@cleocode/nexus 2026.9.16 → 2026.9.17

package/dist/src/pipeline/parse-cache.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Parse cache — per-file extraction memo that makes incremental indexing exact.
+ *
+ * Cross-file resolution (imports, barrels, heritage, calls, accesses) needs the
+ * COMPLETE extraction of every file, and most of what it consumes — raw call
+ * sites, unresolved access sites, re-export records — is never stored in the
+ * published graph rows. Reconstructing those facts from `nexus_nodes` /
+ * `nexus_relations` would be an approximation, so the extraction itself is
+ * persisted instead.
+ *
+ * Extraction is a pure function of `(path, bytes, extractor build, publication
+ * generation)`. An entry is therefore reusable exactly when the file's content
+ * hash and the extractor fingerprint both match; the only generation-dependent
+ * token (the publication generation embedded in anonymous scope identities and
+ * reference evidence) is rewritten on reuse. Everything downstream of
+ * extraction — import resolution, barrel maps, heritage, call and access
+ * resolution, communities and flows — reruns over the merged extraction, so an
+ * incremental run computes the same function as a full rebuild over the same
+ * inputs rather than patching a previous answer.
+ *
+ * @task T12315
+ * @module pipeline/parse-cache
+ */
+import type { GraphParseCacheEntry } from '@cleocode/contracts';
+import type { CommonExtractionResult } from './parse-loop.js';
+/**
+ * One file's complete extraction output, keyed by the file it describes.
+ *
+ * Kept per file (never merged across files) so a file's facts can be replaced
+ * without disturbing any other file's.
+ */
+export interface FileExtraction {
+    /** Path relative to the repository root. */
+    path: string;
+    /** Declarations, imports, heritage, calls, re-exports and accesses of this file. */
+    extraction: Required<CommonExtractionResult>;
+}
+/**
+ * Fingerprint the extractor build: every module under the pipeline and code
+ * directories plus the installed grammar package versions.
+ *
+ * Deliberately over-inclusive — ANY change to pipeline code invalidates every
+ * cache entry. A missed invalidation would publish an incremental graph that
+ * silently differs from a full rebuild, which is worse than re-parsing.
+ *
+ * @returns A hex fingerprint, or `null` when the build cannot be fingerprinted
+ *   (the caller must then refuse to reuse any entry).
+ */
+export declare function computeExtractorFingerprint(): string | null;
+/**
+ * Encode a freshly parsed extraction for storage.
+ *
+ * Must be called before any downstream phase mutates the extracted nodes
+ * (community detection writes `communityId` onto them).
+ *
+ * @param file - The per-file extraction to encode.
+ * @param contentHash - SHA-256 of the parsed bytes.
+ * @param fingerprint - Extractor fingerprint from {@link computeExtractorFingerprint}.
+ * @param generation - Publication generation the extraction was produced under.
+ * @returns A cache entry ready for atomic publication.
+ */
+export declare function encodeParseCacheEntry(file: FileExtraction, contentHash: string, fingerprint: string, generation: string): GraphParseCacheEntry;
+/**
+ * Decode a stored extraction and rebind it to the current publication generation.
+ *
+ * @param entry - Stored cache entry.
+ * @param generation - The publication generation of the run reusing it.
+ * @returns The extraction exactly as re-parsing the same bytes under `generation` would produce.
+ * @throws When the payload is not a decodable extraction; callers treat that file as changed.
+ */
+export declare function decodeParseCacheEntry(entry: GraphParseCacheEntry, generation: string): FileExtraction;
+//# sourceMappingURL=parse-cache.d.ts.map

package/dist/src/pipeline/parse-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-cache.d.ts","sourceRoot":"","sources":["../../../src/pipeline/parse-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAQH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,UAAU,EAAE,QAAQ,CAAC,sBAAsB,CAAC,CAAC;CAC9C;AAsCD;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,GAAG,IAAI,CAmC3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,cAAc,EACpB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,oBAAoB,CAQtB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,oBAAoB,EAC3B,UAAU,EAAE,MAAM,GACjB,cAAc,CAgBhB"}

package/dist/src/pipeline/parse-cache.js

@@ -0,0 +1,158 @@
+/**
+ * Parse cache — per-file extraction memo that makes incremental indexing exact.
+ *
+ * Cross-file resolution (imports, barrels, heritage, calls, accesses) needs the
+ * COMPLETE extraction of every file, and most of what it consumes — raw call
+ * sites, unresolved access sites, re-export records — is never stored in the
+ * published graph rows. Reconstructing those facts from `nexus_nodes` /
+ * `nexus_relations` would be an approximation, so the extraction itself is
+ * persisted instead.
+ *
+ * Extraction is a pure function of `(path, bytes, extractor build, publication
+ * generation)`. An entry is therefore reusable exactly when the file's content
+ * hash and the extractor fingerprint both match; the only generation-dependent
+ * token (the publication generation embedded in anonymous scope identities and
+ * reference evidence) is rewritten on reuse. Everything downstream of
+ * extraction — import resolution, barrel maps, heritage, call and access
+ * resolution, communities and flows — reruns over the merged extraction, so an
+ * incremental run computes the same function as a full rebuild over the same
+ * inputs rather than patching a previous answer.
+ *
+ * @task T12315
+ * @module pipeline/parse-cache
+ */
+import { createHash } from 'node:crypto';
+import { readdirSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { join, relative } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { gunzipSync, gzipSync } from 'node:zlib';
+/**
+ * Serialization format version. Bump when the payload encoding (not the
+ * extractor) changes; extractor changes are caught by the fingerprint.
+ */
+const PAYLOAD_FORMAT = 'nexus-parse-cache/v1';
+/** Grammar packages whose native behaviour determines extraction output. */
+const GRAMMAR_PACKAGES = [
+    'tree-sitter',
+    'tree-sitter-typescript',
+    'tree-sitter-javascript',
+    'tree-sitter-python',
+    'tree-sitter-go',
+    'tree-sitter-rust',
+];
+let cachedFingerprint;
+/** Collect every module file under a directory, in a stable order. */
+function collectModuleFiles(directory, out) {
+    const entries = readdirSync(directory, { withFileTypes: true }).sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
+    for (const entry of entries) {
+        if (entry.name === '__tests__' || entry.name === 'node_modules')
+            continue;
+        const full = join(directory, entry.name);
+        if (entry.isDirectory())
+            collectModuleFiles(full, out);
+        else if (/\.(?:[cm]?js|ts)$/.test(entry.name) &&
+            !entry.name.endsWith('.d.ts') &&
+            !/\.test\.[cm]?[jt]s$/.test(entry.name))
+            out.push(full);
+    }
+}
+/**
+ * Fingerprint the extractor build: every module under the pipeline and code
+ * directories plus the installed grammar package versions.
+ *
+ * Deliberately over-inclusive — ANY change to pipeline code invalidates every
+ * cache entry. A missed invalidation would publish an incremental graph that
+ * silently differs from a full rebuild, which is worse than re-parsing.
+ *
+ * @returns A hex fingerprint, or `null` when the build cannot be fingerprinted
+ *   (the caller must then refuse to reuse any entry).
+ */
+export function computeExtractorFingerprint() {
+    if (cachedFingerprint !== undefined)
+        return cachedFingerprint;
+    try {
+        const hash = createHash('sha256').update(PAYLOAD_FORMAT);
+        const pipelineDir = fileURLToPath(new URL('.', import.meta.url));
+        const codeDir = fileURLToPath(new URL('../code/', import.meta.url));
+        const files = [];
+        collectModuleFiles(pipelineDir, files);
+        collectModuleFiles(codeDir, files);
+        if (files.length === 0)
+            throw new Error('no extractor modules found');
+        const packageSourceRoot = join(pipelineDir, '..');
+        for (const file of files) {
+            hash.update(relative(packageSourceRoot, file));
+            hash.update('\0');
+            hash.update(readFileSync(file));
+        }
+        const requireFromHere = createRequire(import.meta.url);
+        for (const pkg of GRAMMAR_PACKAGES) {
+            let version = 'absent';
+            try {
+                const manifest = JSON.parse(readFileSync(requireFromHere.resolve(`${pkg}/package.json`), 'utf8'));
+                version = manifest.version ?? 'unversioned';
+            }
+            catch {
+                // An uninstalled grammar is part of the build identity too.
+            }
+            hash.update(`${pkg}@${version}\0`);
+        }
+        hash.update(`node-abi:${process.versions.modules}`);
+        cachedFingerprint = hash.digest('hex');
+    }
+    catch {
+        cachedFingerprint = null;
+    }
+    return cachedFingerprint;
+}
+/**
+ * Encode a freshly parsed extraction for storage.
+ *
+ * Must be called before any downstream phase mutates the extracted nodes
+ * (community detection writes `communityId` onto them).
+ *
+ * @param file - The per-file extraction to encode.
+ * @param contentHash - SHA-256 of the parsed bytes.
+ * @param fingerprint - Extractor fingerprint from {@link computeExtractorFingerprint}.
+ * @param generation - Publication generation the extraction was produced under.
+ * @returns A cache entry ready for atomic publication.
+ */
+export function encodeParseCacheEntry(file, contentHash, fingerprint, generation) {
+    return {
+        path: file.path,
+        contentHash,
+        fingerprint,
+        generation,
+        payload: gzipSync(JSON.stringify(file.extraction), { level: 1 }),
+    };
+}
+/**
+ * Decode a stored extraction and rebind it to the current publication generation.
+ *
+ * @param entry - Stored cache entry.
+ * @param generation - The publication generation of the run reusing it.
+ * @returns The extraction exactly as re-parsing the same bytes under `generation` would produce.
+ * @throws When the payload is not a decodable extraction; callers treat that file as changed.
+ */
+export function decodeParseCacheEntry(entry, generation) {
+    if (!entry.generation)
+        throw new Error('Parse cache entry lacks its generation');
+    let text = gunzipSync(entry.payload).toString('utf8');
+    if (entry.generation !== generation)
+        text = text.split(entry.generation).join(generation);
+    const parsed = JSON.parse(text);
+    for (const key of [
+        'definitions',
+        'imports',
+        'heritage',
+        'calls',
+        'reExports',
+        'accesses',
+    ]) {
+        if (!Array.isArray(parsed[key]))
+            throw new Error(`Parse cache entry lacks ${key}`);
+    }
+    return { path: entry.path, extraction: parsed };
+}
+//# sourceMappingURL=parse-cache.js.map

package/dist/src/pipeline/parse-cache.js.map

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

package/dist/src/pipeline/parse-loop.d.ts

@@ -36,6 +36,7 @@ import { type ExtractedCall, type ExtractedHeritage, type ExtractedReExport } fr
 import type { ScannedFile } from './filesystem-walker.js';
 import type { BarrelExportMap, ExtractedImport, ImportResolutionContext, NamedImportMap, TsconfigPaths } from './import-processor.js';
 import type { KnowledgeGraph } from './knowledge-graph.js';
+import type { FileExtraction } from './parse-cache.js';
 import { type ExtractedAccess } from './processors/access-processor.js';
 import type { SymbolTable } from './symbol-table.js';
 /**
@@ -97,6 +98,17 @@ export interface ParseLoopOptions {
      * @param filePath - Current file path being processed
      */
     onProgress?: (current: number, total: number, filePath: string) => void;
+    /**
+     * Extractions reused from the parse cache, keyed by path (T12315). A parseable
+     * file with an entry here is not re-parsed; its extraction is merged exactly
+     * where re-parsing it would have been, so resolution sees the same input.
+     */
+    reusedExtractions?: ReadonlyMap<string, FileExtraction>;
+    /**
+     * Called once per freshly and successfully parsed file, before any later phase
+     * can mutate its nodes — the moment a parse-cache entry must be captured.
+     */
+    onFileExtracted?: (file: FileExtraction) => void;
 }
 /**
  * Result returned by the parse loop.
@@ -117,36 +129,34 @@ export interface ParseLoopResult {
      * Used by the call resolution phase to trace imports through barrel index files.
      */
     barrelMap: BarrelExportMap;
+    /** Parseable files handed to the parser this run. */
+    parsedFileCount: number;
+    /** Parseable files whose extraction came from {@link ParseLoopOptions.reusedExtractions}. */
+    reusedFileCount: number;
 }
 /**
- * Phase 3: Parse loop (parallel or sequential).
- *
- * For each TypeScript/JavaScript file in `files`:
- * 1. Read file content from disk
- * 2. Parse with tree-sitter (typescript or javascript grammar)
- * 3. Extract definitions → register in SymbolTable → add nodes to graph
- * 4. Extract imports → collect for batch resolution
- * 5. Extract heritage → accumulate for deferred edge emission
- *
- * After all files are processed:
- * - Resolves all collected imports via `processExtractedImports`
- * - Emits EXTENDS/IMPLEMENTS edges from accumulated heritage
+ * Phase 3: Parse loop (parallel or sequential), then merge.
  *
- * Files that fail to parse (grammar unavailable, syntax error, read error)
- * are skipped with a warning to stderr — the loop continues.
+ * 1. Classify every scanned file's role from its bytes.
+ * 2. Extract each parseable file that has no reusable cached extraction —
+ *    through the worker pool when the file count or byte volume warrants it.
+ * 3. Merge fresh and reused extractions **in scan order**: register symbols,
+ *    add nodes, emit DEFINES edges, and collect imports, re-exports, heritage,
+ *    calls and accesses. The merge order is the same whichever path produced
+ *    an extraction, so first-wins deduplication in the graph cannot depend on
+ *    which files happened to be re-parsed.
+ * 4. Resolve all imports and build the barrel map over the merged input.
  *
- * **Parallel mode** (Wave H): When `parseableFiles.length >= 15` or total
- * bytes >= 512 KB, the parallel path via the worker pool is attempted first.
- * If the worker script is not found (e.g. running from source without a
- * build), the sequential path is used as a fallback.
+ * Files that fail to parse are reported, not merged; the publish step decides
+ * what a given share of failures means.
  *
- * @param files - All scanned files (non-TypeScript/JavaScript files are filtered)
+ * @param files - All scanned files (non-parseable files are classified and reported only)
  * @param graph - Knowledge graph to add nodes and relations to
  * @param symbolTable - Symbol table to register extracted symbols in
  * @param importCtx - Pre-built import resolution context (from Phase 3a)
  * @param repoPath - Absolute path to the repository root (used to resolve relative paths)
- * @param options - Optional tsconfig paths, named import map, and progress callback
- * @returns Accumulated heritage and call records for Phase 3c and Phase 3e
+ * @param options - Resolution inputs, reuse map, progress and report callbacks
+ * @returns Accumulated heritage, call and access records plus the barrel map
  */
 export declare function runParseLoop(files: ScannedFile[], graph: KnowledgeGraph, symbolTable: SymbolTable, importCtx: ImportResolutionContext, repoPath: string, options?: ParseLoopOptions): Promise<ParseLoopResult>;
 //# sourceMappingURL=parse-loop.d.ts.map

package/dist/src/pipeline/parse-loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-loop.d.ts","sourceRoot":"","sources":["../../../src/pipeline/parse-loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAMH,OAAO,KAAK,EACV,oBAAoB,EACpB,SAAS,EAGT,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAa7B,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EAEvB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EAEf,uBAAuB,EACvB,cAAc,EACd,aAAa,EACd,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,EAAE,KAAK,eAAe,EAAmB,MAAM,kCAAkC,CAAC;AACzF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAkIrD;;;;;;;;;GASG;AACH,MAAM,WAAW,sBAAsB;IACrC,4DAA4D;IAC5D,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,0CAA0C;IAC1C,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,iCAAiC;IACjC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,gEAAgE;IAChE,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAChC,yCAAyC;IACzC,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;CAC9B;AA8DD;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,qBAAqB,EAC9B,qBAAqB,CAAC,EAAE,MAAM,GAC7B,sBAAsB,CAoBxB;AAmGD,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B,mFAAmF;IACnF,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,sEAAsE;IACtE,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACrC,sEAAsE;IACtE,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,qFAAqF;IACrF,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAEtD,4DAA4D;IAC5D,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC,4EAA4E;IAC5E,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACzE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,oFAAoF;IACpF,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,kFAAkF;IAClF,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B;;;OAGG;IACH,SAAS,EAAE,eAAe,CAAC;CAC5B;AA0eD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,WAAW,EAAE,EACpB,KAAK,EAAE,cAAc,EACrB,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,uBAAuB,EAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAuR1B"}
+{"version":3,"file":"parse-loop.d.ts","sourceRoot":"","sources":["../../../src/pipeline/parse-loop.ts"],"names":[],"mappings":"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"}