@colbymchenry/codegraph 0.7.6 → 0.7.9

package/dist/installer/claude-md-template.js

@@ -1,46 +1,21 @@
 "use strict";
 /**
- * CLAUDE.md template for CodeGraph instructions
+ * Backwards-compat re-export shim.
  *
- * This template is injected into ~/.claude/CLAUDE.md (global) or ./.claude/CLAUDE.md (local)
- * Keep this in sync with the README.md "Recommended: Add Global Instructions" section
+ * The instructions template moved to `instructions-template.ts` so it
+ * can be shared across all agent targets (Claude Code, Cursor, Codex
+ * CLI, opencode). This file is preserved purely so existing imports
+ * (`@colbymchenry/codegraph` consumers, downstream tooling) keep
+ * working unchanged. New code should import from
+ * `./instructions-template` directly.
+ *
+ * @deprecated Import from `./instructions-template` instead.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CLAUDE_MD_TEMPLATE = exports.CODEGRAPH_SECTION_END = exports.CODEGRAPH_SECTION_START = void 0;
-// Markers to identify CodeGraph section for updates
-exports.CODEGRAPH_SECTION_START = '<!-- CODEGRAPH_START -->';
-exports.CODEGRAPH_SECTION_END = '<!-- CODEGRAPH_END -->';
-exports.CLAUDE_MD_TEMPLATE = `${exports.CODEGRAPH_SECTION_START}
-## CodeGraph
-
-CodeGraph builds a semantic knowledge graph of codebases for faster, smarter code exploration.
-
-### If \`.codegraph/\` exists in the project
-
-**NEVER call \`codegraph_explore\` or \`codegraph_context\` directly in the main session.** These tools return large amounts of source code that fills up main session context. Instead, ALWAYS spawn an Explore agent for any exploration question (e.g., "how does X work?", "explain the Y system", "where is Z implemented?").
-
-**When spawning Explore agents**, include this instruction in the prompt:
-
-> This project has CodeGraph initialized (.codegraph/ exists). Use \`codegraph_explore\` as your PRIMARY tool — it returns full source code sections from all relevant files in one call.
->
-> **Rules:**
-> 1. Follow the explore call budget in the \`codegraph_explore\` tool description — it scales automatically based on project size.
-> 2. Do NOT re-read files that codegraph_explore already returned source code for. The source sections are complete and authoritative.
-> 3. Only fall back to grep/glob/read for files listed under "Additional relevant files" if you need more detail, or if codegraph returned no results.
-
-**The main session may only use these lightweight tools directly** (for targeted lookups before making edits, not for exploration):
-
-| Tool | Use For |
-|------|---------|
-| \`codegraph_search\` | Find symbols by name |
-| \`codegraph_callers\` / \`codegraph_callees\` | Trace call flow |
-| \`codegraph_impact\` | Check what's affected before editing |
-| \`codegraph_node\` | Get a single symbol's details |
-
-### If \`.codegraph/\` does NOT exist
-
-At the start of a session, ask the user if they'd like to initialize CodeGraph:
-
-"I notice this project doesn't have CodeGraph initialized. Would you like me to run \`codegraph init -i\` to build a code knowledge graph?"
-${exports.CODEGRAPH_SECTION_END}`;
+exports.INSTRUCTIONS_TEMPLATE = exports.CLAUDE_MD_TEMPLATE = exports.CODEGRAPH_SECTION_END = exports.CODEGRAPH_SECTION_START = void 0;
+var instructions_template_1 = require("./instructions-template");
+Object.defineProperty(exports, "CODEGRAPH_SECTION_START", { enumerable: true, get: function () { return instructions_template_1.CODEGRAPH_SECTION_START; } });
+Object.defineProperty(exports, "CODEGRAPH_SECTION_END", { enumerable: true, get: function () { return instructions_template_1.CODEGRAPH_SECTION_END; } });
+Object.defineProperty(exports, "CLAUDE_MD_TEMPLATE", { enumerable: true, get: function () { return instructions_template_1.CLAUDE_MD_TEMPLATE; } });
+Object.defineProperty(exports, "INSTRUCTIONS_TEMPLATE", { enumerable: true, get: function () { return instructions_template_1.INSTRUCTIONS_TEMPLATE; } });
 //# sourceMappingURL=claude-md-template.js.map

package/dist/installer/claude-md-template.js.map

@@ -1 +1 @@
-{"version":3,"file":"claude-md-template.js","sourceRoot":"","sources":["../../src/installer/claude-md-template.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,oDAAoD;AACvC,QAAA,uBAAuB,GAAG,0BAA0B,CAAC;AACrD,QAAA,qBAAqB,GAAG,wBAAwB,CAAC;AAEjD,QAAA,kBAAkB,GAAG,GAAG,+BAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgC1D,6BAAqB,EAAE,CAAC"}
+{"version":3,"file":"claude-md-template.js","sourceRoot":"","sources":["../../src/installer/claude-md-template.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAEH,iEAKiC;AAJ/B,gIAAA,uBAAuB,OAAA;AACvB,8HAAA,qBAAqB,OAAA;AACrB,2HAAA,kBAAkB,OAAA;AAClB,8HAAA,qBAAqB,OAAA"}

package/dist/installer/config-writer.d.ts

@@ -1,36 +1,29 @@
 /**
- * Config file writing for the CodeGraph installer
- * Writes to claude.json, settings.json, and CLAUDE.md
+ * Backwards-compat shim — original Claude-only writer functions.
+ *
+ * The installer now uses the multi-target architecture in
+ * `./targets/`. This file is preserved so existing imports (the test
+ * suite, downstream tooling) keep working unchanged. Each function
+ * delegates to the Claude target. New code should import the target
+ * registry from `./targets/registry` directly.
+ *
+ * @deprecated Use `targets/registry.ts` and the `AgentTarget`
+ *   abstraction instead.
  */
 export type InstallLocation = 'global' | 'local';
 /**
- * Write the MCP server configuration to claude.json
+ * Each shim calls ONLY the named per-file helper — writeMcpConfig
+ * writes only the MCP JSON, writePermissions only settings.json,
+ * writeClaudeMd only CLAUDE.md. The full multi-file install lives
+ * in `claudeTarget.install()` which the new orchestrator uses.
  */
 export declare function writeMcpConfig(location: InstallLocation): void;
-/**
- * Write permissions to settings.json
- */
 export declare function writePermissions(location: InstallLocation): void;
-/**
- * Check if MCP config already exists for CodeGraph
- */
-export declare function hasMcpConfig(location: InstallLocation): boolean;
-/**
- * Check if permissions already exist for CodeGraph
- */
-export declare function hasPermissions(location: InstallLocation): boolean;
-/**
- * Check if CLAUDE.md has CodeGraph section
- */
-export declare function hasClaudeMdSection(location: InstallLocation): boolean;
-/**
- * Write or update CLAUDE.md with CodeGraph instructions
- *
- * If the file exists and has a CodeGraph section (marked or unmarked),
- * it will be replaced. Otherwise, the template is appended.
- */
 export declare function writeClaudeMd(location: InstallLocation): {
     created: boolean;
     updated: boolean;
 };
+export declare function hasMcpConfig(location: InstallLocation): boolean;
+export declare function hasPermissions(location: InstallLocation): boolean;
+export declare function hasClaudeMdSection(location: InstallLocation): boolean;
 //# sourceMappingURL=config-writer.d.ts.map

package/dist/installer/config-writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-writer.d.ts","sourceRoot":"","sources":["../../src/installer/config-writer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,CAAC;AAsGjD;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAa9D;AAiBD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAuBhE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAI/D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CASjE;AAYD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAWrE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAiE/F"}
+{"version":3,"file":"config-writer.d.ts","sourceRoot":"","sources":["../../src/installer/config-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAYH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAE9D;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAEhE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAM/F;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAM/D;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAQjE;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAWrE"}

package/dist/installer/config-writer.js

@@ -1,7 +1,15 @@
 "use strict";
 /**
- * Config file writing for the CodeGraph installer
- * Writes to claude.json, settings.json, and CLAUDE.md
+ * Backwards-compat shim — original Claude-only writer functions.
+ *
+ * The installer now uses the multi-target architecture in
+ * `./targets/`. This file is preserved so existing imports (the test
+ * suite, downstream tooling) keep working unchanged. Each function
+ * delegates to the Claude target. New code should import the target
+ * registry from `./targets/registry` directly.
+ *
+ * @deprecated Use `targets/registry.ts` and the `AgentTarget`
+ *   abstraction instead.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -39,266 +47,63 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.writeMcpConfig = writeMcpConfig;
 exports.writePermissions = writePermissions;
+exports.writeClaudeMd = writeClaudeMd;
 exports.hasMcpConfig = hasMcpConfig;
 exports.hasPermissions = hasPermissions;
 exports.hasClaudeMdSection = hasClaudeMdSection;
-exports.writeClaudeMd = writeClaudeMd;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
-const claude_md_template_1 = require("./claude-md-template");
-/**
- * Get the path to the Claude config directory
- */
-function getClaudeConfigDir(location) {
-    if (location === 'global') {
-        return path.join(os.homedir(), '.claude');
-    }
-    return path.join(process.cwd(), '.claude');
-}
-/**
- * Get the path to the claude.json file
- * - Global: ~/.claude.json (root level)
- * - Local: ./.claude.json (project root)
- */
-function getClaudeJsonPath(location) {
-    if (location === 'global') {
-        return path.join(os.homedir(), '.claude.json');
-    }
-    return path.join(process.cwd(), '.claude.json');
-}
-/**
- * Get the path to the settings.json file
- * - Global: ~/.claude/settings.json
- * - Local: ./.claude/settings.json
- */
-function getSettingsJsonPath(location) {
-    const configDir = getClaudeConfigDir(location);
-    return path.join(configDir, 'settings.json');
-}
-/**
- * Read a JSON file, returning an empty object if it doesn't exist.
- * Distinguishes between missing files (returns {}) and corrupted
- * files (logs warning, returns {}).
- */
-function readJsonFile(filePath) {
-    if (!fs.existsSync(filePath)) {
-        return {};
-    }
-    try {
-        const content = fs.readFileSync(filePath, 'utf-8');
-        return JSON.parse(content);
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        console.warn(`  Warning: Could not parse ${path.basename(filePath)}: ${msg}`);
-        console.warn(`  A backup will be created before overwriting.`);
-        // Create a backup of the corrupted file
-        try {
-            const backupPath = filePath + '.backup';
-            fs.copyFileSync(filePath, backupPath);
-        }
-        catch { /* ignore backup failure */ }
-        return {};
-    }
-}
+const claude_1 = require("./targets/claude");
+const shared_1 = require("./targets/shared");
 /**
- * Write a file atomically by writing to a temp file then renaming.
- * Prevents corruption if the process crashes mid-write.
+ * Each shim calls ONLY the named per-file helper — writeMcpConfig
+ * writes only the MCP JSON, writePermissions only settings.json,
+ * writeClaudeMd only CLAUDE.md. The full multi-file install lives
+ * in `claudeTarget.install()` which the new orchestrator uses.
  */
-function atomicWriteFileSync(filePath, content) {
-    const dir = path.dirname(filePath);
-    if (!fs.existsSync(dir)) {
-        fs.mkdirSync(dir, { recursive: true });
-    }
-    const tmpPath = filePath + '.tmp.' + process.pid;
-    try {
-        fs.writeFileSync(tmpPath, content);
-        fs.renameSync(tmpPath, filePath);
-    }
-    catch (err) {
-        // Clean up temp file on failure
-        try {
-            fs.unlinkSync(tmpPath);
-        }
-        catch { /* ignore */ }
-        throw err;
-    }
+function writeMcpConfig(location) {
+    (0, claude_1.writeMcpEntry)(location);
 }
-/**
- * Write a JSON file, creating parent directories if needed
- */
-function writeJsonFile(filePath, data) {
-    atomicWriteFileSync(filePath, JSON.stringify(data, null, 2) + '\n');
+function writePermissions(location) {
+    (0, claude_1.writePermissionsEntry)(location);
 }
-/**
- * Get the MCP server configuration
- */
-function getMcpServerConfig() {
+function writeClaudeMd(location) {
+    const file = (0, claude_1.writeInstructionsEntry)(location);
     return {
-        type: 'stdio',
-        command: 'codegraph',
-        args: ['serve', '--mcp'],
+        created: file.action === 'created',
+        updated: file.action === 'updated',
     };
 }
-/**
- * Write the MCP server configuration to claude.json
- */
-function writeMcpConfig(location) {
-    const claudeJsonPath = getClaudeJsonPath(location);
-    const config = readJsonFile(claudeJsonPath);
-    // Ensure mcpServers object exists
-    if (!config.mcpServers) {
-        config.mcpServers = {};
-    }
-    // Add or update codegraph server
-    config.mcpServers.codegraph = getMcpServerConfig();
-    writeJsonFile(claudeJsonPath, config);
-}
-/**
- * Get the list of permissions for CodeGraph tools
- */
-function getCodeGraphPermissions() {
-    return [
-        'mcp__codegraph__codegraph_search',
-        'mcp__codegraph__codegraph_context',
-        'mcp__codegraph__codegraph_callers',
-        'mcp__codegraph__codegraph_callees',
-        'mcp__codegraph__codegraph_impact',
-        'mcp__codegraph__codegraph_node',
-        'mcp__codegraph__codegraph_status',
-    ];
-}
-/**
- * Write permissions to settings.json
- */
-function writePermissions(location) {
-    const settingsPath = getSettingsJsonPath(location);
-    const settings = readJsonFile(settingsPath);
-    // Ensure permissions object exists
-    if (!settings.permissions) {
-        settings.permissions = {};
-    }
-    // Ensure allow array exists
-    if (!Array.isArray(settings.permissions.allow)) {
-        settings.permissions.allow = [];
-    }
-    // Add CodeGraph permissions (avoiding duplicates)
-    const codegraphPermissions = getCodeGraphPermissions();
-    for (const permission of codegraphPermissions) {
-        if (!settings.permissions.allow.includes(permission)) {
-            settings.permissions.allow.push(permission);
-        }
-    }
-    writeJsonFile(settingsPath, settings);
-}
-/**
- * Check if MCP config already exists for CodeGraph
- */
 function hasMcpConfig(location) {
-    const claudeJsonPath = getClaudeJsonPath(location);
-    const config = readJsonFile(claudeJsonPath);
+    const file = location === 'global'
+        ? path.join(os.homedir(), '.claude.json')
+        : path.join(process.cwd(), '.claude.json');
+    const config = (0, shared_1.readJsonFile)(file);
     return !!config.mcpServers?.codegraph;
 }
-/**
- * Check if permissions already exist for CodeGraph
- */
 function hasPermissions(location) {
-    const settingsPath = getSettingsJsonPath(location);
-    const settings = readJsonFile(settingsPath);
-    const permissions = settings.permissions?.allow;
-    if (!Array.isArray(permissions)) {
+    const file = location === 'global'
+        ? path.join(os.homedir(), '.claude', 'settings.json')
+        : path.join(process.cwd(), '.claude', 'settings.json');
+    const settings = (0, shared_1.readJsonFile)(file);
+    const allow = settings.permissions?.allow;
+    if (!Array.isArray(allow))
         return false;
-    }
-    // Check if at least one CodeGraph permission exists
-    return permissions.some((p) => p.startsWith('mcp__codegraph__'));
-}
-/**
- * Get the path to CLAUDE.md
- * - Global: ~/.claude/CLAUDE.md
- * - Local: ./.claude/CLAUDE.md
- */
-function getClaudeMdPath(location) {
-    const configDir = getClaudeConfigDir(location);
-    return path.join(configDir, 'CLAUDE.md');
+    return allow.some((p) => p.startsWith('mcp__codegraph__'));
 }
-/**
- * Check if CLAUDE.md has CodeGraph section
- */
 function hasClaudeMdSection(location) {
-    const claudeMdPath = getClaudeMdPath(location);
+    const file = location === 'global'
+        ? path.join(os.homedir(), '.claude', 'CLAUDE.md')
+        : path.join(process.cwd(), '.claude', 'CLAUDE.md');
     try {
-        if (fs.existsSync(claudeMdPath)) {
-            const content = fs.readFileSync(claudeMdPath, 'utf-8');
-            return content.includes(claude_md_template_1.CODEGRAPH_SECTION_START) || content.includes('## CodeGraph');
-        }
+        if (!fs.existsSync(file))
+            return false;
+        const content = fs.readFileSync(file, 'utf-8');
+        return content.includes('<!-- CODEGRAPH_START -->') || content.includes('## CodeGraph');
     }
     catch {
-        // Ignore errors
-    }
-    return false;
-}
-/**
- * Write or update CLAUDE.md with CodeGraph instructions
- *
- * If the file exists and has a CodeGraph section (marked or unmarked),
- * it will be replaced. Otherwise, the template is appended.
- */
-function writeClaudeMd(location) {
-    const claudeMdPath = getClaudeMdPath(location);
-    const configDir = getClaudeConfigDir(location);
-    // Ensure directory exists
-    if (!fs.existsSync(configDir)) {
-        fs.mkdirSync(configDir, { recursive: true });
-    }
-    // Check if file exists
-    if (!fs.existsSync(claudeMdPath)) {
-        // Create new file with just the CodeGraph section
-        atomicWriteFileSync(claudeMdPath, claude_md_template_1.CLAUDE_MD_TEMPLATE + '\n');
-        return { created: true, updated: false };
-    }
-    // Read existing content
-    let content = fs.readFileSync(claudeMdPath, 'utf-8');
-    // Check for marked section (from previous installer)
-    if (content.includes(claude_md_template_1.CODEGRAPH_SECTION_START)) {
-        // Replace the marked section
-        const startIdx = content.indexOf(claude_md_template_1.CODEGRAPH_SECTION_START);
-        const endIdx = content.indexOf(claude_md_template_1.CODEGRAPH_SECTION_END);
-        if (endIdx > startIdx) {
-            // Replace existing marked section
-            const before = content.substring(0, startIdx);
-            const after = content.substring(endIdx + claude_md_template_1.CODEGRAPH_SECTION_END.length);
-            content = before + claude_md_template_1.CLAUDE_MD_TEMPLATE + after;
-            atomicWriteFileSync(claudeMdPath, content);
-            return { created: false, updated: true };
-        }
-    }
-    // Check for unmarked "## CodeGraph" section (from manual setup)
-    const codegraphHeaderRegex = /\n## CodeGraph\n/;
-    const match = content.match(codegraphHeaderRegex);
-    if (match && match.index !== undefined) {
-        // Find the end of the CodeGraph section (next h2 header or end of file)
-        // Use negative lookahead (?!#) to match "## X" but not "### X"
-        const sectionStart = match.index;
-        const afterSection = content.substring(sectionStart + 1);
-        const nextHeaderMatch = afterSection.match(/\n## (?!#)/);
-        let sectionEnd;
-        if (nextHeaderMatch && nextHeaderMatch.index !== undefined) {
-            sectionEnd = sectionStart + 1 + nextHeaderMatch.index;
-        }
-        else {
-            sectionEnd = content.length;
-        }
-        // Replace the section
-        const before = content.substring(0, sectionStart);
-        const after = content.substring(sectionEnd);
-        content = before + '\n' + claude_md_template_1.CLAUDE_MD_TEMPLATE + after;
-        atomicWriteFileSync(claudeMdPath, content);
-        return { created: false, updated: true };
+        return false;
     }
-    // No existing section, append to end
-    content = content.trimEnd() + '\n\n' + claude_md_template_1.CLAUDE_MD_TEMPLATE + '\n';
-    atomicWriteFileSync(claudeMdPath, content);
-    return { created: false, updated: false };
 }
 //# sourceMappingURL=config-writer.js.map

package/dist/installer/config-writer.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-writer.js","sourceRoot":"","sources":["../../src/installer/config-writer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config-writer.js","sourceRoot":"","sources":["../../src/installer/config-writer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoBH,wCAEC;AAED,4CAEC;AAED,sCAMC;AAED,oCAMC;AAED,wCAQC;AAED,gDAWC;AA/DD,uCAAyB;AACzB,2CAA6B;AAC7B,uCAAyB;AACzB,6CAI0B;AAC1B,6CAAgD;AAIhD;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,QAAyB;IACtD,IAAA,sBAAa,EAAC,QAAQ,CAAC,CAAC;AAC1B,CAAC;AAED,SAAgB,gBAAgB,CAAC,QAAyB;IACxD,IAAA,8BAAqB,EAAC,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,SAAgB,aAAa,CAAC,QAAyB;IACrD,MAAM,IAAI,GAAG,IAAA,+BAAsB,EAAC,QAAQ,CAAC,CAAC;IAC9C,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,MAAM,KAAK,SAAS;QAClC,OAAO,EAAE,IAAI,CAAC,MAAM,KAAK,SAAS;KACnC,CAAC;AACJ,CAAC;AAED,SAAgB,YAAY,CAAC,QAAyB;IACpD,MAAM,IAAI,GAAG,QAAQ,KAAK,QAAQ;QAChC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC;QACzC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,IAAI,CAAC,CAAC;IAClC,OAAO,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC;AACxC,CAAC;AAED,SAAgB,cAAc,CAAC,QAAyB;IACtD,MAAM,IAAI,GAAG,QAAQ,KAAK,QAAQ;QAChC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,eAAe,CAAC;QACrD,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,IAAA,qBAAY,EAAC,IAAI,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC;IAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,SAAgB,kBAAkB,CAAC,QAAyB;IAC1D,MAAM,IAAI,GAAG,QAAQ,KAAK,QAAQ;QAChC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC;QACjD,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IACrD,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QACvC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC1F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/installer/index.d.ts

@@ -1,12 +1,53 @@
 /**
  * CodeGraph Interactive Installer
  *
- * Uses @clack/prompts for a polished interactive CLI experience.
+ * Multi-target: writes MCP server config + instructions for the
+ * agents the user picks (Claude Code, Cursor, Codex CLI, opencode).
+ * Defaults to the Claude-only behavior for backwards compatibility
+ * when no targets are explicitly chosen and nothing else is detected.
+ *
+ * Uses @clack/prompts for the interactive UI; `runInstallerWithOptions`
+ * is the non-interactive entry point used by the `--target` /
+ * `--print-config` CLI flags.
  */
-import type { InstallLocation } from './config-writer';
+import type { AgentTarget, Location, WriteResult } from './targets/types';
+export { writeMcpConfig, writePermissions, writeClaudeMd, hasMcpConfig, hasPermissions, hasClaudeMdSection, } from './config-writer';
+export type { InstallLocation } from './config-writer';
+export interface RunInstallerOptions {
+    /** Comma-separated target list, or `auto` / `all` / `none`. */
+    target?: string;
+    /** Skip the location prompt; use this value directly. */
+    location?: Location;
+    /** Skip the auto-allow prompt; use this value directly. */
+    autoAllow?: boolean;
+    /**
+     * Skip every confirm and use defaults: location=global,
+     * autoAllow=true, target=auto. For scripting / CI.
+     */
+    yes?: boolean;
+}
 /**
- * Run the interactive installer
+ * Interactive entry point — preserves the historical UX (`codegraph
+ * install` with no args goes through the prompts), but now starts
+ * the targets multi-select pre-populated with detected agents.
  */
 export declare function runInstaller(): Promise<void>;
-export type { InstallLocation };
+export declare function runInstallerWithOptions(opts: RunInstallerOptions): Promise<void>;
+/**
+ * For every target that has a global config and exposes
+ * `wireProjectSurfaces`, write its project-local surfaces (e.g.
+ * Cursor's `.cursor/rules/codegraph.mdc`). Idempotent — runs
+ * silently when there's nothing to write.
+ *
+ * Called by `codegraph init` so that a user who ran
+ * `codegraph install` once globally doesn't have to re-run it per
+ * project to get full agent support.
+ *
+ * Returns the list of `(target, file)` pairs that were created or
+ * updated — caller decides how to surface them.
+ */
+export declare function wireProjectSurfacesForGlobalAgents(): Array<{
+    target: AgentTarget;
+    file: WriteResult['files'][number];
+}>;
 //# sourceMappingURL=index.d.ts.map

package/dist/installer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/installer/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AA4BvD;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAyElD;AAoFD,YAAY,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/installer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAK1E,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,cAAc,EACd,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAsBvD,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAElD;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkItF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kCAAkC,IAAI,KAAK,CAAC;IAC1D,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;CACpC,CAAC,CAcD"}