@aiready/context-analyzer 0.9.4 → 0.9.6

package/dist/__tests__/fragmentation-coupling.test.js

@@ -0,0 +1,52 @@
+import { describe, it, expect } from 'vitest';
+import { buildDependencyGraph, detectModuleClusters, calculateFragmentation, } from '../analyzer';
+describe('fragmentation coupling discount', () => {
+    it('does not apply discount when files have no shared imports', () => {
+        const files = [
+            {
+                file: 'src/billing/a.ts',
+                content: `export const getBillingA = 1;`,
+            },
+            {
+                file: 'src/api/billing/b.ts',
+                content: `export const getBillingB = 2;`,
+            },
+            {
+                file: 'lib/billing/c.ts',
+                content: `export const getBillingC = 3;`,
+            },
+        ];
+        const graph = buildDependencyGraph(files);
+        const clusters = detectModuleClusters(graph);
+        const cluster = clusters.find((c) => c.domain === 'billing');
+        expect(cluster).toBeDefined();
+        const base = calculateFragmentation(files.map(f => f.file), 'billing');
+        // With no import similarity the coupling discount should be 0 -> fragmentation unchanged
+        expect(cluster.fragmentationScore).toBeCloseTo(base, 6);
+    });
+    it('applies up-to-20% discount when files share identical imports', () => {
+        const files = [
+            {
+                file: 'src/billing/a.ts',
+                content: `import { shared } from 'shared/module';\nexport const getBillingA = 1;`,
+            },
+            {
+                file: 'src/api/billing/b.ts',
+                content: `import { shared } from 'shared/module';\nexport const getBillingB = 2;`,
+            },
+            {
+                file: 'lib/billing/c.ts',
+                content: `import { shared } from 'shared/module';\nexport const getBillingC = 3;`,
+            },
+        ];
+        const graph = buildDependencyGraph(files);
+        const clusters = detectModuleClusters(graph);
+        const cluster = clusters.find((c) => c.domain === 'billing');
+        expect(cluster).toBeDefined();
+        const base = calculateFragmentation(files.map(f => f.file), 'billing');
+        const expected = base * 0.8; // full cohesion => 20% discount
+        // Allow small FP tolerance
+        expect(cluster.fragmentationScore).toBeCloseTo(expected, 6);
+    });
+});
+//# sourceMappingURL=fragmentation-coupling.test.js.map

package/dist/__tests__/fragmentation-coupling.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragmentation-coupling.test.js","sourceRoot":"","sources":["../../src/__tests__/fragmentation-coupling.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAErB,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,KAAK,GAAG;YACZ;gBACE,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,+BAA+B;aACzC;YACD;gBACE,IAAI,EAAE,sBAAsB;gBAC5B,OAAO,EAAE,+BAA+B;aACzC;YACD;gBACE,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,+BAA+B;aACzC;SACF,CAAC;QAEF,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;QAC7D,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QAE9B,MAAM,IAAI,GAAG,sBAAsB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;QACvE,yFAAyF;QACzF,MAAM,CAAC,OAAQ,CAAC,kBAAkB,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,KAAK,GAAG;YACZ;gBACE,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,wEAAwE;aAClF;YACD;gBACE,IAAI,EAAE,sBAAsB;gBAC5B,OAAO,EAAE,wEAAwE;aAClF;YACD;gBACE,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,wEAAwE;aAClF;SACF,CAAC;QAEF,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;QAC7D,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QAE9B,MAAM,IAAI,GAAG,sBAAsB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;QACvE,MAAM,QAAQ,GAAG,IAAI,GAAG,GAAG,CAAC,CAAC,gCAAgC;QAE7D,2BAA2B;QAC3B,MAAM,CAAC,OAAQ,CAAC,kBAAkB,CAAC,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/fragmentation-log.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fragmentation-log.test.d.ts.map

package/dist/__tests__/fragmentation-log.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragmentation-log.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/fragmentation-log.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/fragmentation-log.test.js

@@ -0,0 +1,33 @@
+import { describe, it, expect } from 'vitest';
+import { calculateFragmentation } from '../analyzer';
+describe('calculateFragmentation (log scale option)', () => {
+    it('returns 0 for single file regardless of option', () => {
+        const files = ['src/user/user.ts'];
+        expect(calculateFragmentation(files, 'user')).toBe(0);
+        expect(calculateFragmentation(files, 'user', { useLogScale: true })).toBe(0);
+    });
+    it('matches linear formula when not using log scale', () => {
+        const files = [
+            'a/one.ts',
+            'b/two.ts',
+            'c/three.ts',
+            'd/four.ts',
+        ];
+        const uniqueDirs = 4;
+        const linear = (uniqueDirs - 1) / (files.length - 1);
+        expect(calculateFragmentation(files, 'domain')).toBeCloseTo(linear);
+    });
+    it('computes normalized log-based fragmentation when requested', () => {
+        const files = [
+            'src/group/a.ts',
+            'src/group/b.ts',
+            'src/group/c.ts',
+            'lib/other/d.ts',
+            'tools/x/e.ts',
+        ];
+        const dirs = new Set(files.map((f) => f.split('/').slice(0, -1).join('/'))).size;
+        const expected = Math.log(dirs) / Math.log(files.length);
+        expect(calculateFragmentation(files, 'domain', { useLogScale: true })).toBeCloseTo(expected, 6);
+    });
+});
+//# sourceMappingURL=fragmentation-log.test.js.map

package/dist/__tests__/fragmentation-log.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragmentation-log.test.js","sourceRoot":"","sources":["../../src/__tests__/fragmentation-log.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,QAAQ,CAAC,2CAA2C,EAAE,GAAG,EAAE;IACzD,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,KAAK,GAAG,CAAC,kBAAkB,CAAC,CAAC;QACnC,MAAM,CAAC,sBAAsB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtD,MAAM,CAAC,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,KAAK,GAAG;YACZ,UAAU;YACV,UAAU;YACV,YAAY;YACZ,WAAW;SACZ,CAAC;QAEF,MAAM,UAAU,GAAG,CAAC,CAAC;QACrB,MAAM,MAAM,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACrD,MAAM,CAAC,sBAAsB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,KAAK,GAAG;YACZ,gBAAgB;YAChB,gBAAgB;YAChB,gBAAgB;YAChB,gBAAgB;YAChB,cAAc;SACf,CAAC;QAEF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACjF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAEzD,MAAM,CAAC,sBAAsB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAClG,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/scoring.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scoring.test.d.ts.map

package/dist/__tests__/scoring.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/scoring.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/scoring.test.js

@@ -0,0 +1,118 @@
+import { describe, it, expect } from 'vitest';
+import { calculateContextScore } from '../scoring';
+describe('Context Scoring', () => {
+    describe('calculateContextScore', () => {
+        it('should return perfect score for ideal metrics', () => {
+            const summary = {
+                avgContextBudget: 3000, // < 5000
+                maxContextBudget: 4000,
+                avgImportDepth: 3, // < 5
+                maxImportDepth: 4,
+                avgFragmentation: 0.2, // < 0.3
+                criticalIssues: 0,
+                majorIssues: 0,
+                minorIssues: 0,
+            };
+            const result = calculateContextScore(summary);
+            expect(result.score).toBeGreaterThanOrEqual(90);
+            expect(result.toolName).toBe('context-analyzer');
+            expect(result.recommendations).toHaveLength(0);
+        });
+        it('should penalize high context budget', () => {
+            const summary = {
+                avgContextBudget: 15000, // High
+                maxContextBudget: 20000,
+                avgImportDepth: 3,
+                maxImportDepth: 5,
+                avgFragmentation: 0.2,
+                criticalIssues: 0,
+                majorIssues: 0,
+                minorIssues: 0,
+            };
+            const result = calculateContextScore(summary);
+            expect(result.score).toBeLessThan(70);
+            expect(result.factors.some(f => f.name === 'Context Budget')).toBe(true);
+            expect(result.recommendations.length).toBeGreaterThan(0);
+        });
+        it('should penalize deep import chains', () => {
+            const summary = {
+                avgContextBudget: 4000,
+                maxContextBudget: 5000,
+                avgImportDepth: 12, // Deep
+                maxImportDepth: 15,
+                avgFragmentation: 0.2,
+                criticalIssues: 0,
+                majorIssues: 0,
+                minorIssues: 0,
+            };
+            const result = calculateContextScore(summary);
+            // With depth=12: depthScore=30, rawScore=(100*0.4)+(30*0.3)+(100*0.3)=79
+            expect(result.score).toBe(79);
+            expect(result.factors.some(f => f.name === 'Import Depth')).toBe(true);
+            expect(result.recommendations.some(r => r.action.includes('import chains'))).toBe(true);
+        });
+        it('should penalize high fragmentation', () => {
+            const summary = {
+                avgContextBudget: 4000,
+                maxContextBudget: 5000,
+                avgImportDepth: 3,
+                maxImportDepth: 5,
+                avgFragmentation: 0.7, // High fragmentation
+                criticalIssues: 0,
+                majorIssues: 0,
+                minorIssues: 0,
+            };
+            const result = calculateContextScore(summary);
+            expect(result.score).toBeLessThan(80); // Adjusted threshold
+            expect(result.factors.some(f => f.name === 'Fragmentation')).toBe(true);
+        });
+        it('should apply critical issue penalties', () => {
+            const summary = {
+                avgContextBudget: 4000,
+                maxContextBudget: 5000,
+                avgImportDepth: 3,
+                maxImportDepth: 5,
+                avgFragmentation: 0.2,
+                criticalIssues: 5, // Critical issues present
+                majorIssues: 0,
+                minorIssues: 0,
+            };
+            const result = calculateContextScore(summary);
+            // Perfect subscores=100, minus 5*10=50 critical penalty = 50
+            expect(result.score).toBe(50);
+            expect(result.factors.some(f => f.name === 'Critical Issues')).toBe(true);
+        });
+        it('should handle extreme max budget penalty', () => {
+            const summary = {
+                avgContextBudget: 4000,
+                maxContextBudget: 25000, // Extreme single file
+                avgImportDepth: 3,
+                maxImportDepth: 5,
+                avgFragmentation: 0.2,
+                criticalIssues: 0,
+                majorIssues: 0,
+                minorIssues: 0,
+            };
+            const result = calculateContextScore(summary);
+            expect(result.factors.some(f => f.name === 'Extreme File Detected')).toBe(true);
+            expect(result.recommendations.some(r => r.action.includes('Split large file'))).toBe(true);
+        });
+        it('should combine multiple penalties correctly', () => {
+            const summary = {
+                avgContextBudget: 12000, // High
+                maxContextBudget: 15000,
+                avgImportDepth: 10, // Deep
+                maxImportDepth: 12,
+                avgFragmentation: 0.6, // High
+                criticalIssues: 2,
+                majorIssues: 5,
+                minorIssues: 10,
+            };
+            const result = calculateContextScore(summary);
+            expect(result.score).toBeLessThan(40);
+            expect(result.factors.length).toBeGreaterThan(3);
+            expect(result.recommendations.length).toBeGreaterThan(0);
+        });
+    });
+});
+//# sourceMappingURL=scoring.test.js.map

package/dist/__tests__/scoring.test.js.map

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

package/dist/__tests__/structural-cohesion.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=structural-cohesion.test.d.ts.map

package/dist/__tests__/structural-cohesion.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-cohesion.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/structural-cohesion.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/structural-cohesion.test.js

@@ -0,0 +1,29 @@
+import { describe, it, expect } from 'vitest';
+import { calculateStructuralCohesionFromCoUsage } from '../analyzer';
+describe('calculateStructuralCohesionFromCoUsage', () => {
+    it('returns 1 when no co-usage data present', () => {
+        const score = calculateStructuralCohesionFromCoUsage('missing', undefined);
+        expect(score).toBe(1);
+    });
+    it('returns 1 when co-usage only with a single file', () => {
+        const coUsage = new Map();
+        coUsage.set('a', new Map([['b', 10]]));
+        const score = calculateStructuralCohesionFromCoUsage('a', coUsage);
+        expect(score).toBe(1);
+    });
+    it('returns ~0 when co-usage is perfectly balanced across two files', () => {
+        const coUsage = new Map();
+        coUsage.set('a', new Map([['b', 5], ['c', 5]]));
+        const score = calculateStructuralCohesionFromCoUsage('a', coUsage);
+        // Balanced distribution => entropy == 1 (for 2 items) => cohesion ~= 0
+        expect(score).toBeCloseTo(0, 3);
+    });
+    it('returns intermediate value for skewed distribution', () => {
+        const coUsage = new Map();
+        coUsage.set('a', new Map([['b', 8], ['c', 2]]));
+        const score = calculateStructuralCohesionFromCoUsage('a', coUsage);
+        // Expected approx 0.279
+        expect(score).toBeCloseTo(0.279, 2);
+    });
+});
+//# sourceMappingURL=structural-cohesion.test.js.map

package/dist/__tests__/structural-cohesion.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-cohesion.test.js","sourceRoot":"","sources":["../../src/__tests__/structural-cohesion.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,sCAAsC,EAAE,MAAM,aAAa,CAAA;AAEpE,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE;IACtD,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,KAAK,GAAG,sCAAsC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;QAC1E,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACvB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA+B,CAAA;QACtD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;QACtC,MAAM,KAAK,GAAG,sCAAsC,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAClE,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACvB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,OAAO,GAAG,IAAI,GAAG,EAA+B,CAAA;QACtD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAC/C,MAAM,KAAK,GAAG,sCAAsC,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAClE,uEAAuE;QACvE,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACjC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,OAAO,GAAG,IAAI,GAAG,EAA+B,CAAA;QACtD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAC/C,MAAM,KAAK,GAAG,sCAAsC,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAClE,wBAAwB;QACxB,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/analyzer.d.ts

@@ -0,0 +1,100 @@
+import type { DependencyGraph, ExportInfo, ModuleCluster } from './types';
+interface FileContent {
+    file: string;
+    content: string;
+}
+/**
+ * Build a dependency graph from file contents
+ */
+export declare function buildDependencyGraph(files: FileContent[]): DependencyGraph;
+/**
+ * Calculate the maximum depth of import tree for a file
+ */
+export declare function calculateImportDepth(file: string, graph: DependencyGraph, visited?: Set<string>, depth?: number): number;
+/**
+ * Get all transitive dependencies for a file
+ */
+export declare function getTransitiveDependencies(file: string, graph: DependencyGraph, visited?: Set<string>): string[];
+/**
+ * Calculate total context budget (tokens needed to understand this file)
+ */
+export declare function calculateContextBudget(file: string, graph: DependencyGraph): number;
+/**
+ * Detect circular dependencies
+ */
+export declare function detectCircularDependencies(graph: DependencyGraph): string[][];
+/**
+ * Calculate cohesion score (how related are exports in a file)
+ * Uses enhanced calculation combining domain-based and import-based analysis
+ * @param exports - Array of export information
+ * @param filePath - Optional file path for context-aware scoring
+ */
+export declare function calculateCohesion(exports: ExportInfo[], filePath?: string, options?: {
+    coUsageMatrix?: Map<string, Map<string, number>>;
+    weights?: {
+        importBased?: number;
+        structural?: number;
+        domainBased?: number;
+    };
+}): number;
+/**
+ * Calculate fragmentation score (how scattered is a domain)
+ */
+export declare function calculateFragmentation(files: string[], domain: string, options?: {
+    useLogScale?: boolean;
+    logBase?: number;
+}): number;
+/**
+ * Calculate path entropy for a set of files.
+ * Returns a normalized entropy in [0,1], where 0 = all files in one directory,
+ * and 1 = files are evenly distributed across directories.
+ */
+export declare function calculatePathEntropy(files: string[]): number;
+/**
+ * Calculate directory-distance metric based on common ancestor depth.
+ * For each file pair compute depth(commonAncestor) and normalize by the
+ * maximum path depth between the two files. Returns value in [0,1] where
+ * 0 means all pairs share a deep common ancestor (low fragmentation) and
+ * 1 means they share only the root (high fragmentation).
+ */
+export declare function calculateDirectoryDistance(files: string[]): number;
+/**
+ * Group files by domain to detect module clusters
+ */
+export declare function detectModuleClusters(graph: DependencyGraph, options?: {
+    useLogScale?: boolean;
+}): ModuleCluster[];
+/**
+ * Extract exports using AST parsing (enhanced version)
+ * Falls back to regex if AST parsing fails
+ */
+export declare function extractExportsWithAST(content: string, filePath: string, domainOptions?: {
+    domainKeywords?: string[];
+}, fileImports?: string[]): ExportInfo[];
+/**
+ * Calculate enhanced cohesion score using both domain inference and import similarity
+ *
+ * This combines:
+ * 1. Domain-based cohesion (entropy of inferred domains)
+ * 2. Import-based cohesion (Jaccard similarity of shared imports)
+ *
+ * Weight: 60% import-based, 40% domain-based (import analysis is more reliable)
+ */
+export declare function calculateEnhancedCohesion(exports: ExportInfo[], filePath?: string, options?: {
+    coUsageMatrix?: Map<string, Map<string, number>>;
+    weights?: {
+        importBased?: number;
+        structural?: number;
+        domainBased?: number;
+    };
+}): number;
+/**
+ * Calculate structural cohesion for a file based on co-usage patterns.
+ * Uses the co-usage distribution (files commonly imported alongside this file)
+ * and computes an entropy-based cohesion score in [0,1].
+ * - 1 => highly cohesive (imports mostly appear together with a small set)
+ * - 0 => maximally fragmented (imports appear uniformly across many partners)
+ */
+export declare function calculateStructuralCohesionFromCoUsage(file: string, coUsageMatrix?: Map<string, Map<string, number>>): number;
+export {};
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/analyzer.d.ts.map

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