@colbymchenry/codegraph 0.7.10 → 0.9.0

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

@@ -1,77 +0,0 @@
-/**
- * Helpers shared across `AgentTarget` implementations.
- *
- * Lifted from the original `config-writer.ts` so each target can
- * compose them without inheritance. Kept deliberately small — the
- * targets are different enough (JSON vs TOML vs Markdown, varying
- * idempotency markers) that a base class would force the awkward
- * shape onto everyone.
- */
-/**
- * The MCP-server config block codegraph injects. Same shape across
- * all JSON-shaped agent configs (Claude, Cursor, opencode), only the
- * surrounding wrapper differs. Codex (TOML) builds its own block.
- */
-export declare function getMcpServerConfig(): {
-    type: string;
-    command: string;
-    args: string[];
-};
-/**
- * Permissions list for Claude `settings.json`. Other targets that
- * have a permissions concept can compose this list directly. The
- * permission strings follow Claude's `mcp__<server>__<tool>` format.
- */
-export declare function getCodeGraphPermissions(): string[];
-/**
- * Read a JSON file, returning `{}` when missing or unparseable.
- *
- * Unparseable files are backed up to `<path>.backup` BEFORE we return
- * `{}` — so an idempotent re-run never silently deletes a user's
- * existing config that happened to break JSON parse temporarily.
- */
-export declare function readJsonFile(filePath: string): Record<string, any>;
-/**
- * Write a file atomically: write to `<path>.tmp.<pid>`, then rename.
- *
- * Prevents corruption if the process crashes mid-write. The temp
- * file is cleaned up on rename failure.
- */
-export declare function atomicWriteFileSync(filePath: string, content: string): void;
-/**
- * Atomic JSON write. Trailing newline matches the convention every
- * existing target had — preserves diff-friendly file shape.
- */
-export declare function writeJsonFile(filePath: string, data: Record<string, any>): void;
-/**
- * Compare two JSON values for deep equality, ignoring key order.
- *
- * Used for idempotency: when the on-disk config already exactly
- * matches what we'd write, return action=`unchanged` instead of
- * re-writing (and emitting a confusing "Updated" log line).
- */
-export declare function jsonDeepEqual(a: unknown, b: unknown): boolean;
-/**
- * Replace or append a marker-delimited section in a markdown-ish file.
- *
- * Used by Claude / Codex for the `<!-- CODEGRAPH_START --> ... <!--
- * CODEGRAPH_END -->` block. Preserves all content outside the
- * markers verbatim.
- *
- * Returns `created` when the file didn't exist; `updated` when
- * markers were found and content swapped; `appended` when markers
- * weren't found and section was added at end. `unchanged` when the
- * existing block already matches `body`.
- */
-export declare function replaceOrAppendMarkedSection(filePath: string, body: string, startMarker: string, endMarker: string): 'created' | 'updated' | 'appended' | 'unchanged';
-/**
- * Inverse of `replaceOrAppendMarkedSection`. Strips the marker
- * block from `filePath` if present. If the file becomes empty after
- * removal, deletes the file entirely (matches the existing Claude
- * uninstall behavior).
- *
- * Returns `removed` when content was stripped, `not-found` when
- * the markers weren't present, `kept` when the file didn't exist.
- */
-export declare function removeMarkedSection(filePath: string, startMarker: string, endMarker: string): 'removed' | 'not-found' | 'kept';
-//# sourceMappingURL=shared.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/installer/targets/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAMtF;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAUlD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAelE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAa3E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAE/E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAiB7D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CA2BlD;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,SAAS,GAAG,WAAW,GAAG,MAAM,CAwBlC"}

package/dist/installer/targets/shared.js

@@ -1,246 +0,0 @@
-"use strict";
-/**
- * Helpers shared across `AgentTarget` implementations.
- *
- * Lifted from the original `config-writer.ts` so each target can
- * compose them without inheritance. Kept deliberately small — the
- * targets are different enough (JSON vs TOML vs Markdown, varying
- * idempotency markers) that a base class would force the awkward
- * shape onto everyone.
- */
-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.getMcpServerConfig = getMcpServerConfig;
-exports.getCodeGraphPermissions = getCodeGraphPermissions;
-exports.readJsonFile = readJsonFile;
-exports.atomicWriteFileSync = atomicWriteFileSync;
-exports.writeJsonFile = writeJsonFile;
-exports.jsonDeepEqual = jsonDeepEqual;
-exports.replaceOrAppendMarkedSection = replaceOrAppendMarkedSection;
-exports.removeMarkedSection = removeMarkedSection;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-/**
- * The MCP-server config block codegraph injects. Same shape across
- * all JSON-shaped agent configs (Claude, Cursor, opencode), only the
- * surrounding wrapper differs. Codex (TOML) builds its own block.
- */
-function getMcpServerConfig() {
-    return {
-        type: 'stdio',
-        command: 'codegraph',
-        args: ['serve', '--mcp'],
-    };
-}
-/**
- * Permissions list for Claude `settings.json`. Other targets that
- * have a permissions concept can compose this list directly. The
- * permission strings follow Claude's `mcp__<server>__<tool>` format.
- */
-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',
-    ];
-}
-/**
- * Read a JSON file, returning `{}` when missing or unparseable.
- *
- * Unparseable files are backed up to `<path>.backup` BEFORE we return
- * `{}` — so an idempotent re-run never silently deletes a user's
- * existing config that happened to break JSON parse temporarily.
- */
-function readJsonFile(filePath) {
-    if (!fs.existsSync(filePath)) {
-        return {};
-    }
-    try {
-        return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
-    }
-    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.`);
-        try {
-            fs.copyFileSync(filePath, filePath + '.backup');
-        }
-        catch { /* ignore backup failure */ }
-        return {};
-    }
-}
-/**
- * Write a file atomically: write to `<path>.tmp.<pid>`, then rename.
- *
- * Prevents corruption if the process crashes mid-write. The temp
- * file is cleaned up on rename failure.
- */
-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) {
-        try {
-            fs.unlinkSync(tmpPath);
-        }
-        catch { /* ignore */ }
-        throw err;
-    }
-}
-/**
- * Atomic JSON write. Trailing newline matches the convention every
- * existing target had — preserves diff-friendly file shape.
- */
-function writeJsonFile(filePath, data) {
-    atomicWriteFileSync(filePath, JSON.stringify(data, null, 2) + '\n');
-}
-/**
- * Compare two JSON values for deep equality, ignoring key order.
- *
- * Used for idempotency: when the on-disk config already exactly
- * matches what we'd write, return action=`unchanged` instead of
- * re-writing (and emitting a confusing "Updated" log line).
- */
-function jsonDeepEqual(a, b) {
-    if (a === b)
-        return true;
-    if (typeof a !== typeof b)
-        return false;
-    if (a === null || b === null)
-        return a === b;
-    if (typeof a !== 'object')
-        return false;
-    if (Array.isArray(a) !== Array.isArray(b))
-        return false;
-    if (Array.isArray(a) && Array.isArray(b)) {
-        if (a.length !== b.length)
-            return false;
-        return a.every((v, i) => jsonDeepEqual(v, b[i]));
-    }
-    const ao = a;
-    const bo = b;
-    const ak = Object.keys(ao).sort();
-    const bk = Object.keys(bo).sort();
-    if (ak.length !== bk.length)
-        return false;
-    if (!ak.every((k, i) => k === bk[i]))
-        return false;
-    return ak.every((k) => jsonDeepEqual(ao[k], bo[k]));
-}
-/**
- * Replace or append a marker-delimited section in a markdown-ish file.
- *
- * Used by Claude / Codex for the `<!-- CODEGRAPH_START --> ... <!--
- * CODEGRAPH_END -->` block. Preserves all content outside the
- * markers verbatim.
- *
- * Returns `created` when the file didn't exist; `updated` when
- * markers were found and content swapped; `appended` when markers
- * weren't found and section was added at end. `unchanged` when the
- * existing block already matches `body`.
- */
-function replaceOrAppendMarkedSection(filePath, body, startMarker, endMarker) {
-    if (!fs.existsSync(filePath)) {
-        atomicWriteFileSync(filePath, body + '\n');
-        return 'created';
-    }
-    const content = fs.readFileSync(filePath, 'utf-8');
-    const startIdx = content.indexOf(startMarker);
-    const endIdx = content.indexOf(endMarker);
-    if (startIdx !== -1 && endIdx > startIdx) {
-        const existingBlock = content.substring(startIdx, endIdx + endMarker.length);
-        if (existingBlock === body) {
-            return 'unchanged';
-        }
-        const before = content.substring(0, startIdx);
-        const after = content.substring(endIdx + endMarker.length);
-        atomicWriteFileSync(filePath, before + body + after);
-        return 'updated';
-    }
-    // No markers — append. Preserve existing content with a separating
-    // blank line.
-    const trimmed = content.trimEnd();
-    const sep = trimmed.length > 0 ? '\n\n' : '';
-    atomicWriteFileSync(filePath, trimmed + sep + body + '\n');
-    return 'appended';
-}
-/**
- * Inverse of `replaceOrAppendMarkedSection`. Strips the marker
- * block from `filePath` if present. If the file becomes empty after
- * removal, deletes the file entirely (matches the existing Claude
- * uninstall behavior).
- *
- * Returns `removed` when content was stripped, `not-found` when
- * the markers weren't present, `kept` when the file didn't exist.
- */
-function removeMarkedSection(filePath, startMarker, endMarker) {
-    if (!fs.existsSync(filePath))
-        return 'kept';
-    let content;
-    try {
-        content = fs.readFileSync(filePath, 'utf-8');
-    }
-    catch {
-        return 'kept';
-    }
-    const startIdx = content.indexOf(startMarker);
-    const endIdx = content.indexOf(endMarker);
-    if (startIdx === -1 || endIdx <= startIdx)
-        return 'not-found';
-    const before = content.substring(0, startIdx).trimEnd();
-    const after = content.substring(endIdx + endMarker.length).trimStart();
-    const joined = before + (before && after ? '\n\n' : '') + after;
-    if (joined.trim() === '') {
-        try {
-            fs.unlinkSync(filePath);
-        }
-        catch { /* ignore */ }
-    }
-    else {
-        atomicWriteFileSync(filePath, joined.trim() + '\n');
-    }
-    return 'removed';
-}
-//# sourceMappingURL=shared.js.map

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

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

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

@@ -1,52 +0,0 @@
-/**
- * Tiny TOML helpers — just enough to inject / replace / remove a
- * single dotted-key table block (`[mcp_servers.codegraph]`) inside an
- * existing `~/.codex/config.toml`. We deliberately do NOT try to be a
- * general TOML parser/serializer; that would mean pulling in a
- * dependency (~50KB) for ~6 lines of output.
- *
- * Strategy: treat the file as text. Find the `[mcp_servers.codegraph]`
- * header line, splice it (and the lines that follow it until the next
- * `[...]` header or EOF) in or out. Everything outside that block is
- * preserved verbatim, byte-for-byte.
- *
- * Limitations (acceptable for our narrow use):
- *   - Only handles top-level table headers; not array-of-tables or
- *     subtables nested inside `[mcp_servers]` itself (we always write
- *     the full dotted key `[mcp_servers.codegraph]`).
- *   - Doesn't validate sibling TOML — if the file is malformed
- *     elsewhere, our injection won't fix it but won't make it worse.
- *   - Quotes string values with double quotes; escapes `\` and `"`.
- */
-/**
- * Serialize a record into the body lines of a TOML table. Values
- * supported: string, string[]. Other types throw — the codex MCP
- * config only needs these two.
- */
-export declare function serializeTomlTableBody(values: Record<string, string | string[]>): string;
-/**
- * Build a full table block: header line + body. Suitable for direct
- * insertion into a TOML file.
- */
-export declare function buildTomlTable(header: string, values: Record<string, string | string[]>): string;
-/**
- * Insert or replace a top-level dotted-key TOML table block in the
- * given file content. Preserves all other content verbatim.
- *
- * Returns `'inserted'` when the table was newly added, `'replaced'`
- * when an existing one was rewritten, `'unchanged'` when the
- * existing block already matches `block` byte-for-byte.
- */
-export declare function upsertTomlTable(fileContent: string, header: string, block: string): {
-    content: string;
-    action: 'inserted' | 'replaced' | 'unchanged';
-};
-/**
- * Remove a top-level dotted-key TOML table block. Returns the
- * possibly-empty new content + an action flag.
- */
-export declare function removeTomlTable(fileContent: string, header: string): {
-    content: string;
-    action: 'removed' | 'not-found';
-};
-//# sourceMappingURL=toml.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"toml.d.ts","sourceRoot":"","sources":["../../../src/installer/targets/toml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,MAAM,CAaxF;AAQD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,MAAM,CAEhG;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,WAAW,CAAA;CAAE,CAkCpE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,WAAW,CAAA;CAAE,CAUtD"}

package/dist/installer/targets/toml.js

@@ -1,147 +0,0 @@
-"use strict";
-/**
- * Tiny TOML helpers — just enough to inject / replace / remove a
- * single dotted-key table block (`[mcp_servers.codegraph]`) inside an
- * existing `~/.codex/config.toml`. We deliberately do NOT try to be a
- * general TOML parser/serializer; that would mean pulling in a
- * dependency (~50KB) for ~6 lines of output.
- *
- * Strategy: treat the file as text. Find the `[mcp_servers.codegraph]`
- * header line, splice it (and the lines that follow it until the next
- * `[...]` header or EOF) in or out. Everything outside that block is
- * preserved verbatim, byte-for-byte.
- *
- * Limitations (acceptable for our narrow use):
- *   - Only handles top-level table headers; not array-of-tables or
- *     subtables nested inside `[mcp_servers]` itself (we always write
- *     the full dotted key `[mcp_servers.codegraph]`).
- *   - Doesn't validate sibling TOML — if the file is malformed
- *     elsewhere, our injection won't fix it but won't make it worse.
- *   - Quotes string values with double quotes; escapes `\` and `"`.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.serializeTomlTableBody = serializeTomlTableBody;
-exports.buildTomlTable = buildTomlTable;
-exports.upsertTomlTable = upsertTomlTable;
-exports.removeTomlTable = removeTomlTable;
-/**
- * Serialize a record into the body lines of a TOML table. Values
- * supported: string, string[]. Other types throw — the codex MCP
- * config only needs these two.
- */
-function serializeTomlTableBody(values) {
-    const lines = [];
-    for (const [key, value] of Object.entries(values)) {
-        if (typeof value === 'string') {
-            lines.push(`${key} = ${quoteString(value)}`);
-        }
-        else if (Array.isArray(value) && value.every((v) => typeof v === 'string')) {
-            const parts = value.map(quoteString).join(', ');
-            lines.push(`${key} = [${parts}]`);
-        }
-        else {
-            throw new Error(`Unsupported TOML value type for key "${key}"`);
-        }
-    }
-    return lines.join('\n');
-}
-function quoteString(s) {
-    // TOML basic strings: backslash and double-quote escapes; control
-    // chars not expected in our payload (paths/args).
-    return '"' + s.replace(/\\/g, '\\\\').replace(/"/g, '\\"') + '"';
-}
-/**
- * Build a full table block: header line + body. Suitable for direct
- * insertion into a TOML file.
- */
-function buildTomlTable(header, values) {
-    return `[${header}]\n${serializeTomlTableBody(values)}`;
-}
-/**
- * Insert or replace a top-level dotted-key TOML table block in the
- * given file content. Preserves all other content verbatim.
- *
- * Returns `'inserted'` when the table was newly added, `'replaced'`
- * when an existing one was rewritten, `'unchanged'` when the
- * existing block already matches `block` byte-for-byte.
- */
-function upsertTomlTable(fileContent, header, block) {
-    const headerLine = `[${header}]`;
-    const headerIdx = findHeaderIndex(fileContent, headerLine);
-    if (headerIdx === -1) {
-        // Insert at end with separating blank line if there's existing content.
-        const trimmed = fileContent.trimEnd();
-        const sep = trimmed.length > 0 ? '\n\n' : '';
-        return {
-            content: trimmed + sep + block + '\n',
-            action: 'inserted',
-        };
-    }
-    // Find the end of this block: next `[...]` header (at line start) or EOF.
-    const blockEnd = findNextTableHeader(fileContent, headerIdx + headerLine.length);
-    const existingBlock = fileContent.substring(headerIdx, blockEnd).replace(/\n+$/, '');
-    if (existingBlock === block) {
-        return { content: fileContent, action: 'unchanged' };
-    }
-    const before = fileContent.substring(0, headerIdx);
-    const after = fileContent.substring(blockEnd);
-    // Trim trailing blank lines from `before` (we'll re-add one) and
-    // leading blank lines from `after` so the file shape stays clean.
-    const beforeClean = before.replace(/\n+$/, '');
-    const afterClean = after.replace(/^\n+/, '');
-    const sepBefore = beforeClean.length > 0 ? '\n\n' : '';
-    const sepAfter = afterClean.length > 0 ? '\n\n' : '\n';
-    return {
-        content: beforeClean + sepBefore + block + sepAfter + afterClean,
-        action: 'replaced',
-    };
-}
-/**
- * Remove a top-level dotted-key TOML table block. Returns the
- * possibly-empty new content + an action flag.
- */
-function removeTomlTable(fileContent, header) {
-    const headerLine = `[${header}]`;
-    const headerIdx = findHeaderIndex(fileContent, headerLine);
-    if (headerIdx === -1)
-        return { content: fileContent, action: 'not-found' };
-    const blockEnd = findNextTableHeader(fileContent, headerIdx + headerLine.length);
-    const before = fileContent.substring(0, headerIdx).replace(/\n+$/, '');
-    const after = fileContent.substring(blockEnd).replace(/^\n+/, '');
-    const joined = before + (before && after ? '\n\n' : '') + after;
-    return { content: joined, action: 'removed' };
-}
-/**
- * Locate the byte index of a header line (`[foo.bar]`) when it
- * appears at the start of a line. Returns -1 if not found.
- */
-function findHeaderIndex(content, headerLine) {
-    // Search BOL or right after a newline.
-    if (content.startsWith(headerLine))
-        return 0;
-    const needle = '\n' + headerLine;
-    const idx = content.indexOf(needle);
-    return idx === -1 ? -1 : idx + 1;
-}
-/**
- * Find the byte index of the next top-level `[...]` table header
- * (excluding array-of-tables `[[...]]`) starting from `from`, or
- * return content length when none.
- */
-function findNextTableHeader(content, from) {
-    // Look for "\n[" but skip "\n[[" (array of tables).
-    let i = from;
-    while (i < content.length) {
-        const nlIdx = content.indexOf('\n[', i);
-        if (nlIdx === -1)
-            return content.length;
-        if (content[nlIdx + 2] === '[') {
-            // [[...]] — keep searching past it.
-            i = nlIdx + 2;
-            continue;
-        }
-        return nlIdx + 1;
-    }
-    return content.length;
-}
-//# sourceMappingURL=toml.js.map

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

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

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

@@ -1,116 +0,0 @@
-/**
- * Agent target abstraction for the installer.
- *
- * Each MCP-capable agent (Claude Code, Cursor, Codex CLI, opencode, ...)
- * implements this interface so the installer orchestrator can write the
- * right MCP-server config + instructions file + permissions for that
- * agent without baking client-specific paths into core code. Adding a
- * new agent = one new file in `targets/` + one entry in `registry.ts`.
- *
- * Closes the Claude-locked installer issue (upstream #137). The
- * runtime MCP server is already agent-agnostic; this brings the
- * installer to the same surface.
- */
-export type Location = 'global' | 'local';
-/**
- * Stable string id used in the `--target` CLI flag and the registry
- * lookup. New targets add a value here when they're added to the
- * registry. Keep these short and lowercase.
- */
-export type TargetId = 'claude' | 'cursor' | 'codex' | 'opencode';
-/**
- * Result of `target.detect(location)`.
- *
- * `installed` is a best-effort heuristic that the agent's CLI / app /
- * config dir is present on this system — used to default the
- * multiselect prompt to "what's actually here." False positives are
- * acceptable (we still write); false negatives just mean the user
- * has to opt in manually.
- *
- * `alreadyConfigured` reports whether codegraph has already been
- * wired into this target at this location — drives the
- * "Updated"-vs-"Added" log line and lets `--check` exit 0/1.
- */
-export interface DetectionResult {
-    installed: boolean;
-    alreadyConfigured: boolean;
-    /** Path inspected; surfaced in diagnostic / dry-run output. */
-    configPath?: string;
-}
-/**
- * What `target.install(location)` actually changed on disk. The
- * orchestrator renders one log line per file using `action`.
- *
- * `unchanged` means we touched the file but its contents were already
- * what we'd write — used for byte-identical idempotent re-runs.
- */
-export interface WriteResult {
-    files: Array<{
-        path: string;
-        action: 'created' | 'updated' | 'unchanged' | 'removed' | 'not-found' | 'kept';
-    }>;
-    /**
-     * Optional one-line notes the orchestrator surfaces verbatim — e.g.
-     * "Restart Cursor to apply." Keep these short; multi-line goes in
-     * the README.
-     */
-    notes?: string[];
-}
-export interface InstallOptions {
-    /**
-     * Whether to write the agent's permissions / auto-allow surface
-     * (Claude `settings.json`, others where applicable). When the
-     * target has no permissions concept this option is a no-op.
-     */
-    autoAllow: boolean;
-}
-export interface AgentTarget {
-    /** Stable id; matches the `TargetId` union. */
-    readonly id: TargetId;
-    /** Human-readable name shown in clack prompts and log lines. */
-    readonly displayName: string;
-    /** Optional URL for "where do I learn more about this agent." */
-    readonly docsUrl?: string;
-    /**
-     * Whether this target supports the given install location.
-     *
-     * Some agents (Codex CLI as of 2026-05) have no project-local
-     * config concept — only a single `~/.codex/` dir. Returning false
-     * for an unsupported (target, location) pair lets the orchestrator
-     * skip cleanly with a clear message.
-     */
-    supportsLocation(loc: Location): boolean;
-    detect(loc: Location): DetectionResult;
-    install(loc: Location, opts: InstallOptions): WriteResult;
-    /**
-     * Inverse of install. Removes only what install would have written;
-     * preserves sibling MCP servers, sibling permissions, and unrelated
-     * markdown sections. Must be safe to call when nothing was ever
-     * installed (returns `not-found` actions).
-     */
-    uninstall(loc: Location): WriteResult;
-    /**
-     * Print the MCP-server snippet a user would paste manually for this
-     * target. Used by `codegraph install --print-config <id>` and by
-     * the README. Must NOT touch the filesystem.
-     */
-    printConfig(loc: Location): string;
-    /** Filesystem paths this target would write to at this location. */
-    describePaths(loc: Location): string[];
-    /**
-     * Optional. Write any project-local surfaces this target needs in
-     * order to work fully when its MCP config is configured globally.
-     * Called by `codegraph init` to bootstrap new projects without
-     * forcing the user to re-run `codegraph install` per project.
-     *
-     * Most targets need nothing here — their global config is complete.
-     * Cursor is the notable exception: its rules system
-     * (`.cursor/rules/*.mdc`) is project-scoped only, and is what makes
-     * Cursor's agent prefer codegraph over its built-in grep.
-     *
-     * Must be idempotent. Targets that have nothing project-local omit
-     * the method entirely.
-     */
-    wireProjectSurfaces?(): WriteResult;
-}
-//# sourceMappingURL=types.d.ts.map