@quolu/lattice 0.1.0

package/sensor/dist/extraction/spawn-invokes.js

@@ -0,0 +1,327 @@
+"use strict";
+/**
+ * JS/TS `child_process` process-spawn detection and target folding (ADR 0048,
+ * Lattice sensor correctness fix c/1 — first "call graph非可視の結合" index).
+ *
+ * `spawnSync(process.execPath, [BIN, ...args])` reaches `BIN` by starting a
+ * brand-new OS process, not by calling a JS function — no `calls` edge can
+ * ever represent it, so a spawn-driven test harness (the oracle shape:
+ * `tests/orchestrate/helpers.mjs` spawning `bin/orchestrate-run.mjs`) showed
+ * zero `affected` dependents even though changing the spawned file plainly
+ * breaks the test. This module detects the five `child_process` launch
+ * functions (`spawn`, `spawnSync`, `execFile`, `execFileSync`, `fork`) —
+ * `exec`/`execSync` (shell-string parsing) are OUT OF SCOPE, see
+ * `resolveChildProcessCallee`'s doc — and folds their target argument(s) to a
+ * project-relative path using the same constant-folding engine as dynamic
+ * `import()`/`require()` (dynamic-import.ts's `foldConstantExpr`).
+ *
+ * Detection REQUIRES the callee to be verified bound to `child_process` (a
+ * static `import`/aliased/namespace member, or a simple
+ * `const { spawnSync } = require('node:child_process')`) — a bare name match
+ * on a user-defined `spawn()` must NOT produce an edge (mirrors fix (a)'s
+ * no-name-match-fallback principle).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SPAWN_INVOKES_UNRESOLVED_MARKER = void 0;
+exports.collectChildProcessBindings = collectChildProcessBindings;
+exports.resolveChildProcessCallee = resolveChildProcessCallee;
+exports.resolveInvokesTargets = resolveInvokesTargets;
+const posixPath = __importStar(require("path"));
+const tree_sitter_helpers_1 = require("./tree-sitter-helpers");
+const dynamic_import_1 = require("./dynamic-import");
+/**
+ * Sentinel `referenceName` for a `fork(...)` call whose module argument could
+ * NOT be statically folded. Mirrors `DYNAMIC_IMPORT_UNRESOLVED_MARKER`
+ * (dynamic-import.ts): illegal as both a JS identifier and a file path
+ * (angle brackets, colon), so it can never coincidentally name-match a real
+ * file, and is pushed as a normal unresolved reference so it surfaces as
+ * `status='failed'` rather than being silently dropped. `fork`'s target is
+ * ALWAYS a JS module (unlike `spawn`/`exec*`, whose target is usually an
+ * external binary) — so an unfoldable `fork` argument stays visible, while
+ * an unfoldable `spawn`/`execFile*` argument is a silent skip (see
+ * `resolveInvokesTargets`'s case (iv) — spawn's target domain is mostly
+ * external commands, so "couldn't fold" carries no useful signal there).
+ */
+exports.SPAWN_INVOKES_UNRESOLVED_MARKER = '<spawn:unresolved>';
+const CHILD_PROCESS_SPAWN_FNS = new Set(['spawn', 'spawnSync', 'execFile', 'execFileSync', 'fork']);
+function isChildProcessSpecifier(text) {
+    return text === 'child_process' || text === 'node:child_process';
+}
+const EMPTY_BINDINGS = { localFns: new Map(), namespaces: new Set() };
+/**
+ * Scan the file's top-level (Program direct-child) statements for bindings of
+ * `child_process`'s spawn family. Two binding shapes, per spec:
+ *   - static `import` — named (`import { spawnSync } from 'child_process'`,
+ *     alias-aware), or namespace (`import * as cp from 'node:child_process'`,
+ *     later matched via `cp.spawnSync(...)`).
+ *   - simple CommonJS destructure — `const { spawnSync } = require('node:child_process')`
+ *     (module-level only; `let`/`var` excluded like dynamic-import.ts's
+ *     module-level-const fold, since a reassignable binding's declaration-site
+ *     value isn't necessarily the call-site value).
+ * A default import isn't a meaningful binding shape for this module (no
+ * useful default export) and is intentionally not recognized.
+ */
+function collectChildProcessBindings(anyNodeInTree, source) {
+    const root = anyNodeInTree.tree.rootNode;
+    const localFns = new Map();
+    const namespaces = new Set();
+    for (let i = 0; i < root.namedChildCount; i++) {
+        let stmt = root.namedChild(i);
+        if (!stmt)
+            continue;
+        if (stmt.type === 'import_statement') {
+            const sourceField = (0, tree_sitter_helpers_1.getChildByField)(stmt, 'source');
+            const specifierText = sourceField ? (0, tree_sitter_helpers_1.getNodeText)(sourceField, source).replace(/['"]/g, '') : '';
+            if (!isChildProcessSpecifier(specifierText))
+                continue;
+            const clause = stmt.namedChildren.find((c) => c?.type === 'import_clause');
+            if (!clause)
+                continue;
+            for (const child of clause.namedChildren) {
+                if (!child)
+                    continue;
+                if (child.type === 'named_imports') {
+                    for (const spec of child.namedChildren) {
+                        if (!spec || spec.type !== 'import_specifier')
+                            continue;
+                        const nameNode = (0, tree_sitter_helpers_1.getChildByField)(spec, 'name');
+                        const aliasNode = (0, tree_sitter_helpers_1.getChildByField)(spec, 'alias');
+                        const imported = nameNode ? (0, tree_sitter_helpers_1.getNodeText)(nameNode, source) : '';
+                        if (!CHILD_PROCESS_SPAWN_FNS.has(imported))
+                            continue;
+                        const local = aliasNode ? (0, tree_sitter_helpers_1.getNodeText)(aliasNode, source) : imported;
+                        if (local)
+                            localFns.set(local, imported);
+                    }
+                }
+                else if (child.type === 'namespace_import') {
+                    const idNode = child.namedChildren.find((c) => c?.type === 'identifier') ?? child.namedChild(0);
+                    const local = idNode ? (0, tree_sitter_helpers_1.getNodeText)(idNode, source) : '';
+                    if (local)
+                        namespaces.add(local);
+                }
+            }
+            continue;
+        }
+        if (stmt.type === 'lexical_declaration') {
+            const kindNode = (0, tree_sitter_helpers_1.getChildByField)(stmt, 'kind');
+            if (kindNode?.type !== 'const')
+                continue;
+            for (let j = 0; j < stmt.namedChildCount; j++) {
+                const declarator = stmt.namedChild(j);
+                if (declarator?.type !== 'variable_declarator')
+                    continue;
+                const nameNode = (0, tree_sitter_helpers_1.getChildByField)(declarator, 'name');
+                const valueNode = (0, tree_sitter_helpers_1.getChildByField)(declarator, 'value');
+                if (!nameNode || nameNode.type !== 'object_pattern' || !valueNode)
+                    continue;
+                if (valueNode.type !== 'call_expression')
+                    continue;
+                const fn = (0, tree_sitter_helpers_1.getChildByField)(valueNode, 'function');
+                if (!fn || fn.type !== 'identifier' || (0, tree_sitter_helpers_1.getNodeText)(fn, source) !== 'require')
+                    continue;
+                const argsNode = (0, tree_sitter_helpers_1.getChildByField)(valueNode, 'arguments');
+                const args = argsNode ? argsNode.namedChildren.filter((n) => !!n) : [];
+                if (args.length !== 1 || args[0].type !== 'string')
+                    continue;
+                const fragment = args[0].namedChildren.find((c) => c?.type === 'string_fragment');
+                const specifierText = fragment ? (0, tree_sitter_helpers_1.getNodeText)(fragment, source) : '';
+                if (!isChildProcessSpecifier(specifierText))
+                    continue;
+                for (let k = 0; k < nameNode.namedChildCount; k++) {
+                    const prop = nameNode.namedChild(k);
+                    if (!prop)
+                        continue;
+                    let imported = '';
+                    let local = '';
+                    if (prop.type === 'shorthand_property_identifier_pattern') {
+                        imported = (0, tree_sitter_helpers_1.getNodeText)(prop, source);
+                        local = imported;
+                    }
+                    else if (prop.type === 'pair_pattern') {
+                        const keyNode = (0, tree_sitter_helpers_1.getChildByField)(prop, 'key');
+                        const valNode = (0, tree_sitter_helpers_1.getChildByField)(prop, 'value');
+                        imported = keyNode ? (0, tree_sitter_helpers_1.getNodeText)(keyNode, source) : '';
+                        local = valNode ? (0, tree_sitter_helpers_1.getNodeText)(valNode, source) : imported;
+                    }
+                    else {
+                        continue;
+                    }
+                    if (imported && local && CHILD_PROCESS_SPAWN_FNS.has(imported))
+                        localFns.set(local, imported);
+                }
+            }
+        }
+    }
+    return localFns.size === 0 && namespaces.size === 0 ? EMPTY_BINDINGS : { localFns, namespaces };
+}
+/**
+ * True when `node` is `process.execPath` (a `member_expression`, not folded
+ * by `foldConstantExpr` — its only member_expression shape is
+ * `import.meta.dirname`). Distinguishing this from a general expression fold
+ * is what lets `spawn(process.execPath, [...])` route into the array-element
+ * folding branch (case (ii) below) instead of failing to fold argv[0].
+ */
+function isProcessExecPath(node, source) {
+    if (node.type !== 'member_expression')
+        return false;
+    const object = (0, tree_sitter_helpers_1.getChildByField)(node, 'object');
+    const property = (0, tree_sitter_helpers_1.getChildByField)(node, 'property');
+    return (!!object &&
+        object.type === 'identifier' &&
+        (0, tree_sitter_helpers_1.getNodeText)(object, source) === 'process' &&
+        !!property &&
+        (0, tree_sitter_helpers_1.getNodeText)(property, source) === 'execPath');
+}
+/**
+ * Given a `call_expression` node, return the canonical `child_process`
+ * function name (`spawn`/`spawnSync`/`execFile`/`execFileSync`/`fork`) it
+ * invokes, or null when the callee isn't verified bound to one. Two callee
+ * shapes: a bare identifier bound via `localFns` (static named import or the
+ * `require` destructure), or a `<namespace>.<fn>` member access where
+ * `<namespace>` is a verified `import * as cp from 'child_process'` binding.
+ *
+ * `exec`/`execSync` are deliberately excluded — their single argument is a
+ * whole shell command line (`"git status && ls"`), which requires shell
+ * grammar parsing (quoting, pipes, `&&`, env vars) to extract a target file,
+ * not the argv-array shape this module folds. Out of scope for this fix.
+ */
+function resolveChildProcessCallee(node, source, bindings) {
+    if (node.type !== 'call_expression')
+        return null;
+    const fn = (0, tree_sitter_helpers_1.getChildByField)(node, 'function');
+    if (!fn)
+        return null;
+    if (fn.type === 'identifier') {
+        return bindings.localFns.get((0, tree_sitter_helpers_1.getNodeText)(fn, source)) ?? null;
+    }
+    if (fn.type === 'member_expression') {
+        const object = (0, tree_sitter_helpers_1.getChildByField)(fn, 'object');
+        const property = (0, tree_sitter_helpers_1.getChildByField)(fn, 'property');
+        if (!object || object.type !== 'identifier' || !property)
+            return null;
+        if (!bindings.namespaces.has((0, tree_sitter_helpers_1.getNodeText)(object, source)))
+            return null;
+        const propName = (0, tree_sitter_helpers_1.getNodeText)(property, source);
+        return CHILD_PROCESS_SPAWN_FNS.has(propName) ? propName : null;
+    }
+    return null;
+}
+/**
+ * Fold `node` to a constant string (`foldConstantExpr`), then — ONLY when the
+ * result is a `./`/`../`-relative specifier — rewrite it into the same
+ * project-relative, extension-included path space the resolver's exact-match
+ * expects (import-resolver.ts's `invokes` branch does plain path equality,
+ * no module resolution). A `join(ROOT, ...)`/`resolve(...)`-folded result is
+ * already project-relative (dynamic-import.ts's `foldJoinResolve` produces
+ * that form) and passes through untouched; a bare command name (`'git'`) has
+ * no `./`/`../` prefix and also passes through untouched — the resolver's
+ * exact match on a real file node is what turns "didn't fold to a real
+ * file" into "no edge", not this function. A relative specifier that
+ * resolves outside the project root is a fold failure (can't represent
+ * "outside the project" as a project-relative path) — mirrors
+ * `foldJoinResolve`'s same rule for `join`/`resolve` arithmetic.
+ */
+function foldToProjectPath(node, source, filePath) {
+    const folded = (0, dynamic_import_1.foldConstantExpr)(node, source, filePath);
+    if (folded === null)
+        return null;
+    if (!folded.startsWith('./') && !folded.startsWith('../'))
+        return folded;
+    const dir = posixPath.posix.dirname(filePath.replace(/\\/g, '/'));
+    const base = dir === '.' ? '' : dir;
+    const joined = base ? `${base}/${folded}` : folded;
+    const normalized = posixPath.posix.normalize(joined);
+    if (normalized === '..' || normalized.startsWith('../'))
+        return null;
+    return normalized;
+}
+/**
+ * Fold `callNode`'s target argument(s) into zero or more `invokes` reference
+ * names, per `canonicalFn`:
+ *
+ *  - `fork(modulePath, args?, options?)`: fold `modulePath` (argv[0] only —
+ *    `fork`'s target is always a JS module, so it is ALWAYS pushed, using the
+ *    unresolved sentinel on a folding failure rather than staying silent).
+ *  - `spawn`/`spawnSync`/`execFile`/`execFileSync`(cmd, args?, options?):
+ *      (i)   `cmd` folds to a path — push it. The resolver's exact-file-path
+ *            match is the real filter: a project file resolves, an external
+ *            command (`git`) or arbitrary string simply never matches a file
+ *            node and silently stays unresolved (case iii from spec, "正しい
+ *            挙動" — no special-casing needed here).
+ *      (ii)  `cmd` is `process.execPath` (AST shape) or folds to the literal
+ *            string `'node'` — argv[0] is the current runtime, so the REAL
+ *            target is argv[1]'s array-literal elements. Each element is
+ *            folded independently; a `...spread` or an unfoldable element is
+ *            skipped WITHOUT abandoning the rest of the array.
+ *      (iv)  `cmd` doesn't fold at all — skip entirely (no ref pushed).
+ *            Unlike `fork`, spawn's target domain is mostly external
+ *            commands, so an unfoldable argv[0] carries no signal that
+ *            visibility would improve on.
+ */
+function resolveInvokesTargets(canonicalFn, callNode, source, filePath) {
+    const argsNode = (0, tree_sitter_helpers_1.getChildByField)(callNode, 'arguments');
+    if (!argsNode)
+        return [];
+    const args = argsNode.namedChildren.filter((n) => !!n);
+    if (args.length < 1)
+        return [];
+    if (canonicalFn === 'fork') {
+        const folded = foldToProjectPath(args[0], source, filePath);
+        return [{ referenceName: folded ?? exports.SPAWN_INVOKES_UNRESOLVED_MARKER }];
+    }
+    const first = args[0];
+    const foldedFirst = isProcessExecPath(first, source) ? null : foldToProjectPath(first, source, filePath);
+    const isNodeSelfInvocation = isProcessExecPath(first, source) || foldedFirst === 'node';
+    if (isNodeSelfInvocation) {
+        const second = args[1];
+        if (!second || second.type !== 'array')
+            return [];
+        const targets = [];
+        for (const el of second.namedChildren) {
+            if (!el || el.type === 'spread_element')
+                continue; // 個別スキップ、配列全体は諦めない
+            const foldedEl = foldToProjectPath(el, source, filePath);
+            if (foldedEl !== null)
+                targets.push({ referenceName: foldedEl });
+        }
+        return targets;
+    }
+    if (foldedFirst === null)
+        return []; // case (iv): unfoldable argv[0] — skip, no ref
+    return [{ referenceName: foldedFirst }]; // case (i)/(iii): let the resolver's exact-match decide
+}
+//# sourceMappingURL=spawn-invokes.js.map

package/sensor/dist/extraction/spawn-invokes.js.map

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

package/sensor/dist/extraction/store-worker.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Store worker — dedicated writer thread for the bulk-index store phase.
+ *
+ * During a fresh full index the main thread's biggest serial cost is executing
+ * the per-file INSERT batches. This worker owns that work on its own SQLite
+ * connection: the orchestrator posts one message per file (in file order) and
+ * the worker applies them in arrival order, which preserves the #1015
+ * insertion-order determinism exactly as if the main thread had run the same
+ * calls. The main thread performs NO database access while the writer is
+ * active (fresh-DB path only), so there is no cross-connection contention.
+ *
+ * Protocol (main → worker):
+ *   {type:'open', dbPath, fastInit}  → open connection, reply {type:'ready'}
+ *   {type:'bundle', bundle}          → apply one file's store bundle
+ *   {type:'drain', id}               → reply {type:'drained', id} (in-order ⇒ all prior bundles applied)
+ *   {type:'close'}                   → close DB and exit
+ * Worker → main: {type:'ready'} | {type:'drained', id} | {type:'error', message}
+ *
+ * A bundle failure does not kill the worker; the first error is reported and
+ * the client surfaces it at drain(), matching the main-thread path where a
+ * store exception propagates out of the ordered-flush chain.
+ */
+export {};
+//# sourceMappingURL=store-worker.d.ts.map

package/sensor/dist/extraction/store-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-worker.d.ts","sourceRoot":"","sources":["../../src/extraction/store-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG"}

package/sensor/dist/extraction/store-worker.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * Store worker — dedicated writer thread for the bulk-index store phase.
+ *
+ * During a fresh full index the main thread's biggest serial cost is executing
+ * the per-file INSERT batches. This worker owns that work on its own SQLite
+ * connection: the orchestrator posts one message per file (in file order) and
+ * the worker applies them in arrival order, which preserves the #1015
+ * insertion-order determinism exactly as if the main thread had run the same
+ * calls. The main thread performs NO database access while the writer is
+ * active (fresh-DB path only), so there is no cross-connection contention.
+ *
+ * Protocol (main → worker):
+ *   {type:'open', dbPath, fastInit}  → open connection, reply {type:'ready'}
+ *   {type:'bundle', bundle}          → apply one file's store bundle
+ *   {type:'drain', id}               → reply {type:'drained', id} (in-order ⇒ all prior bundles applied)
+ *   {type:'close'}                   → close DB and exit
+ * Worker → main: {type:'ready'} | {type:'drained', id} | {type:'error', message}
+ *
+ * A bundle failure does not kill the worker; the first error is reported and
+ * the client surfaces it at drain(), matching the main-thread path where a
+ * store exception propagates out of the ordered-flush chain.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+// Compile cache FIRST — same worker-boot rationale as parse-worker.ts.
+try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    require('node:module').enableCompileCache?.();
+}
+catch { /* cache is best-effort */ }
+const worker_threads_1 = require("worker_threads");
+const queries_1 = require("../db/queries");
+const sqlite_adapter_1 = require("../db/sqlite-adapter");
+const store_writer_1 = require("./store-writer");
+const decode_1 = require("./kernel/decode");
+if (!worker_threads_1.parentPort) {
+    throw new Error('store-worker must be run as a worker thread');
+}
+const port = worker_threads_1.parentPort;
+let db = null;
+let queries = null;
+/** Decode a kernel bundle's buffers into the standard pre-filtered StoreBundle. */
+function decodeKernelBundle(bundle) {
+    const asBuf = (u) => Buffer.from(u.buffer, u.byteOffset, u.byteLength);
+    const decoded = (0, decode_1.decodeExtractBuffers)({
+        meta: asBuf(bundle.buffers.meta),
+        nodes: asBuf(bundle.buffers.nodes),
+        edges: asBuf(bundle.buffers.edges),
+        refs: asBuf(bundle.buffers.refs),
+        arena: asBuf(bundle.buffers.arena),
+    }, bundle.filePath, bundle.language);
+    return (0, store_writer_1.finalizeStoreBundle)(decoded, bundle.filePath, bundle.language, bundle.file);
+}
+port.on('message', (msg) => {
+    try {
+        switch (msg.type) {
+            case 'open': {
+                const created = (0, sqlite_adapter_1.createDatabase)(msg.dbPath);
+                db = created.db;
+                // Mirrors db/index.ts configureConnection, with the same fast-init
+                // durability trade the main connection applies for fresh builds.
+                db.pragma('busy_timeout = 5000');
+                db.pragma('foreign_keys = ON');
+                if (msg.fastInit) {
+                    db.pragma('journal_mode = MEMORY');
+                    db.pragma('synchronous = OFF');
+                }
+                else {
+                    db.pragma('synchronous = NORMAL');
+                }
+                db.pragma('cache_size = -64000');
+                db.pragma('temp_store = MEMORY');
+                queries = new queries_1.QueryBuilder(db);
+                port.postMessage({ type: 'ready' });
+                break;
+            }
+            case 'bundle': {
+                if (!queries)
+                    throw new Error('store-worker: bundle before open');
+                const bundle = 'kernel' in msg.bundle ? decodeKernelBundle(msg.bundle) : msg.bundle;
+                queries.storeFileBundle(bundle);
+                port.postMessage({ type: 'ack' });
+                break;
+            }
+            case 'drain': {
+                port.postMessage({ type: 'drained', id: msg.id });
+                break;
+            }
+            case 'close': {
+                try {
+                    db?.close();
+                }
+                catch {
+                    /* already closed */
+                }
+                process.exit(0);
+                break;
+            }
+        }
+    }
+    catch (err) {
+        // The error reply doubles as the bundle's ack so the client's outstanding
+        // counter still drains after a failure.
+        port.postMessage({
+            type: 'error',
+            message: err instanceof Error ? err.message : String(err),
+        });
+    }
+});
+//# sourceMappingURL=store-worker.js.map

package/sensor/dist/extraction/store-worker.js.map

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

package/sensor/dist/extraction/store-writer.d.ts

@@ -0,0 +1,63 @@
+/**
+ * StoreWriter — main-thread client for the store worker (see store-worker.ts).
+ *
+ * Used ONLY on the fresh-DB bulk path: bundles are posted in file order and the
+ * worker applies them in arrival order, so rowid assignment (and therefore
+ * resolution's insertion-order disambiguation) is byte-identical to the
+ * main-thread store. Kill switch: CODEGRAPH_NO_STORE_WORKER=1.
+ */
+import { ExtractionResult, Language, Node, Edge, UnresolvedReference, FileRecord } from '../types';
+/** One file's complete store payload (pre-filtered — see storeFileBundle). */
+export interface StoreBundle {
+    nodes: Node[];
+    edges: Edge[];
+    refs: UnresolvedReference[];
+    file: FileRecord;
+}
+/**
+ * A kernel deferred-decode payload: the file's raw table buffers plus the
+ * FileRecord the main thread built from meta counts. The store WORKER decodes
+ * and finalizes (same filters as the object path), so per-node objects never
+ * exist on the main thread.
+ */
+export interface KernelStoreBundle {
+    kernel: true;
+    filePath: string;
+    language: Language;
+    buffers: NonNullable<ExtractionResult['kernelBuffers']>;
+    file: FileRecord;
+}
+/**
+ * The validation/denormalization every bundle gets before storeFileBundle —
+ * shared by the orchestrator's object path and the store worker's kernel
+ * decode path so the two can never drift:
+ *   - nodes missing identity fields are dropped (#42-class safety),
+ *   - edges must connect inserted nodes (FK integrity),
+ *   - refs must originate from inserted nodes and carry the denormalized
+ *     filePath/language the resolver reads.
+ */
+export declare function finalizeStoreBundle(result: Pick<ExtractionResult, 'nodes' | 'edges' | 'unresolvedReferences'>, filePath: string, language: Language, file: FileRecord): StoreBundle;
+export declare class StoreWriter {
+    private worker;
+    private readyPromise;
+    private firstError;
+    private drainWaiters;
+    private nextDrainId;
+    private exited;
+    /** Bundles posted but not yet acked — the queue-depth backpressure signal. */
+    private outstanding;
+    private belowWaiters;
+    constructor(workerScriptPath: string, dbPath: string, fastInit: boolean);
+    private failAll;
+    private settleOne;
+    ready(): Promise<void>;
+    /** Post one file's bundle. Throws immediately if the writer already failed. */
+    send(bundle: StoreBundle | KernelStoreBundle): void;
+    /** Backpressure: resolves once fewer than `limit` bundles are un-acked. */
+    waitBelow(limit: number): Promise<void>;
+    /** Resolves when every bundle posted before this call has been applied. */
+    drain(): Promise<void>;
+    /** Close the worker's DB connection and join the thread. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=store-writer.d.ts.map

package/sensor/dist/extraction/store-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-writer.d.ts","sourceRoot":"","sources":["../../src/extraction/store-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEnG,8EAA8E;AAC9E,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,IAAI,EAAE,mBAAmB,EAAE,CAAC;IAC5B,IAAI,EAAE,UAAU,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,IAAI,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,WAAW,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC,CAAC;IACxD,IAAI,EAAE,UAAU,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,OAAO,GAAG,sBAAsB,CAAC,EAC1E,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,UAAU,GACf,WAAW,CAcb;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,YAAY,CAA0E;IAC9F,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,8EAA8E;IAC9E,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,YAAY,CAAqD;gBAE7D,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO;IA+CvE,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,SAAS;IAWjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,+EAA+E;IAC/E,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,GAAG,IAAI;IAOnD,2EAA2E;IAC3E,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvC,2EAA2E;IAC3E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtB,4DAA4D;IACtD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAa7B"}