@mxalbert/context-mode 2.0.0

package/build/adapters/zed/index.js

@@ -0,0 +1,163 @@
+/**
+ * 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/cli.d.ts

@@ -0,0 +1,34 @@
+#!/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;