nsaspy/zara-plugins

Fork

You've already forked zara-plugins

Code Issues 10 Pull requests 297 Projects Releases Packages Wiki Activity Actions

zara-emacs: structured Emacs, Org-roam daily, and Magit project integration #212

New issue

Closed

opened 2026-09-08 02:03:14 +00:00 by nsaspy · 0 comments

nsaspy commented

2026-09-08 02:03:14 +00:00

Owner

Copy link

Plugin

zara-emacs

Goal

Give Zara a structured Emacs integration for the operator's real note/coding workflow without embedding editor-specific shell strings in Zara core.

Initial operator phrases/use cases include:

open emacs scratch
open roam daily
open emacs magit <project>
open/reveal a file or buffer
report current Emacs project/buffer context where explicitly requested

Use emacsclient/server-supported mechanisms or another bounded documented Emacs IPC boundary; do not depend on arbitrary elisp supplied by the model.

Typed operations

At minimum:

emacs.open_scratch
emacs.open_file(path)
emacs.open_buffer(name) where safe/meaningful
org_roam.open_daily(date=today)
magit.open_project(project_id)
emacs.context for bounded current buffer/file/project metadata

Project resolution

magit.open_project(project_id) must consume a configurable known-project/alias mapping rather than hard-code one machine's paths.

Prefer consuming Zara's canonical Prolog-backed project resolver when that contract exists. Until then, keep any plugin-local compatibility mapping explicitly user-owned under XDG config and structured so it can be replaced by the canonical resolver without changing the public tool shape.

Do not commit operator paths or private project names as defaults.

Org-roam + dictation handoff

open roam daily must support the Zara workflow where opening today's note is immediately followed by enabling the existing canonical Zara voice-dictation flow.

This plugin MUST NOT open the microphone, create a second recorder, or implement a second voice runtime. Instead expose a typed completion/event/result that Zara's canonical hook/advice/runtime can use to request dictation after the note open is acknowledged.

A successful editor-open result alone must never falsely claim dictation started.

Safety

no model-controlled arbitrary elisp evaluation surface
no shell-string interpolation
bounded paths/arguments
explicit editor-unavailable/server-unavailable results
user config and private paths remain outside Git/Nix store
operations return acknowledgement/evidence from the Emacs boundary where possible

Integration

zara-desktop (#3) may own generic application launch/focus; this plugin owns Emacs-specific semantic operations.
zara-context (#4) may consume bounded Emacs project/file context.
Zara core issue #260/hook surface should orchestrate post-action behavior such as dictation without this plugin bypassing runtime policy.
zara-coding may consume Magit/project operations without duplicating editor IPC.

TDD / acceptance

deterministic fake Emacs server tests are RED first
scratch/file/daily/Magit operations are structured
project aliases/paths are user-configurable and not hard-coded
daily-note action emits/verifies a distinct post-open dictation-request seam rather than owning a microphone
editor/server unavailable and failed-action paths are explicit
arbitrary elisp/shell injection is impossible through the public tool schema
tests require no GUI/network and no real Emacs process
README documents Emacs server, Org-roam, project alias, and dictation integration
registry validation passes
plugin tests pass
nix flake check passes

## Plugin `zara-emacs` ## Goal Give Zara a structured Emacs integration for the operator's real note/coding workflow without embedding editor-specific shell strings in Zara core. Initial operator phrases/use cases include: - `open emacs scratch` - `open roam daily` - `open emacs magit <project>` - open/reveal a file or buffer - report current Emacs project/buffer context where explicitly requested Use `emacsclient`/server-supported mechanisms or another bounded documented Emacs IPC boundary; do not depend on arbitrary elisp supplied by the model. ## Typed operations At minimum: - `emacs.open_scratch` - `emacs.open_file(path)` - `emacs.open_buffer(name)` where safe/meaningful - `org_roam.open_daily(date=today)` - `magit.open_project(project_id)` - `emacs.context` for bounded current buffer/file/project metadata ## Project resolution `magit.open_project(project_id)` must consume a configurable known-project/alias mapping rather than hard-code one machine's paths. Prefer consuming Zara's canonical Prolog-backed project resolver when that contract exists. Until then, keep any plugin-local compatibility mapping explicitly user-owned under XDG config and structured so it can be replaced by the canonical resolver without changing the public tool shape. Do not commit operator paths or private project names as defaults. ## Org-roam + dictation handoff `open roam daily` must support the Zara workflow where opening today's note is immediately followed by enabling the existing canonical Zara voice-dictation flow. This plugin MUST NOT open the microphone, create a second recorder, or implement a second voice runtime. Instead expose a typed completion/event/result that Zara's canonical hook/advice/runtime can use to request dictation after the note open is acknowledged. A successful editor-open result alone must never falsely claim dictation started. ## Safety - no model-controlled arbitrary elisp evaluation surface - no shell-string interpolation - bounded paths/arguments - explicit editor-unavailable/server-unavailable results - user config and private paths remain outside Git/Nix store - operations return acknowledgement/evidence from the Emacs boundary where possible ## Integration - `zara-desktop` (#3) may own generic application launch/focus; this plugin owns Emacs-specific semantic operations. - `zara-context` (#4) may consume bounded Emacs project/file context. - Zara core issue #260/hook surface should orchestrate post-action behavior such as dictation without this plugin bypassing runtime policy. - `zara-coding` may consume Magit/project operations without duplicating editor IPC. ## TDD / acceptance - [ ] deterministic fake Emacs server tests are RED first - [ ] scratch/file/daily/Magit operations are structured - [ ] project aliases/paths are user-configurable and not hard-coded - [ ] daily-note action emits/verifies a distinct post-open dictation-request seam rather than owning a microphone - [ ] editor/server unavailable and failed-action paths are explicit - [ ] arbitrary elisp/shell injection is impossible through the public tool schema - [ ] tests require no GUI/network and no real Emacs process - [ ] README documents Emacs server, Org-roam, project alias, and dictation integration - [ ] registry validation passes - [ ] plugin tests pass - [ ] `nix flake check` passes

nsaspy closed this issue

2026-09-08 02:03:14 +00:00

No Branch/Tag specified

main

feat/p0-prolog-python-nim-product-packages

fix/860-lisp-evidence-type-fence-20260921

feat/strange-loop-experts

companion/805-android-animations-20260917

feat/star-kb-agent

fix/860-lisp-apply-input-schema-20260921

agentic15/lane3-closed-output-contracts

feature/doordash-commerce

feat/860-lisp-symbolic-conversation-20260921

feat/mara-emacs-todo-roam-928

feat/zara-symbolic-memory

fix/860-lisp-apply-verification-lineage

expert-builder-2/nix-bash-current-core-20260920

fix/860-core-lisp-composition

fix/860-lisp-composition-argument-authority

feat/864-nix-bash-style-sources

fix/859-language-handler-verdict

fix/859-language-handler-failed-verdict

fix/859-expert-stop-unregister

feat/863-js-ts-java-kotlin-host

fix/860-lisp-delegation-status

feat/expert-composition-864

feat/862-language-expert-adapters-v2

chore/dotfiles-expert-ownership-20260919

feat/zara-emacs-deep-20260919

feat/862-language-expert-adapters

feature/866-wiki-gates-search

codex/emacs-kb-857-20260919

feat/851-zara-ssh-files

feat/844-zara-music-prolog-tools

feat/emacs-workflows-20260919

feat/org-roam-shared-memory-2026-09-19

feat/844-zara-music

feat/calendar-caldav-824

feature/zara-activity-android-826

feat/zara-home-ha-transport

feat/prolog-policy-plugin-20260917

feat/812-prolog-policy-default-kb

feat/zara-home-ha-events

feat/839-zara-pi-bash-tmux

feat/zara-cota-static-gtfs-830

feature/zara-mobility-829-20260917

docs/agents-working-model-20260917

codex/808-stock-expert-2026-09-17

feat/linux-context-hooks

feat/811-prolog-policy-advice

fix/zara-coding-criteria-provenance-v2

plugin-d/local-recall-transactional-install

plugin-b/pipewire-player-506

plugin-d/508-discord-transactional-install

fix/zara-discord-startup-fail-closed

fix/browser-list-tabs-primary-error

fix/zara-coding-evidence-provenance

feat/zara-browser-webdriver-backend

rage/503-files-root-shape

rage/500-calendar-mutation-proof

rage/495-contacts-create-proof

rage/497-calendar-write-evidence

rage/495-contacts-create-evidence

rage/489-comms-send-evidence-replay

rage/485-calendar-free-busy-evidence

rage/489-comms-send-evidence

rage/485-calendar-free-busy-evidence-replay

rage/489-comms-send-payload-proof

rage/487-calendar-event-temporal-order

rage/483-timers-persisted-numeric-types

rage/481-github-pr-provider-metadata

rage/479-media-numeric-metadata

rage/477-media-accepted-bool

rage/475-comms-attachment-size-type

rage/471-sysadmin-provider-booleans

rage/473-comms-provider-booleans

rage/469-home-scene-verified-bool

rage/467-contacts-accepted-bool

rage/465-calendar-accepted-bool

rage/463-media-provider-booleans

rage/461-discord-boolean-policy

rage/459-expert-host-policy

rage/457-discord-chance-policy

rage/455-timers-numeric-descriptors

rage/453-discord-history-bounds

rage/451-browser-session-bounds

rage/449-avatar-renderer-command-config

rage/447-avatar-directory-policy

rage/407-avatar-renderer-policy-replay

rage/444-discord-context-bound-types

rage/444-discord-context-bound-types-replay

fix/443-avatar-idle-cpu

rage/439-discord-audit-bound-types

rage/439-discord-audit-red-proof

rage/435-healthcheck-numeric-types-replay

rage/435-healthcheck-numeric-types

rage/434-files-numeric-types

rage/432-contacts-numeric-types

rage/429-sysadmin-numeric-types

rage/427-calendar-numeric-types

rage/425-comms-policy-types

rage/423-media-constructor-limit-types

rage/421-media-queue-search-types

rage/419-media-playback-types

rage/417-local-recall-selector-type

rage/415-local-recall-bool-limits

rage/413-context-plugin-ttl-type

rage/411-context-freshness-types

rage/409-knowledge-config-types

rage/407-avatar-renderer-policy

rage/403-agent-zero-config-types-v2

rage/403-agent-zero-config-types

rage/403-agent-zero-config-red

rage/399-starintel-numeric-types-v2

rage/399-starintel-numeric-types

rage/399-starintel-numeric-red

rage/395-emacs-config-types-v2

rage/395-emacs-config-types

rage/395-emacs-config-red

rage/392-brave-config-types-v2

rage/392-brave-config-types

rage/377-coding-prolog-policy-v2

rage/377-red-proof-v2

rage/387-github-integer-limits

rage/385-github-numeric-config

rage/377-coding-prolog-policy-descriptors

rage/382-memory-duplicate-projections

rage/379-shell-runtime-limit-type

rage/374-memory-duplicate-recall

rage/369-coding-inspector-descriptors

rage/368-memory-projection-evidence

rage/370-shell-policy-collections

rage/366-memory-backend-fact-bound

rage/364-shell-policy-descriptors

rage/362-memory-recall-bound

rage/360-expert-bool-bounds

rage/358-github-config-bools

rage/356-github-number-types

rage/354-shell-runtime-bool

rage/352-memory-jsonrpc-id-type

rage/350-memory-mcp-result-status

rage/348-memory-mcp-oserror

rage/345-memory-schema-registration-type-v2

rage/345-memory-schema-registration-type

rage/340-memory-schema-types-v2

rage/340-memory-schema-types

rage/336-coding-task-state-executable-v2

rage/338-memory-bounded-facts

rage/336-coding-task-state-executable

rage/334-memory-type-selector-validation

rage/332-coding-canonical-changed-paths

rage/330-shell-invalid-subprocess-strings

rage/328-memory-provenance-alias

rage/326-memory-write-evidence

rage/324-memory-fact-term

rage/322-memory-scope-type

rage/320-shell-cwd-type

rage/318-memory-provenance

rage/316-memory-query-type

rage/314-shell-argv-container

rage/312-shell-env-mapping

rage/310-current-zara-pin

rage/308-shell-typed-stdin

rage/306-memory-schema-fact-isolation

rage/303-github-strict-result-limits

rage/301-shell-strict-runtime-config

rage/298-shell-environment-allowlist

rage/296-memory-mcp-finite-deadline

rage/294-memory-mcp-response-identity

rage/292-memory-type-isolation

rage/290-shell-byte-limits

rage/288-task-dependencies

rage/286-current-verifier-failures

rage/284-shell-finite-runtime

rage/280-latest-verifier-result

rage/282-shell-typed-config

rage/1-verifier-owned-evidence

rage/registry-timeout-abort

rage/registry-module-import-timeout

rage/registry-bound-module-entrypoints

rage/registry-bound-contract-attributes

rage/registry-service-factory-timeout

rage/registry-legacy-entrypoint-timeout

rage/coding-task-repository-context

rage/registry-sync-timeout-bounds

rage/registry-real-sync-timeouts

rage/coding-task-state-protocol-fence

rage/registry-installed-import-isolation

rage/coding-task-state-response-timeout

rage/coding-task-state-crash-fence

rage/coding-task-state-status-contract

rage/registry-dependency-env-construction

rage/248-document-task-completion

docs/248-task-state-contract

rage/246-freeze-completed-task

rage/244-evidence-status

rage/242-passing-verification

rage/240-task-state-bounds

rage/242-passing-evidence

rage/238-prolog-task-state

rage/236-verifier-duplicate-evidence

rage/234-canonical-verification-object-ids

rage/232-service-plugin-type-agreement

rage/230-deduplicate-worktree-evidence

rage/228-deduplicate-changed-path-evidence

rage/226-isolate-agent-zero-env

rage/224-isolate-avatar-renderer

rage/222-isolate-starintel-live-env

rage/220-strip-live-provider-secrets

rage/215-module-level-factory

rage/217-canonical-evidence-paths

rage/213-commit-tree-object-id

rage/211-diff-head-object-id

rage/209-inspect-head-object-id

rage/207-worktree-head-object-id

rage/205-service-api-version

rage/199-branch-object-id

rage/202-worktree-lock-proof

rage/200-worktree-add-proof

rage/199-branch-object-ids

rage/197-log-object-ids

rage/195-numstat-errors

rage/193-diff-snapshot

rage/191-inspect-dirty-snapshot

rage/189-atomic-branch-create

rage/187-branch-inventory-snapshot

rage/185-fence-branch-create

rage/183-confine-installers

rage/181-confine-plugin-roots

rage/179-strict-service-metadata

rage/177-compat-lifecycle-timeout

rage/175-canonical-install-command

rage/173-python-dependency-metadata

rage/171-canonical-search-paths

rage/169-registry-updated-date

rage/167-canonical-registry-strings

rage/registry-installer-layout-agreement

rage/registry-install-command-grammar

rage/registry-source-urls

rage/registry-search-path-metadata

rage/registry-install-target-metadata

rage/registry-flake-source-metadata

rage/registry-license-metadata

rage/compat-runtime-advice-contract

rage/compat-runtime-worker-sync

rage/compat-runtime-worker-signature

rage/compat-runtime-worker-identity

rage/coding-worktree-remove

rage/compat-runtime-advice-shutdown

rage/compat-runtime-dispatch-contract

rage/registry-nix-metadata-agreement

rage/registry-runtime-readonly-config

rage/registry-require-docs

rage/registry-runtime-closed-workers

rage/registry-confine-metadata-paths

rage/registry-runtime-subscription-lifecycle

rage/registry-runtime-worker-contract

rage/registry-runtime-subscribe-contract

rage/registry-lifecycle-call-semantics

rage/registry-service-tools-call-semantics

rage/registry-async-tools

rage/registry-async-lifecycle

rage/registry-enabled-default-contract

rage/registry-legacy-precedence

rage/registry-legacy-entrypoint-proof

rage/registry-canonical-tool-names

rage/registry-tool-metadata-quality

rage/registry-description-metadata

rage/registry-search-path-discovery

rage/registry-isolate-plugin-imports

rage/registry-tool-name-collisions

rage/1-zara-coding-evidence-branch-shape

rage/1-zara-coding-verify-branch-shape

rage/1-zara-coding-evidence-root-shape

rage/1-zara-coding-verify-root-shape

rage/1-zara-coding-worktree-evidence-path-shape

rage/1-zara-coding-verify-worktree-path-shape

rage/1-zara-coding-verify-path-boundary

rage/1-zara-coding-repository-text-evidence

rage/1-zara-coding-verify-evidence-shape

rage/1-zara-coding-snapshot-evidence-shape

rage/1-zara-coding-worktree-evidence-shape

rage/1-zara-coding-branch-inventory-bound

rage/1-zara-coding-verify-head-shape

rage/1-zara-coding-diff-snapshot

rage/1-zara-coding-rollback-proof

rage/1-zara-coding-inspect-bound

rage/1-zara-coding-dirty-path-coherence

rage/1-zara-coding-doc-current-surface

rage/1-zara-coding-add-lock-rollback

rage/1-zara-coding-changed-path-verify

rage/1-zara-coding-worktree-absent

rage/1-zara-coding-worktree-verify

rage/1-zara-coding-worktree-add-locked

rage/1-zara-coding-worktree-remove

rage/1-zara-coding-branch-assertion

rage/1-zara-coding-check-repository

rage/1-zara-coding-verify-tool

rage/1-zara-coding-spec-verify

rage/1-zara-coding-repository-evidence

rage/1-zara-coding-spec-compile

rage/1-zara-coding-worktree-add

rage/1-zara-coding-branch-create-cas

rage/1-zara-coding-commit

rage/1-zara-coding-branch-delete

rage/1-zara-coding-branch-create

rage/1-zara-coding-worktree-inventory

rage/1-worktree-list

rage/1-repo-list-status

rage/1-spec-language-catalog

rage/1-git-diff-summary

rage/1-git-log-adapter

rage/1-zara-coding-spec-normalize

rage/7-symbolic-memory-native-remember-get

rage/1-zara-coding-task-state

rage/5-zara-shell

rage/8-home-assistant-adapter

rage/7-zara-memory

rage/13-zara-voice-lab

rage/12-zara-voice

rage/8-zara-home-rules

rage/8-zara-home

rage/2-zara-expert

rage/32-discord-scoped-moderation

rage/31-discord-moderation-ack

rage/28-discord-moderation-audit

rage/35-discord-ci-preset

rage/33-discord-channel-commands

rage/33-discord-channel-inspection-policy

rage/27-discord-opt-in-message-content

rage/34-discord-content-diagnostics

rage/30-discord-public-output-privacy

rage/29-discord-user-isolation

rage/12-voice-runtime

rage/53-installed-runtime-smoke

rage/53-lifecycle-compat

rage/12-voice

rage/19-healthcheck-clean

rage/19-healthcheck

rage/16-timers

rage/11-comms

rage/17-contacts

rage/10-calendar

rage/14-media

rage/6-sysadmin

rage/15-files

rage/9-browser

rage/4-context

rage/3-desktop

rage/3-desktop-red

rage/52-emacs-red

rage/18-51-knowledge-brave

rage/50-github-red

fix/agent-zero-native-api

rage/53-zara-compat-red

feat/zara-starintel-server-47

fix/discord-recent-context

feat/agent-zero-bridge-40

fix/discord-tool-execution

feat/zara-persona-37

feat/declarative-runtime-layout

feat/discord-inspection-moderation

fix/discord-manager-permissions

feat/zara-org-todos

codex/zara-plugins-ci-push

feat/zara-discord

No results found.

Labels

Clear labels

accessibility

Barrier affecting people with disabilities

bug

Something isn't working

documentation

Improvements or additions to documentation

duplicate

This issue or pull request already exists

enhancement

New feature or request

good first issue

Good for newcomers

help wanted

Extra attention is needed

invalid

This doesn't seem right

question

Further information is requested

security

wontfix

This will not be worked on

No labels

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

nsaspy/zara-plugins#212

Reference in a new issue

Repository

nsaspy/zara-plugins

Title

Body

No description provided.

Delete branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?

Rows
Columns