@monoes/monograph 1.0.0

package/dist/src/pipeline/orchestrator.js

@@ -0,0 +1,37 @@
+import { resolve, join } from 'path';
+import Graph from 'graphology';
+import { openDb, closeDb } from '../storage/db.js';
+import { PipelineRunner } from './runner.js';
+import { scanPhase } from './phases/scan.js';
+import { structurePhase } from './phases/structure.js';
+import { parsePhase } from './phases/parse.js';
+import { crossFilePhase } from './phases/cross-file.js';
+import { mroPhase } from './phases/mro.js';
+import { communitiesPhase } from './phases/communities.js';
+import { godNodesPhase } from './phases/god-nodes.js';
+import { surprisesPhase } from './phases/surprises.js';
+import { suggestPhase } from './phases/suggest.js';
+import { DEFAULT_OPTIONS } from './types.js';
+export async function buildAsync(repoPath, options = {}) {
+    const dbPath = resolve(join(repoPath, '.monomind', 'monograph.db'));
+    const fullOptions = { ...DEFAULT_OPTIONS, ...options };
+    const db = openDb(dbPath);
+    try {
+        const graph = new Graph({ multi: true, type: 'directed' });
+        const ctx = {
+            repoPath: resolve(repoPath),
+            db, graph,
+            onProgress: options.onProgress ?? (() => { }),
+            options: fullOptions,
+        };
+        const runner = new PipelineRunner([
+            scanPhase, structurePhase, parsePhase, crossFilePhase,
+            mroPhase, communitiesPhase, godNodesPhase, surprisesPhase, suggestPhase,
+        ]);
+        await runner.run(ctx);
+    }
+    finally {
+        closeDb(db);
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../../src/pipeline/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAQ7C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB,EAAE,UAAwB,EAAE;IAC3E,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC;IACpE,MAAM,WAAW,GAAoB,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC;IACxE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAE1B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QAC3D,MAAM,GAAG,GAAoB;YAC3B,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC;YAC3B,EAAE,EAAE,KAAK;YACT,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;YAC5C,OAAO,EAAE,WAAW;SACrB,CAAC;QAEF,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;YAChC,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc;YACrD,QAAQ,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY;SACxE,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,EAAE,CAAC,CAAC;IACd,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { PipelinePhase } from '../types.js';
+export interface CommunitiesOutput {
+    memberships: Map<string, number>;
+    communityLabels: Map<number, string>;
+}
+export declare const communitiesPhase: PipelinePhase<CommunitiesOutput>;
+//# sourceMappingURL=communities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"communities.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phases/communities.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,aAAa,CAAC;AAMlE,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAAC,iBAAiB,CAgC7D,CAAC"}

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

@@ -0,0 +1,34 @@
+import louvain from 'graphology-communities-louvain';
+import { loadGraphFromEdges } from '../../graph/loader.js';
+export const communitiesPhase = {
+    name: 'communities',
+    deps: ['cross-file', 'mro'],
+    async execute(_ctx, deps) {
+        const { resolvedEdges } = deps.get('cross-file');
+        const { allEdges } = deps.get('parse');
+        const allUsedEdges = [...allEdges, ...resolvedEdges];
+        const graph = loadGraphFromEdges(allUsedEdges);
+        let communities = {};
+        try {
+            communities = louvain(graph);
+        }
+        catch {
+            // Empty or disconnected graph
+        }
+        const memberships = new Map(Object.entries(communities).map(([k, v]) => [k, v]));
+        const communityLabels = new Map();
+        const communityDegrees = new Map();
+        for (const [nodeId, commId] of memberships) {
+            if (!communityDegrees.has(commId))
+                communityDegrees.set(commId, new Map());
+            const deg = graph.degree(nodeId) ?? 0;
+            communityDegrees.get(commId).set(nodeId, deg);
+        }
+        for (const [commId, nodeDegs] of communityDegrees) {
+            const topNode = [...nodeDegs.entries()].sort((a, b) => b[1] - a[1])[0]?.[0] ?? '';
+            communityLabels.set(commId, `community-${commId}(${topNode.slice(0, 20)})`);
+        }
+        return { memberships, communityLabels };
+    },
+};
+//# sourceMappingURL=communities.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"communities.js","sourceRoot":"","sources":["../../../../src/pipeline/phases/communities.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,gCAAgC,CAAC;AAGrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAS3D,MAAM,CAAC,MAAM,gBAAgB,GAAqC;IAChE,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,CAAC,YAAY,EAAE,KAAK,CAAC;IAC3B,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI;QACtB,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAoB,CAAC;QACpE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAgB,CAAC;QACtD,MAAM,YAAY,GAAoB,CAAC,GAAG,QAAQ,EAAE,GAAG,aAAa,CAAC,CAAC;QAEtE,MAAM,KAAK,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;QAC/C,IAAI,WAAW,GAA2B,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;QAChC,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,GAAG,CAAiB,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACjG,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;QAElD,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA+B,CAAC;QAChE,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;YAC3C,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;YAC3E,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACtC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACjD,CAAC;QACD,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,gBAAgB,EAAE,CAAC;YAClD,MAAM,OAAO,GAAG,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAClF,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;QAC9E,CAAC;QAED,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC;IAC1C,CAAC;CACF,CAAC"}

package/dist/src/pipeline/phases/cross-file.d.ts

@@ -0,0 +1,7 @@
+import type { PipelinePhase } from '../types.js';
+import type { MonographEdge } from '../../types.js';
+export interface CrossFileOutput {
+    resolvedEdges: MonographEdge[];
+}
+export declare const crossFilePhase: PipelinePhase<CrossFileOutput>;
+//# sourceMappingURL=cross-file.d.ts.map

package/dist/src/pipeline/phases/cross-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-file.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phases/cross-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAKpD,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,aAAa,EAAE,CAAC;CAChC;AAED,eAAO,MAAM,cAAc,EAAE,aAAa,CAAC,eAAe,CAqCzD,CAAC"}

package/dist/src/pipeline/phases/cross-file.js

@@ -0,0 +1,36 @@
+import { makeId, CONFIDENCE_SCORE } from '../../types.js';
+import { insertEdges } from '../../storage/edge-store.js';
+export const crossFilePhase = {
+    name: 'cross-file',
+    deps: ['parse'],
+    async execute(_ctx, deps) {
+        const { allEdges, symbolNodes } = deps.get('parse');
+        const nameIndex = new Map();
+        for (const node of symbolNodes) {
+            nameIndex.set(node.name, node.id);
+            if (node.normLabel)
+                nameIndex.set(node.normLabel, node.id);
+        }
+        const resolvedEdges = [];
+        for (const edge of allEdges) {
+            if (edge.relation !== 'IMPORTS')
+                continue;
+            const targetName = edge.targetId.replace(/^import_/, '').split('/').pop() ?? '';
+            const resolvedId = nameIndex.get(targetName) ?? nameIndex.get(targetName.toLowerCase());
+            if (resolvedId && resolvedId !== edge.targetId) {
+                resolvedEdges.push({
+                    ...edge,
+                    id: makeId(edge.sourceId, resolvedId, 'resolved'),
+                    targetId: resolvedId,
+                    confidence: 'INFERRED',
+                    confidenceScore: CONFIDENCE_SCORE.INFERRED,
+                });
+            }
+        }
+        if (_ctx.db && resolvedEdges.length > 0) {
+            insertEdges(_ctx.db, resolvedEdges);
+        }
+        return { resolvedEdges };
+    },
+};
+//# sourceMappingURL=cross-file.js.map

package/dist/src/pipeline/phases/cross-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-file.js","sourceRoot":"","sources":["../../../../src/pipeline/phases/cross-file.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAO1D,MAAM,CAAC,MAAM,cAAc,GAAmC;IAC5D,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,CAAC,OAAO,CAAC;IACf,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI;QACtB,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAgB,CAAC;QAEnE,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC5C,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YAClC,IAAI,IAAI,CAAC,SAAS;gBAAE,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,aAAa,GAAoB,EAAE,CAAC;QAE1C,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;gBAAE,SAAS;YAE1C,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;YAChF,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;YAExF,IAAI,UAAU,IAAI,UAAU,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC/C,aAAa,CAAC,IAAI,CAAC;oBACjB,GAAG,IAAI;oBACP,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC;oBACjD,QAAQ,EAAE,UAAU;oBACpB,UAAU,EAAE,UAAU;oBACtB,eAAe,EAAE,gBAAgB,CAAC,QAAQ;iBAC3C,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,EAAE,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;QACtC,CAAC;QAED,OAAO,EAAE,aAAa,EAAE,CAAC;IAC3B,CAAC;CACF,CAAC"}

package/dist/src/pipeline/phases/god-nodes.d.ts

@@ -0,0 +1,7 @@
+import type { PipelinePhase } from '../types.js';
+import type { GodNode } from '../../types.js';
+export interface GodNodesOutput {
+    godNodes: GodNode[];
+}
+export declare const godNodesPhase: PipelinePhase<GodNodesOutput>;
+//# sourceMappingURL=god-nodes.d.ts.map

package/dist/src/pipeline/phases/god-nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"god-nodes.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phases/god-nodes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,gBAAgB,CAAC;AAM7D,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC,cAAc,CA4BvD,CAAC"}

package/dist/src/pipeline/phases/god-nodes.js

@@ -0,0 +1,28 @@
+const EXCLUDED_LABELS = new Set(['File', 'Folder', 'Community', 'Concept']);
+export const godNodesPhase = {
+    name: 'god-nodes',
+    deps: ['cross-file', 'parse'],
+    async execute(ctx, deps) {
+        const { resolvedEdges } = deps.get('cross-file');
+        const { allEdges, symbolNodes } = deps.get('parse');
+        const allEdgesCombined = [...allEdges, ...resolvedEdges];
+        const inDeg = new Map();
+        const outDeg = new Map();
+        for (const e of allEdgesCombined) {
+            outDeg.set(e.sourceId, (outDeg.get(e.sourceId) ?? 0) + 1);
+            inDeg.set(e.targetId, (inDeg.get(e.targetId) ?? 0) + 1);
+        }
+        const godNodes = symbolNodes
+            .filter(n => !EXCLUDED_LABELS.has(n.label) && (inDeg.get(n.id) ?? 0) + (outDeg.get(n.id) ?? 0) > 0)
+            .map(n => ({
+            ...n,
+            inDegree: inDeg.get(n.id) ?? 0,
+            outDegree: outDeg.get(n.id) ?? 0,
+            degree: (inDeg.get(n.id) ?? 0) + (outDeg.get(n.id) ?? 0),
+        }))
+            .sort((a, b) => b.degree - a.degree)
+            .slice(0, 20);
+        return { godNodes };
+    },
+};
+//# sourceMappingURL=god-nodes.js.map

package/dist/src/pipeline/phases/god-nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"god-nodes.js","sourceRoot":"","sources":["../../../../src/pipeline/phases/god-nodes.ts"],"names":[],"mappings":"AAKA,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;AAM5E,MAAM,CAAC,MAAM,aAAa,GAAkC;IAC1D,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC;IAC7B,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI;QACrB,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAoB,CAAC;QACpE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAgB,CAAC;QACnE,MAAM,gBAAgB,GAAoB,CAAC,GAAG,QAAQ,EAAE,GAAG,aAAa,CAAC,CAAC;QAE1E,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;QACxC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;QACzC,KAAK,MAAM,CAAC,IAAI,gBAAgB,EAAE,CAAC;YACjC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1D,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,QAAQ,GAAc,WAAW;aACpC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;aAClG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACT,GAAG,CAAC;YACJ,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC;YAC9B,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC;YAChC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;SACzD,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;aACnC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAEhB,OAAO,EAAE,QAAQ,EAAE,CAAC;IACtB,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { PipelinePhase } from '../types.js';
+import type { MonographEdge } from '../../types.js';
+export interface MroOutput {
+    mroEdges: MonographEdge[];
+}
+export declare const mroPhase: PipelinePhase<MroOutput>;
+//# sourceMappingURL=mro.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mro.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phases/mro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAIpD,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,eAAO,MAAM,QAAQ,EAAE,aAAa,CAAC,SAAS,CA0C7C,CAAC"}

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

@@ -0,0 +1,41 @@
+import { makeId, CONFIDENCE_SCORE } from '../../types.js';
+export const mroPhase = {
+    name: 'mro',
+    deps: ['cross-file'],
+    async execute(_ctx, deps) {
+        const { allEdges, symbolNodes } = deps.get('parse');
+        const classMethodsIndex = new Map();
+        for (const edge of allEdges) {
+            if (edge.relation === 'HAS_METHOD') {
+                const methods = classMethodsIndex.get(edge.sourceId) ?? [];
+                methods.push(edge.targetId);
+                classMethodsIndex.set(edge.sourceId, methods);
+            }
+        }
+        const nameIndex = new Map(symbolNodes.map(n => [n.id, n.name]));
+        const mroEdges = [];
+        for (const edge of allEdges) {
+            if (edge.relation !== 'EXTENDS' && edge.relation !== 'IMPLEMENTS')
+                continue;
+            const parentMethods = classMethodsIndex.get(edge.targetId) ?? [];
+            const childMethods = classMethodsIndex.get(edge.sourceId) ?? [];
+            const parentMethodNames = new Map(parentMethods.map(id => [nameIndex.get(id) ?? id, id]));
+            for (const childMethodId of childMethods) {
+                const childName = nameIndex.get(childMethodId);
+                if (!childName)
+                    continue;
+                const parentMethodId = parentMethodNames.get(childName);
+                if (!parentMethodId)
+                    continue;
+                const relation = edge.relation === 'IMPLEMENTS' ? 'METHOD_IMPLEMENTS' : 'METHOD_OVERRIDES';
+                mroEdges.push({
+                    id: makeId(childMethodId, parentMethodId, relation.toLowerCase()),
+                    sourceId: childMethodId, targetId: parentMethodId,
+                    relation, confidence: 'EXTRACTED', confidenceScore: CONFIDENCE_SCORE.EXTRACTED,
+                });
+            }
+        }
+        return { mroEdges };
+    },
+};
+//# sourceMappingURL=mro.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mro.js","sourceRoot":"","sources":["../../../../src/pipeline/phases/mro.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAO1D,MAAM,CAAC,MAAM,QAAQ,GAA6B;IAChD,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,CAAC,YAAY,CAAC;IACpB,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI;QACtB,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAgB,CAAC;QAEnE,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAoB,CAAC;QACtD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;gBACnC,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAC3D,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC5B,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChE,MAAM,QAAQ,GAAoB,EAAE,CAAC;QAErC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,KAAK,YAAY;gBAAE,SAAS;YAE5E,MAAM,aAAa,GAAG,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACjE,MAAM,YAAY,GAAG,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YAChE,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;YAE1F,KAAK,MAAM,aAAa,IAAI,YAAY,EAAE,CAAC;gBACzC,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;gBAC/C,IAAI,CAAC,SAAS;oBAAE,SAAS;gBACzB,MAAM,cAAc,GAAG,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBACxD,IAAI,CAAC,cAAc;oBAAE,SAAS;gBAE9B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,kBAAkB,CAAC;gBAC3F,QAAQ,CAAC,IAAI,CAAC;oBACZ,EAAE,EAAE,MAAM,CAAC,aAAa,EAAE,cAAc,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC;oBACjE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,cAAc;oBACjD,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,gBAAgB,CAAC,SAAS;iBAC/E,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,CAAC;IACtB,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { PipelinePhase } from '../types.js';
+import type { MonographNode, MonographEdge } from '../../types.js';
+export interface ParseOutput {
+    symbolNodes: MonographNode[];
+    allEdges: MonographEdge[];
+    parseErrors: string[];
+}
+export declare const parsePhase: PipelinePhase<ParseOutput>;
+//# sourceMappingURL=parse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phases/parse.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAMnE,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,eAAO,MAAM,UAAU,EAAE,aAAa,CAAC,WAAW,CA8CjD,CAAC"}

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

@@ -0,0 +1,51 @@
+import { readFileSync, statSync } from 'fs';
+import { extname } from 'path';
+import { parseFile } from '../../parsers/loader.js';
+import { insertNodes } from '../../storage/node-store.js';
+import { insertEdges } from '../../storage/edge-store.js';
+export const parsePhase = {
+    name: 'parse',
+    deps: ['structure'],
+    async execute(ctx, deps) {
+        const { fileNodes } = deps.get('structure');
+        const symbolNodes = [];
+        const allEdges = [];
+        const parseErrors = [];
+        let processed = 0;
+        for (const fileNode of fileNodes) {
+            const absPath = fileNode.filePath ? `${ctx.repoPath}/${fileNode.filePath}` : '';
+            const ext = extname(absPath).toLowerCase();
+            let source;
+            try {
+                const stat = statSync(absPath);
+                if (stat.size > ctx.options.maxFileSizeBytes) {
+                    parseErrors.push(`${fileNode.filePath}: skipped (too large)`);
+                    continue;
+                }
+                source = readFileSync(absPath, 'utf-8');
+            }
+            catch {
+                continue;
+            }
+            const result = await parseFile(absPath, source, fileNode.filePath ?? '');
+            symbolNodes.push(...result.nodes);
+            allEdges.push(...result.edges);
+            parseErrors.push(...result.parseErrors);
+            processed++;
+            if (processed % 50 === 0) {
+                ctx.onProgress?.({ phase: 'parse', filesProcessed: processed, totalFiles: fileNodes.length });
+            }
+        }
+        if (ctx.db) {
+            insertNodes(ctx.db, symbolNodes);
+            // Only insert edges whose target already exists in the DB (intra-file edges).
+            // Cross-file import edges with unresolved targets are handled by crossFilePhase
+            // after it resolves them to real node IDs.
+            const knownIds = new Set(symbolNodes.map(n => n.id));
+            const resolvableEdges = allEdges.filter(e => knownIds.has(e.targetId));
+            insertEdges(ctx.db, resolvableEdges);
+        }
+        return { symbolNodes, allEdges, parseErrors };
+    },
+};
+//# sourceMappingURL=parse.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../../src/pipeline/phases/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAG/B,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAS1D,MAAM,CAAC,MAAM,UAAU,GAA+B;IACpD,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,CAAC,WAAW,CAAC;IACnB,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI;QACrB,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAoB,CAAC;QAC/D,MAAM,WAAW,GAAoB,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAoB,EAAE,CAAC;QACrC,MAAM,WAAW,GAAa,EAAE,CAAC;QACjC,IAAI,SAAS,GAAG,CAAC,CAAC;QAElB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChF,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;YAC3C,IAAI,MAAc,CAAC;YACnB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAC/B,IAAI,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;oBAC7C,WAAW,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,QAAQ,uBAAuB,CAAC,CAAC;oBAC9D,SAAS;gBACX,CAAC;gBACD,MAAM,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1C,CAAC;YAAC,MAAM,CAAC;gBAAC,SAAS;YAAC,CAAC;YAErB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YACzE,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAClC,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/B,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;YACxC,SAAS,EAAE,CAAC;YAEZ,IAAI,SAAS,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;gBACzB,GAAG,CAAC,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;YAChG,CAAC;QACH,CAAC;QAED,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;YACX,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;YACjC,8EAA8E;YAC9E,gFAAgF;YAChF,2CAA2C;YAC3C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACrD,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;YACvE,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;IAChD,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { PipelinePhase } from '../types.js';
+export interface ScanOutput {
+    filePaths: string[];
+    totalBytes: number;
+}
+export declare const scanPhase: PipelinePhase<ScanOutput>;
+//# sourceMappingURL=scan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phases/scan.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,aAAa,CAAC;AAgBlE,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,SAAS,EAAE,aAAa,CAAC,UAAU,CAkC/C,CAAC"}

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

@@ -0,0 +1,60 @@
+import { readdirSync, statSync } from 'fs';
+import { join, extname } from 'path';
+import { isSupportedExtension } from '../../parsers/loader.js';
+const DEFAULT_IGNORE = new Set([
+    'node_modules', '.git', 'dist', 'build', '__pycache__',
+    '.cache', 'coverage', '.monomind', 'vendor', 'target',
+]);
+const BINARY_EXTENSIONS = new Set([
+    '.png', '.jpg', '.jpeg', '.gif', '.svg', '.ico', '.woff', '.woff2',
+    '.ttf', '.eot', '.mp3', '.mp4', '.zip', '.gz', '.tar', '.pdf',
+    '.exe', '.dll', '.so', '.dylib', '.class', '.jar',
+]);
+const GENERATED_PATTERNS = [/\.min\.(js|css)$/, /\.pb\.go$/, /_generated\.ts$/];
+export const scanPhase = {
+    name: 'scan',
+    deps: [],
+    async execute(ctx) {
+        const filePaths = [];
+        let totalBytes = 0;
+        const ignoreDirs = new Set([...DEFAULT_IGNORE, ...ctx.options.ignore]);
+        function walk(dir) {
+            let entries;
+            try {
+                entries = readdirSync(dir);
+            }
+            catch {
+                return;
+            }
+            for (const entry of entries) {
+                if (ignoreDirs.has(entry))
+                    continue;
+                const fullPath = join(dir, entry);
+                let stat;
+                try {
+                    stat = statSync(fullPath);
+                }
+                catch {
+                    continue;
+                }
+                if (stat.isDirectory()) {
+                    walk(fullPath);
+                    continue;
+                }
+                const ext = extname(entry).toLowerCase();
+                if (BINARY_EXTENSIONS.has(ext))
+                    continue;
+                if (GENERATED_PATTERNS.some(r => r.test(entry)))
+                    continue;
+                if (ctx.options.codeOnly && !isSupportedExtension(ext))
+                    continue;
+                filePaths.push(fullPath);
+                totalBytes += stat.size;
+            }
+        }
+        walk(ctx.repoPath);
+        ctx.onProgress?.({ phase: 'scan', totalFiles: filePaths.length });
+        return { filePaths, totalBytes };
+    },
+};
+//# sourceMappingURL=scan.js.map

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

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

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

@@ -0,0 +1,9 @@
+import type { PipelinePhase } from '../types.js';
+import type { MonographNode, MonographEdge } from '../../types.js';
+export interface StructureOutput {
+    fileNodes: MonographNode[];
+    folderNodes: MonographNode[];
+    containsEdges: MonographEdge[];
+}
+export declare const structurePhase: PipelinePhase<StructureOutput>;
+//# sourceMappingURL=structure.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phases/structure.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAInE,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B,aAAa,EAAE,aAAa,EAAE,CAAC;CAChC;AAED,eAAO,MAAM,cAAc,EAAE,aAAa,CAAC,eAAe,CAuDzD,CAAC"}

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

@@ -0,0 +1,56 @@
+import { relative, dirname, basename } from 'path';
+import { makeId, toNormLabel, CONFIDENCE_SCORE } from '../../types.js';
+export const structurePhase = {
+    name: 'structure',
+    deps: ['scan'],
+    async execute(ctx, deps) {
+        const { filePaths } = deps.get('scan');
+        const fileNodes = [];
+        const folderNodes = [];
+        const containsEdges = [];
+        const seenFolders = new Set();
+        for (const absPath of filePaths) {
+            const rel = relative(ctx.repoPath, absPath);
+            const fileId = makeId(rel.replace(/\//g, '_'), 'file');
+            fileNodes.push({
+                id: fileId, label: 'File',
+                name: basename(rel), normLabel: toNormLabel(basename(rel)),
+                filePath: rel, isExported: false,
+            });
+            const parts = dirname(rel).split('/');
+            let current = '';
+            let parentFolderId = null;
+            for (const part of parts) {
+                if (part === '.')
+                    continue;
+                current = current ? `${current}/${part}` : part;
+                const folderId = makeId(current.replace(/\//g, '_'), 'folder');
+                if (!seenFolders.has(folderId)) {
+                    seenFolders.add(folderId);
+                    folderNodes.push({
+                        id: folderId, label: 'Folder',
+                        name: part, normLabel: toNormLabel(part),
+                        filePath: current, isExported: false,
+                    });
+                    if (parentFolderId) {
+                        containsEdges.push({
+                            id: makeId(parentFolderId, folderId, 'contains'),
+                            sourceId: parentFolderId, targetId: folderId,
+                            relation: 'CONTAINS', confidence: 'EXTRACTED', confidenceScore: CONFIDENCE_SCORE.EXTRACTED,
+                        });
+                    }
+                }
+                parentFolderId = folderId;
+            }
+            if (parentFolderId) {
+                containsEdges.push({
+                    id: makeId(parentFolderId, fileId, 'contains'),
+                    sourceId: parentFolderId, targetId: fileId,
+                    relation: 'CONTAINS', confidence: 'EXTRACTED', confidenceScore: CONFIDENCE_SCORE.EXTRACTED,
+                });
+            }
+        }
+        return { fileNodes, folderNodes, containsEdges };
+    },
+};
+//# sourceMappingURL=structure.js.map

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

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

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

@@ -0,0 +1,7 @@
+import type { PipelinePhase } from '../types.js';
+import type { SuggestedQuestion } from '../../types.js';
+export interface SuggestOutput {
+    questions: SuggestedQuestion[];
+}
+export declare const suggestPhase: PipelinePhase<SuggestOutput>;
+//# sourceMappingURL=suggest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phases/suggest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAIxD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAED,eAAO,MAAM,YAAY,EAAE,aAAa,CAAC,aAAa,CA6DrD,CAAC"}

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

@@ -0,0 +1,59 @@
+export const suggestPhase = {
+    name: 'suggest',
+    deps: ['parse', 'cross-file', 'mro', 'communities', 'god-nodes', 'surprises'],
+    async execute(_ctx, deps) {
+        const { allEdges, symbolNodes } = deps.get('parse');
+        const { memberships } = deps.get('communities');
+        const questions = [];
+        // Signal 1: ambiguous edges
+        for (const edge of allEdges) {
+            if (edge.confidence === 'AMBIGUOUS') {
+                questions.push({ type: 'ambiguous_edge', edge, reason: 'Dynamic dispatch or unresolved target' });
+            }
+        }
+        // Signal 2: bridge nodes
+        const nodeCommSet = new Map();
+        for (const edge of allEdges) {
+            const srcComm = memberships.get(edge.sourceId);
+            const tgtComm = memberships.get(edge.targetId);
+            if (srcComm !== undefined && tgtComm !== undefined && srcComm !== tgtComm) {
+                for (const [nid, comm] of [[edge.sourceId, srcComm], [edge.targetId, tgtComm]]) {
+                    const s = nodeCommSet.get(nid) ?? new Set();
+                    s.add(comm);
+                    nodeCommSet.set(nid, s);
+                }
+            }
+        }
+        for (const [nodeId, comms] of nodeCommSet) {
+            if (comms.size >= 2) {
+                const node = symbolNodes.find(n => n.id === nodeId);
+                if (!node)
+                    continue;
+                const [commA, commB] = [...comms];
+                questions.push({ type: 'bridge_node', node, commA, commB });
+            }
+        }
+        // Signal 3: verify_inferred
+        for (const edge of allEdges) {
+            if (edge.confidence === 'INFERRED') {
+                questions.push({ type: 'verify_inferred', edge, inferredFrom: 'type inference / alias resolution' });
+            }
+        }
+        // Signal 4: isolated nodes
+        const connectedIds = new Set();
+        for (const e of allEdges) {
+            connectedIds.add(e.sourceId);
+            connectedIds.add(e.targetId);
+        }
+        const isolated = symbolNodes.filter(n => !connectedIds.has(n.id) && n.label !== 'File' && n.label !== 'Folder');
+        if (isolated.length > 0) {
+            questions.push({ type: 'isolated_nodes', nodes: isolated.slice(0, 10), reason: 'No edges found' });
+        }
+        const PRIORITY = {
+            bridge_node: 5, ambiguous_edge: 4, verify_inferred: 3, low_cohesion: 2, isolated_nodes: 1
+        };
+        questions.sort((a, b) => (PRIORITY[b.type] ?? 0) - (PRIORITY[a.type] ?? 0));
+        return { questions };
+    },
+};
+//# sourceMappingURL=suggest.js.map

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

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

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

@@ -0,0 +1,7 @@
+import type { PipelinePhase } from '../types.js';
+import type { SurprisingConnection } from '../../types.js';
+export interface SurprisesOutput {
+    surprises: SurprisingConnection[];
+}
+export declare const surprisesPhase: PipelinePhase<SurprisesOutput>;
+//# sourceMappingURL=surprises.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"surprises.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phases/surprises.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAa3D,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,oBAAoB,EAAE,CAAC;CACnC;AAED,eAAO,MAAM,cAAc,EAAE,aAAa,CAAC,eAAe,CAmDzD,CAAC"}