context-mode 1.0.106 → 1.0.108

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Claude Code plugins by Mert Koseoğlu",
-    "version": "1.0.106"
+    "version": "1.0.108"
   },
   "plugins": [
     {
       "name": "context-mode",
       "source": "./",
       "description": "Claude Code MCP plugin that saves 98% of your context window. Sandboxed code execution in 11 languages, FTS5 knowledge base with BM25 ranking, and intent-driven search.",
-      "version": "1.0.106",
+      "version": "1.0.108",
       "author": {
         "name": "Mert Koseoğlu"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.106",
+  "version": "1.0.108",
   "description": "MCP server that saves 98% of your context window with session continuity. Sandboxed code execution in 11 languages, FTS5 knowledge base with BM25 ranking, and automatic state restore across compactions.",
   "author": {
     "name": "Mert Koseoğlu",

package/.openclaw-plugin/openclaw.plugin.json

@@ -3,7 +3,7 @@
   "name": "Context Mode",
   "kind": "tool",
   "description": "OpenClaw plugin that saves 98% of your context window. Sandboxed code execution in 11 languages, FTS5 knowledge base with BM25 ranking, and intent-driven search.",
-  "version": "1.0.106",
+  "version": "1.0.108",
   "sandbox": {
     "mode": "permissive",
     "filesystem_access": "full",

package/.openclaw-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.106",
+  "version": "1.0.108",
   "description": "OpenClaw plugin that saves 98% of your context window. Sandboxed code execution in 11 languages, FTS5 knowledge base with BM25 ranking, and intent-driven search.",
   "author": {
     "name": "Mert Koseoğlu",

package/README.md

@@ -404,7 +404,7 @@ Full configs: [`configs/cursor/hooks.json`](configs/cursor/hooks.json) | [`confi
 
    The `mcp` entry registers all 11 MCP tools. The `plugin` entry enables hooks — OpenCode calls the plugin's TypeScript functions directly before and after each tool execution, blocking dangerous commands and enforcing sandbox routing.
 
-3. *(Optional)* Copy the routing rules file. OpenCode lacks a SessionStart hook, so the model needs an `AGENTS.md` file for routing awareness:
+3. *(Optional)* Copy the routing rules file. The model needs an `AGENTS.md` file for routing awareness:
 
    ```bash
    cp node_modules/context-mode/configs/opencode/AGENTS.md AGENTS.md
@@ -416,9 +416,9 @@ Full configs: [`configs/cursor/hooks.json`](configs/cursor/hooks.json) | [`confi
 
 **Verify:** In the OpenCode session, type `ctx stats`. Context-mode tools should appear and respond.
 
-**Routing:** Hooks enforce routing programmatically via `tool.execute.before` and `tool.execute.after`. The optional [`AGENTS.md`](configs/opencode/AGENTS.md) file provides routing instructions for model awareness. The `experimental.session.compacting` hook builds resume snapshots when the conversation compacts.
+**Routing:** Hooks enforce routing programmatically via `tool.execute.before` and `tool.execute.after`. The optional [`AGENTS.md`](configs/opencode/AGENTS.md) file provides routing instructions for model awareness. The `experimental.session.compacting` hook builds resume snapshots when the conversation compacts. The `experimental.chat.system.transform` hook injects the routing block and prior-session snapshots at session start, enabling session continuity across restarts. The `chat.message` hook captures user prompts and decisions (UserPromptSubmit equivalent).
 
-> **Note:** OpenCode's SessionStart hook is not yet available ([#14808](https://github.com/sst/opencode/issues/14808)), so startup/resume session restore is not supported. Compaction recovery works fully via the plugin.
+> **Note:** OpenCode lacks a real SessionStart hook ([#14808](https://github.com/sst/opencode/issues/14808), [#5409](https://github.com/sst/opencode/issues/5409)). The plugin uses `experimental.chat.system.transform` as a surrogate — it injects both the routing block and resume snapshots into the system prompt. User-prompt capture uses `chat.message` instead of the missing UserPromptSubmit hook. AGENTS.md/CLAUDE.md/CONTEXT.md rules are captured automatically on first hook fire per project.
 
 Full configs: [`configs/opencode/opencode.json`](configs/opencode/opencode.json) | [`configs/opencode/AGENTS.md`](configs/opencode/AGENTS.md)
 
@@ -454,7 +454,7 @@ Full configs: [`configs/opencode/opencode.json`](configs/opencode/opencode.json)
 
    The `mcp` entry registers all 11 MCP tools. The `plugin` entry enables hooks — KiloCode calls the plugin's TypeScript functions directly before and after each tool execution, blocking dangerous commands and enforcing sandbox routing.
 
-3. *(Optional)* Copy the routing rules file. KiloCode shares the OpenCode plugin architecture and lacks SessionStart, so the model needs an `AGENTS.md` file for routing awareness:
+3. *(Optional)* Copy the routing rules file. KiloCode shares the OpenCode plugin architecture, so the model needs an `AGENTS.md` file for routing awareness:
 
    ```bash
    cp node_modules/context-mode/configs/opencode/AGENTS.md AGENTS.md
@@ -464,9 +464,9 @@ Full configs: [`configs/opencode/opencode.json`](configs/opencode/opencode.json)
 
 **Verify:** In the KiloCode session, type `ctx stats`. Context-mode tools should appear and respond.
 
-**Routing:** Hooks enforce routing programmatically via `tool.execute.before` and `tool.execute.after`. The optional [`AGENTS.md`](configs/opencode/AGENTS.md) file provides routing instructions for model awareness. The `experimental.session.compacting` hook builds resume snapshots when the conversation compacts.
+**Routing:** Hooks enforce routing programmatically via `tool.execute.before` and `tool.execute.after`. The optional [`AGENTS.md`](configs/opencode/AGENTS.md) file provides routing instructions for model awareness. The `experimental.session.compacting` hook builds resume snapshots when the conversation compacts. The `experimental.chat.system.transform` hook injects the routing block and prior-session snapshots at session start, enabling session continuity across restarts. The `chat.message` hook captures user prompts and decisions (UserPromptSubmit equivalent).
 
-> **Note:** KiloCode shares the same plugin architecture as OpenCode, using the OpenCodeAdapter with platform-specific configuration paths (`kilo.json` instead of `opencode.json`, `~/.config/kilo/` instead of `~/.config/opencode/`). SessionStart hook availability depends on KiloCode's implementation.
+> **Note:** KiloCode shares the same plugin architecture as OpenCode, using the OpenCodeAdapter with platform-specific configuration paths (`kilo.json` instead of `opencode.json`, `~/.config/kilo/` instead of `~/.config/opencode/`). Like OpenCode, it lacks a real SessionStart hook — the plugin uses `experimental.chat.system.transform` as a surrogate. User-prompt capture uses `chat.message` instead of the missing UserPromptSubmit hook. AGENTS.md/CLAUDE.md/CONTEXT.md rules are captured automatically on first hook fire per project.
 
 </details>
 
@@ -817,6 +817,8 @@ Context Mode uses [better-sqlite3](https://github.com/WiseLibs/better-sqlite3) o
 
 On older glibc systems (CentOS 7/8, RHEL 8, Debian 10), prebuilt binaries don't load and better-sqlite3 **automatically falls back to compiling from source** via `prebuild-install || node-gyp rebuild --release`. This requires a C++20 compiler (GCC 10+), Make, and Python with setuptools.
 
+**Windows / missing binding self-heal:** if `better_sqlite3.node` ends up missing after install (e.g. `prebuild-install` not on cmd.exe PATH, no MSVC toolchain), the postinstall script and the runtime hook automatically re-fetch the prebuild and repair the binding — no manual `npm rebuild` needed (#408).
+
 **CentOS 8 / RHEL 8** (glibc 2.28):
 
 ```bash
@@ -919,20 +921,22 @@ This means `--continue` sessions preserve indexed docs across restarts. No re-fe
 
 When the context window fills up, the agent compacts the conversation — dropping older messages to make room. Without session tracking, the model forgets which files it was editing, what tasks are in progress, what errors were resolved, and what you last asked for.
 
-Context Mode captures every meaningful event during your session and persists them in a per-project SQLite database. When the conversation compacts (or you resume with `--continue`), your working state is rebuilt automatically — the model continues from your last prompt without asking you to repeat anything.
+Context Mode captures every meaningful event during your session and persists them in a per-project SQLite database. When the conversation compacts (or you resume with `--continue`, `--resume`, or `/resume`), your working state is rebuilt automatically — the model continues from your last prompt without asking you to repeat anything.
+
+> Resuming a non-latest session via `/resume <picker>` works the same way: the SessionStart hook detects the empty live-event table for the freshly issued session id and falls back to the most recent unconsumed snapshot for the project (`session_resume` table). The picker selects the conversation; context-mode rehydrates the prior working state.
 
-Session continuity requires 4 hooks working together:
+Session continuity requires 5 hooks working together:
 
 | Hook | Role | Claude Code | Gemini CLI | VS Code Copilot | JetBrains Copilot | Cursor | OpenCode | KiloCode | OpenClaw | Codex CLI | Antigravity | Kiro | Zed | Pi |
 |---|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
 | **PreToolUse** | Enforces sandbox routing before tool execution | Yes | -- | -- | -- | Yes | -- | -- | -- | Yes | -- | Yes | -- | ✓ (via tool_call event) |
 | **PostToolUse** | Captures events after each tool call | Yes | Yes | Yes | Yes | Yes | Plugin | Plugin | Plugin | Yes | -- | Yes | -- | ✓ (via tool_result event) |
-| **UserPromptSubmit** | Captures user decisions and corrections | Yes | -- | -- | -- | -- | -- | -- | -- | Yes | -- | -- | -- | -- |
+| **UserPromptSubmit** | Captures user decisions and corrections | Yes | -- | -- | -- | -- | Plugin (via chat.message) | Plugin (via chat.message) | -- | Yes | -- | -- | -- | -- |
 | **PreCompact** | Builds snapshot before compaction | Yes | Yes | Yes | Yes | -- | Plugin | Plugin | Plugin | -- | -- | -- | -- | ✓ (via session_before_compact) |
-| **SessionStart** | Restores state after compaction or resume | Yes | Yes | Yes | Yes | -- | -- | -- | Plugin | Yes | -- | -- | -- | ✓ (via session_start event) |
-| | **Session completeness** | **Full** | **High** | **High** | **High** | **Partial** | **High** | **High** | **High** | **Partial** | **--** | **Partial** | **--** | **High** |
+| **SessionStart** | Restores state after compaction or resume | Yes | Yes | Yes | Yes | -- | ✓ (via experimental.chat.system.transform) | ✓ (via experimental.chat.system.transform) | Plugin | Yes | -- | -- | -- | ✓ (via session_start event) |
+| | **Session completeness** | **Full** | **High** | **High** | **High** | **Partial** | **Full** | **Full** | **High** | **Partial** | **--** | **Partial** | **--** | **High** |
 
-> **Note:** Full session continuity (capture + snapshot + restore) works on **Claude Code**, **Gemini CLI**, **VS Code Copilot**, and **JetBrains Copilot**. **OpenCode** provides **high** session continuity: it captures tool events and injects compaction snapshots via the plugin, but SessionStart is not yet available ([#14808](https://github.com/sst/opencode/issues/14808)), so startup/resume restore is not supported. **KiloCode** shares the same plugin architecture as OpenCode via the OpenCodeAdapter, so its continuity level depends on KiloCode's SessionStart support. **Cursor** captures tool events via `preToolUse`/`postToolUse`, but `sessionStart` is currently rejected by Cursor's validator ([forum report](https://forum.cursor.com/t/unknown-hook-type-sessionstart/149566)), so session restore after compaction is not available yet. **OpenClaw** uses native gateway plugin hooks (`api.on()`) for full session continuity. **Pi Coding Agent** provides high session continuity via extension hooks (`tool_call`, `tool_result`, `session_start`, `session_before_compact`). **Codex CLI** provides partial hook-based session tracking through PreToolUse, PostToolUse, SessionStart, UserPromptSubmit, and Stop; MCP tools work. **Antigravity**, **Kiro**, and **Zed** have no hook support in the current release, so session tracking is not available.
+> **Note:** Full session continuity (capture + snapshot + restore) works on **Claude Code**, **Gemini CLI**, **VS Code Copilot**, **JetBrains Copilot**, **OpenCode**, and **KiloCode**. **OpenCode** and **KiloCode** use `experimental.chat.system.transform` as a SessionStart surrogate to inject the routing block and restore prior sessions, plus `chat.message` for user-prompt capture; full SessionStart hook support is not yet available ([#14808](https://github.com/sst/opencode/issues/14808), [#5409](https://github.com/sst/opencode/issues/5409)), but prior-session continuity and user-decision capture work fully. **Cursor** captures tool events via `preToolUse`/`postToolUse`, but `sessionStart` is currently rejected by Cursor's validator ([forum report](https://forum.cursor.com/t/unknown-hook-type-sessionstart/149566)), so session restore after compaction is not available yet. **OpenClaw** uses native gateway plugin hooks (`api.on()`) for full session continuity. **Pi Coding Agent** provides high session continuity via extension hooks (`tool_call`, `tool_result`, `session_start`, `session_before_compact`). **Codex CLI** provides partial hook-based session tracking through PreToolUse, PostToolUse, SessionStart, UserPromptSubmit, and Stop; MCP tools work. **Antigravity**, **Kiro**, and **Zed** have no hook support in the current release, so session tracking is not available.
 
 <details>
 <summary><strong>What gets captured</strong></summary>
@@ -1015,7 +1019,7 @@ Detailed event data is also indexed into FTS5 for on-demand retrieval via `ctx_s
 <details>
 <summary><strong>Per-platform details</strong></summary>
 
-**Claude Code** — Full session support. All 5 hook types fire, capturing tool events, user decisions, building compaction snapshots, and restoring state after compaction or `--continue`.
+**Claude Code** — Full session support. All 5 hook types fire, capturing tool events, user decisions, building compaction snapshots, and restoring state after compaction, `--continue`, `--resume`, or `/resume`.
 
 **Gemini CLI** — High coverage. PostToolUse (AfterTool), PreCompact (PreCompress), and SessionStart all fire. Missing UserPromptSubmit, so user decisions and corrections aren't captured — but file edits, git ops, errors, and tasks are fully tracked.
 
@@ -1025,9 +1029,9 @@ Detailed event data is also indexed into FTS5 for on-demand retrieval via `ctx_s
 
 **Cursor** — Partial coverage. Native `preToolUse` and `postToolUse` hooks capture tool events. `sessionStart` is documented by Cursor but currently rejected by their validator, so session restore is not available. Routing instructions are delivered via MCP server startup instead.
 
-**OpenCode** — Partial. The TypeScript plugin captures PostToolUse events via `tool.execute.after`, but SessionStart is not yet available ([#14808](https://github.com/sst/opencode/issues/14808)). Events are stored but not automatically restored after compaction.
+**OpenCode** — Full session support. The TypeScript plugin captures PostToolUse events via `tool.execute.after`, user prompts and decisions via `chat.message`, builds compaction snapshots via `experimental.session.compacting`, and restores prior sessions via `experimental.chat.system.transform` (SessionStart surrogate). Routing block is injected on first `chat.system.transform` per session. AGENTS.md/CLAUDE.md/CONTEXT.md rules are captured automatically on first hook fire.
 
-**KiloCode** — Partial. Shares the same plugin architecture as OpenCode via the OpenCodeAdapter. The TypeScript plugin captures PostToolUse events via `tool.execute.after`, but SessionStart availability depends on KiloCode's implementation. Events are stored but may not be automatically restored after compaction.
+**KiloCode** — Full session support. Shares the same plugin architecture as OpenCode via the OpenCodeAdapter. The TypeScript plugin captures PostToolUse events via `tool.execute.after`, user prompts and decisions via `chat.message`, builds compaction snapshots via `experimental.session.compacting`, and restores prior sessions via `experimental.chat.system.transform` (SessionStart surrogate).
 
 **OpenClaw / Pi Agent** — High coverage. All tool lifecycle hooks (`after_tool_call`, `before_compaction`, `session_start`) fire via the native gateway plugin. User decisions aren't captured but file edits, git ops, errors, and tasks are fully tracked. Falls back to DB snapshot reconstruction if compaction hooks fail on older gateway versions. See [`docs/adapters/openclaw.md`](docs/adapters/openclaw.md).
 
@@ -1050,7 +1054,7 @@ Detailed event data is also indexed into FTS5 for on-demand retrieval via `ctx_s
 | MCP Server | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
 | PreToolUse Hook | Yes | Yes | Yes | Yes | Yes | Yes | Plugin | Plugin | Plugin | Yes | -- | Yes | -- | Yes (extension) |
 | PostToolUse Hook | Yes | Yes | Yes | Yes | Yes | Yes | Plugin | Plugin | Plugin | Yes | -- | Yes | -- | Yes (extension) |
-| SessionStart Hook | Yes | Yes | Yes | Yes | Yes | -- | -- | -- | Plugin | Yes | -- | -- | -- | Yes (extension) |
+| SessionStart Hook | Yes | Yes | Yes | Yes | Yes | -- | ✓ (via experimental.chat.system.transform) | ✓ (via experimental.chat.system.transform) | Plugin | Yes | -- | -- | -- | Yes (extension) |
 | PreCompact Hook | Yes | Yes | Yes | Yes | Yes | -- | Plugin | Plugin | Plugin | -- | -- | -- | -- | Yes (extension) |
 | Can Modify Args | Yes | Yes | Yes | Yes | Yes | Yes | Plugin | Plugin | Plugin | -- | -- | -- | -- | Yes (extension) |
 | Can Block Tools | Yes | Yes | Yes | Yes | Yes | Yes | Plugin | Plugin | Plugin | Yes | -- | Yes | -- | Yes (extension) |
@@ -1058,9 +1062,9 @@ Detailed event data is also indexed into FTS5 for on-demand retrieval via `ctx_s
 | Slash Commands | Yes | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- |
 | Plugin Marketplace | Yes | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- |
 
-> **OpenCode** uses a TypeScript plugin paradigm — hooks run as in-process functions via `tool.execute.before`, `tool.execute.after`, and `experimental.session.compacting`, providing the same routing enforcement and session continuity as shell-based hooks. SessionStart is not yet available ([#14808](https://github.com/sst/opencode/issues/14808)), but compaction recovery works via the plugin's compacting hook.
+> **OpenCode** uses a TypeScript plugin paradigm — hooks run as in-process functions via `tool.execute.before`, `tool.execute.after`, `experimental.session.compacting`, `experimental.chat.system.transform`, and `chat.message`, providing full routing enforcement, session continuity, and user-prompt capture. The `experimental.chat.system.transform` hook acts as a SessionStart surrogate to inject the routing block and restore prior sessions. The `chat.message` hook captures user prompts and decisions (UserPromptSubmit equivalent).
 >
-> **KiloCode** shares the same TypeScript plugin architecture as OpenCode via the OpenCodeAdapter, with platform-specific configuration paths (`kilo.json` instead of `opencode.json`, `~/.config/kilo/` instead of `~/.config/opencode/`). Hook capabilities depend on KiloCode's implementation of the plugin interface.
+> **KiloCode** shares the same TypeScript plugin architecture as OpenCode via the OpenCodeAdapter, with platform-specific configuration paths (`kilo.json` instead of `opencode.json`, `~/.config/kilo/` instead of `~/.config/opencode/`). Hook capabilities match OpenCode, including SessionStart surrogate via `experimental.chat.system.transform` and user-prompt capture via `chat.message`.
 >
 > **OpenClaw** runs context-mode as a native gateway plugin targeting Pi Agent sessions. Hooks register via `api.on()` (tool/lifecycle) and `api.registerHook()` (commands). All tool interception and compaction hooks are supported. See [`docs/adapters/openclaw.md`](docs/adapters/openclaw.md).
 >

package/build/adapters/claude-code/index.js

@@ -308,19 +308,36 @@ export class ClaudeCodeAdapter extends ClaudeCodeBaseAdapter {
         if (pluginHooks) {
             const allCovered = REQUIRED_HOOKS.every((ht) => this.checkHookType(undefined, pluginHooks, ht));
             if (allCovered) {
-                // Remove ALL existing context-mode hooks from settings.json — hooks.json
-                // is the source of truth. Keeping them causes duplicate concurrent hook
-                // processes (one from settings.json, one from hooks.json), which triggers
-                // "non-blocking hook error" warnings on every tool call.
+                // Strip ONLY the inner context-mode hook commands from each matcher entry —
+                // hooks.json is the source of truth for ctx-mode. User hooks co-located in
+                // the same matcher entry MUST be preserved (#415: entry-level filter wiped
+                // every co-located user hook). After stripping, prune entries whose `hooks`
+                // array becomes empty.
+                const ctxScriptNames = Object.values(HOOK_SCRIPTS);
+                const isCtxModeCommand = (cmd) => cmd != null &&
+                    (ctxScriptNames.some((s) => cmd.includes(s)) ||
+                        cmd.includes("context-mode hook"));
                 for (const hookType of Object.keys(hooks)) {
                     const entries = hooks[hookType];
                     if (!Array.isArray(entries))
                         continue;
-                    const filtered = entries.filter((entry) => !isAnyContextModeHook(entry));
-                    const removed = entries.length - filtered.length;
-                    if (removed > 0) {
-                        hooks[hookType] = filtered;
-                        changes.push(`Removed ${removed} duplicate ${hookType} hook(s) — covered by plugin hooks.json`);
+                    let totalRemoved = 0;
+                    for (const entry of entries) {
+                        const typedEntry = entry;
+                        const innerHooks = typedEntry.hooks ?? [];
+                        const before = innerHooks.length;
+                        typedEntry.hooks = innerHooks.filter((h) => !isCtxModeCommand(h.command));
+                        totalRemoved += before - typedEntry.hooks.length;
+                    }
+                    const pruned = entries.filter((e) => {
+                        const ih = e.hooks;
+                        return Array.isArray(ih) && ih.length > 0;
+                    });
+                    if (totalRemoved > 0 || pruned.length !== entries.length) {
+                        hooks[hookType] = pruned;
+                        if (totalRemoved > 0) {
+                            changes.push(`Removed ${totalRemoved} duplicate ${hookType} hook(s) — covered by plugin hooks.json`);
+                        }
                     }
                 }
                 settings.hooks = hooks;

package/build/adapters/copilot-base.d.ts

@@ -34,9 +34,9 @@ export interface CopilotHookModule {
         readonly POST_TOOL_USE: string;
         readonly PRE_COMPACT: string;
         readonly SESSION_START: string;
-        readonly STOP: string;
-        readonly SUBAGENT_START: string;
-        readonly SUBAGENT_STOP: string;
+        readonly STOP?: string;
+        readonly SUBAGENT_START?: string;
+        readonly SUBAGENT_STOP?: string;
     };
     HOOK_SCRIPTS: Record<string, string>;
     buildHookCommand: (hookType: any, pluginRoot?: string) => string;

package/build/adapters/cursor/hooks.js

@@ -19,8 +19,16 @@ export const HOOK_SCRIPTS = {
     [HOOK_TYPES.POST_TOOL_USE]: "posttooluse.mjs",
     [HOOK_TYPES.SESSION_START]: "sessionstart.mjs",
     [HOOK_TYPES.STOP]: "stop.mjs",
+    [HOOK_TYPES.AFTER_AGENT_RESPONSE]: "afteragentresponse.mjs",
 };
 /** Canonical Cursor-native matchers for tools context-mode routes proactively. */
+// NOTE (Cursor-3, deferred): Cursor is closed-source and does not currently
+// publish the exact tool name it uses for sub-agent dispatch (the analogue of
+// Claude Code's "Task" tool). The "Task" matcher below is kept as a best-guess
+// placeholder until probe data from a real Cursor session confirms the wire
+// name. If/when that probe lands, replace or supplement this entry — do NOT
+// add unverified matchers in the meantime. See Phase 7 audit
+// `/tmp/v1.0.107-adapter-cursor.json` (Cursor-3) for the full deferral note.
 export const PRE_TOOL_USE_MATCHERS = [
     "Shell",
     "Read",

package/build/adapters/cursor/index.js

@@ -21,7 +21,10 @@ export class CursorAdapter extends BaseAdapter {
         preToolUse: true,
         postToolUse: true,
         preCompact: false,
-        sessionStart: false,
+        // Cursor v1 ships native sessionStart and the matching hook script
+        // (hooks/cursor/sessionstart.mjs) is wired through the dispatcher
+        // (src/cli.ts HOOK_MAP). Capability flag must reflect script presence.
+        sessionStart: true,
         canModifyArgs: true,
         canModifyOutput: false,
         canInjectSessionContext: true,

package/build/adapters/gemini-cli/hooks.d.ts

@@ -10,12 +10,17 @@
  * Gemini CLI hook system reference:
  *   - Hooks are registered in ~/.gemini/settings.json under "hooks" key
  *   - Each hook type maps to an array of { matcher, hooks } entries
- *   - Hook names: BeforeTool, AfterTool, PreCompress, SessionStart
+ *   - Hook names: BeforeAgent, BeforeTool, AfterTool, PreCompress, SessionStart
  *   - Input: JSON on stdin
  *   - Output: JSON on stdout (or empty for passthrough)
+ *   - BeforeAgent fires when user submits a prompt — input.prompt carries
+ *     the user message; hookSpecificOutput.additionalContext is appended
+ *     to the prompt (hookRunner.ts:183-197). Equivalent to Claude Code's
+ *     UserPromptSubmit for session-continuity capture.
  */
 /** Gemini CLI hook types. */
 export declare const HOOK_TYPES: {
+    readonly BEFORE_AGENT: "BeforeAgent";
     readonly BEFORE_TOOL: "BeforeTool";
     readonly AFTER_TOOL: "AfterTool";
     readonly PRE_COMPRESS: "PreCompress";

package/build/adapters/gemini-cli/hooks.js

@@ -11,15 +11,20 @@ import { buildNodeCommand } from "../types.js";
  * Gemini CLI hook system reference:
  *   - Hooks are registered in ~/.gemini/settings.json under "hooks" key
  *   - Each hook type maps to an array of { matcher, hooks } entries
- *   - Hook names: BeforeTool, AfterTool, PreCompress, SessionStart
+ *   - Hook names: BeforeAgent, BeforeTool, AfterTool, PreCompress, SessionStart
  *   - Input: JSON on stdin
  *   - Output: JSON on stdout (or empty for passthrough)
+ *   - BeforeAgent fires when user submits a prompt — input.prompt carries
+ *     the user message; hookSpecificOutput.additionalContext is appended
+ *     to the prompt (hookRunner.ts:183-197). Equivalent to Claude Code's
+ *     UserPromptSubmit for session-continuity capture.
  */
 // ─────────────────────────────────────────────────────────
 // Hook type constants
 // ─────────────────────────────────────────────────────────
 /** Gemini CLI hook types. */
 export const HOOK_TYPES = {
+    BEFORE_AGENT: "BeforeAgent",
     BEFORE_TOOL: "BeforeTool",
     AFTER_TOOL: "AfterTool",
     PRE_COMPRESS: "PreCompress",
@@ -30,6 +35,7 @@ export const HOOK_TYPES = {
 // ─────────────────────────────────────────────────────────
 /** Map of hook types to their script file names. */
 export const HOOK_SCRIPTS = {
+    [HOOK_TYPES.BEFORE_AGENT]: "beforeagent.mjs",
     [HOOK_TYPES.BEFORE_TOOL]: "beforetool.mjs",
     [HOOK_TYPES.AFTER_TOOL]: "aftertool.mjs",
     [HOOK_TYPES.PRE_COMPRESS]: "precompress.mjs",

package/build/adapters/gemini-cli/index.js

@@ -165,6 +165,17 @@ export class GeminiCLIAdapter extends BaseAdapter {
     }
     generateHookConfig(pluginRoot) {
         return {
+            [GEMINI_HOOK_NAMES.BEFORE_AGENT]: [
+                {
+                    matcher: "",
+                    hooks: [
+                        {
+                            type: "command",
+                            command: buildGeminiHookCommand(GEMINI_HOOK_NAMES.BEFORE_AGENT, pluginRoot),
+                        },
+                    ],
+                },
+            ],
             [GEMINI_HOOK_NAMES.BEFORE_TOOL]: [
                 {
                     matcher: "run_shell_command|read_file|read_many_files|grep_search|search_file_content|web_fetch|activate_skill|mcp__plugin_context-mode",
@@ -331,6 +342,7 @@ export class GeminiCLIAdapter extends BaseAdapter {
         const hooks = (settings.hooks ?? {});
         const changes = [];
         const hookConfigs = [
+            { name: GEMINI_HOOK_NAMES.BEFORE_AGENT },
             { name: GEMINI_HOOK_NAMES.BEFORE_TOOL },
             { name: GEMINI_HOOK_NAMES.SESSION_START },
         ];

package/build/adapters/kiro/hooks.js

@@ -20,6 +20,8 @@ export const HOOK_TYPES = {
 export const HOOK_SCRIPTS = {
     [HOOK_TYPES.PRE_TOOL_USE]: "pretooluse.mjs",
     [HOOK_TYPES.POST_TOOL_USE]: "posttooluse.mjs",
+    [HOOK_TYPES.USER_PROMPT_SUBMIT]: "userpromptsubmit.mjs",
+    [HOOK_TYPES.AGENT_SPAWN]: "agentspawn.mjs",
 };
 // ─────────────────────────────────────────────────────────
 // PreToolUse matchers
@@ -46,9 +48,11 @@ export const PRE_TOOL_USE_MATCHERS = [
 export const PRE_TOOL_USE_MATCHER_PATTERN = PRE_TOOL_USE_MATCHERS.join("|");
 export const REQUIRED_HOOKS = [
     HOOK_TYPES.PRE_TOOL_USE,
+    HOOK_TYPES.AGENT_SPAWN,
 ];
 export const OPTIONAL_HOOKS = [
     HOOK_TYPES.POST_TOOL_USE,
+    HOOK_TYPES.USER_PROMPT_SUBMIT,
 ];
 /**
  * Check if a hook entry points to a context-mode hook script.

package/build/adapters/kiro/index.d.ts

@@ -18,6 +18,13 @@
  *   - CLI hooks: https://kiro.dev/docs/cli/custom-agents/configuration-reference#hooks-field
  */
 import { BaseAdapter } from "../base.js";
+/**
+ * Steering integration: we ship a single context-mode-specific routing file
+ * at `configs/kiro/KIRO.md`. Users can copy it into `.kiro/steering/` to opt
+ * into deterministic injection. We do NOT deploy generic SDD scaffolds (e.g.
+ * cc-sdd's product/structure/tech + steering-custom/* templates) — those are
+ * project-template content, not adapter wiring.
+ */
 import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration } from "../types.js";
 export declare class KiroAdapter extends BaseAdapter implements HookAdapter {
     constructor();
@@ -27,11 +34,11 @@ export declare class KiroAdapter extends BaseAdapter implements HookAdapter {
     parsePreToolUseInput(raw: unknown): PreToolUseEvent;
     parsePostToolUseInput(raw: unknown): PostToolUseEvent;
     parsePreCompactInput(_raw: unknown): PreCompactEvent;
-    parseSessionStartInput(_raw: unknown): SessionStartEvent;
+    parseSessionStartInput(raw: unknown): SessionStartEvent;
     formatPreToolUseResponse(response: PreToolUseResponse): unknown;
     formatPostToolUseResponse(_response: PostToolUseResponse): unknown;
     formatPreCompactResponse(_response: PreCompactResponse): unknown;
-    formatSessionStartResponse(_response: SessionStartResponse): unknown;
+    formatSessionStartResponse(response: SessionStartResponse): unknown;
     getSettingsPath(): string;
     /**
      * Kiro stores per-project context under .kiro/ (steering files, etc).

package/build/adapters/kiro/index.js

@@ -36,10 +36,10 @@ export class KiroAdapter extends BaseAdapter {
         preToolUse: true,
         postToolUse: true,
         preCompact: false,
-        sessionStart: false,
+        sessionStart: true, // Kiro agentSpawn = SessionStart equivalent
         canModifyArgs: false, // Kiro CLI uses exit codes, can't modify input
         canModifyOutput: false,
-        canInjectSessionContext: false,
+        canInjectSessionContext: true, // agentSpawn returns additionalContext via JSON stdout
     };
     // ── Input parsing ──────────────────────────────────────
     parsePreToolUseInput(raw) {
@@ -69,8 +69,16 @@ export class KiroAdapter extends BaseAdapter {
     parsePreCompactInput(_raw) {
         throw new Error("Kiro does not support PreCompact hooks");
     }
-    parseSessionStartInput(_raw) {
-        throw new Error("Kiro does not support SessionStart hooks (yet)");
+    parseSessionStartInput(raw) {
+        // Kiro maps agentSpawn -> SessionStart. Stdin shape mirrors codex/CC.
+        const input = (raw ?? {});
+        const source = input.source ?? "startup";
+        return {
+            source,
+            sessionId: `pid-${process.ppid}`,
+            projectDir: input.cwd ?? process.cwd(),
+            raw,
+        };
     }
     // ── Response formatting ────────────────────────────────
     formatPreToolUseResponse(response) {
@@ -91,8 +99,16 @@ export class KiroAdapter extends BaseAdapter {
     formatPreCompactResponse(_response) {
         return undefined;
     }
-    formatSessionStartResponse(_response) {
-        return undefined;
+    formatSessionStartResponse(response) {
+        // Kiro agentSpawn returns the same hookSpecificOutput shape as CC SessionStart.
+        if (!response?.context)
+            return undefined;
+        return {
+            hookSpecificOutput: {
+                hookEventName: "agentSpawn",
+                additionalContext: response.context,
+            },
+        };
     }
     // ── Configuration ──────────────────────────────────────
     getSettingsPath() {
@@ -111,8 +127,8 @@ export class KiroAdapter extends BaseAdapter {
         return ["KIRO.md"];
     }
     generateHookConfig(pluginRoot) {
-        // Kiro CLI hook config format: { preToolUse: [{ matcher, command }] }
-        // Note: This generates the entries for agent config files
+        // Kiro CLI hook config format: { <hookName>: [{ matcher, command }] }
+        // Note: This generates the entries for agent config files (~/.kiro/agents/*.json).
         return {
             [KIRO_HOOK_TYPES.PRE_TOOL_USE]: [{
                     matcher: KIRO_PRE_TOOL_USE_MATCHER_PATTERN,
@@ -122,6 +138,14 @@ export class KiroAdapter extends BaseAdapter {
                     matcher: "*",
                     hooks: [{ type: "command", command: buildKiroHookCommand(KIRO_HOOK_TYPES.POST_TOOL_USE, pluginRoot) }],
                 }],
+            [KIRO_HOOK_TYPES.AGENT_SPAWN]: [{
+                    matcher: "*",
+                    hooks: [{ type: "command", command: buildKiroHookCommand(KIRO_HOOK_TYPES.AGENT_SPAWN, pluginRoot) }],
+                }],
+            [KIRO_HOOK_TYPES.USER_PROMPT_SUBMIT]: [{
+                    matcher: "*",
+                    hooks: [{ type: "command", command: buildKiroHookCommand(KIRO_HOOK_TYPES.USER_PROMPT_SUBMIT, pluginRoot) }],
+                }],
         };
     }
     readSettings() {
@@ -233,25 +257,23 @@ export class KiroAdapter extends BaseAdapter {
                 // No existing config — create new
             }
             const hooks = (config.hooks ?? {});
-            // Add preToolUse hook if not present
-            const preToolUseEntries = (hooks[KIRO_HOOK_TYPES.PRE_TOOL_USE] ?? []);
-            if (!preToolUseEntries.some(e => isKiroContextModeHook(e, KIRO_HOOK_TYPES.PRE_TOOL_USE))) {
-                preToolUseEntries.push({
-                    matcher: KIRO_PRE_TOOL_USE_MATCHER_PATTERN,
-                    command: buildKiroHookCommand(KIRO_HOOK_TYPES.PRE_TOOL_USE, pluginRoot),
-                });
-                hooks[KIRO_HOOK_TYPES.PRE_TOOL_USE] = preToolUseEntries;
-                changes.push(`Added ${KIRO_HOOK_TYPES.PRE_TOOL_USE} hook to ${defaultAgent}`);
-            }
-            // Add postToolUse hook if not present
-            const postToolUseEntries = (hooks[KIRO_HOOK_TYPES.POST_TOOL_USE] ?? []);
-            if (!postToolUseEntries.some(e => isKiroContextModeHook(e, KIRO_HOOK_TYPES.POST_TOOL_USE))) {
-                postToolUseEntries.push({
-                    matcher: "*",
-                    command: buildKiroHookCommand(KIRO_HOOK_TYPES.POST_TOOL_USE, pluginRoot),
-                });
-                hooks[KIRO_HOOK_TYPES.POST_TOOL_USE] = postToolUseEntries;
-                changes.push(`Added ${KIRO_HOOK_TYPES.POST_TOOL_USE} hook to ${defaultAgent}`);
+            // Hooks to add: [hookType, matcher]
+            const hookSpecs = [
+                [KIRO_HOOK_TYPES.PRE_TOOL_USE, KIRO_PRE_TOOL_USE_MATCHER_PATTERN],
+                [KIRO_HOOK_TYPES.POST_TOOL_USE, "*"],
+                [KIRO_HOOK_TYPES.AGENT_SPAWN, "*"],
+                [KIRO_HOOK_TYPES.USER_PROMPT_SUBMIT, "*"],
+            ];
+            for (const [hookType, matcher] of hookSpecs) {
+                const entries = (hooks[hookType] ?? []);
+                if (!entries.some(e => isKiroContextModeHook(e, hookType))) {
+                    entries.push({
+                        matcher,
+                        command: buildKiroHookCommand(hookType, pluginRoot),
+                    });
+                    hooks[hookType] = entries;
+                    changes.push(`Added ${hookType} hook to ${defaultAgent}`);
+                }
             }
             config.hooks = hooks;
             writeFileSync(defaultAgent, JSON.stringify(config, null, 2), "utf-8");

package/build/adapters/opencode/index.js

@@ -40,10 +40,10 @@ export class OpenCodeAdapter extends BaseAdapter {
         preToolUse: true,
         postToolUse: true,
         preCompact: true, // experimental
-        sessionStart: false,
+        sessionStart: true,
         canModifyArgs: true,
         canModifyOutput: true, // with TUI bug caveat for bash (#13575)
-        canInjectSessionContext: false,
+        canInjectSessionContext: true,
     };
     platform;
     constructor(platform = "opencode") {
@@ -152,11 +152,17 @@ export class OpenCodeAdapter extends BaseAdapter {
     }
     paths() {
         if (this.platform === "kilo") {
+            // Kilo runtime accepts `.kilo/`, `.kilocode/`, and `.opencode/` as
+            // project config dirs (refs/platforms/kilo/packages/opencode/src/
+            // kilocode/config/config.ts:50,408). Mirror that here so context-mode
+            // discovers config regardless of which suffix the user adopted.
             return [
                 resolve("kilo.json"),
                 resolve("kilo.jsonc"),
                 resolve(".kilo", "kilo.json"),
                 resolve(".kilo", "kilo.jsonc"),
+                resolve(".kilocode", "kilo.json"),
+                resolve(".kilocode", "kilo.jsonc"),
                 join(homedir(), ".config", "kilo", "kilo.json"),
                 join(homedir(), ".config", "kilo", "kilo.jsonc"),
             ];
@@ -304,11 +310,11 @@ export class OpenCodeAdapter extends BaseAdapter {
                 fix: "context-mode upgrade",
             });
         }
-        // Warn about SessionStart limitation
+        // Note: SessionStart handled via experimental.chat.system.transform surrogate
         results.push({
             check: "SessionStart hook",
-            status: "warn",
-            message: `SessionStart not supported in ${this.name} (see issues #14808, #5409)`,
+            status: "pass",
+            message: `SessionStart via experimental.chat.system.transform surrogate (native hook pending #14808, #5409)`,
         });
         return results;
     }

package/build/adapters/qwen-code/index.js

@@ -230,6 +230,9 @@ export class QwenCodeAdapter extends ClaudeCodeBaseAdapter {
             }
         }
         // ── Phase 2: Register fresh hooks ────────────────────
+        // All 5 hooks must be wired (z6 — capabilities declare 5 events but
+        // configureAllHooks previously only wrote 2). Qwen Code's hook stdin shape
+        // is wire-identical to Claude Code, so we reuse top-level hook scripts.
         const hookTypes = [
             {
                 name: "PreToolUse",
@@ -242,11 +245,26 @@ export class QwenCodeAdapter extends ClaudeCodeBaseAdapter {
                     "mcp__plugin_context-mode_context-mode__ctx_batch_execute",
                 ].join("|"),
             },
+            {
+                name: "PostToolUse",
+                script: "posttooluse.mjs",
+                matcher: "run_shell_command|read_file|write_file|edit|glob|grep_search|todo_write|agent|ask_user_question|mcp__",
+            },
             {
                 name: "SessionStart",
                 script: "sessionstart.mjs",
                 matcher: "",
             },
+            {
+                name: "PreCompact",
+                script: "precompact.mjs",
+                matcher: "",
+            },
+            {
+                name: "UserPromptSubmit",
+                script: "userpromptsubmit.mjs",
+                matcher: "",
+            },
         ];
         for (const { name, script, matcher } of hookTypes) {
             const entry = {