Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors
Rust
docs(command-code): narrow managed acceptance gate
AkitaOnRails7a6490c13483
diff --git a/docs/install.md b/docs/install.mdindex 9a18d71f..fd565cf3 100644--- a/docs/install.md+++ b/docs/install.md@@ -780,10 +780,15 @@ ai-memory finalize-session --agent command-code --session-id <uuid>ai-memory does not install Command Code Mods. Mods are currently documentedas experimental, run unsandboxed, and do not provide the same stable nativesession identity at every callback. Managed `ai-memory run command-code`-support is also withheld until a logged-in acceptance run proves the current-session-store layout, exact resume selector, checkout ownership, read-only-transcript import, `--yolo` translation, and Windows executable behavior.-Direct `cmd`, `cmdc`, or `command-code` launches remain unchanged.+support is also withheld. Command Code documents append-only JSONL transcripts+under `~/.commandcode/projects/<project-slug>/`, native `--continue`,+`--resume`, and `--session` selectors, `--yolo`, and the Windows `cmdc` alias.+It does not document the JSONL record schema needed for bounded visible-event+import. A logged-in acceptance run must still supply sanitized structural+fixtures and validate checkout matching, incremental import, resume identity,+normal-exit finalization, and native Windows behavior before ai-memory manages+those sessions. Direct `cmd`, `cmdc`, or `command-code` launches remain+unchanged.### Kiro CLIdiff --git a/docs/managed-workstreams.md b/docs/managed-workstreams.mdindex cd697ce1..3a2ef714 100644--- a/docs/managed-workstreams.md+++ b/docs/managed-workstreams.md@@ -236,11 +236,15 @@ is labelled completed evidence and must never be replayed as a pending call.Command Code is intentionally absent from this table. Its first-party MCP andstable lifecycle-hook integration does not imply managed resume support.-Before adding a managed adapter, a logged-in current release must prove the-session-store layout, exact resume selector, checkout validation, read-only-visible-event extraction, dangerous-mode translation, normal-exit finalization,-and the `cmdc` executable path on native Windows. Experimental Mod APIs are not-a substitute for those native-session acceptance artifacts.+The official session contract establishes append-only JSONL transcripts at+`~/.commandcode/projects/<project-slug>/<session-id>.jsonl`, native+`--continue`, `--resume`, and `--session` selectors, `--yolo`, and `cmdc` as+the native Windows alias. The record-level JSONL schema is not documented.+Before adding a managed adapter, a logged-in current release must therefore+supply sanitized structural fixtures and validate project-slug ownership,+branch-aware visible-event extraction, incremental append behavior, resume+identity, normal-exit finalization, and native Windows execution. Experimental+Mod APIs are not a substitute for those native-session acceptance artifacts.An explicit native selector such as Claude's `--resume`, OpenCode's `--session`,Codex's `resume`, or Antigravity's `--conversation` / `--continue` wins.diff --git a/docs/mcp-install.md b/docs/mcp-install.mdindex 175fa6e7..a5d1cc57 100644--- a/docs/mcp-install.md+++ b/docs/mcp-install.md@@ -834,14 +834,18 @@ envelope, and inject pending handoffs with`Stop` is only a turn boundary. Run `ai-memory finalize-session --agentcommand-code` after the final turn (or add `--session-id <uuid>` when severalsessions share the project). ai-memory does not generate a Mod: that API is-experimental and unsandboxed. A managed adapter remains deferred until a real-logged-in client acceptance test supplies safe fixtures for exact resume,-checkout ownership, transcript import, dangerous mode, and native Windows.+experimental and unsandboxed. Command Code officially documents its+project-scoped append-only JSONL location, native resume selectors, `--yolo`,+and Windows aliases, but not the JSONL record schema. A managed adapter remains+deferred until a real logged-in client acceptance test supplies sanitized+structural fixtures and validates checkout ownership, incremental visible-event+import, resume identity, normal-exit finalization, and native Windows execution.Sources: <https://commandcode.ai/docs/mcp>,<https://commandcode.ai/docs/hooks>,<https://commandcode.ai/docs/mods>, and-<https://commandcode.ai/docs/reference/cli>.+<https://commandcode.ai/docs/reference/cli>, plus the native-session contract at+<https://commandcode.ai/docs/sessions>.## Kiro CLI