ts-knowledge-graph 0.1.1 → 0.1.2

package/dist/commands/find_command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find_command.d.ts","sourceRoot":"","sources":["../../src/commands/find_command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,qBAAa,WAAW;IACvB,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAIvC"}

package/dist/commands/find_command.js

@@ -0,0 +1,7 @@
+import { CommandHelpers } from './command_helpers.js';
+export class FindCommand {
+    static register(program) {
+        CommandHelpers.registerSymbolQuery(program, 'find', '<pattern>', 'find symbols whose name contains <pattern>', (query, arg) => query.find(arg));
+    }
+}
+//# sourceMappingURL=find_command.js.map

package/dist/commands/find_command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find_command.js","sourceRoot":"","sources":["../../src/commands/find_command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,OAAO,WAAW;IACvB,MAAM,CAAC,QAAQ,CAAC,OAAgB;QAC/B,cAAc,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,4CAA4C,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAC7H,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACnB,CAAC;CACD"}

package/dist/commands/install_command.d.ts

@@ -0,0 +1,16 @@
+import { Command } from 'commander';
+/**
+ * Installs the bundled Claude Code skill into a target project so an agent can
+ * query the knowledge graph through the ts-knowledge-graph CLI.
+ */
+export declare class InstallCommand {
+    static register(program: Command): void;
+    private static run;
+    /**
+     * Resolves the bundled SKILL.md relative to this module. The `../../` prefix
+     * reaches the package root from both `src/commands` (run via tsx) and
+     * `dist/commands` (run from the built output).
+     */
+    private static sourceSkillPath;
+}
+//# sourceMappingURL=install_command.d.ts.map

package/dist/commands/install_command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install_command.d.ts","sourceRoot":"","sources":["../../src/commands/install_command.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC;;;GAGG;AACH,qBAAa,cAAc;IAC1B,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;mBAWlB,GAAG;IAcxB;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;CAI9B"}

package/dist/commands/install_command.js

@@ -0,0 +1,42 @@
+import { copyFileSync, existsSync, mkdirSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import chalk from 'chalk';
+const SKILL_RELATIVE_PATH = 'skills/ts-knowledge-graph/SKILL.md';
+/**
+ * Installs the bundled Claude Code skill into a target project so an agent can
+ * query the knowledge graph through the ts-knowledge-graph CLI.
+ */
+export class InstallCommand {
+    static register(program) {
+        program
+            .command('install')
+            .description('install the ts-knowledge-graph Claude Code skill into a project')
+            .argument('[destFolder]', 'project root to install the skill into', process.cwd())
+            .option('--force', 'overwrite an existing SKILL.md', false)
+            .action(async (destFolder, options) => {
+            await InstallCommand.run(destFolder, options);
+        });
+    }
+    static async run(destFolder, options) {
+        const source = InstallCommand.sourceSkillPath();
+        const target = resolve(destFolder, SKILL_RELATIVE_PATH);
+        if (existsSync(target) === true && options.force === false) {
+            console.log(chalk.yellow(`✗ ${target} already exists — pass --force to overwrite`));
+            return;
+        }
+        mkdirSync(dirname(target), { recursive: true });
+        copyFileSync(source, target);
+        console.log(chalk.green(`✓ installed skill -> ${target}`));
+    }
+    /**
+     * Resolves the bundled SKILL.md relative to this module. The `../../` prefix
+     * reaches the package root from both `src/commands` (run via tsx) and
+     * `dist/commands` (run from the built output).
+     */
+    static sourceSkillPath() {
+        const here = dirname(fileURLToPath(import.meta.url));
+        return resolve(here, '..', '..', SKILL_RELATIVE_PATH);
+    }
+}
+//# sourceMappingURL=install_command.js.map

package/dist/commands/install_command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install_command.js","sourceRoot":"","sources":["../../src/commands/install_command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,mBAAmB,GAAG,oCAAoC,CAAC;AAMjE;;;GAGG;AACH,MAAM,OAAO,cAAc;IAC1B,MAAM,CAAC,QAAQ,CAAC,OAAgB;QAC/B,OAAO;aACL,OAAO,CAAC,SAAS,CAAC;aAClB,WAAW,CAAC,iEAAiE,CAAC;aAC9E,QAAQ,CAAC,cAAc,EAAE,wCAAwC,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;aACjF,MAAM,CAAC,SAAS,EAAE,gCAAgC,EAAE,KAAK,CAAC;aAC1D,MAAM,CAAC,KAAK,EAAE,UAAkB,EAAE,OAAuB,EAAE,EAAE;YAC7D,MAAM,cAAc,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,UAAkB,EAAE,OAAuB;QACnE,MAAM,MAAM,GAAG,cAAc,CAAC,eAAe,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC;QAExD,IAAI,UAAU,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YAC5D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,MAAM,6CAA6C,CAAC,CAAC,CAAC;YACpF,OAAO;QACR,CAAC;QAED,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,wBAAwB,MAAM,EAAE,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAC,eAAe;QAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACrD,OAAO,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,mBAAmB,CAAC,CAAC;IACvD,CAAC;CACD"}

package/dist/commands/load.d.ts

@@ -0,0 +1,6 @@
+import { Command } from 'commander';
+export declare class Load {
+    static register(program: Command): void;
+    private static run;
+}
+//# sourceMappingURL=load.d.ts.map

package/dist/commands/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/commands/load.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,qBAAa,IAAI;IAChB,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;mBAWlB,GAAG;CAUxB"}

package/dist/commands/load.js

@@ -0,0 +1,28 @@
+import { resolve } from 'node:path';
+import chalk from 'chalk';
+import { JsonlReader } from '../store/jsonl_reader.js';
+import { KuzuStore } from '../store/kuzu_store.js';
+import { DEFAULT_DB_PATH, DEFAULT_GRAPH_DIR } from './command_helpers.js';
+export class Load {
+    static register(program) {
+        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 Load.run(graphDir, options.db);
+        });
+    }
+    static async run(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`));
+    }
+}
+//# sourceMappingURL=load.js.map

package/dist/commands/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/commands/load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE1E,MAAM,OAAO,IAAI;IAChB,MAAM,CAAC,QAAQ,CAAC,OAAgB;QAC/B,OAAO;aACL,OAAO,CAAC,MAAM,CAAC;aACf,WAAW,CAAC,mDAAmD,CAAC;aAChE,QAAQ,CAAC,YAAY,EAAE,+CAA+C,EAAE,iBAAiB,CAAC;aAC1F,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,eAAe,CAAC;aAChE,MAAM,CAAC,KAAK,EAAE,QAAgB,EAAE,OAAuB,EAAE,EAAE;YAC3D,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,QAAgB,EAAE,MAAc;QACxD,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,QAAQ,CAAC,SAAS,UAAU,MAAM,CAAC,CAAC,CAAC;QAC/E,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnE,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC;QACxC,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;QACzB,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC/B,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,KAAK,CAAC,MAAM,WAAW,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC,CAAC;IACnF,CAAC;CACD"}

package/dist/commands/load_command.d.ts

@@ -0,0 +1,6 @@
+import { Command } from 'commander';
+export declare class LoadCommand {
+    static register(program: Command): void;
+    private static run;
+}
+//# sourceMappingURL=load_command.d.ts.map

package/dist/commands/load_command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load_command.d.ts","sourceRoot":"","sources":["../../src/commands/load_command.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,qBAAa,WAAW;IACvB,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;mBAWlB,GAAG;CAUxB"}

package/dist/commands/load_command.js

@@ -0,0 +1,28 @@
+import { resolve } from 'node:path';
+import chalk from 'chalk';
+import { JsonlReader } from '../store/jsonl_reader.js';
+import { KuzuStore } from '../store/kuzu_store.js';
+import { DEFAULT_DB_PATH, DEFAULT_GRAPH_DIR } from './command_helpers.js';
+export class LoadCommand {
+    static register(program) {
+        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 LoadCommand.run(graphDir, options.db);
+        });
+    }
+    static async run(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`));
+    }
+}
+//# sourceMappingURL=load_command.js.map

package/dist/commands/load_command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load_command.js","sourceRoot":"","sources":["../../src/commands/load_command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE1E,MAAM,OAAO,WAAW;IACvB,MAAM,CAAC,QAAQ,CAAC,OAAgB;QAC/B,OAAO;aACL,OAAO,CAAC,MAAM,CAAC;aACf,WAAW,CAAC,mDAAmD,CAAC;aAChE,QAAQ,CAAC,YAAY,EAAE,+CAA+C,EAAE,iBAAiB,CAAC;aAC1F,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,eAAe,CAAC;aAChE,MAAM,CAAC,KAAK,EAAE,QAAgB,EAAE,OAAuB,EAAE,EAAE;YAC3D,MAAM,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,QAAgB,EAAE,MAAc;QACxD,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,QAAQ,CAAC,SAAS,UAAU,MAAM,CAAC,CAAC,CAAC;QAC/E,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnE,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC;QACxC,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;QACzB,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC/B,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,KAAK,CAAC,MAAM,WAAW,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC,CAAC;IACnF,CAAC;CACD"}

package/dist/commands/neighbors.d.ts

@@ -0,0 +1,5 @@
+import { Command } from 'commander';
+export declare class Neighbors {
+    static register(program: Command): void;
+}
+//# sourceMappingURL=neighbors.d.ts.map

package/dist/commands/neighbors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"neighbors.d.ts","sourceRoot":"","sources":["../../src/commands/neighbors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,qBAAa,SAAS;IACrB,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAavC"}

package/dist/commands/neighbors.js

@@ -0,0 +1,17 @@
+import { CommandHelpers, DEFAULT_DB_PATH } from './command_helpers.js';
+export class Neighbors {
+    static register(program) {
+        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 CommandHelpers.withQuery(options.db, async (query) => {
+                CommandHelpers.printNeighbors(await query.neighborhood(id), options.json === true);
+            });
+        });
+    }
+}
+//# sourceMappingURL=neighbors.js.map

package/dist/commands/neighbors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"neighbors.js","sourceRoot":"","sources":["../../src/commands/neighbors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAgB,MAAM,sBAAsB,CAAC;AAErF,MAAM,OAAO,SAAS;IACrB,MAAM,CAAC,QAAQ,CAAC,OAAgB;QAC/B,OAAO;aACL,OAAO,CAAC,WAAW,CAAC;aACpB,WAAW,CAAC,wCAAwC,CAAC;aACrD,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;aACtC,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,eAAe,CAAC;aAChE,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,CAAC;aACxC,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,OAAqB,EAAE,EAAE;YACnD,MAAM,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBAC1D,cAAc,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YACpF,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACD"}

package/dist/commands/neighbors_command.d.ts

@@ -0,0 +1,5 @@
+import { Command } from 'commander';
+export declare class NeighborsCommand {
+    static register(program: Command): void;
+}
+//# sourceMappingURL=neighbors_command.d.ts.map

package/dist/commands/neighbors_command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"neighbors_command.d.ts","sourceRoot":"","sources":["../../src/commands/neighbors_command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,qBAAa,gBAAgB;IAC5B,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAavC"}

package/dist/commands/neighbors_command.js

@@ -0,0 +1,17 @@
+import { CommandHelpers, DEFAULT_DB_PATH } from './command_helpers.js';
+export class NeighborsCommand {
+    static register(program) {
+        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 CommandHelpers.withQuery(options.db, async (query) => {
+                CommandHelpers.printNeighbors(await query.neighborhood(id), options.json === true);
+            });
+        });
+    }
+}
+//# sourceMappingURL=neighbors_command.js.map

package/dist/commands/neighbors_command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"neighbors_command.js","sourceRoot":"","sources":["../../src/commands/neighbors_command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAgB,MAAM,sBAAsB,CAAC;AAErF,MAAM,OAAO,gBAAgB;IAC5B,MAAM,CAAC,QAAQ,CAAC,OAAgB;QAC/B,OAAO;aACL,OAAO,CAAC,WAAW,CAAC;aACpB,WAAW,CAAC,wCAAwC,CAAC;aACrD,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;aACtC,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,eAAe,CAAC;aAChE,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,CAAC;aACxC,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,OAAqB,EAAE,EAAE;YACnD,MAAM,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBAC1D,cAAc,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YACpF,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACD"}

package/dist/commands/optimize.d.ts

@@ -0,0 +1,6 @@
+import { Command } from 'commander';
+export declare class Optimize {
+    static register(program: Command): void;
+    private static run;
+}
+//# sourceMappingURL=optimize.d.ts.map

package/dist/commands/optimize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimize.d.ts","sourceRoot":"","sources":["../../src/commands/optimize.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,qBAAa,QAAQ;IACpB,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;mBAalB,GAAG;CAsCxB"}

package/dist/commands/optimize.js

@@ -0,0 +1,59 @@
+import { existsSync } from 'node:fs';
+import chalk from 'chalk';
+import { AgentTools } from '../agent/agent_tools.js';
+import { CodeEditor } from '../agent/code_editor.js';
+import { OptimizerAgent } from '../agent/optimizer_agent.js';
+import { CommandHelpers, DEFAULT_DB_PATH } from './command_helpers.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.';
+export class Optimize {
+    static register(program) {
+        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 Optimize.run(task, options);
+        });
+    }
+    static async run(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 CommandHelpers.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)'));
+            }
+        });
+    }
+}
+//# sourceMappingURL=optimize.js.map

package/dist/commands/optimize.js.map

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

package/dist/commands/optimize_command.d.ts

@@ -0,0 +1,6 @@
+import { Command } from 'commander';
+export declare class OptimizeCommand {
+    static register(program: Command): void;
+    private static run;
+}
+//# sourceMappingURL=optimize_command.d.ts.map

package/dist/commands/optimize_command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimize_command.d.ts","sourceRoot":"","sources":["../../src/commands/optimize_command.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,qBAAa,eAAe;IAC3B,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;mBAalB,GAAG;CAsCxB"}

package/dist/commands/optimize_command.js

@@ -0,0 +1,59 @@
+import { existsSync } from 'node:fs';
+import chalk from 'chalk';
+import { AgentTools } from '../agent/agent_tools.js';
+import { CodeEditor } from '../agent/code_editor.js';
+import { OptimizerAgent } from '../agent/optimizer_agent.js';
+import { CommandHelpers, DEFAULT_DB_PATH } from './command_helpers.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.';
+export class OptimizeCommand {
+    static register(program) {
+        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 OptimizeCommand.run(task, options);
+        });
+    }
+    static async run(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 CommandHelpers.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)'));
+            }
+        });
+    }
+}
+//# sourceMappingURL=optimize_command.js.map

package/dist/commands/optimize_command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimize_command.js","sourceRoot":"","sources":["../../src/commands/optimize_command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvE,MAAM,YAAY,GAAG,iJAAiJ,CAAC;AAQvK,MAAM,OAAO,eAAe;IAC3B,MAAM,CAAC,QAAQ,CAAC,OAAgB;QAC/B,OAAO;aACL,OAAO,CAAC,UAAU,CAAC;aACnB,WAAW,CAAC,gEAAgE,CAAC;aAC7E,QAAQ,CAAC,QAAQ,EAAE,uCAAuC,EAAE,YAAY,CAAC;aACzE,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,eAAe,CAAC;aAChE,MAAM,CAAC,oBAAoB,EAAE,uCAAuC,CAAC;aACrE,MAAM,CAAC,iBAAiB,EAAE,qBAAqB,EAAE,IAAI,CAAC;aACtD,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,OAAwB,EAAE,EAAE;YACxD,MAAM,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAY,EAAE,OAAwB;QAC9D,IAAI,UAAU,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;YACjC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,iGAAiG,CAAC,CAAC,CAAC;YAC1H,OAAO;QACR,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QACxD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,yFAAyF,CAAC,CAAC,CAAC;YAClH,OAAO;QACR,CAAC;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC/B,MAAM,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YAC1D,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC;gBAChC,KAAK,EAAE,IAAI,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC;gBACtC,MAAM,EAAE,IAAI,UAAU,CAAC,QAAQ,CAAC;gBAChC,QAAQ;gBACR,KAAK;gBACL,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;aAClC,CAAC,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,CAAC;YAClI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC;YAC3C,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAEtC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBACvC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC/B,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,OAAO,CAAC,OAAO,CAAC,MAAM,oBAAoB,CAAC,CAAC,CAAC;YACjF,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACpC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;YAC3E,CAAC;YACD,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sEAAsE,CAAC,CAAC,CAAC;YACnG,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC;CACD"}

package/dist/commands/references.d.ts

@@ -0,0 +1,5 @@
+import { Command } from 'commander';
+export declare class References {
+    static register(program: Command): void;
+}
+//# sourceMappingURL=references.d.ts.map

package/dist/commands/references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../src/commands/references.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,qBAAa,UAAU;IACtB,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAavC"}

package/dist/commands/references.js

@@ -0,0 +1,17 @@
+import { CommandHelpers, DEFAULT_DB_PATH } from './command_helpers.js';
+export class References {
+    static register(program) {
+        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 CommandHelpers.withQuery(options.db, async (query) => {
+                CommandHelpers.printNeighbors(await query.references(id), options.json === true);
+            });
+        });
+    }
+}
+//# sourceMappingURL=references.js.map

package/dist/commands/references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.js","sourceRoot":"","sources":["../../src/commands/references.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAgB,MAAM,sBAAsB,CAAC;AAErF,MAAM,OAAO,UAAU;IACtB,MAAM,CAAC,QAAQ,CAAC,OAAgB;QAC/B,OAAO;aACL,OAAO,CAAC,YAAY,CAAC;aACrB,WAAW,CAAC,yEAAyE,CAAC;aACtF,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;aACtC,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,eAAe,CAAC;aAChE,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,CAAC;aACxC,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,OAAqB,EAAE,EAAE;YACnD,MAAM,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBAC1D,cAAc,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YAClF,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACD"}

package/dist/commands/references_command.d.ts

@@ -0,0 +1,5 @@
+import { Command } from 'commander';
+export declare class ReferencesCommand {
+    static register(program: Command): void;
+}
+//# sourceMappingURL=references_command.d.ts.map

package/dist/commands/references_command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references_command.d.ts","sourceRoot":"","sources":["../../src/commands/references_command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,qBAAa,iBAAiB;IAC7B,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAavC"}

package/dist/commands/references_command.js

@@ -0,0 +1,17 @@
+import { CommandHelpers, DEFAULT_DB_PATH } from './command_helpers.js';
+export class ReferencesCommand {
+    static register(program) {
+        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 CommandHelpers.withQuery(options.db, async (query) => {
+                CommandHelpers.printNeighbors(await query.references(id), options.json === true);
+            });
+        });
+    }
+}
+//# sourceMappingURL=references_command.js.map

package/dist/commands/references_command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references_command.js","sourceRoot":"","sources":["../../src/commands/references_command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAgB,MAAM,sBAAsB,CAAC;AAErF,MAAM,OAAO,iBAAiB;IAC7B,MAAM,CAAC,QAAQ,CAAC,OAAgB;QAC/B,OAAO;aACL,OAAO,CAAC,YAAY,CAAC;aACrB,WAAW,CAAC,yEAAyE,CAAC;aACtF,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;aACtC,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,eAAe,CAAC;aAChE,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,CAAC;aACxC,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,OAAqB,EAAE,EAAE;YACnD,MAAM,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBAC1D,cAAc,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YAClF,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACD"}

package/dist/commands/web.d.ts

@@ -0,0 +1,19 @@
+import { Command } from 'commander';
+/**
+ * `web` command — serves the knowledge graph database in an interactive web
+ * visualisation. The graph is read from Kùzu once at startup and injected into
+ * the page as `/data/graph_data.js`; all other assets are served statically
+ * from the contribs/web_visualisation/web directory.
+ */
+export declare class Web {
+    static register(program: Command): void;
+    private static run;
+    /**
+     * Reads every node and edge from the database and renders them as the
+     * `window.GRAPH_DATA` script the visualisation page loads on boot.
+     */
+    private static buildDataScript;
+    private static handle;
+    private static notFound;
+}
+//# sourceMappingURL=web.d.ts.map

package/dist/commands/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/commands/web.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2BpC;;;;;GAKG;AACH,qBAAa,GAAG;IACf,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;mBAWlB,GAAG;IAmBxB;;;OAGG;mBACkB,eAAe;mBAoCf,MAAM;IAwB3B,OAAO,CAAC,MAAM,CAAC,QAAQ;CAIvB"}

package/dist/commands/web.js

@@ -0,0 +1,120 @@
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { createServer } from 'node:http';
+import { extname, join, normalize, resolve, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import chalk from 'chalk';
+import { KuzuStore } from '../store/kuzu_store.js';
+import { DEFAULT_DB_PATH } from './command_helpers.js';
+/**
+ * Static assets of the web visualisation, resolved relative to this module so
+ * the same path works from `src/` (tsx) and from `dist/` (published package).
+ */
+const WEB_ROOT = fileURLToPath(new URL('../../contribs/web_visualisation/web', import.meta.url));
+const DATA_SCRIPT_PATH = '/data/graph_data.js';
+const DEFAULT_PORT = '4173';
+const MIME_TYPES = {
+    '.css': 'text/css; charset=utf-8',
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.png': 'image/png',
+    '.svg': 'image/svg+xml',
+};
+/**
+ * `web` command — serves the knowledge graph database in an interactive web
+ * visualisation. The graph is read from Kùzu once at startup and injected into
+ * the page as `/data/graph_data.js`; all other assets are served statically
+ * from the contribs/web_visualisation/web directory.
+ */
+export class Web {
+    static register(program) {
+        program
+            .command('web')
+            .description('serve the knowledge graph database in a web visualisation')
+            .option('-d, --db <path>', 'Kùzu database path', DEFAULT_DB_PATH)
+            .option('-p, --port <port>', 'HTTP port to listen on', DEFAULT_PORT)
+            .action(async (options) => {
+            await Web.run(options);
+        });
+    }
+    static async run(options) {
+        const dbPath = resolve(options.db);
+        if (existsSync(dbPath) === false) {
+            console.error(chalk.red(`database not found at ${dbPath} — run \`extract\` then \`load\` first`));
+            process.exitCode = 1;
+            return;
+        }
+        const dataScript = await Web.buildDataScript(dbPath);
+        const server = createServer((request, response) => {
+            void Web.handle(request, response, dataScript);
+        });
+        server.listen(Number(options.port), () => {
+            console.log(chalk.green(`✓ serving the knowledge graph at http://localhost:${options.port}/`));
+            console.log(chalk.gray('  press Ctrl+C to stop'));
+        });
+    }
+    /**
+     * Reads every node and edge from the database and renders them as the
+     * `window.GRAPH_DATA` script the visualisation page loads on boot.
+     */
+    static async buildDataScript(dbPath) {
+        const store = new KuzuStore(dbPath);
+        await store.initSchema();
+        try {
+            const nodeRows = await store.run('MATCH (n:GraphNode) RETURN n.id AS id, n.kind AS kind, n.name AS name, n.filePath AS filePath, n.exported AS exported, n.startLine AS startLine, n.endLine AS endLine');
+            const edgeRows = await store.run('MATCH (f:GraphNode)-[e:Edge]->(t:GraphNode) RETURN f.id AS from, e.kind AS kind, t.id AS to');
+            const nodes = nodeRows.map((row) => ({
+                id: String(row.id),
+                kind: String(row.kind),
+                name: String(row.name),
+                filePath: String(row.filePath),
+                exported: row.exported === true,
+                range: {
+                    startLine: Number(row.startLine),
+                    startColumn: 0,
+                    endLine: Number(row.endLine),
+                    endColumn: 0,
+                },
+            }));
+            const edges = edgeRows.map((row, index) => ({
+                id: `e${index}`,
+                kind: String(row.kind),
+                from: String(row.from),
+                to: String(row.to),
+            }));
+            console.log(chalk.cyan(`loaded ${nodes.length} nodes, ${edges.length} edges from ${dbPath}`));
+            return `window.GRAPH_DATA = ${JSON.stringify({ nodes, edges })};\n`;
+        }
+        finally {
+            await store.close();
+        }
+    }
+    static async handle(request, response, dataScript) {
+        const url = new URL(request.url ?? '/', 'http://localhost');
+        const pathname = url.pathname === '/' ? '/index.html' : url.pathname;
+        if (pathname === DATA_SCRIPT_PATH) {
+            response.writeHead(200, { 'content-type': MIME_TYPES['.js'] });
+            response.end(dataScript);
+            return;
+        }
+        const filePath = normalize(join(WEB_ROOT, pathname));
+        if (filePath.startsWith(WEB_ROOT + sep) === false) {
+            Web.notFound(response);
+            return;
+        }
+        try {
+            const content = await readFile(filePath);
+            response.writeHead(200, { 'content-type': MIME_TYPES[extname(filePath)] ?? 'application/octet-stream' });
+            response.end(content);
+        }
+        catch {
+            Web.notFound(response);
+        }
+    }
+    static notFound(response) {
+        response.writeHead(404, { 'content-type': 'text/plain; charset=utf-8' });
+        response.end('not found');
+    }
+}
+//# sourceMappingURL=web.js.map