cgraphx 1.4.3 → 2.0.0

package/dist/installer/targets/codex.js

@@ -1,185 +0,0 @@
-"use strict";
-/**
- * OpenAI Codex CLI target.
- *
- *   - MCP server entry to `~/.codex/config.toml` as the dotted-key
- *     table `[mcp_servers.cgraphx]`. TOML — not JSON — handled by
- *     the narrow serializer in `./toml.ts`.
- *   - Instructions to `~/.codex/AGENTS.md`.
- *
- * Codex CLI as of 2026-05 has no project-local config concept —
- * everything lives under `~/.codex/`. `supportsLocation('local')`
- * returns false; the orchestrator skips Codex when the user picks
- * the local install location.
- *
- * No permissions concept.
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.codexTarget = void 0;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const os = __importStar(require("os"));
-const shared_1 = require("./shared");
-const instructions_template_1 = require("../instructions-template");
-const toml_1 = require("./toml");
-const TOML_HEADER = 'mcp_servers.cgraphx';
-function configDir() {
-    return path.join(os.homedir(), '.codex');
-}
-function tomlConfigPath() {
-    return path.join(configDir(), 'config.toml');
-}
-function instructionsPath() {
-    return path.join(configDir(), 'AGENTS.md');
-}
-class CodexTarget {
-    id = 'codex';
-    displayName = 'Codex CLI';
-    docsUrl = 'https://github.com/openai/codex';
-    supportsLocation(loc) {
-        return loc === 'global';
-    }
-    detect(loc) {
-        if (loc !== 'global') {
-            return { installed: false, alreadyConfigured: false };
-        }
-        const tomlPath = tomlConfigPath();
-        let alreadyConfigured = false;
-        if (fs.existsSync(tomlPath)) {
-            try {
-                const content = fs.readFileSync(tomlPath, 'utf-8');
-                alreadyConfigured = content.includes(`[${TOML_HEADER}]`);
-            }
-            catch { /* ignore */ }
-        }
-        const installed = fs.existsSync(configDir());
-        return { installed, alreadyConfigured, configPath: tomlPath };
-    }
-    install(loc, _opts) {
-        if (loc !== 'global') {
-            return {
-                files: [],
-                notes: ['Codex CLI has no project-local config — re-run with --location=global to install.'],
-            };
-        }
-        const files = [];
-        files.push(writeMcpEntry());
-        // AGENTS.md gets the short marker-fenced CodeGraph block (#704):
-        // subagents and non-MCP harnesses read AGENTS.md but never the MCP
-        // initialize instructions. Upsert self-heals a stale pre-#529 block.
-        files.push((0, shared_1.upsertInstructionsEntry)(instructionsPath()));
-        return { files };
-    }
-    uninstall(loc) {
-        if (loc !== 'global')
-            return { files: [] };
-        const files = [];
-        const tomlPath = tomlConfigPath();
-        if (fs.existsSync(tomlPath)) {
-            const content = fs.readFileSync(tomlPath, 'utf-8');
-            const { content: nextContent, action } = (0, toml_1.removeTomlTable)(content, TOML_HEADER);
-            if (action === 'removed') {
-                if (nextContent.trim() === '') {
-                    try {
-                        fs.unlinkSync(tomlPath);
-                    }
-                    catch { /* ignore */ }
-                }
-                else {
-                    (0, shared_1.atomicWriteFileSync)(tomlPath, nextContent.trimEnd() + '\n');
-                }
-                files.push({ path: tomlPath, action: 'removed' });
-            }
-            else {
-                files.push({ path: tomlPath, action: 'not-found' });
-            }
-        }
-        else {
-            files.push({ path: tomlPath, action: 'not-found' });
-        }
-        files.push(removeInstructionsEntry());
-        return { files };
-    }
-    printConfig(loc) {
-        if (loc !== 'global') {
-            return '# Codex CLI has no project-local config — use --location=global.\n';
-        }
-        const block = buildCodegraphBlock();
-        return `# Add to ${tomlConfigPath()}\n\n${block}\n`;
-    }
-    describePaths(loc) {
-        if (loc !== 'global')
-            return [];
-        return [tomlConfigPath(), instructionsPath()];
-    }
-}
-function buildCodegraphBlock() {
-    const mcp = (0, shared_1.getMcpServerConfig)();
-    return (0, toml_1.buildTomlTable)(TOML_HEADER, {
-        command: mcp.command,
-        args: mcp.args,
-    });
-}
-function writeMcpEntry() {
-    const file = tomlConfigPath();
-    const dir = path.dirname(file);
-    if (!fs.existsSync(dir))
-        fs.mkdirSync(dir, { recursive: true });
-    const block = buildCodegraphBlock();
-    // Single read — `existing === ''` derives both "is the file empty
-    // or absent" and "what was its content," avoiding a TOCTOU window
-    // between two `fs.existsSync` calls.
-    const existing = fs.existsSync(file) ? fs.readFileSync(file, 'utf-8') : '';
-    const created = existing.length === 0;
-    const { content: nextContent, action } = (0, toml_1.upsertTomlTable)(existing, TOML_HEADER, block);
-    if (action === 'unchanged') {
-        return { path: file, action: 'unchanged' };
-    }
-    (0, shared_1.atomicWriteFileSync)(file, nextContent);
-    return { path: file, action: created ? 'created' : 'updated' };
-}
-/**
- * Strip the marker-delimited CodeGraph block from `~/.codex/AGENTS.md`
- * if a prior install wrote one. Used by both install (self-heal on
- * upgrade) and uninstall — see issue #529.
- */
-function removeInstructionsEntry() {
-    const file = instructionsPath();
-    const action = (0, shared_1.removeMarkedSection)(file, instructions_template_1.CGRAPHX_SECTION_START, instructions_template_1.CGRAPHX_SECTION_END);
-    return { path: file, action };
-}
-exports.codexTarget = new CodexTarget();
-//# sourceMappingURL=codex.js.map

package/dist/installer/targets/codex.js.map

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

package/dist/installer/targets/cursor.d.ts

@@ -1,35 +0,0 @@
-/**
- * Cursor target.
- *
- *   - MCP server entry to `~/.cursor/mcp.json` (global) or
- *     `./.cursor/mcp.json` (local). Same `{mcpServers: {...}}` shape
- *     as Claude.
- *   - Instructions to `./.cursor/rules/cgraphx.mdc` (project-local
- *     ONLY). Cursor's rules system is a project-scoped surface;
- *     global cursor rules aren't a stable convention as of 2026-05.
- *     For `--location=global`, only mcp.json is written.
- *
- * ## Why we hardcode `--path` for Cursor
- *
- * Cursor launches MCP-server subprocesses with a working directory
- * that ISN'T the workspace root AND doesn't pass `rootUri` /
- * `workspaceFolders` in the MCP initialize call. The CodeGraph MCP
- * server's `process.cwd()` fallback therefore misses the workspace's
- * `.cgraphx/` and reports "not initialized" on every tool call.
- *
- * So we inject `--path` into the args ourselves:
- *
- *   - `local`  install: absolute path (we know it at install time).
- *   - `global` install: `${workspaceFolder}` — Cursor expands this to
- *     the open workspace's root, giving us per-workspace behavior
- *     from a single global config.
- *
- * Codex and Claude do not need this — they launch MCP servers with
- * `cwd = workspace` and pass `rootUri`, respectively.
- *
- * No permissions concept — Cursor doesn't have an auto-allow list
- * the installer can populate. `autoAllow` is silently ignored.
- */
-import { AgentTarget } from './types';
-export declare const cursorTarget: AgentTarget;
-//# sourceMappingURL=cursor.d.ts.map

package/dist/installer/targets/cursor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../../src/installer/targets/cursor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAKH,OAAO,EACL,WAAW,EAKZ,MAAM,SAAS,CAAC;AA4MjB,eAAO,MAAM,YAAY,EAAE,WAAgC,CAAC"}

package/dist/installer/targets/cursor.js

@@ -1,254 +0,0 @@
-"use strict";
-/**
- * Cursor target.
- *
- *   - MCP server entry to `~/.cursor/mcp.json` (global) or
- *     `./.cursor/mcp.json` (local). Same `{mcpServers: {...}}` shape
- *     as Claude.
- *   - Instructions to `./.cursor/rules/cgraphx.mdc` (project-local
- *     ONLY). Cursor's rules system is a project-scoped surface;
- *     global cursor rules aren't a stable convention as of 2026-05.
- *     For `--location=global`, only mcp.json is written.
- *
- * ## Why we hardcode `--path` for Cursor
- *
- * Cursor launches MCP-server subprocesses with a working directory
- * that ISN'T the workspace root AND doesn't pass `rootUri` /
- * `workspaceFolders` in the MCP initialize call. The CodeGraph MCP
- * server's `process.cwd()` fallback therefore misses the workspace's
- * `.cgraphx/` and reports "not initialized" on every tool call.
- *
- * So we inject `--path` into the args ourselves:
- *
- *   - `local`  install: absolute path (we know it at install time).
- *   - `global` install: `${workspaceFolder}` — Cursor expands this to
- *     the open workspace's root, giving us per-workspace behavior
- *     from a single global config.
- *
- * Codex and Claude do not need this — they launch MCP servers with
- * `cwd = workspace` and pass `rootUri`, respectively.
- *
- * No permissions concept — Cursor doesn't have an auto-allow list
- * the installer can populate. `autoAllow` is silently ignored.
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.cursorTarget = void 0;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const os = __importStar(require("os"));
-const shared_1 = require("./shared");
-const instructions_template_1 = require("../instructions-template");
-function mcpJsonPath(loc) {
-    return loc === 'global'
-        ? path.join(os.homedir(), '.cursor', 'mcp.json')
-        : path.join(process.cwd(), '.cursor', 'mcp.json');
-}
-/**
- * Cursor "rules" file. Only meaningful for the project-local
- * location — Cursor reads `.cursor/rules/*.mdc` from the workspace
- * root. There is no global equivalent.
- */
-function rulesPath() {
-    return path.join(process.cwd(), '.cursor', 'rules', 'cgraphx.mdc');
-}
-/**
- * Cursor `.mdc` rules use YAML-ish frontmatter. `alwaysApply: true`
- * makes the rule load on every conversation regardless of file
- * patterns — appropriate for a tool-usage guide that's relevant
- * whenever the user is asking the agent to navigate code.
- */
-const MDC_FRONTMATTER = [
-    '---',
-    'description: CodeGraph MCP usage guide — when to use which tool',
-    'alwaysApply: true',
-    '---',
-    '',
-].join('\n');
-class CursorTarget {
-    id = 'cursor';
-    displayName = 'Cursor';
-    docsUrl = 'https://docs.cursor.com/context/model-context-protocol';
-    supportsLocation(_loc) {
-        // Both supported, but `local` writes more files (mcp.json + rules);
-        // `global` writes only mcp.json. The orchestrator surfaces the
-        // difference via describePaths.
-        return true;
-    }
-    detect(loc) {
-        const mcpPath = mcpJsonPath(loc);
-        const config = (0, shared_1.readJsonFile)(mcpPath);
-        const alreadyConfigured = !!config.mcpServers?.cgraphx;
-        // "Installed" heuristic: does ~/.cursor exist (global) or has the
-        // user opted into a project-local cursor config dir?
-        const installed = loc === 'global'
-            ? fs.existsSync(path.join(os.homedir(), '.cursor'))
-            : fs.existsSync(path.join(process.cwd(), '.cursor'));
-        return { installed, alreadyConfigured, configPath: mcpPath };
-    }
-    install(loc, _opts) {
-        const files = [];
-        files.push(writeMcpEntry(loc));
-        // We no longer write `.cursor/rules/cgraphx.mdc` — the CodeGraph
-        // usage guidance ships in the MCP server's `initialize` response,
-        // the single source of truth (issue #529). Strip a rules file a
-        // previous install created so an upgrade self-heals.
-        if (loc === 'local') {
-            const rulesCleanup = removeRulesEntry();
-            if (rulesCleanup.action === 'removed')
-                files.push(rulesCleanup);
-        }
-        return {
-            files,
-            notes: ['Restart Cursor for MCP changes to take effect.'],
-        };
-    }
-    uninstall(loc) {
-        const files = [];
-        const mcpPath = mcpJsonPath(loc);
-        const config = (0, shared_1.readJsonFile)(mcpPath);
-        if (config.mcpServers?.cgraphx) {
-            delete config.mcpServers.cgraphx;
-            if (Object.keys(config.mcpServers).length === 0) {
-                delete config.mcpServers;
-            }
-            (0, shared_1.writeJsonFile)(mcpPath, config);
-            files.push({ path: mcpPath, action: 'removed' });
-        }
-        else {
-            files.push({ path: mcpPath, action: 'not-found' });
-        }
-        if (loc === 'local') {
-            files.push(removeRulesEntry());
-        }
-        return { files };
-    }
-    printConfig(loc) {
-        const target = mcpJsonPath(loc);
-        const snippet = JSON.stringify({ mcpServers: { cgraphx: buildCursorMcpConfig(loc) } }, null, 2);
-        return `# Add to ${target}\n\n${snippet}\n`;
-    }
-    describePaths(loc) {
-        return loc === 'local'
-            ? [mcpJsonPath(loc), rulesPath()]
-            : [mcpJsonPath(loc)];
-    }
-}
-/**
- * Build the CodeGraph MCP-server config for Cursor at the given
- * location. Inherits the shared shape ({type, command, args}) and
- * appends `--path` so the spawned MCP server resolves the workspace
- * correctly regardless of Cursor's launch cwd. See file header for
- * the full rationale.
- */
-function buildCursorMcpConfig(loc) {
-    const base = (0, shared_1.getMcpServerConfig)();
-    const pathArg = loc === 'local' ? process.cwd() : '${workspaceFolder}';
-    return { ...base, args: [...base.args, '--path', pathArg] };
-}
-function writeMcpEntry(loc) {
-    const file = mcpJsonPath(loc);
-    const existing = (0, shared_1.readJsonFile)(file);
-    const before = existing.mcpServers?.cgraphx;
-    const after = buildCursorMcpConfig(loc);
-    if ((0, shared_1.jsonDeepEqual)(before, after)) {
-        return { path: file, action: 'unchanged' };
-    }
-    const action = before ? 'updated' : (fs.existsSync(file) ? 'updated' : 'created');
-    if (!existing.mcpServers)
-        existing.mcpServers = {};
-    existing.mcpServers.cgraphx = after;
-    (0, shared_1.writeJsonFile)(file, existing);
-    return { path: file, action };
-}
-/**
- * Remove the Cursor rules file on uninstall (and as a self-heal on
- * install — see issue #529).
- *
- * Unlike the shared CLAUDE.md / AGENTS.md files (where CodeGraph owns
- * only a marker-delimited section), `.cursor/rules/cgraphx.mdc` is a
- * file we create OUTRIGHT — the frontmatter is ours too. So a plain
- * `removeMarkedSection` is wrong here: it would strip our instruction
- * block but leave the orphaned `description: CodeGraph ...` frontmatter
- * behind, so the file lingers and still "mentions" cgraphx.
- *
- * Instead: strip our block, and if nothing but our own frontmatter
- * remains, delete the whole file. Only when the user has added their
- * own content outside our markers do we keep the file (minus our block).
- */
-function removeRulesEntry() {
-    const file = rulesPath();
-    if (!fs.existsSync(file))
-        return { path: file, action: 'not-found' };
-    let content;
-    try {
-        content = fs.readFileSync(file, 'utf-8');
-    }
-    catch {
-        return { path: file, action: 'not-found' };
-    }
-    const ourFrontmatter = MDC_FRONTMATTER.trim();
-    const startIdx = content.indexOf(instructions_template_1.CGRAPHX_SECTION_START);
-    const endIdx = content.indexOf(instructions_template_1.CGRAPHX_SECTION_END);
-    // Our marked block is present — strip it, then decide what's left.
-    if (startIdx !== -1 && endIdx > startIdx) {
-        const before = content.substring(0, startIdx).trimEnd();
-        const after = content.substring(endIdx + instructions_template_1.CGRAPHX_SECTION_END.length).trimStart();
-        const remainder = (before + (before && after ? '\n\n' : '') + after).trim();
-        if (remainder === '' || remainder === ourFrontmatter) {
-            try {
-                fs.unlinkSync(file);
-            }
-            catch { /* ignore */ }
-        }
-        else {
-            (0, shared_1.atomicWriteFileSync)(file, remainder + '\n');
-        }
-        return { path: file, action: 'removed' };
-    }
-    // No block, but the file is still our pristine frontmatter-only file
-    // — it's ours, so remove it.
-    if (content.trim() === ourFrontmatter) {
-        try {
-            fs.unlinkSync(file);
-        }
-        catch { /* ignore */ }
-        return { path: file, action: 'removed' };
-    }
-    // Foreign content we don't recognize — leave it alone.
-    return { path: file, action: 'not-found' };
-}
-exports.cursorTarget = new CursorTarget();
-//# sourceMappingURL=cursor.js.map

package/dist/installer/targets/cursor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../../src/installer/targets/cursor.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,2CAA6B;AAC7B,uCAAyB;AAQzB,qCAMkB;AAClB,oEAGkC;AAElC,SAAS,WAAW,CAAC,GAAa;IAChC,OAAO,GAAG,KAAK,QAAQ;QACrB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC;QAChD,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AACtD,CAAC;AACD;;;;GAIG;AACH,SAAS,SAAS;IAChB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;AACrE,CAAC;AAED;;;;;GAKG;AACH,MAAM,eAAe,GAAG;IACtB,KAAK;IACL,iEAAiE;IACjE,mBAAmB;IACnB,KAAK;IACL,EAAE;CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,YAAY;IACP,EAAE,GAAG,QAAiB,CAAC;IACvB,WAAW,GAAG,QAAQ,CAAC;IACvB,OAAO,GAAG,wDAAwD,CAAC;IAE5E,gBAAgB,CAAC,IAAc;QAC7B,oEAAoE;QACpE,+DAA+D;QAC/D,gCAAgC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,GAAa;QAClB,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,OAAO,CAAC,CAAC;QACrC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC;QACvD,kEAAkE;QAClE,qDAAqD;QACrD,MAAM,SAAS,GAAG,GAAG,KAAK,QAAQ;YAChC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;YACnD,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;QACvD,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;IAC/D,CAAC;IAED,OAAO,CAAC,GAAa,EAAE,KAAqB;QAC1C,MAAM,KAAK,GAAyB,EAAE,CAAC;QAEvC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;QAE/B,iEAAiE;QACjE,kEAAkE;QAClE,gEAAgE;QAChE,qDAAqD;QACrD,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACpB,MAAM,YAAY,GAAG,gBAAgB,EAAE,CAAC;YACxC,IAAI,YAAY,CAAC,MAAM,KAAK,SAAS;gBAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAClE,CAAC;QAED,OAAO;YACL,KAAK;YACL,KAAK,EAAE,CAAC,gDAAgD,CAAC;SAC1D,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,GAAa;QACrB,MAAM,KAAK,GAAyB,EAAE,CAAC;QAEvC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC;YAC/B,OAAO,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC;YACjC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAChD,OAAO,MAAM,CAAC,UAAU,CAAC;YAC3B,CAAC;YACD,IAAA,sBAAa,EAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACjC,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,WAAW,CAAC,GAAa;QACvB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,oBAAoB,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAChG,OAAO,YAAY,MAAM,OAAO,OAAO,IAAI,CAAC;IAC9C,CAAC;IAED,aAAa,CAAC,GAAa;QACzB,OAAO,GAAG,KAAK,OAAO;YACpB,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,CAAC;YACjC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,CAAC;CACF;AAED;;;;;;GAMG;AACH,SAAS,oBAAoB,CAAC,GAAa;IACzC,MAAM,IAAI,GAAG,IAAA,2BAAkB,GAAE,CAAC;IAClC,MAAM,OAAO,GAAG,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,oBAAoB,CAAC;IACvE,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED,SAAS,aAAa,CAAC,GAAa;IAClC,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,QAAQ,GAAG,IAAA,qBAAY,EAAC,IAAI,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC5C,MAAM,KAAK,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAExC,IAAI,IAAA,sBAAa,EAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAC7C,CAAC;IACD,MAAM,MAAM,GAA0B,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACzG,IAAI,CAAC,QAAQ,CAAC,UAAU;QAAE,QAAQ,CAAC,UAAU,GAAG,EAAE,CAAC;IACnD,QAAQ,CAAC,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;IACpC,IAAA,sBAAa,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAChC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAS,gBAAgB;IACvB,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC;IACzB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAErE,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAC7C,CAAC;IAED,MAAM,cAAc,GAAG,eAAe,CAAC,IAAI,EAAE,CAAC;IAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,6CAAqB,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,2CAAmB,CAAC,CAAC;IAEpD,mEAAmE;IACnE,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,GAAG,QAAQ,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;QACxD,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,2CAAmB,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,CAAC;QACjF,MAAM,SAAS,GAAG,CAAC,MAAM,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5E,IAAI,SAAS,KAAK,EAAE,IAAI,SAAS,KAAK,cAAc,EAAE,CAAC;YACrD,IAAI,CAAC;gBAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QACrD,CAAC;aAAM,CAAC;YACN,IAAA,4BAAmB,EAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC3C,CAAC;IAED,qEAAqE;IACrE,6BAA6B;IAC7B,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,cAAc,EAAE,CAAC;QACtC,IAAI,CAAC;YAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QACnD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC3C,CAAC;IAED,uDAAuD;IACvD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AAC7C,CAAC;AAEY,QAAA,YAAY,GAAgB,IAAI,YAAY,EAAE,CAAC"}

package/dist/installer/targets/gemini.d.ts

@@ -1,26 +0,0 @@
-/**
- * Gemini CLI target (also covers the rebranded "Antigravity CLI" —
- * Google is in the middle of unifying its CLI tools under
- * Antigravity, and the new CLI continues to read `~/.gemini/settings.json`
- * + project-local `.gemini/settings.json`). Writes:
- *
- *   - MCP server entry to `~/.gemini/settings.json` (global) or
- *     `./.gemini/settings.json` (local) under the standard
- *     `mcpServers.cgraphx` key. Same shape as Claude / Cursor.
- *   - Instructions to `~/.gemini/GEMINI.md` (global) or `./GEMINI.md`
- *     (local — Gemini reads the project root file directly, not
- *     under `.gemini/`).
- *
- * No permissions concept — Gemini CLI gates tool invocations through
- * the `trust` field per server, not an external allowlist. We leave
- * `trust` unset so the user controls confirmation prompts.
- *
- * The Antigravity IDE shares `~/.gemini/GEMINI.md` for instructions
- * but uses a separate MCP config file (`~/.gemini/antigravity/mcp_config.json`)
- * — see `./antigravity.ts`. Both targets writing to GEMINI.md is
- * safe: the marker-based section replacement makes the second write
- * a byte-identical no-op.
- */
-import { AgentTarget } from './types';
-export declare const geminiTarget: AgentTarget;
-//# sourceMappingURL=gemini.d.ts.map

package/dist/installer/targets/gemini.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../../src/installer/targets/gemini.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,EACL,WAAW,EAKZ,MAAM,SAAS,CAAC;AAgIjB,eAAO,MAAM,YAAY,EAAE,WAAgC,CAAC"}