context-mode 1.0.54 → 1.0.56

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Claude Code plugins by Mert Koseoğlu",
-    "version": "1.0.54"
+    "version": "1.0.56"
   },
   "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.54",
+      "version": "1.0.56",
       "author": {
         "name": "Mert Koseoğlu"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.54",
+  "version": "1.0.56",
   "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.54",
+  "version": "1.0.56",
   "sandbox": {
     "mode": "permissive",
     "filesystem_access": "full",

package/.openclaw-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.54",
+  "version": "1.0.56",
   "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

@@ -282,15 +282,23 @@ Full configs: [`configs/cursor/hooks.json`](configs/cursor/hooks.json) | [`confi
 
    The `mcp` entry registers the 6 sandbox 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. Restart OpenCode.
+3. *(Optional)* Copy the routing rules file. OpenCode lacks a SessionStart hook, so the model needs an `AGENTS.md` file for routing awareness:
+
+   ```bash
+   cp node_modules/context-mode/configs/opencode/AGENTS.md AGENTS.md
+   ```
+
+   This tells the model which tools to use and which commands are blocked. Without it, hooks still enforce routing — but the model won't know *why* a command was denied.
+
+4. Restart OpenCode.
 
 **Verify:** In the OpenCode session, type `ctx stats`. Context-mode tools should appear and respond.
 
-**Routing:** Automatic. The plugin intercepts tool calls at runtime via `tool.execute.before` and `tool.execute.after`. No routing file is written to your project. 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.
 
 > **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.
 
-Full config: [`configs/opencode/opencode.json`](configs/opencode/opencode.json)
+Full configs: [`configs/opencode/opencode.json`](configs/opencode/opencode.json) | [`configs/opencode/AGENTS.md`](configs/opencode/AGENTS.md)
 
 </details>
 
@@ -324,11 +332,17 @@ Full config: [`configs/opencode/opencode.json`](configs/opencode/opencode.json)
 
    The `mcp` entry registers the 6 sandbox 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. Restart KiloCode.
+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:
+
+   ```bash
+   cp node_modules/context-mode/configs/opencode/AGENTS.md AGENTS.md
+   ```
+
+4. Restart KiloCode.
 
 **Verify:** In the KiloCode session, type `ctx stats`. Context-mode tools should appear and respond.
 
-**Routing:** Automatic. The plugin intercepts tool calls at runtime via `tool.execute.before` and `tool.execute.after`. No routing file is written to your project. 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.
 
 > **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.
 
@@ -710,7 +724,7 @@ Session continuity requires 4 hooks working together:
 | **SessionStart** | Restores state after compaction or resume | Yes | Yes | Yes | -- | -- | -- | Plugin | -- | -- | -- | -- | ✓ (via session_start event) |
 | | **Session completeness** | **Full** | **High** | **High** | **Partial** | **High** | **High** | **High** | **--** | **--** | **Partial** | **--** | **High** |
 
-> **Note:** Full session continuity (capture + snapshot + restore) works on **Claude Code**, **Gemini CLI**, **VS Code Copilot**, and **OpenCode**. **KiloCode** shares the same plugin architecture as OpenCode via the OpenCodeAdapter. **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. **OpenCode** uses the `experimental.session.compacting` plugin hook for compaction recovery, but SessionStart is not yet available ([#14808](https://github.com/sst/opencode/issues/14808)), so startup/resume is not supported. **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**, **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**, and **VS Code 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**, **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>

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

@@ -16,7 +16,7 @@
  *   - MCP support: https://antigravity.google/docs/mcp
  *   - Tool list: System prompt leak (21 verified tools)
  */
-import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration, RoutingInstructionsConfig } from "../types.js";
+import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration } from "../types.js";
 export declare class AntigravityAdapter implements HookAdapter {
     readonly name = "Antigravity";
     readonly paradigm: HookParadigm;
@@ -43,7 +43,5 @@ export declare class AntigravityAdapter implements HookAdapter {
     backupSettings(): string | null;
     setHookPermissions(_pluginRoot: string): string[];
     updatePluginRegistry(_pluginRoot: string, _version: string): void;
-    getRoutingInstructionsConfig(): RoutingInstructionsConfig;
-    writeRoutingInstructions(projectDir: string, pluginRoot: string): string | null;
     getRoutingInstructions(): string;
 }

package/build/adapters/antigravity/index.js

@@ -175,36 +175,6 @@ export class AntigravityAdapter {
     updatePluginRegistry(_pluginRoot, _version) {
         // Antigravity plugin registry is managed via mcp_config.json
     }
-    // ── Routing Instructions (soft enforcement) ────────────
-    getRoutingInstructionsConfig() {
-        return {
-            fileName: "GEMINI.md",
-            globalPath: resolve(homedir(), ".gemini", "GEMINI.md"),
-            projectRelativePath: "GEMINI.md",
-        };
-    }
-    writeRoutingInstructions(projectDir, pluginRoot) {
-        const config = this.getRoutingInstructionsConfig();
-        const targetPath = resolve(projectDir, config.projectRelativePath);
-        const sourcePath = resolve(pluginRoot, "configs", "antigravity", config.fileName);
-        try {
-            const content = readFileSync(sourcePath, "utf-8");
-            try {
-                const existing = readFileSync(targetPath, "utf-8");
-                if (existing.includes("context-mode"))
-                    return null;
-                writeFileSync(targetPath, existing.trimEnd() + "\n\n" + content, "utf-8");
-                return targetPath;
-            }
-            catch {
-                writeFileSync(targetPath, content, "utf-8");
-                return targetPath;
-            }
-        }
-        catch {
-            return null;
-        }
-    }
     getRoutingInstructions() {
         const instructionsPath = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "..", "configs", "antigravity", "GEMINI.md");
         try {

package/build/adapters/claude-code/index.d.ts

@@ -13,7 +13,7 @@
  *   - Config: ~/.claude/settings.json
  *   - Session dir: ~/.claude/context-mode/sessions/
  */
-import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration, RoutingInstructionsConfig } from "../types.js";
+import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration } from "../types.js";
 export declare class ClaudeCodeAdapter implements HookAdapter {
     readonly name = "Claude Code";
     readonly paradigm: HookParadigm;
@@ -44,8 +44,6 @@ export declare class ClaudeCodeAdapter implements HookAdapter {
     backupSettings(): string | null;
     setHookPermissions(pluginRoot: string): string[];
     updatePluginRegistry(pluginRoot: string, version: string): void;
-    getRoutingInstructionsConfig(): RoutingInstructionsConfig;
-    writeRoutingInstructions(projectDir: string, pluginRoot: string): string | null;
     /**
      * Extract session ID from Claude Code hook input.
      * Priority: transcript_path UUID > session_id field > CLAUDE_SESSION_ID env > ppid fallback.

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

@@ -17,7 +17,7 @@ import { createHash } from "node:crypto";
 import { readFileSync, writeFileSync, mkdirSync, copyFileSync, accessSync, existsSync, readdirSync, chmodSync, constants, } from "node:fs";
 import { resolve, join } from "node:path";
 import { homedir } from "node:os";
-import { HOOK_TYPES, HOOK_SCRIPTS, PRE_TOOL_USE_MATCHER_PATTERN, isContextModeHook, isAnyContextModeHook, extractHookScriptPath, buildHookCommand, } from "./hooks.js";
+import { HOOK_TYPES, HOOK_SCRIPTS, REQUIRED_HOOKS, PRE_TOOL_USE_MATCHER_PATTERN, isContextModeHook, isAnyContextModeHook, extractHookScriptPath, buildHookCommand, } from "./hooks.js";
 // ─────────────────────────────────────────────────────────
 // Adapter implementation
 // ─────────────────────────────────────────────────────────
@@ -414,6 +414,20 @@ export class ClaudeCodeAdapter {
                 changes.push(`Removed ${removed} stale ${hookType} hook(s)`);
             }
         }
+        // If plugin hooks.json already covers all required hooks, skip settings.json
+        // registration entirely (Issue #198). Plugin installs don't need settings.json
+        // entries — hooks.json with ${CLAUDE_PLUGIN_ROOT} is the source of truth.
+        const pluginHooks = this.readPluginHooks(pluginRoot);
+        if (pluginHooks) {
+            const allCovered = REQUIRED_HOOKS.every((ht) => this.checkHookType(undefined, pluginHooks, ht));
+            if (allCovered) {
+                // Still write cleaned settings (stale removal) but don't add new entries
+                settings.hooks = hooks;
+                this.writeSettings(settings);
+                changes.push("Skipped settings.json registration — plugin hooks.json is sufficient");
+                return changes;
+            }
+        }
         // Register fresh hooks for required hook types
         const hookTypes = [
             HOOK_TYPES.PRE_TOOL_USE,
@@ -518,39 +532,6 @@ export class ClaudeCodeAdapter {
             /* best effort */
         }
     }
-    // ── Routing Instructions (soft enforcement) ────────────
-    getRoutingInstructionsConfig() {
-        return {
-            fileName: "CLAUDE.md",
-            globalPath: resolve(homedir(), ".claude", "CLAUDE.md"),
-            projectRelativePath: "CLAUDE.md",
-        };
-    }
-    writeRoutingInstructions(projectDir, pluginRoot) {
-        const config = this.getRoutingInstructionsConfig();
-        const targetPath = resolve(projectDir, config.projectRelativePath);
-        const sourcePath = resolve(pluginRoot, "configs", "claude-code", config.fileName);
-        try {
-            const content = readFileSync(sourcePath, "utf-8");
-            // Check if file exists and already has context-mode instructions
-            try {
-                const existing = readFileSync(targetPath, "utf-8");
-                if (existing.includes("context-mode"))
-                    return null;
-                // Append to existing file
-                writeFileSync(targetPath, existing.trimEnd() + "\n\n" + content, "utf-8");
-                return targetPath;
-            }
-            catch {
-                // File doesn't exist — create it
-                writeFileSync(targetPath, content, "utf-8");
-                return targetPath;
-            }
-        }
-        catch {
-            return null;
-        }
-    }
     // ── Internal helpers ───────────────────────────────────
     /**
      * Extract session ID from Claude Code hook input.

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

@@ -11,7 +11,7 @@
  *   - All capabilities are false — MCP is the only integration path
  *   - Session dir: ~/.codex/context-mode/sessions/
  */
-import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration, RoutingInstructionsConfig } from "../types.js";
+import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration } from "../types.js";
 export declare class CodexAdapter implements HookAdapter {
     readonly name = "Codex CLI";
     readonly paradigm: HookParadigm;
@@ -38,7 +38,5 @@ export declare class CodexAdapter implements HookAdapter {
     backupSettings(): string | null;
     setHookPermissions(_pluginRoot: string): string[];
     updatePluginRegistry(_pluginRoot: string, _version: string): void;
-    getRoutingInstructionsConfig(): RoutingInstructionsConfig;
-    writeRoutingInstructions(projectDir: string, pluginRoot: string): string | null;
     getRoutingInstructions(): string;
 }

package/build/adapters/codex/index.js

@@ -12,7 +12,7 @@
  *   - Session dir: ~/.codex/context-mode/sessions/
  */
 import { createHash } from "node:crypto";
-import { readFileSync, writeFileSync, mkdirSync, copyFileSync, accessSync, constants, } from "node:fs";
+import { readFileSync, mkdirSync, copyFileSync, accessSync, constants, } from "node:fs";
 import { resolve, join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 import { homedir } from "node:os";
@@ -180,36 +180,6 @@ export class CodexAdapter {
     updatePluginRegistry(_pluginRoot, _version) {
         // Codex CLI has no plugin registry
     }
-    // ── Routing Instructions (soft enforcement) ────────────
-    getRoutingInstructionsConfig() {
-        return {
-            fileName: "AGENTS.md",
-            globalPath: resolve(homedir(), ".codex", "AGENTS.md"),
-            projectRelativePath: "AGENTS.md",
-        };
-    }
-    writeRoutingInstructions(projectDir, pluginRoot) {
-        const config = this.getRoutingInstructionsConfig();
-        const targetPath = resolve(projectDir, config.projectRelativePath);
-        const sourcePath = resolve(pluginRoot, "configs", "codex", config.fileName);
-        try {
-            const content = readFileSync(sourcePath, "utf-8");
-            try {
-                const existing = readFileSync(targetPath, "utf-8");
-                if (existing.includes("context-mode"))
-                    return null;
-                writeFileSync(targetPath, existing.trimEnd() + "\n\n" + content, "utf-8");
-                return targetPath;
-            }
-            catch {
-                writeFileSync(targetPath, content, "utf-8");
-                return targetPath;
-            }
-        }
-        catch {
-            return null;
-        }
-    }
     getRoutingInstructions() {
         const instructionsPath = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "..", "configs", "codex", "AGENTS.md");
         try {

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

@@ -4,7 +4,7 @@
  * Native Cursor hooks use lower-camel hook names and flat command entries in
  * `.cursor/hooks.json` / `~/.cursor/hooks.json`.
  */
-import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, SessionStartResponse, HookRegistration, RoutingInstructionsConfig } from "../types.js";
+import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, SessionStartResponse, HookRegistration } from "../types.js";
 export declare class CursorAdapter implements HookAdapter {
     readonly name = "Cursor";
     readonly paradigm: HookParadigm;
@@ -29,8 +29,6 @@ export declare class CursorAdapter implements HookAdapter {
     backupSettings(): string | null;
     setHookPermissions(pluginRoot: string): string[];
     updatePluginRegistry(_pluginRoot: string, _version: string): void;
-    getRoutingInstructionsConfig(): RoutingInstructionsConfig;
-    writeRoutingInstructions(_projectDir: string, _pluginRoot: string): string | null;
     private getCandidateHookConfigPaths;
     private getProjectDir;
     private extractSessionId;

package/build/adapters/cursor/index.js

@@ -338,17 +338,6 @@ export class CursorAdapter {
     updatePluginRegistry(_pluginRoot, _version) {
         // Cursor manages extensions and native hooks internally.
     }
-    getRoutingInstructionsConfig() {
-        return {
-            fileName: "AGENTS.md",
-            globalPath: "",
-            projectRelativePath: "AGENTS.md",
-        };
-    }
-    writeRoutingInstructions(_projectDir, _pluginRoot) {
-        // Native Cursor hook support ships independently from any instruction-file story.
-        return null;
-    }
     getCandidateHookConfigPaths() {
         const paths = [this.getSettingsPath(), join(homedir(), ".cursor", "hooks.json")];
         if (process.platform === "darwin") {

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

@@ -18,7 +18,7 @@
  *   - Project dir env: GEMINI_PROJECT_DIR (also CLAUDE_PROJECT_DIR alias)
  *   - Session dir: ~/.gemini/context-mode/sessions/
  */
-import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration, RoutingInstructionsConfig } from "../types.js";
+import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration } from "../types.js";
 export declare class GeminiCLIAdapter implements HookAdapter {
     readonly name = "Gemini CLI";
     readonly paradigm: HookParadigm;
@@ -45,8 +45,6 @@ export declare class GeminiCLIAdapter implements HookAdapter {
     backupSettings(): string | null;
     setHookPermissions(pluginRoot: string): string[];
     updatePluginRegistry(pluginRoot: string, version: string): void;
-    getRoutingInstructionsConfig(): RoutingInstructionsConfig;
-    writeRoutingInstructions(projectDir: string, pluginRoot: string): string | null;
     /** Get the project directory from environment variables. */
     private getProjectDir;
     /**

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

@@ -421,36 +421,6 @@ export class GeminiCLIAdapter {
             /* best effort */
         }
     }
-    // ── Routing Instructions (soft enforcement) ────────────
-    getRoutingInstructionsConfig() {
-        return {
-            fileName: "GEMINI.md",
-            globalPath: resolve(homedir(), ".gemini", "GEMINI.md"),
-            projectRelativePath: "GEMINI.md",
-        };
-    }
-    writeRoutingInstructions(projectDir, pluginRoot) {
-        const config = this.getRoutingInstructionsConfig();
-        const targetPath = resolve(projectDir, config.projectRelativePath);
-        const sourcePath = resolve(pluginRoot, "configs", "gemini-cli", config.fileName);
-        try {
-            const content = readFileSync(sourcePath, "utf-8");
-            try {
-                const existing = readFileSync(targetPath, "utf-8");
-                if (existing.includes("context-mode"))
-                    return null;
-                writeFileSync(targetPath, existing.trimEnd() + "\n\n" + content, "utf-8");
-                return targetPath;
-            }
-            catch {
-                writeFileSync(targetPath, content, "utf-8");
-                return targetPath;
-            }
-        }
-        catch {
-            return null;
-        }
-    }
     // ── Internal helpers ───────────────────────────────────
     /** Get the project directory from environment variables. */
     getProjectDir() {

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

@@ -17,7 +17,7 @@
  *   - clientInfo.name: https://github.com/kirodotdev/Kiro/issues/5205 ("Kiro CLI")
  *   - CLI hooks: https://kiro.dev/docs/cli/custom-agents/configuration-reference#hooks-field
  */
-import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration, RoutingInstructionsConfig } from "../types.js";
+import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration } from "../types.js";
 export declare class KiroAdapter implements HookAdapter {
     readonly name = "Kiro";
     readonly paradigm: HookParadigm;
@@ -44,7 +44,5 @@ export declare class KiroAdapter implements HookAdapter {
     backupSettings(): string | null;
     setHookPermissions(_pluginRoot: string): string[];
     updatePluginRegistry(_pluginRoot: string, _version: string): void;
-    getRoutingInstructionsConfig(): RoutingInstructionsConfig;
-    writeRoutingInstructions(projectDir: string, pluginRoot: string): string | null;
     getRoutingInstructions(): string;
 }

package/build/adapters/kiro/index.js

@@ -283,36 +283,6 @@ export class KiroAdapter {
     updatePluginRegistry(_pluginRoot, _version) {
         // Kiro plugin registry is managed via mcp.json
     }
-    // ── Routing Instructions (soft enforcement) ────────────
-    getRoutingInstructionsConfig() {
-        return {
-            fileName: "KIRO.md",
-            globalPath: resolve(homedir(), ".kiro", "KIRO.md"),
-            projectRelativePath: "KIRO.md",
-        };
-    }
-    writeRoutingInstructions(projectDir, pluginRoot) {
-        const config = this.getRoutingInstructionsConfig();
-        const targetPath = resolve(projectDir, config.projectRelativePath);
-        const sourcePath = resolve(pluginRoot, "configs", "kiro", config.fileName);
-        try {
-            const content = readFileSync(sourcePath, "utf-8");
-            try {
-                const existing = readFileSync(targetPath, "utf-8");
-                if (existing.includes("context-mode"))
-                    return null;
-                writeFileSync(targetPath, existing.trimEnd() + "\n\n" + content, "utf-8");
-                return targetPath;
-            }
-            catch {
-                writeFileSync(targetPath, content, "utf-8");
-                return targetPath;
-            }
-        }
-        catch {
-            return null;
-        }
-    }
     getRoutingInstructions() {
         const instructionsPath = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "..", "configs", "kiro", "KIRO.md");
         try {

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

@@ -15,7 +15,7 @@
  *   - Config: openclaw.json plugins.entries, ~/.openclaw/extensions/
  *   - Session dir: ~/.openclaw/context-mode/sessions/
  */
-import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration, RoutingInstructionsConfig } from "../types.js";
+import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration } from "../types.js";
 export declare class OpenClawAdapter implements HookAdapter {
     readonly name = "OpenClaw";
     readonly paradigm: HookParadigm;
@@ -42,8 +42,6 @@ export declare class OpenClawAdapter implements HookAdapter {
     backupSettings(): string | null;
     setHookPermissions(_pluginRoot: string): string[];
     updatePluginRegistry(_pluginRoot: string, _version: string): void;
-    getRoutingInstructionsConfig(): RoutingInstructionsConfig;
-    writeRoutingInstructions(projectDir: string, pluginRoot: string): string | null;
     /**
      * Extract session ID from OpenClaw hook input.
      */

package/build/adapters/openclaw/index.js

@@ -409,44 +409,6 @@ export class OpenClawAdapter {
     updatePluginRegistry(_pluginRoot, _version) {
         // OpenClaw manages plugins through npm/openclaw.json — no separate registry
     }
-    // ── Routing Instructions (soft enforcement) ────────────
-    getRoutingInstructionsConfig() {
-        return {
-            fileName: "AGENTS.md",
-            globalPath: resolve(homedir(), ".openclaw", "AGENTS.md"),
-            projectRelativePath: "AGENTS.md",
-        };
-    }
-    writeRoutingInstructions(projectDir, pluginRoot) {
-        const config = this.getRoutingInstructionsConfig();
-        const targetPath = resolve(projectDir, config.projectRelativePath);
-        const sourcePath = resolve(pluginRoot, "configs", "openclaw", config.fileName);
-        try {
-            let content;
-            try {
-                content = readFileSync(sourcePath, "utf-8");
-            }
-            catch {
-                // Fall back to opencode config if openclaw-specific doesn't exist yet
-                const fallbackPath = resolve(pluginRoot, "configs", "opencode", config.fileName);
-                content = readFileSync(fallbackPath, "utf-8");
-            }
-            try {
-                const existing = readFileSync(targetPath, "utf-8");
-                if (existing.includes("context-mode"))
-                    return null;
-                writeFileSync(targetPath, existing.trimEnd() + "\n\n" + content, "utf-8");
-                return targetPath;
-            }
-            catch {
-                writeFileSync(targetPath, content, "utf-8");
-                return targetPath;
-            }
-        }
-        catch {
-            return null;
-        }
-    }
     // ── Internal helpers ───────────────────────────────────
     /**
      * Extract session ID from OpenClaw hook input.

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

@@ -15,7 +15,7 @@
  *   - Config: opencode.json plugin array, .opencode/plugins/*.ts
  *   - Session dir: ~/.config/opencode/context-mode/sessions/
  */
-import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration, RoutingInstructionsConfig, PlatformId } from "../types.js";
+import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration, PlatformId } from "../types.js";
 export type AdapterPlatformType = Extract<PlatformId, "opencode" | "kilo">;
 export declare class OpenCodeAdapter implements HookAdapter {
     get name(): string;
@@ -47,8 +47,6 @@ export declare class OpenCodeAdapter implements HookAdapter {
     backupSettings(): string | null;
     setHookPermissions(_pluginRoot: string): string[];
     updatePluginRegistry(_pluginRoot: string, _version: string): void;
-    getRoutingInstructionsConfig(): RoutingInstructionsConfig;
-    writeRoutingInstructions(projectDir: string, pluginRoot: string): string | null;
     /**
      * Extract session ID from OpenCode hook input.
      * OpenCode uses camelCase sessionID.