@monoes/monograph 1.2.0 → 1.2.2

package/dist/src/analysis/dep-classification.js

@@ -96,4 +96,34 @@ export function classifyDependencies(db) {
         valueOnlyCount,
     };
 }
+/** Format DepClassificationResult as structured text for LLM navigation and actionable guidance. */
+export function formatDepClassification(result) {
+    if (result.packages.length === 0) {
+        return 'Dependency classification: no external packages detected.';
+    }
+    const lines = [
+        `Dependency classification: ${result.packages.length} external package(s).`,
+        `  type-only: ${result.typeOnlyCount}  mixed: ${result.mixedCount}  value-only: ${result.valueOnlyCount}`,
+        '',
+    ];
+    const groups = [
+        ['type-only', 'Type-only (move to devDependencies or use @types)', 'Move to devDependencies — not needed at runtime.'],
+        ['unused', 'Unused', 'Remove from dependencies — no imports detected.'],
+        ['move-to-devdeps', 'Move to devDependencies', 'Only used in non-production code paths.'],
+        ['keep-as-dep', 'Keep as dependency', 'Used as runtime value imports — keep in dependencies.'],
+    ];
+    for (const [rec, heading, advice] of groups) {
+        const pkgs = result.packages.filter(p => p.recommendation === rec);
+        if (pkgs.length === 0)
+            continue;
+        lines.push(`${heading} (${pkgs.length}):`);
+        for (const p of pkgs) {
+            const typeNote = p.typeOnlyImportCount > 0 ? ` (${p.typeOnlyImportCount} type-only)` : '';
+            lines.push(`  ${p.packageName}  imports:${p.importCount}${typeNote}`);
+        }
+        lines.push(`  → ${advice}`);
+        lines.push('');
+    }
+    return lines.join('\n').trimEnd();
+}
 //# sourceMappingURL=dep-classification.js.map

package/dist/src/analysis/dep-classification.js.map

@@ -1 +1 @@
-{"version":3,"file":"dep-classification.js","sourceRoot":"","sources":["../../../src/analysis/dep-classification.ts"],"names":[],"mappings":"AA2BA,SAAS,iBAAiB,CAAC,OAAe,EAAE,WAAmB;IAC7D,0DAA0D;IAC1D,0CAA0C;IAC1C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,qEAAqE;QACrE,OAAO,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAW;IACrC,0CAA0C;IAC1C,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,sEAAsE;IACtE,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,EAAe;IAClD,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;;GAMvB,CAAC,CAAC,GAAG,EAAe,CAAC;IAEtB,iCAAiC;IACjC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAyD,CAAC;IAEpF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC;QAEnC,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC;YAAE,SAAS;QAEnD,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC;QAC3D,IAAI,CAAC,WAAW;YAAE,SAAS;QAE3B,gEAAgE;QAChE,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YACnB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAA4B,CAAC;gBACpE,UAAU,GAAG,KAAK,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;YAC5C,CAAC;YAAC,MAAM,CAAC;gBACP,uCAAuC;YACzC,CAAC;QACH,CAAC;QACD,6EAA6E;QAC7E,iFAAiF;QACjF,gEAAgE;QAEhE,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;QACpF,IAAI,UAAU,EAAE,CAAC;YACf,QAAQ,CAAC,WAAW,EAAE,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,YAAY,EAAE,CAAC;QAC1B,CAAC;QACD,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,QAAQ,GAA+B,EAAE,CAAC;IAEhD,KAAK,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC/C,MAAM,WAAW,GAAG,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC;QAC5C,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC;QAE9C,IAAI,cAA0D,CAAC;QAC/D,IAAI,WAAW,IAAI,cAAc,EAAE,CAAC;YAClC,cAAc,GAAG,aAAa,CAAC;QACjC,CAAC;aAAM,IAAI,WAAW,IAAI,CAAC,cAAc,EAAE,CAAC;YAC1C,cAAc,GAAG,aAAa,CAAC;QACjC,CAAC;aAAM,IAAI,CAAC,WAAW,IAAI,cAAc,EAAE,CAAC;YAC1C,cAAc,GAAG,WAAW,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,cAAc,GAAG,QAAQ,CAAC;QAC5B,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC;YACZ,WAAW;YACX,WAAW;YACX,cAAc;YACd,cAAc;YACd,WAAW,EAAE,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,WAAW;YACrD,mBAAmB,EAAE,MAAM,CAAC,WAAW;SACxC,CAAC,CAAC;IACL,CAAC;IAED,oDAAoD;IACpD,MAAM,KAAK,GAA2B,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;IAC9G,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEzF,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;IACpF,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC;IAClF,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC;IAEvF,OAAO;QACL,QAAQ;QACR,aAAa;QACb,UAAU;QACV,cAAc;KACf,CAAC;AACJ,CAAC"}
+{"version":3,"file":"dep-classification.js","sourceRoot":"","sources":["../../../src/analysis/dep-classification.ts"],"names":[],"mappings":"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"}

package/dist/src/analysis/dependency-health.d.ts

@@ -44,4 +44,8 @@ export interface DependencyHealthResult {
  * Compute a composite dependency health score for the given graph.
  */
 export declare function dependencyHealth(input: DependencyHealthInput): DependencyHealthResult;
+/**
+ * Format dependency health results as structured text for LLM consumption.
+ */
+export declare function formatDependencyHealth(result: DependencyHealthResult): string;
 //# sourceMappingURL=dependency-health.d.ts.map

package/dist/src/analysis/dependency-health.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dependency-health.d.ts","sourceRoot":"","sources":["../../../src/analysis/dependency-health.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,iCAAiC;IACjC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,0BAA0B;IAC1B,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,uBAAuB,CAAC;CAClC;AAaD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,sBAAsB,CA2DrF"}
+{"version":3,"file":"dependency-health.d.ts","sourceRoot":"","sources":["../../../src/analysis/dependency-health.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,iCAAiC;IACjC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,0BAA0B;IAC1B,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,uBAAuB,CAAC;CAClC;AAaD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,sBAAsB,CA2DrF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAoB7E"}

package/dist/src/analysis/dependency-health.js

@@ -74,4 +74,32 @@ export function dependencyHealth(input) {
         details: { cyclePenalty, deadCodeRatio, fanSkew, godNodeConcentration },
     };
 }
+/**
+ * Format dependency health results as structured text for LLM consumption.
+ */
+export function formatDependencyHealth(result) {
+    const { score, details } = result;
+    const pct = (v) => `${(v * 100).toFixed(1)}%`;
+    const grade = score >= 0.9 ? 'Excellent' : score >= 0.75 ? 'Good' : score >= 0.5 ? 'Fair' : 'Poor';
+    const lines = [
+        `Dependency health score: ${pct(score)} (${grade})`,
+        `  Cycle penalty       : ${pct(details.cyclePenalty)}  (fraction of nodes in cycles; weight 35%)`,
+        `  Dead-code ratio     : ${pct(details.deadCodeRatio)}  (fraction of unreachable nodes; weight 25%)`,
+        `  Fan-out skew        : ${pct(details.fanSkew)}  (out-degree coefficient of variation / 4; weight 20%)`,
+        `  God-node density    : ${pct(details.godNodeConcentration)}  (max in-degree / total edges; weight 20%)`,
+    ];
+    const advice = [];
+    if (details.cyclePenalty > 0.1)
+        advice.push('reduce circular imports (cyclePenalty high)');
+    if (details.deadCodeRatio > 0.1)
+        advice.push('remove unreachable exports (deadCodeRatio high)');
+    if (details.fanSkew > 0.25)
+        advice.push('break up high-fan-out modules (fanSkew high)');
+    if (details.godNodeConcentration > 0.1)
+        advice.push('distribute hub dependencies (godNodeConcentration high)');
+    if (advice.length > 0) {
+        lines.push('  Recommendations: ' + advice.join('; '));
+    }
+    return lines.join('\n');
+}
 //# sourceMappingURL=dependency-health.js.map

package/dist/src/analysis/dependency-health.js.map

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

package/dist/src/analysis/duplicate-exports.d.ts

@@ -1,11 +1,13 @@
 import type { MonographDb } from '../storage/db.js';
+export interface DuplicateExportLocation {
+    nodeId: string;
+    filePath: string | null;
+    startLine: number | null;
+    label: string;
+}
 export interface DuplicateExportGroup {
     exportName: string;
-    locations: Array<{
-        nodeId: string;
-        filePath: string | null;
-        label: string;
-    }>;
+    locations: DuplicateExportLocation[];
     count: number;
 }
 export interface DuplicateExportsResult {
@@ -14,4 +16,6 @@ export interface DuplicateExportsResult {
     affectedFiles: number;
 }
 export declare function detectDuplicateExports(db: MonographDb): DuplicateExportsResult;
+/** Format DuplicateExportsResult as structured text with file:line hints for LLM navigation. */
+export declare function formatDuplicateExports(result: DuplicateExportsResult): string;
 //# sourceMappingURL=duplicate-exports.d.ts.map

package/dist/src/analysis/duplicate-exports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"duplicate-exports.d.ts","sourceRoot":"","sources":["../../../src/analysis/duplicate-exports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7E,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB;AAYD,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,WAAW,GAAG,sBAAsB,CAiD9E"}
+{"version":3,"file":"duplicate-exports.d.ts","sourceRoot":"","sources":["../../../src/analysis/duplicate-exports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,uBAAuB,EAAE,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB;AAaD,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,WAAW,GAAG,sBAAsB,CAiD9E;AAED,gGAAgG;AAChG,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAyB7E"}

package/dist/src/analysis/duplicate-exports.js

@@ -1,7 +1,7 @@
 /** Generic names that are too common to be meaningful duplicates. */
 const GENERIC_NAMES = new Set(['default', 'index', 'module']);
 export function detectDuplicateExports(db) {
-    const rows = db.prepare(`SELECT id, name, file_path, label
+    const rows = db.prepare(`SELECT id, name, file_path, start_line, label
      FROM nodes
      WHERE is_exported = 1
        AND label IN ('Function','Class','Method','Interface','Const','TypeAlias','Enum','Variable')`).all();
@@ -16,7 +16,7 @@ export function detectDuplicateExports(db) {
             list = [];
             groups.set(normalized, list);
         }
-        list.push({ nodeId: row.id, filePath: row.file_path, label: row.label });
+        list.push({ nodeId: row.id, filePath: row.file_path, startLine: row.start_line ?? null, label: row.label });
     }
     // Filter to duplicates only (count > 1)
     const duplicateGroups = [];
@@ -42,4 +42,28 @@ export function detectDuplicateExports(db) {
         affectedFiles: affectedFileSet.size,
     };
 }
+/** Format DuplicateExportsResult as structured text with file:line hints for LLM navigation. */
+export function formatDuplicateExports(result) {
+    if (result.totalDuplicates === 0) {
+        return 'Duplicate exports: none detected.';
+    }
+    const lines = [
+        `Duplicate exports: ${result.totalDuplicates} name(s) exported from multiple files (${result.affectedFiles} file(s) affected).`,
+        '',
+    ];
+    for (const group of result.groups) {
+        lines.push(`  ${group.exportName} (${group.count} locations):`);
+        for (const loc of group.locations) {
+            const ref = loc.filePath
+                ? loc.startLine != null
+                    ? `${loc.filePath}:${loc.startLine}`
+                    : loc.filePath
+                : '(unknown)';
+            lines.push(`    ${loc.label}  ${ref}`);
+        }
+    }
+    lines.push('');
+    lines.push('Fix: consolidate duplicate exports into a single canonical location or rename to avoid conflicts.');
+    return lines.join('\n').trimEnd();
+}
 //# sourceMappingURL=duplicate-exports.js.map

package/dist/src/analysis/duplicate-exports.js.map

@@ -1 +1 @@
-{"version":3,"file":"duplicate-exports.js","sourceRoot":"","sources":["../../../src/analysis/duplicate-exports.ts"],"names":[],"mappings":"AAqBA,qEAAqE;AACrE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE9D,MAAM,UAAU,sBAAsB,CAAC,EAAe;IACpD,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CACrB;;;oGAGgG,CACjG,CAAC,GAAG,EAAmB,CAAC;IAEzB,2BAA2B;IAC3B,MAAM,MAAM,GAAG,IAAI,GAAG,EAA6E,CAAC;IAEpG,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QACjD,IAAI,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,SAAS;QAE5C,IAAI,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,EAAE,CAAC;YACV,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,wCAAwC;IACxC,MAAM,eAAe,GAA2B,EAAE,CAAC;IACnD,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAE1C,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,MAAM,EAAE,CAAC;QACvC,IAAI,SAAS,CAAC,MAAM,IAAI,CAAC;YAAE,SAAS;QAEpC,eAAe,CAAC,IAAI,CAAC;YACnB,UAAU,EAAE,IAAI;YAChB,SAAS;YACT,KAAK,EAAE,SAAS,CAAC,MAAM;SACxB,CAAC,CAAC;QAEH,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC5B,IAAI,GAAG,CAAC,QAAQ;gBAAE,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAElD,OAAO;QACL,MAAM,EAAE,eAAe;QACvB,eAAe,EAAE,eAAe,CAAC,MAAM;QACvC,aAAa,EAAE,eAAe,CAAC,IAAI;KACpC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"duplicate-exports.js","sourceRoot":"","sources":["../../../src/analysis/duplicate-exports.ts"],"names":[],"mappings":"AA6BA,qEAAqE;AACrE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE9D,MAAM,UAAU,sBAAsB,CAAC,EAAe;IACpD,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CACrB;;;oGAGgG,CACjG,CAAC,GAAG,EAAmB,CAAC;IAEzB,2BAA2B;IAC3B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAqC,CAAC;IAE5D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QACjD,IAAI,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,SAAS;QAE5C,IAAI,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,EAAE,CAAC;YACV,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9G,CAAC;IAED,wCAAwC;IACxC,MAAM,eAAe,GAA2B,EAAE,CAAC;IACnD,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAE1C,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,MAAM,EAAE,CAAC;QACvC,IAAI,SAAS,CAAC,MAAM,IAAI,CAAC;YAAE,SAAS;QAEpC,eAAe,CAAC,IAAI,CAAC;YACnB,UAAU,EAAE,IAAI;YAChB,SAAS;YACT,KAAK,EAAE,SAAS,CAAC,MAAM;SACxB,CAAC,CAAC;QAEH,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC5B,IAAI,GAAG,CAAC,QAAQ;gBAAE,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAElD,OAAO;QACL,MAAM,EAAE,eAAe;QACvB,eAAe,EAAE,eAAe,CAAC,MAAM;QACvC,aAAa,EAAE,eAAe,CAAC,IAAI;KACpC,CAAC;AACJ,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,sBAAsB,CAAC,MAA8B;IACnE,IAAI,MAAM,CAAC,eAAe,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,mCAAmC,CAAC;IAC7C,CAAC;IAED,MAAM,KAAK,GAAa;QACtB,sBAAsB,MAAM,CAAC,eAAe,0CAA0C,MAAM,CAAC,aAAa,qBAAqB;QAC/H,EAAE;KACH,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,UAAU,KAAK,KAAK,CAAC,KAAK,cAAc,CAAC,CAAC;QAChE,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YAClC,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ;gBACtB,CAAC,CAAC,GAAG,CAAC,SAAS,IAAI,IAAI;oBACrB,CAAC,CAAC,GAAG,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,SAAS,EAAE;oBACpC,CAAC,CAAC,GAAG,CAAC,QAAQ;gBAChB,CAAC,CAAC,WAAW,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,KAAK,KAAK,GAAG,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,mGAAmG,CAAC,CAAC;IAChH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACpC,CAAC"}

package/dist/src/analysis/feature-flags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../../src/analysis/feature-flags.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,QAAQ,GAAG,qBAAqB,GAAG,SAAS,GAAG,cAAc,CAAC;AAC1E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,cAAc,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,eAAO,MAAM,oBAAoB,EAAE,WAWlC,CAAC;AA0FF,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,WAAkC,GACzC,WAAW,EAAE,CAaf;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,WAAW,EAAE,EACpB,WAAW,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACnE,WAAW,EAAE,CAUf;AAeD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,YAAY,CAiBjE"}
+{"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../../src/analysis/feature-flags.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,QAAQ,GAAG,qBAAqB,GAAG,SAAS,GAAG,cAAc,CAAC;AAC1E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,cAAc,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,eAAO,MAAM,oBAAoB,EAAE,WAWlC,CAAC;AA0FF,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,WAAkC,GACzC,WAAW,EAAE,CAaf;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,WAAW,EAAE,EACpB,WAAW,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACnE,WAAW,EAAE,CAuBf;AAeD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,YAAY,CAwBjE"}

package/dist/src/analysis/feature-flags.js

@@ -114,13 +114,26 @@ export function analyzeFeatureFlags(rootDir, config = DEFAULT_FLAGS_CONFIG) {
     return flags;
 }
 export function crossReferenceWithDeadCode(flags, deadExports) {
+    // Pregroup dead exports by filePath to avoid O(F*D) nested scan
+    const deadByFile = new Map();
+    for (const e of deadExports) {
+        let arr = deadByFile.get(e.filePath);
+        if (!arr) {
+            arr = [];
+            deadByFile.set(e.filePath, arr);
+        }
+        arr.push({ name: e.name, line: e.line });
+    }
     return flags.map(flag => {
         if (flag.guardLineStart == null || flag.guardLineEnd == null)
             return flag;
-        const guarded = deadExports
-            .filter(e => e.filePath === flag.filePath &&
-            e.line >= (flag.guardLineStart ?? 0) &&
-            e.line <= (flag.guardLineEnd ?? Infinity))
+        const fileDeads = deadByFile.get(flag.filePath);
+        if (!fileDeads)
+            return flag;
+        const start = flag.guardLineStart ?? 0;
+        const end = flag.guardLineEnd ?? Infinity;
+        const guarded = fileDeads
+            .filter(e => e.line >= start && e.line <= end)
             .map(e => e.name);
         return guarded.length > 0 ? { ...flag, guardedDeadExports: guarded } : flag;
     });
@@ -151,21 +164,27 @@ function walkDir(dir, fn) {
     }
 }
 export function summarizeFlags(flags) {
+    // Single pass over flags instead of 7 separate filter/map passes
+    const byKind = { EnvironmentVariable: 0, SdkCall: 0, ConfigObject: 0 };
+    const byConfidence = { High: 0, Medium: 0, Low: 0 };
+    const flagNames = new Set();
+    const filePaths = new Set();
+    let deadCodeOverlaps = 0;
+    for (const f of flags) {
+        byKind[f.kind]++;
+        byConfidence[f.confidence]++;
+        flagNames.add(f.flagName);
+        filePaths.add(f.filePath);
+        if ((f.guardedDeadExports?.length ?? 0) > 0)
+            deadCodeOverlaps++;
+    }
     return {
         totalFlags: flags.length,
-        byKind: {
-            EnvironmentVariable: flags.filter(f => f.kind === 'EnvironmentVariable').length,
-            SdkCall: flags.filter(f => f.kind === 'SdkCall').length,
-            ConfigObject: flags.filter(f => f.kind === 'ConfigObject').length,
-        },
-        byConfidence: {
-            High: flags.filter(f => f.confidence === 'High').length,
-            Medium: flags.filter(f => f.confidence === 'Medium').length,
-            Low: flags.filter(f => f.confidence === 'Low').length,
-        },
-        uniqueFlagNames: new Set(flags.map(f => f.flagName)).size,
-        filesWithFlags: new Set(flags.map(f => f.filePath)).size,
-        deadCodeOverlaps: flags.filter(f => (f.guardedDeadExports?.length ?? 0) > 0).length,
+        byKind,
+        byConfidence,
+        uniqueFlagNames: flagNames.size,
+        filesWithFlags: filePaths.size,
+        deadCodeOverlaps,
     };
 }
 //# sourceMappingURL=feature-flags.js.map

package/dist/src/analysis/feature-flags.js.map

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

package/dist/src/analysis/node-similarity.d.ts

@@ -17,6 +17,8 @@ export interface SimilarNode {
 }
 /**
  * Build an undirected neighbor map from an edge list.
+ * Callers that invoke findSimilarNodes for multiple nodes on the same edge set
+ * should build once and pass the map directly to findSimilarNodesFromMap.
  */
 export declare function buildNeighborMap(edges: SimilarityEdge[]): Map<string, Set<string>>;
 /**
@@ -24,11 +26,28 @@ export declare function buildNeighborMap(edges: SimilarityEdge[]): Map<string, S
  * Returns 0 when both sets are empty.
  */
 export declare function jaccardSimilarity(a: Set<string>, b: Set<string>): number;
+/**
+ * Find the k most similar nodes to `nodeId` using a pre-built neighbor map.
+ *
+ * Use this variant when querying multiple nodes against the same edge set —
+ * build the map once with `buildNeighborMap` and reuse it across calls.
+ *
+ * Only nodes with score > 0 are returned (no shared neighbors → excluded).
+ * Results are sorted descending by score.
+ */
+export declare function findSimilarNodesFromMap(nodeId: string, neighborMap: Map<string, Set<string>>, k: number): SimilarNode[];
 /**
  * Find the k most similar nodes to `nodeId` by Jaccard neighbor overlap.
  *
+ * Builds the neighbor map from `edges` on each call. For repeated queries
+ * over the same edge set, prefer `buildNeighborMap` + `findSimilarNodesFromMap`.
+ *
  * Only nodes with score > 0 are returned (no shared neighbors → excluded).
  * Results are sorted descending by score.
  */
 export declare function findSimilarNodes(nodeId: string, edges: SimilarityEdge[], k: number): SimilarNode[];
+/**
+ * Format similar-node results as structured text for LLM consumption.
+ */
+export declare function formatSimilarNodes(nodeId: string, results: SimilarNode[], nodeLabels?: Map<string, string>): string;
 //# sourceMappingURL=node-similarity.d.ts.map

package/dist/src/analysis/node-similarity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-similarity.d.ts","sourceRoot":"","sources":["../../../src/analysis/node-similarity.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,cAAc,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,cAAc,EAAE,GACtB,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAS1B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAQxE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,cAAc,EAAE,EACvB,CAAC,EAAE,MAAM,GACR,WAAW,EAAE,CAgBf"}
+{"version":3,"file":"node-similarity.d.ts","sourceRoot":"","sources":["../../../src/analysis/node-similarity.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,cAAc,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,cAAc,EAAE,GACtB,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAS1B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAQxE;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EACrC,CAAC,EAAE,MAAM,GACR,WAAW,EAAE,CAef;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,cAAc,EAAE,EACvB,CAAC,EAAE,MAAM,GACR,WAAW,EAAE,CAEf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,WAAW,EAAE,EACtB,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,CAWR"}

package/dist/src/analysis/node-similarity.js

@@ -9,6 +9,8 @@
  */
 /**
  * Build an undirected neighbor map from an edge list.
+ * Callers that invoke findSimilarNodes for multiple nodes on the same edge set
+ * should build once and pass the map directly to findSimilarNodesFromMap.
  */
 export function buildNeighborMap(edges) {
     const neighbors = new Map();
@@ -38,13 +40,15 @@ export function jaccardSimilarity(a, b) {
     return union === 0 ? 0 : intersection / union;
 }
 /**
- * Find the k most similar nodes to `nodeId` by Jaccard neighbor overlap.
+ * Find the k most similar nodes to `nodeId` using a pre-built neighbor map.
+ *
+ * Use this variant when querying multiple nodes against the same edge set —
+ * build the map once with `buildNeighborMap` and reuse it across calls.
  *
  * Only nodes with score > 0 are returned (no shared neighbors → excluded).
  * Results are sorted descending by score.
  */
-export function findSimilarNodes(nodeId, edges, k) {
-    const neighborMap = buildNeighborMap(edges);
+export function findSimilarNodesFromMap(nodeId, neighborMap, k) {
     const targetNeighbors = neighborMap.get(nodeId);
     if (!targetNeighbors || targetNeighbors.size === 0)
         return [];
@@ -60,4 +64,31 @@ export function findSimilarNodes(nodeId, edges, k) {
     results.sort((a, b) => b.score - a.score);
     return results.slice(0, k);
 }
+/**
+ * Find the k most similar nodes to `nodeId` by Jaccard neighbor overlap.
+ *
+ * Builds the neighbor map from `edges` on each call. For repeated queries
+ * over the same edge set, prefer `buildNeighborMap` + `findSimilarNodesFromMap`.
+ *
+ * Only nodes with score > 0 are returned (no shared neighbors → excluded).
+ * Results are sorted descending by score.
+ */
+export function findSimilarNodes(nodeId, edges, k) {
+    return findSimilarNodesFromMap(nodeId, buildNeighborMap(edges), k);
+}
+/**
+ * Format similar-node results as structured text for LLM consumption.
+ */
+export function formatSimilarNodes(nodeId, results, nodeLabels) {
+    if (results.length === 0) {
+        return `No structurally similar nodes found for: ${nodeId}`;
+    }
+    const lines = [`Similar nodes to ${nodeId} (Jaccard neighbor overlap):`];
+    for (const { nodeId: id, score } of results) {
+        const label = nodeLabels?.get(id);
+        const suffix = label ? ` [${label}]` : '';
+        lines.push(`  ${(score * 100).toFixed(1)}%  ${id}${suffix}`);
+    }
+    return lines.join('\n');
+}
 //# sourceMappingURL=node-similarity.js.map

package/dist/src/analysis/node-similarity.js.map

@@ -1 +1 @@
-{"version":3,"file":"node-similarity.js","sourceRoot":"","sources":["../../../src/analysis/node-similarity.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAuB;IAEvB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAuB,CAAC;IACjD,KAAK,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,KAAK,EAAE,CAAC;QAC3C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACjE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACjE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACvC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,CAAc,EAAE,CAAc;IAC9D,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,YAAY,EAAE,CAAC;IAClC,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,YAAY,CAAC;IAC7C,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,GAAG,KAAK,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAc,EACd,KAAuB,EACvB,CAAS;IAET,MAAM,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,CAAC,eAAe,IAAI,eAAe,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAE9D,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,KAAK,MAAM,CAAC,SAAS,EAAE,kBAAkB,CAAC,IAAI,WAAW,EAAE,CAAC;QAC1D,IAAI,SAAS,KAAK,MAAM;YAAE,SAAS;QACnC,MAAM,KAAK,GAAG,iBAAiB,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC;QACrE,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAC1C,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"node-similarity.js","sourceRoot":"","sources":["../../../src/analysis/node-similarity.ts"],"names":[],"mappings":"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"}

package/dist/src/analysis/private-type-leaks.d.ts

@@ -3,9 +3,11 @@ export interface PrivateTypeLeak {
     exportNodeId: string;
     exportName: string;
     exportFilePath: string | null;
+    exportStartLine: number | null;
     leakedTypeNodeId: string;
     leakedTypeName: string;
     leakedTypeFilePath: string | null;
+    leakedTypeStartLine: number | null;
     reason: string;
 }
 export interface PrivateTypeLeaksResult {
@@ -14,4 +16,6 @@ export interface PrivateTypeLeaksResult {
     affectedExports: number;
 }
 export declare function detectPrivateTypeLeaks(db: MonographDb): PrivateTypeLeaksResult;
+/** Format PrivateTypeLeaksResult as structured text with file:line hints for LLM navigation. */
+export declare function formatPrivateTypeLeaks(result: PrivateTypeLeaksResult): string;
 //# sourceMappingURL=private-type-leaks.d.ts.map

package/dist/src/analysis/private-type-leaks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"private-type-leaks.d.ts","sourceRoot":"","sources":["../../../src/analysis/private-type-leaks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAWD,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,WAAW,GAAG,sBAAsB,CA4C9E"}
+{"version":3,"file":"private-type-leaks.d.ts","sourceRoot":"","sources":["../../../src/analysis/private-type-leaks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAaD,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,WAAW,GAAG,sBAAsB,CA+C9E;AAED,gGAAgG;AAChG,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAqC7E"}

package/dist/src/analysis/private-type-leaks.js

@@ -1,7 +1,8 @@
 export function detectPrivateTypeLeaks(db) {
     const rows = db.prepare(`
-    SELECT e.source_id, e.target_id, n1.name as src_name, n1.file_path as src_path,
-           n2.name as tgt_name, n2.file_path as tgt_path
+    SELECT e.source_id, e.target_id,
+           n1.name as src_name, n1.file_path as src_path, n1.start_line as src_line,
+           n2.name as tgt_name, n2.file_path as tgt_path, n2.start_line as tgt_line
     FROM edges e
     JOIN nodes n1 ON n1.id = e.source_id
     JOIN nodes n2 ON n2.id = e.target_id
@@ -27,9 +28,11 @@ export function detectPrivateTypeLeaks(db) {
             exportNodeId: row.source_id,
             exportName: row.src_name,
             exportFilePath: row.src_path,
+            exportStartLine: row.src_line ?? null,
             leakedTypeNodeId: row.target_id,
             leakedTypeName: row.tgt_name,
             leakedTypeFilePath: row.tgt_path,
+            leakedTypeStartLine: row.tgt_line ?? null,
             reason: `Exported symbol ${row.src_name} references non-exported ${row.tgt_name} from another community`,
         });
     }
@@ -39,4 +42,42 @@ export function detectPrivateTypeLeaks(db) {
         affectedExports: affectedExportIds.size,
     };
 }
+/** Format PrivateTypeLeaksResult as structured text with file:line hints for LLM navigation. */
+export function formatPrivateTypeLeaks(result) {
+    if (result.totalLeaks === 0) {
+        return 'Private type leaks: none detected.';
+    }
+    const lines = [
+        `Private type leaks: ${result.totalLeaks} leak(s) across ${result.affectedExports} exported symbol(s).`,
+        '',
+    ];
+    // Group leaks by exporting file for compact display
+    const byFile = new Map();
+    for (const leak of result.leaks) {
+        const key = leak.exportFilePath ?? '(unknown)';
+        let group = byFile.get(key);
+        if (!group) {
+            group = [];
+            byFile.set(key, group);
+        }
+        group.push(leak);
+    }
+    for (const [filePath, fileLeaks] of byFile) {
+        lines.push(`File: ${filePath}`);
+        for (const leak of fileLeaks) {
+            const exportRef = leak.exportStartLine != null
+                ? `${filePath}:${leak.exportStartLine}`
+                : filePath;
+            const leakRef = leak.leakedTypeFilePath
+                ? leak.leakedTypeStartLine != null
+                    ? `${leak.leakedTypeFilePath}:${leak.leakedTypeStartLine}`
+                    : leak.leakedTypeFilePath
+                : '(unknown)';
+            lines.push(`  ${leak.exportName} (${exportRef}) → leaks ${leak.leakedTypeName} (${leakRef})`);
+        }
+        lines.push('');
+    }
+    lines.push(`Fix: make leaked types public, move them to a shared module, or restructure community boundaries.`);
+    return lines.join('\n').trimEnd();
+}
 //# sourceMappingURL=private-type-leaks.js.map

package/dist/src/analysis/private-type-leaks.js.map

@@ -1 +1 @@
-{"version":3,"file":"private-type-leaks.js","sourceRoot":"","sources":["../../../src/analysis/private-type-leaks.ts"],"names":[],"mappings":"AA2BA,MAAM,UAAU,sBAAsB,CAAC,EAAe;IACpD,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;;;;;;;;;GAavB,CAAC,CAAC,GAAG,EAAe,CAAC;IAEtB,6CAA6C;IAC7C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,KAAK,GAAsB,EAAE,CAAC;IACpC,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;IAE5C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAChD,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEd,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAErC,KAAK,CAAC,IAAI,CAAC;YACT,YAAY,EAAE,GAAG,CAAC,SAAS;YAC3B,UAAU,EAAE,GAAG,CAAC,QAAQ;YACxB,cAAc,EAAE,GAAG,CAAC,QAAQ;YAC5B,gBAAgB,EAAE,GAAG,CAAC,SAAS;YAC/B,cAAc,EAAE,GAAG,CAAC,QAAQ;YAC5B,kBAAkB,EAAE,GAAG,CAAC,QAAQ;YAChC,MAAM,EAAE,mBAAmB,GAAG,CAAC,QAAQ,4BAA4B,GAAG,CAAC,QAAQ,yBAAyB;SACzG,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,KAAK;QACL,UAAU,EAAE,KAAK,CAAC,MAAM;QACxB,eAAe,EAAE,iBAAiB,CAAC,IAAI;KACxC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"private-type-leaks.js","sourceRoot":"","sources":["../../../src/analysis/private-type-leaks.ts"],"names":[],"mappings":"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"}

package/dist/src/analysis/project-state.d.ts

@@ -12,6 +12,8 @@ export interface WorkspaceEntry {
 export interface ProjectState {
     files: ProjectFile[];
     pathToId: Map<string, number>;
+    /** O(1) lookup by numeric fileId */
+    idToFile: Map<number, ProjectFile>;
     workspaces: WorkspaceEntry[];
 }
 export declare function makeProjectState(files: ProjectFile[], workspaces: WorkspaceEntry[]): ProjectState;

package/dist/src/analysis/project-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-state.d.ts","sourceRoot":"","sources":["../../../src/analysis/project-state.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,YAAY,CAGjG;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAErF;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAgBhG;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,GAAG,WAAW,EAAE,CAM9F;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAwC;gBAE3C,UAAU,EAAE,cAAc,EAAE;IAOxC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAWpD,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGrD"}
+{"version":3,"file":"project-state.d.ts","sourceRoot":"","sources":["../../../src/analysis/project-state.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,oCAAoC;IACpC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACnC,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,YAAY,CASjG;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGrF;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAgBhG;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,GAAG,WAAW,EAAE,CAM9F;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAwC;gBAE3C,UAAU,EAAE,cAAc,EAAE;IAUxC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAWpD,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGrD"}

package/dist/src/analysis/project-state.js

@@ -1,9 +1,16 @@
 export function makeProjectState(files, workspaces) {
-    const pathToId = new Map(files.map(f => [f.path, f.fileId]));
-    return { files, pathToId, workspaces };
+    // Build both lookup maps in a single pass to avoid intermediate arrays
+    const pathToId = new Map();
+    const idToFile = new Map();
+    for (const f of files) {
+        pathToId.set(f.path, f.fileId);
+        idToFile.set(f.fileId, f);
+    }
+    return { files, pathToId, idToFile, workspaces };
 }
 export function fileById(state, fileId) {
-    return state.files.find(f => f.fileId === fileId);
+    // O(1) lookup via idToFile map instead of O(N) linear scan
+    return state.idToFile.get(fileId);
 }
 export function idForPath(state, filePath) {
     return state.pathToId.get(filePath);
@@ -36,10 +43,14 @@ export function filesInWorkspace(state, workspace) {
 export class PackageResolver {
     entries;
     constructor(workspaces) {
-        this.entries = workspaces
-            .filter(w => w.name)
-            .map(w => ({ root: w.root, name: w.name }))
-            .sort((a, b) => b.root.length - a.root.length);
+        // Combine filter + map into a single for-of loop to avoid 2 intermediate arrays
+        const named = [];
+        for (const w of workspaces) {
+            if (w.name)
+                named.push({ root: w.root, name: w.name });
+        }
+        named.sort((a, b) => b.root.length - a.root.length);
+        this.entries = named;
     }
     resolvePackage(filePath) {
         const normalized = filePath.replace(/\\/g, '/');