context-mode 1.0.168 → 2.0.0-next.5

package/build/adapters/zed/index.js

@@ -1,163 +0,0 @@
-/**
- * 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 { readFileSync, writeFileSync, mkdirSync, } from "node:fs";
-import { resolve, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-import { homedir } from "node:os";
-import { BaseAdapter } from "../base.js";
-// ─────────────────────────────────────────────────────────
-// Adapter implementation
-// ─────────────────────────────────────────────────────────
-export class ZedAdapter extends BaseAdapter {
-    constructor() {
-        super([".config", "zed"]);
-    }
-    name = "Zed";
-    paradigm = "mcp-only";
-    capabilities = {
-        preToolUse: false,
-        postToolUse: false,
-        preCompact: false,
-        sessionStart: false,
-        canModifyArgs: false,
-        canModifyOutput: false,
-        canInjectSessionContext: false,
-    };
-    // ── Input parsing ──────────────────────────────────────
-    // Zed does not support hooks. These methods exist to satisfy the
-    // interface contract but will throw if called.
-    parsePreToolUseInput(_raw) {
-        throw new Error("Zed does not support hooks");
-    }
-    parsePostToolUseInput(_raw) {
-        throw new Error("Zed does not support hooks");
-    }
-    parsePreCompactInput(_raw) {
-        throw new Error("Zed does not support hooks");
-    }
-    parseSessionStartInput(_raw) {
-        throw new Error("Zed does not support hooks");
-    }
-    // ── Response formatting ────────────────────────────────
-    // Zed does not support hooks. Return undefined for all responses.
-    formatPreToolUseResponse(_response) {
-        return undefined;
-    }
-    formatPostToolUseResponse(_response) {
-        return undefined;
-    }
-    formatPreCompactResponse(_response) {
-        return undefined;
-    }
-    formatSessionStartResponse(_response) {
-        return undefined;
-    }
-    // ── Configuration ──────────────────────────────────────
-    getSettingsPath() {
-        return resolve(homedir(), ".config", "zed", "settings.json");
-    }
-    getInstructionFiles() {
-        return ["AGENTS.md"];
-    }
-    generateHookConfig(_pluginRoot) {
-        // Zed does not support hooks — return empty registration
-        return {};
-    }
-    readSettings() {
-        try {
-            const raw = readFileSync(this.getSettingsPath(), "utf-8");
-            return JSON.parse(raw);
-        }
-        catch {
-            return null;
-        }
-    }
-    writeSettings(settings) {
-        const settingsPath = this.getSettingsPath();
-        mkdirSync(dirname(settingsPath), { recursive: true });
-        writeFileSync(settingsPath, JSON.stringify(settings, null, 2), "utf-8");
-    }
-    // ── Diagnostics (doctor) ─────────────────────────────────
-    validateHooks(_pluginRoot) {
-        return [
-            {
-                check: "Hook support",
-                status: "warn",
-                message: "Zed does not support hooks. Only MCP integration is available.",
-            },
-        ];
-    }
-    checkPluginRegistration() {
-        // Check for context-mode in context_servers section of settings.json
-        try {
-            const raw = readFileSync(this.getSettingsPath(), "utf-8");
-            const settings = JSON.parse(raw);
-            const hasContextServers = settings.context_servers !== undefined;
-            const hasContextMode = raw.includes("context-mode");
-            if (hasContextServers && hasContextMode) {
-                return {
-                    check: "MCP registration",
-                    status: "pass",
-                    message: "context-mode found in context_servers config",
-                };
-            }
-            if (hasContextServers) {
-                return {
-                    check: "MCP registration",
-                    status: "fail",
-                    message: "context_servers section exists but context-mode not found",
-                    fix: 'Add context-mode to context_servers in ~/.config/zed/settings.json',
-                };
-            }
-            return {
-                check: "MCP registration",
-                status: "fail",
-                message: "No context_servers section in settings.json",
-                fix: 'Add context_servers.context-mode to ~/.config/zed/settings.json',
-            };
-        }
-        catch {
-            return {
-                check: "MCP registration",
-                status: "warn",
-                message: "Could not read ~/.config/zed/settings.json",
-            };
-        }
-    }
-    getInstalledVersion() {
-        // Zed has no marketplace or plugin system for context-mode
-        return "not installed";
-    }
-    // ── Upgrade ────────────────────────────────────────────
-    configureAllHooks(_pluginRoot) {
-        // Zed does not support hooks — nothing to configure
-        return [];
-    }
-    setHookPermissions(_pluginRoot) {
-        // No hook scripts for Zed
-        return [];
-    }
-    updatePluginRegistry(_pluginRoot, _version) {
-        // Zed has no plugin registry
-    }
-    getRoutingInstructions() {
-        const instructionsPath = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "..", "configs", "zed", "AGENTS.md");
-        try {
-            return readFileSync(instructionsPath, "utf-8");
-        }
-        catch {
-            // Fallback inline instructions
-            return "# context-mode\n\nUse context-mode MCP tools (execute, execute_file, batch_execute, fetch_and_index, search) instead of bash/cat/curl for data-heavy operations.";
-        }
-    }
-}

package/build/cache-heal.d.ts

@@ -1,48 +0,0 @@
-/**
- * Plugin cache self-heal — fixes broken CLAUDE_PLUGIN_ROOT references.
- *
- * Claude Code's plugin auto-update can leave installed_plugins.json pointing
- * to a non-existent directory (anthropics/claude-code#46915). This module
- * detects and repairs the mismatch by creating symlinks.
- *
- * 4-layer defense:
- *   1. start.mjs startup — reverse heal (registry → symlink to us)
- *   2. server.ts first tool call — mid-session heal
- *   3. postinstall.mjs — backward symlink on new install
- *   4. global hook auto-deploy — survives total plugin cache breakage
- */
-export interface HealResult {
-    healed: boolean;
-    action?: "symlink" | "global-hook" | "none";
-    from?: string;
-    to?: string;
-}
-/**
- * Core heal: if installed_plugins.json points to a non-existent directory,
- * create a symlink from that path to our actual directory.
- *
- * @param currentDir - The directory we're actually running from
- * @param installedPluginsPath - Path to installed_plugins.json (injectable for testing)
- */
-export declare function healRegistryMismatch(currentDir: string, installedPluginsPath?: string): HealResult;
-/**
- * Deploy a global SessionStart hook that heals plugin cache mismatches.
- * This hook lives outside the plugin directory, so it survives cache breakage.
- *
- * Written to ~/.claude/hooks/context-mode-cache-heal.sh
- */
-export declare function deployGlobalHealHook(): HealResult;
-/**
- * Backward symlink: during postinstall, if the registry points to a
- * non-existent OLD path, create a symlink from old → new (our directory).
- * Same as healRegistryMismatch but called from postinstall context.
- */
-export { healRegistryMismatch as healBackwardCompat };
-/**
- * Mid-session heal — call on first MCP tool invocation.
- * Checks if registry path differs from our running directory.
- * Creates symlink if needed. Runs only once per process.
- */
-export declare function healMidSession(currentDir: string): HealResult;
-/** Reset mid-session flag (for testing only) */
-export declare function _resetMidSession(): void;

package/build/cache-heal.js

@@ -1,150 +0,0 @@
-/**
- * Plugin cache self-heal — fixes broken CLAUDE_PLUGIN_ROOT references.
- *
- * Claude Code's plugin auto-update can leave installed_plugins.json pointing
- * to a non-existent directory (anthropics/claude-code#46915). This module
- * detects and repairs the mismatch by creating symlinks.
- *
- * 4-layer defense:
- *   1. start.mjs startup — reverse heal (registry → symlink to us)
- *   2. server.ts first tool call — mid-session heal
- *   3. postinstall.mjs — backward symlink on new install
- *   4. global hook auto-deploy — survives total plugin cache breakage
- */
-import { existsSync, readFileSync, symlinkSync, mkdirSync, writeFileSync } from "node:fs";
-import { resolve, dirname } from "node:path";
-import { homedir } from "node:os";
-/**
- * Core heal: if installed_plugins.json points to a non-existent directory,
- * create a symlink from that path to our actual directory.
- *
- * @param currentDir - The directory we're actually running from
- * @param installedPluginsPath - Path to installed_plugins.json (injectable for testing)
- */
-export function healRegistryMismatch(currentDir, installedPluginsPath) {
-    const ipPath = installedPluginsPath ?? resolve(homedir(), ".claude", "plugins", "installed_plugins.json");
-    if (!existsSync(ipPath))
-        return { healed: false, action: "none" };
-    if (!existsSync(currentDir))
-        return { healed: false, action: "none" };
-    let ip;
-    try {
-        ip = JSON.parse(readFileSync(ipPath, "utf-8"));
-    }
-    catch {
-        return { healed: false, action: "none" };
-    }
-    for (const [key, entries] of Object.entries(ip.plugins ?? {})) {
-        if (!key.toLowerCase().includes("context-mode"))
-            continue;
-        for (const entry of entries) {
-            const registryPath = entry.installPath;
-            if (!registryPath)
-                continue;
-            // Registry path exists — no healing needed
-            if (existsSync(registryPath))
-                continue;
-            // Registry path doesn't exist — create symlink to our directory
-            try {
-                const parent = dirname(registryPath);
-                if (!existsSync(parent))
-                    mkdirSync(parent, { recursive: true });
-                if (process.platform === "win32") {
-                    // Windows: use junction (no admin required)
-                    symlinkSync(currentDir, registryPath, "junction");
-                }
-                else {
-                    symlinkSync(currentDir, registryPath);
-                }
-                return { healed: true, action: "symlink", from: registryPath, to: currentDir };
-            }
-            catch {
-                return { healed: false, action: "none" };
-            }
-        }
-    }
-    return { healed: false, action: "none" };
-}
-/**
- * Deploy a global SessionStart hook that heals plugin cache mismatches.
- * This hook lives outside the plugin directory, so it survives cache breakage.
- *
- * Written to ~/.claude/hooks/context-mode-cache-heal.sh
- */
-export function deployGlobalHealHook() {
-    const hooksDir = resolve(homedir(), ".claude", "hooks");
-    const hookPath = resolve(hooksDir, "context-mode-cache-heal.sh");
-    // Already deployed
-    if (existsSync(hookPath))
-        return { healed: false, action: "none" };
-    try {
-        if (!existsSync(hooksDir))
-            mkdirSync(hooksDir, { recursive: true });
-        const script = `#!/usr/bin/env bash
-# context-mode plugin cache self-heal — auto-deployed by context-mode MCP server
-# Fixes anthropics/claude-code#46915: auto-update breaks CLAUDE_PLUGIN_ROOT
-# This hook runs at SessionStart (global, not plugin-level) so it works even
-# when the plugin cache is broken.
-
-set -euo pipefail
-
-PLUGINS_FILE="$HOME/.claude/plugins/installed_plugins.json"
-[[ -f "$PLUGINS_FILE" ]] || exit 0
-
-# Find context-mode entries and heal missing directories
-node -e '
-const fs = require("fs");
-const path = require("path");
-try {
-  const ip = JSON.parse(fs.readFileSync(process.argv[1], "utf-8"));
-  for (const [key, entries] of Object.entries(ip.plugins || {})) {
-    if (!key.toLowerCase().includes("context-mode")) continue;
-    for (const entry of entries) {
-      const p = entry.installPath;
-      if (!p || fs.existsSync(p)) continue;
-      const parent = path.dirname(p);
-      if (!fs.existsSync(parent)) continue;
-      const dirs = fs.readdirSync(parent).filter(d => /^\\d+\\.\\d+/.test(d) && fs.statSync(path.join(parent, d)).isDirectory());
-      if (dirs.length === 0) continue;
-      dirs.sort((a, b) => {
-        const pa = a.split(".").map(Number), pb = b.split(".").map(Number);
-        for (let i = 0; i < 3; i++) { if ((pa[i]||0) !== (pb[i]||0)) return (pa[i]||0) - (pb[i]||0); }
-        return 0;
-      });
-      const target = path.join(parent, dirs[dirs.length - 1]);
-      try { fs.symlinkSync(target, p); } catch {}
-    }
-  }
-} catch {}
-' "$PLUGINS_FILE" 2>/dev/null || true
-`;
-        writeFileSync(hookPath, script, { mode: 0o755 });
-        return { healed: true, action: "global-hook", from: hookPath };
-    }
-    catch {
-        return { healed: false, action: "none" };
-    }
-}
-/**
- * Backward symlink: during postinstall, if the registry points to a
- * non-existent OLD path, create a symlink from old → new (our directory).
- * Same as healRegistryMismatch but called from postinstall context.
- */
-export { healRegistryMismatch as healBackwardCompat };
-/** One-shot flag for mid-session heal in server.ts */
-let _midSessionHealed = false;
-/**
- * Mid-session heal — call on first MCP tool invocation.
- * Checks if registry path differs from our running directory.
- * Creates symlink if needed. Runs only once per process.
- */
-export function healMidSession(currentDir) {
-    if (_midSessionHealed)
-        return { healed: false, action: "none" };
-    _midSessionHealed = true;
-    return healRegistryMismatch(currentDir);
-}
-/** Reset mid-session flag (for testing only) */
-export function _resetMidSession() {
-    _midSessionHealed = false;
-}

package/build/cli.d.ts

@@ -1,34 +0,0 @@
-#!/usr/bin/env node
-/**
- * context-mode CLI
- *
- * Usage:
- *   context-mode                              → Start MCP server (stdio)
- *   context-mode doctor                       → Diagnose runtime issues, hooks, FTS5, version
- *   context-mode upgrade                      → Fix hooks, permissions, and settings
- *   context-mode hook <platform> <event>      → Dispatch a hook script (used by platform hook configs)
- *   CONTEXT_MODE_DIR=/abs/path context-mode   → Override sessions/content storage root
- *     Empty/whitespace is ignored; non-empty values must be absolute.
- *
- * Platform auto-detection: CLI detects which platform is running
- * (Claude Code, Gemini CLI, OpenCode, etc.) and uses the appropriate adapter.
- */
-/** Normalize Windows backslash paths to forward slashes for Bash (MSYS2) compatibility. */
-export declare function toUnixPath(p: string): string;
-export declare function npmExecFile(args: string[], opts?: Record<string, unknown>): void;
-export declare function npmExec(command: string, opts?: Record<string, unknown>): void;
-/**
- * Open a URL in the user's default browser without invoking a shell.
- *
- * Uses `execFile` with an arg array so the URL cannot be interpreted as
- * shell metacharacters.  Original code used `execSync(`open "${url}"`)`
- * which would shell-interpolate the URL — fragile if the URL ever
- * becomes attacker-controlled (remote, weak port-validation, etc).
- *
- * Best-effort: if the OS opener is missing the function logs a copyable
- * URL hint and returns; it never throws.  `runner` is injectable for
- * tests; default is `child_process.execFile` (callback form, fire-and-
- * forget).
- */
-export type ExecFileFn = (file: string, args: readonly string[], opts?: Record<string, unknown>) => unknown;
-export declare function openInBrowser(url: string, platform?: NodeJS.Platform, runner?: ExecFileFn): void;