@monoes/monograph 1.1.0 → 1.2.0

package/dist/src/pipeline/phases/tools.js

@@ -0,0 +1,132 @@
+import { readFileSync, statSync } from 'fs';
+import { extname } from 'path';
+import { makeId, toNormLabel } from '../../types.js';
+import { insertNodes } from '../../storage/node-store.js';
+import { insertEdges } from '../../storage/edge-store.js';
+// ── Constants ─────────────────────────────────────────────────────────────────
+const CODE_EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs']);
+// ── Detection regexes ─────────────────────────────────────────────────────────
+/** server.tool('name', ...) or server.tool("name", ...) */
+const SERVER_TOOL_RE = /server\.tool\(\s*['"]([^'"]+)['"]/g;
+/** export const FOO_TOOL = { name: 'foo', description: '...' } */
+const EXPORTED_TOOL_CONST_RE = /export\s+const\s+\w+[Tt][Oo][Oo][Ll]\w*\s*=\s*\{[^}]*name:\s*['"]([^'"]+)['"]/g;
+/** Array variable name pattern: TOOLS, tools, MY_TOOLS, toolsList, etc. (case-insensitive on 'tools') */
+const TOOLS_ARRAY_VAR_RE = /(?:export\s+)?(?:const|let|var)\s+(\w*[Tt][Oo][Oo][Ll][Ss]?\w*)\s*(?::\s*\w+\[\])?\s*=\s*\[/g;
+// ── Phase ─────────────────────────────────────────────────────────────────────
+export const toolsPhase = {
+    name: 'tools',
+    deps: ['parse', 'structure'],
+    async execute(ctx, deps) {
+        const { fileNodes } = deps.get('structure');
+        const toolDefs = [];
+        const toolNodes = [];
+        const handlesEdges = [];
+        for (const fileNode of fileNodes) {
+            const relPath = fileNode.filePath ?? '';
+            const ext = extname(relPath).toLowerCase();
+            if (!CODE_EXTENSIONS.has(ext))
+                continue;
+            const source = safeReadSource(`${ctx.repoPath}/${relPath}`, ctx.options.maxFileSizeBytes);
+            if (!source)
+                continue;
+            const detectedNames = new Set();
+            // ── 1. server.tool('name', ...) pattern ───────────────────────────────
+            const serverToolRe = new RegExp(SERVER_TOOL_RE.source, 'g');
+            let m;
+            while ((m = serverToolRe.exec(source)) !== null) {
+                detectedNames.add(m[1]);
+            }
+            // ── 2. Exported constant tool pattern ─────────────────────────────────
+            const exportedToolRe = new RegExp(EXPORTED_TOOL_CONST_RE.source, 'g');
+            while ((m = exportedToolRe.exec(source)) !== null) {
+                detectedNames.add(m[1]);
+            }
+            // ── 3. TOOLS array pattern ────────────────────────────────────────────
+            const toolsArrayRe = new RegExp(TOOLS_ARRAY_VAR_RE.source, 'g');
+            while ((m = toolsArrayRe.exec(source)) !== null) {
+                const arrayStart = m.index + m[0].length;
+                // Extract the array block (up to 4000 chars to avoid huge allocations)
+                const block = source.slice(arrayStart, arrayStart + 4000);
+                // Only match if array contains a description property (reduces false positives)
+                if (!block.includes('description'))
+                    continue;
+                // Find all name: 'foo' entries in the block
+                const nameRe = /name:\s*['"]([^'"]+)['"]/g;
+                let nm;
+                while ((nm = nameRe.exec(block)) !== null) {
+                    detectedNames.add(nm[1]);
+                }
+            }
+            // ── Create nodes & edges for each detected tool ───────────────────────
+            for (const toolName of detectedNames) {
+                const toolNodeId = makeId('tool', toolName, relPath);
+                const toolNode = {
+                    id: toolNodeId,
+                    label: 'Tool',
+                    name: toolName,
+                    normLabel: toNormLabel(toolName),
+                    filePath: relPath,
+                    startLine: 0,
+                    endLine: 0,
+                    isExported: true,
+                    language: langFromExt(ext),
+                };
+                toolNodes.push(toolNode);
+                const def = { name: toolName, filePath: relPath, toolNodeId };
+                // Attempt handler lookup in the DB
+                if (ctx.db) {
+                    const lowerTool = toolName.toLowerCase().replace(/[_-]/g, '');
+                    // Query Function/Method nodes in the same file
+                    const rows = ctx.db
+                        .prepare(`SELECT id, name FROM nodes
+               WHERE file_path = ?
+               AND label IN ('Function', 'Method')`)
+                        .all(relPath);
+                    // Find nodes whose name contains the tool name (case-insensitive, stripped)
+                    const matches = rows.filter(row => {
+                        const n = row.name.toLowerCase().replace(/[_-]/g, '');
+                        return n.includes(lowerTool) || (n.length > 0 && lowerTool.includes(n));
+                    });
+                    if (matches.length === 1) {
+                        const edgeId = makeId(toolNodeId, matches[0].id, 'handles_tool');
+                        handlesEdges.push({
+                            id: edgeId,
+                            sourceId: toolNodeId,
+                            targetId: matches[0].id,
+                            relation: 'HANDLES_TOOL',
+                            confidence: 'EXTRACTED',
+                            confidenceScore: 0.85,
+                        });
+                        def.handlerNodeId = matches[0].id;
+                    }
+                }
+                toolDefs.push(def);
+            }
+        }
+        if (ctx.db) {
+            insertNodes(ctx.db, toolNodes);
+            insertEdges(ctx.db, handlesEdges);
+        }
+        return { toolDefs };
+    },
+};
+// ── Utilities ─────────────────────────────────────────────────────────────────
+function safeReadSource(absPath, maxBytes) {
+    try {
+        const stat = statSync(absPath);
+        if (stat.size > maxBytes)
+            return undefined;
+        return readFileSync(absPath, 'utf-8');
+    }
+    catch {
+        return undefined;
+    }
+}
+function langFromExt(ext) {
+    if (ext === '.ts' || ext === '.tsx')
+        return 'typescript';
+    if (ext === '.js' || ext === '.jsx' || ext === '.mjs' || ext === '.cjs')
+        return 'javascript';
+    return 'unknown';
+}
+//# sourceMappingURL=tools.js.map

package/dist/src/pipeline/phases/tools.js.map

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

package/dist/src/pipeline/phases/variables-phase.d.ts

@@ -0,0 +1,6 @@
+import type { PipelinePhase } from '../types.js';
+export interface VariablesOutput {
+    variableCount: number;
+}
+export declare const variablesPhase: PipelinePhase<VariablesOutput>;
+//# sourceMappingURL=variables-phase.d.ts.map

package/dist/src/pipeline/phases/variables-phase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables-phase.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phases/variables-phase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,aAAa,CAAC;AAIlE,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,cAAc,EAAE,aAAa,CAAC,eAAe,CA2BzD,CAAC"}

package/dist/src/pipeline/phases/variables-phase.js

@@ -0,0 +1,23 @@
+import { extractVariables, variableToNode } from './variables.js';
+export const variablesPhase = {
+    name: 'variables',
+    deps: ['parse'],
+    async execute(ctx, deps) {
+        const { fileContents } = deps.get('parse');
+        const stmt = ctx.db.prepare(`
+      INSERT OR IGNORE INTO nodes (id, label, name, norm_label, file_path, start_line, end_line, is_exported)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        let variableCount = 0;
+        for (const [filePath, source] of fileContents) {
+            const vars = extractVariables(source, filePath);
+            for (const v of vars) {
+                const node = variableToNode(v);
+                stmt.run(node.id, node.label, node.name, node.normLabel ?? node.name.toLowerCase(), node.filePath ?? null, node.startLine ?? null, node.endLine ?? null, node.isExported ? 1 : 0);
+                variableCount++;
+            }
+        }
+        return { variableCount };
+    },
+};
+//# sourceMappingURL=variables-phase.js.map

package/dist/src/pipeline/phases/variables-phase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables-phase.js","sourceRoot":"","sources":["../../../../src/pipeline/phases/variables-phase.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMlE,MAAM,CAAC,MAAM,cAAc,GAAmC;IAC5D,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,CAAC,OAAO,CAAC;IACf,KAAK,CAAC,OAAO,CAAC,GAAoB,EAAE,IAA0B;QAC5D,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAgB,CAAC;QAE1D,MAAM,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC;;;KAG3B,CAAC,CAAC;QAEH,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;YAC9C,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAChD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;gBACrB,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;gBAC/B,IAAI,CAAC,GAAG,CACN,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EACzE,IAAI,CAAC,QAAQ,IAAI,IAAI,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI,EACnE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACxB,CAAC;gBACF,aAAa,EAAE,CAAC;YAClB,CAAC;QACH,CAAC;QAED,OAAO,EAAE,aAAa,EAAE,CAAC;IAC3B,CAAC;CACF,CAAC"}

package/dist/src/pipeline/phases/variables.d.ts

@@ -0,0 +1,10 @@
+import type { MonographNode } from '../../types.js';
+export interface VariableInfo {
+    name: string;
+    isExported: boolean;
+    line: number;
+    filePath: string;
+}
+export declare function extractVariables(source: string, filePath: string): VariableInfo[];
+export declare function variableToNode(v: VariableInfo): MonographNode;
+//# sourceMappingURL=variables.d.ts.map

package/dist/src/pipeline/phases/variables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phases/variables.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAqBD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CAyBjF;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,YAAY,GAAG,aAAa,CAW7D"}

package/dist/src/pipeline/phases/variables.js

@@ -0,0 +1,55 @@
+// Regex for top-level variable declarations.
+// We detect nesting depth by counting braces before the match.
+const TOP_LEVEL_VAR = /^(export\s+)?(const|let|var)\s+(\w+)\s*[=:]/gm;
+/**
+ * Strip string literals, template literals, and comments from source text before
+ * brace-depth counting, so braces inside those constructs don't skew the depth.
+ */
+function stripNonCodeBraces(src) {
+    // Replace content inside single/double-quoted strings and block comments with
+    // equal-length spaces (preserving offsets/line numbers), then strip line comments.
+    return src
+        .replace(/`[^`\\]*(?:\\[\s\S][^`\\]*)*`/g, m => ' '.repeat(m.length))
+        .replace(/"(?:[^"\\]|\\.)*"/g, m => ' '.repeat(m.length))
+        .replace(/'(?:[^'\\]|\\.)*'/g, m => ' '.repeat(m.length))
+        .replace(/\/\*[\s\S]*?\*\//g, m => ' '.repeat(m.length))
+        .replace(/\/\/[^\n]*/g, m => ' '.repeat(m.length));
+}
+export function extractVariables(source, filePath) {
+    const results = [];
+    let match;
+    TOP_LEVEL_VAR.lastIndex = 0;
+    // Pre-process: strip string/comment content so braces inside them don't count
+    const stripped = stripNonCodeBraces(source);
+    while ((match = TOP_LEVEL_VAR.exec(source)) !== null) {
+        const before = stripped.slice(0, match.index);
+        // Count brace depth — top-level means depth == 0
+        let depth = 0;
+        for (const ch of before) {
+            if (ch === '{')
+                depth++;
+            else if (ch === '}')
+                depth--;
+        }
+        if (depth !== 0)
+            continue;
+        const isExported = !!match[1];
+        const name = match[3];
+        const line = before.split('\n').length;
+        results.push({ name, isExported, line, filePath });
+    }
+    return results;
+}
+export function variableToNode(v) {
+    return {
+        id: `var:${v.filePath}:${v.name}`,
+        label: 'Variable',
+        name: v.name,
+        normLabel: v.name.toLowerCase(),
+        filePath: v.filePath,
+        startLine: v.line,
+        endLine: v.line,
+        isExported: v.isExported,
+    };
+}
+//# sourceMappingURL=variables.js.map

package/dist/src/pipeline/phases/variables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables.js","sourceRoot":"","sources":["../../../../src/pipeline/phases/variables.ts"],"names":[],"mappings":"AASA,6CAA6C;AAC7C,+DAA+D;AAC/D,MAAM,aAAa,GAAG,+CAA+C,CAAC;AAEtE;;;GAGG;AACH,SAAS,kBAAkB,CAAC,GAAW;IACrC,8EAA8E;IAC9E,mFAAmF;IACnF,OAAO,GAAG;SACP,OAAO,CAAC,gCAAgC,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;SACpE,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;SACxD,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;SACxD,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;SACvD,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,QAAgB;IAC/D,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,IAAI,KAA6B,CAAC;IAClC,aAAa,CAAC,SAAS,GAAG,CAAC,CAAC;IAE5B,8EAA8E;IAC9E,MAAM,QAAQ,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE5C,OAAO,CAAC,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACrD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9C,iDAAiD;QACjD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;YACxB,IAAI,EAAE,KAAK,GAAG;gBAAE,KAAK,EAAE,CAAC;iBACnB,IAAI,EAAE,KAAK,GAAG;gBAAE,KAAK,EAAE,CAAC;QAC/B,CAAC;QACD,IAAI,KAAK,KAAK,CAAC;YAAE,SAAS;QAE1B,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,CAAe;IAC5C,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE;QACjC,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE;QAC/B,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,SAAS,EAAE,CAAC,CAAC,IAAI;QACjB,OAAO,EAAE,CAAC,CAAC,IAAI;QACf,UAAU,EAAE,CAAC,CAAC,UAAU;KACzB,CAAC;AACJ,CAAC"}

package/dist/src/pipeline/phases/wildcard-phase.d.ts

@@ -0,0 +1,6 @@
+import type { PipelinePhase } from '../types.js';
+export interface WildcardSynthesisOutput {
+    synthesizedCount: number;
+}
+export declare const wildcardSynthesisPhase: PipelinePhase<WildcardSynthesisOutput>;
+//# sourceMappingURL=wildcard-phase.d.ts.map

package/dist/src/pipeline/phases/wildcard-phase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wildcard-phase.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phases/wildcard-phase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,aAAa,CAAC;AAMlE,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,sBAAsB,EAAE,aAAa,CAAC,uBAAuB,CAkCzE,CAAC"}

package/dist/src/pipeline/phases/wildcard-phase.js

@@ -0,0 +1,31 @@
+import { synthesizeWildcardImports } from './wildcard-synthesis.js';
+export const wildcardSynthesisPhase = {
+    name: 'wildcard-synthesis',
+    deps: ['parse', 'cross-file'],
+    async execute(ctx, deps) {
+        const { symbolNodes: allNodes, allEdges, fileContents } = deps.get('parse');
+        const { resolvedEdges } = deps.get('cross-file');
+        const allKnownEdges = [...allEdges, ...resolvedEdges];
+        const allKnownNodes = allNodes;
+        let synthesizedCount = 0;
+        const fileNodeIndex = new Map();
+        for (const node of allKnownNodes) {
+            if (node.filePath)
+                fileNodeIndex.set(node.filePath, node.id);
+        }
+        const stmt = ctx.db.prepare(`
+      INSERT OR IGNORE INTO edges (id, source_id, target_id, relation, confidence, confidence_score)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `);
+        for (const [filePath, source] of fileContents) {
+            const fileNodeId = fileNodeIndex.get(filePath) ?? `file:${filePath}`;
+            const { synthesizedEdges } = synthesizeWildcardImports(fileNodeId, source, allKnownNodes, allKnownEdges);
+            for (const edge of synthesizedEdges) {
+                stmt.run(edge.id, edge.sourceId, edge.targetId, edge.relation, edge.confidence, edge.confidenceScore);
+                synthesizedCount++;
+            }
+        }
+        return { synthesizedCount };
+    },
+};
+//# sourceMappingURL=wildcard-phase.js.map

package/dist/src/pipeline/phases/wildcard-phase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wildcard-phase.js","sourceRoot":"","sources":["../../../../src/pipeline/phases/wildcard-phase.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAOpE,MAAM,CAAC,MAAM,sBAAsB,GAA2C;IAC5E,IAAI,EAAE,oBAAoB;IAC1B,IAAI,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC;IAC7B,KAAK,CAAC,OAAO,CAAC,GAAoB,EAAE,IAA0B;QAC5D,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAgB,CAAC;QAC3F,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAoB,CAAC;QAEpE,MAAM,aAAa,GAAoB,CAAC,GAAG,QAAQ,EAAE,GAAG,aAAa,CAAC,CAAC;QACvE,MAAM,aAAa,GAAoB,QAAQ,CAAC;QAEhD,IAAI,gBAAgB,GAAG,CAAC,CAAC;QAEzB,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;QAChD,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,QAAQ;gBAAE,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC;;;KAG3B,CAAC,CAAC;QAEH,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;YAC9C,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,QAAQ,QAAQ,EAAE,CAAC;YACrE,MAAM,EAAE,gBAAgB,EAAE,GAAG,yBAAyB,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;YAEzG,KAAK,MAAM,IAAI,IAAI,gBAAgB,EAAE,CAAC;gBACpC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;gBACtG,gBAAgB,EAAE,CAAC;YACrB,CAAC;QACH,CAAC;QAED,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC9B,CAAC;CACF,CAAC"}

package/dist/src/pipeline/phases/wildcard-synthesis.d.ts

@@ -0,0 +1,47 @@
+import type { MonographNode, MonographEdge } from '../../types.js';
+export interface WildcardBinding {
+    /** The namespace alias, e.g. `X` in `import * as X from './module'` */
+    alias: string;
+    /** The module specifier, e.g. `./module` */
+    moduleSpecifier: string;
+}
+export interface WildcardMemberAccess {
+    alias: string;
+    member: string;
+    line: number;
+}
+export interface WildcardSynthesisResult {
+    /** New edges synthesized from wildcard member accesses */
+    synthesizedEdges: MonographEdge[];
+}
+/**
+ * Extracts all wildcard import bindings from a TypeScript/JavaScript source file.
+ *
+ * @param source - Raw source code content
+ * @returns Array of wildcard bindings found in the source
+ */
+export declare function extractWildcardBindings(source: string): WildcardBinding[];
+/**
+ * Extracts all member accesses for a given namespace alias from source code.
+ * e.g. for alias `ns`, detects `ns.foo`, `ns.bar`, etc.
+ *
+ * @param source - Raw source code content
+ * @param alias - The namespace alias to scan for
+ * @returns Array of member accesses with line numbers
+ */
+export declare function extractWildcardMemberAccesses(source: string, alias: string): WildcardMemberAccess[];
+/**
+ * Synthesizes direct symbol edges from wildcard namespace member accesses.
+ *
+ * Given source code that has `import * as X from './module'` and uses `X.foo`,
+ * this function creates IMPORTS edges from the source file node to the `foo`
+ * export node in `./module`.
+ *
+ * @param sourceFileId - The node ID of the file containing the wildcard import
+ * @param source - Raw source code of the file
+ * @param nodes - All known nodes in the graph
+ * @param edges - All known edges (used to avoid duplicates)
+ * @returns Synthesized edges that directly link callers to target exports
+ */
+export declare function synthesizeWildcardImports(sourceFileId: string, source: string, nodes: MonographNode[], edges: MonographEdge[]): WildcardSynthesisResult;
+//# sourceMappingURL=wildcard-synthesis.d.ts.map

package/dist/src/pipeline/phases/wildcard-synthesis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wildcard-synthesis.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phases/wildcard-synthesis.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAKnE,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,0DAA0D;IAC1D,gBAAgB,EAAE,aAAa,EAAE,CAAC;CACnC;AASD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE,CAUzE;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,oBAAoB,EAAE,CAoBxB;AAqCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,aAAa,EAAE,EACtB,KAAK,EAAE,aAAa,EAAE,GACrB,uBAAuB,CA8EzB"}

package/dist/src/pipeline/phases/wildcard-synthesis.js

@@ -0,0 +1,158 @@
+import { dirname, resolve, basename } from 'path';
+import { makeId, CONFIDENCE_SCORE } from '../../types.js';
+// ── Regex patterns ────────────────────────────────────────────────────────────
+/** Matches: import * as X from './path' or import * as X from "../path" */
+const WILDCARD_IMPORT_RE = /import\s+\*\s+as\s+(\w+)\s+from\s+['"]([^'"]+)['"]/g;
+// ── Core functions ────────────────────────────────────────────────────────────
+/**
+ * Extracts all wildcard import bindings from a TypeScript/JavaScript source file.
+ *
+ * @param source - Raw source code content
+ * @returns Array of wildcard bindings found in the source
+ */
+export function extractWildcardBindings(source) {
+    const results = [];
+    WILDCARD_IMPORT_RE.lastIndex = 0;
+    let match;
+    while ((match = WILDCARD_IMPORT_RE.exec(source)) !== null) {
+        results.push({ alias: match[1], moduleSpecifier: match[2] });
+    }
+    return results;
+}
+/**
+ * Extracts all member accesses for a given namespace alias from source code.
+ * e.g. for alias `ns`, detects `ns.foo`, `ns.bar`, etc.
+ *
+ * @param source - Raw source code content
+ * @param alias - The namespace alias to scan for
+ * @returns Array of member accesses with line numbers
+ */
+export function extractWildcardMemberAccesses(source, alias) {
+    const results = [];
+    const memberRe = new RegExp(`\\b${alias}\\.(\\w+)`, 'g');
+    const lines = source.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        memberRe.lastIndex = 0;
+        let m;
+        const seen = new Set();
+        while ((m = memberRe.exec(line)) !== null) {
+            const member = m[1];
+            if (!seen.has(member)) {
+                seen.add(member);
+                results.push({ alias, member, line: i + 1 });
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Resolve a relative module specifier to an absolute file path (without extension).
+ * Returns null when `sourceFilePath` is unavailable or the specifier is non-relative.
+ */
+function resolveSpecifierPath(sourceFilePath, moduleSpecifier) {
+    if (!sourceFilePath)
+        return null;
+    if (!moduleSpecifier.startsWith('.'))
+        return null;
+    const dir = dirname(sourceFilePath);
+    const resolved = resolve(dir, moduleSpecifier);
+    // Strip extension so we can match .ts, .js, .tsx, .mjs, etc.
+    return resolved.replace(/\.[^./\\]+$/, '');
+}
+/**
+ * Return true when a candidate file path matches the resolved specifier path.
+ *
+ * Handles:
+ * - Exact basename-without-extension match (resolvedPath is a bare module path)
+ * - Index file: `resolvedPath/index` matches `candidatePath` ending in `/index.<ext>`
+ */
+function specifierMatchesFilePath(resolvedPath, candidateFilePath) {
+    // Strip extension from candidate for comparison
+    const candidateBase = candidateFilePath.replace(/\.[^./\\]+$/, '');
+    if (candidateBase === resolvedPath)
+        return true;
+    // Handle implicit /index
+    if (candidateBase === resolvedPath + '/index')
+        return true;
+    return false;
+}
+/**
+ * Synthesizes direct symbol edges from wildcard namespace member accesses.
+ *
+ * Given source code that has `import * as X from './module'` and uses `X.foo`,
+ * this function creates IMPORTS edges from the source file node to the `foo`
+ * export node in `./module`.
+ *
+ * @param sourceFileId - The node ID of the file containing the wildcard import
+ * @param source - Raw source code of the file
+ * @param nodes - All known nodes in the graph
+ * @param edges - All known edges (used to avoid duplicates)
+ * @returns Synthesized edges that directly link callers to target exports
+ */
+export function synthesizeWildcardImports(sourceFileId, source, nodes, edges) {
+    const bindings = extractWildcardBindings(source);
+    if (bindings.length === 0)
+        return { synthesizedEdges: [] };
+    // Build an index of existing edge IDs to avoid duplicates
+    const existingEdgeIds = new Set(edges.map(e => e.id));
+    // Build id→node map for path-based filtering and name→nodes index
+    const nodeById = new Map(nodes.map(n => [n.id, n]));
+    const sourceNode = nodeById.get(sourceFileId);
+    // Build a name→node[] index restricted to exported nodes
+    const nameIndex = new Map();
+    for (const node of nodes) {
+        if (!node.isExported)
+            continue;
+        const existing = nameIndex.get(node.name) ?? [];
+        existing.push(node);
+        nameIndex.set(node.name, existing);
+        // Also index by normLabel if different
+        if (node.normLabel && node.normLabel !== node.name) {
+            const byNorm = nameIndex.get(node.normLabel) ?? [];
+            byNorm.push(node);
+            nameIndex.set(node.normLabel, byNorm);
+        }
+    }
+    const synthesizedEdges = [];
+    for (const binding of bindings) {
+        // Resolve the module specifier to an absolute path (extension-stripped)
+        const resolvedPath = resolveSpecifierPath(sourceNode?.filePath, binding.moduleSpecifier);
+        // Basename of the specifier for fallback matching
+        const specBase = basename(binding.moduleSpecifier).replace(/\.[^.]+$/, '').toLowerCase();
+        const accesses = extractWildcardMemberAccesses(source, binding.alias);
+        for (const access of accesses) {
+            const candidateNodes = nameIndex.get(access.member) ?? nameIndex.get(access.member.toLowerCase()) ?? [];
+            // Filter candidates to only those belonging to the target module
+            let filtered;
+            if (resolvedPath !== null) {
+                // Strong filter: match by resolved absolute path
+                filtered = candidateNodes.filter(n => n.filePath != null && specifierMatchesFilePath(resolvedPath, n.filePath));
+            }
+            else {
+                // Fallback: match by basename (mirrors cross-file.ts resolution)
+                filtered = candidateNodes.filter(n => n.filePath != null &&
+                    basename(n.filePath).replace(/\.[^.]+$/, '').toLowerCase() === specBase);
+            }
+            // If still no match with basename fallback, skip — no cross-module edge
+            if (filtered.length === 0)
+                continue;
+            for (const target of filtered) {
+                const edgeId = makeId(sourceFileId, target.id, 'wildcard', access.member);
+                if (existingEdgeIds.has(edgeId))
+                    continue;
+                synthesizedEdges.push({
+                    id: edgeId,
+                    sourceId: sourceFileId,
+                    targetId: target.id,
+                    relation: 'IMPORTS',
+                    confidence: 'INFERRED',
+                    confidenceScore: CONFIDENCE_SCORE.INFERRED,
+                });
+                existingEdgeIds.add(edgeId);
+            }
+        }
+    }
+    return { synthesizedEdges };
+}
+//# sourceMappingURL=wildcard-synthesis.js.map

package/dist/src/pipeline/phases/wildcard-synthesis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wildcard-synthesis.js","sourceRoot":"","sources":["../../../../src/pipeline/phases/wildcard-synthesis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAElD,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAsB1D,iFAAiF;AAEjF,2EAA2E;AAC3E,MAAM,kBAAkB,GAAG,qDAAqD,CAAC;AAEjF,iFAAiF;AAEjF;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAc;IACpD,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,kBAAkB,CAAC,SAAS,GAAG,CAAC,CAAC;IAEjC,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,6BAA6B,CAC3C,MAAc,EACd,KAAa;IAEb,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,GAAG,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC;QACvB,IAAI,CAAyB,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,OAAO,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACjB,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAC3B,cAAyC,EACzC,eAAuB;IAEvB,IAAI,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,MAAM,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAC/C,6DAA6D;IAC7D,OAAO,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,SAAS,wBAAwB,CAC/B,YAAoB,EACpB,iBAAyB;IAEzB,gDAAgD;IAChD,MAAM,aAAa,GAAG,iBAAiB,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IACnE,IAAI,aAAa,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC;IAChD,yBAAyB;IACzB,IAAI,aAAa,KAAK,YAAY,GAAG,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3D,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,yBAAyB,CACvC,YAAoB,EACpB,MAAc,EACd,KAAsB,EACtB,KAAsB;IAEtB,MAAM,QAAQ,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACjD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,gBAAgB,EAAE,EAAE,EAAE,CAAC;IAE3D,0DAA0D;IAC1D,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEtD,kEAAkE;IAClE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAwB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3E,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAE9C,yDAAyD;IACzD,MAAM,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;IACrD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,SAAS;QAC/B,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAChD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACnC,uCAAuC;QACvC,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YACnD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACnD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClB,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,MAAM,gBAAgB,GAAoB,EAAE,CAAC;IAE7C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,wEAAwE;QACxE,MAAM,YAAY,GAAG,oBAAoB,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;QAEzF,kDAAkD;QAClD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QAEzF,MAAM,QAAQ,GAAG,6BAA6B,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAEtE,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;YAC9B,MAAM,cAAc,GAClB,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;YAEnF,iEAAiE;YACjE,IAAI,QAAyB,CAAC;YAC9B,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;gBAC1B,iDAAiD;gBACjD,QAAQ,GAAG,cAAc,CAAC,MAAM,CAC9B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,IAAI,IAAI,wBAAwB,CAAC,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,CAC9E,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,iEAAiE;gBACjE,QAAQ,GAAG,cAAc,CAAC,MAAM,CAC9B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,IAAI;oBACrB,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,QAAQ,CAC1E,CAAC;YACJ,CAAC;YAED,wEAAwE;YACxE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAEpC,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;gBAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC1E,IAAI,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC;oBAAE,SAAS;gBAE1C,gBAAgB,CAAC,IAAI,CAAC;oBACpB,EAAE,EAAE,MAAM;oBACV,QAAQ,EAAE,YAAY;oBACtB,QAAQ,EAAE,MAAM,CAAC,EAAE;oBACnB,QAAQ,EAAE,SAAS;oBACnB,UAAU,EAAE,UAAU;oBACtB,eAAe,EAAE,gBAAgB,CAAC,QAAQ;iBAC3C,CAAC,CAAC;gBAEH,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC9B,CAAC"}

package/dist/src/pipeline/progress.d.ts

@@ -0,0 +1,20 @@
+export type ProgressPhase = 'discovery' | 'parse' | 'churn' | 'complexity' | 'duplication' | 'scoring' | 'render' | 'complete';
+export interface ProgressEvent {
+    phase: ProgressPhase;
+    filesProcessed?: number;
+    totalFiles?: number;
+    message?: string;
+    elapsedMs?: number;
+}
+export type ProgressCallback = (event: ProgressEvent) => void;
+export declare class ProgressReporter {
+    private callbacks;
+    private startTime;
+    private counts;
+    subscribe(cb: ProgressCallback): () => void;
+    emit(phase: ProgressPhase, opts?: Omit<ProgressEvent, 'phase' | 'elapsedMs'>): void;
+    increment(phase: ProgressPhase): void;
+    getCount(phase: ProgressPhase): number;
+}
+export declare function consoleProgressReporter(enabled: boolean): ProgressCallback;
+//# sourceMappingURL=progress.d.ts.map

package/dist/src/pipeline/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../src/pipeline/progress.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GACrB,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,YAAY,GAC9C,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEtD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,aAAa,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAE9D,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,MAAM,CAAoC;IAElD,SAAS,CAAC,EAAE,EAAE,gBAAgB,GAAG,MAAM,IAAI;IAQ3C,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,WAAW,CAAC,GAAG,IAAI;IAWnF,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAIrC,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM;CAGvC;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAU1E"}

package/dist/src/pipeline/progress.js

@@ -0,0 +1,46 @@
+export class ProgressReporter {
+    callbacks = [];
+    startTime = Date.now();
+    counts = new Map();
+    subscribe(cb) {
+        this.callbacks.push(cb);
+        return () => {
+            const idx = this.callbacks.indexOf(cb);
+            if (idx !== -1)
+                this.callbacks.splice(idx, 1);
+        };
+    }
+    emit(phase, opts) {
+        const event = {
+            phase,
+            elapsedMs: Date.now() - this.startTime,
+            ...opts,
+        };
+        for (const cb of this.callbacks) {
+            try {
+                cb(event);
+            }
+            catch { /* don't let progress errors crash the pipeline */ }
+        }
+    }
+    increment(phase) {
+        this.counts.set(phase, (this.counts.get(phase) ?? 0) + 1);
+    }
+    getCount(phase) {
+        return this.counts.get(phase) ?? 0;
+    }
+}
+export function consoleProgressReporter(enabled) {
+    return (event) => {
+        if (!enabled)
+            return;
+        const pct = event.totalFiles && event.filesProcessed
+            ? ` (${Math.round(event.filesProcessed / event.totalFiles * 100)}%)`
+            : '';
+        const msg = event.message ?? `phase: ${event.phase}`;
+        process.stderr.write(`\r  ${msg}${pct}   `);
+        if (event.phase === 'complete')
+            process.stderr.write('\n');
+    };
+}
+//# sourceMappingURL=progress.js.map

package/dist/src/pipeline/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../../src/pipeline/progress.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,gBAAgB;IACnB,SAAS,GAAuB,EAAE,CAAC;IACnC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;IAElD,SAAS,CAAC,EAAoB;QAC5B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxB,OAAO,GAAG,EAAE;YACV,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACvC,IAAI,GAAG,KAAK,CAAC,CAAC;gBAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAChD,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAoB,EAAE,IAAiD;QAC1E,MAAM,KAAK,GAAkB;YAC3B,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS;YACtC,GAAG,IAAI;SACR,CAAC;QACF,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC;gBAAC,EAAE,CAAC,KAAK,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,kDAAkD,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAED,SAAS,CAAC,KAAoB;QAC5B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,QAAQ,CAAC,KAAoB;QAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;CACF;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO,CAAC,KAAK,EAAE,EAAE;QACf,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,cAAc;YAClD,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC,IAAI;YACpE,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,IAAI,UAAU,KAAK,CAAC,KAAK,EAAE,CAAC;QACrD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,GAAG,KAAK,CAAC,CAAC;QAC5C,IAAI,KAAK,CAAC,KAAK,KAAK,UAAU;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/pipeline/runner.d.ts

@@ -1,8 +1,17 @@
 import type { PipelinePhase, PipelineContext } from './types.js';
 export declare class PipelineRunner {
     private readonly phases;
-    private readonly order;
     constructor(phases: PipelinePhase<unknown>[]);
     run(ctx: PipelineContext): Promise<Map<string, unknown>>;
 }
+export interface IncrementalAstOptions {
+    /** If true, preserve INFERRED and AMBIGUOUS edges during code-only rebuild. Default true. */
+    preserveInferred?: boolean;
+}
+/**
+ * Incremental AST-only rebuild: clears EXTRACTED edges (re-parsed from code)
+ * while preserving INFERRED and AMBIGUOUS edges (derived by reasoning).
+ * Accepts a list of changed file paths; if empty, clears all EXTRACTED edges.
+ */
+export declare function runIncrementalAst(db: import('better-sqlite3').Database, changedFiles: string[], options?: IncrementalAstOptions): Promise<void>;
 //# sourceMappingURL=runner.d.ts.map

package/dist/src/pipeline/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/pipeline/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGjE,qBAAa,cAAc;IAGb,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;gBAEJ,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE;IAIvD,GAAG,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAa/D"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/pipeline/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGjE,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;gBAEtC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE;IAMtC,GAAG,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAyB/D;AAuCD,MAAM,WAAW,qBAAqB;IACpC,6FAA6F;IAC7F,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,OAAO,gBAAgB,EAAE,QAAQ,EACrC,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAoBf"}