ts-knowledge-graph 0.1.1 → 0.1.2

package/dist/agent/agent_tools.js

@@ -0,0 +1,153 @@
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+export const PROPOSE_TOOL_NAME = 'propose_optimization';
+export const AGENT_TOOLS = [
+    {
+        type: 'function',
+        function: {
+            name: 'find_symbol',
+            description: 'Resolve a symbol name (substring, case-insensitive) to candidate node ids. Always start here to obtain ids; never invent ids.',
+            parameters: {
+                type: 'object',
+                properties: { name: { type: 'string', description: 'symbol name or substring' } },
+                required: ['name'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'who_calls',
+            description: 'List the direct callers of a function/method node id.',
+            parameters: {
+                type: 'object',
+                properties: { id: { type: 'string', description: 'node id from find_symbol' } },
+                required: ['id'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'references',
+            description: 'List everything that references a symbol or type (calls, type usage, heritage, instantiation, value reads). Use this to judge whether a symbol is safe to remove.',
+            parameters: {
+                type: 'object',
+                properties: { id: { type: 'string', description: 'node id from find_symbol' } },
+                required: ['id'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'blast_radius',
+            description: 'List every symbol transitively impacted by changing a node id (transitive callers).',
+            parameters: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string', description: 'node id from find_symbol' },
+                    depth: { type: 'integer', description: 'max traversal depth (default 10)' },
+                },
+                required: ['id'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'neighbors',
+            description: 'Show the one-hop neighbourhood (incoming and outgoing edges) of a node id.',
+            parameters: {
+                type: 'object',
+                properties: { id: { type: 'string', description: 'node id from find_symbol' } },
+                required: ['id'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'dead_exports',
+            description: 'List exported symbols that have no inbound references anywhere in the project — prime candidates for safe removal.',
+            parameters: { type: 'object', properties: {} },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'read_file',
+            description: 'Read a project source file (optionally a line range) to see exact text before proposing an edit.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    path: { type: 'string', description: 'project-relative file path, e.g. src/schema/node.ts' },
+                    startLine: { type: 'integer', description: 'first line (1-based, optional)' },
+                    endLine: { type: 'integer', description: 'last line (inclusive, optional)' },
+                },
+                required: ['path'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: PROPOSE_TOOL_NAME,
+            description: 'Propose ONE safe edit. The harness applies it, runs the TypeScript type-checker, and keeps it only if type-checking passes (otherwise it is reverted and you get the errors). `find` must match the file exactly and uniquely.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    filePath: { type: 'string', description: 'project-relative file path' },
+                    find: { type: 'string', description: 'exact text to replace (must be unique in the file)' },
+                    replace: { type: 'string', description: 'replacement text (empty string to delete)' },
+                    rationale: { type: 'string', description: 'why this change is safe and beneficial' },
+                },
+                required: ['filePath', 'find', 'replace', 'rationale'],
+            },
+        },
+    },
+];
+export class AgentTools {
+    constructor(query, rootPath) {
+        this.query = query;
+        this.rootPath = rootPath;
+    }
+    async dispatch(name, input) {
+        switch (name) {
+            case 'find_symbol':
+                return AgentTools.stringify(await this.query.find(String(input.name)));
+            case 'who_calls':
+                return AgentTools.stringify(await this.query.whoCalls(String(input.id)));
+            case 'references':
+                return AgentTools.stringify(await this.query.references(String(input.id)));
+            case 'blast_radius':
+                return AgentTools.stringify(await this.query.blastRadius(String(input.id), Number(input.depth ?? 10)));
+            case 'neighbors':
+                return AgentTools.stringify(await this.query.neighborhood(String(input.id)));
+            case 'dead_exports':
+                return AgentTools.stringify(await this.query.deadExports());
+            case 'read_file':
+                return this.readFile(input);
+            default:
+                return `unknown tool: ${name}`;
+        }
+    }
+    async readFile(input) {
+        const absolute = resolve(this.rootPath, String(input.path));
+        const content = await readFile(absolute, 'utf8').catch(() => undefined);
+        if (content === undefined) {
+            return `file not found: ${String(input.path)}`;
+        }
+        const lines = content.split('\n');
+        const start = input.startLine === undefined ? 1 : Number(input.startLine);
+        const end = input.endLine === undefined ? lines.length : Number(input.endLine);
+        return lines
+            .slice(start - 1, end)
+            .map((line, index) => `${start + index}\t${line}`)
+            .join('\n');
+    }
+    static stringify(value) {
+        return JSON.stringify(value, null, 2);
+    }
+}
+//# sourceMappingURL=agent_tools.js.map

package/dist/agent/agent_tools.js.map

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

package/dist/agent/code_editor.d.ts

@@ -0,0 +1,18 @@
+export type EditRequest = {
+    filePath: string;
+    find: string;
+    replace: string;
+};
+export type EditResult = {
+    ok: boolean;
+    message: string;
+};
+export declare class CodeEditor {
+    private readonly rootPath;
+    private readonly backups;
+    constructor(rootPath: string);
+    apply(request: EditRequest): Promise<EditResult>;
+    revert(filePath: string): Promise<void>;
+    private static readSafe;
+}
+//# sourceMappingURL=code_editor.d.ts.map

package/dist/agent/code_editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code_editor.d.ts","sourceRoot":"","sources":["../../src/agent/code_editor.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,GAAG;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACxB,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,qBAAa,UAAU;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;gBAEzC,QAAQ,EAAE,MAAM;IAItB,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAoBhD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;mBAQxB,QAAQ;CAO7B"}

package/dist/agent/code_editor.js

@@ -0,0 +1,43 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+export class CodeEditor {
+    constructor(rootPath) {
+        this.backups = new Map();
+        this.rootPath = rootPath;
+    }
+    async apply(request) {
+        const absolute = resolve(this.rootPath, request.filePath);
+        const original = await CodeEditor.readSafe(absolute);
+        if (original === undefined) {
+            return { ok: false, message: `file not found: ${request.filePath}` };
+        }
+        const occurrences = original.split(request.find).length - 1;
+        if (occurrences === 0) {
+            return { ok: false, message: 'find text not found in file' };
+        }
+        if (occurrences > 1) {
+            return { ok: false, message: `find text matched ${occurrences} times; include more surrounding context to make it unique` };
+        }
+        if (this.backups.has(absolute) === false) {
+            this.backups.set(absolute, original);
+        }
+        await writeFile(absolute, original.replace(request.find, request.replace), 'utf8');
+        return { ok: true, message: 'applied' };
+    }
+    async revert(filePath) {
+        const absolute = resolve(this.rootPath, filePath);
+        const original = this.backups.get(absolute);
+        if (original !== undefined) {
+            await writeFile(absolute, original, 'utf8');
+        }
+    }
+    static async readSafe(absolute) {
+        try {
+            return await readFile(absolute, 'utf8');
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+//# sourceMappingURL=code_editor.js.map

package/dist/agent/code_editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code_editor.js","sourceRoot":"","sources":["../../src/agent/code_editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,MAAM,OAAO,UAAU;IAItB,YAAY,QAAgB;QAFX,YAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;QAGpD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,OAAoB;QAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;QACtE,CAAC;QACD,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5D,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC;QAC9D,CAAC;QACD,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,qBAAqB,WAAW,4DAA4D,EAAE,CAAC;QAC7H,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,KAAK,EAAE,CAAC;YAC1C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;QACnF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAgB;QAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC7C,CAAC;IACF,CAAC;IAEO,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAgB;QAC7C,IAAI,CAAC;YACJ,OAAO,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,SAAS,CAAC;QAClB,CAAC;IACF,CAAC;CACD"}

package/dist/agent/optimizer_agent.d.ts

@@ -0,0 +1,30 @@
+import { AgentTools } from './agent_tools.js';
+import { CodeEditor } from './code_editor.js';
+export type AppliedEdit = {
+    filePath: string;
+    rationale: string;
+};
+export type OptimizeOutcome = {
+    applied: AppliedEdit[];
+    transcript: string[];
+};
+export type OptimizerParams = {
+    tools: AgentTools;
+    editor: CodeEditor;
+    rootPath: string;
+    model: string;
+    maxSteps?: number;
+};
+export declare class OptimizerAgent {
+    private readonly client;
+    private readonly tools;
+    private readonly editor;
+    private readonly rootPath;
+    private readonly model;
+    private readonly maxSteps;
+    constructor(params: OptimizerParams);
+    run(task: string): Promise<OptimizeOutcome>;
+    private applyAndVerify;
+    private static parseArguments;
+}
+//# sourceMappingURL=optimizer_agent.d.ts.map

package/dist/agent/optimizer_agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimizer_agent.d.ts","sourceRoot":"","sources":["../../src/agent/optimizer_agent.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,UAAU,EAAqB,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAmB9C,MAAM,MAAM,WAAW,GAAG;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC7B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,MAAM,EAAE,eAAe;IAS7B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;YA0CnC,cAAc;IA4B5B,OAAO,CAAC,MAAM,CAAC,cAAc;CAW7B"}

package/dist/agent/optimizer_agent.js

@@ -0,0 +1,97 @@
+import OpenAI from 'openai';
+import { AGENT_TOOLS, PROPOSE_TOOL_NAME } from './agent_tools.js';
+import { Verifier } from './verifier.js';
+const SYSTEM_PROMPT = `You are an autonomous TypeScript optimization agent working on a real codebase.
+
+You have a code knowledge graph at your disposal through tools. Use it as your eyes.
+
+Method (follow it):
+1. Find a candidate. Dead code is the safest win — call dead_exports first, or find_symbol for a named target.
+2. Understand the blast radius. Before proposing ANY change you MUST confirm safety with references / who_calls / blast_radius. A symbol is safe to remove only when it has zero inbound references.
+3. Read the exact text with read_file so your edit matches the file precisely.
+4. Propose exactly ONE edit via ${PROPOSE_TOOL_NAME}. The harness type-checks it and keeps it only if the check passes; on failure you receive the compiler errors and must fix or abandon.
+
+Rules:
+- ids come from tool results; never invent them.
+- Act autonomously — do not ask the user questions. Make the call yourself.
+- Prefer removing genuinely dead exports or behavior-preserving simplifications. Never change observable behavior.
+- When you have applied a verified improvement (or concluded there is no safe one), stop and summarize.`;
+export class OptimizerAgent {
+    constructor(params) {
+        this.client = new OpenAI();
+        this.tools = params.tools;
+        this.editor = params.editor;
+        this.rootPath = params.rootPath;
+        this.model = params.model;
+        this.maxSteps = params.maxSteps ?? 12;
+    }
+    async run(task) {
+        const messages = [
+            { role: 'system', content: SYSTEM_PROMPT },
+            { role: 'user', content: task },
+        ];
+        const applied = [];
+        const transcript = [];
+        for (let step = 0; step < this.maxSteps; step += 1) {
+            const completion = await this.client.chat.completions.create({
+                model: this.model,
+                messages,
+                tools: AGENT_TOOLS,
+            });
+            const message = completion.choices[0].message;
+            messages.push(message);
+            if (typeof message.content === 'string' && message.content.length > 0) {
+                transcript.push(message.content);
+            }
+            const toolCalls = message.tool_calls ?? [];
+            if (toolCalls.length === 0) {
+                break;
+            }
+            for (const call of toolCalls) {
+                if (call.type !== 'function') {
+                    messages.push({ role: 'tool', tool_call_id: call.id, content: 'unsupported tool call type' });
+                    continue;
+                }
+                const input = OptimizerAgent.parseArguments(call.function.arguments);
+                const content = call.function.name === PROPOSE_TOOL_NAME
+                    ? await this.applyAndVerify(input, applied, transcript)
+                    : await this.tools.dispatch(call.function.name, input);
+                messages.push({ role: 'tool', tool_call_id: call.id, content });
+            }
+        }
+        return { applied, transcript };
+    }
+    async applyAndVerify(input, applied, transcript) {
+        const request = {
+            filePath: String(input.filePath),
+            find: String(input.find),
+            replace: String(input.replace),
+        };
+        const rationale = String(input.rationale ?? '');
+        const edit = await this.editor.apply(request);
+        if (edit.ok === false) {
+            return `EDIT REJECTED: ${edit.message}`;
+        }
+        const verify = await Verifier.typecheck(this.rootPath);
+        if (verify.ok === false) {
+            await this.editor.revert(request.filePath);
+            return `TYPECHECK FAILED — change reverted. Fix the approach or abandon it. Compiler output:\n${verify.output}`;
+        }
+        applied.push({ filePath: request.filePath, rationale });
+        transcript.push(`APPLIED ${request.filePath} — ${rationale}`);
+        return 'VERIFIED: the type-checker passed and the edit was kept.';
+    }
+    static parseArguments(raw) {
+        try {
+            const parsed = JSON.parse(raw);
+            if (typeof parsed === 'object' && parsed !== null) {
+                return parsed;
+            }
+            return {};
+        }
+        catch {
+            return {};
+        }
+    }
+}
+//# sourceMappingURL=optimizer_agent.js.map

package/dist/agent/optimizer_agent.js.map

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

package/dist/cli.d.ts

@@ -1,14 +1,5 @@
 #!/usr/bin/env node
 export declare class Cli {
     static run(argv: string[]): void;
-    private static registerQuery;
-    private static extract;
-    private static load;
-    private static optimize;
-    private static withQuery;
-    private static printRefs;
-    private static printNeighbors;
-    private static printBreakdown;
-    private static countBy;
 }
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAmCA,qBAAa,GAAG;IACf,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAoFhC,OAAO,CAAC,MAAM,CAAC,aAAa;mBAoBP,OAAO;mBAkBP,IAAI;mBAWJ,QAAQ;mBAuCR,SAAS;IAU9B,OAAO,CAAC,MAAM,CAAC,SAAS;IAexB,OAAO,CAAC,MAAM,CAAC,cAAc;IAgB7B,OAAO,CAAC,MAAM,CAAC,cAAc;IAW7B,OAAO,CAAC,MAAM,CAAC,OAAO;CAOtB"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAeA,qBAAa,GAAG;IACf,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;CAqBhC"}

package/dist/cli.js

@@ -1,221 +1,37 @@
 #!/usr/bin/env node
-import { existsSync } from 'node:fs';
-import { resolve } from 'node:path';
-import chalk from 'chalk';
 import { Command } from 'commander';
-import { AgentTools } from './agent/agent-tools.js';
-import { CodeEditor } from './agent/code-editor.js';
-import { OptimizerAgent } from './agent/optimizer-agent.js';
-import { GraphBuilder } from './extract/graph-builder.js';
-import { ProjectLoader } from './extract/project-loader.js';
-import { GraphQuery } from './query/graph-query.js';
-import { JsonlReader } from './store/jsonl-reader.js';
-import { JsonlStore } from './store/jsonl-store.js';
-import { KuzuStore } from './store/kuzu-store.js';
-const DEFAULT_TASK = 'Find one genuinely dead exported symbol using dead_exports, confirm with references that it has zero inbound references, then remove it safely.';
-const DEFAULT_DB_PATH = './outputs/graph.kuzu';
-const DEFAULT_GRAPH_DIR = './outputs/graph';
+import { BlastRadiusCommand } from './commands/blast_radius_command.js';
+import { CallsCommand } from './commands/calls_command.js';
+import { DeadExportsCommand } from './commands/dead_exports_command.js';
+import { ExtractCommand } from './commands/extract_command.js';
+import { FindCommand } from './commands/find_command.js';
+import { InstallCommand } from './commands/install_command.js';
+import { LoadCommand } from './commands/load_command.js';
+import { NeighborsCommand } from './commands/neighbors_command.js';
+import { OptimizeCommand } from './commands/optimize_command.js';
+import { ReferencesCommand } from './commands/references_command.js';
+import { WebCommand } from './commands/web_command.js';
+import { WhoCallsCommand } from './commands/who_calls_command.js';
 export class Cli {
     static run(argv) {
         const program = new Command();
         program
             .name('ts-knowledge-graph')
             .description('Parse a TypeScript project into a knowledge graph and query it');
-        program
-            .command('extract')
-            .argument('<root>', 'path to the TypeScript project to parse')
-            .option('-o, --out <dir>', 'output directory for the JSONL graph', DEFAULT_GRAPH_DIR)
-            .option('--semantic', 'resolve heritage and CALLS edges (slower)', false)
-            .action(async (root, options) => {
-            await Cli.extract(root, options);
-        });
-        program
-            .command('load')
-            .description('load a JSONL graph into an embedded Kùzu database')
-            .argument('[graphDir]', 'directory holding nodes.jsonl and edges.jsonl', DEFAULT_GRAPH_DIR)
-            .option('-d, --db <path>', 'Kùzu database path', DEFAULT_DB_PATH)
-            .action(async (graphDir, options) => {
-            await Cli.load(graphDir, options.db);
-        });
-        Cli.registerQuery(program, 'find', '<pattern>', 'find symbols whose name contains <pattern>', (query, arg) => query.find(arg));
-        Cli.registerQuery(program, 'who-calls', '<id>', 'list symbols that call <id>', (query, arg) => query.whoCalls(arg));
-        Cli.registerQuery(program, 'calls', '<id>', 'list symbols that <id> calls', (query, arg) => query.calls(arg));
-        Cli.registerQuery(program, 'dead-exports', '', 'list exported symbols with no inbound references', (query) => query.deadExports());
-        program
-            .command('blast-radius')
-            .description('list every symbol transitively impacted by changing <id>')
-            .argument('<id>', 'node id to analyse')
-            .option('-d, --db <path>', 'Kùzu database path', DEFAULT_DB_PATH)
-            .option('--depth <n>', 'maximum traversal depth', '10')
-            .option('--json', 'emit raw JSON', false)
-            .action(async (id, options) => {
-            await Cli.withQuery(options.db, async (query) => {
-                Cli.printRefs(await query.blastRadius(id, Number(options.depth)), options.json === true);
-            });
-        });
-        program
-            .command('neighbors')
-            .description('show the one-hop neighbourhood of <id>')
-            .argument('<id>', 'node id to inspect')
-            .option('-d, --db <path>', 'Kùzu database path', DEFAULT_DB_PATH)
-            .option('--json', 'emit raw JSON', false)
-            .action(async (id, options) => {
-            await Cli.withQuery(options.db, async (query) => {
-                Cli.printNeighbors(await query.neighborhood(id), options.json === true);
-            });
-        });
-        program
-            .command('references')
-            .description('list everything that references <id> (calls, type usage, heritage, new)')
-            .argument('<id>', 'node id to inspect')
-            .option('-d, --db <path>', 'Kùzu database path', DEFAULT_DB_PATH)
-            .option('--json', 'emit raw JSON', false)
-            .action(async (id, options) => {
-            await Cli.withQuery(options.db, async (query) => {
-                Cli.printNeighbors(await query.references(id), options.json === true);
-            });
-        });
-        program
-            .command('optimize')
-            .description('run the autonomous optimization agent against the loaded graph')
-            .argument('[task]', 'what the agent should try to optimize', DEFAULT_TASK)
-            .option('-d, --db <path>', 'Kùzu database path', DEFAULT_DB_PATH)
-            .option('-m, --model <name>', 'model name (defaults to OPENAI_MODEL)')
-            .option('--max-steps <n>', 'maximum agent steps', '12')
-            .action(async (task, options) => {
-            await Cli.optimize(task, options);
-        });
+        ExtractCommand.register(program);
+        LoadCommand.register(program);
+        FindCommand.register(program);
+        WhoCallsCommand.register(program);
+        CallsCommand.register(program);
+        DeadExportsCommand.register(program);
+        BlastRadiusCommand.register(program);
+        NeighborsCommand.register(program);
+        ReferencesCommand.register(program);
+        OptimizeCommand.register(program);
+        WebCommand.register(program);
+        InstallCommand.register(program);
         void program.parseAsync(argv);
     }
-    static registerQuery(program, name, argSpec, description, run) {
-        const command = program.command(argSpec === '' ? name : `${name} ${argSpec}`).description(description);
-        command
-            .option('-d, --db <path>', 'Kùzu database path', DEFAULT_DB_PATH)
-            .option('--json', 'emit raw JSON', false)
-            .action(async (...args) => {
-            const options = args[args.length - 2];
-            const arg = argSpec === '' ? '' : args[0];
-            await Cli.withQuery(options.db, async (query) => {
-                Cli.printRefs(await run(query, arg), options.json === true);
-            });
-        });
-    }
-    static async extract(root, options) {
-        const rootPath = resolve(root);
-        const outPath = resolve(options.out);
-        console.log(chalk.cyan(`Loading project at ${rootPath} ...`));
-        const project = ProjectLoader.load(rootPath);
-        const builder = new GraphBuilder();
-        builder.build(project, rootPath, { semantic: options.semantic });
-        const nodes = builder.getNodes();
-        const edges = builder.getEdges();
-        await JsonlStore.write(outPath, nodes, edges);
-        console.log(chalk.green(`✓ ${nodes.length} nodes, ${edges.length} edges -> ${outPath}`));
-        Cli.printBreakdown(nodes, edges);
-    }
-    static async load(graphDir, dbPath) {
-        const resolvedDb = resolve(dbPath);
-        console.log(chalk.cyan(`Loading ${resolve(graphDir)} into ${resolvedDb} ...`));
-        const { nodes, edges } = await JsonlReader.read(resolve(graphDir));
-        const store = new KuzuStore(resolvedDb);
-        await store.initSchema();
-        await store.load(nodes, edges);
-        await store.close();
-        console.log(chalk.green(`✓ loaded ${nodes.length} nodes, ${edges.length} edges`));
-    }
-    static async optimize(task, options) {
-        if (existsSync('.env') === true) {
-            process.loadEnvFile('.env');
-        }
-        if (process.env.OPENAI_API_KEY === undefined) {
-            console.log(chalk.red('Set OPENAI_API_KEY before running the optimizer — copy .env-sample to .env and pick a provider.'));
-            return;
-        }
-        const model = options.model ?? process.env.OPENAI_MODEL;
-        if (model === undefined) {
-            console.log(chalk.red('Set OPENAI_MODEL in .env (or pass --model) — see .env-sample for per-provider examples.'));
-            return;
-        }
-        const rootPath = process.cwd();
-        await Cli.withQuery(options.db, async (query) => {
-            const agent = new OptimizerAgent({
-                tools: new AgentTools(query, rootPath),
-                editor: new CodeEditor(rootPath),
-                rootPath,
-                model,
-                maxSteps: Number(options.maxSteps),
-            });
-            console.log(chalk.gray(`Model: ${model}${process.env.OPENAI_BASE_URL === undefined ? '' : ` @ ${process.env.OPENAI_BASE_URL}`}`));
-            console.log(chalk.cyan(`Task: ${task}\n`));
-            const outcome = await agent.run(task);
-            for (const line of outcome.transcript) {
-                console.log(chalk.gray(line));
-            }
-            console.log(chalk.bold(`\nApplied ${outcome.applied.length} verified edit(s):`));
-            for (const edit of outcome.applied) {
-                console.log(`  ${chalk.green('✓')} ${edit.filePath} — ${edit.rationale}`);
-            }
-            if (outcome.applied.length === 0) {
-                console.log(chalk.yellow('  (none — the agent found no safe change, or reverted what it tried)'));
-            }
-        });
-    }
-    static async withQuery(dbPath, fn) {
-        const store = new KuzuStore(resolve(dbPath));
-        await store.initSchema();
-        try {
-            await fn(new GraphQuery(store));
-        }
-        finally {
-            await store.close();
-        }
-    }
-    static printRefs(refs, json) {
-        if (json === true) {
-            console.log(JSON.stringify(refs, null, 2));
-            return;
-        }
-        if (refs.length === 0) {
-            console.log(chalk.yellow('(no results)'));
-            return;
-        }
-        for (const ref of refs) {
-            console.log(`${chalk.gray(ref.kind.padEnd(14))} ${chalk.bold(ref.name)}  ${chalk.gray(`${ref.filePath}:${ref.startLine}`)}`);
-        }
-        console.log(chalk.gray(`\n${refs.length} result(s)`));
-    }
-    static printNeighbors(neighbors, json) {
-        if (json === true) {
-            console.log(JSON.stringify(neighbors, null, 2));
-            return;
-        }
-        if (neighbors.length === 0) {
-            console.log(chalk.yellow('(no neighbours)'));
-            return;
-        }
-        for (const neighbor of neighbors) {
-            const arrow = neighbor.direction === 'out' ? '->' : '<-';
-            console.log(`${chalk.cyan(arrow)} ${chalk.gray(neighbor.edgeKind.padEnd(12))} ${chalk.bold(neighbor.name)}  ${chalk.gray(`${neighbor.filePath}:${neighbor.startLine}`)}`);
-        }
-        console.log(chalk.gray(`\n${neighbors.length} edge(s)`));
-    }
-    static printBreakdown(nodes, edges) {
-        console.log(chalk.bold('\nNodes'));
-        for (const [kind, count] of Cli.countBy(nodes.map((node) => node.kind))) {
-            console.log(`  ${kind.padEnd(16)} ${count}`);
-        }
-        console.log(chalk.bold('\nEdges'));
-        for (const [kind, count] of Cli.countBy(edges.map((edge) => edge.kind))) {
-            console.log(`  ${kind.padEnd(16)} ${count}`);
-        }
-    }
-    static countBy(values) {
-        const counts = new Map();
-        for (const value of values) {
-            counts.set(value, (counts.get(value) ?? 0) + 1);
-        }
-        return [...counts.entries()].sort((a, b) => b[1] - a[1]);
-    }
 }
 Cli.run(process.argv);
 //# sourceMappingURL=cli.js.map