npm - chainlesschain - Versions diffs - 0.165.6 → 0.165.8 - Mend

chainlesschain 0.165.6 → 0.165.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (238) hide show

package/src/command-help-index.json CHANGED Viewed

@@ -5,7 +5,7 @@
     "a2a": "Usage: chainlesschain a2a [options] [command]\n\nA2A Protocol — agent-to-agent communication\n\nOptions:\n  -h, --help                                     display help for command\n\nCommands:\n  register [options] <name>                      Register an agent card\n  discover [options]                             Discover agents by capability or skill\n  submit [options] <agent-id> <input>            Submit a task to an agent\n  status [options] <task-id>                     Get task status\n  complete <task-id> <output>                    Mark a task as completed\n  fail <task-id> <error>                         Mark a task as failed\n  peers [options]                                List all registered agents\n  cards [options]                                List all agent cards with details\n  negotiate [options] <agent-id> <capabilities>  Check if an agent supports required capabilities\n  task-statuses [options]                        List V2 task statuses (Phase 81)\n  card-statuses [options]                        List V2 card statuses (Phase 81)\n  subscription-types [options]                   List V2 subscription types (Phase 81)\n  negotiation-results [options]                  List V2 negotiation outcomes (Phase 81)\n  validate-card [options] <name>                 Validate an agent card against the A2A schema\n  set-card-status [options] <cardId> <status>    Transition a card between active/inactive/expired\n  card-status [options] <cardId>                 Show a card's V2 status\n  send-task-v2 [options] <agentId> <input>       Submit a V2 task (in-memory, with optional timeout)\n  start-working [options] <taskId>               Transition a V2 task to working\n  request-input [options] <taskId> <prompt>      Request user input while a V2 task is working\n  provide-input [options] <taskId> <input>       Provide input for an input-required V2 task\n  complete-task-v2 [options] <taskId> [output]   Complete a V2 task (from working only)\n  fail-task-v2 [options] <taskId> [error]        Fail a V2 task with an error message\n  cancel-task [options] <taskId> [reason]        Cancel a non-terminal V2 task\n  check-timeout [options] <taskId>               Check V2 task timeout (auto-fails if past deadline)\n  task-v2 [options] <taskId>                     Show a V2 task snapshot\n  tasks-v2 [options]                             List V2 tasks\n  negotiate-v2 [options] <cardJson>              Phase 81 capability negotiation against an agent card\n  stats-v2 [options]                             Aggregate V2 stats (tasks + cards + subscriptions)\n  enums-v2                                       Show V2 governance enums\n  register-agent-v2 [options]                    Register an a2a agent profile (pending)\n  activate-agent-v2 <id>                         Activate agent\n  suspend-agent-v2 <id>                          Suspend agent\n  retire-agent-v2 <id>                           Retire agent (terminal)\n  touch-agent-v2 <id>                            Refresh lastTouchedAt\n  get-agent-v2 <id>                              Get agent\n  list-agents-v2                                 List agents\n  create-message-v2 [options]                    Create an a2a message (queued)\n  start-message-v2 <id>                          Transition message to sending\n  deliver-message-v2 <id>                        Transition message to delivered\n  fail-message-v2 [options] <id>                 Fail message\n  cancel-message-v2 [options] <id>               Cancel message\n  get-message-v2 <id>                            Get message\n  list-messages-v2                               List messages\n  set-max-active-agents-v2 <n>                   Set per-owner active cap\n  set-max-pending-messages-v2 <n>                Set per-agent pending cap\n  set-agent-idle-ms-v2 <n>                       Set idle threshold\n  set-message-stuck-ms-v2 <n>                    Set stuck threshold\n  auto-suspend-idle-agents-v2                    Auto-suspend idle agents\n  auto-fail-stuck-messages-v2                    Auto-fail stuck sending messages\n  gov-stats-v2                                   V2 governance aggregate stats\n  help [command]                                 display help for command\n",
     "activitypub": "Usage: chainlesschain activitypub|ap [options] [command]\n\nActivityPub C2S bridge — actors, outbox/inbox, Follow/Create/Like/Announce\n\nOptions:\n  -h, --help                                    display help for command\n\nCommands:\n  actor                                         Manage local and remote ActivityPub actors\n  publish [options] <content>                   Publish a Create(Note) activity to the actor's outbox\n  follow [options] <target>                     Publish a Follow activity (target: username or actor URL)\n  accept [options] <follow-activity-id>         Accept a pending Follow request\n  unfollow [options] <target>                   Publish an Undo(Follow) activity\n  like [options] <object-id>                    Publish a Like activity for an object URL\n  announce [options] <object-id>                Publish an Announce (boost) activity for an object URL\n  outbox [options] <username>                   List an actor's outbox activities\n  inbox [options] <username>                    List an actor's inbox activities\n  deliver [options] <username> <activity-json>  Simulate inbox delivery — push a JSON activity into a local actor's inbox\n  followers [options] <username>                List followers of an actor\n  search [options] <query>                      Search actors and/or notes in the local Fediverse index\n  following [options] <username>                List who this actor is following\n  enums-v2                                      Show V2 enums\n  register-actor-v2 [options]                   Register an AP actor profile (pending)\n  activate-actor-v2 <id>                        Activate actor\n  suspend-actor-v2 <id>                         Suspend actor\n  deactivate-actor-v2 <id>                      Deactivate actor (terminal)\n  touch-actor-v2 <id>                           Refresh lastTouchedAt\n  get-actor-v2 <id>                             Get actor\n  list-actors-v2                                List actors\n  create-activity-v2 [options]                  Create an AP activity (queued)\n  start-activity-v2 <id>                        Transition activity to delivering\n  deliver-activity-v2 <id>                      Transition activity to delivered\n  fail-activity-v2 [options] <id>               Fail activity\n  cancel-activity-v2 [options] <id>             Cancel activity\n  get-activity-v2 <id>                          Get activity\n  list-activities-v2                            List activities\n  set-max-active-actors-v2 <n>                  Set per-owner active cap\n  set-max-pending-activities-v2 <n>             Set per-actor pending cap\n  set-actor-idle-ms-v2 <n>                      Set idle threshold\n  set-activity-stuck-ms-v2 <n>                  Set stuck threshold\n  auto-suspend-idle-actors-v2                   Auto-suspend idle actors\n  auto-fail-stuck-activities-v2                 Auto-fail stuck delivering activities\n  gov-stats-v2                                  V2 governance aggregate stats\n  help [command]                                display help for command\n",
     "agenda": "Usage: chainlesschain agenda [options] [command]\n\nFire agent-scheduled wakeups / crons / monitors (persisted by the `schedule`\ntool)\n\nOptions:\n  -h, --help             display help for command\n\nCommands:\n  list [options]         List all scheduled entries\n  run [options]          Fire every entry that is due now\n  cancel [options] <id>  Remove a scheduled entry by id\n  prune [options]        Remove finished entries (fired / matched / exhausted /\n                         expired)\n  help [command]         display help for command\n",
-    "agent": "Usage: chainlesschain agent|a [options] [task...]\n\nStart an agentic AI session (reads/writes files, runs commands)\n\nArguments:\n  task                                 Headless task 鈥?when given (or with -p /\n                                       piped stdin), runs non-interactively\n\nOptions:\n  --model <model>                      Model name\n  --provider <provider>                LLM provider (ollama, openai,\n                                       volcengine, deepseek, ...)\n  --base-url <url>                     API base URL\n  --api-key <key>                      API key\n  --think [level]                      Enable Anthropic extended thinking\n                                       (level: think | hard | ultra; Anthropic\n                                       models only)\n  --ultrathink                         Maximum Anthropic extended thinking (=\n                                       --think ultra)\n  --thinking-budget <n>                Thinking token budget for legacy Claude\n                                       models (Sonnet 4.5 / Opus 4.0-4.5 /\n                                       older); clamped below max_tokens.\n                                       Adaptive-thinking models ignore it (they\n                                       use --think's effort). Requires\n                                       --think/--ultrathink.\n  --image <path>                       Attach an image (png/jpg/jpeg/gif/webp)\n                                       to the prompt for a vision-capable model\n                                       (headless; repeatable)\n  --vision-model <id>                  Model to use when an image is attached\n                                       (default: config llm.visionModel or\n                                       doubao-seed-2-0-lite-260215)\n  --session <id>                       Resume a previous agent session\n  -c, --continue                       Resume the most recent session (no id\n                                       needed 鈥?claude --continue parity)\n  --resume [id]                        Resume a session by id (no id 鈫?most\n                                       recent 鈥?claude --resume parity)\n  --fork-session                       When resuming, branch into a NEW session\n                                       id and leave the original untouched\n                                       (claude --fork-session parity)\n  --fork-request-id <key>              Stable idempotency key for\n                                       --fork-session retries (omit for a new\n                                       fork each invocation)\n  --add-dir <dir>                      Extra working directory the agent may\n                                       read/search/edit (repeatable)\n  --checkpoint                         Auto-snapshot the work tree before each\n                                       mutating tool (DEFAULT inside a git\n                                       repo; cc checkpoint restore to roll\n                                       back)\n  --no-checkpoint                      Disable auto-checkpointing (it is on by\n                                       default inside git repos)\n  --managed-checkpoint                 Checkpoint bounded mutating tools with\n                                       Process Broker; unavailable writer\n                                       lifetimes are reported as coverage none\n  --managed-checkpoint-state <dir>     Durable managed-checkpoint state\n                                       directory (must be outside the\n                                       workspace)\n  --managed-checkpoint-exclude <path>  Explicit workspace path excluded from\n                                       managed checkpoints; repeatable and\n                                       reported as partial coverage\n  --safe-mode                          Run bare: disable project memory,\n                                       settings hooks, memory recall, IDE\n                                       context, status line and update notice\n                                       (permission rules STAY active)\n  --bare                               Everything --safe-mode disables PLUS\n                                       skills, plugins and MCP/IDE auto-connect\n                                       — minimal fast surface for scripted\n                                       calls (explicit --mcp-config still\n                                       loads; permission rules STAY active)\n  --ephemeral                          No session persistence: nothing is\n                                       written to the session store (headless;\n                                       a --resume id still replays history\n                                       read-only)\n  --capabilities                       Print a machine-readable capability\n                                       manifest (JSON: protocol version, tools,\n                                       permission modes, exit codes) and exit\n  --disable-slash-commands             Interactive REPL: don't dispatch '/'\n                                       input as slash commands — it reaches the\n                                       model verbatim (/exit and /quit stay\n                                       live)\n  --ax-screen-reader                   Screen-reader friendly output: no ANSI\n                                       colors, no in-place status line repaints\n                                       (also CC_SCREEN_READER=1)\n  --worktree                           Run this session in a fresh git worktree\n                                       (isolated branch; auto-removed when the\n                                       session changes nothing)\n  --no-worktree                        Background Git task: explicitly share\n                                       the current work tree (intended for\n                                       read-only tasks; writable runs are not\n                                       isolated)\n  --unattended                         Enable fail-closed shell action policy\n                                       for scheduled/event-driven runs\n  --unattended-allow <classes>         Comma-separated action classes\n                                       explicitly allowed for unattended shell\n                                       runs\n  --sandbox [image]                    Run shell commands in an ephemeral\n                                       Docker sandbox (network disabled by\n                                       default)\n  --sandbox-mode <mode>                Sandbox posture: off | workspace-write |\n                                       strict (explicit isolation modes fail\n                                       closed)\n  --sandbox-network                    Allow network access inside --sandbox\n  --otlp <file>                        Write the agent run's OpenTelemetry\n                                       spans (model/tool/retry) as OTLP/JSON to\n                                       <file>\n  --otlp-content                       Include prompt/response CONTENT in\n                                       --otlp spans (off by default; content is\n                                       redacted unless this is set)\n  --auto-rewake                        When an async `asyncRewake` hook (e.g. a\n                                       background test) fails at turn end,\n                                       re-engage the agent to fix it (bounded\n                                       by --max-rewakes)\n  --auto-pin                           Force-pin the original task (first user\n                                       turn) through compaction (ON by default;\n                                       disable with CC_AUTO_PIN=0 or config\n                                       context.autoPin=false)\n  --max-rewakes <n>                    Max auto-rewake re-drives per run\n                                       (default 1); implies --auto-rewake\n  --bg, --background                   Start as a detached background agent and\n                                       return its id immediately\n  --agent-id <id>                      Agent id for scoped memory recall\n  --recall-limit <n>                   Top-K memories to inject into system\n                                       prompt\n  --recall-query <q>                   Query string for startup memory recall\n  --no-recall-memory                   Disable startup memory recall\n  --vim                                Start the interactive REPL in vim-mode\n                                       line editing (toggle later with /vim; or\n                                       CC_VIM=1)\n  --no-stream                          Disable streamed response rendering\n  --no-park-on-exit                    Close the session-core handle on exit\n                                       instead of parking it\n  --bundle <path>                      Agent bundle directory (may execute\n                                       local MCP commands from mcp.json)\n  -p, --print [prompt]                 Headless: run one non-interactive turn\n                                       and exit\n  --output-format <fmt>                Headless output: text | json |\n                                       stream-json (default: \"text\")\n  --max-turns <n>                      Cap agent loop iterations (headless)\n  --json-schema <file>                 Headless structured output: final reply\n                                       must be JSON validating against this\n                                       schema (invalid replies retried)\n  --allowed-tools <list>               Comma/space-separated tool allow-list\n                                       (headless)\n  --disallowed-tools <list>            Comma/space-separated tool deny-list\n                                       (headless)\n  --permission-mode <mode>             manual | auto | dontAsk | default | plan\n                                       | acceptEdits | bypassPermissions (plan\n                                       headless-only)\n  --no-file-refs                       Disable @path file-reference expansion\n                                       in the prompt (headless)\n  --no-slash-macros                    Disable /name custom-command\n                                       (.claude/commands) expansion in the\n                                       prompt (headless)\n  --system-prompt <text>               Replace the built-in system prompt\n                                       (literal text or @file)\n  --append-system-prompt <text>        Append extra guidance to the system\n                                       prompt (literal text or @file)\n  --no-project-memory                  Skip auto-loaded project memory (cc.md /\n                                       CLAUDE.md / AGENTS.md hierarchy,\n                                       .chainlesschain/rules.md,\n                                       .claude/rules/*.md) — a lean system\n                                       prompt for token-tight surfaces (e.g.\n                                       IDE chat). The agent can still read\n                                       those files with tools when it needs\n                                       them.\n  --output-style <name>                Apply a named output-style persona\n                                       (.claude/output-styles/<name>.md or a\n                                       built-in: concise | explanatory |\n                                       learning)\n  --input-format <fmt>                 Headless input: text | stream-json\n                                       (NDJSON user events on stdin,\n                                       multi-turn) (default: \"text\")\n  --trace-id <id>                      Correlation id stamped as `trace_id` on\n                                       every stream-json output line (also read\n                                       from CC_TRACE_ID). Lets an IDE/bridge\n                                       trace one run across its own logs, the\n                                       CLI, transcripts and diagnostics.\n                                       Auto-generated per run when omitted.\n  --fallback-model <model>             Backup model(s) to try in order when the\n                                       primary fails (transient error or\n                                       model-not-found). Repeatable or\n                                       comma-separated; up to 3. A\n                                       `provider:model` entry (e.g.\n                                       openai:gpt-4o) falls back\n                                       cross-provider, using that provider's\n                                       API key from its env var (skipped if\n                                       unset — never reuses the primary key).\n                                       Defaults to config llm.fallbackModels.\n  --include-partial-messages           Emit live assistant-text deltas as\n                                       stream_event lines (requires\n                                       --output-format stream-json)\n  --goal [id]                          Bind a cc goal into the run (id, or omit\n                                       the value to auto-resolve the active\n                                       goal)\n  --goal-assess                        After the run, ask the model to assess\n                                       goal progress and persist it (opt-in;\n                                       costs one extra completion; requires\n                                       --goal)\n  --goal-condition <spec>              Session completion condition; re-drives\n                                       outer turns until met. Prefix\n                                       exit-zero:/file-exists:/contains:/regex:\n                                       (deterministic) or model:<desc>\n                                       (model-judged)\n  --max-outer-turns <n>                Max outer re-drive turns for\n                                       --goal-condition (default 10, hard cap\n                                       100)\n  --goal-max-tokens <n>                Token budget across --goal-condition\n                                       outer turns\n  --goal-max-cost <usd>                Cost budget (USD) across\n                                       --goal-condition outer turns\n  --goal-max-time <ms>                 Wall-clock budget (ms) across\n                                       --goal-condition outer turns\n  --mcp-config <file>                  Load ad-hoc MCP servers from a JSON file\n                                       for this run (headless); their tools\n                                       become callable (mcp__<server>__<tool>)\n  --no-mcp                             Don't auto-connect MCP servers\n                                       registered with `cc mcp add\n                                       --auto-connect` (--mcp-config still\n                                       loads)\n  --ide                                Force-enable IDE bridge auto-connect:\n                                       discover a running editor's MCP server\n                                       via ~/.chainlesschain/ide/*.json\n                                       (default: auto inside an IDE integrated\n                                       terminal)\n  --no-ide                             Disable IDE bridge auto-connect\n  --pdh                                Force-enable PDH bridge auto-connect:\n                                       discover the Android app's\n                                       device-capability MCP server via\n                                       ~/.chainlesschain/pdh-bridge/*.json\n                                       (default: auto when\n                                       CHAINLESSCHAIN_PDH_PORT is set)\n  --no-pdh                             Disable PDH bridge auto-connect\n  --jetbrains                          Force-enable IntelliJ IDEA built-in MCP\n                                       (IDEA >= 2025.2) as server `idea`\n                                       (default: auto when the ChainlessChain\n                                       JetBrains plugin injects\n                                       CHAINLESSCHAIN_JETBRAINS_MCP_URL)\n  --no-jetbrains                       Disable IDEA built-in MCP auto-connect\n  --interactive-approvals              Stream mode: confirm-tier approvals\n                                       become approval_request/approval\n                                       stdin-stdout events instead of failing\n                                       closed (chat-panel UX)\n  --permission-prompt-tool <tool>      Defer tool approvals to an MCP tool\n                                       (mcp__<server>__<tool>; requires\n                                       --mcp-config) instead of headless\n                                       fail-closed\n  --remote-control                     Route confirm-tier approvals to paired\n                                       mobile/web devices — requires a relay or\n                                       explicit LAN opt-in; headless waits\n                                       fail-closed, interactive races the\n                                       terminal prompt (also /remote-control)\n  --remote-control-allow-lan           Permit --remote-control to expose its\n                                       authenticated WS endpoint on a trusted\n                                       LAN\n  --channels <list>                    Inbound channels for the interactive\n                                       session (webhook[:port],telegram) —\n                                       external events enter as user turns;\n                                       webhook needs its bearer token, telegram\n                                       needs channels.telegram.allowFrom\n  --settings <file>                    Merge an extra\n                                       .claude/settings.json-shaped file for\n                                       this run: permission rules\n                                       (allow/ask/deny) + native config\n                                       overrides (model, env)\n  --max-budget-usd <amount>            Hard USD spend cap: stop the run before\n                                       the next paid LLM call once the\n                                       estimated cost reaches this (headless;\n                                       uses the cc cost price table)\n  --session-budget                     Enable the durable session-wide budget\n                                       authority (headless; requires\n                                       --session/--resume/--continue)\n  --session-max-concurrent <n>         Durable session cap for concurrent child\n                                       work\n  --session-max-spawns <n>             Durable session cap for total child-work\n                                       admissions\n  --session-max-depth <n>              Durable session cap for child-agent\n                                       nesting depth\n  --session-max-turns <n>              Durable session cap for model turns\n                                       across resumes\n  --session-max-tokens <n>             Durable session cap for\n                                       provider-reported tokens across resumes\n  --session-max-cost-usd <amount>      Durable session cost cap across resumes\n                                       (requires priced provider usage)\n  --session-max-wall-ms <n>            Durable session cap for cumulative\n                                       active wall time\n  --session-max-tool-ms <n>            Durable session cap for aggregate tool\n                                       execution time\n  --observability-workspace <id>       Persist a workspace scope on new session\n                                       authority for causal reports\n  --observability-team <id>            Persist a team scope on new session\n                                       authority for causal reports\n  --observability-policy <id>          Persist a policy scope on new session\n                                       authority for causal reports\n  --strict-mcp-config                  Use ONLY --mcp-config servers; ignore\n                                       registered (cc mcp add) and IDE-bridge\n                                       MCP for a reproducible tool surface\n  --project-mcp                        Opt in to loading a project-scoped\n                                       .mcp.json (default off; a checked-in\n                                       .mcp.json can spawn commands)\n  --replay-user-messages               Stream-input mode: echo each accepted\n                                       stdin user message back as a `user`\n                                       event (transcript/correlation)\n  --allow-dangerous-bypass             Bypass all permission prompts in\n                                       headless mode (DANGEROUS: auto-approves\n                                       all tool calls) (default: false)\n  -y, --yolo                           Alias for --allow-dangerous-bypass\n                                       (default: false)\n  --dangerously-skip-permissions       Alias for --allow-dangerous-bypass\n                                       (default: false)\n  -h, --help                           display help for command\n",
+    "agent": "Usage: chainlesschain agent|a [options] [task...]\n\nStart an agentic AI session (reads/writes files, runs commands)\n\nArguments:\n  task                                 Headless task 鈥?when given (or with -p /\n                                       piped stdin), runs non-interactively\n\nOptions:\n  --model <model>                      Model name\n  --provider <provider>                LLM provider (ollama, openai,\n                                       volcengine, deepseek, ...)\n  --base-url <url>                     API base URL\n  --api-key <key>                      API key\n  --think [level]                      Enable Anthropic extended thinking\n                                       (level: think | hard | ultra; Anthropic\n                                       models only)\n  --ultrathink                         Maximum Anthropic extended thinking (=\n                                       --think ultra)\n  --thinking-budget <n>                Thinking token budget for legacy Claude\n                                       models (Sonnet 4.5 / Opus 4.0-4.5 /\n                                       older); clamped below max_tokens.\n                                       Adaptive-thinking models ignore it (they\n                                       use --think's effort). Requires\n                                       --think/--ultrathink.\n  --image <path>                       Attach an image (png/jpg/jpeg/gif/webp)\n                                       to the prompt for a vision-capable model\n                                       (headless; repeatable)\n  --vision-model <id>                  Model to use when an image is attached\n                                       (default: config llm.visionModel or\n                                       doubao-seed-2-0-lite-260215)\n  --session <id>                       Resume a previous agent session\n  -c, --continue                       Resume the most recent session (no id\n                                       needed 鈥?claude --continue parity)\n  --resume [id]                        Resume a session by id (no id 鈫?most\n                                       recent 鈥?claude --resume parity)\n  --fork-session                       When resuming, branch into a NEW session\n                                       id and leave the original untouched\n                                       (claude --fork-session parity)\n  --fork-request-id <key>              Stable idempotency key for\n                                       --fork-session retries (omit for a new\n                                       fork each invocation)\n  --add-dir <dir>                      Extra working directory the agent may\n                                       read/search/edit (repeatable)\n  --checkpoint                         Auto-snapshot the work tree before each\n                                       mutating tool (DEFAULT inside a git\n                                       repo; cc checkpoint restore to roll\n                                       back)\n  --no-checkpoint                      Disable auto-checkpointing (it is on by\n                                       default inside git repos)\n  --managed-checkpoint                 Checkpoint bounded mutating tools with\n                                       Process Broker; unavailable writer\n                                       lifetimes are reported as coverage none\n  --managed-checkpoint-state <dir>     Durable managed-checkpoint state\n                                       directory (must be outside the\n                                       workspace)\n  --managed-checkpoint-exclude <path>  Explicit workspace path excluded from\n                                       managed checkpoints; repeatable and\n                                       reported as partial coverage\n  --safe-mode                          Run bare: disable project memory,\n                                       settings hooks, memory recall, IDE\n                                       context, status line and update notice\n                                       (permission rules STAY active)\n  --bare                               Everything --safe-mode disables PLUS\n                                       skills, plugins and MCP/IDE auto-connect\n                                       — minimal fast surface for scripted\n                                       calls (explicit --mcp-config still\n                                       loads; permission rules STAY active)\n  --ephemeral                          No session persistence: nothing is\n                                       written to the session store (headless;\n                                       a --resume id still replays history\n                                       read-only)\n  --capabilities                       Print a machine-readable capability\n                                       manifest (JSON: protocol version, tools,\n                                       permission modes, exit codes) and exit\n  --disable-slash-commands             Interactive REPL: don't dispatch '/'\n                                       input as slash commands — it reaches the\n                                       model verbatim (/exit and /quit stay\n                                       live)\n  --ax-screen-reader                   Screen-reader friendly output: no ANSI\n                                       colors, no in-place status line repaints\n                                       (also CC_SCREEN_READER=1)\n  --worktree                           Run this session in a fresh git worktree\n                                       (isolated branch; auto-removed when the\n                                       session changes nothing)\n  --no-worktree                        Background Git task: explicitly share\n                                       the current work tree (intended for\n                                       read-only tasks; writable runs are not\n                                       isolated)\n  --unattended                         Enable fail-closed shell action policy\n                                       for scheduled/event-driven runs\n  --unattended-allow <classes>         Comma-separated action classes\n                                       explicitly allowed for unattended shell\n                                       runs\n  --sandbox [image]                    Run shell commands in an ephemeral\n                                       Docker sandbox (network disabled by\n                                       default)\n  --sandbox-mode <mode>                Sandbox posture: off | workspace-write |\n                                       strict (explicit isolation modes fail\n                                       closed)\n  --sandbox-network                    Allow network access inside --sandbox\n  --otlp <file>                        Write the agent run's OpenTelemetry\n                                       spans (model/tool/retry) as OTLP/JSON to\n                                       <file>\n  --otlp-content                       Include prompt/response CONTENT in\n                                       --otlp spans (off by default; content is\n                                       redacted unless this is set)\n  --auto-rewake                        When an async `asyncRewake` hook (e.g. a\n                                       background test) fails at turn end,\n                                       re-engage the agent to fix it (bounded\n                                       by --max-rewakes)\n  --auto-pin                           Force-pin the original task (first user\n                                       turn) through compaction (ON by default;\n                                       disable with CC_AUTO_PIN=0 or config\n                                       context.autoPin=false)\n  --max-rewakes <n>                    Max auto-rewake re-drives per run\n                                       (default 1); implies --auto-rewake\n  --bg, --background                   Start as a detached background agent and\n                                       return its id immediately\n  --agent-id <id>                      Agent id for scoped memory recall\n  --recall-limit <n>                   Top-K memories to inject into system\n                                       prompt\n  --recall-query <q>                   Query string for startup memory recall\n  --no-recall-memory                   Disable startup memory recall\n  --vim                                Start the interactive REPL in vim-mode\n                                       line editing (toggle later with /vim; or\n                                       CC_VIM=1)\n  --no-stream                          Disable streamed response rendering\n  --no-park-on-exit                    Close the session-core handle on exit\n                                       instead of parking it\n  --bundle <path>                      Agent bundle directory (may execute\n                                       local MCP commands from mcp.json)\n  -p, --print [prompt]                 Headless: run one non-interactive turn\n                                       and exit\n  --output-format <fmt>                Headless output: text | json |\n                                       stream-json (default: \"text\")\n  --max-turns <n>                      Cap agent loop iterations (headless)\n  --json-schema <file>                 Headless structured output: final reply\n                                       must be JSON validating against this\n                                       schema (invalid replies retried)\n  --allowed-tools <list>               Comma/space-separated tool allow-list\n                                       (headless)\n  --disallowed-tools <list>            Comma/space-separated tool deny-list\n                                       (headless)\n  --permission-mode <mode>             manual | auto | dontAsk | default | plan\n                                       | acceptEdits | bypassPermissions (plan\n                                       headless-only)\n  --no-file-refs                       Disable @path file-reference expansion\n                                       in the prompt (headless)\n  --no-slash-macros                    Disable /name custom-command\n                                       (.claude/commands) expansion in the\n                                       prompt (headless)\n  --system-prompt <text>               Replace the built-in system prompt\n                                       (literal text or @file)\n  --append-system-prompt <text>        Append extra guidance to the system\n                                       prompt (literal text or @file)\n  --no-project-memory                  Skip auto-loaded project memory (cc.md /\n                                       CLAUDE.md / AGENTS.md hierarchy,\n                                       .chainlesschain/rules.md,\n                                       .claude/rules/*.md) — a lean system\n                                       prompt for token-tight surfaces (e.g.\n                                       IDE chat). The agent can still read\n                                       those files with tools when it needs\n                                       them.\n  --output-style <name>                Apply a named output-style persona\n                                       (.claude/output-styles/<name>.md or a\n                                       built-in: concise | explanatory |\n                                       learning)\n  --input-format <fmt>                 Headless input: text | stream-json\n                                       (NDJSON user events on stdin,\n                                       multi-turn) (default: \"text\")\n  --trace-id <id>                      Correlation id stamped as `trace_id` on\n                                       every stream-json output line (also read\n                                       from CC_TRACE_ID). Lets an IDE/bridge\n                                       trace one run across its own logs, the\n                                       CLI, transcripts and diagnostics.\n                                       Auto-generated per run when omitted.\n  --fallback-model <model>             Backup model(s) to try in order when the\n                                       primary fails (transient error or\n                                       model-not-found). Repeatable or\n                                       comma-separated; up to 3. A\n                                       `provider:model` entry (e.g.\n                                       openai:gpt-4o) falls back\n                                       cross-provider, using that provider's\n                                       API key from its env var (skipped if\n                                       unset — never reuses the primary key).\n                                       Defaults to config llm.fallbackModels.\n  --include-partial-messages           Emit live assistant-text deltas as\n                                       stream_event lines (requires\n                                       --output-format stream-json)\n  --include-hook-events                Emit redacted hook and subagent\n                                       lifecycle events (requires\n                                       --output-format stream-json)\n  --goal [id]                          Bind a cc goal into the run (id, or omit\n                                       the value to auto-resolve the active\n                                       goal)\n  --goal-assess                        After the run, ask the model to assess\n                                       goal progress and persist it (opt-in;\n                                       costs one extra completion; requires\n                                       --goal)\n  --goal-condition <spec>              Session completion condition; re-drives\n                                       outer turns until met. Prefix\n                                       exit-zero:/file-exists:/contains:/regex:\n                                       (deterministic) or model:<desc>\n                                       (model-judged)\n  --max-outer-turns <n>                Max outer re-drive turns for\n                                       --goal-condition (default 10, hard cap\n                                       100)\n  --goal-max-tokens <n>                Token budget across --goal-condition\n                                       outer turns\n  --goal-max-cost <usd>                Cost budget (USD) across\n                                       --goal-condition outer turns\n  --goal-max-time <ms>                 Wall-clock budget (ms) across\n                                       --goal-condition outer turns\n  --mcp-config <file>                  Load ad-hoc MCP servers from a JSON file\n                                       for this run (headless); their tools\n                                       become callable (mcp__<server>__<tool>)\n  --no-mcp                             Don't auto-connect MCP servers\n                                       registered with `cc mcp add\n                                       --auto-connect` (--mcp-config still\n                                       loads)\n  --ide                                Force-enable IDE bridge auto-connect:\n                                       discover a running editor's MCP server\n                                       via ~/.chainlesschain/ide/*.json\n                                       (default: auto inside an IDE integrated\n                                       terminal)\n  --no-ide                             Disable IDE bridge auto-connect\n  --pdh                                Force-enable PDH bridge auto-connect:\n                                       discover the Android app's\n                                       device-capability MCP server via\n                                       ~/.chainlesschain/pdh-bridge/*.json\n                                       (default: auto when\n                                       CHAINLESSCHAIN_PDH_PORT is set)\n  --no-pdh                             Disable PDH bridge auto-connect\n  --jetbrains                          Force-enable IntelliJ IDEA built-in MCP\n                                       (IDEA >= 2025.2) as server `idea`\n                                       (default: auto when the ChainlessChain\n                                       JetBrains plugin injects\n                                       CHAINLESSCHAIN_JETBRAINS_MCP_URL)\n  --no-jetbrains                       Disable IDEA built-in MCP auto-connect\n  --interactive-approvals              Stream mode: confirm-tier approvals\n                                       become approval_request/approval\n                                       stdin-stdout events instead of failing\n                                       closed (chat-panel UX)\n  --permission-prompt-tool <tool>      Defer tool approvals to an MCP tool\n                                       (mcp__<server>__<tool>; requires\n                                       --mcp-config) instead of headless\n                                       fail-closed\n  --remote-control                     Route confirm-tier approvals to paired\n                                       mobile/web devices — requires a relay or\n                                       explicit LAN opt-in; headless waits\n                                       fail-closed, interactive races the\n                                       terminal prompt (also /remote-control)\n  --remote-control-allow-lan           Permit --remote-control to expose its\n                                       authenticated WS endpoint on a trusted\n                                       LAN\n  --channels <list>                    Inbound channels for the interactive\n                                       session (webhook[:port],telegram) —\n                                       external events enter as user turns;\n                                       webhook needs its bearer token, telegram\n                                       needs channels.telegram.allowFrom\n  --settings <file>                    Merge an extra\n                                       .claude/settings.json-shaped file for\n                                       this run: permission rules\n                                       (allow/ask/deny) + native config\n                                       overrides (model, env)\n  --max-budget-usd <amount>            Hard USD spend cap: stop the run before\n                                       the next paid LLM call once the\n                                       estimated cost reaches this (headless;\n                                       uses the cc cost price table)\n  --session-budget                     Enable the durable session-wide budget\n                                       authority (headless; requires\n                                       --session/--resume/--continue)\n  --session-max-concurrent <n>         Durable session cap for concurrent child\n                                       work\n  --session-max-spawns <n>             Durable session cap for total child-work\n                                       admissions\n  --session-max-depth <n>              Durable session cap for child-agent\n                                       nesting depth\n  --session-max-turns <n>              Durable session cap for model turns\n                                       across resumes\n  --session-max-tokens <n>             Durable session cap for\n                                       provider-reported tokens across resumes\n  --session-max-cost-usd <amount>      Durable session cost cap across resumes\n                                       (requires priced provider usage)\n  --session-max-wall-ms <n>            Durable session cap for cumulative\n                                       active wall time\n  --session-max-tool-ms <n>            Durable session cap for aggregate tool\n                                       execution time\n  --observability-workspace <id>       Persist a workspace scope on new session\n                                       authority for causal reports\n  --observability-team <id>            Persist a team scope on new session\n                                       authority for causal reports\n  --observability-policy <id>          Persist a policy scope on new session\n                                       authority for causal reports\n  --strict-mcp-config                  Use ONLY --mcp-config servers; ignore\n                                       registered (cc mcp add) and IDE-bridge\n                                       MCP for a reproducible tool surface\n  --project-mcp                        Opt in to loading a project-scoped\n                                       .mcp.json (default off; a checked-in\n                                       .mcp.json can spawn commands)\n  --replay-user-messages               Stream-input mode: echo each accepted\n                                       stdin user message back as a `user`\n                                       event (transcript/correlation)\n  --allow-dangerous-bypass             Bypass all permission prompts in\n                                       headless mode (DANGEROUS: auto-approves\n                                       all tool calls) (default: false)\n  -y, --yolo                           Alias for --allow-dangerous-bypass\n                                       (default: false)\n  --dangerously-skip-permissions       Alias for --allow-dangerous-bypass\n                                       (default: false)\n  -h, --help                           display help for command\n",
     "agent-network": "Usage: chainlesschain agent-network|anet [options] [command]\n\nDecentralized Agent Network (Phase 24) — DID / registry / credentials / task\nrouting\n\nOptions:\n  -h, --help                                           display help for command\n\nCommands:\n  config [options]                                     Show network constants & reputation weights\n  dimensions [options]                                 List reputation dimensions\n  task-statuses [options]                              List task lifecycle statuses\n  did-create [options]                                 Create an Agent DID (Ed25519 + DID document)\n  did-resolve [options] <did>                          Resolve DID → DID document\n  dids [options]                                       List Agent DIDs\n  did-deactivate [options] <did>                       Deactivate a DID (also forces registry offline)\n  sign [options] <did> <data>                          Sign data with agent's Ed25519 key\n  verify [options] <did> <data> <signature>            Verify a signature from an agent\n  register [options] <did> <orgId>                     Register an Agent in the federated registry\n  unregister [options] <did>                           Remove an Agent from the registry\n  heartbeat [options] <did>                            Bump last_heartbeat (forces online)\n  discover [options]                                   Discover agents (capability / org / status)\n  sweep [options]                                      Mark stale online agents offline\n  peer-add [options] <peerId>                          Add/update a Kademlia peer (k-bucket auto-computed)\n  peer-remove [options] <peerId>                       Remove a peer\n  peers [options]                                      List peers (optionally by k-bucket)\n  auth-start [options] <did>                           Issue an auth challenge for a DID\n  auth-complete [options] <sessionId> <signature>      Complete auth with signature over challenge\n  auth-validate [options] <token>                      Validate a session token (returns agentDid or exits 1)\n  auth-sessions [options]                              List auth sessions\n  credential-issue [options] <issuerDid> <subjectDid>  Issue a VC with HMAC/Ed25519 proof\n  credential-verify [options] <id>                     Verify a VC (signature + expiry + revocation)\n  credential-revoke [options] <id>                     Revoke a credential\n  credential-show [options] <id>                       Show a credential\n  credentials [options]                                List credentials (filter by subject/issuer/status/type)\n  task-route [options] <sourceOrg> <taskType>          Route task → pick best-rep agent matching capability\n  task-show [options] <taskId>                         Show a task\n  task-status [options] <taskId> <status>              Update task status (terminal states set completedAt)\n  task-cancel [options] <taskId>                       Cancel a task (sets CANCELLED + reason)\n  tasks [options]                                      List tasks\n  rep-update [options] <did> <dimension> <score>       Record a reputation observation\n  rep-show [options] <did>                             Show reputation summary (weighted total + per-dim avg)\n  rep-history [options] <did>                          Show reputation history (newest first)\n  rep-top [options]                                    Top agents by dimension (or total)\n  stats [options]                                      Network-level statistics\n  agent-maturities-v2                                  List V2 agent maturity states\n  task-lifecycles-v2                                   List V2 task lifecycle states\n  stats-v2                                             V2 agent-network stats\n  get-max-active-agents-v2                             Get max active agents per network (V2)\n  set-max-active-agents-v2 <n>                         Set max active agents per network (V2)\n  get-max-pending-tasks-v2                             Get max pending tasks per agent (V2)\n  set-max-pending-tasks-v2 <n>                         Set max pending tasks per agent (V2)\n  get-agent-idle-ms-v2                                 Get agent idle threshold (V2)\n  set-agent-idle-ms-v2 <ms>                            Set agent idle threshold (V2)\n  get-task-stuck-ms-v2                                 Get task stuck threshold (V2)\n  set-task-stuck-ms-v2 <ms>                            Set task stuck threshold (V2)\n  active-agent-count-v2 <networkId>                    Active agent count for network (V2)\n  pending-task-count-v2 <agentId>                      Pending task count for agent (V2)\n  register-agent-v2 [options] <id>                     Register a V2 agent\n  get-agent-v2 <id>                                    Get a V2 agent\n  list-agents-v2 [options]                             List V2 agents\n  set-agent-status-v2 <id> <next>                      Set V2 agent status\n  activate-agent-v2 <id>                               Activate a V2 agent\n  suspend-agent-v2 <id>                                Suspend a V2 agent\n  revoke-agent-v2 <id>                                 Revoke a V2 agent\n  touch-agent-v2 <id>                                  Touch a V2 agent\n  create-task-v2 [options] <id>                        Create a V2 task\n  get-task-v2 <id>                                     Get a V2 task\n  list-tasks-v2 [options]                              List V2 tasks\n  set-task-status-v2 <id> <next>                       Set V2 task status\n  start-task-v2 <id>                                   Start a V2 task\n  complete-task-v2 <id>                                Complete a V2 task\n  fail-task-v2 <id>                                    Fail a V2 task\n  cancel-task-v2 <id>                                  Cancel a V2 task\n  auto-suspend-idle-agents-v2                          Auto-suspend idle V2 agents\n  auto-fail-stuck-tasks-v2                             Auto-fail stuck V2 tasks\n  help [command]                                       display help for command\n",
     "agents": "Usage: chainlesschain agents [options] [command]\n\nUser-defined subagents (.claude/agents/*.md)\n\nOptions:\n  -h, --help                        display help for command\n\nCommands:\n  background|bg [options]           List background agent sessions\n  logs [options] <id>               Print recent output from a background agent\n  view [options] <id>               Show a detailed background agent view\n  stop [options] <id>               Stop a running background agent\n  rename [options] <id> <title...>  Rename a background agent session\n  list|ls [options]                 List discovered subagents (project +\n                                    personal)\n  show [options] <name>             Show an agent's metadata + system prompt\n  run [options] <name> [task...]    Run a task headlessly as the named subagent\n  new [options] <name>              Scaffold a new agent file (project-native\n                                    .chainlesschain/agents/)\n  help [command]                    display help for command\n",
     "android": "Usage: chainlesschain android [options] [command]\n\nAndroid-native bridge: ContentResolver / SAF / Accessibility / Shizuku / root\n(Plan A A7)\n\nOptions:\n  -h, --help              display help for command\n\nCommands:\n  caps [options]          Probe what bridge capabilities are available on this\n                          device\n  contacts                ContentResolver: contacts\n  sms                     ContentResolver: SMS\n  calls                   ContentResolver: call log\n  app                     PackageManager: app inventory + Intent\n  fs                      SAF / sandbox filesystem\n  a11y                    Accessibility Service\n  shizuku                 Shizuku ADB-like privileges\n  root                    Magisk root su\n  perms [options] <name>  Check (and request) a runtime permission\n  help [command]          display help for command\n",
@@ -63,7 +63,7 @@
     "federation": "Usage: chainlesschain federation [options] [command]\n\nFederation hardening system (Phase 58)\n\nOptions:\n  -h, --help                                       display help for command\n\nCommands:\n  circuit-states [options]                         List circuit breaker states\n  health-statuses [options]                        List health statuses\n  health-metrics [options]                         List health check metric types\n  register [options] <node-id>                     Register a federation node with circuit breaker\n  remove [options] <node-id>                       Remove a federation node\n  breaker-show [options] <node-id>                 Show circuit breaker state for a node\n  breakers [options]                               List circuit breakers\n  failure [options] <node-id>                      Record a failure for a node (may trip breaker)\n  success [options] <node-id>                      Record a success for a node (may close breaker)\n  half-open [options] <node-id>                    Try transitioning an open breaker to half-open\n  reset [options] <node-id>                        Reset circuit breaker to closed state\n  check [options] <node-id>                        Record a health check result\n  check-show [options] <check-id>                  Show health check details\n  checks [options]                                 List health checks\n  node-health [options] <node-id>                  Get aggregated health status for a node\n  pool-init [options] <node-id>                    Initialize a connection pool for a node\n  pool-acquire [options] <node-id>                 Acquire a connection from pool\n  pool-release [options] <node-id>                 Release a connection back to pool\n  pool-stats [options] <node-id>                   Show connection pool stats\n  pools [options]                                  List all connection pools\n  pool-destroy [options] <node-id>                 Destroy a connection pool\n  stats [options]                                  Federation hardening statistics\n  node-statuses-v2 [options]                       List V2 node lifecycle statuses\n  default-failure-threshold [options]              Default circuit-breaker failure threshold\n  failure-threshold [options]                      Current failure threshold\n  set-failure-threshold [options] <n>              Set failure threshold (positive integer)\n  default-half-open-cooldown-ms [options]          Default half-open cooldown in ms\n  half-open-cooldown-ms [options]                  Current half-open cooldown in ms\n  set-half-open-cooldown-ms [options] <ms>         Set half-open cooldown (positive integer ms)\n  default-unhealthy-threshold [options]            Default consecutive-unhealthy isolation threshold\n  unhealthy-threshold [options]                    Current consecutive-unhealthy threshold\n  set-unhealthy-threshold [options] <n>            Set consecutive-unhealthy threshold\n  default-max-active-nodes [options]               Default max active nodes cap\n  max-active-nodes [options]                       Current max active nodes cap\n  active-node-count [options]                      Number of currently ACTIVE nodes\n  set-max-active-nodes [options] <n>               Set max active nodes cap\n  register-v2 [options] <node-id>                  Register a node with V2 lifecycle tracking\n  node-status-v2 [options] <node-id>               Get V2 node status\n  set-node-status-v2 [options] <node-id> <status>  Transition node to a new status\n  record-health-v2 [options] <node-id>             Record a V2 health check (throws on invalid input)\n  trip-circuit [options] <node-id>                 Force-trip a circuit breaker (closed/half_open → open)\n  auto-isolate-unhealthy [options]                 Bulk-isolate ACTIVE nodes with N consecutive UNHEALTHY checks\n  stats-v2 [options]                               V2 federation hardening statistics\n  help [command]                                   display help for command\n",
     "fflag": "Usage: chainlesschain fflag [options] [command]\n\nFeature Flags V2 governance (in-memory, CLI v0.143.0)\n\nOptions:\n  -h, --help                      display help for command\n\nCommands:\n  enums-v2                        Show V2 maturity + lifecycle enums\n  register-profile-v2 [options]   Register a feature flag profile (pending)\n  activate-profile-v2 <id>        Transition profile to active\n  pause-profile-v2 <id>           Transition profile to paused\n  archive-profile-v2 <id>         Transition profile to archived (terminal)\n  touch-profile-v2 <id>           Refresh lastTouchedAt\n  get-profile-v2 <id>             Get a profile by id\n  list-profiles-v2                List all profiles\n  create-eval-v2 [options]        Create an eval (queued)\n  evaluating-eval-v2 <id>         Mark eval as evaluating\n  evaluate-eval-v2 <id>           Mark eval as evaluated (terminal)\n  fail-eval-v2 [options] <id>     Mark eval as failed (terminal)\n  cancel-eval-v2 [options] <id>   Mark eval as cancelled (terminal)\n  get-eval-v2 <id>                Get an eval by id\n  list-evals-v2                   List all evals\n  config-v2                       Show V2 config (caps + idle/stuck windows)\n  set-max-active-profiles-v2 <n>  Set max active profiles per owner\n  set-max-pending-evals-v2 <n>    Set max pending evals per profile\n  set-profile-idle-ms-v2 <ms>     Set profile idle window\n  set-eval-stuck-ms-v2 <ms>       Set eval stuck window\n  auto-pause-idle-v2              Auto-pause idle active profiles\n  auto-fail-stuck-v2              Auto-fail stuck evaluating evals\n  gov-stats-v2                    Show V2 governance stats\n  help [command]                  display help for command\n",
     "fusion": "Usage: chainlesschain fusion [options] [command]\n\nProtocol fusion & AI social (Phase 72-73)\n\nOptions:\n  -h, --help                                                     display help for command\n\nCommands:\n  protocols [options]                                            List supported protocols\n  quality-levels [options]                                       List quality levels\n  send [options]                                                 Send cross-protocol message\n  msg-show [options] <id>                                        Show message details\n  messages [options]                                             List unified messages\n  map-identity [options]                                         Create identity mapping\n  identity [options] <did>                                       Look up identity mapping by DID\n  identities [options]                                           List identity mappings\n  verify-identity [options] <id>                                 Verify an identity mapping\n  assess [options] <content>                                     Assess content quality\n  quality-show [options] <id>                                    Show quality score details\n  quality-scores [options]                                       List quality scores\n  quality-report [options]                                       Content quality report\n  translate [options] <text>                                     Translate text (simulated)\n  detect-lang [options] <text>                                   Detect language of text\n  translation-stats [options]                                    Translation cache statistics\n  stats [options]                                                Protocol fusion & AI social statistics\n  bridge-maturities-v2                                           List BRIDGE_MATURITY_V2 enum values\n  translation-runs-v2                                            List TRANSLATION_RUN_V2 enum values\n  max-active-bridges-per-operator                                Get current max-active-bridges-per-operator cap\n  set-max-active-bridges-per-operator <n>                        Set max-active-bridges-per-operator cap\n  max-running-translations-per-bridge                            Get current max-running-translations-per-bridge cap\n  set-max-running-translations-per-bridge <n>                    Set max-running-translations-per-bridge cap\n  bridge-idle-ms                                                 Get current bridge-idle-ms threshold\n  set-bridge-idle-ms <n>                                         Set bridge-idle-ms threshold\n  translation-stuck-ms                                           Get current translation-stuck-ms threshold\n  set-translation-stuck-ms <n>                                   Set translation-stuck-ms threshold\n  active-bridge-count [options]                                  Count non-retired, non-provisional bridges (optionally by operator)\n  running-translation-count [options]                            Count RUNNING translations (optionally by bridge)\n  register-bridge-v2 [options] <bridge-id>                       Register V2 bridge (provisional by default)\n  bridge-v2 <bridge-id>                                          Show V2 bridge state\n  list-bridges-v2 [options]                                      List V2 bridges\n  set-bridge-maturity-v2 [options] <bridge-id> <status>          Transition V2 bridge maturity\n  activate-bridge [options] <bridge-id>                          Shortcut for activate transition\n  degrade-bridge [options] <bridge-id>                           Shortcut for degrade transition\n  deprecate-bridge [options] <bridge-id>                         Shortcut for deprecate transition\n  retire-bridge [options] <bridge-id>                            Shortcut for retire transition\n  touch-bridge-usage <bridge-id>                                 Mark V2 bridge as used now (for idle auto-retire)\n  enqueue-translation-v2 [options] <translation-id>              Enqueue a V2 translation run\n  translation-v2 <translation-id>                                Show V2 translation state\n  list-translations-v2 [options]                                 List V2 translations\n  set-translation-status-v2 [options] <translation-id> <status>  Transition V2 translation status\n  start-translation [options] <translation-id>                   Shortcut for start transition\n  succeed-translation [options] <translation-id>                 Shortcut for succeed transition\n  fail-translation [options] <translation-id>                    Shortcut for fail transition\n  cancel-translation [options] <translation-id>                  Shortcut for cancel transition\n  auto-retire-idle-bridges                                       Bulk-retire ACTIVE/DEGRADED/DEPRECATED bridges whose lastUsedAt is older than bridgeIdleMs\n  auto-fail-stuck-running-translations                           Bulk-fail RUNNING translations whose startedAt is older than translationStuckMs\n  stats-v2                                                       Show V2 stats with all-enum zero-initialized counters\n  help [command]                                                 display help for command\n",
-    "git": "Usage: chainlesschain git [options] [command]\n\nGit integration for knowledge base versioning\n\nOptions:\n  -h, --help                       display help for command\n\nCommands:\n  status [options]                 Show git status of the knowledge base\n                                   directory\n  init [options]                   Initialize a git repository\n  auto-commit [options]            Auto-commit all changes with a generated\n                                   message\n  hooks [options]                  Install git hooks for the knowledge base\n  history-analyze [options]        Analyze repository history and statistics\n  enums-v2 [options]               List Git V2 enums\n  config-set-v2 [options]          Set Git V2 caps/thresholds\n  register-repo-v2 [options] <id>  Register Git V2 repo\n  activate-repo-v2 <id>            Activate Git V2 repo\n  archive-repo-v2 <id>             Archive Git V2 repo\n  decommission-repo-v2 <id>        Decommission Git V2 repo\n  touch-repo-v2 <id>               Touch Git V2 repo\n  get-repo-v2 [options] <id>       Get Git V2 repo\n  list-repos-v2 [options]          List Git V2 repos\n  create-commit-v2 [options] <id>  Create Git V2 commit\n  start-commit-v2 <id>             Start Git V2 commit\n  commit-commit-v2 <id>            Commit Git V2 commit\n  fail-commit-v2 [options] <id>    Fail Git V2 commit\n  cancel-commit-v2 [options] <id>  Cancel Git V2 commit\n  get-commit-v2 <id>               Get Git V2 commit\n  list-commits-v2                  List Git V2 commits\n  auto-archive-repos-v2            Auto-archive idle Git V2 repos\n  auto-fail-commits-v2             Auto-fail stuck Git V2 commits\n  gov-stats-v2 [options]           Git V2 governance stats\n  help [command]                   display help for command\n",
+    "git": "Usage: chainlesschain git [options] [command]\n\nGit integration for knowledge base versioning\n\nOptions:\n  -h, --help                       display help for command\n\nCommands:\n  gitlab-mr [options] <reference>  Render a local GitLab MR/worktree footer (no\n                                   network I/O)\n  status [options]                 Show git status of the knowledge base\n                                   directory\n  init [options]                   Initialize a git repository\n  auto-commit [options]            Auto-commit all changes with a generated\n                                   message\n  hooks [options]                  Install git hooks for the knowledge base\n  history-analyze [options]        Analyze repository history and statistics\n  enums-v2 [options]               List Git V2 enums\n  config-set-v2 [options]          Set Git V2 caps/thresholds\n  register-repo-v2 [options] <id>  Register Git V2 repo\n  activate-repo-v2 <id>            Activate Git V2 repo\n  archive-repo-v2 <id>             Archive Git V2 repo\n  decommission-repo-v2 <id>        Decommission Git V2 repo\n  touch-repo-v2 <id>               Touch Git V2 repo\n  get-repo-v2 [options] <id>       Get Git V2 repo\n  list-repos-v2 [options]          List Git V2 repos\n  create-commit-v2 [options] <id>  Create Git V2 commit\n  start-commit-v2 <id>             Start Git V2 commit\n  commit-commit-v2 <id>            Commit Git V2 commit\n  fail-commit-v2 [options] <id>    Fail Git V2 commit\n  cancel-commit-v2 [options] <id>  Cancel Git V2 commit\n  get-commit-v2 <id>               Get Git V2 commit\n  list-commits-v2                  List Git V2 commits\n  auto-archive-repos-v2            Auto-archive idle Git V2 repos\n  auto-fail-commits-v2             Auto-fail stuck Git V2 commits\n  gov-stats-v2 [options]           Git V2 governance stats\n  help [command]                   display help for command\n",
     "goal": "Usage: chainlesschain goal [options] [command]\n\nCross-session persistent goals / OKRs\n\nOptions:\n  -h, --help                         display help for command\n\nCommands:\n  set|add [options] <objective>      Create a goal with an objective (and\n                                     optional key results)\n  list|ls [options]                  List goals (newest first)\n  show [options] <id>                Show a goal in full\n  kr                                 Manage key results\n  progress [options] <id>            Record progress: set a percentage and/or\n                                     append a note\n  link [options] <id> [sessionId]    Attach a session to a goal (defaults to\n                                     the latest session)\n  unlink [options] <id> [sessionId]  Detach a session from a goal\n  pause [options] <id>               Mark a goal paused\n  resume [options] <id>              Mark a goal resumed\n  close [options] <id>               Mark a goal closed (done)\n  abandon [options] <id>             Mark a goal abandoned\n  rm|delete [options] <id>           Delete a goal\n  active [options]                   Show the goal that would bind to a run\n                                     (resolution order)\n  help [command]                     display help for command\n",
     "governance": "Usage: chainlesschain governance [options] [command]\n\nCommunity governance — proposals, voting, impact analysis, prediction\n\nOptions:\n  -h, --help                                                   display help for command\n\nCommands:\n  types [options]                                              List proposal types\n  statuses [options]                                           List proposal statuses\n  impact-levels [options]                                      List impact levels\n  create [options] <title>                                     Create a governance proposal (starts as draft)\n  list [options]                                               List proposals\n  show [options] <proposal-id>                                 Show proposal details\n  activate [options] <proposal-id>                             Activate a draft proposal for voting\n  close [options] <proposal-id>                                Close voting — auto-resolves to passed/rejected\n  expire <proposal-id>                                         Mark a draft/active proposal as expired\n  vote [options] <proposal-id> <voter-did> <yes|no|abstain>    Cast a vote (replaces any prior vote by same voter)\n  votes [options] <proposal-id>                                List votes for a proposal\n  tally [options] <proposal-id>                                Show vote tally with quorum/threshold check\n  analyze [options] <proposal-id>                              Run heuristic impact analysis on a proposal\n  predict [options] <proposal-id>                              Predict voting outcome (heuristic or vote-based)\n  stats [options]                                              Governance statistics\n  proposer-maturities-v2 [options]                             List proposer V2 maturity states\n  delegation-lifecycles-v2 [options]                           List delegation V2 lifecycle states\n  default-max-active-proposers-per-realm                       Default per-realm active proposer cap\n  max-active-proposers-per-realm                               Current per-realm active proposer cap\n  set-max-active-proposers-per-realm <n>                       Set per-realm active proposer cap\n  default-max-active-delegations-per-delegator                 Default per-delegator active delegation cap\n  max-active-delegations-per-delegator                         Current per-delegator active delegation cap\n  set-max-active-delegations-per-delegator <n>                 Set per-delegator active delegation cap\n  default-proposer-idle-ms                                     Default proposer idle window (ms)\n  proposer-idle-ms                                             Current proposer idle window (ms)\n  set-proposer-idle-ms <ms>                                    Set proposer idle window (ms)\n  default-pending-delegation-ms                                Default pending delegation window (ms)\n  pending-delegation-ms                                        Current pending delegation window (ms)\n  set-pending-delegation-ms <ms>                               Set pending delegation window (ms)\n  active-proposer-count [options]                              Count active V2 proposers (scope by realm)\n  active-delegation-count [options]                            Count active V2 delegations (scope by delegator)\n  register-proposer-v2 [options] <proposer-id>                 Register a V2 proposer\n  proposer-v2 <proposer-id>                                    Get V2 proposer record\n  set-proposer-maturity-v2 [options] <proposer-id> <status>    Set proposer V2 maturity status\n  activate-proposer [options] <proposer-id>                    Activate V2 proposer\n  suspend-proposer [options] <proposer-id>                     Suspend V2 proposer\n  retire-proposer [options] <proposer-id>                      Retire V2 proposer (terminal)\n  touch-proposer-activity <proposer-id>                        Touch V2 proposer lastActivityAt\n  create-delegation-v2 [options] <delegation-id>               Create V2 vote delegation\n  delegation-v2 <delegation-id>                                Get V2 delegation record\n  set-delegation-status-v2 [options] <delegation-id> <status>  Set delegation V2 status\n  activate-delegation [options] <delegation-id>                Activate V2 delegation\n  revoke-delegation [options] <delegation-id>                  Revoke V2 delegation (terminal)\n  expire-delegation [options] <delegation-id>                  Expire V2 delegation (terminal)\n  auto-retire-idle-proposers                                   Auto-retire active/suspended proposers past idle window\n  auto-expire-stale-pending-delegations                        Auto-expire pending delegations past window\n  stats-v2                                                     V2 governance statistics\n  help [command]                                               display help for command\n",
     "hardening": "Usage: chainlesschain hardening [options] [command]\n\nSecurity hardening — baselines, audits, regression detection\n\nOptions:\n  -h, --help                                               display help for command\n\nCommands:\n  baseline                                                 Performance baseline management\n  audit                                                    Security audit management\n  config-check [options] <config-path>                     Audit a config file (presence, required keys, placeholders)\n  deploy-check [options]                                   Evaluate the 6-item production-deployment checklist\n  audit-statuses-v2 [options]                              List V2 audit lifecycle statuses\n  baseline-statuses-v2 [options]                           List V2 baseline lifecycle statuses\n  severities-v2 [options]                                  List V2 severity buckets\n  default-max-concurrent-audits [options]                  Default concurrent audit cap\n  max-concurrent-audits [options]                          Current concurrent audit cap\n  set-max-concurrent-audits [options] <n>                  Set concurrent audit cap\n  default-baseline-retention-ms [options]                  Default baseline retention in ms\n  baseline-retention-ms [options]                          Current baseline retention in ms\n  set-baseline-retention-ms [options] <ms>                 Set baseline retention in ms\n  default-audit-timeout-ms [options]                       Default audit timeout in ms\n  audit-timeout-ms [options]                               Current audit timeout in ms\n  set-audit-timeout-ms [options] <ms>                      Set audit timeout in ms\n  running-audit-count [options]                            Number of currently RUNNING audits\n  register-audit-v2 [options] <name>                       Register a V2 audit entry (PENDING)\n  start-audit [options] <audit-id>                         Start a PENDING audit (enforces concurrency cap)\n  complete-audit [options] <audit-id>                      Complete a RUNNING audit\n  set-audit-status-v2 [options] <audit-id> <status>        Transition audit to a new status\n  audit-status-v2 [options] <audit-id>                     Get V2 audit status\n  auto-timeout-audits [options]                            Bulk-fail RUNNING audits past auditTimeoutMs\n  create-baseline-v2 [options] <name>                      Create a V2 baseline (DRAFT)\n  activate-baseline [options] <baseline-id>                Activate a DRAFT baseline (supersedes previous ACTIVE)\n  set-baseline-status-v2 [options] <baseline-id> <status>  Transition baseline to a new status\n  baseline-status-v2 [options] <baseline-id>               Get V2 baseline status\n  auto-archive-stale-baselines [options]                   Bulk-archive SUPERSEDED baselines past retention\n  stats-v2 [options]                                       V2 hardening statistics\n  help [command]                                           display help for command\n",
@@ -140,7 +140,7 @@
     "seshsearch": "Usage: chainlesschain seshsearch [options] [command]\n\nSession Search V2 governance\n\nOptions:\n  -h, --help                                  display help for command\n\nCommands:\n  enums-v2\n  config-v2\n  set-max-active-v2 <n>\n  set-max-pending-v2 <n>\n  set-idle-ms-v2 <n>\n  set-stuck-ms-v2 <n>\n  register-profile-v2 [options] <id> <owner>\n  activate-profile-v2 <id>\n  stale-profile-v2 <id>\n  archive-profile-v2 <id>\n  touch-profile-v2 <id>\n  get-profile-v2 <id>\n  list-profiles-v2\n  create-query-v2 [options] <id> <profileId>\n  searching-query-v2 <id>\n  complete-query-v2 <id>\n  fail-query-v2 <id> [reason]\n  cancel-query-v2 <id> [reason]\n  get-query-v2 <id>\n  list-queries-v2\n  auto-stale-idle-v2\n  auto-fail-stuck-v2\n  gov-stats-v2\n  reset-state-v2\n  help [command]                              display help for command\n",
     "seshtail": "Usage: chainlesschain seshtail [options] [command]\n\nSession Tail V2 governance\n\nOptions:\n  -h, --help                              display help for command\n\nCommands:\n  enums-v2\n  config-v2\n  set-max-active-v2 <n>\n  set-max-pending-v2 <n>\n  set-idle-ms-v2 <n>\n  set-stuck-ms-v2 <n>\n  register-sub-v2 [options] <id> <owner>\n  activate-sub-v2 <id>\n  pause-sub-v2 <id>\n  close-sub-v2 <id>\n  touch-sub-v2 <id>\n  get-sub-v2 <id>\n  list-subs-v2\n  create-event-v2 [options] <id> <subId>\n  tailing-event-v2 <id>\n  complete-event-v2 <id>\n  fail-event-v2 <id> [reason]\n  cancel-event-v2 <id> [reason]\n  get-event-v2 <id>\n  list-events-v2\n  auto-pause-idle-v2\n  auto-fail-stuck-v2\n  gov-stats-v2\n  reset-state-v2\n  help [command]                          display help for command\n",
     "seshu": "Usage: chainlesschain seshu [options] [command]\n\nSession Usage V2 governance\n\nOptions:\n  -h, --help                                  display help for command\n\nCommands:\n  enums-v2\n  config-v2\n  set-max-active-v2 <n>\n  set-max-pending-v2 <n>\n  set-idle-ms-v2 <n>\n  set-stuck-ms-v2 <n>\n  register-budget-v2 [options] <id> <owner>\n  activate-budget-v2 <id>\n  exhaust-budget-v2 <id>\n  archive-budget-v2 <id>\n  touch-budget-v2 <id>\n  get-budget-v2 <id>\n  list-budgets-v2\n  create-record-v2 [options] <id> <budgetId>\n  recording-record-v2 <id>\n  record-record-v2 <id>\n  reject-record-v2 <id> [reason]\n  cancel-record-v2 <id> [reason]\n  get-record-v2 <id>\n  list-records-v2\n  auto-exhaust-idle-v2\n  auto-reject-stuck-v2\n  gov-stats-v2\n  reset-state-v2\n  help [command]                              display help for command\n",
-    "session": "Usage: chainlesschain session [options] [command]\n\nConversation session management\n\nOptions:\n  -h, --help                               display help for command\n\nCommands:\n  mcp-recovery                             Inspect or adjudicate verified MCP outcome-unknown calls\n  location                                 Inspect verified execution location, capabilities, and handoff safety\n  budget                                   Inspect or adjudicate a durable session budget authority\n  message                                  Durable cross-session inbox, addressing, policy and receipts\n  list [options]                           List saved sessions\n  projection [options]                     Emit the canonical versioned session projection for IDEs\n  show [options] <id>                      Show a session's messages\n  pr-status [options] [id]                 PR/CI monitor + controlled auto-merge decision for a session's linked PR\n  resume [options] [id]                    Resume a session in chat mode (id optional — interactive picker, or most recent when piped)\n  export [options] <id>                    Export a session as Markdown (canonical JSONL transcript, then legacy DB fallback)\n  search [options] <query>                 Full-text search across agent session transcripts (JSONL --resume store)\n  delete [options] <id>                    Delete a session\n  rename [options] <id> <title...>         Rename a headless (JSONL) session — shows up in session list\n  prune [options]                          Delete JSONL sessions whose last activity is older than a cutoff (newest N always kept)\n  migrate [options] [source]               Migrate legacy JSON session files to JSONL\n  validate [options] [id]                  Validate JSONL session files\n  verify [options] [id]                    Verify transcript hash-chain integrity (tamper-evidence); omit id to verify all\n  repair [options] <id>                    Diagnose and repair one crash-partial final transcript record only\n  index [options] [query]                  Build/refresh the SQLite session index; search it, or mirror sessions off-box\n  policy [options] <id>                    Show or set per-session approval policy\n  lifecycle [options]                      List session-core handles (running/idle/parked)\n  park <id>                                Park a session (persist to disk, free process memory)\n  unpark <id>                              Resume a parked session\n  end [options] <id>                       Close a session (optionally consolidate trace into MemoryStore)\n  tail [options] <id>                      Follow a JSONL session's events (NDJSON on stdout)\n  usage [options] [id]                     Aggregate token usage (per-session or global)\n  observability [options] <request>        Export verified token/USD, retry, tool latency, diff, gate, artifact and PR causality\n  observability-authority [options] <id>   Print the verified headHash/eventCount/scope binding for a delivery flow\n  workflow [options] [id]                  Inspect coding workflow state (.chainlesschain/sessions/)\n  conversation-maturities-v2 [options]     List V2 conversation maturity states\n  turn-lifecycles-v2 [options]             List V2 turn lifecycle states\n  stats-v2 [options]                       Show V2 session stats\n  get-max-active-conv-v2                   Get max active conversations per user\n  set-max-active-conv-v2 <n>               Set max active conversations per user\n  get-max-pending-turns-v2                 Get max pending turns per conversation\n  set-max-pending-turns-v2 <n>             Set max pending turns per conversation\n  get-conv-idle-ms-v2                      Get conversation idle ms\n  set-conv-idle-ms-v2 <ms>                 Set conversation idle ms\n  get-turn-stuck-ms-v2                     Get turn stuck ms\n  set-turn-stuck-ms-v2 <ms>                Set turn stuck ms\n  active-conv-count-v2 <userId>            Count active conversations for user\n  pending-turn-count-v2 <conversationId>   Count pending+streaming turns for conversation\n  register-conversation-v2 [options] <id>  Register V2 conversation (initial=draft)\n  get-conversation-v2 <id>                 Get V2 conversation by id\n  list-conversations-v2 [options]          List V2 conversations\n  activate-conversation-v2 <id>            Transition conversation → active\n  pause-conversation-v2 <id>               Transition conversation → paused\n  archive-conversation-v2 <id>             Transition conversation → archived (terminal)\n  touch-conversation-v2 <id>               Update conversation lastSeenAt\n  create-turn-v2 [options] <id>            Create V2 turn (initial=pending)\n  get-turn-v2 <id>                         Get V2 turn by id\n  list-turns-v2 [options]                  List V2 turns\n  stream-turn-v2 <id>                      Transition turn → streaming\n  complete-turn-v2 <id>                    Transition turn → completed (terminal)\n  fail-turn-v2 <id>                        Transition turn → failed (terminal)\n  cancel-turn-v2 <id>                      Transition turn → cancelled (terminal)\n  auto-archive-idle-conv-v2                Auto-archive idle conversations; output flipped\n  auto-fail-stuck-turns-v2                 Auto-fail stuck streaming turns; output flipped\n  help [command]                           display help for command\n",
+    "session": "Usage: chainlesschain session [options] [command]\n\nConversation session management\n\nOptions:\n  -h, --help                               display help for command\n\nCommands:\n  mcp-recovery                             Inspect or adjudicate verified MCP outcome-unknown calls\n  location                                 Inspect verified execution location, capabilities, and handoff safety\n  budget                                   Inspect or adjudicate a durable session budget authority\n  message                                  Durable cross-session inbox, addressing, policy and receipts\n  group                                    CLI-owned durable session groups and atomic batch moves\n  list [options]                           List saved sessions\n  projection [options]                     Emit the canonical versioned session projection for IDEs\n  show [options] <id>                      Show a session's messages\n  pr-status [options] [id]                 PR/CI monitor + controlled auto-merge decision for a session's linked PR\n  resume [options] [id]                    Resume a session in chat mode (id optional — interactive picker, or most recent when piped)\n  export [options] <id>                    Export a session as Markdown (canonical JSONL transcript, then legacy DB fallback)\n  search [options] <query>                 Full-text search across agent session transcripts (JSONL --resume store)\n  delete [options] <id>                    Delete a session\n  rename [options] <id> <title...>         Rename a headless (JSONL) session — shows up in session list\n  prune [options]                          Delete JSONL sessions whose last activity is older than a cutoff (newest N always kept)\n  migrate [options] [source]               Migrate legacy JSON session files to JSONL\n  validate [options] [id]                  Validate JSONL session files\n  verify [options] [id]                    Verify transcript hash-chain integrity (tamper-evidence); omit id to verify all\n  repair [options] <id>                    Diagnose and repair one crash-partial final transcript record only\n  index [options] [query]                  Build/refresh the SQLite session index; search it, or mirror sessions off-box\n  policy [options] <id>                    Show or set per-session approval policy\n  lifecycle [options]                      List session-core handles (running/idle/parked)\n  park <id>                                Park a session (persist to disk, free process memory)\n  unpark <id>                              Resume a parked session\n  end [options] <id>                       Close a session (optionally consolidate trace into MemoryStore)\n  tail [options] <id>                      Follow a JSONL session's events (NDJSON on stdout)\n  usage [options] [id]                     Aggregate token usage (per-session or global)\n  observability [options] <request>        Export verified token/USD, retry, tool latency, diff, gate, artifact and PR causality\n  observability-authority [options] <id>   Print the verified headHash/eventCount/scope binding for a delivery flow\n  workflow [options] [id]                  Inspect coding workflow state (.chainlesschain/sessions/)\n  conversation-maturities-v2 [options]     List V2 conversation maturity states\n  turn-lifecycles-v2 [options]             List V2 turn lifecycle states\n  stats-v2 [options]                       Show V2 session stats\n  get-max-active-conv-v2                   Get max active conversations per user\n  set-max-active-conv-v2 <n>               Set max active conversations per user\n  get-max-pending-turns-v2                 Get max pending turns per conversation\n  set-max-pending-turns-v2 <n>             Set max pending turns per conversation\n  get-conv-idle-ms-v2                      Get conversation idle ms\n  set-conv-idle-ms-v2 <ms>                 Set conversation idle ms\n  get-turn-stuck-ms-v2                     Get turn stuck ms\n  set-turn-stuck-ms-v2 <ms>                Set turn stuck ms\n  active-conv-count-v2 <userId>            Count active conversations for user\n  pending-turn-count-v2 <conversationId>   Count pending+streaming turns for conversation\n  register-conversation-v2 [options] <id>  Register V2 conversation (initial=draft)\n  get-conversation-v2 <id>                 Get V2 conversation by id\n  list-conversations-v2 [options]          List V2 conversations\n  activate-conversation-v2 <id>            Transition conversation → active\n  pause-conversation-v2 <id>               Transition conversation → paused\n  archive-conversation-v2 <id>             Transition conversation → archived (terminal)\n  touch-conversation-v2 <id>               Update conversation lastSeenAt\n  create-turn-v2 [options] <id>            Create V2 turn (initial=pending)\n  get-turn-v2 <id>                         Get V2 turn by id\n  list-turns-v2 [options]                  List V2 turns\n  stream-turn-v2 <id>                      Transition turn → streaming\n  complete-turn-v2 <id>                    Transition turn → completed (terminal)\n  fail-turn-v2 <id>                        Transition turn → failed (terminal)\n  cancel-turn-v2 <id>                      Transition turn → cancelled (terminal)\n  auto-archive-idle-conv-v2                Auto-archive idle conversations; output flipped\n  auto-fail-stuck-turns-v2                 Auto-fail stuck streaming turns; output flipped\n  help [command]                           display help for command\n",
     "setup": "Usage: chainlesschain setup [options]\n\nInteractive setup wizard for ChainlessChain\n\nOptions:\n  --skip-download  Skip binary download\n  --skip-services  Skip Docker service setup\n  -h, --help       display help for command\n",
     "sganal": "Usage: chainlesschain sganal [options] [command]\n\nSocial Graph Analytics V2 governance (in-memory, CLI v0.143.0)\n\nOptions:\n  -h, --help                      display help for command\n\nCommands:\n  enums-v2\n  register-profile-v2 [options]\n  activate-profile-v2 <id>\n  stale-profile-v2 <id>\n  archive-profile-v2 <id>\n  touch-profile-v2 <id>\n  get-profile-v2 <id>\n  list-profiles-v2\n  create-run-v2 [options]\n  running-run-v2 <id>\n  complete-run-v2 <id>\n  fail-run-v2 [options] <id>\n  cancel-run-v2 [options] <id>\n  get-run-v2 <id>\n  list-runs-v2\n  config-v2\n  set-max-active-profiles-v2 <n>\n  set-max-pending-runs-v2 <n>\n  set-profile-idle-ms-v2 <ms>\n  set-run-stuck-ms-v2 <ms>\n  auto-stale-idle-v2\n  auto-fail-stuck-v2\n  gov-stats-v2\n  help [command]                  display help for command\n",
     "siem": "Usage: chainlesschain siem [options] [command]\n\nSIEM integration — log export to external targets\n\nOptions:\n  -h, --help                                    display help for command\n\nCommands:\n  targets [options]                             List SIEM export targets\n  add-target [options] <type> <url>             Add a SIEM target (splunk_hec, elasticsearch, azure_sentinel)\n  export <target-id>                            Export logs to a SIEM target\n  stats [options]                               Show SIEM export statistics\n  formats                                       List SIEM export formats (V2)\n  target-types                                  List SIEM target types (V2)\n  severities                                    List SIEM severity levels (V2)\n  statuses                                      List SIEM target statuses (V2)\n  default-batch-size                            Show default SIEM batch size (V2)\n  severity-cef <severity>                       Map a SIEM severity to its CEF integer (0-10)\n  format-log [options] <format>                 Format a JSON log payload as cef|leef|json\n  add-target-v2 [options]                       Add a SIEM target via canonical options (V2)\n  remove-target <target-id>                     Remove a SIEM target (V2)\n  set-status <target-id> <status>               Transition a SIEM target's status (V2)\n  export-v2 [options] <target-id>               Batch-export logs to a target (V2)\n  stats-v2                                      Show extended SIEM stats (byFormat/byType/byStatus, V2)\n  by-status <status>                            List SIEM targets filtered by status (V2)\n  enums-v2                                      Show V2 enums (target maturity + export lifecycle)\n  config-v2                                     Show V2 config thresholds\n  set-max-active-targets-v2 <n>                 Set max active targets per operator\n  set-max-pending-exports-v2 <n>                Set max pending exports per target\n  set-target-idle-ms-v2 <n>                     Set target idle threshold (ms)\n  set-export-stuck-ms-v2 <n>                    Set export stuck threshold (ms)\n  register-target-v2 [options] <id> <operator>  Register V2 SIEM target\n  activate-target-v2 <id>                       Activate target\n  degrade-target-v2 <id>                        Degrade target\n  retire-target-v2 <id>                         Retire target (terminal)\n  touch-target-v2 <id>                          Touch target lastTouchedAt\n  get-target-v2 <id>                            Get V2 target\n  list-targets-v2                               List V2 targets\n  create-export-v2 [options] <id> <targetId>    Create V2 export (queued)\n  start-export-v2 <id>                          Start export\n  deliver-export-v2 <id>                        Deliver export\n  fail-export-v2 <id> [reason]                  Fail export\n  cancel-export-v2 <id> [reason]                Cancel export\n  get-export-v2 <id>                            Get V2 export\n  list-exports-v2                               List V2 exports\n  auto-degrade-idle-v2                          Auto-degrade idle targets\n  auto-fail-stuck-v2                            Auto-fail stuck sending exports\n  gov-stats-v2                                  V2 governance aggregate stats\n  help [command]                                display help for command\n",

package/src/commands/agent.js CHANGED Viewed

@@ -30,6 +30,11 @@ import {
   transformBackgroundLaunchArgv,
 } from "../lib/background-command-argv.js";
 import { resolveSessionBudgetRootOptions } from "../lib/session-budget-production-root.js";
+import {
+  captureClaudeStorageLaunchEnvironment,
+  restoreClaudeStorageLaunchEnvironment,
+  validateClaudeStorageLaunchEnvironment,
+} from "../lib/claude-project-auto-memory.js";
 /**
  * Resolve + validate `--add-dir` values into absolute, existing, de-duped
@@ -465,6 +470,10 @@ export function registerAgentCommand(program) {
       "--include-partial-messages",
       "Emit live assistant-text deltas as stream_event lines (requires --output-format stream-json)",
     )
+    .option(
+      "--include-hook-events",
+      "Emit redacted hook and subagent lifecycle events (requires --output-format stream-json)",
+    )
     .option(
       "--goal [id]",
       "Bind a cc goal into the run (id, or omit the value to auto-resolve the active goal)",
@@ -620,6 +629,20 @@ export function registerAgentCommand(program) {
       false,
     )
     .action(async (task, options, command) => {
+      // These variables select canonical config/session storage. Capture and
+      // validate them before any project settings file can merge an arbitrary
+      // `env` map; settings remain useful for child tools but never acquire
+      // launcher authority over transcript or automatic-memory placement.
+      const claudeStorageLaunchEnv = captureClaudeStorageLaunchEnvironment();
+      try {
+        validateClaudeStorageLaunchEnvironment(claudeStorageLaunchEnv, {
+          cwd: process.cwd(),
+        });
+      } catch (error) {
+        process.stderr.write(`Error: ${error.message}\n`);
+        process.exitCode = 1;
+        return;
+      }
       // Scope is immutable session authority. Resolve every scope/fork
       // conflict before worktree creation, session forking, bootstrap, or any
       // other externally visible setup performed by this action.
@@ -636,18 +659,16 @@ export function registerAgentCommand(program) {
       // --capabilities: print the machine-readable manifest and exit — no
       // config, no bootstrap, no network (gap-analysis 2026-07-11 快速收益 #6).
       if (options.capabilities) {
-        const { buildAgentCapabilities } = await import(
-          "../lib/headless-manifest.js"
-        );
+        const { buildAgentCapabilities } =
+          await import("../lib/headless-manifest.js");
         console.log(JSON.stringify(buildAgentCapabilities(), null, 2));
         return;
       }
       let toolAdmission = null;
       if (process.env.CC_TOOL_ADMISSION) {
         try {
-          const { parseToolAdmissionConfig } = await import(
-            "../lib/agent-tool-admission.js"
-          );
+          const { parseToolAdmissionConfig } =
+            await import("../lib/agent-tool-admission.js");
           toolAdmission = parseToolAdmissionConfig(
             process.env.CC_TOOL_ADMISSION,
           );
@@ -724,9 +745,8 @@ export function registerAgentCommand(program) {
       // screen readers (mono theme + no repainting status line). Applied
       // before anything renders.
       {
-        const { screenReaderRequested, applyScreenReaderMode } = await import(
-          "../lib/accessibility.js"
-        );
+        const { screenReaderRequested, applyScreenReaderMode } =
+          await import("../lib/accessibility.js");
         if (screenReaderRequested(options)) {
           applyScreenReaderMode();
         }
@@ -759,9 +779,8 @@ export function registerAgentCommand(program) {
       };
       if (options.worktree !== undefined || backgroundRequested) {
         try {
-          const { resolveBackgroundWorktreePolicy } = await import(
-            "../lib/background-worktree-policy.js"
-          );
+          const { resolveBackgroundWorktreePolicy } =
+            await import("../lib/background-worktree-policy.js");
           worktreeDecision = resolveBackgroundWorktreePolicy({
             background: backgroundRequested,
             worktree: options.worktree,
@@ -813,9 +832,8 @@ export function registerAgentCommand(program) {
       };
       if (worktreeDecision.enabled) {
         try {
-          const { setupAgentWorktree, finishAgentWorktree } = await import(
-            "../lib/agent-worktree.js"
-          );
+          const { setupAgentWorktree, finishAgentWorktree } =
+            await import("../lib/agent-worktree.js");
           _finishAgentWorktreeFn = finishAgentWorktree;
           const detectedRepoRoot = worktreeDecision.repoRoot || invocationCwd;
           const worktreeCwd =
@@ -843,9 +861,8 @@ export function registerAgentCommand(program) {
             const { loadHooks } = await import("../lib/settings-hooks.cjs");
             _worktreeSettingsHooks =
               loadHooks({ cwd: _worktree.repoRoot }).hooks || null;
-            const { runWorktreeCreateHooks, dispatchAsyncHooks } = await import(
-              "../lib/settings-hook-events.js"
-            );
+            const { runWorktreeCreateHooks, dispatchAsyncHooks } =
+              await import("../lib/settings-hook-events.js");
             runWorktreeCreateHooks(_worktreeSettingsHooks, {
               worktreePath: _worktree.path,
               branch: _worktree.branch,
@@ -853,9 +870,8 @@ export function registerAgentCommand(program) {
               cwd: _worktree.path,
             });
             if (!_worktreeAsyncSupervisor) {
-              const { AsyncHookSupervisor } = await import(
-                "../lib/async-hook-supervisor.js"
-              );
+              const { AsyncHookSupervisor } =
+                await import("../lib/async-hook-supervisor.js");
               _worktreeAsyncSupervisor = new AsyncHookSupervisor({
                 persistStats: true,
               });
@@ -940,9 +956,8 @@ export function registerAgentCommand(program) {
       // Claude-Code parity: auto-checkpoint defaults ON inside a git repo
       // (shadow-commit engine, zero working-tree touch); explicit
       // --checkpoint / --no-checkpoint always wins.
-      const { resolveAutoCheckpoint } = await import(
-        "../lib/auto-checkpoint-default.js"
-      );
+      const { resolveAutoCheckpoint } =
+        await import("../lib/auto-checkpoint-default.js");
       const autoCheckpoint = resolveAutoCheckpoint({
         flagValue: options.checkpoint,
         flagSource: command?.getOptionValueSource?.("checkpoint"),
@@ -969,15 +984,13 @@ export function registerAgentCommand(program) {
         if (headlessIntent) {
           // Headless replays the JSONL store only, so resolve "most recent"
           // from there 鈥?a DB-only id would resume into an empty transcript.
-          const { getLastSessionId } = await import(
-            "../harness/jsonl-session-store.js"
-          );
+          const { getLastSessionId } =
+            await import("../harness/jsonl-session-store.js");
           options.session = getLastSessionId();
         } else {
           // Interactive: picker across both stores (agent REPL rebuilds either).
-          const { pickRecentSession } = await import(
-            "../lib/session-picker.js"
-          );
+          const { pickRecentSession } =
+            await import("../lib/session-picker.js");
           const picked = await pickRecentSession(ctx, {
             message: "Resume which agent session?",
           });
@@ -1000,9 +1013,8 @@ export function registerAgentCommand(program) {
       // a no-op (silent) for a fresh run.
       if (options.forkSession && options.session) {
         const store = await import("../harness/jsonl-session-store.js");
-        const { applyForkSession } = await import(
-          "../runtime/headless-runner.js"
-        );
+        const { applyForkSession } =
+          await import("../runtime/headless-runner.js");
         const fork = applyForkSession(
           {
             forkSession: true,
@@ -1024,16 +1036,16 @@ export function registerAgentCommand(program) {
         }
       }
-      // --include-partial-messages only makes sense for NDJSON output: the
-      // stream-input mode is always NDJSON, otherwise require stream-json
-      // explicitly (fail fast rather than silently dropping the deltas).
+      // Event projections only make sense for NDJSON output: the stream-input
+      // mode is always NDJSON, otherwise require stream-json explicitly (fail
+      // fast rather than silently dropping an opt-in machine contract).
       if (
-        options.includePartialMessages &&
+        (options.includePartialMessages || options.includeHookEvents) &&
         options.inputFormat !== "stream-json" &&
         options.outputFormat !== "stream-json"
       ) {
         process.stderr.write(
-          "--include-partial-messages requires --output-format stream-json.\n",
+          "--include-partial-messages and --include-hook-events require --output-format stream-json.\n",
         );
         await _finishWorktree();
         process.exit(1);
@@ -1058,6 +1070,12 @@ export function registerAgentCommand(program) {
       // block below may default options.model 鈥?so vision input can tell an
       // explicit model from a settings default.
       const explicitCliModel = options.model;
+      // Launcher environment is captured before a settings file can merge its
+      // own `env` map. In particular, a checked-in project settings file must
+      // not manufacture ANTHROPIC_MODEL / CLAUDE_CODE_* launcher authority.
+      const startupAnthropicModel = process.env.ANTHROPIC_MODEL;
+      const startupAnthropicDefaultModel = process.env.ANTHROPIC_DEFAULT_MODEL;
+      let settingsModel = null;
       // --settings native config overrides: a .claude/settings.json-shaped file
       // (and the discovered .claude settings) may set `model` + `env` for this
@@ -1068,9 +1086,8 @@ export function registerAgentCommand(program) {
       let settingsSandbox = null;
       let managedSettingsSandbox = null;
       try {
-        const { loadSettingsConfig } = await import(
-          "../lib/settings-loader.cjs"
-        );
+        const { loadSettingsConfig } =
+          await import("../lib/settings-loader.cjs");
         const sc = loadSettingsConfig({
           cwd: process.cwd(),
           unattendedActionPolicy: options.unattended
@@ -1088,7 +1105,10 @@ export function registerAgentCommand(program) {
         for (const [k, v] of Object.entries(sc.env || {})) {
           process.env[k] = v;
         }
-        if (!options.model && sc.model) options.model = sc.model;
+        if (!options.model && sc.model) {
+          options.model = sc.model;
+          settingsModel = sc.model;
+        }
         settingsSandbox = sc.sandbox || null;
         managedSettingsSandbox = sc.managedSandbox || null;
       } catch (error) {
@@ -1099,6 +1119,8 @@ export function registerAgentCommand(program) {
         }
         // User/project settings overrides remain best-effort. Organization
         // managed settings are handled above and may never fail open.
+      } finally {
+        restoreClaudeStorageLaunchEnvironment(claudeStorageLaunchEnv);
       }
       let resolvedAgentSandbox;
@@ -1194,7 +1216,7 @@ export function registerAgentCommand(program) {
       // flags there, and BEFORE every dispatch (headless/stream/REPL) since
       // they all read options.provider/model/baseUrl/apiKey.
       {
-        const { applyConfigLlmDefaults, reconcileConfigLlmProvider } =
+        const { applyAgentModelDefaults, reconcileConfigLlmProvider } =
           await import("../lib/llm-config-defaults.js");
         // Self-repair a MISLABELED config (provider disagrees with the provider
@@ -1222,8 +1244,16 @@ export function registerAgentCommand(program) {
           }
         }
-        applyConfigLlmDefaults(options, repairedLlm, {
-          explicitModel: explicitCliModel, // settings-file model must not ride
+        applyAgentModelDefaults(options, repairedLlm, {
+          explicitModel: explicitCliModel,
+          anthropicModel: startupAnthropicModel,
+          anthropicDefaultModel: startupAnthropicDefaultModel,
+          settingsModel,
+          // ANTHROPIC_DEFAULT_MODEL is deliberately a new-session fallback;
+          // a resume/continue keeps its recorded model unless a higher source
+          // explicitly replaces it.
+          isNewSession:
+            !options.session && !options.continue && !options.resume,
         });
         // Also reconcile the RESOLVED options: the editor panel may have already
@@ -1247,9 +1277,8 @@ export function registerAgentCommand(program) {
       // never pollutes spawned-bin test stderr.
       if (!process.env.VITEST && !process.env.VITEST_WORKER_ID) {
         try {
-          const { maybeWarnDeprecatedModel } = await import(
-            "../lib/model-deprecation.js"
-          );
+          const { maybeWarnDeprecatedModel } =
+            await import("../lib/model-deprecation.js");
           maybeWarnDeprecatedModel({ model: options.model });
         } catch {
           /* fail-open: a deprecation notice must never affect the run */
@@ -1335,9 +1364,8 @@ export function registerAgentCommand(program) {
       // stdin; output is always NDJSON. Routed before single-prompt handling
       // so stdin is consumed as events, not as one prompt.
       if (options.inputFormat === "stream-json") {
-        const { runAgentHeadlessStream } = await import(
-          "../runtime/headless-stream.js"
-        );
+        const { runAgentHeadlessStream } =
+          await import("../runtime/headless-stream.js");
         const { parseToolList } = await import("../runtime/headless-runner.js");
         const cwd = process.cwd();
         let outcome;
@@ -1378,6 +1406,7 @@ export function registerAgentCommand(program) {
             // (flag absent) leaves the default-on path byte-identical.
             projectMemory: options.projectMemory,
             includePartialMessages: options.includePartialMessages === true,
+            includeHookEvents: options.includeHookEvents === true,
             goal: options.goal,
             mcpConfig: options.mcpConfig || null,
             useRegisteredMcp: options.mcp !== false,
@@ -1406,6 +1435,7 @@ export function registerAgentCommand(program) {
             // into the system prompt, and a per-turn `structured_result` event is
             // appended after each turn (parity with single-prompt --json-schema).
             jsonSchema: options.jsonSchema || null,
+            claudeStorageLaunchEnv,
           });
         } catch (err) {
           process.stderr.write(
@@ -1569,9 +1599,8 @@ export function registerAgentCommand(program) {
         const resumeRequested =
           Boolean(options.continue) || options.resume !== undefined;
         if (resumeRequested && options.session) {
-          const { sessionHasPersistedEvidence } = await import(
-            "../harness/jsonl-session-store.js"
-          );
+          const { sessionHasPersistedEvidence } =
+            await import("../harness/jsonl-session-store.js");
           if (!sessionHasPersistedEvidence(options.session)) {
             process.stderr.write(
               `Note: no headless transcript for session "${options.session}" 鈥?` +
@@ -1579,16 +1608,14 @@ export function registerAgentCommand(program) {
             );
           }
         }
-        const { runAgentHeadless, parseToolList } = await import(
-          "../runtime/headless-runner.js"
-        );
+        const { runAgentHeadless, parseToolList } =
+          await import("../runtime/headless-runner.js");
         // --goal-condition: validate the spec up front so a bad prefix fails
         // fast (before any model call) with a clear message.
         if (options.goalCondition) {
           try {
-            const { parseGoalCondition } = await import(
-              "../lib/goal-condition-engine.js"
-            );
+            const { parseGoalCondition } =
+              await import("../lib/goal-condition-engine.js");
             parseGoalCondition(options.goalCondition);
           } catch (e) {
             process.stderr.write(`--goal-condition: ${e.message}\n`);
@@ -1656,6 +1683,8 @@ export function registerAgentCommand(program) {
           projectMemory: options.projectMemory,
           // --include-partial-messages: live token deltas as stream_event lines
           includePartialMessages: options.includePartialMessages === true,
+          // --include-hook-events: redacted lifecycle/progress NDJSON lines
+          includeHookEvents: options.includeHookEvents === true,
           // --goal [id]: bind a cc goal into the run (Phase 1)
           goal: options.goal,
           // --goal-assess: run-end LLM progress assessment (Phase 2)
@@ -1707,6 +1736,7 @@ export function registerAgentCommand(program) {
             : undefined,
           // --fallback-model: retry once on a backup model on transient errors
           chatFn: fallbackChatFn,
+          claudeStorageLaunchEnv,
         };
         // --json-schema: structured output. Accepts a file path OR inline JSON.
@@ -1872,6 +1902,7 @@ export function registerAgentCommand(program) {
         observabilityScope: hasObservabilityScope
           ? observabilityScope
           : undefined,
+        claudeStorageLaunchEnv,
       });
       await runtime.startAgentSession();
       // Interactive session ended (REPL closed) — settle the worktree.