synomem 0.1.0 → 0.2.0

package/ARCHITECTURE.md

@@ -44,7 +44,7 @@ reconstruct one requested aggregate. Generated Markdown is never a machine query
 ## Authorization
 
 MCP servers bind one actor at startup, and tool inputs cannot override it. Humans have local
-administrative authority. Agents can manage their own notes, recipient memo state, and todos they
+administrative authority. Agents can manage their own notes and todos, recipient memo state, and tasks they
 created or received. System actors have no implicit agent or administrator authority. Actor
 principals are keyed by both kind and ID; matching text IDs across kinds do not share author access.
 
@@ -55,7 +55,7 @@ The filesystem owner remains the ultimate local authority.
 ## Concurrency and durability
 
 SQLite uses WAL, foreign keys, `synchronous=FULL`, a bounded busy handler, and `BEGIN IMMEDIATE`
-transactions. Actor-scoped idempotency protects retries. Note and todo revisions use aggregate
+transactions. Actor-scoped idempotency protects retries. Note, task, and todo revisions use aggregate
 versions so stale writes fail with `REVISION_CONFLICT` rather than overwriting concurrent state.
 
 V1 supports one machine and one filesystem owner. A future hosted service must enforce the same

package/CHANGELOG.md

@@ -5,6 +5,41 @@ All notable changes will be documented here. The format follows
 
 ## [Unreleased]
 
+### Changed
+
+- The MCP server binds to an agent with `--agent-id`, reading the display name and actor kind from
+  the agent's profile. `synomem skill install --agent <id-or-alias>` resolves the agent before
+  writing anything, records a runtime binding for each runtime it installs, and generates a
+  registration command carrying only the canonical ID.
+
+## [0.2.0] - 2026-09-05
+
+### Added
+
+- Private todos as a distinct domain: a todo belongs to the agent that wrote it, is visible to no
+  one else, and cannot be assigned. Work meant for another agent is a task.
+- Optional responses when accepting a task and required responses when rejecting one, so a refusal
+  always tells the assigner why.
+- Discovery for work that has stalled: tasks awaiting a response and tasks past their deadline.
+- Case-insensitive agent aliases with `agent resolve`, which returns candidates instead of guessing
+  when several agents answer to one name, and `agent directory`.
+- Advisory runtime bindings recording where an agent was registered to run, with `agent runtime
+bind`, `list`, and `unbind`, and the matching `synomem_agent_resolve` and
+  `synomem_agent_directory` MCP tools.
+
+### Changed
+
+- Schema version 5 adds a normalized alias column with a unique index and an
+  `agent_runtime_bindings` table. Existing databases migrate in place.
+- Aliases are stored folded to lowercase, so one name cannot be claimed twice in two casings.
+
+## [0.1.1] - 2026-09-04
+
+### Fixed
+
+- Allow configured `SYNOMEM_ACTOR_ID`, `SYNOMEM_ACTOR_KIND`, and `SYNOMEM_ACTOR_NAME` values to
+  override historical CLI default identities for remote commands while preserving local fallbacks.
+
 ## [0.1.0] - 2026-09-04
 
 ### Added
@@ -31,5 +66,6 @@ All notable changes will be documented here. The format follows
 - Skill installation is explicit, constrained to supported runtime directories, and dry-run by
   default.
 
-[Unreleased]: https://github.com/Coaden/synomem/compare/v0.1.0...HEAD
+[Unreleased]: https://github.com/Coaden/synomem/compare/v0.1.1...HEAD
+[0.1.1]: https://github.com/Coaden/synomem/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/Coaden/synomem/releases/tag/v0.1.0

package/README.md

@@ -43,8 +43,8 @@ MCP server, compact change feeds, and readable Markdown projections. V1 runs ent
 and opens no network listener.
 
 > [!IMPORTANT]
-> The renamed `synomem` package has not been published yet. It is pre-1.0 software, so review the
-> release notes and rename guidance before upgrading persisted storage or public API consumers.
+> Synomem is pre-1.0 software. Review the release notes before upgrading persisted storage or public
+> API consumers.
 
 ## Quick start
 
@@ -69,11 +69,17 @@ synomem note create --as gracie \
   --title "Release invariant" \
   --body "Never publish without explicit maintainer authorization."
 
-synomem todo create codex \
+synomem task create codex \
   --from gracie --title "Review the migration" --due-date 2026-09-15
 
 synomem inbox codex
-synomem todo accept <todo-id> --as codex
+synomem task accept <task-id> --as codex --response "Starting after the tests."
+
+# A todo is private to the agent that wrote it; nobody else can assign one.
+synomem todo create --as codex --title "Re-read the migration notes"
+
+synomem agent resolve Mike
+synomem agent directory
 synomem list
 ```
 
@@ -87,15 +93,15 @@ terminal-capable agent. The Synomem package contains the portable
 installer for the six named local harnesses.
 
 ```text
-Set up Synomem for this agent and runtime. Synomem is a local-first coordination system for durable kudos, one-to-one memos, private agent notes, and consent-based assigned todos. It uses an append-only SQLite database under ~/.agents by default, an actor-bound stdio MCP server, and a portable Agent Skill. Multiple local agents may share the database, but every MCP server must be bound to its own stable identity.
+Set up Synomem for this agent and runtime. Synomem is a local-first coordination system for durable kudos, one-to-one memos, private agent notes, consent-based assigned tasks, and private todos. It uses an append-only SQLite database under ~/.agents by default, an actor-bound stdio MCP server, and a portable Agent Skill. Multiple local agents may share the database, but every MCP server must be bound to its own stable identity.
 
 Work autonomously through the safe, reversible steps below. Do not expose secrets, overwrite unrelated configuration, invent an identity, use --force without my explicit approval, or modify another agent's integration.
 
 1. Verify Node.js 22.13+ and npm are available. Install or update the public package with `npm install --global synomem` if needed, then report `synomem --version`.
 2. Preserve an existing `SYNOMEM_HOME`; otherwise use the default ~/.agents. Run `synomem init`, then `synomem doctor`. Never point tests or experiments at another Synomem home.
 3. Run `synomem agent list`. Determine this agent's existing stable ID from the current harness or Synomem configuration and reuse it. If no identity is clearly established, ask me for the agent ID and display name before running `synomem agent create <id> --name <name>`. Never silently merge or rename identities.
-4. Detect the current harness from actual local evidence and its installed CLI help. Use runtime `claude` for Claude Code, `codex` for Codex, `hermes` for Hermes, `openclaw` for OpenClaw, `cursor` for Cursor, or `grok` for local Grok Build (`grokbot` is accepted as an alias). Check `synomem skill install --help`, then preview with `synomem skill install --runtime <runtime> --actor-id <agent-id> --actor-name <display-name>`. Review the exact destination and apply the same command with `--yes`; it must report `current`. If the installed release does not yet list this runtime, locate the packaged source under the global npm root at `synomem/skills/synomem` and follow the verified destination and conflict rules in https://github.com/Coaden/synomem/blob/main/docs/skill.md instead. Do not guess a path, overwrite an existing skill, or create a fake harness home to make an unavailable runtime appear installed.
-5. Inspect any actor-bound MCP registration command printed by the installer. Check the harness's existing MCP list/config first, then run the command only if `synomem` is absent or incorrect. Do not create duplicates. Cursor has no noninteractive MCP-add command: carefully merge a `synomem` stdio entry into its documented user `~/.cursor/mcp.json`, using command `synomem-mcp` and arguments `--actor-id <agent-id> --actor-kind agent --actor-name <display-name>`; preserve every existing entry.
+4. Detect the current harness from actual local evidence and its installed CLI help. Use runtime `claude` for Claude Code, `codex` for Codex, `hermes` for Hermes, `openclaw` for OpenClaw, `cursor` for Cursor, or `grok` for local Grok Build (`grokbot` is accepted as an alias). Check `synomem skill install --help`, then preview with `synomem skill install --runtime <runtime> --agent <agent-id>`. Review the exact destination and apply the same command with `--yes`; it must report `current`. If the installed release does not yet list this runtime, locate the packaged source under the global npm root at `synomem/skills/synomem` and follow the verified destination and conflict rules in https://github.com/Coaden/synomem/blob/main/docs/skill.md instead. Do not guess a path, overwrite an existing skill, or create a fake harness home to make an unavailable runtime appear installed.
+5. Inspect any actor-bound MCP registration command printed by the installer. Check the harness's existing MCP list/config first, then run the command only if `synomem` is absent or incorrect. Do not create duplicates. Cursor has no noninteractive MCP-add command: carefully merge a `synomem` stdio entry into its documented user `~/.cursor/mcp.json`, using command `synomem-mcp` and the single argument `--agent-id <agent-id>` (the display name and kind come from the agent's profile, so nothing in a shared config file asserts an identity); preserve every existing entry.
 6. Verify the harness can discover the installed skill and MCP server using its own list/status commands, then run `synomem doctor`. Start a new agent session if that harness does not live-reload a newly created skills directory.
 7. If this is hosted Grok Bot rather than local Grok Build, do not claim it shares the desktop's local SQLite database. Install the package and skill only inside a persistent terminal environment where `npm`, local stdio MCP, and ~/.grok are actually available. Otherwise provide the skill URL https://github.com/Coaden/synomem/blob/main/skills/synomem/SKILL.md and explain the unsupported boundary; do not expose the local database through a tunnel.
 8. Report the package version, stable actor ID, storage home, installed skill path, MCP registration and verification status, whether a new session is needed, and every file or configuration changed. Do not print record contents or environment values beyond the non-secret actor identity and home path.
@@ -130,13 +136,20 @@ await client.notes.revise({
   body: 'Never publish or create a release without explicit maintainer authorization.',
 });
 
-await client.todos.create({
+// A task is assigned to someone else and needs their consent.
+await client.tasks.create({
   assigneeAgentId: 'codex',
   title: 'Review the migration',
   due: { kind: 'date', date: '2026-09-15' },
 });
 
-const page = await client.items.list({ kinds: ['memo', 'todo'], limit: 10 });
+// A todo is the agent's own reminder, visible to no one else.
+await client.todos.create({
+  title: 'Re-read the migration notes',
+  due: { kind: 'date', date: '2026-09-14' },
+});
+
+const page = await client.items.list({ kinds: ['memo', 'task'], limit: 10 });
 const changes = await client.items.changes({ after: page.watermark });
 
 await client.close();
@@ -147,7 +160,7 @@ The library performs no filesystem work at import time and never terminates its
 ## Context-safe reads
 
 `client.items.list()` and MCP `synomem_list` return 10 compact summaries by default and at most 50.
-Summaries omit message bodies, kudos reasons and evidence, note bodies, todo descriptions, source,
+Summaries omit message bodies, kudos reasons and evidence, note bodies, task and todo details, source,
 and metadata. Fetch one authorized detail record with `items.get(id)` or `synomem_get`.
 
 Incremental reads return at most 20 changes by default and 100 at most. List and change responses
@@ -176,9 +189,9 @@ bounded reads. See [the MCP guide](docs/mcp.md).
 The package includes [`skills/synomem`](skills/synomem). Installation is explicit and dry-run first:
 
 ```bash
-synomem skill install --runtime codex --actor-id codex --actor-name "Codex"
-synomem skill install --runtime codex --actor-id codex --actor-name "Codex" --yes
-synomem skill install --runtime hermes --actor-id mycroft --actor-name "Mycroft" --yes
+synomem skill install --runtime codex --agent codex
+synomem skill install --runtime codex --agent codex --yes
+synomem skill install --runtime hermes --agent mycroft --yes
 synomem skill status
 ```
 
@@ -197,8 +210,8 @@ are `claude`, `codex`, `hermes`, `openclaw`, `cursor`, and `grok`; `grokbot` ali
     ├── profile.json
     ├── WINS.md
     ├── MEMORY.md
-    ├── TODOS.md
-    ├── inbox/{kudos,memos,todos}/
+    ├── TASKS.md
+    ├── inbox/{kudos,memos,tasks}/
     └── NOTES.md
 ```
 

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAKA,OAAO,EAAE,OAAO,EAA0B,MAAM,WAAW,CAAC;AAE5D,OAAO,EAA0C,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAIhG,OAAO,EAA4C,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE9F,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AASrB,OAAO,KAAK,EACV,aAAa,EAQd,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAkB,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE1E,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE;QACjC,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,aAAa,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,eAAe,CAAC;KAClC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7D,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,aAAa,CAAC;QACrB,MAAM,EAAE,YAAY,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,KAAK,OAAO,CAAC,aAAa,GAAG,YAAY,CAAC,CAAC;CAC7C;AAkMD,wBAAgB,SAAS,CACvB,EAAE,GAAE,KAAiB,EACrB,cAAc,GAAE,qBAAgD,EAChE,YAAY,GAAE,eAAoB,GACjC,OAAO,CA+yCT;AAED,wBAAsB,MAAM,CAC1B,IAAI,WAAe,EACnB,EAAE,GAAE,KAAiB,EACrB,cAAc,GAAE,qBAAgD,EAChE,YAAY,GAAE,eAAoB,GACjC,OAAO,CAAC,MAAM,CAAC,CAqBjB"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAKA,OAAO,EAAE,OAAO,EAA0B,MAAM,WAAW,CAAC;AAE5D,OAAO,EAA0C,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAIhG,OAAO,EAA4C,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE9F,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AASrB,OAAO,KAAK,EACV,aAAa,EAQd,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAkB,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE1E,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE;QACjC,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,aAAa,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,eAAe,CAAC;KAClC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7D,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,aAAa,CAAC;QACrB,MAAM,EAAE,YAAY,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,KAAK,OAAO,CAAC,aAAa,GAAG,YAAY,CAAC,CAAC;CAC7C;AAkND,wBAAgB,SAAS,CACvB,EAAE,GAAE,KAAiB,EACrB,cAAc,GAAE,qBAAgD,EAChE,YAAY,GAAE,eAAoB,GACjC,OAAO,CA8qDT;AAED,wBAAsB,MAAM,CAC1B,IAAI,WAAe,EACnB,EAAE,GAAE,KAAiB,EACrB,cAAc,GAAE,qBAAgD,EAChE,YAAY,GAAE,eAAoB,GACjC,OAAO,CAAC,MAAM,CAAC,CAqBjB"}