xtctx 0.3.2 → 0.11.1

package/dist/src/config/mcp-config.js

@@ -0,0 +1,462 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { parse as parseToml, stringify as stringifyToml } from "@iarna/toml";
+import { errorMessage } from "../utils/errors.js";
+/**
+ * Tools with native MCP configuration support.
+ *
+ * Tools NOT listed here receive MCP connection details embedded in their
+ * managed-block instructions file via `renderMcpServersMarkdown`.
+ */
+const NATIVE_MCP_TOOLS = {
+    // Claude Code — `.mcp.json` at project root, `mcpServers` key, stdio entries.
+    // Keep both aliases because older local setup files may refer to `claude`,
+    // while the current scraper/tool id is `claude-code`.
+    claude: {
+        projectPath: (root) => join(root, ".mcp.json"),
+    },
+    "claude-code": {
+        projectPath: (root) => join(root, ".mcp.json"),
+    },
+    // Cursor — `.cursor/mcp.json` at project root, same JSON shape.
+    cursor: {
+        projectPath: (root) => join(root, ".cursor", "mcp.json"),
+    },
+    // VS Code GitHub Copilot — `.vscode/mcp.json`. Note: the root key is
+    // `servers`, not `mcpServers` (per VS Code's MCP configuration reference).
+    copilot: {
+        projectPath: (root) => join(root, ".vscode", "mcp.json"),
+        rootKey: "servers",
+    },
+    // Codex CLI — TOML at `.codex/config.toml` (project) or `~/.codex/config.toml`
+    // (global). Server entries live under `[mcp_servers.<name>]` tables. Codex's
+    // TOML format uses `command` + `args` + `env` and does NOT include a `type`
+    // field (stdio is implicit).
+    codex: {
+        format: "toml",
+        projectPath: (root) => join(root, ".codex", "config.toml"),
+        globalPath: (home) => join(home, ".codex", "config.toml"),
+        rootKey: "mcp_servers",
+        buildEntry: buildCodexEntry,
+    },
+    // Google Antigravity — JSON at `~/.gemini/antigravity/mcp_config.json`.
+    // App-level config under the Gemini state directory; entries omit `type`.
+    antigravity: {
+        globalPath: (home) => join(home, ".gemini", "antigravity", "mcp_config.json"),
+        buildEntry: buildAntigravityEntry,
+    },
+    // opencode (sst/opencode-ai) — JSON at `opencode.json` (project) or
+    // `~/.config/opencode/opencode.json` (global). Top-level `mcp` key. Entries
+    // use `type: "local" | "remote"`, `command` as a combined ARRAY of
+    // strings (executable + args together), `enabled: true`, and `environment`
+    // (not `env`) for env vars on local servers. Remote uses `url` + `headers`.
+    opencode: {
+        projectPath: (root) => join(root, "opencode.json"),
+        globalPath: (home) => join(home, ".config", "opencode", "opencode.json"),
+        rootKey: "mcp",
+        buildEntry: buildOpencodeEntry,
+    },
+    // GitHub Copilot CLI (the standalone `~/.copilot/`-rooted CLI, distinct
+    // from VS Code Copilot) — JSON at `~/.copilot/mcp-config.json`. User-level
+    // only; project-level MCP for Copilot CLI lives in `.mcp.json` at the
+    // project root, which is already written by the `claude` / `claude-code`
+    // renderers above (one file, two consumers).
+    "copilot-cli": {
+        globalPath: (home) => join(home, ".copilot", "mcp-config.json"),
+        buildEntry: buildCopilotCliEntry,
+    },
+};
+export function hasNativeMcpSupport(tool) {
+    return tool in NATIVE_MCP_TOOLS;
+}
+export function isGlobalOnlyMcpTool(tool) {
+    const renderer = NATIVE_MCP_TOOLS[tool];
+    return Boolean(renderer?.globalPath && !renderer.projectPath);
+}
+/**
+ * Sync MCP server configs into native formats for tools that support them.
+ *
+ * For each enabled tool with a renderer:
+ *  - Prefer the project-scoped path if the renderer provides one
+ *  - Fall back to the user-scoped path if project is unset (Copilot CLI)
+ *  - Skip duplicate writes when two renderer aliases resolve to the same
+ *    file path (claude + claude-code both write `.mcp.json`)
+ */
+export async function syncToolMcpConfigs(projectRoot, servers, enabledTools, options = {}) {
+    if (servers.length === 0) {
+        return { results: [], servers_loaded: 0 };
+    }
+    const home = options.homeDir ?? homedir();
+    const results = [];
+    const writtenPaths = new Set();
+    for (const tool of enabledTools) {
+        const renderer = NATIVE_MCP_TOOLS[tool];
+        if (!renderer)
+            continue;
+        // Choose path: project preferred, fall back to global. Tools without
+        // a project path (Copilot CLI) write to global only.
+        let configPath = null;
+        let scope = "project";
+        if (renderer.projectPath) {
+            configPath = renderer.projectPath(projectRoot);
+            scope = "project";
+        }
+        else if (renderer.globalPath) {
+            configPath = renderer.globalPath(home);
+            scope = "global";
+        }
+        if (!configPath)
+            continue;
+        if (writtenPaths.has(configPath)) {
+            results.push({
+                tool,
+                path: configPath,
+                scope,
+                updated: false,
+                created: false,
+                skipped: true,
+            });
+            continue;
+        }
+        writtenPaths.add(configPath);
+        const result = await writeMcpConfig(tool, configPath, scope, renderer, servers);
+        results.push(result);
+    }
+    return { results, servers_loaded: servers.length };
+}
+export async function removeMcpServerConfigs(projectRoot, serverName, tools, options = {}) {
+    const home = options.homeDir ?? homedir();
+    const results = [];
+    const writtenPaths = new Set();
+    for (const tool of tools) {
+        const renderer = NATIVE_MCP_TOOLS[tool];
+        if (!renderer)
+            continue;
+        const target = resolveConfigTarget(projectRoot, home, renderer);
+        if (!target)
+            continue;
+        if (writtenPaths.has(target.path)) {
+            results.push({
+                tool,
+                path: target.path,
+                scope: target.scope,
+                removed: false,
+                skipped: true,
+            });
+            continue;
+        }
+        writtenPaths.add(target.path);
+        results.push(await removeMcpConfig(tool, target.path, target.scope, renderer, serverName));
+    }
+    return { results };
+}
+// ---------------------------------------------------------------------------
+// Generic writer + merge
+// ---------------------------------------------------------------------------
+async function writeMcpConfig(tool, configPath, scope, renderer, servers) {
+    try {
+        const format = renderer.format ?? "json";
+        const rootKey = renderer.rootKey ?? "mcpServers";
+        const buildEntry = renderer.buildEntry ?? defaultBuildEntry;
+        let existingContent = null;
+        try {
+            existingContent = await readFile(configPath, "utf-8");
+        }
+        catch (error) {
+            if (!isMissingFile(error)) {
+                return failedMcpSync(tool, configPath, scope, `Failed to read existing MCP config: ${errorMessage(error)}`);
+            }
+        }
+        let existing = null;
+        if (existingContent !== null) {
+            try {
+                existing = parseConfig(existingContent, format);
+            }
+            catch (error) {
+                return failedMcpSync(tool, configPath, scope, `Failed to parse existing MCP config; leaving it unchanged: ${errorMessage(error)}`);
+            }
+        }
+        const serverEntries = buildServerEntries(servers, buildEntry);
+        const merged = mergeUnderRootKey(existing, rootKey, serverEntries);
+        const content = serializeConfig(merged, format);
+        if (existingContent !== null && normalizeNewlines(existingContent) === normalizeNewlines(content)) {
+            return {
+                tool,
+                path: configPath,
+                scope,
+                updated: false,
+                created: false,
+                skipped: true,
+            };
+        }
+        await mkdir(dirname(configPath), { recursive: true });
+        await writeFile(configPath, content, "utf-8");
+        return {
+            tool,
+            path: configPath,
+            scope,
+            updated: existing !== null,
+            created: existing === null,
+            skipped: false,
+        };
+    }
+    catch (error) {
+        return failedMcpSync(tool, configPath, scope, `Failed to write MCP config: ${errorMessage(error)}`);
+    }
+}
+function parseConfig(raw, format) {
+    if (format === "toml") {
+        return parseToml(raw);
+    }
+    return JSON.parse(raw);
+}
+function serializeConfig(value, format) {
+    if (format === "toml") {
+        // @iarna/toml emits a final newline already; normalise to single trailing.
+        return stringifyToml(value).replace(/\n*$/, "\n");
+    }
+    return JSON.stringify(value, null, 2) + "\n";
+}
+function buildServerEntries(servers, buildEntry) {
+    const result = {};
+    for (const server of servers) {
+        result[server.name] = buildEntry(server);
+    }
+    return result;
+}
+function mergeUnderRootKey(existing, rootKey, serverEntries) {
+    if (!existing) {
+        return { [rootKey]: serverEntries };
+    }
+    const existingEntries = isRecord(existing[rootKey]) ? existing[rootKey] : {};
+    return {
+        ...existing,
+        [rootKey]: { ...existingEntries, ...serverEntries },
+    };
+}
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function isMissingFile(error) {
+    return Boolean(error && typeof error === "object" && error.code === "ENOENT");
+}
+function failedMcpSync(tool, configPath, scope, warning) {
+    return {
+        tool,
+        path: configPath,
+        scope,
+        updated: false,
+        created: false,
+        skipped: false,
+        warning,
+    };
+}
+// ---------------------------------------------------------------------------
+// Per-tool entry builders
+// ---------------------------------------------------------------------------
+/**
+ * Default Claude-Code-style entry shape.
+ *
+ *  { type: "stdio" | "sse" | "streamable-http", command, args, env, url }
+ *
+ * Used by Claude Code, Cursor, and (with rootKey override) VS Code Copilot.
+ */
+function defaultBuildEntry(server) {
+    const entry = {};
+    if (server.transport === "sse" || server.transport === "streamable-http") {
+        entry.type = server.transport;
+        if (server.url)
+            entry.url = server.url;
+    }
+    else {
+        entry.type = "stdio";
+        entry.command = server.command;
+        if (server.args?.length)
+            entry.args = server.args;
+    }
+    if (server.env && Object.keys(server.env).length > 0) {
+        entry.env = { ...server.env };
+    }
+    return entry;
+}
+/**
+ * Codex TOML entry. No `type` field (stdio is implicit). Renders as:
+ *
+ *   [mcp_servers.xtctx]
+ *   command = "npx"
+ *   args = ["-y", "xtctx"]
+ */
+function buildCodexEntry(server) {
+    const entry = {};
+    if (server.transport === "sse" || server.transport === "streamable-http") {
+        if (server.url)
+            entry.url = server.url;
+    }
+    else {
+        entry.command = server.command;
+        if (server.args?.length)
+            entry.args = server.args;
+    }
+    if (server.env && Object.keys(server.env).length > 0) {
+        entry.env = { ...server.env };
+    }
+    return entry;
+}
+/**
+ * Antigravity MCP entry shape. Same as Codex (no `type` field) but JSON.
+ *
+ *   "mcpServers": {
+ *     "xtctx": { "command": "npx", "args": [...] }
+ *   }
+ */
+function buildAntigravityEntry(server) {
+    return buildCodexEntry(server);
+}
+/**
+ * opencode entry shape (sst/opencode-ai).
+ *
+ *   "mcp": {
+ *     "xtctx": {
+ *       "type": "local",
+ *       "command": ["npx", "-y", "xtctx"],
+ *       "enabled": true
+ *     }
+ *   }
+ *
+ * Note that opencode's `command` is a combined array (executable + args),
+ * env vars use the key `environment`, and remote servers use `type: "remote"`
+ * + `url` + optional `headers`.
+ */
+function buildOpencodeEntry(server) {
+    if (server.transport === "sse" || server.transport === "streamable-http") {
+        const remote = {
+            type: "remote",
+            url: server.url ?? "",
+            enabled: true,
+        };
+        if (server.env && Object.keys(server.env).length > 0) {
+            remote.headers = { ...server.env };
+        }
+        return remote;
+    }
+    const command = [server.command, ...(server.args ?? [])];
+    const local = {
+        type: "local",
+        command,
+        enabled: true,
+    };
+    if (server.env && Object.keys(server.env).length > 0) {
+        local.environment = { ...server.env };
+    }
+    return local;
+}
+/**
+ * GitHub Copilot CLI entry shape (`~/.copilot/mcp-config.json`).
+ *
+ *   "mcpServers": {
+ *     "xtctx": {
+ *       "type": "local",
+ *       "command": "npx",
+ *       "args": ["-y", "xtctx"],
+ *       "tools": ["*"]
+ *     }
+ *   }
+ *
+ * Copilot CLI uses `type: "local" | "http"` and a `tools` allowlist
+ * (`["*"]` = allow all tools the server exposes). The defaults grant
+ * full access; tighten by editing the file post-sync if needed.
+ */
+function buildCopilotCliEntry(server) {
+    if (server.transport === "sse" || server.transport === "streamable-http") {
+        const http = {
+            type: "http",
+            url: server.url ?? "",
+            tools: ["*"],
+        };
+        if (server.env && Object.keys(server.env).length > 0) {
+            http.env = { ...server.env };
+        }
+        return http;
+    }
+    const local = {
+        type: "local",
+        command: server.command,
+        args: server.args ?? [],
+        tools: ["*"],
+    };
+    if (server.env && Object.keys(server.env).length > 0) {
+        local.env = { ...server.env };
+    }
+    return local;
+}
+// ---------------------------------------------------------------------------
+// Misc helpers
+// ---------------------------------------------------------------------------
+function normalizeNewlines(input) {
+    return input.replace(/\r\n/g, "\n");
+}
+async function removeMcpConfig(tool, configPath, scope, renderer, serverName) {
+    try {
+        const format = renderer.format ?? "json";
+        const rootKey = renderer.rootKey ?? "mcpServers";
+        let existingContent;
+        try {
+            existingContent = await readFile(configPath, "utf-8");
+        }
+        catch {
+            return {
+                tool,
+                path: configPath,
+                scope,
+                removed: false,
+                skipped: true,
+            };
+        }
+        const existing = parseConfig(existingContent, format);
+        const existingEntries = isRecord(existing[rootKey]) ? { ...existing[rootKey] } : {};
+        if (!(serverName in existingEntries)) {
+            return {
+                tool,
+                path: configPath,
+                scope,
+                removed: false,
+                skipped: true,
+            };
+        }
+        delete existingEntries[serverName];
+        const updated = { ...existing, [rootKey]: existingEntries };
+        const content = serializeConfig(updated, format);
+        if (normalizeNewlines(existingContent) !== normalizeNewlines(content)) {
+            await mkdir(dirname(configPath), { recursive: true });
+            await writeFile(configPath, content, "utf-8");
+        }
+        return {
+            tool,
+            path: configPath,
+            scope,
+            removed: true,
+            skipped: false,
+        };
+    }
+    catch (error) {
+        return {
+            tool,
+            path: configPath,
+            scope,
+            removed: false,
+            skipped: false,
+            warning: `Failed to remove MCP config: ${errorMessage(error)}`,
+        };
+    }
+}
+function resolveConfigTarget(projectRoot, home, renderer) {
+    if (renderer.projectPath) {
+        return { path: renderer.projectPath(projectRoot), scope: "project" };
+    }
+    if (renderer.globalPath) {
+        return { path: renderer.globalPath(home), scope: "global" };
+    }
+    return null;
+}
+//# sourceMappingURL=mcp-config.js.map

package/dist/src/config/mcp-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.js","sourceRoot":"","sources":["../../../src/config/mcp-config.ts"],"names":[],"mappings":"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"}

package/dist/src/config/setup.d.ts

@@ -0,0 +1,37 @@
+import { type McpServerDefinition } from "./mcp-config.js";
+export interface SetupOptions {
+    projectPath?: string;
+    yes?: boolean;
+    repair?: boolean;
+    homeDir?: string;
+    selectedSkillIds?: string[];
+    includeGlobalMcp?: boolean;
+}
+export interface SetupResult {
+    projectRoot: string;
+    configPath: string;
+    writes: Array<{
+        path: string;
+        kind: string;
+        changed: boolean;
+    }>;
+    warnings: string[];
+}
+export interface PlannedSetupWrite {
+    path: string;
+    kind: string;
+}
+export declare function runSetup(options?: SetupOptions): Promise<SetupResult>;
+export declare function setupProject(options?: SetupOptions): Promise<SetupResult>;
+export declare function describeSetupPlan(projectPath?: string, selectedSkillIds?: string[], includeGlobalMcp?: boolean): {
+    projectRoot: string;
+    writes: PlannedSetupWrite[];
+};
+export declare function inspectManagedFile(filePath: string): Promise<{
+    exists: boolean;
+    blockCount: number;
+    staleReferences: string[];
+}>;
+export declare function xtctxServerDefinition(): McpServerDefinition;
+export declare function pathExists(filePath: string): Promise<boolean>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/src/config/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/config/setup.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAC;AAczB,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAChE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AASD,wBAAsB,QAAQ,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAI/E;AAED,wBAAsB,YAAY,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAwEnF;AAED,wBAAgB,iBAAiB,CAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,gBAAgB,GAAE,MAAM,EAAsB,EAC9C,gBAAgB,UAAQ,GACvB;IACD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B,CAyCA;AAkBD,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAClE,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,CAAC,CAWD;AAED,wBAAgB,qBAAqB,IAAI,mBAAmB,CAO3D;AAmOD,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE"}