projscan 4.7.0 → 4.8.0

package/README.md

@@ -35,29 +35,29 @@ npx projscan
 
 <img src="docs/projscan-mission-control.gif" alt="projscan Mission Control turning a plain-language goal into shortcut commands, proof commands, and review gates" width="760">
 
-## What's New in 4.7.0
+## What's New in 4.8.0
 
-4.7.0 turns the post-4.6 validation train into release-ready evidence: broader
-framework dataflow precision, offline Python requirement include support,
-release-train roadmap routing, and lower-risk internal hotspots.
+4.8.0 turns the post-4.7 agent-research loop into release-ready hardening:
+SvelteKit dataflow precision, safer continuation routing, clearer coordination
+handoffs, sharper Python dependency evidence, and smaller internal modules.
 
-- **Remix dataflow coverage.** Remix route actions and loaders now classify
-  request body readers, headers, URL, signal, and params through
+- **SvelteKit dataflow coverage.** `RequestEvent` handlers and hooks now
+  classify request body readers, headers, URL, params, and cookies through
   framework-gated source patterns.
-- **Python requirements includes.** Upgrade previews follow local `-r`
-  requirements and `-c` constraints without reading outside the scan or adding
-  network access.
-- **Roadmap routing.** Build-next product-planning prompts now route to
-  release-train roadmap evidence with a read-only roadmap preview.
-- **Hotspot cleanup.** Dataflow risk assembly, plugin manifest validation,
-  telemetry flushing, search index helpers, release evidence, and bug-hunt
-  findings have been split into focused modules.
-- **Focused coverage.** Python lockfile, framework dataflow, intent router,
-  preflight, MCP, and start suites now carry smaller regression tests plus
-  architecture guards for high-risk entrypoints.
-- **Release readiness.** Large-train preflight warnings are now separated from
-  concrete taint, dataflow, health, plugin, and supply-chain defects so release
-  review can focus on scale sign-off.
+- **No-release continuation routing.** Autonomous improvement prompts now route
+  to bounded workplans while release, publish, deploy, push, merge, and
+  version-bump actions stay blocked unless a release task is active.
+- **Scoped evidence prompts.** Shareable redacted evidence requests can infer
+  top-level directory scopes such as `tests` and produce concrete local
+  analyze/doctor/CI commands.
+- **Coordination handoffs.** Agent briefs now carry clearer merge-order hints
+  and preflight coordination proof paths for parallel-agent work.
+- **Python dependency evidence.** Upgrade previews handle numeric-looking
+  package names, Poetry dependency source lines, nested requirements, and nested
+  constraints more reliably.
+- **Maintainability cleanup.** Mission Control route criteria, public start
+  types, plugin loading, telemetry helpers, preflight/report assembly, code
+  graph indexing, and HTML reporters have been split into focused modules.
 
 <img src="docs/projscan-proof-router.png" alt="projscan intent router and proof workflow showing impact routing, setup discovery, dependency intelligence, and stable-surface guardrails" width="760">
 
@@ -500,7 +500,7 @@ projscan start --intent "what should an intern work on?" # Routes to bug-hunt pr
 projscan start --intent "what is a low risk improvement?" # Routes to bug-hunt prioritization
 projscan start --intent "pick a small safe task" # Routes to bug-hunt prioritization
 projscan start --intent "what should I do next?" # Routes to an ordered before-edit workplan
-projscan start --intent "what should we build next?" # Routes to release-train roadmap planning
+projscan start --intent "what should we build next?" # Routes to a before-edit implementation workplan
 projscan start --intent "explain issue missing-test-framework" # Routes to deep issue context
 projscan start --intent "fix issue missing-test-framework" # Routes to a concrete fix suggestion
 projscan start --intent "is user input reaching SQL sinks?" # Routes to hardening dataflow analysis
@@ -1347,7 +1347,7 @@ Capability is advertised under `experimental.fileChanged` on `initialize` so cli
 - **`projscan_start`** _(3.0.4)_ - first-60-seconds repo orientation. Composes setup diagnostics, `firstTenMinutes`, workflow recipes, workplan, quality scorecard, top risks, adoption gaps, next commands, and optional handoff payload.
 - **`projscan_understand`** _(3.4)_ - cited repo-comprehension report with `map`, `flow`, `contracts`, `change`, and `verify` views, read-first files, unknowns, change readiness, verification tiers, and exact next commands.
 - **`projscan_semantic_graph`** _(3.0; query mode 4.0)_ - the code graph, two ways. With no `query`: the stable v3 semantic graph contract (file, function, package, and symbol nodes plus `defines`, `imports`, `imports_package`, `exports`, and `calls` edges). With `query: { direction, file?, symbol? }`: one cheap targeted lookup — `imports`, `exports`, `importers`, `symbol_defs`, `package_importers` — with millisecond responses on a warm cache. (Subsumes the former `projscan_graph`, removed in 4.0.)
-- **`projscan_dataflow`** _(3.0)_ - focused direct, propagated, and bridge source-to-sink dataflow risks. Next.js route body readers and URL reads plus Hono, Express, Fastify, and Koa request sources are framework-aware, DB/write sinks are receiver-sensitive, and defaults suppress test-file paths, broad readFile/writeFile noise, JavaScript RegExp.exec false positives, and generated-code anxiety; opt into broader scans with `include_tests` / `include_broad_file_io` / `include_generated` or the matching CLI flags.
+- **`projscan_dataflow`** _(3.0)_ - focused direct, propagated, and bridge source-to-sink dataflow risks. Next.js route body readers and URL reads plus Remix, SvelteKit, Hono, Express, Fastify, and Koa request sources are framework-aware, DB/write sinks are receiver-sensitive, and defaults suppress test-file paths, broad readFile/writeFile noise, JavaScript RegExp.exec false positives, and generated-code anxiety; opt into broader scans with `include_tests` / `include_broad_file_io` / `include_generated` or the matching CLI flags.
 - **`projscan_search`** - fast search across `symbols` (exported names), `files` (path substring), or `content` (source substring with line + excerpt). Sub-file mode (`sub_file: true`) embeds per-function for sharper semantic results _(0.15)_.
 - **`projscan_coupling`** _(0.11)_ - per-file fan-in / fan-out / instability + circular-import cycles (Tarjan SCC). Filter by `direction: cycles_only | high_fan_in | high_fan_out`.
 - **`projscan_pr_diff`** _(0.11)_ - structural diff between two git refs. Returns added/removed/modified files with explicit lists of exports, imports, and call sites that changed, plus ΔCC and Δfan-in.

package/dist/cli/commands/start.js

@@ -1,33 +1,10 @@
 import { program } from '../_shared.js';
-import { parsePositiveInt, runStartCommandAction } from './startAction.js';
+import { runStartCommandAction } from './startAction.js';
+import { registerStartOptions } from './startOptionsRegistration.js';
 export function registerStart() {
-    program
+    const startCommand = program
         .command('start')
-        .description('Orient an engineer or agent with the next best workflow for this repo')
-        .option('--mode <mode>', 'before_edit, before_commit, before_merge, refactor, release, bug_hunt, or hardening')
-        .option('--intent <text>', 'plain-language goal to route into the next best action')
-        .option('--mission <dir>', 'read an existing Mission Control bundle and include proof outcome')
-        .option('--max-tasks <count>', 'maximum workplan tasks to inspect', parsePositiveInt)
-        .option('--max-risks <count>', 'maximum start risks to return', parsePositiveInt)
-        .option('--include-handoff', 'include a compact handoff payload')
-        .option('--handoff-prompt', 'print only the concise Mission Control handoff prompt')
-        .option('--next-command', 'print only the current Mission Control cursor command')
-        .option('--next-tool-call', 'print only the current Mission Control cursor MCP tool call as JSON')
-        .option('--ready-tool-calls', 'print all currently ready Mission Control MCP tool calls as compact JSON')
-        .option('--proof-commands', 'print only ready Mission Control proof commands')
-        .option('--checklist', 'print only the Mission Control resume checklist')
-        .option('--resume-json', 'print only the Mission Control resume object as compact JSON')
-        .option('--handoff-json', 'print only the Mission Control handoff object as compact JSON')
-        .option('--save-mission <dir>', 'write the Mission Control bundle to this directory')
-        .option('--runbook', 'print only the Mission Control Markdown runbook')
-        .option('--task-card', 'print only the Mission Control Markdown task card')
-        .option('--review-gate', 'print only the Mission Control review gate')
-        .option('--review-gate-json', 'print only the Mission Control review gate as JSON')
-        .option('--review-policy', 'print only the Mission Control review policy as JSON')
-        .option('--review-replies', 'print only the Mission Control reviewer reply choices')
-        .option('--mission-script', 'print the Mission Control shell script')
-        .option('--shortcuts', 'print the Mission Control shortcut command index')
-        .option('--shortcuts-json', 'print the Mission Control shortcut command index as JSON')
-        .action(runStartCommandAction);
+        .description('Orient an engineer or agent with the next best workflow for this repo');
+    registerStartOptions(startCommand).action(runStartCommandAction);
 }
 //# sourceMappingURL=start.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../src/cli/commands/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE3E,MAAM,UAAU,aAAa;IAC3B,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,uEAAuE,CAAC;SACpF,MAAM,CACL,eAAe,EACf,qFAAqF,CACtF;SACA,MAAM,CAAC,iBAAiB,EAAE,wDAAwD,CAAC;SACnF,MAAM,CAAC,iBAAiB,EAAE,mEAAmE,CAAC;SAC9F,MAAM,CAAC,qBAAqB,EAAE,mCAAmC,EAAE,gBAAgB,CAAC;SACpF,MAAM,CAAC,qBAAqB,EAAE,+BAA+B,EAAE,gBAAgB,CAAC;SAChF,MAAM,CAAC,mBAAmB,EAAE,mCAAmC,CAAC;SAChE,MAAM,CAAC,kBAAkB,EAAE,uDAAuD,CAAC;SACnF,MAAM,CAAC,gBAAgB,EAAE,uDAAuD,CAAC;SACjF,MAAM,CACL,kBAAkB,EAClB,qEAAqE,CACtE;SACA,MAAM,CACL,oBAAoB,EACpB,0EAA0E,CAC3E;SACA,MAAM,CAAC,kBAAkB,EAAE,iDAAiD,CAAC;SAC7E,MAAM,CAAC,aAAa,EAAE,iDAAiD,CAAC;SACxE,MAAM,CAAC,eAAe,EAAE,8DAA8D,CAAC;SACvF,MAAM,CAAC,gBAAgB,EAAE,+DAA+D,CAAC;SACzF,MAAM,CAAC,sBAAsB,EAAE,oDAAoD,CAAC;SACpF,MAAM,CAAC,WAAW,EAAE,iDAAiD,CAAC;SACtE,MAAM,CAAC,aAAa,EAAE,mDAAmD,CAAC;SAC1E,MAAM,CAAC,eAAe,EAAE,4CAA4C,CAAC;SACrE,MAAM,CAAC,oBAAoB,EAAE,oDAAoD,CAAC;SAClF,MAAM,CAAC,iBAAiB,EAAE,sDAAsD,CAAC;SACjF,MAAM,CAAC,kBAAkB,EAAE,uDAAuD,CAAC;SACnF,MAAM,CAAC,kBAAkB,EAAE,wCAAwC,CAAC;SACpE,MAAM,CAAC,aAAa,EAAE,kDAAkD,CAAC;SACzE,MAAM,CAAC,kBAAkB,EAAE,0DAA0D,CAAC;SACtF,MAAM,CAAC,qBAAqB,CAAC,CAAC;AACnC,CAAC"}
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../src/cli/commands/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE,MAAM,UAAU,aAAa;IAC3B,MAAM,YAAY,GAAG,OAAO;SACzB,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,uEAAuE,CAAC,CAAC;IAExF,oBAAoB,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;AACnE,CAAC"}

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

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerStartOptions(command: Command): Command;

package/dist/cli/commands/startOptionsRegistration.js

@@ -0,0 +1,29 @@
+import { parsePositiveInt } from './startAction.js';
+export function registerStartOptions(command) {
+    return command
+        .option('--mode <mode>', 'before_edit, before_commit, before_merge, refactor, release, bug_hunt, or hardening')
+        .option('--intent <text>', 'plain-language goal to route into the next best action')
+        .option('--mission <dir>', 'read an existing Mission Control bundle and include proof outcome')
+        .option('--max-tasks <count>', 'maximum workplan tasks to inspect', parsePositiveInt)
+        .option('--max-risks <count>', 'maximum start risks to return', parsePositiveInt)
+        .option('--include-handoff', 'include a compact handoff payload')
+        .option('--handoff-prompt', 'print only the concise Mission Control handoff prompt')
+        .option('--next-command', 'print only the current Mission Control cursor command')
+        .option('--next-tool-call', 'print only the current Mission Control cursor MCP tool call as JSON')
+        .option('--ready-tool-calls', 'print all currently ready Mission Control MCP tool calls as compact JSON')
+        .option('--proof-commands', 'print only ready Mission Control proof commands')
+        .option('--checklist', 'print only the Mission Control resume checklist')
+        .option('--resume-json', 'print only the Mission Control resume object as compact JSON')
+        .option('--handoff-json', 'print only the Mission Control handoff object as compact JSON')
+        .option('--save-mission <dir>', 'write the Mission Control bundle to this directory')
+        .option('--runbook', 'print only the Mission Control Markdown runbook')
+        .option('--task-card', 'print only the Mission Control Markdown task card')
+        .option('--review-gate', 'print only the Mission Control review gate')
+        .option('--review-gate-json', 'print only the Mission Control review gate as JSON')
+        .option('--review-policy', 'print only the Mission Control review policy as JSON')
+        .option('--review-replies', 'print only the Mission Control reviewer reply choices')
+        .option('--mission-script', 'print the Mission Control shell script')
+        .option('--shortcuts', 'print the Mission Control shortcut command index')
+        .option('--shortcuts-json', 'print the Mission Control shortcut command index as JSON');
+}
+//# sourceMappingURL=startOptionsRegistration.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"startOptionsRegistration.js","sourceRoot":"","sources":["../../../src/cli/commands/startOptionsRegistration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO,OAAO;SACX,MAAM,CACL,eAAe,EACf,qFAAqF,CACtF;SACA,MAAM,CAAC,iBAAiB,EAAE,wDAAwD,CAAC;SACnF,MAAM,CAAC,iBAAiB,EAAE,mEAAmE,CAAC;SAC9F,MAAM,CAAC,qBAAqB,EAAE,mCAAmC,EAAE,gBAAgB,CAAC;SACpF,MAAM,CAAC,qBAAqB,EAAE,+BAA+B,EAAE,gBAAgB,CAAC;SAChF,MAAM,CAAC,mBAAmB,EAAE,mCAAmC,CAAC;SAChE,MAAM,CAAC,kBAAkB,EAAE,uDAAuD,CAAC;SACnF,MAAM,CAAC,gBAAgB,EAAE,uDAAuD,CAAC;SACjF,MAAM,CACL,kBAAkB,EAClB,qEAAqE,CACtE;SACA,MAAM,CACL,oBAAoB,EACpB,0EAA0E,CAC3E;SACA,MAAM,CAAC,kBAAkB,EAAE,iDAAiD,CAAC;SAC7E,MAAM,CAAC,aAAa,EAAE,iDAAiD,CAAC;SACxE,MAAM,CAAC,eAAe,EAAE,8DAA8D,CAAC;SACvF,MAAM,CAAC,gBAAgB,EAAE,+DAA+D,CAAC;SACzF,MAAM,CAAC,sBAAsB,EAAE,oDAAoD,CAAC;SACpF,MAAM,CAAC,WAAW,EAAE,iDAAiD,CAAC;SACtE,MAAM,CAAC,aAAa,EAAE,mDAAmD,CAAC;SAC1E,MAAM,CAAC,eAAe,EAAE,4CAA4C,CAAC;SACrE,MAAM,CAAC,oBAAoB,EAAE,oDAAoD,CAAC;SAClF,MAAM,CAAC,iBAAiB,EAAE,sDAAsD,CAAC;SACjF,MAAM,CAAC,kBAAkB,EAAE,uDAAuD,CAAC;SACnF,MAAM,CAAC,kBAAkB,EAAE,wCAAwC,CAAC;SACpE,MAAM,CAAC,aAAa,EAAE,kDAAkD,CAAC;SACzE,MAAM,CAAC,kBAAkB,EAAE,0DAA0D,CAAC,CAAC;AAC5F,CAAC"}

package/dist/core/ast.d.ts

@@ -1,21 +1,6 @@
-import type { AstExport, AstImport, FunctionInfo } from './astTypes.js';
+import { type AstResult } from './astResult.js';
 export type { AstExport, AstImport, FunctionInfo, SymbolKind } from './astTypes.js';
-export interface AstResult {
-    ok: boolean;
-    reason?: string;
-    imports: AstImport[];
-    exports: AstExport[];
-    callSites: string[];
-    lineCount: number;
-    /** File-level McCabe cyclomatic complexity: decision points + 1. 0 when unparsed. */
-    cyclomaticComplexity: number;
-    /**
-     * Per-function CC. May be empty when the adapter doesn't yet support
-     * per-function granularity or when the file has no function definitions.
-     * 0.13.0+ all six adapters populate this for parsed files.
-     */
-    functions: FunctionInfo[];
-}
+export type { AstResult } from './astResult.js';
 export { isParseable } from './astParser.js';
 /**
  * Parse a source file and extract imports, exports, and call sites.

package/dist/core/ast.js

@@ -1,17 +1,5 @@
-import { extractFunctionsFromBabel } from './astFunctionCollector.js';
-import { visitTopLevel } from './astModuleSignals.js';
 import { isParseable, parseBabelFile } from './astParser.js';
-import { collectProgramSignals } from './astProgramSignals.js';
-const EMPTY = {
-    ok: false,
-    reason: 'unparsed',
-    imports: [],
-    exports: [],
-    callSites: [],
-    lineCount: 0,
-    cyclomaticComplexity: 0,
-    functions: [],
-};
+import { parsedAstResult, unparsedAstResult } from './astResult.js';
 export { isParseable } from './astParser.js';
 /**
  * Parse a source file and extract imports, exports, and call sites.
@@ -24,28 +12,11 @@ export { isParseable } from './astParser.js';
  */
 export function parseSource(filePath, content) {
     if (!isParseable(filePath)) {
-        return { ...EMPTY, reason: 'non-source extension' };
+        return unparsedAstResult('non-source extension');
     }
     const parsed = parseBabelFile(filePath, content);
     if (!parsed.ok)
-        return { ...EMPTY, reason: parsed.reason };
-    const ast = parsed.ast;
-    const imports = [];
-    const exports = [];
-    const callSites = [];
-    for (const node of ast.program.body) {
-        visitTopLevel(node, imports, exports);
-    }
-    const decisionPoints = collectProgramSignals(ast.program, imports, callSites);
-    const functions = extractFunctionsFromBabel(ast.program);
-    return {
-        ok: true,
-        imports,
-        exports,
-        callSites: [...new Set(callSites)],
-        lineCount: content ? content.split('\n').length : 0,
-        cyclomaticComplexity: decisionPoints + 1,
-        functions,
-    };
+        return unparsedAstResult(parsed.reason);
+    return parsedAstResult(parsed.ast.program, content);
 }
 //# sourceMappingURL=ast.js.map

package/dist/core/ast.js.map

@@ -1 +1 @@
-{"version":3,"file":"ast.js","sourceRoot":"","sources":["../../src/core/ast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAsB/D,MAAM,KAAK,GAAc;IACvB,EAAE,EAAE,KAAK;IACT,MAAM,EAAE,UAAU;IAClB,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,EAAE;IACX,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,CAAC;IACZ,oBAAoB,EAAE,CAAC;IACvB,SAAS,EAAE,EAAE;CACd,CAAC;AAEF,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,OAAe;IAC3D,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACtD,CAAC;IAED,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjD,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC3D,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;IAEvB,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACpC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,cAAc,GAAG,qBAAqB,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAE9E,MAAM,SAAS,GAAG,yBAAyB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAEzD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO;QACP,OAAO;QACP,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;QAClC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACnD,oBAAoB,EAAE,cAAc,GAAG,CAAC;QACxC,SAAS;KACV,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ast.js","sourceRoot":"","sources":["../../src/core/ast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAkB,MAAM,gBAAgB,CAAC;AAKpF,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,OAAe;IAC3D,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3B,OAAO,iBAAiB,CAAC,sBAAsB,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjD,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACxD,OAAO,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC"}

package/dist/core/astResult.d.ts

@@ -0,0 +1,20 @@
+import type { Program } from '@babel/types';
+import type { AstExport, AstImport, FunctionInfo } from './astTypes.js';
+export interface AstResult {
+    ok: boolean;
+    reason?: string;
+    imports: AstImport[];
+    exports: AstExport[];
+    callSites: string[];
+    lineCount: number;
+    /** File-level McCabe cyclomatic complexity: decision points + 1. 0 when unparsed. */
+    cyclomaticComplexity: number;
+    /**
+     * Per-function CC. May be empty when the adapter doesn't yet support
+     * per-function granularity or when the file has no function definitions.
+     * 0.13.0+ all six adapters populate this for parsed files.
+     */
+    functions: FunctionInfo[];
+}
+export declare function unparsedAstResult(reason?: string): AstResult;
+export declare function parsedAstResult(program: Program, content: string): AstResult;

package/dist/core/astResult.js

@@ -0,0 +1,39 @@
+import { extractFunctionsFromBabel } from './astFunctionCollector.js';
+import { visitTopLevel } from './astModuleSignals.js';
+import { collectProgramSignals } from './astProgramSignals.js';
+const EMPTY_AST_RESULT = {
+    ok: false,
+    reason: 'unparsed',
+    imports: [],
+    exports: [],
+    callSites: [],
+    lineCount: 0,
+    cyclomaticComplexity: 0,
+    functions: [],
+};
+export function unparsedAstResult(reason = 'unparsed') {
+    return { ...EMPTY_AST_RESULT, reason };
+}
+export function parsedAstResult(program, content) {
+    const imports = [];
+    const exports = [];
+    const callSites = [];
+    for (const node of program.body) {
+        visitTopLevel(node, imports, exports);
+    }
+    const decisionPoints = collectProgramSignals(program, imports, callSites);
+    const functions = extractFunctionsFromBabel(program);
+    return {
+        ok: true,
+        imports,
+        exports,
+        callSites: [...new Set(callSites)],
+        lineCount: lineCountForContent(content),
+        cyclomaticComplexity: decisionPoints + 1,
+        functions,
+    };
+}
+function lineCountForContent(content) {
+    return content ? content.split('\n').length : 0;
+}
+//# sourceMappingURL=astResult.js.map

package/dist/core/astResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"astResult.js","sourceRoot":"","sources":["../../src/core/astResult.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAoB/D,MAAM,gBAAgB,GAAc;IAClC,EAAE,EAAE,KAAK;IACT,MAAM,EAAE,UAAU;IAClB,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,EAAE;IACX,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,CAAC;IACZ,oBAAoB,EAAE,CAAC;IACvB,SAAS,EAAE,EAAE;CACd,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,MAAM,GAAG,UAAU;IACnD,OAAO,EAAE,GAAG,gBAAgB,EAAE,MAAM,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAgB,EAAE,OAAe;IAC/D,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAChC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,cAAc,GAAG,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAC1E,MAAM,SAAS,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;IAErD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO;QACP,OAAO;QACP,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;QAClC,SAAS,EAAE,mBAAmB,CAAC,OAAO,CAAC;QACvC,oBAAoB,EAAE,cAAc,GAAG,CAAC;QACxC,SAAS;KACV,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAe;IAC1C,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC"}

package/dist/core/codeGraph.d.ts

@@ -1,5 +1,6 @@
 import type { FileEntry } from '../types.js';
 export { packagesUsed, filesImportingPackage, filesImportingFile, filesDefiningSymbol, importersOf, exportsOf, importsOf, } from './codeGraphQueries.js';
+export { incrementallyUpdateGraph } from './codeGraphIncremental.js';
 import type { CodeGraph, GraphFile } from './codeGraphTypes.js';
 export type { CodeGraph, GraphFile };
 export declare function buildCodeGraph(rootPath: string, files: FileEntry[], previousGraph?: CodeGraph): Promise<CodeGraph>;
@@ -9,19 +10,3 @@ export declare function buildCodeGraph(rootPath: string, files: FileEntry[], pre
  * `getAdapterFor(filePath).toPackageName(specifier)`.
  */
 export declare function toPackageName(specifier: string): string | null;
-/**
- * 0.16.0: targeted incremental update for watch mode. Given a graph and a
- * list of repo-relative paths that may have changed (added, modified, or
- * deleted), update the graph in place: re-stat each path, re-parse changed
- * ones, drop deleted ones, and fix up the cross-file derived indexes
- * (`localImporters`, `packageImporters`, `symbolDefs`, per-function
- * `fanIn`).
- *
- * Returns the same `graph` reference. Cheap: O(changedPaths) for the parse
- * pass; the fan-in recomputation is O(graph.files) but it's a single
- * walk over already-parsed entries (no IO).
- *
- * `changedPaths` should be repo-relative (forward-slash). Files that don't
- * exist are treated as deletions; files that do exist are re-parsed.
- */
-export declare function incrementallyUpdateGraph(graph: CodeGraph, rootPath: string, changedPaths: string[]): Promise<CodeGraph>;

package/dist/core/codeGraph.js

@@ -1,12 +1,13 @@
-import path from 'node:path';
 import { listAdapters } from './languages/registry.js';
 import { mapWithConcurrency, DEFAULT_FILE_IO_CONCURRENCY } from '../utils/concurrency.js';
 import { computeFanIn, computeFanOut } from './codeGraphFanMetrics.js';
 import { selectParseableGraphInputs } from './codeGraphFileSelection.js';
 import { rebuildCrossFileIndexes } from './codeGraphIndexes.js';
-import { parseFileToGraphEntry, processChangedPath } from './codeGraphParsing.js';
+import { parseFileToGraphEntry } from './codeGraphParsing.js';
+import { prepareAdapterContexts } from './codeGraphAdapterContexts.js';
 export { packagesUsed, filesImportingPackage, filesImportingFile, filesDefiningSymbol, importersOf, exportsOf, importsOf, } from './codeGraphQueries.js';
-import { expandLocalStarReexports, isLocalStarReexport } from './codeGraphReexports.js';
+export { incrementallyUpdateGraph } from './codeGraphIncremental.js';
+import { expandLocalStarReexports } from './codeGraphReexports.js';
 export async function buildCodeGraph(rootPath, files, previousGraph) {
     const contextByAdapter = await prepareAdapterContexts(rootPath, files);
     const parseable = selectParseableGraphInputs(files);
@@ -31,18 +32,6 @@ export async function buildCodeGraph(rootPath, files, previousGraph) {
         scannedFiles: graphFiles.size,
     };
 }
-/**
- * Per-adapter setup (e.g. Python package-root detection from
- * pyproject.toml, Rust workspace detection from Cargo.toml). Run once
- * per graph build; cheap relative to parsing.
- */
-async function prepareAdapterContexts(rootPath, files) {
-    const contextByAdapter = new Map();
-    for (const adapter of listAdapters()) {
-        contextByAdapter.set(adapter, await adapter.preparePackageRoots(rootPath, files));
-    }
-    return contextByAdapter;
-}
 /**
  * Back-compat: convert a JS/TS import specifier to a bare package name.
  * Delegates to the JavaScript adapter. For multi-language use cases, prefer
@@ -52,78 +41,4 @@ export function toPackageName(specifier) {
     const jsAdapter = listAdapters().find((a) => a.id === 'javascript');
     return jsAdapter ? jsAdapter.toPackageName(specifier) : null;
 }
-/**
- * 0.16.0: targeted incremental update for watch mode. Given a graph and a
- * list of repo-relative paths that may have changed (added, modified, or
- * deleted), update the graph in place: re-stat each path, re-parse changed
- * ones, drop deleted ones, and fix up the cross-file derived indexes
- * (`localImporters`, `packageImporters`, `symbolDefs`, per-function
- * `fanIn`).
- *
- * Returns the same `graph` reference. Cheap: O(changedPaths) for the parse
- * pass; the fan-in recomputation is O(graph.files) but it's a single
- * walk over already-parsed entries (no IO).
- *
- * `changedPaths` should be repo-relative (forward-slash). Files that don't
- * exist are treated as deletions; files that do exist are re-parsed.
- */
-export async function incrementallyUpdateGraph(graph, rootPath, changedPaths) {
-    if (changedPaths.length === 0)
-        return graph;
-    // 1.10+ — re-parse changed files first, then derive adapter contexts
-    // against the post-update graph view. Previously contexts were computed
-    // from the pre-update graph, so a newly-added manifest (pyproject.toml,
-    // Cargo.toml, go.mod) batched with source files wasn't in the file list
-    // passed to preparePackageRoots — the adapter derived a stale set of
-    // package roots and mis-resolved that batch's imports until the next
-    // tick. Parsing itself doesn't depend on context, so the reorder is safe.
-    await Promise.all(changedPaths.map((rel) => processChangedPath(graph, rootPath, rel)));
-    await refreshLocalStarReexporters(graph, rootPath);
-    const contextByAdapter = await prepareAdapterContexts(rootPath, fakeFilesFromGraph(graph, rootPath));
-    expandLocalStarReexports(graph.files, contextByAdapter);
-    rebuildIndexesIntoGraph(graph, contextByAdapter);
-    computeFanIn(graph.files);
-    computeFanOut(graph.files);
-    graph.scannedFiles = graph.files.size;
-    return graph;
-}
-async function refreshLocalStarReexporters(graph, rootPath) {
-    const reexporters = [...graph.files.values()]
-        .filter((entry) => entry.imports.some(isLocalStarReexport))
-        .map((entry) => entry.relativePath);
-    await Promise.all(reexporters.map((rel) => processChangedPath(graph, rootPath, rel)));
-}
-/**
- * Build a FileEntry[]-shaped stand-in from the current graph, used as
- * the input to `preparePackageRoots` during incremental update — the
- * adapters need a complete view of repo layout to detect manifest
- * edits (pyproject.toml, go.mod) that would shift package roots.
- */
-function fakeFilesFromGraph(graph, rootPath) {
-    return [...graph.files.values()].map((gf) => ({
-        relativePath: gf.relativePath,
-        absolutePath: path.resolve(rootPath, gf.relativePath),
-        directory: path.dirname(gf.relativePath),
-        extension: path.extname(gf.relativePath),
-        sizeBytes: 0,
-    }));
-}
-/**
- * Rebuild the graph's cross-file indexes in place — clear, then refill
- * from scratch. The graph is small relative to parse cost so rebuilding
- * edges in O(N) keeps the logic simple and avoids orphan-edge bugs from
- * in-place patching.
- */
-function rebuildIndexesIntoGraph(graph, contextByAdapter) {
-    const { localImporters, packageImporters, symbolDefs } = rebuildCrossFileIndexes(graph.files, contextByAdapter);
-    graph.localImporters.clear();
-    for (const [k, v] of localImporters)
-        graph.localImporters.set(k, v);
-    graph.packageImporters.clear();
-    for (const [k, v] of packageImporters)
-        graph.packageImporters.set(k, v);
-    graph.symbolDefs.clear();
-    for (const [k, v] of symbolDefs)
-        graph.symbolDefs.set(k, v);
-}
 //# sourceMappingURL=codeGraph.js.map

package/dist/core/codeGraph.js.map

@@ -1 +1 @@
-{"version":3,"file":"codeGraph.js","sourceRoot":"","sources":["../../src/core/codeGraph.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"codeGraph.js","sourceRoot":"","sources":["../../src/core/codeGraph.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,SAAS,EACT,SAAS,GACV,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAKnE,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAgB,EAChB,KAAkB,EAClB,aAAyB;IAEzB,MAAM,gBAAgB,GAAG,MAAM,sBAAsB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,0BAA0B,CAAC,KAAK,CAAC,CAAC;IAEpD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAqB,CAAC;IAChD,mEAAmE;IACnE,0EAA0E;IAC1E,mEAAmE;IACnE,MAAM,kBAAkB,CAAC,SAAS,EAAE,2BAA2B,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;QAC3F,MAAM,KAAK,GAAG,MAAM,qBAAqB,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;QAClF,IAAI,KAAK;YAAE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,wBAAwB,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IACvD,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,GAAG,uBAAuB,CAC9E,UAAU,EACV,gBAAgB,CACjB,CAAC;IACF,YAAY,CAAC,UAAU,CAAC,CAAC;IACzB,aAAa,CAAC,UAAU,CAAC,CAAC;IAE1B,OAAO;QACL,KAAK,EAAE,UAAU;QACjB,gBAAgB;QAChB,cAAc;QACd,UAAU;QACV,YAAY,EAAE,UAAU,CAAC,IAAI;KAC9B,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,YAAY,CAAC,CAAC;IACpE,OAAO,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/D,CAAC"}

package/dist/core/codeGraphAdapterContexts.d.ts

@@ -0,0 +1,8 @@
+import type { FileEntry } from '../types.js';
+import type { LanguageAdapter, LanguageResolveContext } from './languages/LanguageAdapter.js';
+/**
+ * Per-adapter setup (e.g. Python package-root detection from
+ * pyproject.toml, Rust workspace detection from Cargo.toml). Run once
+ * per graph build; cheap relative to parsing.
+ */
+export declare function prepareAdapterContexts(rootPath: string, files: FileEntry[]): Promise<Map<LanguageAdapter, LanguageResolveContext>>;

package/dist/core/codeGraphAdapterContexts.js

@@ -0,0 +1,14 @@
+import { listAdapters } from './languages/registry.js';
+/**
+ * Per-adapter setup (e.g. Python package-root detection from
+ * pyproject.toml, Rust workspace detection from Cargo.toml). Run once
+ * per graph build; cheap relative to parsing.
+ */
+export async function prepareAdapterContexts(rootPath, files) {
+    const contextByAdapter = new Map();
+    for (const adapter of listAdapters()) {
+        contextByAdapter.set(adapter, await adapter.preparePackageRoots(rootPath, files));
+    }
+    return contextByAdapter;
+}
+//# sourceMappingURL=codeGraphAdapterContexts.js.map

package/dist/core/codeGraphAdapterContexts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeGraphAdapterContexts.js","sourceRoot":"","sources":["../../src/core/codeGraphAdapterContexts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAAgB,EAChB,KAAkB;IAElB,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA2C,CAAC;IAC5E,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,EAAE,CAAC;QACrC,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC"}

package/dist/core/codeGraphIncremental.d.ts

@@ -0,0 +1,17 @@
+import type { CodeGraph } from './codeGraphTypes.js';
+/**
+ * 0.16.0: targeted incremental update for watch mode. Given a graph and a
+ * list of repo-relative paths that may have changed (added, modified, or
+ * deleted), update the graph in place: re-stat each path, re-parse changed
+ * ones, drop deleted ones, and fix up the cross-file derived indexes
+ * (`localImporters`, `packageImporters`, `symbolDefs`, per-function
+ * `fanIn`).
+ *
+ * Returns the same `graph` reference. Cheap: O(changedPaths) for the parse
+ * pass; the fan-in recomputation is O(graph.files) but it's a single
+ * walk over already-parsed entries (no IO).
+ *
+ * `changedPaths` should be repo-relative (forward-slash). Files that don't
+ * exist are treated as deletions; files that do exist are re-parsed.
+ */
+export declare function incrementallyUpdateGraph(graph: CodeGraph, rootPath: string, changedPaths: string[]): Promise<CodeGraph>;

package/dist/core/codeGraphIncremental.js

@@ -0,0 +1,64 @@
+import path from 'node:path';
+import { computeFanIn, computeFanOut } from './codeGraphFanMetrics.js';
+import { rebuildCrossFileIndexes } from './codeGraphIndexes.js';
+import { processChangedPath } from './codeGraphParsing.js';
+import { expandLocalStarReexports, isLocalStarReexport } from './codeGraphReexports.js';
+import { prepareAdapterContexts } from './codeGraphAdapterContexts.js';
+/**
+ * 0.16.0: targeted incremental update for watch mode. Given a graph and a
+ * list of repo-relative paths that may have changed (added, modified, or
+ * deleted), update the graph in place: re-stat each path, re-parse changed
+ * ones, drop deleted ones, and fix up the cross-file derived indexes
+ * (`localImporters`, `packageImporters`, `symbolDefs`, per-function
+ * `fanIn`).
+ *
+ * Returns the same `graph` reference. Cheap: O(changedPaths) for the parse
+ * pass; the fan-in recomputation is O(graph.files) but it's a single
+ * walk over already-parsed entries (no IO).
+ *
+ * `changedPaths` should be repo-relative (forward-slash). Files that don't
+ * exist are treated as deletions; files that do exist are re-parsed.
+ */
+export async function incrementallyUpdateGraph(graph, rootPath, changedPaths) {
+    if (changedPaths.length === 0)
+        return graph;
+    // Re-parse changed files first, then derive adapter contexts against the
+    // post-update graph so manifest changes are visible before import expansion.
+    await Promise.all(changedPaths.map((rel) => processChangedPath(graph, rootPath, rel)));
+    await refreshLocalStarReexporters(graph, rootPath);
+    const contextByAdapter = await prepareAdapterContexts(rootPath, fakeFilesFromGraph(graph, rootPath));
+    expandLocalStarReexports(graph.files, contextByAdapter);
+    rebuildIndexesIntoGraph(graph, contextByAdapter);
+    computeFanIn(graph.files);
+    computeFanOut(graph.files);
+    graph.scannedFiles = graph.files.size;
+    return graph;
+}
+async function refreshLocalStarReexporters(graph, rootPath) {
+    const reexporters = [...graph.files.values()]
+        .filter((entry) => entry.imports.some(isLocalStarReexport))
+        .map((entry) => entry.relativePath);
+    await Promise.all(reexporters.map((rel) => processChangedPath(graph, rootPath, rel)));
+}
+function fakeFilesFromGraph(graph, rootPath) {
+    return [...graph.files.values()].map((gf) => ({
+        relativePath: gf.relativePath,
+        absolutePath: path.resolve(rootPath, gf.relativePath),
+        directory: path.dirname(gf.relativePath),
+        extension: path.extname(gf.relativePath),
+        sizeBytes: 0,
+    }));
+}
+function rebuildIndexesIntoGraph(graph, contextByAdapter) {
+    const { localImporters, packageImporters, symbolDefs } = rebuildCrossFileIndexes(graph.files, contextByAdapter);
+    graph.localImporters.clear();
+    for (const [k, v] of localImporters)
+        graph.localImporters.set(k, v);
+    graph.packageImporters.clear();
+    for (const [k, v] of packageImporters)
+        graph.packageImporters.set(k, v);
+    graph.symbolDefs.clear();
+    for (const [k, v] of symbolDefs)
+        graph.symbolDefs.set(k, v);
+}
+//# sourceMappingURL=codeGraphIncremental.js.map

package/dist/core/codeGraphIncremental.js.map

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

package/dist/core/collisionDetector.d.ts

@@ -34,6 +34,7 @@ export interface CollisionWorktreeSummary {
     path: string;
     branch: string | null;
     changedFileCount: number;
+    uncommittedChangedFileCount: number;
     baseRef: string | null;
 }
 export interface CollisionReport {

package/dist/core/collisionDetector.js

@@ -62,6 +62,7 @@ export async function detectCollisions(rootPath, options = {}) {
             path: w.path,
             branch: w.branch,
             changedFileCount: 0,
+            uncommittedChangedFileCount: 0,
             baseRef: null,
         }));
         return {
@@ -81,6 +82,7 @@ export async function detectCollisions(rootPath, options = {}) {
         return {
             ref: w,
             files: result.available ? result.files : [],
+            uncommittedFiles: result.available ? result.uncommittedFiles : [],
             baseRef: result.baseRef,
         };
     }));
@@ -202,6 +204,7 @@ export async function detectCollisions(rootPath, options = {}) {
         path: c.ref.path,
         branch: c.ref.branch,
         changedFileCount: c.files.length,
+        uncommittedChangedFileCount: c.uncommittedFiles.length,
         baseRef: c.baseRef,
     }));
     return {