optave-codegraph 3.13.0

package/dist/cli/commands/stats.js

@@ -0,0 +1,15 @@
+import { stats } from '../../presentation/queries-cli.js';
+export const command = {
+    name: 'stats',
+    description: 'Show graph health overview: nodes, edges, languages, cycles, hotspots, embeddings',
+    options: [
+        ['-d, --db <path>', 'Path to graph.db'],
+        ['-T, --no-tests', 'Exclude test/spec files from results'],
+        ['--include-tests', 'Include test/spec files (overrides excludeTests config)'],
+        ['-j, --json', 'Output as JSON'],
+    ],
+    async execute(_args, opts, ctx) {
+        await stats(opts.db, { noTests: ctx.resolveNoTests(opts), json: opts.json });
+    },
+};
+//# sourceMappingURL=stats.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../../src/cli/commands/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAG1D,MAAM,CAAC,MAAM,OAAO,GAAsB;IACxC,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,mFAAmF;IAChG,OAAO,EAAE;QACP,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;QACvC,CAAC,gBAAgB,EAAE,sCAAsC,CAAC;QAC1D,CAAC,iBAAiB,EAAE,yDAAyD,CAAC;QAC9E,CAAC,YAAY,EAAE,gBAAgB,CAAC;KACjC;IACD,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG;QAC5B,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/E,CAAC;CACF,CAAC"}

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

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

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

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

package/dist/cli/commands/structure.js

@@ -0,0 +1,50 @@
+export const command = {
+    name: 'structure [dir]',
+    description: 'Show project directory structure with hierarchy, cohesion scores, and per-file metrics',
+    options: [
+        ['-d, --db <path>', 'Path to graph.db'],
+        ['--depth <n>', 'Max directory depth'],
+        ['--sort <metric>', 'Sort by: cohesion | fan-in | fan-out | density | files', 'files'],
+        ['--full', 'Show all files without limit'],
+        ['-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'],
+        ['--modules', 'Show module boundaries (directories with high cohesion)'],
+        ['--threshold <number>', 'Cohesion threshold for --modules (default: 0.3)'],
+    ],
+    async execute([dir], opts, ctx) {
+        const { structureData, formatStructure, moduleBoundariesData, formatModuleBoundaries } = await import('../../presentation/structure.js');
+        if (opts.modules) {
+            const parsed = opts.threshold ? parseFloat(opts.threshold) : undefined;
+            if (parsed !== undefined && Number.isNaN(parsed)) {
+                console.error('Error: --threshold must be a number');
+                process.exitCode = 1;
+                return;
+            }
+            const data = moduleBoundariesData(opts.db, {
+                threshold: parsed,
+            });
+            if (!ctx.outputResult(data, 'modules', opts)) {
+                console.log(formatModuleBoundaries(data));
+            }
+            return;
+        }
+        const qOpts = ctx.resolveQueryOpts(opts);
+        const data = structureData(opts.db, {
+            directory: dir,
+            depth: opts.depth ? parseInt(opts.depth, 10) : undefined,
+            sort: opts.sort,
+            full: opts.full,
+            noTests: qOpts.noTests,
+            limit: qOpts.limit,
+            offset: qOpts.offset,
+        });
+        if (!ctx.outputResult(data, 'directories', opts)) {
+            console.log(formatStructure(data));
+        }
+    },
+};
+//# sourceMappingURL=structure.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"structure.js","sourceRoot":"","sources":["../../../src/cli/commands/structure.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,OAAO,GAAsB;IACxC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,wFAAwF;IAC1F,OAAO,EAAE;QACP,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;QACvC,CAAC,aAAa,EAAE,qBAAqB,CAAC;QACtC,CAAC,iBAAiB,EAAE,wDAAwD,EAAE,OAAO,CAAC;QACtF,CAAC,QAAQ,EAAE,8BAA8B,CAAC;QAC1C,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;QACxE,CAAC,sBAAsB,EAAE,iDAAiD,CAAC;KAC5E;IACD,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,GAAG;QAC5B,MAAM,EAAE,aAAa,EAAE,eAAe,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,GACpF,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;QAElD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,SAAmB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACjF,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjD,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;gBACrD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;YACD,MAAM,IAAI,GAAG,oBAAoB,CAAC,IAAI,CAAC,EAAE,EAAE;gBACzC,SAAS,EAAE,MAAM;aAClB,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC;gBAC7C,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;YAC5C,CAAC;YACD,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE;YAClC,SAAS,EAAE,GAAG;YACd,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAe,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;YAClE,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,CAAC;YACjD,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;CACF,CAAC"}

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

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

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

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

package/dist/cli/commands/triage.js

@@ -0,0 +1,89 @@
+import { collectFile } from '../../db/query-builder.js';
+import { EVERY_SYMBOL_KIND, VALID_ROLES } from '../../domain/queries.js';
+import { ConfigError } from '../../shared/errors.js';
+function validateFilters(opts) {
+    if (opts.kind && !EVERY_SYMBOL_KIND.includes(opts.kind)) {
+        throw new ConfigError(`Invalid kind "${opts.kind}". Valid: ${EVERY_SYMBOL_KIND.join(', ')}`);
+    }
+    if (opts.role && !VALID_ROLES.includes(opts.role)) {
+        throw new ConfigError(`Invalid role "${opts.role}". Valid: ${VALID_ROLES.join(', ')}`);
+    }
+}
+function parseWeights(raw) {
+    if (!raw)
+        return undefined;
+    try {
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        throw new ConfigError('Invalid --weights JSON', { cause: err });
+    }
+}
+async function runHotspots(opts, ctx) {
+    const { hotspotsData, formatHotspots } = await import('../../presentation/structure.js');
+    const metric = opts.sort === 'risk' ? 'fan-in' : opts.sort;
+    const data = hotspotsData(opts.db, {
+        metric,
+        level: opts.level,
+        limit: parseInt(opts.limit, 10),
+        offset: opts.offset ? parseInt(opts.offset, 10) : undefined,
+        noTests: ctx.resolveNoTests(opts),
+    });
+    if (!ctx.outputResult(data, 'items', opts)) {
+        console.log(formatHotspots(data));
+    }
+}
+export const command = {
+    name: 'triage',
+    description: 'Ranked audit queue by composite risk score (connectivity + complexity + churn + role)',
+    options: [
+        ['-d, --db <path>', 'Path to graph.db'],
+        ['-n, --limit <number>', 'Max results to return', '20'],
+        [
+            '--level <level>',
+            'Granularity: function (default) | file | directory. File/directory level shows hotspots',
+            'function',
+        ],
+        [
+            '--sort <metric>',
+            'Sort metric: risk | complexity | churn | fan-in | mi (function level); fan-in | fan-out | density | coupling (file/directory level)',
+            'risk',
+        ],
+        ['--min-score <score>', 'Only show symbols with risk score >= threshold'],
+        [
+            '--role <role>',
+            'Filter by role (entry, core, utility, adapter, leaf, dead, dead-leaf, dead-entry, dead-ffi, dead-unresolved)',
+        ],
+        ['-f, --file <path>', 'Scope to a specific file (partial match, repeatable)', collectFile],
+        ['-k, --kind <kind>', 'Filter by symbol kind (function, method, class)'],
+        ['-T, --no-tests', 'Exclude test/spec files from results'],
+        ['--include-tests', 'Include test/spec files (overrides excludeTests config)'],
+        ['-j, --json', 'Output as JSON'],
+        ['--offset <number>', 'Skip N results (default: 0)'],
+        ['--ndjson', 'Newline-delimited JSON output'],
+        ['--weights <json>', 'Custom weights JSON (e.g. \'{"fanIn":1,"complexity":0}\')'],
+    ],
+    async execute(_args, opts, ctx) {
+        if (opts.level === 'file' || opts.level === 'directory') {
+            await runHotspots(opts, ctx);
+            return;
+        }
+        validateFilters(opts);
+        const weights = parseWeights(opts.weights);
+        const { triage } = await import('../../presentation/triage.js');
+        triage(opts.db, {
+            limit: parseInt(opts.limit, 10),
+            offset: opts.offset ? parseInt(opts.offset, 10) : undefined,
+            sort: opts.sort,
+            minScore: opts.minScore,
+            role: opts.role,
+            file: opts.file,
+            kind: opts.kind,
+            noTests: ctx.resolveNoTests(opts),
+            json: opts.json,
+            ndjson: opts.ndjson,
+            weights,
+        });
+    },
+};
+//# sourceMappingURL=triage.js.map

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

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

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

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

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

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

package/dist/cli/commands/watch.js

@@ -0,0 +1,28 @@
+import path from 'node:path';
+import { watchProject } from '../../domain/graph/watcher.js';
+export const command = {
+    name: 'watch [dir]',
+    description: 'Watch project for file changes and incrementally update the graph',
+    options: [
+        ['-d, --db <path>', 'Path to graph.db'],
+        ['--poll', 'Use stat-based polling (default on Windows to avoid ReFS/Dev Drive crashes)'],
+        ['--native', 'Force native OS file watchers instead of polling'],
+        ['--poll-interval <ms>', 'Polling interval in milliseconds (default: 2000)'],
+    ],
+    async execute([dir], opts, ctx) {
+        const root = path.resolve(dir || '.');
+        const engine = ctx.program.opts().engine;
+        if (opts.poll && opts.native) {
+            ctx.program.error('--poll and --native are mutually exclusive');
+        }
+        // Explicit --poll or --native wins; otherwise let watcher auto-detect by platform
+        const poll = opts.poll ? true : opts.native ? false : undefined;
+        await watchProject(root, {
+            engine,
+            poll,
+            pollInterval: opts.pollInterval ? Number(opts.pollInterval) : undefined,
+            dbPath: opts.db ? path.resolve(opts.db) : undefined,
+        });
+    },
+};
+//# sourceMappingURL=watch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../../src/cli/commands/watch.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAG7D,MAAM,CAAC,MAAM,OAAO,GAAsB;IACxC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,mEAAmE;IAChF,OAAO,EAAE;QACP,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;QACvC,CAAC,QAAQ,EAAE,6EAA6E,CAAC;QACzF,CAAC,UAAU,EAAE,kDAAkD,CAAC;QAChE,CAAC,sBAAsB,EAAE,kDAAkD,CAAC;KAC7E;IACD,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,GAAG;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC;QACzC,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC7B,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAClE,CAAC;QACD,kFAAkF;QAClF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QAChE,MAAM,YAAY,CAAC,IAAI,EAAE;YACvB,MAAM;YACN,IAAI;YACJ,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS;YACvE,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;SACpD,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

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

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

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

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

package/dist/cli/commands/where.js

@@ -0,0 +1,20 @@
+import { where } from '../../presentation/queries-cli.js';
+export const command = {
+    name: 'where [name]',
+    description: 'Find where a symbol is defined and used (minimal, fast lookup)',
+    queryOpts: true,
+    options: [['-f, --file <path>', 'File overview: list symbols, imports, exports']],
+    validate([name], opts) {
+        if (!name && !opts.file) {
+            return 'Provide a symbol name or use --file <path>';
+        }
+    },
+    execute([name], opts, ctx) {
+        const target = (opts.file || name);
+        where(target, opts.db, {
+            file: !!opts.file,
+            ...ctx.resolveQueryOpts(opts),
+        });
+    },
+};
+//# sourceMappingURL=where.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"where.js","sourceRoot":"","sources":["../../../src/cli/commands/where.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAG1D,MAAM,CAAC,MAAM,OAAO,GAAsB;IACxC,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,gEAAgE;IAC7E,SAAS,EAAE,IAAI;IACf,OAAO,EAAE,CAAC,CAAC,mBAAmB,EAAE,+CAA+C,CAAC,CAAC;IACjF,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI;QACnB,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACxB,OAAO,4CAA4C,CAAC;QACtD,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG;QACvB,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAW,CAAC;QAC7C,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE;YACrB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI;YACjB,GAAG,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC;SAC9B,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,22 @@
+import { Command } from 'commander';
+import type { CliContext, CommandDefinition } from './types.js';
+declare const program: Command;
+/** Shared context passed to every command's execute(). */
+declare const ctx: CliContext;
+/**
+ * Register a command definition onto a Commander parent.
+ *
+ * Command shape:
+ *   { name, description, queryOpts?, options?, validate?, execute(args, opts, ctx), subcommands? }
+ *
+ * - `name` includes positional args, e.g. 'build [dir]' or 'path <from> <to>'
+ * - `queryOpts` (boolean) — if true, attaches shared query options
+ * - `options` — array of arrays passed to cmd.option(), e.g. [['--depth <n>', 'Max depth', '3']]
+ * - `validate(args, opts, ctx)` — return an error string to abort, or falsy to proceed
+ * - `execute(args, opts, ctx)` — the action handler
+ * - `subcommands` — nested command definitions (for groups like registry, snapshot)
+ */
+declare function registerCommand(parent: Command, def: CommandDefinition): Command;
+export declare function run(): Promise<void>;
+export { ctx, program, registerCommand };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAe,MAAM,YAAY,CAAC;AAK7E,QAAA,MAAM,OAAO,SAAgB,CAAC;AA8B9B,0DAA0D;AAC1D,QAAA,MAAM,GAAG,EAAE,UAOV,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,iBAAS,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAoCzE;AA2CD,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAGzC;AAED,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,139 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { Command } from 'commander';
+import { setUserConfigOverride } from '../infrastructure/config.js';
+import { setVerbose } from '../infrastructure/logger.js';
+import { checkForUpdates, printUpdateNotification } from '../infrastructure/update-check.js';
+import { ConfigError } from '../shared/errors.js';
+import { applyQueryOpts, config, formatSize, resolveNoTests, resolveQueryOpts, } from './shared/options.js';
+import { outputResult } from './shared/output.js';
+const __cliDir = path.dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(fs.readFileSync(path.join(__cliDir, '..', '..', 'package.json'), 'utf-8'));
+const program = new Command();
+program
+    .name('codegraph')
+    .description('Local code dependency graph tool')
+    .version(pkg.version)
+    .option('-v, --verbose', 'Enable verbose/debug output')
+    .option('--engine <engine>', 'Parser engine: native, wasm, or auto (default: auto)', 'auto')
+    .option('--user-config [path]', 'Apply global user config for this run (optional custom path)')
+    .option('--no-user-config', 'Skip global user config for this run')
+    .hook('preAction', (thisCommand) => {
+    const opts = thisCommand.opts();
+    if (opts.verbose)
+        setVerbose(true);
+    // Wire user-config flags into the config loader before any command runs.
+    // Commander sets opts.userConfig = true (bare flag), a string (path), or undefined.
+    // opts.userConfig is false when --no-user-config is passed (Commander negation).
+    const uc = opts.userConfig;
+    setUserConfigOverride(uc);
+})
+    .hook('postAction', async (_thisCommand, actionCommand) => {
+    const name = actionCommand.name();
+    if (name === 'mcp' || name === 'watch')
+        return;
+    if (actionCommand.opts().json)
+        return;
+    try {
+        const result = await checkForUpdates(pkg.version);
+        if (result)
+            printUpdateNotification(result.current, result.latest);
+    }
+    catch {
+        /* never break CLI */
+    }
+});
+/** Shared context passed to every command's execute(). */
+const ctx = {
+    config,
+    resolveNoTests,
+    resolveQueryOpts,
+    formatSize,
+    outputResult: outputResult,
+    program,
+};
+/**
+ * Register a command definition onto a Commander parent.
+ *
+ * Command shape:
+ *   { name, description, queryOpts?, options?, validate?, execute(args, opts, ctx), subcommands? }
+ *
+ * - `name` includes positional args, e.g. 'build [dir]' or 'path <from> <to>'
+ * - `queryOpts` (boolean) — if true, attaches shared query options
+ * - `options` — array of arrays passed to cmd.option(), e.g. [['--depth <n>', 'Max depth', '3']]
+ * - `validate(args, opts, ctx)` — return an error string to abort, or falsy to proceed
+ * - `execute(args, opts, ctx)` — the action handler
+ * - `subcommands` — nested command definitions (for groups like registry, snapshot)
+ */
+function registerCommand(parent, def) {
+    const cmd = parent.command(def.name).description(def.description);
+    if (def.alias)
+        cmd.alias(def.alias);
+    if (def.queryOpts)
+        applyQueryOpts(cmd);
+    for (const opt of def.options || []) {
+        cmd.option(...opt);
+    }
+    if (def.execute) {
+        const argCount = (def.name.match(/<[^>]+>|\[[^\]]+\]/g) || []).length;
+        cmd.action((...actionArgs) => {
+            const args = actionArgs.slice(0, argCount);
+            const opts = actionArgs[argCount];
+            if (def.validate) {
+                const err = def.validate(args, opts, ctx);
+                if (err) {
+                    throw new ConfigError(err);
+                }
+            }
+            return def.execute(args, opts, ctx);
+        });
+    }
+    if (def.subcommands) {
+        for (const sub of def.subcommands) {
+            registerCommand(cmd, sub);
+        }
+    }
+    return cmd;
+}
+/**
+ * Auto-discover and register all command modules from src/cli/commands/.
+ * Each module must export a `command` (single definition) or `commands` (array).
+ */
+async function discoverCommands() {
+    const commandsDir = path.join(__cliDir, 'commands');
+    const files = fs
+        .readdirSync(commandsDir)
+        .filter((f) => f.endsWith('.js') || f.endsWith('.ts'))
+        .filter((f) => !f.endsWith('.d.ts'))
+        .sort();
+    // Deduplicate: prefer .ts over .js when both exist
+    const fileSet = new Set(files);
+    const seen = new Set();
+    const deduped = [];
+    for (const file of files) {
+        const base = file.replace(/\.[jt]s$/, '');
+        if (!seen.has(base)) {
+            seen.add(base);
+            const tsVariant = `${base}.ts`;
+            deduped.push(fileSet.has(tsVariant) ? tsVariant : file);
+        }
+    }
+    for (const file of deduped) {
+        const mod = (await import(pathToFileURL(path.join(commandsDir, file)).href));
+        if (mod.command) {
+            registerCommand(program, mod.command);
+        }
+        if (mod.commands) {
+            for (const def of mod.commands) {
+                registerCommand(program, def);
+            }
+        }
+    }
+}
+export async function run() {
+    await discoverCommands();
+    await program.parseAsync();
+}
+export { ctx, program, registerCommand };
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/shared/open-graph.d.ts

@@ -0,0 +1,11 @@
+import type { BetterSqlite3Database } from '../../types.js';
+/**
+ * Open the graph database in readonly mode with a clean close() handle.
+ */
+export declare function openGraph(opts?: {
+    db?: string;
+}): {
+    db: BetterSqlite3Database;
+    close: () => void;
+};
+//# sourceMappingURL=open-graph.d.ts.map

package/dist/cli/shared/open-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-graph.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/open-graph.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,GAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG;IACrD,EAAE,EAAE,qBAAqB,CAAC;IAC1B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAGA"}

package/dist/cli/shared/open-graph.js

@@ -0,0 +1,9 @@
+import { openReadonlyOrFail } from '../../db/index.js';
+/**
+ * Open the graph database in readonly mode with a clean close() handle.
+ */
+export function openGraph(opts = {}) {
+    const db = openReadonlyOrFail(opts.db);
+    return { db, close: () => db.close() };
+}
+//# sourceMappingURL=open-graph.js.map

package/dist/cli/shared/open-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-graph.js","sourceRoot":"","sources":["../../../src/cli/shared/open-graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGvD;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,OAAwB,EAAE;IAIlD,MAAM,EAAE,GAAG,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC;AACzC,CAAC"}

package/dist/cli/shared/options.d.ts

@@ -0,0 +1,25 @@
+import type { Command } from 'commander';
+import type { CodegraphConfig } from '../../types.js';
+import type { CommandOpts } from '../types.js';
+declare const config: CodegraphConfig;
+/**
+ * Attach the common query options shared by most analysis commands.
+ */
+export declare function applyQueryOpts(cmd: Command): Command;
+/**
+ * Resolve the effective noTests value: CLI flag > config > false.
+ * Commander sets opts.tests to false when --no-tests is passed.
+ * When --include-tests is passed, always return false (include tests).
+ * Otherwise, fall back to config.query.excludeTests.
+ */
+export declare function resolveNoTests(opts: CommandOpts): boolean;
+/**
+ * Extract the common query option fields shared by most analysis commands.
+ *
+ * Spreads cleanly into per-command option objects:
+ *   `{ ...resolveQueryOpts(opts), depth: parseInt(opts.depth, 10) }`
+ */
+export declare function resolveQueryOpts(opts: CommandOpts): CommandOpts;
+export declare function formatSize(bytes: number): string;
+export { config };
+//# sourceMappingURL=options.d.ts.map

package/dist/cli/shared/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM/C,QAAA,MAAM,MAAM,EAAE,eAKO,CAAC;AAEtB;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAWpD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAIzD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAU/D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/cli/shared/options.js

@@ -0,0 +1,66 @@
+import { loadConfig } from '../../infrastructure/config.js';
+// Deferred so global --user-config / --no-user-config flags are parsed
+// before config is first accessed (Commander parses flags before any command
+// action runs, but module-level code executes at import time).
+let _config;
+const config = new Proxy({}, {
+    get(_t, prop) {
+        if (_config === undefined)
+            _config = loadConfig(process.cwd());
+        return _config[prop];
+    },
+});
+/**
+ * Attach the common query options shared by most analysis commands.
+ */
+export function applyQueryOpts(cmd) {
+    return cmd
+        .option('-d, --db <path>', 'Path to graph.db')
+        .option('-T, --no-tests', 'Exclude test/spec files from results')
+        .option('--include-tests', 'Include test/spec files (overrides excludeTests config)')
+        .option('-j, --json', 'Output as JSON')
+        .option('-n, --limit <number>', 'Max results to return')
+        .option('--offset <number>', 'Skip N results (default: 0)')
+        .option('--ndjson', 'Newline-delimited JSON output')
+        .option('--table', 'Output as aligned table')
+        .option('--csv', 'Output as CSV');
+}
+/**
+ * Resolve the effective noTests value: CLI flag > config > false.
+ * Commander sets opts.tests to false when --no-tests is passed.
+ * When --include-tests is passed, always return false (include tests).
+ * Otherwise, fall back to config.query.excludeTests.
+ */
+export function resolveNoTests(opts) {
+    if (opts.includeTests)
+        return false;
+    if (opts.tests === false)
+        return true;
+    return config.query?.excludeTests || false;
+}
+/**
+ * Extract the common query option fields shared by most analysis commands.
+ *
+ * Spreads cleanly into per-command option objects:
+ *   `{ ...resolveQueryOpts(opts), depth: parseInt(opts.depth, 10) }`
+ */
+export function resolveQueryOpts(opts) {
+    return {
+        noTests: resolveNoTests(opts),
+        json: opts.json,
+        ndjson: opts.ndjson,
+        table: opts.table,
+        csv: opts.csv,
+        limit: opts.limit ? parseInt(opts.limit, 10) : undefined,
+        offset: opts.offset ? parseInt(opts.offset, 10) : undefined,
+    };
+}
+export function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+export { config };
+//# sourceMappingURL=options.js.map

package/dist/cli/shared/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/cli/shared/options.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAI5D,uEAAuE;AACvE,6EAA6E;AAC7E,+DAA+D;AAC/D,IAAI,OAAoC,CAAC;AACzC,MAAM,MAAM,GAAoB,IAAI,KAAK,CAAC,EAAqB,EAAE;IAC/D,GAAG,CAAC,EAAE,EAAE,IAAY;QAClB,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC/D,OAAO,OAAO,CAAC,IAA6B,CAAC,CAAC;IAChD,CAAC;CACF,CAAoB,CAAC;AAEtB;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,OAAO,GAAG;SACP,MAAM,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;SAC7C,MAAM,CAAC,gBAAgB,EAAE,sCAAsC,CAAC;SAChE,MAAM,CAAC,iBAAiB,EAAE,yDAAyD,CAAC;SACpF,MAAM,CAAC,YAAY,EAAE,gBAAgB,CAAC;SACtC,MAAM,CAAC,sBAAsB,EAAE,uBAAuB,CAAC;SACvD,MAAM,CAAC,mBAAmB,EAAE,6BAA6B,CAAC;SAC1D,MAAM,CAAC,UAAU,EAAE,+BAA+B,CAAC;SACnD,MAAM,CAAC,SAAS,EAAE,yBAAyB,CAAC;SAC5C,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAiB;IAC9C,IAAI,IAAI,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC;IACpC,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,MAAM,CAAC,KAAK,EAAE,YAAY,IAAI,KAAK,CAAC;AAC7C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAiB;IAChD,OAAO;QACL,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC;QAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;QACxD,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;KAC5D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,IAAI,CAAC;IACtC,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAClE,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AACpD,CAAC;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/cli/shared/output.d.ts

@@ -0,0 +1,2 @@
+export { outputResult } from '../../infrastructure/result-formatter.js';
+//# sourceMappingURL=output.d.ts.map

package/dist/cli/shared/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC"}

package/dist/cli/shared/output.js

@@ -0,0 +1,2 @@
+export { outputResult } from '../../infrastructure/result-formatter.js';
+//# sourceMappingURL=output.js.map

package/dist/cli/shared/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../../src/cli/shared/output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC"}

package/dist/cli/types.d.ts

@@ -0,0 +1,32 @@
+import type { Command } from 'commander';
+/**
+ * Commander options are inherently dynamic — the set of keys depends on
+ * how each command defines its `.option()` calls at runtime.  Using a
+ * concrete index-signature type (`Record<string, …>`) triggers
+ * `noPropertyAccessFromIndexSignature` and forces bracket notation
+ * everywhere, which hurts readability for no safety gain.  A dedicated
+ * opaque alias keeps the intent clear while allowing dot access.
+ */
+export type CommandOpts = any;
+/** Shape of the shared context passed to every command's execute(). */
+export interface CliContext {
+    config: CommandOpts;
+    resolveNoTests: (opts: CommandOpts) => boolean;
+    resolveQueryOpts: (opts: CommandOpts) => CommandOpts;
+    formatSize: (bytes: number) => string;
+    outputResult: (data: unknown, key: string, opts: CommandOpts) => boolean;
+    program: Command;
+}
+/** Shape of a command definition registered via registerCommand(). */
+export interface CommandDefinition {
+    name: string;
+    description: string;
+    /** Optional Commander.js alias (e.g. 'explain' for the 'audit' command). */
+    alias?: string;
+    queryOpts?: boolean;
+    options?: Array<[string, string, ...unknown[]]>;
+    validate?(args: string[], opts: CommandOpts, ctx: CliContext): string | undefined;
+    execute?(args: string[], opts: CommandOpts, ctx: CliContext): void | Promise<void>;
+    subcommands?: CommandDefinition[];
+}
+//# sourceMappingURL=types.d.ts.map