@mxalbert/context-mode 2.0.0

package/build/adapters/types.js

@@ -0,0 +1,118 @@
+/**
+ * adapters/types — Platform adapter interface for multi-platform hook support.
+ *
+ * Defines the contract that each platform adapter must implement.
+ * Three paradigms exist across supported platforms:
+ *   A) JSON stdin/stdout — Claude Code, Gemini/Qwen family CLIs, Copilot/Codex/Kimi,
+ *      Cursor, Kiro, Antigravity CLI (`agy`)
+ *   B) TS Plugin Functions — OpenCode, KiloCode, OpenClaw
+ *   C) MCP-only (no hooks) — Antigravity IDE, Zed, Pi/OMP MCP-only paths
+ *
+ * The MCP server layer is 100% portable and needs no adapter.
+ * Only the hook layer requires platform-specific adapters.
+ */
+// ─────────────────────────────────────────────────────────
+// Hook paradigm
+// ─────────────────────────────────────────────────────────
+import { resolveHookRuntime } from "../runtime.js";
+// ─────────────────────────────────────────────────────────
+// Platform detection
+// ─────────────────────────────────────────────────────────
+// ─────────────────────────────────────────────────────────
+// Cross-platform command helpers (#369, #372)
+// ─────────────────────────────────────────────────────────
+/**
+ * Build a cross-platform `node <script>` command string.
+ *
+ * Fixes two Windows bugs:
+ *   #369 — Bare `node` fails on Windows Git Bash (MSYS) because PATH
+ *          resolution is unreliable. Uses `process.execPath` instead.
+ *   #372 — MSYS rewrites absolute paths on non-C: drives (e.g.
+ *          `C:\Users\...` → `D:\c\Users\...`). Forward slashes +
+ *          double-quoting prevents the translation.
+ *
+ * Safe on macOS/Linux — quoting and forward slashes are no-ops there.
+ */
+export function buildNodeCommand(scriptPath, opts) {
+    let nodePath = process.execPath.replace(/\\/g, "/");
+    if (isInProcessPluginPlatform(opts?.platform)) {
+        const base = nodePath.split("/").pop().replace(/\.exe$/i, "");
+        if (!JS_RUNTIMES.has(base)) {
+            nodePath = opts?.jsRuntime?.replace(/\\/g, "/") ?? "node";
+        }
+    }
+    const safePath = scriptPath.replace(/\\/g, "/");
+    return `"${nodePath}" "${safePath}"`;
+}
+/**
+ * Build a cross-platform hook spawn command using the resolved JS runtime
+ * (issue #738). Identical wire-format to {@link buildNodeCommand} — two
+ * double-quoted, forward-slashed tokens separated by whitespace — so it
+ * round-trips through {@link parseNodeCommand} unchanged.
+ *
+ * The only difference is the runtime path: when a Bun ≥1.0 install is
+ * detected at process start, that path is used in place of `process.execPath`.
+ * Hooks run end-to-end in pure JS (no native modules) so swapping the
+ * runtime is a no-op for output but cuts ~40-60ms of Node cold-start per
+ * tool call.
+ *
+ * Why a SEPARATE helper instead of repurposing {@link buildNodeCommand}:
+ *   `buildNodeCommand` is also called by openclaw plugin (doctor / upgrade
+ *   command suggestions in `src/adapters/openclaw/plugin.ts`). Those CLI
+ *   targets MUST stay on Node because they load better-sqlite3, which has
+ *   no Bun-compatible prebuild yet (#543). Keeping the two helpers separate
+ *   makes the audit trivial: anything emitting a hook spawn command uses
+ *   `buildHookRuntimeCommand`; anything emitting a user-visible CLI command
+ *   stays on `buildNodeCommand`.
+ *
+ * `opts.platform` is forwarded to {@link isInProcessPluginPlatform} so the
+ * existing opencode/kilo in-process JS-runtime substitution still works
+ * (those platforms inject their own runtime via `opts.jsRuntime`).
+ */
+export function buildHookRuntimeCommand(scriptPath, opts) {
+    // In-process plugin platforms (opencode/kilo) inject their own runtime —
+    // delegate to buildNodeCommand which already handles that special case.
+    if (isInProcessPluginPlatform(opts?.platform)) {
+        return buildNodeCommand(scriptPath, opts);
+    }
+    const runtime = resolveHookRuntime();
+    const runtimePath = runtime.path.replace(/\\/g, "/");
+    const safePath = scriptPath.replace(/\\/g, "/");
+    return `"${runtimePath}" "${safePath}"`;
+}
+/**
+ * Strict inverse of `buildNodeCommand`.
+ *
+ * Returns `{ nodePath, scriptPath }` ONLY when `cmd` could have been
+ * produced by `buildNodeCommand` — i.e. exactly two double-quoted args
+ * separated by whitespace. Anything else (bare `node …`, single quotes,
+ * unquoted ambiguous input, CLI dispatcher entries) returns `null`.
+ *
+ * Why strict: the legacy `\S+\.mjs` fallback in
+ * `src/util/hook-config.ts:24` and the two-step regex in
+ * `src/adapters/claude-code/hooks.ts:178` silently grabbed the path tail
+ * after the last whitespace whenever the host wire-format dropped quotes,
+ * producing the #548 doubled-path FAIL when `pluginRoot` contained
+ * spaces (e.g. `C:\Users\High Ground Services\…`). A canonical inverse
+ * lets every emit (`buildNodeCommand`) round-trip through every parse
+ * (`parseNodeCommand`) without inventing fallbacks. Adapter #16 inherits
+ * the contract by importing one module.
+ */
+export function parseNodeCommand(cmd) {
+    if (typeof cmd !== "string" || cmd.length === 0)
+        return null;
+    // Match `"<nodePath>" "<scriptPath>"` with arbitrary whitespace
+    // separator. Both segments must be non-empty and contain no embedded
+    // double quotes — buildNodeCommand never emits embedded quotes.
+    const m = cmd.match(/^"([^"]+)"\s+"([^"]+)"\s*$/);
+    if (!m)
+        return null;
+    return { nodePath: m[1], scriptPath: m[2] };
+}
+/** Known JS runtime binary names (base filename without extension). */
+export const JS_RUNTIMES = new Set(["node", "bun", "deno"]);
+/** Platforms where context-mode runs as an in-process TS plugin (not MCP stdio). */
+export const IN_PROCESS_PLUGIN_PLATFORMS = new Set(["opencode", "kilo"]);
+export function isInProcessPluginPlatform(p) {
+    return !!p && IN_PROCESS_PLUGIN_PLATFORMS.has(p);
+}

package/build/adapters/vscode-copilot/config.d.ts

@@ -0,0 +1,8 @@
+/**
+ * adapters/vscode-copilot/config — Thin re-exports from VSCodeCopilotAdapter.
+ *
+ * This module exists for backward compatibility. All logic lives in the
+ * adapter class (index.ts). New code should use getAdapter() from detect.ts.
+ */
+export { VSCodeCopilotAdapter } from "./index.js";
+export { HOOK_TYPES, HOOK_SCRIPTS, REQUIRED_HOOKS, OPTIONAL_HOOKS } from "./hooks.js";

package/build/adapters/vscode-copilot/config.js

@@ -0,0 +1,8 @@
+/**
+ * adapters/vscode-copilot/config — Thin re-exports from VSCodeCopilotAdapter.
+ *
+ * This module exists for backward compatibility. All logic lives in the
+ * adapter class (index.ts). New code should use getAdapter() from detect.ts.
+ */
+export { VSCodeCopilotAdapter } from "./index.js";
+export { HOOK_TYPES, HOOK_SCRIPTS, REQUIRED_HOOKS, OPTIONAL_HOOKS } from "./hooks.js";

package/build/adapters/vscode-copilot/hooks.d.ts

@@ -0,0 +1,71 @@
+/**
+ * adapters/vscode-copilot/hooks — VS Code Copilot hook definitions and matchers.
+ *
+ * Defines the hook types, matchers, and registration format specific to
+ * VS Code Copilot's hook system. This module is used by:
+ *   - CLI setup/upgrade commands (to configure hooks)
+ *   - Doctor command (to validate hook configuration)
+ *   - Hook config generation
+ *
+ * VS Code Copilot hook system reference:
+ *   - Hooks are registered in .github/hooks/*.json
+ *   - Hook names: PreToolUse, PostToolUse, PreCompact, SessionStart (PascalCase)
+ *   - CRITICAL: matchers are parsed but IGNORED (all hooks fire on all tools)
+ *   - Input: JSON on stdin
+ *   - Output: JSON on stdout (or empty for passthrough)
+ *   - Preview status — API may change
+ */
+/** VS Code Copilot hook types. */
+export declare const HOOK_TYPES: {
+    readonly PRE_TOOL_USE: "PreToolUse";
+    readonly POST_TOOL_USE: "PostToolUse";
+    readonly PRE_COMPACT: "PreCompact";
+    readonly SESSION_START: "SessionStart";
+};
+export type HookType = (typeof HOOK_TYPES)[keyof typeof HOOK_TYPES];
+/** Map of hook types to their script file names. */
+export declare const HOOK_SCRIPTS: Record<string, string>;
+/** Required hooks that must be configured for context-mode to function. */
+export declare const REQUIRED_HOOKS: HookType[];
+/** Optional hooks that enhance functionality but aren't critical. */
+export declare const OPTIONAL_HOOKS: HookType[];
+/**
+ * Check if a hook entry points to a context-mode hook script.
+ * Matches both legacy format (node .../pretooluse.mjs) and
+ * CLI dispatcher format (context-mode hook vscode-copilot pretooluse).
+ */
+export declare function isContextModeHook(entry: {
+    hooks?: Array<{
+        command?: string;
+    }>;
+}, hookType: HookType): boolean;
+/**
+ * Build the hook command string for a given hook type.
+ *
+ * Always emits the CLI dispatcher form
+ * (`context-mode hook vscode-copilot <event>`) — the `pluginRoot` argument
+ * is accepted for API compatibility but intentionally ignored.
+ *
+ * Why the dispatcher form is mandatory here (Issue #613 — Tier C contract):
+ *   `.github/hooks/context-mode.json` is a **workspace-committed** file
+ *   (upstream: refs/platforms/vscode-copilot/assets/prompts/skills/
+ *   agent-customization/references/hooks.md line 7 — "Workspace
+ *   (team-shared)"). It lands in every teammate's `git status`. Embedding
+ *   `process.execPath` or any absolute pluginRoot path here:
+ *     - Leaks PII (username, `C:/Users/<user>/...` paths).
+ *     - Breaks cross-machine portability (fnm/nvm/volta/brew shims are
+ *       per-shell-session ephemeral; the path goes stale immediately on
+ *       Windows + fnm).
+ *
+ * Commit `f5c9d02` (2026-03-06) added an absolute-path branch when a
+ * pluginRoot was passed. It solved a real PATH-availability bug on
+ * Brew/nvm setups by going too far — the CLI then always passes
+ * pluginRoot, so the portable form became unreachable in production
+ * and every `/ctx-upgrade` baked a non-portable command into the
+ * committed config. This reverts to the pre-`f5c9d02` shape.
+ *
+ * For users without a global install, the recovery path is the same as
+ * every other CLI-dispatcher adapter (cursor, codex):
+ *   `npm install -g @mxalbert/context-mode`
+ */
+export declare function buildHookCommand(hookType: HookType, _pluginRoot?: string): string;

package/build/adapters/vscode-copilot/hooks.js

@@ -0,0 +1,98 @@
+/**
+ * adapters/vscode-copilot/hooks — VS Code Copilot hook definitions and matchers.
+ *
+ * Defines the hook types, matchers, and registration format specific to
+ * VS Code Copilot's hook system. This module is used by:
+ *   - CLI setup/upgrade commands (to configure hooks)
+ *   - Doctor command (to validate hook configuration)
+ *   - Hook config generation
+ *
+ * VS Code Copilot hook system reference:
+ *   - Hooks are registered in .github/hooks/*.json
+ *   - Hook names: PreToolUse, PostToolUse, PreCompact, SessionStart (PascalCase)
+ *   - CRITICAL: matchers are parsed but IGNORED (all hooks fire on all tools)
+ *   - Input: JSON on stdin
+ *   - Output: JSON on stdout (or empty for passthrough)
+ *   - Preview status — API may change
+ */
+// ─────────────────────────────────────────────────────────
+// Hook type constants
+// ─────────────────────────────────────────────────────────
+/** VS Code Copilot hook types. */
+export const HOOK_TYPES = {
+    PRE_TOOL_USE: "PreToolUse",
+    POST_TOOL_USE: "PostToolUse",
+    PRE_COMPACT: "PreCompact",
+    SESSION_START: "SessionStart",
+};
+// ─────────────────────────────────────────────────────────
+// Hook script file names
+// ─────────────────────────────────────────────────────────
+/** Map of hook types to their script file names. */
+export const HOOK_SCRIPTS = {
+    [HOOK_TYPES.PRE_TOOL_USE]: "pretooluse.mjs",
+    [HOOK_TYPES.POST_TOOL_USE]: "posttooluse.mjs",
+    [HOOK_TYPES.PRE_COMPACT]: "precompact.mjs",
+    [HOOK_TYPES.SESSION_START]: "sessionstart.mjs",
+};
+// ─────────────────────────────────────────────────────────
+// Hook validation
+// ─────────────────────────────────────────────────────────
+/** Required hooks that must be configured for context-mode to function. */
+export const REQUIRED_HOOKS = [
+    HOOK_TYPES.PRE_TOOL_USE,
+    HOOK_TYPES.SESSION_START,
+];
+/** Optional hooks that enhance functionality but aren't critical. */
+export const OPTIONAL_HOOKS = [
+    HOOK_TYPES.POST_TOOL_USE,
+    HOOK_TYPES.PRE_COMPACT,
+];
+/**
+ * Check if a hook entry points to a context-mode hook script.
+ * Matches both legacy format (node .../pretooluse.mjs) and
+ * CLI dispatcher format (context-mode hook vscode-copilot pretooluse).
+ */
+export function isContextModeHook(entry, hookType) {
+    const scriptName = HOOK_SCRIPTS[hookType];
+    if (!scriptName)
+        return false;
+    const cliCommand = buildHookCommand(hookType);
+    return (entry.hooks?.some((h) => h.command?.includes(scriptName) || h.command?.includes(cliCommand)) ?? false);
+}
+/**
+ * Build the hook command string for a given hook type.
+ *
+ * Always emits the CLI dispatcher form
+ * (`context-mode hook vscode-copilot <event>`) — the `pluginRoot` argument
+ * is accepted for API compatibility but intentionally ignored.
+ *
+ * Why the dispatcher form is mandatory here (Issue #613 — Tier C contract):
+ *   `.github/hooks/context-mode.json` is a **workspace-committed** file
+ *   (upstream: refs/platforms/vscode-copilot/assets/prompts/skills/
+ *   agent-customization/references/hooks.md line 7 — "Workspace
+ *   (team-shared)"). It lands in every teammate's `git status`. Embedding
+ *   `process.execPath` or any absolute pluginRoot path here:
+ *     - Leaks PII (username, `C:/Users/<user>/...` paths).
+ *     - Breaks cross-machine portability (fnm/nvm/volta/brew shims are
+ *       per-shell-session ephemeral; the path goes stale immediately on
+ *       Windows + fnm).
+ *
+ * Commit `f5c9d02` (2026-03-06) added an absolute-path branch when a
+ * pluginRoot was passed. It solved a real PATH-availability bug on
+ * Brew/nvm setups by going too far — the CLI then always passes
+ * pluginRoot, so the portable form became unreachable in production
+ * and every `/ctx-upgrade` baked a non-portable command into the
+ * committed config. This reverts to the pre-`f5c9d02` shape.
+ *
+ * For users without a global install, the recovery path is the same as
+ * every other CLI-dispatcher adapter (cursor, codex):
+ *   `npm install -g @mxalbert/context-mode`
+ */
+export function buildHookCommand(hookType, _pluginRoot) {
+    const scriptName = HOOK_SCRIPTS[hookType];
+    if (!scriptName) {
+        throw new Error(`No script defined for hook type: ${hookType}`);
+    }
+    return `context-mode hook vscode-copilot ${hookType.toLowerCase()}`;
+}

package/build/adapters/vscode-copilot/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * adapters/vscode-copilot — VS Code Copilot platform adapter.
+ *
+ * Extends CopilotBaseAdapter with VS Code-specific logic:
+ *   - extractSessionId: VSCODE_PID fallback
+ *   - getProjectDir: CLAUDE_PROJECT_DIR
+ *   - getSessionDir: .github/ detection with ~/.vscode/ fallback
+ *   - checkPluginRegistration: reads .vscode/mcp.json
+ *   - getInstalledVersion: scans VS Code extensions dir
+ *   - validateHooks: preview status + matcher warnings
+ */
+import { CopilotBaseAdapter } from "../copilot-base.js";
+import type { CopilotHookInput, CopilotHookModule } from "../copilot-base.js";
+import type { DiagnosticResult } from "../types.js";
+export declare class VSCodeCopilotAdapter extends CopilotBaseAdapter {
+    constructor();
+    readonly name = "VS Code Copilot";
+    protected readonly hookModule: CopilotHookModule;
+    protected readonly hookSubdir = "vscode-copilot";
+    protected extractSessionId(input: CopilotHookInput): string;
+    protected getProjectDir(): string;
+    getSessionDir(): string;
+    /**
+     * VS Code Copilot honors .github/copilot-instructions.md per project.
+     * Always returned absolute, resolved against `projectDir` (or `cwd`).
+     */
+    getConfigDir(projectDir?: string): string;
+    getInstructionFiles(): string[];
+    validateHooks(pluginRoot: string): DiagnosticResult[];
+    checkPluginRegistration(): DiagnosticResult;
+    getInstalledVersion(): string;
+}

package/build/adapters/vscode-copilot/index.js

@@ -0,0 +1,222 @@
+/**
+ * adapters/vscode-copilot — VS Code Copilot platform adapter.
+ *
+ * Extends CopilotBaseAdapter with VS Code-specific logic:
+ *   - extractSessionId: VSCODE_PID fallback
+ *   - getProjectDir: CLAUDE_PROJECT_DIR
+ *   - getSessionDir: .github/ detection with ~/.vscode/ fallback
+ *   - checkPluginRegistration: reads .vscode/mcp.json
+ *   - getInstalledVersion: scans VS Code extensions dir
+ *   - validateHooks: preview status + matcher warnings
+ */
+import { readFileSync, mkdirSync, accessSync, existsSync, constants, } from "node:fs";
+import { resolve, join } from "node:path";
+import { homedir } from "node:os";
+import { CopilotBaseAdapter } from "../copilot-base.js";
+import { resolveContextModeDataRoot } from "../base.js";
+// ─────────────────────────────────────────────────────────
+// Hook constants (re-exported from hooks.ts)
+// ─────────────────────────────────────────────────────────
+import { HOOK_TYPES as VSCODE_HOOK_NAMES, HOOK_SCRIPTS as VSCODE_HOOK_SCRIPTS, buildHookCommand as buildVSCodeHookCommand, } from "./hooks.js";
+// ─────────────────────────────────────────────────────────
+// Adapter implementation
+// ─────────────────────────────────────────────────────────
+export class VSCodeCopilotAdapter extends CopilotBaseAdapter {
+    constructor() {
+        // sessionDirSegments unused — vscode-copilot overrides getSessionDir()
+        // with .github directory detection fallback logic
+        super([".vscode"]);
+    }
+    name = "VS Code Copilot";
+    hookModule = {
+        HOOK_TYPES: VSCODE_HOOK_NAMES,
+        HOOK_SCRIPTS: VSCODE_HOOK_SCRIPTS,
+        buildHookCommand: buildVSCodeHookCommand,
+    };
+    hookSubdir = "vscode-copilot";
+    // ── Platform-specific overrides ────────────────────────
+    extractSessionId(input) {
+        if (input.sessionId)
+            return input.sessionId;
+        if (process.env.VSCODE_PID)
+            return `vscode-${process.env.VSCODE_PID}`;
+        return `pid-${process.ppid}`;
+    }
+    getProjectDir() {
+        // Cascade order (locked by tests/adapters/vscode-copilot.test.ts):
+        //   1. CLAUDE_PROJECT_DIR — top priority for users running VS Code under
+        //      Claude Code CLI.
+        //   2. VSCODE_CWD — exported by VS Code's bootstrap into every child it
+        //      spawns (refs/platforms/vscode-copilot/src/util/vs/base/common/
+        //      process.ts:31). The MCP child inherits it. Was previously missing
+        //      from this cascade — every direct VS Code Copilot session silently
+        //      lost its workspace folder. PR #689 5-agent EM audit (Phase A
+        //      claim verification) confirmed the gap; this is the minimal fix.
+        //   3. process.cwd() — last resort.
+        return (process.env.CLAUDE_PROJECT_DIR
+            || process.env.VSCODE_CWD
+            || process.cwd());
+    }
+    getSessionDir() {
+        // Issue #649: CONTEXT_MODE_DATA_DIR wins over both the .github project
+        // dir and the ~/.vscode fallback so dev-container/CI users can pin
+        // storage to a writable volume regardless of whether a .github tree
+        // happens to exist in cwd.
+        const override = resolveContextModeDataRoot();
+        if (override) {
+            const overrideDir = join(override, "context-mode", "sessions");
+            mkdirSync(overrideDir, { recursive: true });
+            return overrideDir;
+        }
+        // Prefer .github/context-mode/sessions/ if .github exists,
+        // otherwise fall back to ~/.vscode/context-mode/sessions/
+        const githubDir = resolve(".github", "context-mode", "sessions");
+        const fallbackDir = join(homedir(), ".vscode", "context-mode", "sessions");
+        const dir = existsSync(resolve(".github")) ? githubDir : fallbackDir;
+        mkdirSync(dir, { recursive: true });
+        return dir;
+    }
+    /**
+     * VS Code Copilot honors .github/copilot-instructions.md per project.
+     * Always returned absolute, resolved against `projectDir` (or `cwd`).
+     */
+    getConfigDir(projectDir) {
+        return resolve(projectDir ?? process.cwd(), ".github");
+    }
+    getInstructionFiles() {
+        return ["copilot-instructions.md"];
+    }
+    // ── Diagnostics (doctor) ─────────────────────────────────
+    validateHooks(pluginRoot) {
+        const results = [];
+        // Check .github/hooks/ directory for hook JSON files
+        const hooksDir = resolve(".github", "hooks");
+        try {
+            accessSync(hooksDir, constants.R_OK);
+        }
+        catch {
+            results.push({
+                check: "Hooks directory",
+                status: "fail",
+                message: ".github/hooks/ directory not found",
+                fix: "context-mode upgrade",
+            });
+            return results;
+        }
+        // Check for context-mode hook config
+        const hookConfigPath = resolve(hooksDir, "context-mode.json");
+        try {
+            const raw = readFileSync(hookConfigPath, "utf-8");
+            const config = JSON.parse(raw);
+            const hooks = config.hooks;
+            // Check PreToolUse
+            if (hooks?.[VSCODE_HOOK_NAMES.PRE_TOOL_USE]) {
+                results.push({
+                    check: "PreToolUse hook",
+                    status: "pass",
+                    message: "PreToolUse hook configured in context-mode.json",
+                });
+            }
+            else {
+                results.push({
+                    check: "PreToolUse hook",
+                    status: "fail",
+                    message: "PreToolUse not found in context-mode.json",
+                    fix: "context-mode upgrade",
+                });
+            }
+            // Check SessionStart
+            if (hooks?.[VSCODE_HOOK_NAMES.SESSION_START]) {
+                results.push({
+                    check: "SessionStart hook",
+                    status: "pass",
+                    message: "SessionStart hook configured in context-mode.json",
+                });
+            }
+            else {
+                results.push({
+                    check: "SessionStart hook",
+                    status: "fail",
+                    message: "SessionStart not found in context-mode.json",
+                    fix: "context-mode upgrade",
+                });
+            }
+        }
+        catch {
+            results.push({
+                check: "Hook configuration",
+                status: "fail",
+                message: "Could not read .github/hooks/context-mode.json",
+                fix: "context-mode upgrade",
+            });
+        }
+        // Warn about preview status
+        results.push({
+            check: "API stability",
+            status: "warn",
+            message: "VS Code Copilot hooks are in preview — API may change without notice",
+        });
+        // Warn about matcher behavior
+        results.push({
+            check: "Matcher support",
+            status: "warn",
+            message: "Matchers are parsed but IGNORED — all hooks fire on all tools",
+        });
+        return results;
+    }
+    checkPluginRegistration() {
+        // Check MCP config in .vscode/mcp.json
+        try {
+            const mcpConfigPath = resolve(".vscode", "mcp.json");
+            const raw = readFileSync(mcpConfigPath, "utf-8");
+            const config = JSON.parse(raw);
+            const servers = config.servers;
+            if (servers) {
+                const hasPlugin = Object.keys(servers).some((k) => k.includes("context-mode"));
+                if (hasPlugin) {
+                    return {
+                        check: "MCP registration",
+                        status: "pass",
+                        message: "context-mode found in .vscode/mcp.json",
+                    };
+                }
+            }
+            return {
+                check: "MCP registration",
+                status: "fail",
+                message: "context-mode not found in .vscode/mcp.json",
+                fix: "Add context-mode server to .vscode/mcp.json",
+            };
+        }
+        catch {
+            return {
+                check: "MCP registration",
+                status: "warn",
+                message: "Could not read .vscode/mcp.json",
+            };
+        }
+    }
+    getInstalledVersion() {
+        // Check VS Code extensions for context-mode
+        const extensionDirs = [
+            join(homedir(), ".vscode", "extensions"),
+            join(homedir(), ".vscode-insiders", "extensions"),
+        ];
+        for (const extDir of extensionDirs) {
+            try {
+                const entries = readFileSync(join(extDir, "extensions.json"), "utf-8");
+                const exts = JSON.parse(entries);
+                const contextMode = exts.find((e) => typeof e.identifier === "object" &&
+                    e.identifier !== null &&
+                    e.identifier.id?.toString().includes("context-mode"));
+                if (contextMode && typeof contextMode.version === "string") {
+                    return contextMode.version;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return "not installed";
+    }
+}

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

@@ -0,0 +1,40 @@
+/**
+ * adapters/zed — Zed editor platform adapter.
+ *
+ * Implements HookAdapter for Zed's MCP-only paradigm.
+ *
+ * Zed hook specifics:
+ *   - NO hook support — Zed is an editor, not a CLI with hook pipelines
+ *   - Config: ~/.config/zed/settings.json (JSON format)
+ *   - MCP: full support via context_servers section in settings.json
+ *   - All capabilities are false — MCP is the only integration path
+ *   - Session dir: ~/.config/zed/context-mode/sessions/
+ */
+import { BaseAdapter } from "../base.js";
+import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration } from "../types.js";
+export declare class ZedAdapter extends BaseAdapter implements HookAdapter {
+    constructor();
+    readonly name = "Zed";
+    readonly paradigm: HookParadigm;
+    readonly capabilities: PlatformCapabilities;
+    parsePreToolUseInput(_raw: unknown): PreToolUseEvent;
+    parsePostToolUseInput(_raw: unknown): PostToolUseEvent;
+    parsePreCompactInput(_raw: unknown): PreCompactEvent;
+    parseSessionStartInput(_raw: unknown): SessionStartEvent;
+    formatPreToolUseResponse(_response: PreToolUseResponse): unknown;
+    formatPostToolUseResponse(_response: PostToolUseResponse): unknown;
+    formatPreCompactResponse(_response: PreCompactResponse): unknown;
+    formatSessionStartResponse(_response: SessionStartResponse): unknown;
+    getSettingsPath(): string;
+    getInstructionFiles(): string[];
+    generateHookConfig(_pluginRoot: string): HookRegistration;
+    readSettings(): Record<string, unknown> | null;
+    writeSettings(settings: Record<string, unknown>): void;
+    validateHooks(_pluginRoot: string): DiagnosticResult[];
+    checkPluginRegistration(): DiagnosticResult;
+    getInstalledVersion(): string;
+    configureAllHooks(_pluginRoot: string): string[];
+    setHookPermissions(_pluginRoot: string): string[];
+    updatePluginRegistry(_pluginRoot: string, _version: string): void;
+    getRoutingInstructions(): string;
+}