ts-knowledge-graph 0.1.2 → 0.1.4

package/dist/verify/project_verifier.d.ts

@@ -0,0 +1,85 @@
+/**
+ * The reusable verify path for the optimization loop: run the project's
+ * type-check and test gates and reduce them to one pass/fail verdict, plus the
+ * honesty flags an agent needs (was *behaviour* verified, or only types?).
+ *
+ * A type-check proves the edit compiles; it cannot see a swapped operator, an
+ * off-by-one, or a dropped branch. Running the test suite alongside `tsc` is
+ * what turns "still compiles" into "still works". When a project has no test
+ * script the test gate degrades to skipped and {@link VerifyReport.behaviorVerified}
+ * stays false, so the caller can report the change as unverified rather than
+ * implying it was behaviourally checked.
+ */
+/** The two correctness gates, run in order. */
+export type CheckName = 'typecheck' | 'test';
+/** A gate ran and passed, ran and failed, or never ran. */
+export type CheckStatus = 'pass' | 'fail' | 'skipped';
+/** A gate resolved from the project's package.json: its command, or why it was skipped. */
+export type PlannedCheck = {
+    name: CheckName;
+    /** The shell command to run, or `null` when the gate is skipped. */
+    command: string | null;
+    /** Why the gate will not run (e.g. no matching npm script), set when `command` is null. */
+    skippedReason?: string;
+};
+/** The outcome of executing (or skipping) one gate. */
+export type CheckResult = {
+    name: CheckName;
+    command: string | null;
+    status: CheckStatus;
+    /** Process exit code; `null` when the gate was skipped or the process died on a signal. */
+    exitCode: number | null;
+    durationMs: number;
+    /** Combined stdout+stderr, tail-bounded to the last `outputTailLines` lines. */
+    output: string;
+    skippedReason?: string;
+};
+/** The single verdict the optimize loop consumes to keep or revert an edit. */
+export type VerifyReport = {
+    /** True when at least one gate ran and no gate that ran failed. */
+    ok: boolean;
+    /** True only when the test gate actually ran and passed — behaviour, not just types, was checked. */
+    behaviorVerified: boolean;
+    /** True when a gate was skipped (e.g. the project has no test script), so `ok` is weaker than a full pass. */
+    degraded: boolean;
+    checks: CheckResult[];
+    /** A one-line, quotable verdict that states exactly what was and was not verified. */
+    summary: string;
+};
+export type VerifyOptions = {
+    /** Project root whose package.json is read and whose scripts are run. Defaults to `process.cwd()`. */
+    cwd?: string;
+    /** npm script name for the type-check gate. Default `typecheck`. */
+    typecheckScript?: string;
+    /** npm script name for the test gate. Default `test`. */
+    testScript?: string;
+    /** Skip the type-check gate entirely. */
+    skipTypecheck?: boolean;
+    /** Skip the test gate entirely (degrades to type-check-only, reported honestly). */
+    skipTests?: boolean;
+    /** Keep only the last N lines of each gate's captured output. Default 80. */
+    outputTailLines?: number;
+};
+/** How a planned gate is executed. Injectable so tests need not spawn npm. */
+export type CheckExecutor = (command: string, cwd: string) => Promise<{
+    exitCode: number | null;
+    output: string;
+}>;
+export declare class ProjectVerifier {
+    /**
+     * Run the project's verify gates and return one verdict. `exec` defaults to a
+     * real subprocess spawn; tests inject a fake to avoid running npm.
+     */
+    static verify(options?: VerifyOptions, exec?: CheckExecutor): Promise<VerifyReport>;
+    /** Resolve each gate against the project's scripts, deciding what will run and what is skipped (pure). */
+    static planChecks(scripts: Record<string, string>, options?: VerifyOptions): PlannedCheck[];
+    /** Reduce a set of gate results to the single verdict, including the honesty flags (pure). */
+    static summarize(checks: CheckResult[]): VerifyReport;
+    private static planOne;
+    private static runCheck;
+    private static buildSummary;
+    private static readScripts;
+    private static tail;
+    private static spawnCommand;
+}
+//# sourceMappingURL=project_verifier.d.ts.map

package/dist/verify/project_verifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project_verifier.d.ts","sourceRoot":"","sources":["../../src/verify/project_verifier.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;GAWG;AAEH,+CAA+C;AAC/C,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;AAE7C,2DAA2D;AAC3D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEtD,2FAA2F;AAC3F,MAAM,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,oEAAoE;IACpE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,2FAA2F;IAC3F,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,uDAAuD;AACvD,MAAM,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB,2FAA2F;IAC3F,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,+EAA+E;AAC/E,MAAM,MAAM,YAAY,GAAG;IAC1B,mEAAmE;IACnE,EAAE,EAAE,OAAO,CAAC;IACZ,qGAAqG;IACrG,gBAAgB,EAAE,OAAO,CAAC;IAC1B,8GAA8G;IAC9G,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,sFAAsF;IACtF,OAAO,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC3B,sGAAsG;IACtG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oFAAoF;IACpF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,8EAA8E;AAC9E,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAQnH,qBAAa,eAAe;IAC3B;;;OAGG;WACU,MAAM,CAAC,OAAO,GAAE,aAAkB,EAAE,IAAI,GAAE,aAA4C,GAAG,OAAO,CAAC,YAAY,CAAC;IAY3H,0GAA0G;IAC1G,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAE,aAAkB,GAAG,YAAY,EAAE;IAS/F,8FAA8F;IAC9F,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,YAAY;IAWrD,OAAO,CAAC,MAAM,CAAC,OAAO;mBAUD,QAAQ;IAwB7B,OAAO,CAAC,MAAM,CAAC,YAAY;mBAoBN,WAAW;IAmBhC,OAAO,CAAC,MAAM,CAAC,IAAI;IAWnB,OAAO,CAAC,MAAM,CAAC,YAAY;CAkB3B"}

package/dist/verify/project_verifier.js

@@ -0,0 +1,138 @@
+import { spawn } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { z } from 'zod';
+const DEFAULT_TYPECHECK_SCRIPT = 'typecheck';
+const DEFAULT_TEST_SCRIPT = 'test';
+const DEFAULT_TAIL_LINES = 80;
+const PackageJsonSchema = z.object({ scripts: z.record(z.unknown()).optional() });
+export class ProjectVerifier {
+    /**
+     * Run the project's verify gates and return one verdict. `exec` defaults to a
+     * real subprocess spawn; tests inject a fake to avoid running npm.
+     */
+    static async verify(options = {}, exec = ProjectVerifier.spawnCommand) {
+        const cwd = resolve(options.cwd ?? process.cwd());
+        const tailLines = options.outputTailLines ?? DEFAULT_TAIL_LINES;
+        const scripts = await ProjectVerifier.readScripts(cwd);
+        const plan = ProjectVerifier.planChecks(scripts, options);
+        const results = [];
+        for (const check of plan) {
+            results.push(await ProjectVerifier.runCheck(check, cwd, tailLines, exec));
+        }
+        return ProjectVerifier.summarize(results);
+    }
+    /** Resolve each gate against the project's scripts, deciding what will run and what is skipped (pure). */
+    static planChecks(scripts, options = {}) {
+        const typecheckScript = options.typecheckScript ?? DEFAULT_TYPECHECK_SCRIPT;
+        const testScript = options.testScript ?? DEFAULT_TEST_SCRIPT;
+        return [
+            ProjectVerifier.planOne('typecheck', typecheckScript, scripts, options.skipTypecheck === true),
+            ProjectVerifier.planOne('test', testScript, scripts, options.skipTests === true),
+        ];
+    }
+    /** Reduce a set of gate results to the single verdict, including the honesty flags (pure). */
+    static summarize(checks) {
+        const ran = checks.filter((check) => check.status !== 'skipped');
+        const failed = ran.filter((check) => check.status === 'fail');
+        const test = checks.find((check) => check.name === 'test');
+        const behaviorVerified = test !== undefined && test.status === 'pass';
+        const ok = ran.length > 0 && failed.length === 0;
+        const degraded = checks.some((check) => check.status === 'skipped');
+        const summary = ProjectVerifier.buildSummary(ran, failed, test, ok, behaviorVerified);
+        return { ok, behaviorVerified, degraded, checks, summary };
+    }
+    static planOne(name, script, scripts, skip) {
+        if (skip === true) {
+            return { name, command: null, skippedReason: 'skipped by request' };
+        }
+        if (typeof scripts[script] !== 'string') {
+            return { name, command: null, skippedReason: `no "${script}" script in package.json` };
+        }
+        return { name, command: `npm run ${script}` };
+    }
+    static async runCheck(check, cwd, tailLines, exec) {
+        if (check.command === null) {
+            return {
+                name: check.name,
+                command: null,
+                status: 'skipped',
+                exitCode: null,
+                durationMs: 0,
+                output: '',
+                skippedReason: check.skippedReason,
+            };
+        }
+        const startedAt = Date.now();
+        const { exitCode, output } = await exec(check.command, cwd);
+        return {
+            name: check.name,
+            command: check.command,
+            status: exitCode === 0 ? 'pass' : 'fail',
+            exitCode,
+            durationMs: Date.now() - startedAt,
+            output: ProjectVerifier.tail(output, tailLines),
+        };
+    }
+    static buildSummary(ran, failed, test, ok, behaviorVerified) {
+        if (ran.length === 0) {
+            return 'could not verify: no type-check or test script found — change is unverified';
+        }
+        if (ok === false) {
+            return `FAILED: ${failed.map((check) => check.name).join(' and ')} did not pass — revert the edit`;
+        }
+        if (behaviorVerified === true) {
+            return `verified: ${ran.map((check) => check.name).join(' + ')} passed (behaviour checked)`;
+        }
+        const why = test?.skippedReason ?? 'tests did not run';
+        return `type-check passed, but ${why} — behaviour NOT verified`;
+    }
+    static async readScripts(cwd) {
+        try {
+            const raw = await readFile(resolve(cwd, 'package.json'), 'utf8');
+            const parsed = PackageJsonSchema.safeParse(JSON.parse(raw));
+            if (parsed.success === false) {
+                return {};
+            }
+            const scripts = {};
+            for (const [name, value] of Object.entries(parsed.data.scripts ?? {})) {
+                if (typeof value === 'string') {
+                    scripts[name] = value;
+                }
+            }
+            return scripts;
+        }
+        catch {
+            return {};
+        }
+    }
+    static tail(text, lines) {
+        if (lines <= 0) {
+            return text;
+        }
+        const allLines = text.split('\n');
+        if (allLines.length <= lines) {
+            return text;
+        }
+        return allLines.slice(allLines.length - lines).join('\n');
+    }
+    static spawnCommand(command, cwd) {
+        return new Promise((resolvePromise) => {
+            const child = spawn(command, { cwd, shell: true });
+            let output = '';
+            const append = (chunk) => {
+                output += chunk.toString();
+            };
+            child.stdout.on('data', append);
+            child.stderr.on('data', append);
+            child.on('error', (error) => {
+                output += `\n${error.message}`;
+                resolvePromise({ exitCode: 1, output });
+            });
+            child.on('close', (code) => {
+                resolvePromise({ exitCode: code, output });
+            });
+        });
+    }
+}
+//# sourceMappingURL=project_verifier.js.map

package/dist/verify/project_verifier.js.map

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

package/{skills/ts-knowledge-graph → dotclaude_folder/skills/code-graph-query}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: ts-knowledge-graph
+name: code-graph-query
 description: >-
   Query a TypeScript codebase as a knowledge graph to answer impact, caller,
   dependency, and dead-code questions. Use this instead of grep/glob for
@@ -8,7 +8,7 @@ description: >-
   ts-knowledge-graph CLI and a built graph database.
 ---
 
-# ts-knowledge-graph
+# code-graph-query
 
 Answer structural questions about a TypeScript project by querying a semantic
 knowledge graph (built with the TypeScript compiler API) rather than reading or

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "ts-knowledge-graph",
-	"version": "0.1.2",
+	"version": "0.1.4",
 	"description": "Parse TypeScript source into a knowledge graph for autonomous code optimization",
 	"type": "module",
 	"bin": {
@@ -9,10 +9,9 @@
 	"files": [
 		"dist",
 		"contribs/web_visualisation/web",
-		"skills/ts-knowledge-graph/SKILL.md",
+		"dotclaude_folder/skills/code-graph-query/SKILL.md",
 		"README.md",
-		"LICENSE",
-		".env-sample"
+		"LICENSE"
 	],
 	"engines": {
 		"node": ">=18"
@@ -25,15 +24,95 @@
 		"web": "tsx src/cli.ts web",
 		"dev": "tsx src/cli.ts",
 		"build": "tsc -p tsconfig.build.json",
+		"clean": "npm run clean:dist && npm run clean:outputs",
+		"clean:dist": "rm -rf ./dist",
+		"clean:outputs": "rm -rf ./outputs/*/",
+		"symlink:dotclaude": "bash scripts/symlink_dotclaude.sh",
 		"publish:all": "npm run build && npm version patch && npm publish",
-		"typecheck": "tsc --noEmit",
-		"test": "node --import tsx --test \"test/**/*.test.ts\""
+		"typecheck": "tsc --noEmit && tsc -p contribs/web_visualisation/web/tsconfig.json",
+		"test": "node --import tsx --test \"tests/**/*.test.ts\"",
+		"verify": "tsx src/cli.ts verify",
+		"project01": "npm run project01:rebuild && npm run project01:dead-exports",
+		"project01:tour": "bash scripts/project_01_tour.sh",
+		"project01:rebuild": "npm run project01:clean && npm run project01:extract && npm run project01:load",
+		"project01:clean": "rm -rf ./outputs/project_01",
+		"project01:extract": "tsx src/cli.ts extract sample_projects/project_01 --semantic --out ./outputs/project_01/graph",
+		"project01:load": "tsx src/cli.ts load ./outputs/project_01/graph --db ./outputs/project_01/graph.kuzu",
+		"project01:enrich": "bash scripts/profile_and_enrich.sh project_01",
+		"project01:benchmark": "tsx src/cli.ts benchmark titleCase --workload scripts/benchmarks/project_01_workload.ts --db ./outputs/project_01/graph.kuzu --root ./sample_projects/project_01 --runs 5",
+		"project01:verify": "tsx src/cli.ts verify --cwd sample_projects/project_01",
+		"project01:dead-exports": "tsx src/cli.ts dead-exports --db ./outputs/project_01/graph.kuzu",
+		"project01:hotspots": "tsx src/cli.ts hotspots --db ./outputs/project_01/graph.kuzu",
+		"project01:cost": "tsx src/cli.ts cost --db ./outputs/project_01/graph.kuzu",
+		"project01:find": "tsx src/cli.ts find --db ./outputs/project_01/graph.kuzu",
+		"project01:who-calls": "tsx src/cli.ts who-calls --db ./outputs/project_01/graph.kuzu",
+		"project01:calls": "tsx src/cli.ts calls --db ./outputs/project_01/graph.kuzu",
+		"project01:references": "tsx src/cli.ts references --db ./outputs/project_01/graph.kuzu",
+		"project01:neighbors": "tsx src/cli.ts neighbors --db ./outputs/project_01/graph.kuzu",
+		"project01:blast-radius": "tsx src/cli.ts blast-radius --db ./outputs/project_01/graph.kuzu",
+		"project01:web": "tsx src/cli.ts web --db ./outputs/project_01/graph.kuzu",
+		"project02": "npm run project02:rebuild && npm run project02:dead-exports",
+		"project02:tour": "bash scripts/project_02_tour.sh",
+		"project02:rebuild": "npm run project02:clean && npm run project02:extract && npm run project02:load",
+		"project02:clean": "rm -rf ./outputs/project_02",
+		"project02:extract": "tsx src/cli.ts extract sample_projects/project_02 --semantic --out ./outputs/project_02/graph",
+		"project02:load": "tsx src/cli.ts load ./outputs/project_02/graph --db ./outputs/project_02/graph.kuzu",
+		"project02:enrich": "bash scripts/profile_and_enrich.sh project_02",
+		"project02:benchmark": "tsx src/cli.ts benchmark parseTerm --workload scripts/benchmarks/project_02_workload.ts --db ./outputs/project_02/graph.kuzu --root ./sample_projects/project_02 --runs 5",
+		"project02:verify": "tsx src/cli.ts verify --cwd sample_projects/project_02",
+		"project02:dead-exports": "tsx src/cli.ts dead-exports --db ./outputs/project_02/graph.kuzu",
+		"project02:hotspots": "tsx src/cli.ts hotspots --db ./outputs/project_02/graph.kuzu",
+		"project02:cost": "tsx src/cli.ts cost --db ./outputs/project_02/graph.kuzu",
+		"project02:find": "tsx src/cli.ts find --db ./outputs/project_02/graph.kuzu",
+		"project02:who-calls": "tsx src/cli.ts who-calls --db ./outputs/project_02/graph.kuzu",
+		"project02:calls": "tsx src/cli.ts calls --db ./outputs/project_02/graph.kuzu",
+		"project02:references": "tsx src/cli.ts references --db ./outputs/project_02/graph.kuzu",
+		"project02:neighbors": "tsx src/cli.ts neighbors --db ./outputs/project_02/graph.kuzu",
+		"project02:blast-radius": "tsx src/cli.ts blast-radius --db ./outputs/project_02/graph.kuzu",
+		"project02:web": "tsx src/cli.ts web --db ./outputs/project_02/graph.kuzu",
+		"project03": "npm run project03:rebuild && npm run project03:dead-exports",
+		"project03:tour": "bash scripts/project_03_tour.sh",
+		"project03:rebuild": "npm run project03:clean && npm run project03:extract && npm run project03:load",
+		"project03:clean": "rm -rf ./outputs/project_03",
+		"project03:extract": "tsx src/cli.ts extract sample_projects/project_03 --semantic --out ./outputs/project_03/graph",
+		"project03:load": "tsx src/cli.ts load ./outputs/project_03/graph --db ./outputs/project_03/graph.kuzu",
+		"project03:enrich": "bash scripts/profile_and_enrich.sh project_03",
+		"project03:benchmark": "tsx src/cli.ts benchmark describe --workload scripts/benchmarks/project_03_workload.ts --db ./outputs/project_03/graph.kuzu --root ./sample_projects/project_03 --runs 5",
+		"project03:verify": "tsx src/cli.ts verify --cwd sample_projects/project_03",
+		"project03:dead-exports": "tsx src/cli.ts dead-exports --db ./outputs/project_03/graph.kuzu",
+		"project03:hotspots": "tsx src/cli.ts hotspots --db ./outputs/project_03/graph.kuzu",
+		"project03:cost": "tsx src/cli.ts cost --db ./outputs/project_03/graph.kuzu",
+		"project03:find": "tsx src/cli.ts find --db ./outputs/project_03/graph.kuzu",
+		"project03:who-calls": "tsx src/cli.ts who-calls --db ./outputs/project_03/graph.kuzu",
+		"project03:calls": "tsx src/cli.ts calls --db ./outputs/project_03/graph.kuzu",
+		"project03:references": "tsx src/cli.ts references --db ./outputs/project_03/graph.kuzu",
+		"project03:neighbors": "tsx src/cli.ts neighbors --db ./outputs/project_03/graph.kuzu",
+		"project03:blast-radius": "tsx src/cli.ts blast-radius --db ./outputs/project_03/graph.kuzu",
+		"project03:web": "tsx src/cli.ts web --db ./outputs/project_03/graph.kuzu",
+		"project04": "npm run project04:rebuild && npm run project04:dead-exports",
+		"project04:tour": "bash scripts/project_04_tour.sh",
+		"project04:rebuild": "npm run project04:clean && npm run project04:extract && npm run project04:load",
+		"project04:clean": "rm -rf ./outputs/project_04",
+		"project04:extract": "tsx src/cli.ts extract sample_projects/project_04 --semantic --out ./outputs/project_04/graph",
+		"project04:load": "tsx src/cli.ts load ./outputs/project_04/graph --db ./outputs/project_04/graph.kuzu",
+		"project04:enrich": "bash scripts/profile_and_enrich.sh project_04",
+		"project04:workload": "tsx scripts/benchmarks/project_04_workload.ts",
+		"project04:verify": "tsx src/cli.ts verify --cwd sample_projects/project_04",
+		"project04:dead-exports": "tsx src/cli.ts dead-exports --db ./outputs/project_04/graph.kuzu",
+		"project04:hotspots": "tsx src/cli.ts hotspots --db ./outputs/project_04/graph.kuzu",
+		"project04:cost": "tsx src/cli.ts cost --db ./outputs/project_04/graph.kuzu",
+		"project04:find": "tsx src/cli.ts find --db ./outputs/project_04/graph.kuzu",
+		"project04:who-calls": "tsx src/cli.ts who-calls --db ./outputs/project_04/graph.kuzu",
+		"project04:calls": "tsx src/cli.ts calls --db ./outputs/project_04/graph.kuzu",
+		"project04:references": "tsx src/cli.ts references --db ./outputs/project_04/graph.kuzu",
+		"project04:neighbors": "tsx src/cli.ts neighbors --db ./outputs/project_04/graph.kuzu",
+		"project04:blast-radius": "tsx src/cli.ts blast-radius --db ./outputs/project_04/graph.kuzu",
+		"project04:web": "tsx src/cli.ts web --db ./outputs/project_04/graph.kuzu"
 	},
 	"dependencies": {
 		"chalk": "^5.3.0",
 		"commander": "^12.1.0",
 		"kuzu": "^0.11.3",
-		"openai": "^6.42.0",
 		"ts-morph": "^23.0.0",
 		"zod": "^3.23.8"
 	},

package/.env-sample

@@ -1,34 +0,0 @@
-# Copy to .env and pick ONE provider block below.
-# The agent uses the OpenAI-compatible chat-completions API, so any provider
-# exposing that surface works — only the three variables below change.
-#
-#   OPENAI_API_KEY    auth token for the provider (any non-empty string for local servers)
-#   OPENAI_BASE_URL   the provider's OpenAI-compatible endpoint (omit for openai.com)
-#   OPENAI_MODEL      model name, in the provider's naming scheme
-
-# --- OpenAI (default) -------------------------------------------------------
-OPENAI_API_KEY=sk-...
-# OPENAI_BASE_URL is not needed — defaults to https://api.openai.com/v1
-OPENAI_MODEL=gpt-5.1
-
-# --- OpenRouter (any model behind one key) ----------------------------------
-# OPENAI_API_KEY=sk-or-v1-...
-# OPENAI_BASE_URL=https://openrouter.ai/api/v1
-# OPENAI_MODEL=anthropic/claude-sonnet-4.5
-# OPENAI_MODEL=openai/gpt-5.1
-# OPENAI_MODEL=deepseek/deepseek-chat-v3.1
-
-# --- Ollama (local, free) ---------------------------------------------------
-# OPENAI_API_KEY=ollama
-# OPENAI_BASE_URL=http://localhost:11434/v1
-# OPENAI_MODEL=qwen2.5-coder:32b
-
-# --- LM Studio (local) ------------------------------------------------------
-# OPENAI_API_KEY=lm-studio
-# OPENAI_BASE_URL=http://localhost:1234/v1
-# OPENAI_MODEL=local-model
-
-# --- vLLM (self-hosted) -----------------------------------------------------
-# OPENAI_API_KEY=token-abc123
-# OPENAI_BASE_URL=http://localhost:8000/v1
-# OPENAI_MODEL=Qwen/Qwen2.5-Coder-32B-Instruct

package/dist/agent/agent-tools.d.ts

@@ -1,13 +0,0 @@
-import OpenAI from 'openai';
-import { GraphQuery } from '../query/graph-query.js';
-export declare const PROPOSE_TOOL_NAME = "propose_optimization";
-export declare const AGENT_TOOLS: OpenAI.Chat.Completions.ChatCompletionTool[];
-export declare class AgentTools {
-    private readonly query;
-    private readonly rootPath;
-    constructor(query: GraphQuery, rootPath: string);
-    dispatch(name: string, input: Record<string, unknown>): Promise<string>;
-    private readFile;
-    private static stringify;
-}
-//# sourceMappingURL=agent-tools.d.ts.map

package/dist/agent/agent-tools.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-tools.d.ts","sourceRoot":"","sources":["../../src/agent/agent-tools.ts"],"names":[],"mappings":"AAEA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,eAAO,MAAM,iBAAiB,yBAAyB,CAAC;AAExD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,kBAAkB,EAyGnE,CAAC;AAEF,qBAAa,UAAU;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM;IAKzC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;YAqB/D,QAAQ;IAetB,OAAO,CAAC,MAAM,CAAC,SAAS;CAGxB"}

package/dist/agent/agent-tools.js

@@ -1,153 +0,0 @@
-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

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

package/dist/agent/agent_tools.d.ts

@@ -1,13 +0,0 @@
-import OpenAI from 'openai';
-import { GraphQuery } from '../query/graph_query.js';
-export declare const PROPOSE_TOOL_NAME = "propose_optimization";
-export declare const AGENT_TOOLS: OpenAI.Chat.Completions.ChatCompletionTool[];
-export declare class AgentTools {
-    private readonly query;
-    private readonly rootPath;
-    constructor(query: GraphQuery, rootPath: string);
-    dispatch(name: string, input: Record<string, unknown>): Promise<string>;
-    private readFile;
-    private static stringify;
-}
-//# sourceMappingURL=agent_tools.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"agent_tools.d.ts","sourceRoot":"","sources":["../../src/agent/agent_tools.ts"],"names":[],"mappings":"AAEA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,eAAO,MAAM,iBAAiB,yBAAyB,CAAC;AAExD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,kBAAkB,EAyGnE,CAAC;AAEF,qBAAa,UAAU;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM;IAKzC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;YAqB/D,QAAQ;IAetB,OAAO,CAAC,MAAM,CAAC,SAAS;CAGxB"}