optave-codegraph 3.13.0

package/dist/cli/commands/owners.js

@@ -0,0 +1,27 @@
+import { collectFile } from '../../db/query-builder.js';
+export const command = {
+    name: 'owners [target]',
+    description: 'Show CODEOWNERS mapping for files and functions',
+    options: [
+        ['-d, --db <path>', 'Path to graph.db'],
+        ['--owner <owner>', 'Filter to a specific owner'],
+        ['--boundary', 'Show cross-owner boundary edges'],
+        ['-f, --file <path>', 'Scope to a specific file (repeatable)', collectFile],
+        ['-k, --kind <kind>', 'Filter by symbol kind'],
+        ['-T, --no-tests', 'Exclude test/spec files'],
+        ['--include-tests', 'Include test/spec files (overrides excludeTests config)'],
+        ['-j, --json', 'Output as JSON'],
+    ],
+    async execute([target], opts, ctx) {
+        const { owners } = await import('../../presentation/owners.js');
+        owners(opts.db, {
+            owner: opts.owner,
+            boundary: opts.boundary,
+            file: opts.file && opts.file.length > 0 ? opts.file : target,
+            kind: opts.kind,
+            noTests: ctx.resolveNoTests(opts),
+            json: opts.json,
+        });
+    },
+};
+//# sourceMappingURL=owners.js.map

package/dist/cli/commands/owners.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"owners.js","sourceRoot":"","sources":["../../../src/cli/commands/owners.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGxD,MAAM,CAAC,MAAM,OAAO,GAAsB;IACxC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,iDAAiD;IAC9D,OAAO,EAAE;QACP,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;QACvC,CAAC,iBAAiB,EAAE,4BAA4B,CAAC;QACjD,CAAC,YAAY,EAAE,iCAAiC,CAAC;QACjD,CAAC,mBAAmB,EAAE,uCAAuC,EAAE,WAAW,CAAC;QAC3E,CAAC,mBAAmB,EAAE,uBAAuB,CAAC;QAC9C,CAAC,gBAAgB,EAAE,yBAAyB,CAAC;QAC7C,CAAC,iBAAiB,EAAE,yDAAyD,CAAC;QAC9E,CAAC,YAAY,EAAE,gBAAgB,CAAC;KACjC;IACD,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG;QAC/B,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,8BAA8B,CAAC,CAAC;QAChE,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE;YACd,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAK,IAAI,CAAC,IAAkB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM;YAC3E,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC;YACjC,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/cli/commands/path.d.ts

@@ -0,0 +1,3 @@
+import type { CommandDefinition } from '../types.js';
+export declare const command: CommandDefinition;
+//# sourceMappingURL=path.d.ts.map

package/dist/cli/commands/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/path.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,eAAO,MAAM,OAAO,EAAE,iBAqCrB,CAAC"}

package/dist/cli/commands/path.js

@@ -0,0 +1,41 @@
+import { EVERY_SYMBOL_KIND } from '../../domain/queries.js';
+import { symbolPath } from '../../presentation/queries-cli.js';
+export const command = {
+    name: 'path <from> <to>',
+    description: 'Find shortest path between two symbols (or files with --file)',
+    options: [
+        ['-d, --db <path>', 'Path to graph.db'],
+        ['-f, --file', 'Treat <from> and <to> as file paths instead of symbol names'],
+        ['--reverse', 'Follow edges backward'],
+        [
+            '--kinds <kinds>',
+            'Comma-separated edge kinds to follow (default: calls; file mode: imports,imports-type)',
+        ],
+        ['--from-file <path>', 'Disambiguate source symbol by file'],
+        ['--to-file <path>', 'Disambiguate target symbol by file'],
+        ['--depth <n>', 'Max traversal depth', '10'],
+        ['-k, --kind <kind>', 'Filter to a specific symbol kind'],
+        ['-T, --no-tests', 'Exclude test/spec files from results'],
+        ['--include-tests', 'Include test/spec files (overrides excludeTests config)'],
+        ['-j, --json', 'Output as JSON'],
+    ],
+    validate([_from, _to], opts) {
+        if (opts.kind && !EVERY_SYMBOL_KIND.includes(opts.kind)) {
+            return `Invalid kind "${opts.kind}". Valid: ${EVERY_SYMBOL_KIND.join(', ')}`;
+        }
+    },
+    execute([from, to], opts, ctx) {
+        symbolPath(from, to, opts.db, {
+            maxDepth: opts.depth ? parseInt(opts.depth, 10) : 10,
+            edgeKinds: opts.kinds ? opts.kinds.split(',').map((s) => s.trim()) : undefined,
+            reverse: opts.reverse,
+            fromFile: opts.fromFile,
+            toFile: opts.toFile,
+            kind: opts.kind,
+            noTests: ctx.resolveNoTests(opts),
+            json: opts.json,
+            file: opts.file,
+        });
+    },
+};
+//# sourceMappingURL=path.js.map

package/dist/cli/commands/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../../src/cli/commands/path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAG/D,MAAM,CAAC,MAAM,OAAO,GAAsB;IACxC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,+DAA+D;IAC5E,OAAO,EAAE;QACP,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;QACvC,CAAC,YAAY,EAAE,6DAA6D,CAAC;QAC7E,CAAC,WAAW,EAAE,uBAAuB,CAAC;QACtC;YACE,iBAAiB;YACjB,wFAAwF;SACzF;QACD,CAAC,oBAAoB,EAAE,oCAAoC,CAAC;QAC5D,CAAC,kBAAkB,EAAE,oCAAoC,CAAC;QAC1D,CAAC,aAAa,EAAE,qBAAqB,EAAE,IAAI,CAAC;QAC5C,CAAC,mBAAmB,EAAE,kCAAkC,CAAC;QACzD,CAAC,gBAAgB,EAAE,sCAAsC,CAAC;QAC1D,CAAC,iBAAiB,EAAE,yDAAyD,CAAC;QAC9E,CAAC,YAAY,EAAE,gBAAgB,CAAC;KACjC;IACD,QAAQ,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,IAAI;QACzB,IAAI,IAAI,CAAC,IAAI,IAAI,CAAE,iBAAuC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/E,OAAO,iBAAiB,IAAI,CAAC,IAAI,aAAa,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/E,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG;QAC3B,UAAU,CAAC,IAAK,EAAE,EAAG,EAAE,IAAI,CAAC,EAAE,EAAE;YAC9B,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAe,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;YAC9D,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,IAAI,CAAC,KAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;YAC1F,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC;YACjC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/cli/commands/plot.d.ts

@@ -0,0 +1,3 @@
+import type { CommandDefinition } from '../types.js';
+export declare const command: CommandDefinition;
+//# sourceMappingURL=plot.d.ts.map

package/dist/cli/commands/plot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plot.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/plot.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAmBrD,eAAO,MAAM,OAAO,EAAE,iBAsFrB,CAAC"}

package/dist/cli/commands/plot.js

@@ -0,0 +1,96 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { toErrorMessage } from '../../shared/errors.js';
+import { openGraph } from '../shared/open-graph.js';
+export const command = {
+    name: 'plot',
+    description: 'Generate an interactive HTML dependency graph viewer',
+    options: [
+        ['-d, --db <path>', 'Path to graph.db'],
+        ['--functions', 'Function-level graph instead of file-level'],
+        ['-T, --no-tests', 'Exclude test/spec files'],
+        ['--include-tests', 'Include test/spec files (overrides excludeTests config)'],
+        ['--min-confidence <score>', 'Minimum edge confidence threshold (default: 0.5)', '0.5'],
+        ['-o, --output <file>', 'Write HTML to file'],
+        ['-c, --config <path>', 'Path to .plotDotCfg config file'],
+        ['--no-open', 'Do not open in browser'],
+        ['--cluster <mode>', 'Cluster nodes: none | community | directory'],
+        ['--overlay <list>', 'Comma-separated overlays: complexity,risk'],
+        ['--seed <strategy>', 'Seed strategy: all | top-fanin | entry'],
+        ['--seed-count <n>', 'Number of seed nodes (default: 30)'],
+        ['--size-by <metric>', 'Size nodes by: uniform | fan-in | fan-out | complexity'],
+        ['--color-by <mode>', 'Color nodes by: kind | role | community | complexity'],
+    ],
+    async execute(_args, opts, ctx) {
+        const { generatePlotHTML, loadPlotConfig } = await import('../../features/graph-enrichment.js');
+        const os = await import('node:os');
+        const { db, close } = openGraph(opts);
+        let plotCfg;
+        let html;
+        try {
+            if (opts.config) {
+                try {
+                    plotCfg = JSON.parse(fs.readFileSync(opts.config, 'utf-8'));
+                }
+                catch (e) {
+                    console.error(`Failed to load config: ${toErrorMessage(e)}`);
+                    process.exitCode = 1;
+                    return;
+                }
+            }
+            else {
+                plotCfg = loadPlotConfig(process.cwd());
+            }
+            if (opts.cluster)
+                plotCfg.clusterBy = opts.cluster;
+            if (opts.colorBy)
+                plotCfg.colorBy = opts.colorBy;
+            if (opts.sizeBy)
+                plotCfg.sizeBy = opts.sizeBy;
+            if (opts.seed)
+                plotCfg.seedStrategy = opts.seed;
+            if (opts.seedCount)
+                plotCfg.seedCount = parseInt(opts.seedCount, 10);
+            if (opts.overlay) {
+                const parts = opts.overlay.split(',').map((s) => s.trim());
+                if (!plotCfg.overlays)
+                    plotCfg.overlays = {};
+                if (parts.includes('complexity'))
+                    plotCfg.overlays.complexity = true;
+                if (parts.includes('risk'))
+                    plotCfg.overlays.risk = true;
+            }
+            html = generatePlotHTML(db, {
+                fileLevel: !opts.functions,
+                noTests: ctx.resolveNoTests(opts),
+                minConfidence: parseFloat(opts.minConfidence),
+                // PlotConfig shapes are structurally compatible; bridge the two declarations
+                config: plotCfg,
+            });
+        }
+        finally {
+            close();
+        }
+        if (!html) {
+            console.error('generatePlotHTML returned no output');
+            process.exitCode = 1;
+            return;
+        }
+        const outPath = opts.output || path.join(os.tmpdir(), `codegraph-plot-${Date.now()}.html`);
+        fs.writeFileSync(outPath, html, 'utf-8');
+        console.log(`Plot written to ${outPath}`);
+        if (opts.open !== false) {
+            const { execFile } = await import('node:child_process');
+            const args = process.platform === 'win32'
+                ? ['cmd', ['/c', 'start', '', outPath]]
+                : process.platform === 'darwin'
+                    ? ['open', [outPath]]
+                    : ['xdg-open', [outPath]];
+            execFile(args[0], args[1], (err) => {
+                if (err)
+                    console.error('Could not open browser:', err.message);
+            });
+        }
+    },
+};
+//# sourceMappingURL=plot.js.map

package/dist/cli/commands/plot.js.map

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

package/dist/cli/commands/query.d.ts

@@ -0,0 +1,3 @@
+import type { CommandDefinition } from '../types.js';
+export declare const command: CommandDefinition;
+//# sourceMappingURL=query.d.ts.map

package/dist/cli/commands/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/query.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,eAAO,MAAM,OAAO,EAAE,iBA6CrB,CAAC"}

package/dist/cli/commands/query.js

@@ -0,0 +1,51 @@
+import { collectFile } from '../../db/query-builder.js';
+import { EVERY_SYMBOL_KIND } from '../../domain/queries.js';
+import { fnDeps, symbolPath } from '../../presentation/queries-cli.js';
+export const command = {
+    name: 'query <name>',
+    description: 'Function-level dependency chain or shortest path between symbols',
+    queryOpts: true,
+    options: [
+        ['--depth <n>', 'Transitive caller depth', '3'],
+        [
+            '-f, --file <path>',
+            'Scope search to functions in this file (partial match, repeatable)',
+            collectFile,
+        ],
+        ['-k, --kind <kind>', 'Filter to a specific symbol kind'],
+        ['--path <to>', 'Path mode: find shortest path to <to>'],
+        ['--kinds <kinds>', 'Path mode: comma-separated edge kinds to follow (default: calls)'],
+        ['--reverse', 'Path mode: follow edges backward'],
+        ['--from-file <path>', 'Path mode: disambiguate source symbol by file'],
+        ['--to-file <path>', 'Path mode: disambiguate target symbol by file'],
+    ],
+    validate([_name], opts) {
+        if (opts.kind && !EVERY_SYMBOL_KIND.includes(opts.kind)) {
+            return `Invalid kind "${opts.kind}". Valid: ${EVERY_SYMBOL_KIND.join(', ')}`;
+        }
+    },
+    execute([name], opts, ctx) {
+        if (opts.path) {
+            console.error('Note: "query --path" is deprecated, use "codegraph path <from> <to>" instead');
+            symbolPath(name, opts.path, opts.db, {
+                maxDepth: opts.depth ? parseInt(opts.depth, 10) : 10,
+                edgeKinds: opts.kinds ? opts.kinds.split(',').map((s) => s.trim()) : undefined,
+                reverse: opts.reverse,
+                fromFile: opts.fromFile,
+                toFile: opts.toFile,
+                kind: opts.kind,
+                noTests: ctx.resolveNoTests(opts),
+                json: opts.json,
+            });
+        }
+        else {
+            fnDeps(name, opts.db, {
+                depth: parseInt(opts.depth, 10),
+                file: opts.file,
+                kind: opts.kind,
+                ...ctx.resolveQueryOpts(opts),
+            });
+        }
+    },
+};
+//# sourceMappingURL=query.js.map

package/dist/cli/commands/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/cli/commands/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAGvE,MAAM,CAAC,MAAM,OAAO,GAAsB;IACxC,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,kEAAkE;IAC/E,SAAS,EAAE,IAAI;IACf,OAAO,EAAE;QACP,CAAC,aAAa,EAAE,yBAAyB,EAAE,GAAG,CAAC;QAC/C;YACE,mBAAmB;YACnB,oEAAoE;YACpE,WAAW;SACZ;QACD,CAAC,mBAAmB,EAAE,kCAAkC,CAAC;QACzD,CAAC,aAAa,EAAE,uCAAuC,CAAC;QACxD,CAAC,iBAAiB,EAAE,kEAAkE,CAAC;QACvF,CAAC,WAAW,EAAE,kCAAkC,CAAC;QACjD,CAAC,oBAAoB,EAAE,+CAA+C,CAAC;QACvE,CAAC,kBAAkB,EAAE,+CAA+C,CAAC;KACtE;IACD,QAAQ,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI;QACpB,IAAI,IAAI,CAAC,IAAI,IAAI,CAAE,iBAAuC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/E,OAAO,iBAAiB,IAAI,CAAC,IAAI,aAAa,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/E,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG;QACvB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,CAAC,8EAA8E,CAAC,CAAC;YAC9F,UAAU,CAAC,IAAK,EAAE,IAAI,CAAC,IAAc,EAAE,IAAI,CAAC,EAAE,EAAE;gBAC9C,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAe,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;gBAC9D,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,IAAI,CAAC,KAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;gBAC1F,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC;gBACjC,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAK,EAAE,IAAI,CAAC,EAAE,EAAE;gBACrB,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAe,EAAE,EAAE,CAAC;gBACzC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,GAAG,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC;aAC9B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/cli/commands/registry.d.ts

@@ -0,0 +1,3 @@
+import type { CommandDefinition } from '../types.js';
+export declare const command: CommandDefinition;
+//# sourceMappingURL=registry.d.ts.map

package/dist/cli/commands/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/registry.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,eAAO,MAAM,OAAO,EAAE,iBA6FrB,CAAC"}

package/dist/cli/commands/registry.js

@@ -0,0 +1,95 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { listRepos, pruneRegistry, REGISTRY_PATH, registerRepo, unregisterRepo, } from '../../infrastructure/registry.js';
+import { ConfigError } from '../../shared/errors.js';
+export const command = {
+    name: 'registry',
+    description: 'Manage the multi-repo project registry',
+    subcommands: [
+        {
+            name: 'list',
+            description: 'List all registered repositories',
+            options: [['-j, --json', 'Output as JSON']],
+            execute(_args, opts) {
+                pruneRegistry();
+                const repos = listRepos();
+                if (opts.json) {
+                    console.log(JSON.stringify(repos, null, 2));
+                }
+                else if (repos.length === 0) {
+                    console.log(`No repositories registered.\nRegistry: ${REGISTRY_PATH}`);
+                }
+                else {
+                    console.log(`Registered repositories (${REGISTRY_PATH}):\n`);
+                    for (const r of repos) {
+                        const dbExists = fs.existsSync(r.dbPath);
+                        const status = dbExists ? '' : ' [DB missing]';
+                        console.log(`  ${r.name}${status}`);
+                        console.log(`    Path: ${r.path}`);
+                        console.log(`    DB:   ${r.dbPath}`);
+                        console.log();
+                    }
+                }
+            },
+        },
+        {
+            name: 'add <dir>',
+            description: 'Register a project directory',
+            options: [['-n, --name <name>', 'Custom name (defaults to directory basename)']],
+            execute([dir], opts) {
+                const absDir = path.resolve(dir);
+                const { name, entry } = registerRepo(absDir, opts.name);
+                console.log(`Registered "${name}" → ${entry.path}`);
+            },
+        },
+        {
+            name: 'remove <name>',
+            description: 'Unregister a repository by name',
+            execute([name]) {
+                const removed = unregisterRepo(name);
+                if (removed) {
+                    console.log(`Removed "${name}" from registry.`);
+                }
+                else {
+                    throw new ConfigError(`Repository "${name}" not found in registry.`);
+                }
+            },
+        },
+        {
+            name: 'prune',
+            description: 'Remove stale registry entries (missing directories or idle beyond TTL)',
+            options: [
+                ['--ttl <days>', 'Days of inactivity before pruning (default: 30)', '30'],
+                ['--exclude <names>', 'Comma-separated repo names to preserve from pruning'],
+                ['--dry-run', 'Show what would be pruned without removing anything'],
+            ],
+            execute(_args, opts) {
+                const excludeNames = opts.exclude
+                    ? opts.exclude
+                        .split(',')
+                        .map((s) => s.trim())
+                        .filter((s) => s.length > 0)
+                    : [];
+                const dryRun = !!opts.dryRun;
+                const pruned = pruneRegistry(undefined, parseInt(opts.ttl, 10), excludeNames, dryRun);
+                if (pruned.length === 0) {
+                    console.log('No stale entries found.');
+                }
+                else {
+                    const prefix = dryRun ? 'Would prune' : 'Pruned';
+                    for (const entry of pruned) {
+                        const tag = entry.reason === 'expired' ? 'expired' : 'missing';
+                        console.log(`${prefix} "${entry.name}" (${entry.path}) [${tag}]`);
+                    }
+                    if (dryRun) {
+                        console.log(`\nDry run: ${pruned.length} ${pruned.length === 1 ? 'entry' : 'entries'} would be removed.`);
+                    }
+                    else {
+                        console.log(`\nRemoved ${pruned.length} stale ${pruned.length === 1 ? 'entry' : 'entries'}.`);
+                    }
+                }
+            },
+        },
+    ],
+};
+//# sourceMappingURL=registry.js.map

package/dist/cli/commands/registry.js.map

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

package/dist/cli/commands/roles.d.ts

@@ -0,0 +1,3 @@
+import type { CommandDefinition } from '../types.js';
+export declare const command: CommandDefinition;
+//# sourceMappingURL=roles.d.ts.map

package/dist/cli/commands/roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/roles.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,eAAO,MAAM,OAAO,EAAE,iBAgCrB,CAAC"}

package/dist/cli/commands/roles.js

@@ -0,0 +1,36 @@
+import { collectFile } from '../../db/query-builder.js';
+import { VALID_ROLES } from '../../domain/queries.js';
+import { dynamicCalls, roles } from '../../presentation/queries-cli.js';
+export const command = {
+    name: 'roles',
+    description: 'Show node role classification: entry, core, utility, adapter, dead (dead-leaf, dead-entry, dead-ffi, dead-unresolved), leaf',
+    options: [
+        ['-d, --db <path>', 'Path to graph.db'],
+        ['--role <role>', `Filter by role (${VALID_ROLES.join(', ')})`],
+        ['-f, --file <path>', 'Scope to a specific file (partial match, repeatable)', collectFile],
+        ['-T, --no-tests', 'Exclude test/spec files'],
+        ['--include-tests', 'Include test/spec files (overrides excludeTests config)'],
+        ['-j, --json', 'Output as JSON'],
+        ['-n, --limit <number>', 'Max results to return'],
+        ['--offset <number>', 'Skip N results (default: 0)'],
+        ['--ndjson', 'Newline-delimited JSON output'],
+        ['--dynamic', 'Show flagged dynamic call sites instead of symbol roles'],
+    ],
+    validate(_args, opts) {
+        if (opts.role && !VALID_ROLES.includes(opts.role)) {
+            return `Invalid role "${opts.role}". Valid roles: ${VALID_ROLES.join(', ')}`;
+        }
+    },
+    execute(_args, opts, ctx) {
+        if (opts.dynamic) {
+            dynamicCalls(opts.db, ctx.resolveQueryOpts(opts));
+            return;
+        }
+        roles(opts.db, {
+            role: opts.role,
+            file: opts.file,
+            ...ctx.resolveQueryOpts(opts),
+        });
+    },
+};
+//# sourceMappingURL=roles.js.map

package/dist/cli/commands/roles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.js","sourceRoot":"","sources":["../../../src/cli/commands/roles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAGxE,MAAM,CAAC,MAAM,OAAO,GAAsB;IACxC,IAAI,EAAE,OAAO;IACb,WAAW,EACT,6HAA6H;IAC/H,OAAO,EAAE;QACP,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;QACvC,CAAC,eAAe,EAAE,mBAAmB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QAC/D,CAAC,mBAAmB,EAAE,sDAAsD,EAAE,WAAW,CAAC;QAC1F,CAAC,gBAAgB,EAAE,yBAAyB,CAAC;QAC7C,CAAC,iBAAiB,EAAE,yDAAyD,CAAC;QAC9E,CAAC,YAAY,EAAE,gBAAgB,CAAC;QAChC,CAAC,sBAAsB,EAAE,uBAAuB,CAAC;QACjD,CAAC,mBAAmB,EAAE,6BAA6B,CAAC;QACpD,CAAC,UAAU,EAAE,+BAA+B,CAAC;QAC7C,CAAC,WAAW,EAAE,yDAAyD,CAAC;KACzE;IACD,QAAQ,CAAC,KAAK,EAAE,IAAI;QAClB,IAAI,IAAI,CAAC,IAAI,IAAI,CAAE,WAAiC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACzE,OAAO,iBAAiB,IAAI,CAAC,IAAI,mBAAmB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/E,CAAC;IACH,CAAC;IACD,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG;QACtB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE;YACb,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC;SAC9B,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/cli/commands/search.d.ts

@@ -0,0 +1,3 @@
+import type { CommandDefinition } from '../types.js';
+export declare const command: CommandDefinition;
+//# sourceMappingURL=search.d.ts.map

package/dist/cli/commands/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/search.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,eAAO,MAAM,OAAO,EAAE,iBAwCrB,CAAC"}

package/dist/cli/commands/search.js

@@ -0,0 +1,43 @@
+import { collectFile } from '../../db/query-builder.js';
+import { search } from '../../domain/search/index.js';
+export const command = {
+    name: 'search <query>',
+    description: 'Semantic search: find functions by natural language description',
+    options: [
+        ['-d, --db <path>', 'Path to graph.db'],
+        ['-m, --model <name>', 'Override embedding model (auto-detects from DB)'],
+        ['-n, --limit <number>', 'Max results', '15'],
+        ['-T, --no-tests', 'Exclude test/spec files from results'],
+        ['--include-tests', 'Include test/spec files (overrides excludeTests config)'],
+        ['--min-score <score>', 'Minimum similarity threshold', '0.2'],
+        ['-k, --kind <kind>', 'Filter by kind: function, method, class'],
+        ['--file <pattern>', 'Filter by file path pattern (repeatable)', collectFile],
+        ['--rrf-k <number>', 'RRF k parameter for multi-query ranking', '60'],
+        ['--mode <mode>', 'Search mode: hybrid, semantic, keyword (default: hybrid)'],
+        ['-j, --json', 'Output as JSON'],
+        ['--offset <number>', 'Skip N results (default: 0)'],
+        ['--ndjson', 'Newline-delimited JSON output'],
+    ],
+    validate([_query], opts) {
+        const validModes = ['hybrid', 'semantic', 'keyword'];
+        if (opts.mode && !validModes.includes(opts.mode)) {
+            return `Invalid mode "${opts.mode}". Valid: ${validModes.join(', ')}`;
+        }
+    },
+    async execute([query], opts, ctx) {
+        const fileArr = (opts.file || []);
+        const filePattern = fileArr.length === 1 ? fileArr[0] : fileArr.length > 1 ? fileArr : undefined;
+        await search(query, opts.db, {
+            limit: parseInt(opts.limit, 10),
+            noTests: ctx.resolveNoTests(opts),
+            minScore: parseFloat(opts.minScore),
+            model: opts.model,
+            kind: opts.kind,
+            filePattern,
+            rrfK: parseInt(opts.rrfK, 10),
+            mode: opts.mode,
+            json: opts.json,
+        });
+    },
+};
+//# sourceMappingURL=search.js.map

package/dist/cli/commands/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/cli/commands/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAGtD,MAAM,CAAC,MAAM,OAAO,GAAsB;IACxC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,iEAAiE;IAC9E,OAAO,EAAE;QACP,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;QACvC,CAAC,oBAAoB,EAAE,iDAAiD,CAAC;QACzE,CAAC,sBAAsB,EAAE,aAAa,EAAE,IAAI,CAAC;QAC7C,CAAC,gBAAgB,EAAE,sCAAsC,CAAC;QAC1D,CAAC,iBAAiB,EAAE,yDAAyD,CAAC;QAC9E,CAAC,qBAAqB,EAAE,8BAA8B,EAAE,KAAK,CAAC;QAC9D,CAAC,mBAAmB,EAAE,yCAAyC,CAAC;QAChE,CAAC,kBAAkB,EAAE,0CAA0C,EAAE,WAAW,CAAC;QAC7E,CAAC,kBAAkB,EAAE,yCAAyC,EAAE,IAAI,CAAC;QACrE,CAAC,eAAe,EAAE,0DAA0D,CAAC;QAC7E,CAAC,YAAY,EAAE,gBAAgB,CAAC;QAChC,CAAC,mBAAmB,EAAE,6BAA6B,CAAC;QACpD,CAAC,UAAU,EAAE,+BAA+B,CAAC;KAC9C;IACD,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI;QACrB,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;QACrD,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAc,CAAC,EAAE,CAAC;YAC3D,OAAO,iBAAiB,IAAI,CAAC,IAAI,aAAa,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACxE,CAAC;IACH,CAAC;IACD,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,GAAG;QAC9B,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAa,CAAC;QAC9C,MAAM,WAAW,GACf,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/E,MAAM,MAAM,CAAC,KAAM,EAAE,IAAI,CAAC,EAAwB,EAAE;YAClD,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAe,EAAE,EAAE,CAAC;YACzC,OAAO,EAAE,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC;YACjC,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,QAAkB,CAAC;YAC7C,KAAK,EAAE,IAAI,CAAC,KAA2B;YACvC,IAAI,EAAE,IAAI,CAAC,IAA0B;YACrC,WAAW;YACX,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAc,EAAE,EAAE,CAAC;YACvC,IAAI,EAAE,IAAI,CAAC,IAAqD;YAChE,IAAI,EAAE,IAAI,CAAC,IAA2B;SACvC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/cli/commands/sequence.d.ts

@@ -0,0 +1,3 @@
+import type { CommandDefinition } from '../types.js';
+export declare const command: CommandDefinition;
+//# sourceMappingURL=sequence.d.ts.map

package/dist/cli/commands/sequence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/sequence.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,eAAO,MAAM,OAAO,EAAE,iBAyBrB,CAAC"}

package/dist/cli/commands/sequence.js

@@ -0,0 +1,29 @@
+import { collectFile } from '../../db/query-builder.js';
+import { EVERY_SYMBOL_KIND } from '../../domain/queries.js';
+export const command = {
+    name: 'sequence <name>',
+    description: 'Generate a Mermaid sequence diagram from call graph edges (participants = files)',
+    queryOpts: true,
+    options: [
+        ['--depth <n>', 'Max forward traversal depth', '10'],
+        ['--dataflow', 'Annotate with parameter names and return arrows from dataflow table'],
+        ['-f, --file <path>', 'Scope to a specific file (partial match, repeatable)', collectFile],
+        ['-k, --kind <kind>', 'Filter by symbol kind'],
+    ],
+    validate([_name], opts) {
+        if (opts.kind && !EVERY_SYMBOL_KIND.includes(opts.kind)) {
+            return `Invalid kind "${opts.kind}". Valid: ${EVERY_SYMBOL_KIND.join(', ')}`;
+        }
+    },
+    async execute([name], opts, ctx) {
+        const { sequence } = await import('../../presentation/sequence.js');
+        sequence(name, opts.db, {
+            depth: parseInt(opts.depth, 10),
+            file: opts.file,
+            kind: opts.kind,
+            dataflow: opts.dataflow,
+            ...ctx.resolveQueryOpts(opts),
+        });
+    },
+};
+//# sourceMappingURL=sequence.js.map

package/dist/cli/commands/sequence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.js","sourceRoot":"","sources":["../../../src/cli/commands/sequence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,MAAM,CAAC,MAAM,OAAO,GAAsB;IACxC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,kFAAkF;IAC/F,SAAS,EAAE,IAAI;IACf,OAAO,EAAE;QACP,CAAC,aAAa,EAAE,6BAA6B,EAAE,IAAI,CAAC;QACpD,CAAC,YAAY,EAAE,qEAAqE,CAAC;QACrF,CAAC,mBAAmB,EAAE,sDAAsD,EAAE,WAAW,CAAC;QAC1F,CAAC,mBAAmB,EAAE,uBAAuB,CAAC;KAC/C;IACD,QAAQ,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI;QACpB,IAAI,IAAI,CAAC,IAAI,IAAI,CAAE,iBAAuC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/E,OAAO,iBAAiB,IAAI,CAAC,IAAI,aAAa,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/E,CAAC;IACH,CAAC;IACD,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG;QAC7B,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAC;QACpE,QAAQ,CAAC,IAAK,EAAE,IAAI,CAAC,EAAE,EAAE;YACvB,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAe,EAAE,EAAE,CAAC;YACzC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,GAAG,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC;SAC9B,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/cli/commands/snapshot.d.ts

@@ -0,0 +1,3 @@
+import type { CommandDefinition } from '../types.js';
+export declare const command: CommandDefinition;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/cli/commands/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/snapshot.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,eAAO,MAAM,OAAO,EAAE,iBA0DrB,CAAC"}

package/dist/cli/commands/snapshot.js

@@ -0,0 +1,61 @@
+import { snapshotDelete, snapshotList, snapshotRestore, snapshotSave, } from '../../features/snapshot.js';
+export const command = {
+    name: 'snapshot',
+    description: 'Save and restore graph database snapshots',
+    subcommands: [
+        {
+            name: 'save <name>',
+            description: 'Save a snapshot of the current graph database',
+            options: [
+                ['-d, --db <path>', 'Path to graph.db'],
+                ['--force', 'Overwrite existing snapshot'],
+            ],
+            execute([name], opts, ctx) {
+                const result = snapshotSave(name, { dbPath: opts.db, force: opts.force });
+                console.log(`Snapshot saved: ${result.name} (${ctx.formatSize(result.size)})`);
+            },
+        },
+        {
+            name: 'restore <name>',
+            description: 'Restore a snapshot over the current graph database',
+            options: [['-d, --db <path>', 'Path to graph.db']],
+            execute([name], opts) {
+                snapshotRestore(name, { dbPath: opts.db });
+                console.log(`Snapshot "${name}" restored.`);
+            },
+        },
+        {
+            name: 'list',
+            description: 'List all saved snapshots',
+            options: [
+                ['-d, --db <path>', 'Path to graph.db'],
+                ['-j, --json', 'Output as JSON'],
+            ],
+            execute(_args, opts, ctx) {
+                const snapshots = snapshotList({ dbPath: opts.db });
+                if (opts.json) {
+                    console.log(JSON.stringify(snapshots, null, 2));
+                }
+                else if (snapshots.length === 0) {
+                    console.log('No snapshots found.');
+                }
+                else {
+                    console.log(`Snapshots (${snapshots.length}):\n`);
+                    for (const s of snapshots) {
+                        console.log(`  ${s.name.padEnd(30)} ${ctx.formatSize(s.size).padStart(10)}  ${s.createdAt.toISOString()}`);
+                    }
+                }
+            },
+        },
+        {
+            name: 'delete <name>',
+            description: 'Delete a saved snapshot',
+            options: [['-d, --db <path>', 'Path to graph.db']],
+            execute([name], opts) {
+                snapshotDelete(name, { dbPath: opts.db });
+                console.log(`Snapshot "${name}" deleted.`);
+            },
+        },
+    ],
+};
+//# sourceMappingURL=snapshot.js.map

package/dist/cli/commands/snapshot.js.map

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

package/dist/cli/commands/stats.d.ts

@@ -0,0 +1,3 @@
+import type { CommandDefinition } from '../types.js';
+export declare const command: CommandDefinition;
+//# sourceMappingURL=stats.d.ts.map

package/dist/cli/commands/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/stats.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,eAAO,MAAM,OAAO,EAAE,iBAYrB,CAAC"}