@mohantn/gate-keeper 2.1.0

package/dist/cache/sqlite-cache.js.map

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

package/dist/cli/query-repl.d.ts

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+/**
+ * --query interactive REPL mode
+ *
+ * Starts a readline loop accepting natural language queries against the loaded
+ * dependency graph.
+ *
+ * Usage:
+ *   npx tsx src/cli/query-repl.ts [--repo /path/to/repo]
+ *
+ * Queries are dispatched through the same deterministic pattern matcher used by
+ * the MCP `query_graph` tool — no LLM involved, purely graph-algorithm answers.
+ *
+ * Commands:
+ *   query text    — ask about the graph (god nodes, surprising connections, etc.)
+ *   explain path  — get detailed explanation of a file
+ *   path src dst  — shortest dependency path between two files
+ *   help          — show available query patterns
+ *   quit / exit   — leave the REPL
+ */
+import { ReplGraph } from './repl-algorithms';
+type GraphData = ReplGraph;
+export declare const QUERY_PATTERNS: Array<{
+    name: string;
+    desc: string;
+    match: RegExp;
+    handler: (m: RegExpExecArray, graph: GraphData, repo: string) => string;
+}>;
+export declare function handleExplain(target: string, graph: GraphData, repo: string): void;
+export declare function handlePath(parts: string[], graph: GraphData, repo: string): void;
+/**
+ * Exported for use by the daemon's --query mode.
+ * Loads the graph from the running daemon, then starts the REPL.
+ */
+export declare function startRepl(repo: string): Promise<void>;
+export {};
+//# sourceMappingURL=query-repl.d.ts.map

package/dist/cli/query-repl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-repl.d.ts","sourceRoot":"","sources":["../../src/cli/query-repl.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,EACL,SAAS,EAEV,MAAM,mBAAmB,CAAC;AA4B3B,KAAK,SAAS,GAAG,SAAS,CAAC;AAI3B,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACzE,CA+CA,CAAC;AAeF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAmBlF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAuBhF;AA0FD;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG3D"}

package/dist/cli/query-repl.js

@@ -0,0 +1,298 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * --query interactive REPL mode
+ *
+ * Starts a readline loop accepting natural language queries against the loaded
+ * dependency graph.
+ *
+ * Usage:
+ *   npx tsx src/cli/query-repl.ts [--repo /path/to/repo]
+ *
+ * Queries are dispatched through the same deterministic pattern matcher used by
+ * the MCP `query_graph` tool — no LLM involved, purely graph-algorithm answers.
+ *
+ * Commands:
+ *   query text    — ask about the graph (god nodes, surprising connections, etc.)
+ *   explain path  — get detailed explanation of a file
+ *   path src dst  — shortest dependency path between two files
+ *   help          — show available query patterns
+ *   quit / exit   — leave the REPL
+ */
+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.QUERY_PATTERNS = void 0;
+exports.handleExplain = handleExplain;
+exports.handlePath = handlePath;
+exports.startRepl = startRepl;
+const http = __importStar(require("http"));
+const path = __importStar(require("path"));
+const readline = __importStar(require("readline"));
+const child_process_1 = require("child_process");
+const repl_algorithms_1 = require("./repl-algorithms");
+const DAEMON_PORT = 5378;
+// ── Helpers ────────────────────────────────────────────────
+function fetchApi(urlPath) {
+    return new Promise((resolve) => {
+        const req = http.get(`http://127.0.0.1:${DAEMON_PORT}${urlPath}`, { timeout: 5000 }, (res) => {
+            let body = '';
+            res.on('data', (chunk) => { body += chunk; });
+            res.on('end', () => {
+                try {
+                    resolve(JSON.parse(body));
+                }
+                catch {
+                    resolve(null);
+                }
+            });
+        });
+        req.on('error', () => resolve(null));
+        req.on('timeout', () => { req.destroy(); resolve(null); });
+    });
+}
+function findGitRoot(dir) {
+    const result = (0, child_process_1.spawnSync)('git', ['rev-parse', '--show-toplevel'], {
+        cwd: dir, encoding: 'utf8', timeout: 3000,
+    });
+    return result.status === 0 && result.stdout.trim() ? result.stdout.trim() : dir;
+}
+// ── REPL query patterns ────────────────────────────────────
+exports.QUERY_PATTERNS = [
+    {
+        name: 'god nodes',
+        desc: 'most-connected files (highest blast radius)',
+        match: /god|hotspot|central|blast|connected/i,
+        handler: (_, graph, repo) => {
+            const ranked = (0, repl_algorithms_1.computeDegreeCentrality)(graph).slice(0, 8);
+            return ranked.length === 0 ? 'No files in graph.' :
+                ranked.map((n, i) => `${i + 1}. ${path.relative(repo, n.path)} — ${n.totalDegree} connections, rating ${n.rating}/10`).join('\n');
+        },
+    },
+    {
+        name: 'surprising',
+        desc: 'cross-module dependencies',
+        match: /surprising|unexpected|cross|strange/i,
+        handler: (_, graph, repo) => {
+            const s = (0, repl_algorithms_1.findSurprising)(graph, repo, 5);
+            if (s.length === 0)
+                return 'No surprising cross-module connections found.';
+            return s.map((c, i) => `${i + 1}. ${path.relative(repo, c.src)} → ${path.relative(repo, c.dst)} (${c.S} → ${c.T})`).join('\n');
+        },
+    },
+    {
+        name: 'questions / suggestions',
+        desc: 'auto-generated questions about the codebase',
+        match: /question|suggest|recommend/i,
+        handler: (_, graph, repo) => {
+            const qs = (0, repl_algorithms_1.suggestQuestions)(graph, repo);
+            return qs.map((q, i) => `${i + 1}. ${q}`).join('\n');
+        },
+    },
+    {
+        name: 'health / quality',
+        desc: 'worst-rated files and overall quality',
+        match: /health|quality|worst|bad|poor|rating/i,
+        handler: (_, graph) => {
+            if (graph.nodes.length === 0)
+                return 'No files in graph.';
+            const avg = graph.nodes.reduce((s, n) => s + n.rating, 0) / graph.nodes.length;
+            const worst = [...graph.nodes].sort((a, b) => a.rating - b.rating).slice(0, 5);
+            const lines = [`Overall: ${graph.nodes.length} files, avg rating ${avg.toFixed(1)}/10`];
+            for (const n of worst) {
+                const errors = n.violations.filter(v => v.severity === 'error').length;
+                const warnings = n.violations.filter(v => v.severity === 'warning').length;
+                lines.push(`  ${n.rating}/10 — ${n.label} (${errors} errors, ${warnings} warnings)`);
+            }
+            return lines.join('\n');
+        },
+    },
+];
+// ── REPL command helpers ───────────────────────────────────
+function printHelp() {
+    process.stdout.write('\n  Natural language queries:\n');
+    for (const p of exports.QUERY_PATTERNS)
+        process.stdout.write(`    ${p.desc}\n`);
+    process.stdout.write('  Commands:\n');
+    process.stdout.write('    explain <file>  — detailed file explanation\n');
+    process.stdout.write('    path <a> <b>    — shortest dependency path\n');
+    process.stdout.write('    refresh         — reload the graph from the daemon\n');
+    process.stdout.write('    help            — this message\n');
+    process.stdout.write('    quit / exit     — leave the REPL\n\n');
+}
+function handleExplain(target, graph, repo) {
+    if (!target) {
+        process.stdout.write('No file specified.\n');
+        return;
+    }
+    const match = graph.nodes.find(n => n.id.toLowerCase().includes(target.toLowerCase()) ||
+        n.label.toLowerCase().includes(target.toLowerCase()));
+    if (!match) {
+        process.stdout.write(`No file matching "${target}" found in graph.\n`);
+        return;
+    }
+    const rel = path.relative(repo, match.id);
+    const errors = match.violations.filter(v => v.severity === 'error').length;
+    const warnings = match.violations.filter(v => v.severity === 'warning').length;
+    process.stdout.write(`\n  ${rel}\n`);
+    process.stdout.write(`  Rating: ${match.rating}/10 | LOC: ${match.metrics.linesOfCode} | Complexity: ${match.metrics.cyclomaticComplexity}\n`);
+    process.stdout.write(`  Imports: ${match.metrics.importCount} | Errors: ${errors} | Warnings: ${warnings}\n`);
+}
+function handlePath(parts, graph, repo) {
+    if (parts.length < 2) {
+        process.stdout.write('Usage: path <source-file> <target-file>\n');
+        return;
+    }
+    const a = parts[0];
+    const b = parts[1];
+    const src = graph.nodes.find(n => n.label.includes(a) || n.id.includes(a));
+    const dst = graph.nodes.find(n => n.label.includes(b) || n.id.includes(b));
+    if (!src || !dst) {
+        process.stdout.write(`Could not find matching files. Try: ${graph.nodes.slice(0, 10).map(n => n.label).join(', ')}\n`);
+        return;
+    }
+    process.stdout.write(`Path from ${path.relative(repo, src.id)} to ${path.relative(repo, dst.id)}:\n`);
+    const found = (0, repl_algorithms_1.findPath)(src.id, dst.id, graph.edges);
+    if (found) {
+        for (const f of found) {
+            const n = graph.nodes.find(node => node.id === f);
+            process.stdout.write(`  ${path.relative(repo, f)} (${n?.rating ?? '?'})\n`);
+        }
+    }
+    else {
+        process.stdout.write('  No dependency path found between these files.\n');
+    }
+}
+// ── Core REPL loop (shared by main() and startRepl()) ─────
+async function runRepl(repo, graph) {
+    const repoName = path.basename(repo);
+    process.stdout.write(`\n  ⬡ Gate Keeper Query REPL — ${repoName}\n`);
+    process.stdout.write(`  ${graph.nodes.length} files, ${graph.edges.length} edges\n\n`);
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        prompt: 'gk> ',
+    });
+    rl.prompt();
+    rl.on('line', async (line) => {
+        const trimmed = line.trim();
+        if (!trimmed) {
+            rl.prompt();
+            return;
+        }
+        if (trimmed === 'quit' || trimmed === 'exit') {
+            rl.close();
+            return;
+        }
+        if (trimmed === 'help') {
+            printHelp();
+            rl.prompt();
+            return;
+        }
+        if (trimmed === 'refresh') {
+            const freshRaw = await fetchApi(`/api/graph?repo=${encodeURIComponent(repo)}`);
+            if (freshRaw) {
+                Object.assign(graph, freshRaw);
+                process.stdout.write(`Refreshed: ${graph.nodes.length} files, ${graph.edges.length} edges\n`);
+            }
+            else {
+                process.stdout.write('Refresh failed — daemon may be unavailable\n');
+            }
+            rl.prompt();
+            return;
+        }
+        if (trimmed.startsWith('explain ')) {
+            handleExplain(trimmed.slice(8).trim(), graph, repo);
+            rl.prompt();
+            return;
+        }
+        if (trimmed.startsWith('path ')) {
+            handlePath(trimmed.slice(5).trim().split(/\s+/), graph, repo);
+            rl.prompt();
+            return;
+        }
+        let answered = false;
+        for (const p of exports.QUERY_PATTERNS) {
+            if (p.match.test(trimmed)) {
+                const m = p.match.exec(trimmed);
+                if (m) {
+                    process.stdout.write(p.handler(m, graph, repo) + '\n');
+                    answered = true;
+                }
+                break;
+            }
+        }
+        if (!answered) {
+            process.stdout.write('Query not recognised. Try: "god nodes", "surprising connections", "health", "suggest questions", or type "help".\n');
+        }
+        rl.prompt();
+    });
+    rl.on('close', () => {
+        process.stdout.write('\nGoodbye.\n');
+        process.exit(0);
+    });
+}
+async function loadGraph(repo, startupHint) {
+    const graphRaw = await fetchApi(`/api/graph?repo=${encodeURIComponent(repo)}`);
+    if (!graphRaw) {
+        process.stderr.write('Error: Cannot connect to Gate Keeper daemon on port 5378.\n');
+        process.stderr.write(`${startupHint}\n`);
+        process.exit(1);
+    }
+    return graphRaw;
+}
+// ── Public entry points ────────────────────────────────────
+/**
+ * Exported for use by the daemon's --query mode.
+ * Loads the graph from the running daemon, then starts the REPL.
+ */
+async function startRepl(repo) {
+    const graph = await loadGraph(repo, 'Start the daemon first: npm run dev  (from the gate-keeper directory)');
+    await runRepl(repo, graph);
+}
+async function main() {
+    const args = process.argv.slice(2);
+    const repoIndex = args.indexOf('--repo');
+    const repoArg = repoIndex >= 0 ? args[repoIndex + 1] : undefined;
+    const repo = repoArg ?? findGitRoot(process.cwd());
+    const graph = await loadGraph(repo, 'Start it with: npm run dev  (from the gate-keeper directory)');
+    await runRepl(repo, graph);
+}
+if (require.main === module) {
+    main().catch(err => {
+        process.stderr.write(String(err) + '\n');
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=query-repl.js.map

package/dist/cli/query-repl.js.map

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

package/dist/cli/repl-algorithms.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Pure graph-algorithm functions used by the query REPL.
+ * No I/O — all functions take graph data and return results.
+ */
+export interface ReplGraphNode {
+    id: string;
+    label: string;
+    rating: number;
+    metrics: {
+        linesOfCode: number;
+        importCount: number;
+        cyclomaticComplexity: number;
+    };
+    violations: Array<{
+        type: string;
+        severity: string;
+    }>;
+}
+export interface ReplGraphEdge {
+    source: string;
+    target: string;
+    type: string;
+    strength: number;
+}
+export interface ReplGraph {
+    nodes: ReplGraphNode[];
+    edges: ReplGraphEdge[];
+}
+export interface CentralityEntry {
+    path: string;
+    label: string;
+    rating: number;
+    inDegree: number;
+    outDegree: number;
+    totalDegree: number;
+}
+export interface SurprisingConnection {
+    src: string;
+    dst: string;
+    S: string;
+    T: string;
+    score: number;
+}
+export declare function getModule(filePath: string, repoRoot: string): string;
+export declare function computeDegreeCentrality(graph: ReplGraph): CentralityEntry[];
+export declare function findSurprising(graph: ReplGraph, repo: string, topN?: number): SurprisingConnection[];
+export declare function suggestQuestions(graph: ReplGraph, repo: string): string[];
+export declare function findPath(startId: string, endId: string, edges: ReplGraphEdge[]): string[] | null;
+//# sourceMappingURL=repl-algorithms.d.ts.map

package/dist/cli/repl-algorithms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl-algorithms.d.ts","sourceRoot":"","sources":["../../src/cli/repl-algorithms.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,oBAAoB,EAAE,MAAM,CAAA;KAAE,CAAC;IACpF,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf;AAID,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMpE;AAID,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,GAAG,eAAe,EAAE,CAc3E;AAID,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,oBAAoB,EAAE,CAiC/F;AAID,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAezE;AAID,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,GAAG,IAAI,CAchG"}

package/dist/cli/repl-algorithms.js

@@ -0,0 +1,147 @@
+"use strict";
+/**
+ * Pure graph-algorithm functions used by the query REPL.
+ * No I/O — all functions take graph data and return results.
+ */
+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.getModule = getModule;
+exports.computeDegreeCentrality = computeDegreeCentrality;
+exports.findSurprising = findSurprising;
+exports.suggestQuestions = suggestQuestions;
+exports.findPath = findPath;
+const path = __importStar(require("path"));
+// ── Module detection ───────────────────────────────────────
+function getModule(filePath, repoRoot) {
+    const rel = path.relative(repoRoot, filePath);
+    const parts = rel.split(path.sep).filter(Boolean);
+    if (parts.length <= 1)
+        return '(root)';
+    if (['src', 'lib', 'app'].includes(parts[0]) && parts.length > 2)
+        return parts[1];
+    return parts[0];
+}
+// ── Degree centrality ──────────────────────────────────────
+function computeDegreeCentrality(graph) {
+    const inDeg = new Map();
+    const outDeg = new Map();
+    for (const n of graph.nodes) {
+        inDeg.set(n.id, 0);
+        outDeg.set(n.id, 0);
+    }
+    for (const e of graph.edges) {
+        outDeg.set(e.source, (outDeg.get(e.source) ?? 0) + 1);
+        inDeg.set(e.target, (inDeg.get(e.target) ?? 0) + 1);
+    }
+    return graph.nodes.map(n => ({
+        path: n.id, label: n.label, rating: n.rating,
+        inDegree: inDeg.get(n.id) ?? 0,
+        outDegree: outDeg.get(n.id) ?? 0,
+        totalDegree: (inDeg.get(n.id) ?? 0) + (outDeg.get(n.id) ?? 0),
+    })).sort((a, b) => b.totalDegree - a.totalDegree);
+}
+// ── Surprising cross-module connections ────────────────────
+function findSurprising(graph, repo, topN = 5) {
+    const nodeIds = new Set(graph.nodes.map(n => n.id));
+    const moduleOf = new Map();
+    for (const n of graph.nodes)
+        moduleOf.set(n.id, getModule(n.id, repo));
+    const pairCounts = new Map();
+    for (const e of graph.edges) {
+        if (!nodeIds.has(e.source) || !nodeIds.has(e.target))
+            continue;
+        const sm = moduleOf.get(e.source) ?? '(?)';
+        const tm = moduleOf.get(e.target) ?? '(?)';
+        if (sm !== tm) {
+            const key = `${sm}→${tm}`;
+            pairCounts.set(key, (pairCounts.get(key) ?? 0) + 1);
+        }
+    }
+    const results = [];
+    for (const e of graph.edges) {
+        if (!nodeIds.has(e.source) || !nodeIds.has(e.target))
+            continue;
+        const sm = moduleOf.get(e.source) ?? '(?)';
+        const tm = moduleOf.get(e.target) ?? '(?)';
+        if (sm === tm)
+            continue;
+        const pairCount = pairCounts.get(`${sm}→${tm}`) ?? 1;
+        results.push({ src: e.source, dst: e.target, S: sm, T: tm, score: 1 / Math.log(pairCount + 1) });
+    }
+    const seen = new Set();
+    return results.sort((a, b) => b.score - a.score).filter(r => {
+        const k = `${r.src}|${r.dst}`;
+        if (seen.has(k))
+            return false;
+        seen.add(k);
+        return true;
+    }).slice(0, topN);
+}
+// ── Suggested questions ────────────────────────────────────
+function suggestQuestions(graph, repo) {
+    const centrality = computeDegreeCentrality(graph);
+    const top = centrality.slice(0, 3);
+    const worst = [...graph.nodes].sort((a, b) => a.rating - b.rating)[0];
+    const qs = [];
+    for (const god of top) {
+        qs.push(`What would break if "${path.relative(repo, god.path)}" changed?`);
+    }
+    if (worst && top[0] && worst.id !== top[0].path) {
+        qs.push(`How does "${path.relative(repo, top[0].path)}" connect to "${path.relative(repo, worst.id)}" (worst-rated file)?`);
+    }
+    if (worst && worst.rating < 7) {
+        qs.push(`What's wrong with "${path.relative(repo, worst.id)}" (rating ${worst.rating}/10)?`);
+    }
+    return qs;
+}
+// ── BFS path finding ───────────────────────────────────────
+function findPath(startId, endId, edges) {
+    const queue = [{ id: startId, trail: [startId] }];
+    const visited = new Set([startId]);
+    while (queue.length > 0) {
+        const node = queue.shift();
+        for (const edge of edges) {
+            if (edge.source !== node.id || visited.has(edge.target))
+                continue;
+            const trail = [...node.trail, edge.target];
+            if (edge.target === endId)
+                return trail;
+            visited.add(edge.target);
+            queue.push({ id: edge.target, trail });
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=repl-algorithms.js.map

package/dist/cli/repl-algorithms.js.map

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

package/dist/cli/setup-core.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Core setup logic — pure installation functions used by the `setup` CLI command.
+ *
+ * Each function returns a SetupResult with a step name, icon, message, and
+ * optional file path. Independent steps so partial failures don't cascade.
+ */
+export interface SetupOptions {
+    all: boolean;
+    claude: boolean;
+    copilot: boolean;
+    cursor: boolean;
+    gitHooks: boolean;
+    githubAction: boolean;
+    scan: boolean;
+    force: boolean;
+    repoRoot: string;
+    gkDir: string;
+}
+export interface SetupResult {
+    step: string;
+    icon: string;
+    message: string;
+    path: string | null;
+}
+export interface InstallationStep {
+    label: string;
+    run: () => Promise<SetupResult>;
+}
+export declare function defaultGraphifyIgnore(opts: SetupOptions): Promise<SetupResult>;
+export declare function installClaudeHooks(opts: SetupOptions): Promise<SetupResult>;
+export declare function installCopilotInstructions(opts: SetupOptions): Promise<SetupResult>;
+export declare function installVscodeMcp(opts: SetupOptions): Promise<SetupResult>;
+export declare function installCursorRules(opts: SetupOptions): Promise<SetupResult>;
+export declare function installGitHubWorkflow(opts: SetupOptions): Promise<SetupResult>;
+export declare function installGitHooks(opts: SetupOptions): Promise<SetupResult>;
+export declare function runInitialScan(opts: SetupOptions): Promise<SetupResult>;
+export declare function printSummary(results: SetupResult[], repoRoot: string): void;
+//# sourceMappingURL=setup-core.d.ts.map

package/dist/cli/setup-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-core.d.ts","sourceRoot":"","sources":["../../src/cli/setup-core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;CACjC;AAID,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAoCpF;AA4CD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAsCjF;AAID,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAWzF;AAID,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA6B/E;AAID,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA8BjF;AAID,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAgFpF;AAID,wBAAsB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA6D9E;AAID,wBAAsB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA4C7E;AAID,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAmB3E"}