purecontext-mcp 1.1.8 → 1.2.0

package/dist/server/tools/check-move-safe.d.ts

@@ -0,0 +1,44 @@
+/**
+ * check-move-safe.ts
+ *
+ * MCP tool: check_move_safe
+ *
+ * Pre-flight check for moving a file to a new location. Returns:
+ *   - All import statements that need updating (importUpdates), with exact
+ *     current and new paths, plus the line number of each import.
+ *   - Whether the move would introduce import cycles at the new location
+ *     (wouldIntroduceCycles).
+ *
+ * Safety definition:
+ *   safe: false — if the move would place the file in an existing import cycle
+ *                 (the cycle moves with the file to its new location).
+ *   safe: true  — if all affected imports can be updated mechanically and the
+ *                 new location has no cycle involvement.
+ *
+ * Note: all moves are mechanically doable — the only hard blocker is cycle
+ * risk. `importUpdates` is the primary output: an exact checklist of the
+ * import statements that must be updated after the move.
+ */
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const name = "check_move_safe";
+export declare const description: string;
+export declare const inputSchema: {
+    repoId: z.ZodString;
+    filePath: z.ZodString;
+    newFilePath: z.ZodString;
+    checkCycles: z.ZodOptional<z.ZodBoolean>;
+};
+export interface ImportUpdate {
+    importerFilePath: string;
+    currentImportPath: string;
+    newImportPath: string;
+    line: number;
+}
+export declare function handler(args: {
+    repoId: string;
+    filePath: string;
+    newFilePath: string;
+    checkCycles?: boolean;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=check-move-safe.d.ts.map

package/dist/server/tools/check-move-safe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-move-safe.d.ts","sourceRoot":"","sources":["../../../src/server/tools/check-move-safe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGzE,eAAO,MAAM,IAAI,oBAAoB,CAAC;AAEtC,eAAO,MAAM,WAAW,QAM0D,CAAC;AAEnF,eAAO,MAAM,WAAW;;;;;CAevB,CAAC;AAIF,MAAM,WAAW,YAAY;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAyJD,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GAAG,OAAO,CAAC,cAAc,CAAC,CA2H1B"}

package/dist/server/tools/check-move-safe.js

@@ -0,0 +1,266 @@
+/**
+ * check-move-safe.ts
+ *
+ * MCP tool: check_move_safe
+ *
+ * Pre-flight check for moving a file to a new location. Returns:
+ *   - All import statements that need updating (importUpdates), with exact
+ *     current and new paths, plus the line number of each import.
+ *   - Whether the move would introduce import cycles at the new location
+ *     (wouldIntroduceCycles).
+ *
+ * Safety definition:
+ *   safe: false — if the move would place the file in an existing import cycle
+ *                 (the cycle moves with the file to its new location).
+ *   safe: true  — if all affected imports can be updated mechanically and the
+ *                 new location has no cycle involvement.
+ *
+ * Note: all moves are mechanically doable — the only hard blocker is cycle
+ * risk. `importUpdates` is the primary output: an exact checklist of the
+ * import statements that must be updated after the move.
+ */
+import { z } from 'zod';
+import { dirname, extname, relative, sep } from 'path';
+import { openDatabase, getRepo } from '../../core/db/schema.js';
+import { getFileContent } from '../../core/db/file-store.js';
+import { getImportersOf, getAllDepEdges } from '../../core/db/dep-store.js';
+import { buildMeta } from './_meta.js';
+export const name = 'check_move_safe';
+export const description = 'Pre-flight check for moving a file to a new location. Returns a checklist of ' +
+    'import statements that need updating (importUpdates) plus cycle-risk analysis ' +
+    '(wouldIntroduceCycles). ' +
+    'safe: false only when the move would place the file inside an existing import cycle. ' +
+    'All moves are mechanically doable — importUpdates gives you the exact edits needed. ' +
+    'Use find_importers to preview which files depend on a module before moving it.';
+export const inputSchema = {
+    repoId: z.string().describe('Repo ID from index_folder or resolve_repo'),
+    filePath: z
+        .string()
+        .describe('Current file path relative to the repo root (e.g. "src/utils/hash.ts")'),
+    newFilePath: z
+        .string()
+        .describe('Proposed new location relative to the repo root (e.g. "src/core/hash.ts")'),
+    checkCycles: z
+        .boolean()
+        .optional()
+        .describe('Simulate the move in the dependency graph and detect any import cycles ' +
+        'that would involve the new location. Default true.'),
+};
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+/** Normalize path separators to forward slashes. */
+function normalizeSep(p) {
+    return p.split(sep).join('/');
+}
+/**
+ * Compute the new import specifier from `importerFilePath` to `newTargetPath`,
+ * preserving whether the original specifier had a file extension.
+ *
+ * Examples:
+ *   importerFilePath = 'src/main.ts', newTargetPath = 'src/core/hash.ts',
+ *   currentSpecifier = './utils/hash'
+ *   → './core/hash' (no extension, matching original)
+ *
+ *   importerFilePath = 'src/deep/nested/consumer.ts', newTargetPath = 'src/deep/parser.ts',
+ *   currentSpecifier = '../../lib/parser'
+ *   → '../parser'
+ */
+function computeNewImportPath(importerFilePath, newTargetPath, currentSpecifier) {
+    const importerDir = dirname(importerFilePath);
+    const rawRelative = normalizeSep(relative(normalizeSep(importerDir), normalizeSep(newTargetPath)));
+    // Add './' prefix when the path doesn't start with '../'
+    const withPrefix = rawRelative.startsWith('../') ? rawRelative : `./${rawRelative}`;
+    // Match extension presence from the original specifier
+    if (!extname(currentSpecifier)) {
+        // Original had no extension → strip extension from computed path
+        const ext = extname(withPrefix);
+        return ext ? withPrefix.slice(0, -ext.length) : withPrefix;
+    }
+    return withPrefix;
+}
+/** Find the 1-based line number of the first import containing `specifier`. */
+function findImportLine(content, specifier) {
+    if (!content)
+        return 0;
+    const text = content.toString('utf8');
+    const lines = text.split('\n');
+    // Match the raw specifier surrounded by any quote character
+    const escaped = specifier.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const re = new RegExp(`['"\`]${escaped}['"\`]`);
+    for (let i = 0; i < lines.length; i++) {
+        if (re.test(lines[i]))
+            return i + 1;
+    }
+    return 0;
+}
+/**
+ * Get the import specifier used by `importerFile` when importing `targetFile`.
+ * Returns the first matching edge's specifier, or an empty string if not found.
+ */
+function getSpecifier(db, repoId, importerFile, targetFile) {
+    const row = db
+        .prepare(`SELECT specifier FROM dep_edges
+       WHERE repo_id = ? AND source_file = ? AND target_file = ?
+       LIMIT 1`)
+        .get(repoId, importerFile, targetFile);
+    return row?.specifier ?? '';
+}
+/**
+ * Detect all import cycles in a modified dependency graph where `oldPath` has
+ * been renamed to `newPath`. Returns cycles that involve `newPath`.
+ *
+ * Uses the same DFS algorithm as findImportCycles: each cycle is reported
+ * exactly once, rooted at its lexicographically smallest file.
+ */
+function detectCyclesAfterMove(edges, oldPath, newPath, maxCycles = 20) {
+    // Build adjacency list with oldPath renamed to newPath
+    const adj = new Map();
+    for (const edge of edges) {
+        if (edge.sourceFile === edge.targetFile)
+            continue;
+        const src = edge.sourceFile === oldPath ? newPath : edge.sourceFile;
+        const tgt = edge.targetFile === oldPath ? newPath : edge.targetFile;
+        if (src === tgt)
+            continue;
+        const srcList = adj.get(src) ?? [];
+        if (!srcList.includes(tgt))
+            srcList.push(tgt);
+        adj.set(src, srcList);
+        if (!adj.has(tgt))
+            adj.set(tgt, []);
+    }
+    for (const v of adj.values())
+        v.sort();
+    const found = [];
+    const cap = maxCycles + 1;
+    const nodes = [...adj.keys()].sort();
+    function dfs(start, path, pathSet) {
+        if (found.length >= cap)
+            return;
+        const cur = path[path.length - 1];
+        for (const next of adj.get(cur) ?? []) {
+            if (found.length >= cap)
+                return;
+            if (next === start && path.length >= 2) {
+                found.push([...path]);
+            }
+            else if (!pathSet.has(next) && next > start) {
+                pathSet.add(next);
+                path.push(next);
+                dfs(start, path, pathSet);
+                path.pop();
+                pathSet.delete(next);
+            }
+        }
+    }
+    for (const node of nodes) {
+        if (found.length >= cap)
+            break;
+        dfs(node, [node], new Set([node]));
+    }
+    // Return only cycles that involve the new (moved) path, capped at maxCycles
+    return found.filter((c) => c.includes(newPath)).slice(0, maxCycles);
+}
+// ─── Handler ──────────────────────────────────────────────────────────────────
+export async function handler(args) {
+    const t0 = Date.now();
+    const { repoId, filePath, newFilePath, checkCycles = true } = args;
+    // Normalize separators so the paths match what's stored in the DB
+    const normalizedFilePath = normalizeSep(filePath);
+    const normalizedNewFilePath = normalizeSep(newFilePath);
+    if (normalizedFilePath === normalizedNewFilePath) {
+        const output = {
+            safe: true,
+            verdict: 'Safe to move: source and destination paths are the same (no-op).',
+            filePath: normalizedFilePath,
+            newFilePath: normalizedNewFilePath,
+            importUpdates: [],
+            importUpdateCount: 0,
+            newCycles: [],
+            wouldIntroduceCycles: false,
+            _tokenEstimate: 0,
+            _meta: buildMeta({ timingMs: Date.now() - t0 }),
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(output, null, 2) }] };
+    }
+    const db = openDatabase(repoId);
+    try {
+        const repo = getRepo(db, repoId);
+        if (!repo) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Repo "${repoId}" not found. Run index_folder first.`,
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // ── 1. Find all direct importers ──────────────────────────────────────────
+        const importerFiles = getImportersOf(db, repoId, normalizedFilePath);
+        // ── 2. Build ImportUpdate list ────────────────────────────────────────────
+        const importUpdates = [];
+        for (const importerFilePath of importerFiles) {
+            const specifier = getSpecifier(db, repoId, importerFilePath, normalizedFilePath);
+            if (!specifier)
+                continue; // edge without specifier — skip
+            const newImportPath = computeNewImportPath(importerFilePath, normalizedNewFilePath, specifier);
+            const content = getFileContent(db, repoId, importerFilePath);
+            const line = findImportLine(content, specifier);
+            importUpdates.push({
+                importerFilePath,
+                currentImportPath: specifier,
+                newImportPath,
+                line,
+            });
+        }
+        // Sort by importer path for deterministic output
+        importUpdates.sort((a, b) => a.importerFilePath.localeCompare(b.importerFilePath));
+        // ── 3. Cycle detection ────────────────────────────────────────────────────
+        let newCycles = [];
+        if (checkCycles) {
+            const allEdges = getAllDepEdges(db, repoId);
+            newCycles = detectCyclesAfterMove(allEdges, normalizedFilePath, normalizedNewFilePath);
+        }
+        const wouldIntroduceCycles = newCycles.length > 0;
+        // ── 4. Verdict ────────────────────────────────────────────────────────────
+        const safe = !wouldIntroduceCycles;
+        let verdict;
+        if (safe) {
+            const count = importUpdates.length;
+            if (count === 0) {
+                verdict = 'Safe to move: no importers found. No import statements need updating.';
+            }
+            else {
+                verdict =
+                    `Safe to move: ${count} import statement${count !== 1 ? 's' : ''} will need updating across ` +
+                        `${new Set(importUpdates.map((u) => u.importerFilePath)).size} file${importUpdates.length !== 1 ? 's' : ''}. No cycles.`;
+            }
+        }
+        else {
+            verdict =
+                `Move introduces ${newCycles.length} import cycle${newCycles.length !== 1 ? 's' : ''} at the new location. ` +
+                    `${importUpdates.length} import statement${importUpdates.length !== 1 ? 's' : ''} also need updating.`;
+        }
+        const responseText = JSON.stringify({ importUpdates, newCycles });
+        const output = {
+            safe,
+            verdict,
+            filePath: normalizedFilePath,
+            newFilePath: normalizedNewFilePath,
+            importUpdates,
+            importUpdateCount: importUpdates.length,
+            newCycles,
+            wouldIntroduceCycles,
+            _tokenEstimate: Math.ceil(responseText.length / 4),
+            _meta: buildMeta({ timingMs: Date.now() - t0 }),
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(output, null, 2) }] };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=check-move-safe.js.map

package/dist/server/tools/check-move-safe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-move-safe.js","sourceRoot":"","sources":["../../../src/server/tools/check-move-safe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAKvC,MAAM,CAAC,MAAM,IAAI,GAAG,iBAAiB,CAAC;AAEtC,MAAM,CAAC,MAAM,WAAW,GACtB,+EAA+E;IAC/E,gFAAgF;IAChF,0BAA0B;IAC1B,uFAAuF;IACvF,sFAAsF;IACtF,gFAAgF,CAAC;AAEnF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACxE,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,wEAAwE,CAAC;IACrF,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,CAAC,2EAA2E,CAAC;IACxF,WAAW,EAAE,CAAC;SACX,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,yEAAyE;QACzE,oDAAoD,CACrD;CACJ,CAAC;AAwBF,iFAAiF;AAEjF,oDAAoD;AACpD,SAAS,YAAY,CAAC,CAAS;IAC7B,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAS,oBAAoB,CAC3B,gBAAwB,EACxB,aAAqB,EACrB,gBAAwB;IAExB,MAAM,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAEnG,yDAAyD;IACzD,MAAM,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,WAAW,EAAE,CAAC;IAEpF,uDAAuD;IACvD,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC/B,iEAAiE;QACjE,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QAChC,OAAO,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IAC7D,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,+EAA+E;AAC/E,SAAS,cAAc,CAAC,OAAsB,EAAE,SAAiB;IAC/D,IAAI,CAAC,OAAO;QAAE,OAAO,CAAC,CAAC;IACvB,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,4DAA4D;IAC5D,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACjE,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,SAAS,OAAO,QAAQ,CAAC,CAAC;IAEhD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CACnB,EAAqB,EACrB,MAAc,EACd,YAAoB,EACpB,UAAkB;IAElB,MAAM,GAAG,GAAG,EAAE;SACX,OAAO,CACN;;eAES,CACV;SACA,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;IACzC,OAAO,GAAG,EAAE,SAAS,IAAI,EAAE,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,SAAS,qBAAqB,CAC5B,KAAgB,EAChB,OAAe,EACf,OAAe,EACf,SAAS,GAAG,EAAE;IAEd,uDAAuD;IACvD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAoB,CAAC;IAExC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,UAAU;YAAE,SAAS;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;QACpE,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;QACpE,IAAI,GAAG,KAAK,GAAG;YAAE,SAAS;QAE1B,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9C,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACtB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE;QAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAEvC,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAG,SAAS,GAAG,CAAC,CAAC;IAC1B,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAErC,SAAS,GAAG,CAAC,KAAa,EAAE,IAAc,EAAE,OAAoB;QAC9D,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG;YAAE,OAAO;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;YACtC,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG;gBAAE,OAAO;YAChC,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACvC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;YACxB,CAAC;iBAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;gBAC9C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAClB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAChB,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;gBAC1B,IAAI,CAAC,GAAG,EAAE,CAAC;gBACX,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG;YAAE,MAAM;QAC/B,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,4EAA4E;IAC5E,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;AACtE,CAAC;AAED,iFAAiF;AAEjF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAK7B;IACC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;IAEnE,kEAAkE;IAClE,MAAM,kBAAkB,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,qBAAqB,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IAExD,IAAI,kBAAkB,KAAK,qBAAqB,EAAE,CAAC;QACjD,MAAM,MAAM,GAAwB;YAClC,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,kEAAkE;YAC3E,QAAQ,EAAE,kBAAkB;YAC5B,WAAW,EAAE,qBAAqB;YAClC,aAAa,EAAE,EAAE;YACjB,iBAAiB,EAAE,CAAC;YACpB,SAAS,EAAE,EAAE;YACb,oBAAoB,EAAE,KAAK;YAC3B,cAAc,EAAE,CAAC;YACjB,KAAK,EAAE,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC;SAChD,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAChF,CAAC;IAED,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAEhC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,SAAS,MAAM,sCAAsC;yBAC7D,CAAC;qBACH;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,6EAA6E;QAE7E,MAAM,aAAa,GAAG,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC;QAErE,6EAA6E;QAE7E,MAAM,aAAa,GAAmB,EAAE,CAAC;QAEzC,KAAK,MAAM,gBAAgB,IAAI,aAAa,EAAE,CAAC;YAC7C,MAAM,SAAS,GAAG,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;YACjF,IAAI,CAAC,SAAS;gBAAE,SAAS,CAAC,gCAAgC;YAE1D,MAAM,aAAa,GAAG,oBAAoB,CACxC,gBAAgB,EAChB,qBAAqB,EACrB,SAAS,CACV,CAAC;YAEF,MAAM,OAAO,GAAG,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;YAC7D,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAEhD,aAAa,CAAC,IAAI,CAAC;gBACjB,gBAAgB;gBAChB,iBAAiB,EAAE,SAAS;gBAC5B,aAAa;gBACb,IAAI;aACL,CAAC,CAAC;QACL,CAAC;QAED,iDAAiD;QACjD,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAEnF,6EAA6E;QAE7E,IAAI,SAAS,GAAe,EAAE,CAAC;QAE/B,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,QAAQ,GAAG,cAAc,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAC5C,SAAS,GAAG,qBAAqB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,qBAAqB,CAAC,CAAC;QACzF,CAAC;QAED,MAAM,oBAAoB,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;QAElD,6EAA6E;QAE7E,MAAM,IAAI,GAAG,CAAC,oBAAoB,CAAC;QAEnC,IAAI,OAAe,CAAC;QACpB,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC;YACnC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBAChB,OAAO,GAAG,uEAAuE,CAAC;YACpF,CAAC;iBAAM,CAAC;gBACN,OAAO;oBACL,iBAAiB,KAAK,oBAAoB,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,6BAA6B;wBAC7F,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,QAAQ,aAAa,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC;YAC7H,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO;gBACL,mBAAmB,SAAS,CAAC,MAAM,gBAAgB,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,wBAAwB;oBAC5G,GAAG,aAAa,CAAC,MAAM,oBAAoB,aAAa,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,sBAAsB,CAAC;QAC3G,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC;QAClE,MAAM,MAAM,GAAwB;YAClC,IAAI;YACJ,OAAO;YACP,QAAQ,EAAE,kBAAkB;YAC5B,WAAW,EAAE,qBAAqB;YAClC,aAAa;YACb,iBAAiB,EAAE,aAAa,CAAC,MAAM;YACvC,SAAS;YACT,oBAAoB;YACpB,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;YAClD,KAAK,EAAE,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC;SAChD,CAAC;QAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAChF,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/server/tools/check-rename-safe.d.ts

@@ -0,0 +1,48 @@
+/**
+ * check-rename-safe.ts
+ *
+ * MCP tool: check_rename_safe
+ *
+ * Pre-flight check for renaming a symbol. Returns a binary verdict, all
+ * affected files, and the specific lines that will need updating — so an
+ * agent can decide whether to proceed without manually inspecting raw
+ * reference lists.
+ *
+ * Safety rules:
+ *   safe: false  — if conflicts exist (newName already present in the same file)
+ *   safe: false  — if any reference is a string-literal (runtime string that
+ *                  won't be fixed by a text rename, requires human judgment)
+ *   safe: true   — all other cases (comment references are included but not
+ *                  blockers)
+ *
+ * changeType detection (in priority order):
+ *   'comment'        — line starts with // or * (JSDoc)
+ *   'import'         — line contains the `import` keyword
+ *   'string-literal' — symbol name appears inside quote characters
+ *   'type-reference' — line contains `type` or `interface` keyword
+ *   'call'           — default
+ */
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const name = "check_rename_safe";
+export declare const description: string;
+export declare const inputSchema: {
+    repoId: z.ZodString;
+    symbolId: z.ZodString;
+    newName: z.ZodString;
+    checkConflicts: z.ZodOptional<z.ZodBoolean>;
+};
+export interface AffectedSite {
+    filePath: string;
+    line: number;
+    column: number;
+    context: string;
+    changeType: 'call' | 'import' | 'type-reference' | 'string-literal' | 'comment';
+}
+export declare function handler(args: {
+    repoId: string;
+    symbolId: string;
+    newName: string;
+    checkConflicts?: boolean;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=check-rename-safe.d.ts.map

package/dist/server/tools/check-rename-safe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-rename-safe.d.ts","sourceRoot":"","sources":["../../../src/server/tools/check-rename-safe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,IAAI,sBAAsB,CAAC;AAExC,eAAO,MAAM,WAAW,QAK0B,CAAC;AAEnD,eAAO,MAAM,WAAW;;;;;CAWvB,CAAC;AAIF,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,SAAS,CAAC;CACjF;AAyDD,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG,OAAO,CAAC,cAAc,CAAC,CA6J1B"}

package/dist/server/tools/check-rename-safe.js

@@ -0,0 +1,218 @@
+/**
+ * check-rename-safe.ts
+ *
+ * MCP tool: check_rename_safe
+ *
+ * Pre-flight check for renaming a symbol. Returns a binary verdict, all
+ * affected files, and the specific lines that will need updating — so an
+ * agent can decide whether to proceed without manually inspecting raw
+ * reference lists.
+ *
+ * Safety rules:
+ *   safe: false  — if conflicts exist (newName already present in the same file)
+ *   safe: false  — if any reference is a string-literal (runtime string that
+ *                  won't be fixed by a text rename, requires human judgment)
+ *   safe: true   — all other cases (comment references are included but not
+ *                  blockers)
+ *
+ * changeType detection (in priority order):
+ *   'comment'        — line starts with // or * (JSDoc)
+ *   'import'         — line contains the `import` keyword
+ *   'string-literal' — symbol name appears inside quote characters
+ *   'type-reference' — line contains `type` or `interface` keyword
+ *   'call'           — default
+ */
+import { z } from 'zod';
+import { openDatabase, getRepo } from '../../core/db/schema.js';
+import { getSymbolById } from '../../core/db/symbol-store.js';
+import { getAllFilesWithContent } from '../../core/db/file-store.js';
+import { buildMeta } from './_meta.js';
+export const name = 'check_rename_safe';
+export const description = 'Pre-flight check for renaming a symbol. Returns a verdict, all affected files, ' +
+    'and the specific lines that will need updating. ' +
+    'safe: false when the new name conflicts with an existing symbol or when string-literal ' +
+    'references exist that require manual updates. ' +
+    'Use search_symbols to find the symbolId first.';
+export const inputSchema = {
+    repoId: z.string().describe('Repo ID from index_folder or resolve_repo'),
+    symbolId: z.string().describe('Symbol ID of the symbol to rename'),
+    newName: z.string().min(1).describe('Proposed new name for the symbol'),
+    checkConflicts: z
+        .boolean()
+        .optional()
+        .describe('Check if newName already exists in the same file (default true). ' +
+        'Set false to skip conflict detection for speed.'),
+};
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Classify a reference line into a change type.
+ * Checked in priority order so that the most specific match wins.
+ */
+function detectChangeType(lineContent, symbolName) {
+    const trimmed = lineContent.trim();
+    // Comment: line starts with // or * (JSDoc block) or /*
+    if (/^(\/\/|\*|\/\*)/.test(trimmed)) {
+        return 'comment';
+    }
+    // Import statement
+    if (/\bimport\b/.test(trimmed)) {
+        return 'import';
+    }
+    // String literal: symbol name appears inside quote characters
+    const escaped = escapeRegex(symbolName);
+    if (new RegExp(`['"\`][^'"\`]*\\b${escaped}\\b[^'"\`]*['"\`]`).test(trimmed)) {
+        return 'string-literal';
+    }
+    // Type reference: `type` or `interface` keyword on this line
+    if (/\btype\b/.test(trimmed) || /\binterface\b/.test(trimmed)) {
+        return 'type-reference';
+    }
+    // Default: call / variable usage
+    return 'call';
+}
+// ─── Handler ──────────────────────────────────────────────────────────────────
+export async function handler(args) {
+    const t0 = Date.now();
+    const { repoId, symbolId, newName, checkConflicts = true } = args;
+    const db = openDatabase(repoId);
+    try {
+        const repo = getRepo(db, repoId);
+        if (!repo) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Repo "${repoId}" not found. Run index_folder first.`,
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const symbol = getSymbolById(db, repoId, symbolId);
+        if (!symbol) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Symbol "${symbolId}" not found in repo "${repoId}".`,
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // No-op: renaming to the same name is always safe
+        if (symbol.name === newName) {
+            const output = {
+                safe: true,
+                verdict: `Safe to rename: new name is the same as the current name (no-op).`,
+                symbolName: symbol.name,
+                newName,
+                conflicts: [],
+                affectedSites: [],
+                affectedFileCount: 0,
+                _tokenEstimate: 0,
+                _meta: buildMeta({ timingMs: Date.now() - t0 }),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(output, null, 2) }] };
+        }
+        // ── 1. Find all references ────────────────────────────────────────────────
+        const affectedSites = [];
+        const pattern = new RegExp(`\\b${escapeRegex(symbol.name)}\\b`);
+        // Definition file is excluded from reference scan (we don't list the
+        // declaration itself as an affected site — only call/import sites)
+        const definitionFile = symbol.filePath;
+        const files = getAllFilesWithContent(db, repoId);
+        for (const { path, rawContent } of files) {
+            if (!rawContent)
+                continue;
+            if (path === definitionFile)
+                continue;
+            const text = rawContent.toString('utf8');
+            const lines = text.split('\n');
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                if (!pattern.test(line))
+                    continue;
+                const match = pattern.exec(line);
+                const column = match ? match.index + 1 : 1; // 1-based
+                affectedSites.push({
+                    filePath: path,
+                    line: i + 1,
+                    column,
+                    context: line.length > 120 ? line.slice(0, 120) : line,
+                    changeType: detectChangeType(line, symbol.name),
+                });
+            }
+        }
+        // ── 2. Conflict detection ─────────────────────────────────────────────────
+        const conflicts = [];
+        if (checkConflicts) {
+            // Look for any symbol with newName in the same file as the declaration
+            const conflictRows = db
+                .prepare(`SELECT name, file_path, kind FROM symbols
+           WHERE repo_id = ? AND name = ? AND file_path = ?`)
+                .all(repoId, newName, definitionFile);
+            for (const row of conflictRows) {
+                conflicts.push(`${row.name} (${row.kind}) in ${row.file_path}`);
+            }
+        }
+        // ── 3. Compute verdict ────────────────────────────────────────────────────
+        const hasStringLiterals = affectedSites.some((s) => s.changeType === 'string-literal');
+        const safe = conflicts.length === 0 && !hasStringLiterals;
+        const uniqueFiles = new Set(affectedSites.map((s) => s.filePath));
+        const affectedFileCount = uniqueFiles.size;
+        const callCount = affectedSites.filter((s) => s.changeType === 'call').length;
+        const importCount = affectedSites.filter((s) => s.changeType === 'import').length;
+        const stringLitCount = affectedSites.filter((s) => s.changeType === 'string-literal').length;
+        const commentCount = affectedSites.filter((s) => s.changeType === 'comment').length;
+        const typeRefCount = affectedSites.filter((s) => s.changeType === 'type-reference').length;
+        let verdict;
+        if (!safe) {
+            const reasons = [];
+            if (conflicts.length > 0) {
+                reasons.push(`"${newName}" conflicts with an existing symbol`);
+            }
+            if (hasStringLiterals) {
+                reasons.push(`${stringLitCount} string-literal reference(s) require manual update`);
+            }
+            verdict = `Not safe to rename: ${reasons.join('; ')}. ${affectedFileCount} file(s) affected.`;
+        }
+        else {
+            const breakdown = [];
+            if (callCount > 0)
+                breakdown.push(`${callCount} call site${callCount > 1 ? 's' : ''}`);
+            if (importCount > 0)
+                breakdown.push(`${importCount} import${importCount > 1 ? 's' : ''}`);
+            if (typeRefCount > 0)
+                breakdown.push(`${typeRefCount} type reference${typeRefCount > 1 ? 's' : ''}`);
+            if (commentCount > 0)
+                breakdown.push(`${commentCount} comment${commentCount > 1 ? 's' : ''}`);
+            const detail = breakdown.length > 0 ? ` (${breakdown.join(', ')})` : '';
+            verdict = `Safe to rename: ${affectedFileCount} file${affectedFileCount !== 1 ? 's' : ''} affected${detail}. No conflicts.`;
+        }
+        const responseText = JSON.stringify(affectedSites);
+        const output = {
+            safe,
+            verdict,
+            symbolName: symbol.name,
+            newName,
+            conflicts,
+            affectedSites,
+            affectedFileCount,
+            _tokenEstimate: Math.ceil(responseText.length / 4),
+            _meta: buildMeta({ timingMs: Date.now() - t0 }),
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(output, null, 2) }] };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=check-rename-safe.js.map

package/dist/server/tools/check-rename-safe.js.map

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

package/dist/server/tools/diff-health-radar.d.ts

@@ -0,0 +1,44 @@
+/**
+ * diff-health-radar.ts
+ *
+ * MCP tool: diff_health_radar
+ *
+ * Compare health radar scores between two indexed repos (or two states of the
+ * same codebase). Primary use cases:
+ *
+ *   • PR review: index main branch → index feature branch → compare
+ *   • Refactoring validation: index before → refactor → re-index → compare
+ *   • Cross-repo benchmark: compare health of two different projects
+ *
+ * Runs health_radar on both repos, then computes per-axis deltas (head − base).
+ * Positive delta = improvement; negative delta = regression.
+ *
+ * Output:
+ *   • base snapshot — health scores from baseRepoId
+ *   • head snapshot — health scores from headRepoId
+ *   • axes delta map — score change per axis with trend label
+ *   • overallDelta — change in overall health (head − base)
+ *   • trend — 'improved' | 'degraded' | 'stable' (based on overallDelta)
+ *   • regressions — axis names that degraded by > SIGNIFICANT_DELTA
+ *   • improvements — axis names that improved by > SIGNIFICANT_DELTA
+ *
+ * A delta of +5 or more is treated as a meaningful improvement.
+ * A delta of −5 or more (negative) is treated as a meaningful regression.
+ */
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const name = "diff_health_radar";
+export declare const description: string;
+export declare const inputSchema: {
+    baseRepoId: z.ZodString;
+    headRepoId: z.ZodString;
+    scope: z.ZodOptional<z.ZodString>;
+    includeStability: z.ZodOptional<z.ZodBoolean>;
+};
+export declare function handler(args: {
+    baseRepoId: string;
+    headRepoId: string;
+    scope?: string;
+    includeStability?: boolean;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=diff-health-radar.d.ts.map