@monoes/monograph 1.0.0 → 1.2.0

package/dist/src/pipeline/phases/pdf-parse.js

@@ -0,0 +1,119 @@
+import { readFileSync, statSync, readdirSync } from 'fs';
+import { extname, basename, join, relative } from 'path';
+import { makeId, toNormLabel, CONFIDENCE_SCORE } from '../../types.js';
+import { insertNodes } from '../../storage/node-store.js';
+import { insertEdges } from '../../storage/edge-store.js';
+const IGNORE_DIRS = new Set([
+    'node_modules', '.git', 'dist', 'build', '__pycache__',
+    '.cache', 'coverage', '.monomind', 'vendor', 'target',
+    '.worktrees',
+]);
+function walkPdfs(dir, repoPath, ignore) {
+    const extraIgnore = new Set(ignore);
+    const results = [];
+    function walk(d) {
+        let entries;
+        try {
+            entries = readdirSync(d);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (IGNORE_DIRS.has(entry) || extraIgnore.has(entry))
+                continue;
+            const full = join(d, entry);
+            let st;
+            try {
+                st = statSync(full);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory()) {
+                walk(full);
+                continue;
+            }
+            if (extname(entry).toLowerCase() === '.pdf')
+                results.push(full);
+        }
+    }
+    walk(dir);
+    return results;
+}
+export const pdfParsePhase = {
+    name: 'pdf-parse',
+    deps: ['structure'],
+    async execute(ctx) {
+        if (ctx.options.codeOnly)
+            return { sectionNodes: [], pdfFiles: 0 };
+        // Dynamically load pdf-parse — skip silently if not installed.
+        // Use Function() to prevent TypeScript from resolving the optional module at build time.
+        let extractText = null;
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const mod = await new Function('return import("pdf-parse")')();
+            const fn = mod.default ?? mod;
+            extractText = async (buf) => (await fn(buf)).text;
+        }
+        catch {
+            return { sectionNodes: [], pdfFiles: 0 };
+        }
+        const pdfPaths = walkPdfs(ctx.repoPath, ctx.repoPath, ctx.options.ignore);
+        if (pdfPaths.length === 0)
+            return { sectionNodes: [], pdfFiles: 0 };
+        const sectionNodes = [];
+        const allEdges = [];
+        for (const absPath of pdfPaths) {
+            const rel = relative(ctx.repoPath, absPath);
+            const fileId = makeId(rel.replace(/\//g, '_'), 'file');
+            let text;
+            try {
+                const buf = readFileSync(absPath);
+                if (buf.length > ctx.options.maxFileSizeBytes * 10)
+                    continue; // 5 MB limit for PDFs
+                text = await extractText(buf);
+            }
+            catch {
+                continue;
+            }
+            if (!text || text.trim().length === 0)
+                continue;
+            // Split into ~1500-char paragraphs with 150-char overlap (knowledge_graph style)
+            const CHUNK = 1500;
+            const OVERLAP = 150;
+            const chunks = [];
+            for (let pos = 0; pos < text.length; pos += CHUNK - OVERLAP) {
+                chunks.push({ content: text.slice(pos, pos + CHUNK), startChar: pos });
+                if (pos + CHUNK >= text.length)
+                    break;
+            }
+            const docTitle = basename(rel).replace(/\.pdf$/i, '');
+            for (let i = 0; i < chunks.length; i++) {
+                const { content, startChar } = chunks[i];
+                const title = `${docTitle} §${i + 1}`;
+                const sectionId = makeId('section', fileId, String(i));
+                const node = {
+                    id: sectionId, label: 'Section',
+                    name: title, normLabel: toNormLabel(title),
+                    filePath: rel, startLine: startChar, endLine: startChar + content.length,
+                    isExported: false,
+                    properties: { level: 1, content: content.slice(0, 2000), source: 'pdf', chunk: i },
+                };
+                sectionNodes.push(node);
+                allEdges.push({
+                    id: makeId(fileId, sectionId, 'defines'),
+                    sourceId: fileId, targetId: sectionId,
+                    relation: 'DEFINES', confidence: 'EXTRACTED', confidenceScore: CONFIDENCE_SCORE.EXTRACTED,
+                });
+            }
+        }
+        if (sectionNodes.length > 0)
+            insertNodes(ctx.db, sectionNodes);
+        if (allEdges.length > 0)
+            insertEdges(ctx.db, allEdges);
+        ctx.onProgress?.({ phase: 'pdf-parse', message: `Parsed ${pdfPaths.length} PDF files → ${sectionNodes.length} chunks` });
+        return { sectionNodes, pdfFiles: pdfPaths.length };
+    },
+};
+//# sourceMappingURL=pdf-parse.js.map

package/dist/src/pipeline/phases/pdf-parse.js.map

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

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

@@ -0,0 +1,20 @@
+import type { PipelinePhase } from '../types.js';
+export interface ProcessDef {
+    id: string;
+    name: string;
+    filePath: string;
+    entryNodeId: string;
+    stepCount: number;
+}
+export interface ProcessesOutput {
+    processResult: {
+        processes: ProcessDef[];
+        memberships: Map<string, string>;
+        stats: {
+            totalProcesses: number;
+            totalSteps: number;
+        };
+    };
+}
+export declare const processesPhase: PipelinePhase<ProcessesOutput>;
+//# sourceMappingURL=processes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"processes.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phases/processes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AASjD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE;QACb,SAAS,EAAE,UAAU,EAAE,CAAC;QACxB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,KAAK,EAAE;YAAE,cAAc,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC;KACvD,CAAC;CACH;AAwGD,eAAO,MAAM,cAAc,EAAE,aAAa,CAAC,eAAe,CA4GzD,CAAC"}

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

@@ -0,0 +1,163 @@
+import { basename, extname } from 'path';
+import { makeId, toNormLabel } from '../../types.js';
+import { insertNodes } from '../../storage/node-store.js';
+import { insertEdges } from '../../storage/edge-store.js';
+// ── Entry-point file names that boost score ───────────────────────────────────
+const ENTRY_FILENAMES = new Set(['index', 'main', 'cli', 'server', 'app', 'cmd']);
+// ── BFS call-chain traversal ──────────────────────────────────────────────────
+function bfsCallChain(startNodeId, db, maxDepth = 8) {
+    const visited = new Set([startNodeId]);
+    const queue = [{ id: startNodeId, depth: 0 }];
+    const calleesStmt = db.prepare(`
+    SELECT target_id FROM edges WHERE source_id = ? AND relation = 'CALLS'
+  `);
+    while (queue.length > 0) {
+        const item = queue.shift();
+        if (item.depth >= maxDepth)
+            continue;
+        const callees = calleesStmt.all(item.id);
+        for (const { target_id } of callees) {
+            if (!visited.has(target_id)) {
+                visited.add(target_id);
+                queue.push({ id: target_id, depth: item.depth + 1 });
+            }
+        }
+    }
+    return visited;
+}
+function scoreEntryPoints(db) {
+    const symbolRows = db
+        .prepare(`SELECT id, name, file_path, is_exported, language
+       FROM nodes
+       WHERE label IN ('Function', 'Method', 'Class')`)
+        .all();
+    const incomingCallsStmt = db.prepare(`SELECT COUNT(*) as cnt FROM edges WHERE target_id = ? AND relation = 'CALLS'`);
+    const isRouteHandlerStmt = db.prepare(`SELECT COUNT(*) as cnt FROM edges WHERE target_id = ? AND relation = 'HANDLES_ROUTE'`);
+    const isToolHandlerStmt = db.prepare(`SELECT COUNT(*) as cnt FROM edges WHERE target_id = ? AND relation = 'HANDLES_TOOL'`);
+    const scored = [];
+    for (const row of symbolRows) {
+        let score = 0;
+        const incomingCalls = incomingCallsStmt.get(row.id).cnt;
+        if (incomingCalls === 0)
+            score += 3;
+        if (row.is_exported === 1)
+            score += 2;
+        const isRouteHandler = isRouteHandlerStmt.get(row.id).cnt > 0;
+        if (isRouteHandler)
+            score += 4;
+        const isToolHandler = isToolHandlerStmt.get(row.id).cnt > 0;
+        if (isToolHandler)
+            score += 4;
+        const filePath = row.file_path ?? '';
+        const filename = basename(filePath, extname(filePath)).toLowerCase();
+        if (ENTRY_FILENAMES.has(filename))
+            score += 2;
+        if (score >= 3) {
+            scored.push({
+                id: row.id,
+                name: row.name,
+                filePath: filePath,
+                language: row.language ?? 'unknown',
+                score,
+            });
+        }
+    }
+    // Sort by descending score so highest-priority entry points are processed first
+    return scored.sort((a, b) => b.score - a.score);
+}
+// ── Phase ─────────────────────────────────────────────────────────────────────
+export const processesPhase = {
+    name: 'processes',
+    deps: ['communities', 'routes', 'tools', 'structure'],
+    async execute(ctx, _deps) {
+        if (!ctx.db) {
+            return {
+                processResult: {
+                    processes: [],
+                    memberships: new Map(),
+                    stats: { totalProcesses: 0, totalSteps: 0 },
+                },
+            };
+        }
+        const db = ctx.db;
+        // Determine how many processes to create based on symbol count
+        const symbolCountRow = db
+            .prepare(`SELECT COUNT(*) as cnt FROM nodes WHERE label NOT IN ('File', 'Folder', 'Community', 'Process', 'Document')`)
+            .get();
+        const symbolCount = symbolCountRow.cnt;
+        const maxProcesses = Math.max(20, Math.min(300, Math.ceil(symbolCount / 10)));
+        // Score and collect candidate entry points
+        const candidates = scoreEntryPoints(db);
+        const limitedCandidates = candidates.slice(0, maxProcesses);
+        const processNodes = [];
+        const processEdges = [];
+        const processDefs = [];
+        const memberships = new Map();
+        let totalSteps = 0;
+        // Track which nodes are already claimed as an entry point of a process
+        // to avoid creating duplicate processes for the same entry node
+        const claimedEntries = new Set();
+        for (const entry of limitedCandidates) {
+            if (claimedEntries.has(entry.id))
+                continue;
+            claimedEntries.add(entry.id);
+            const processNodeId = makeId('process', entry.id);
+            const stepNodeIds = bfsCallChain(entry.id, db);
+            const processNode = {
+                id: processNodeId,
+                label: 'Process',
+                name: entry.name,
+                normLabel: toNormLabel(entry.name),
+                filePath: entry.filePath,
+                language: entry.language,
+                startLine: 0,
+                endLine: 0,
+                isExported: false,
+                properties: { stepCount: stepNodeIds.size },
+            };
+            processNodes.push(processNode);
+            // ENTRY_POINT_OF: entry symbol → process
+            processEdges.push({
+                id: makeId(entry.id, processNodeId, 'entry_point_of'),
+                sourceId: entry.id,
+                targetId: processNodeId,
+                relation: 'ENTRY_POINT_OF',
+                confidence: 'EXTRACTED',
+                confidenceScore: 0.9,
+            });
+            // STEP_IN_PROCESS: process → each step symbol (including entry)
+            for (const stepNodeId of stepNodeIds) {
+                processEdges.push({
+                    id: makeId(processNodeId, stepNodeId, 'step_in_process'),
+                    sourceId: processNodeId,
+                    targetId: stepNodeId,
+                    relation: 'STEP_IN_PROCESS',
+                    confidence: 'EXTRACTED',
+                    confidenceScore: 0.85,
+                });
+                memberships.set(stepNodeId, processNodeId);
+            }
+            totalSteps += stepNodeIds.size;
+            processDefs.push({
+                id: processNodeId,
+                name: entry.name,
+                filePath: entry.filePath,
+                entryNodeId: entry.id,
+                stepCount: stepNodeIds.size,
+            });
+        }
+        insertNodes(db, processNodes);
+        insertEdges(db, processEdges);
+        return {
+            processResult: {
+                processes: processDefs,
+                memberships,
+                stats: {
+                    totalProcesses: processDefs.length,
+                    totalSteps,
+                },
+            },
+        };
+    },
+};
+//# sourceMappingURL=processes.js.map

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

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

package/dist/src/pipeline/phases/re-export-propagation.d.ts

@@ -0,0 +1,21 @@
+import type { PipelinePhase } from '../types.js';
+import type Database from 'better-sqlite3';
+export interface ReExportPropagationOutput {
+    propagated: number;
+}
+/**
+ * Fixed-point re-export chain propagation.
+ *
+ * After the graph is built, barrel files (index.ts that re-export from sub-modules)
+ * create RE_EXPORTS edges pointing to the files they re-export from. A file is
+ * "reachable" if:
+ *   (a) it has a direct IMPORTS edge targeting one of its symbols or its File node, OR
+ *   (b) it is re-exported by a barrel file that is itself reachable (transitively).
+ *
+ * This prevents false "unreachable" reports for exports behind barrel files.
+ *
+ * Algorithm: iterative BFS until no new propagations (fixed-point).
+ */
+export declare function propagateReExports(db: Database.Database): ReExportPropagationOutput;
+export declare const reExportPropagationPhase: PipelinePhase<ReExportPropagationOutput>;
+//# sourceMappingURL=re-export-propagation.d.ts.map

package/dist/src/pipeline/phases/re-export-propagation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"re-export-propagation.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phases/re-export-propagation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,aAAa,CAAC;AAGlE,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,yBAAyB,CAwGnF;AAED,eAAO,MAAM,wBAAwB,EAAE,aAAa,CAAC,yBAAyB,CAS7E,CAAC"}

package/dist/src/pipeline/phases/re-export-propagation.js

@@ -0,0 +1,109 @@
+import { makeId, CONFIDENCE_SCORE } from '../../types.js';
+/**
+ * Fixed-point re-export chain propagation.
+ *
+ * After the graph is built, barrel files (index.ts that re-export from sub-modules)
+ * create RE_EXPORTS edges pointing to the files they re-export from. A file is
+ * "reachable" if:
+ *   (a) it has a direct IMPORTS edge targeting one of its symbols or its File node, OR
+ *   (b) it is re-exported by a barrel file that is itself reachable (transitively).
+ *
+ * This prevents false "unreachable" reports for exports behind barrel files.
+ *
+ * Algorithm: iterative BFS until no new propagations (fixed-point).
+ */
+export function propagateReExports(db) {
+    // Collect all RE_EXPORTS edges (barrel file → re-exported file), keyed by File node IDs
+    const reExportEdges = db.prepare(`SELECT source_id, target_id FROM edges WHERE relation = 'RE_EXPORTS'`).all();
+    if (reExportEdges.length === 0)
+        return { propagated: 0 };
+    // Build map: barrelFileId → Set<reExportedFileId>
+    const barrelExports = new Map();
+    for (const e of reExportEdges) {
+        if (!barrelExports.has(e.source_id))
+            barrelExports.set(e.source_id, new Set());
+        barrelExports.get(e.source_id).add(e.target_id);
+    }
+    // Determine which File nodes are "reached" — either directly imported (via their File node ID)
+    // or their symbols are imported (join through nodes.file_path).
+    // We build a set of reached file paths to handle both IMPORTS→symbol and IMPORTS→File cases.
+    const reachedFilePaths = new Set(db.prepare(`
+      SELECT DISTINCT n.file_path
+      FROM edges e
+      JOIN nodes n ON n.id = e.target_id
+      WHERE e.relation = 'IMPORTS'
+        AND n.file_path IS NOT NULL
+    `).all().map(r => r.file_path));
+    // Also map File node ID → file_path for barrel lookup
+    const fileIdToPath = new Map(db.prepare(`SELECT id, file_path FROM nodes WHERE label = 'File' AND file_path IS NOT NULL`).all().map(r => [r.id, r.file_path]));
+    // Map file_path → File node ID for inserting synthetic IMPORTS edges
+    const filePathToId = new Map();
+    for (const [id, path] of fileIdToPath)
+        filePathToId.set(path, id);
+    // Prepare insert for synthetic IMPORTS edge: importer_file → re-exported_file (File node)
+    const insertEdge = db.prepare(`
+    INSERT OR IGNORE INTO edges (id, source_id, target_id, relation, confidence, confidence_score, weight)
+    VALUES (?, ?, ?, 'IMPORTS', 'INFERRED', ?, 1.0)
+  `);
+    const addPropagated = db.transaction((toAdd) => {
+        for (const { importerFileId, targetFileId, targetFilePath } of toAdd) {
+            const edgeId = makeId(importerFileId, targetFileId, 'reexport_propagated');
+            insertEdge.run(edgeId, importerFileId, targetFileId, CONFIDENCE_SCORE.INFERRED);
+            reachedFilePaths.add(targetFilePath);
+        }
+    });
+    let totalPropagated = 0;
+    let changed = true;
+    while (changed) {
+        changed = false;
+        const toAdd = [];
+        for (const [barrelFileId, exportedFileIds] of barrelExports) {
+            const barrelFilePath = fileIdToPath.get(barrelFileId);
+            if (!barrelFilePath || !reachedFilePaths.has(barrelFilePath))
+                continue;
+            // Find who imports this barrel (via its File node or via its symbols)
+            const importers = db.prepare(`
+        SELECT DISTINCT e.source_id
+        FROM edges e
+        WHERE e.relation = 'IMPORTS'
+          AND e.target_id IN (
+            SELECT id FROM nodes
+            WHERE file_path = ?
+          )
+      `).all(barrelFilePath);
+            for (const { source_id: importerNodeId } of importers) {
+                // Walk up to the importing File node
+                const importerFilePath = db.prepare(`SELECT file_path FROM nodes WHERE id = ? AND file_path IS NOT NULL LIMIT 1`).get(importerNodeId)?.file_path;
+                const importerFileId = importerFilePath ? filePathToId.get(importerFilePath) : undefined;
+                if (!importerFileId)
+                    continue;
+                for (const targetFileId of exportedFileIds) {
+                    const targetFilePath = fileIdToPath.get(targetFileId);
+                    if (!targetFilePath)
+                        continue;
+                    if (!reachedFilePaths.has(targetFilePath)) {
+                        toAdd.push({ importerFileId, targetFileId, targetFilePath });
+                    }
+                }
+            }
+        }
+        if (toAdd.length > 0) {
+            addPropagated(toAdd);
+            totalPropagated += toAdd.length;
+            changed = true;
+        }
+    }
+    return { propagated: totalPropagated };
+}
+export const reExportPropagationPhase = {
+    name: 're-export-propagation',
+    deps: ['cross-file'],
+    async execute(ctx) {
+        if (!ctx.db)
+            return { propagated: 0 };
+        const result = propagateReExports(ctx.db);
+        ctx.onProgress?.({ phase: 're-export-propagation', message: `Propagated ${result.propagated} re-export edges` });
+        return result;
+    },
+};
+//# sourceMappingURL=re-export-propagation.js.map

package/dist/src/pipeline/phases/re-export-propagation.js.map

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

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

@@ -0,0 +1,32 @@
+import type Database from 'better-sqlite3';
+export type ReachabilityRole = 'runtime' | 'test' | 'support' | 'unreachable';
+/**
+ * Classify every File node's reachability role.
+ *
+ * Entry point detection:
+ * - Test entry points: files matching test patterns (*.test.*, *.spec.*, __tests__/*)
+ * - Runtime entry points: files with no incoming IMPORTS edges (potential roots)
+ * - Support files: *.config.*, scripts/*, tools/* etc.
+ *
+ * BFS propagation (forward — follows what files import):
+ * - From test entry points: mark reachable files as 'test'
+ * - From runtime entry points: mark reachable files as 'runtime'
+ * - Files reachable from both: 'runtime' wins over 'test'
+ * - Nodes reachable from neither: marked 'unreachable'
+ * - Config/support files (*.config.*, scripts/*): marked 'support'
+ */
+export declare function classifyReachability(db: Database.Database, _projectDir: string): {
+    runtime: number;
+    test: number;
+    support: number;
+    unreachable: number;
+};
+/**
+ * Get File nodes filtered by reachability role.
+ */
+export declare function getNodesByReachabilityRole(db: Database.Database, role: ReachabilityRole, limit?: number): Array<{
+    id: string;
+    name: string;
+    filePath: string | null;
+}>;
+//# sourceMappingURL=reachability.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reachability.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phases/reachability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,CAAC;AAE9E;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,WAAW,EAAE,MAAM,GAClB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAoGzE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,IAAI,EAAE,gBAAgB,EACtB,KAAK,SAAM,GACV,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAS9D"}

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

@@ -0,0 +1,124 @@
+/**
+ * Classify every File node's reachability role.
+ *
+ * Entry point detection:
+ * - Test entry points: files matching test patterns (*.test.*, *.spec.*, __tests__/*)
+ * - Runtime entry points: files with no incoming IMPORTS edges (potential roots)
+ * - Support files: *.config.*, scripts/*, tools/* etc.
+ *
+ * BFS propagation (forward — follows what files import):
+ * - From test entry points: mark reachable files as 'test'
+ * - From runtime entry points: mark reachable files as 'runtime'
+ * - Files reachable from both: 'runtime' wins over 'test'
+ * - Nodes reachable from neither: marked 'unreachable'
+ * - Config/support files (*.config.*, scripts/*): marked 'support'
+ */
+export function classifyReachability(db, _projectDir) {
+    const TEST_PATTERNS = [
+        /\.test\.[tj]sx?$/,
+        /\.spec\.[tj]sx?$/,
+        /__tests__\//,
+        /\/test\//,
+        /\/tests\//,
+    ];
+    const SUPPORT_PATTERNS = [
+        /\.config\.[tj]sx?$/,
+        /\/scripts\//,
+        /\/tools\//,
+        /jest\.config/,
+        /vitest\.config/,
+        /webpack\.config/,
+        /vite\.config/,
+    ];
+    const allFileNodes = db.prepare(`SELECT id, file_path, properties FROM nodes WHERE label = 'File' AND file_path IS NOT NULL`).all();
+    const roleMap = new Map();
+    const testEntryIds = new Set();
+    const runtimeEntryIds = new Set();
+    // Initial classification by path pattern
+    for (const node of allFileNodes) {
+        const fp = node.file_path;
+        if (TEST_PATTERNS.some(p => p.test(fp))) {
+            testEntryIds.add(node.id);
+            roleMap.set(node.id, 'test');
+        }
+        else if (SUPPORT_PATTERNS.some(p => p.test(fp))) {
+            roleMap.set(node.id, 'support');
+        }
+    }
+    // Files with no incoming IMPORTS edges are potential runtime roots
+    const noIncoming = db.prepare(`
+    SELECT n.id FROM nodes n
+    WHERE n.label = 'File'
+    AND NOT EXISTS (
+      SELECT 1 FROM edges e WHERE e.target_id = n.id AND e.relation = 'IMPORTS'
+    )
+  `).all();
+    for (const { id } of noIncoming) {
+        if (!roleMap.has(id)) {
+            runtimeEntryIds.add(id);
+            roleMap.set(id, 'runtime');
+        }
+    }
+    // ── BFS from entry points — forward direction (walk what files import) ───────
+    const bfs = (startIds, role) => {
+        const queue = Array.from(startIds);
+        const visited = new Set(startIds);
+        while (queue.length > 0) {
+            const nodeId = queue.shift();
+            // Follow forward edges: find files that this file imports
+            const imported = db.prepare(`SELECT DISTINCT target_id FROM edges WHERE source_id = ? AND relation IN ('IMPORTS', 'RE_EXPORTS')`).all(nodeId);
+            for (const { target_id } of imported) {
+                if (!visited.has(target_id)) {
+                    visited.add(target_id);
+                    // Set role only if not already set to a higher-priority role
+                    // Priority: runtime > test > support > unreachable
+                    const existing = roleMap.get(target_id);
+                    if (!existing || existing === 'unreachable' || (role === 'runtime' && existing === 'test')) {
+                        roleMap.set(target_id, role);
+                    }
+                    queue.push(target_id);
+                }
+            }
+        }
+    };
+    // Test BFS first, then runtime (runtime wins on overlap)
+    bfs(testEntryIds, 'test');
+    bfs(runtimeEntryIds, 'runtime');
+    // ── Persist roles and count ───────────────────────────────────────────────────
+    let runtime = 0, test = 0, support = 0, unreachable = 0;
+    for (const node of allFileNodes) {
+        const role = roleMap.get(node.id) ?? 'unreachable';
+        let props = {};
+        try {
+            if (node.properties)
+                props = JSON.parse(node.properties);
+        }
+        catch { /* ignore parse errors */ }
+        props.reachabilityRole = role;
+        db.prepare(`UPDATE nodes SET properties = ? WHERE id = ?`)
+            .run(JSON.stringify(props), node.id);
+        if (role === 'runtime')
+            runtime++;
+        else if (role === 'test')
+            test++;
+        else if (role === 'support')
+            support++;
+        else
+            unreachable++;
+    }
+    return { runtime, test, support, unreachable };
+}
+/**
+ * Get File nodes filtered by reachability role.
+ */
+export function getNodesByReachabilityRole(db, role, limit = 100) {
+    const rows = db.prepare(`
+    SELECT id, name, file_path
+    FROM nodes
+    WHERE label = 'File'
+    AND json_extract(properties, '$.reachabilityRole') = ?
+    LIMIT ?
+  `).all(role, limit);
+    return rows.map(r => ({ id: r.id, name: r.name, filePath: r.file_path }));
+}
+//# sourceMappingURL=reachability.js.map

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

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