@girardelli/architect 1.2.1 → 2.1.0

package/dist/rules/hub-splitter.d.ts

@@ -0,0 +1,13 @@
+import { AnalysisReport, RefactorRule, RefactorStep } from '../types.js';
+/**
+ * Hub Splitter Rule (Tier 1)
+ * Detects files with many connections and generates split plans.
+ * A "hub" is a file that many other files depend on, creating tight coupling.
+ */
+export declare class HubSplitterRule implements RefactorRule {
+    name: string;
+    tier: 1;
+    analyze(report: AnalysisReport, projectPath: string): RefactorStep[];
+    private groupDependents;
+}
+//# sourceMappingURL=hub-splitter.d.ts.map

package/dist/rules/hub-splitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-splitter.d.ts","sourceRoot":"","sources":["../../src/rules/hub-splitter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAiB,MAAM,aAAa,CAAC;AAExF;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,YAAY;IAClD,IAAI,SAAkB;IACtB,IAAI,EAAG,CAAC,CAAU;IAElB,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE;IA4FpE,OAAO,CAAC,eAAe;CAkBxB"}

package/dist/rules/hub-splitter.js

@@ -0,0 +1,110 @@
+import { basename, dirname } from 'path';
+/**
+ * Hub Splitter Rule (Tier 1)
+ * Detects files with many connections and generates split plans.
+ * A "hub" is a file that many other files depend on, creating tight coupling.
+ */
+export class HubSplitterRule {
+    constructor() {
+        this.name = 'hub-splitter';
+        this.tier = 1;
+    }
+    analyze(report, projectPath) {
+        const steps = [];
+        // Count connections per node
+        const connectionCount = {};
+        for (const edge of report.dependencyGraph.edges) {
+            if (!connectionCount[edge.from])
+                connectionCount[edge.from] = { incoming: [], outgoing: [] };
+            if (!connectionCount[edge.to])
+                connectionCount[edge.to] = { incoming: [], outgoing: [] };
+            connectionCount[edge.from].outgoing.push(edge.to);
+            connectionCount[edge.to].incoming.push(edge.from);
+        }
+        // Find hubs (5+ incoming connections, not barrel files)
+        const barrelFiles = new Set(['__init__.py', 'index.ts', 'index.js', 'index.tsx', 'mod.rs']);
+        for (const [file, connections] of Object.entries(connectionCount)) {
+            const fileName = basename(file);
+            if (barrelFiles.has(fileName))
+                continue;
+            if (connections.incoming.length < 5)
+                continue;
+            const operations = [];
+            // Determine if this is a dot-notation module or a real file
+            const isDotNotation = !file.includes('/') && !file.includes('\\');
+            const moduleName = isDotNotation
+                ? file.split('.').pop() || file
+                : fileName.replace(/\.[^.]+$/, '');
+            const moduleDir = isDotNotation
+                ? file.split('.').slice(0, -1).join('/')
+                : dirname(file);
+            const ext = isDotNotation ? 'py' : (fileName.split('.').pop() || 'py');
+            // Analyze what dependents import to suggest groupings
+            const dependentGroups = this.groupDependents(connections.incoming);
+            // Suggest splitting into domain modules
+            if (dependentGroups.length >= 2) {
+                for (const group of dependentGroups) {
+                    const newFileName = `${moduleName}_${group.name}.${ext}`;
+                    const newPath = moduleDir ? `${moduleDir}/${newFileName}` : newFileName;
+                    operations.push({
+                        type: 'CREATE',
+                        path: newPath,
+                        description: `Create \`${newFileName}\` with functionality used by: ${group.dependents.join(', ')}`,
+                        content: ext === 'py'
+                            ? `"""${moduleName}_${group.name} — extracted from ${moduleName}."""\n# Used by: ${group.dependents.join(', ')}\n`
+                            : `// ${moduleName}_${group.name} — extracted from ${moduleName}\n// Used by: ${group.dependents.join(', ')}\n`,
+                    });
+                }
+                // Update imports in all dependents
+                for (const dependent of connections.incoming) {
+                    operations.push({
+                        type: 'MODIFY',
+                        path: dependent,
+                        description: `Update imports in \`${basename(dependent)}\` to use new split modules`,
+                    });
+                }
+                // Mark original for refactoring
+                operations.push({
+                    type: 'MODIFY',
+                    path: isDotNotation ? `${moduleDir}/${moduleName}.${ext}` : file,
+                    description: `Refactor \`${moduleName}.${ext}\` — extract grouped functionality to new modules`,
+                });
+            }
+            if (operations.length > 0) {
+                steps.push({
+                    id: 0,
+                    tier: 1,
+                    rule: this.name,
+                    priority: connections.incoming.length >= 8 ? 'CRITICAL' : 'HIGH',
+                    title: `Split hub file: ${moduleName}.${ext}`,
+                    description: `\`${file}\` has ${connections.incoming.length} incoming connections. ` +
+                        `Split into ${dependentGroups.length} focused modules to reduce coupling.`,
+                    rationale: `High fan-in (${connections.incoming.length} files depend on this) creates a bottleneck. ` +
+                        `Changes to this file ripple to ${connections.incoming.length} other files. ` +
+                        `Splitting by usage pattern reduces blast radius.`,
+                    operations,
+                    scoreImpact: [
+                        { metric: 'coupling', before: report.score.breakdown.coupling, after: Math.min(95, report.score.breakdown.coupling + 15) },
+                    ],
+                });
+            }
+        }
+        return steps;
+    }
+    groupDependents(dependents) {
+        // Group by top-level directory
+        const groups = {};
+        for (const dep of dependents) {
+            const parts = dep.includes('/') ? dep.split('/') : dep.split('.');
+            const groupName = parts.length >= 2 ? parts[parts.length - 2] : 'core';
+            if (!groups[groupName])
+                groups[groupName] = [];
+            groups[groupName].push(basename(dep));
+        }
+        return Object.entries(groups).map(([name, deps]) => ({
+            name,
+            dependents: deps,
+        }));
+    }
+}
+//# sourceMappingURL=hub-splitter.js.map

package/dist/rules/hub-splitter.js.map

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

package/dist/rules/import-organizer.d.ts

@@ -0,0 +1,13 @@
+import { AnalysisReport, RefactorRule, RefactorStep } from '../types.js';
+/**
+ * Import Organizer Rule (Tier 1)
+ * Detects files that import from too many different modules (cross-boundary).
+ * Suggests dependency injection or facade patterns.
+ */
+export declare class ImportOrganizerRule implements RefactorRule {
+    name: string;
+    tier: 1;
+    analyze(report: AnalysisReport, projectPath: string): RefactorStep[];
+    private generateFacadeContent;
+}
+//# sourceMappingURL=import-organizer.d.ts.map

package/dist/rules/import-organizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-organizer.d.ts","sourceRoot":"","sources":["../../src/rules/import-organizer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAiB,MAAM,aAAa,CAAC;AAExF;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACtD,IAAI,SAAsB;IAC1B,IAAI,EAAG,CAAC,CAAU;IAElB,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE;IAuEpE,OAAO,CAAC,qBAAqB;CAc9B"}

package/dist/rules/import-organizer.js

@@ -0,0 +1,85 @@
+import { basename, dirname } from 'path';
+/**
+ * Import Organizer Rule (Tier 1)
+ * Detects files that import from too many different modules (cross-boundary).
+ * Suggests dependency injection or facade patterns.
+ */
+export class ImportOrganizerRule {
+    constructor() {
+        this.name = 'import-organizer';
+        this.tier = 1;
+    }
+    analyze(report, projectPath) {
+        const steps = [];
+        // Find files that import from many different directories
+        const crossBoundary = {};
+        for (const edge of report.dependencyGraph.edges) {
+            const fromDir = dirname(edge.from);
+            const toDir = dirname(edge.to);
+            if (!crossBoundary[edge.from]) {
+                crossBoundary[edge.from] = { targets: new Set(), dirs: new Set() };
+            }
+            crossBoundary[edge.from].targets.add(edge.to);
+            if (fromDir !== toDir) {
+                crossBoundary[edge.from].dirs.add(toDir);
+            }
+        }
+        // Files importing from 3+ different directories
+        const violators = Object.entries(crossBoundary)
+            .filter(([_, data]) => data.dirs.size >= 3)
+            .sort((a, b) => b[1].dirs.size - a[1].dirs.size);
+        for (const [file, data] of violators) {
+            const operations = [];
+            const fileName = basename(file);
+            const fileDir = dirname(file);
+            // Suggest creating a facade/service layer
+            const ext = fileName.split('.').pop() || 'py';
+            const nameBase = fileName.replace(/\.[^.]+$/, '');
+            const facadePath = `${fileDir}/${nameBase}_deps.${ext}`;
+            operations.push({
+                type: 'CREATE',
+                path: facadePath,
+                description: `Create dependency facade \`${basename(facadePath)}\` — centralizes ${data.dirs.size} cross-module imports`,
+                content: this.generateFacadeContent(ext, Array.from(data.targets), Array.from(data.dirs)),
+            });
+            operations.push({
+                type: 'MODIFY',
+                path: file,
+                description: `Refactor \`${fileName}\` to import from local facade instead of ${data.dirs.size} different modules`,
+            });
+            steps.push({
+                id: 0,
+                tier: 1,
+                rule: this.name,
+                priority: data.dirs.size >= 5 ? 'HIGH' : 'MEDIUM',
+                title: `Reduce cross-boundary imports: ${fileName}`,
+                description: `\`${file}\` imports from ${data.dirs.size} different modules: ` +
+                    `${Array.from(data.dirs).map((d) => `\`${d}\``).join(', ')}. ` +
+                    `Consider using a facade or dependency injection.`,
+                rationale: `Files with imports scattered across many modules have high afferent coupling. ` +
+                    `A facade centralizes these dependencies, making the file easier to test (mock one facade) ` +
+                    `and reducing the impact of changes in dependent modules.`,
+                operations,
+                scoreImpact: [
+                    { metric: 'cohesion', before: report.score.breakdown.cohesion, after: Math.min(95, report.score.breakdown.cohesion + 5) },
+                    { metric: 'coupling', before: report.score.breakdown.coupling, after: Math.min(95, report.score.breakdown.coupling + 5) },
+                ],
+            });
+        }
+        return steps;
+    }
+    generateFacadeContent(ext, targets, dirs) {
+        if (ext === 'py') {
+            const imports = targets
+                .map((t) => `# from ${t.replace(/\//g, '.')} import ...`)
+                .join('\n');
+            return `"""Dependency facade — centralizes cross-module imports."""\n\n${imports}\n\n# Re-export what ${dirs.length} modules need\n`;
+        }
+        // JS/TS
+        const imports = targets
+            .map((t) => `// export { ... } from '${t}';`)
+            .join('\n');
+        return `/**\n * Dependency facade — centralizes cross-module imports.\n */\n\n${imports}\n`;
+    }
+}
+//# sourceMappingURL=import-organizer.js.map

package/dist/rules/import-organizer.js.map

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

package/dist/rules/module-grouper.d.ts

@@ -0,0 +1,13 @@
+import { AnalysisReport, RefactorRule, RefactorStep } from '../types.js';
+/**
+ * Module Grouper Rule (Tier 1)
+ * Analyzes which files are frequently imported together and suggests
+ * grouping them into cohesive modules/packages.
+ */
+export declare class ModuleGrouperRule implements RefactorRule {
+    name: string;
+    tier: 1;
+    analyze(report: AnalysisReport, projectPath: string): RefactorStep[];
+    private suggestModuleName;
+}
+//# sourceMappingURL=module-grouper.d.ts.map

package/dist/rules/module-grouper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-grouper.d.ts","sourceRoot":"","sources":["../../src/rules/module-grouper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAiB,MAAM,aAAa,CAAC;AAExF;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IACpD,IAAI,SAAoB;IACxB,IAAI,EAAG,CAAC,CAAU;IAElB,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE;IAqGpE,OAAO,CAAC,iBAAiB;CAU1B"}

package/dist/rules/module-grouper.js

@@ -0,0 +1,110 @@
+import { basename, dirname, join } from 'path';
+/**
+ * Module Grouper Rule (Tier 1)
+ * Analyzes which files are frequently imported together and suggests
+ * grouping them into cohesive modules/packages.
+ */
+export class ModuleGrouperRule {
+    constructor() {
+        this.name = 'module-grouper';
+        this.tier = 1;
+    }
+    analyze(report, projectPath) {
+        const steps = [];
+        // Build co-import matrix: which files are imported together?
+        const coImportCount = {};
+        // For each source file, see what it imports
+        const importsBySource = {};
+        for (const edge of report.dependencyGraph.edges) {
+            if (!importsBySource[edge.from])
+                importsBySource[edge.from] = [];
+            importsBySource[edge.from].push(edge.to);
+        }
+        // Count co-imports
+        for (const [source, targets] of Object.entries(importsBySource)) {
+            for (let i = 0; i < targets.length; i++) {
+                for (let j = i + 1; j < targets.length; j++) {
+                    const a = targets[i];
+                    const b = targets[j];
+                    if (!coImportCount[a])
+                        coImportCount[a] = {};
+                    if (!coImportCount[b])
+                        coImportCount[b] = {};
+                    coImportCount[a][b] = (coImportCount[a][b] || 0) + 1;
+                    coImportCount[b][a] = (coImportCount[b][a] || 0) + 1;
+                }
+            }
+        }
+        // Find clusters: files that are always imported together
+        const clusters = [];
+        const visited = new Set();
+        for (const [fileA, partners] of Object.entries(coImportCount)) {
+            if (visited.has(fileA))
+                continue;
+            const strongPartners = Object.entries(partners)
+                .filter(([_, count]) => count >= 2)
+                .sort((a, b) => b[1] - a[1]);
+            if (strongPartners.length >= 2) {
+                const cluster = [fileA, ...strongPartners.map(([f]) => f)];
+                const inSameDir = cluster.every((f) => dirname(f) === dirname(cluster[0]));
+                // Only suggest if NOT already in the same directory
+                if (!inSameDir) {
+                    const score = strongPartners.reduce((sum, [_, c]) => sum + c, 0);
+                    clusters.push({ files: cluster, coImportScore: score });
+                    cluster.forEach((f) => visited.add(f));
+                }
+            }
+        }
+        // Generate steps for each cluster
+        for (const cluster of clusters.slice(0, 3)) {
+            const operations = [];
+            const clusterName = this.suggestModuleName(cluster.files);
+            const targetDir = `${dirname(cluster.files[0])}/${clusterName}`;
+            // Create new module directory
+            operations.push({
+                type: 'CREATE',
+                path: `${targetDir}/__init__.py`,
+                description: `Create new module \`${clusterName}/\` to group ${cluster.files.length} co-dependent files`,
+                content: `"""Module ${clusterName} — grouped by co-import pattern."""\n`,
+            });
+            // Move files
+            for (const file of cluster.files) {
+                const newPath = join(targetDir, basename(file));
+                operations.push({
+                    type: 'MOVE',
+                    path: file,
+                    newPath,
+                    description: `Move \`${basename(file)}\` → \`${clusterName}/${basename(file)}\``,
+                });
+            }
+            steps.push({
+                id: 0,
+                tier: 1,
+                rule: this.name,
+                priority: 'MEDIUM',
+                title: `Group co-dependent files into \`${clusterName}/\``,
+                description: `Files ${cluster.files.map((f) => `\`${basename(f)}\``).join(', ')} ` +
+                    `are frequently imported together (co-import score: ${cluster.coImportScore}). ` +
+                    `Grouping them improves cohesion.`,
+                rationale: `Files that are frequently imported together belong in the same module. ` +
+                    `This improves discoverability and reduces the cognitive load of understanding ` +
+                    `which files work together.`,
+                operations,
+                scoreImpact: [
+                    { metric: 'cohesion', before: report.score.breakdown.cohesion, after: Math.min(95, report.score.breakdown.cohesion + 10) },
+                    { metric: 'modularity', before: report.score.breakdown.modularity, after: Math.min(95, report.score.breakdown.modularity + 5) },
+                ],
+            });
+        }
+        return steps;
+    }
+    suggestModuleName(files) {
+        // Try to infer a common theme from filenames
+        const names = files.map((f) => basename(f).replace(/\.[^.]+$/, '').toLowerCase());
+        const commonParts = names[0].split(/[_-]/).filter((part) => names.every((n) => n.includes(part)));
+        if (commonParts.length > 0)
+            return commonParts[0];
+        return 'shared';
+    }
+}
+//# sourceMappingURL=module-grouper.js.map

package/dist/rules/module-grouper.js.map

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

package/dist/scorer.d.ts

@@ -4,11 +4,23 @@ export declare class ArchitectureScorer {
     private coupling;
     private cohesion;
     private layering;
+    /**
+     * Barrel/index files that naturally have many connections and should be
+     * excluded from coupling max-edge penalty calculations.
+     */
+    private static readonly BARREL_FILES;
     score(edges: DependencyEdge[], antiPatterns: AntiPattern[], totalFiles: number): ArchitectureScore;
     private calculateModularity;
     private calculateCoupling;
     private findNodeWithMaxEdges;
     private calculateCohesion;
+    /**
+     * Determines if a dependency is "internal" (cohesive).
+     * Two files are considered cohesive if they share the same top-level
+     * package/directory (e.g., deepguard/cli.py → deepguard/analyzer.py).
+     * This is crucial for Python flat packages where all files live in
+     * one directory but ARE cohesive.
+     */
     private isInternalDependency;
     private calculateLayering;
 }

package/dist/scorer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scorer.d.ts","sourceRoot":"","sources":["../src/scorer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAkB,MAAM,YAAY,CAAC;AAE5F,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,QAAQ,CAAa;IAE7B,KAAK,CACH,KAAK,EAAE,cAAc,EAAE,EACvB,YAAY,EAAE,WAAW,EAAE,EAC3B,UAAU,EAAE,MAAM,GACjB,iBAAiB;IA2DpB,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,iBAAiB;IAwBzB,OAAO,CAAC,oBAAoB;IAuB5B,OAAO,CAAC,iBAAiB;IAyBzB,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,iBAAiB;CAsB1B"}
+{"version":3,"file":"scorer.d.ts","sourceRoot":"","sources":["../src/scorer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAkB,MAAM,YAAY,CAAC;AAG5F,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,QAAQ,CAAa;IAE7B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAGjC;IAEH,KAAK,CACH,KAAK,EAAE,cAAc,EAAE,EACvB,YAAY,EAAE,WAAW,EAAE,EAC3B,UAAU,EAAE,MAAM,GACjB,iBAAiB;IA2DpB,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,iBAAiB;IAwCzB,OAAO,CAAC,oBAAoB;IAuB5B,OAAO,CAAC,iBAAiB;IA4BzB;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,iBAAiB;CAsB1B"}

package/dist/scorer.js

@@ -1,3 +1,4 @@
+import { basename } from 'path';
 export class ArchitectureScorer {
     constructor() {
         this.modularity = 0;
@@ -78,27 +79,44 @@ export class ArchitectureScorer {
         }
     }
     calculateCoupling(edges, totalFiles) {
-        if (totalFiles === 0) {
+        if (totalFiles === 0 || totalFiles === 1) {
             this.coupling = 50;
             return;
         }
-        const nodeWithMaxEdges = this.findNodeWithMaxEdges(edges);
+        // Exclude barrel/index files from max-edge calculation —
+        // they naturally have many connections by design.
+        const nonBarrelEdges = edges.filter((e) => {
+            const fromFile = basename(e.from);
+            const toFile = basename(e.to);
+            return !ArchitectureScorer.BARREL_FILES.has(fromFile) &&
+                !ArchitectureScorer.BARREL_FILES.has(toFile);
+        });
+        const nodeWithMaxEdges = this.findNodeWithMaxEdges(nonBarrelEdges);
         const maxEdgeCount = nodeWithMaxEdges ? nodeWithMaxEdges.count : 0;
-        const couplingRatio = maxEdgeCount / (totalFiles - 1);
-        if (couplingRatio < 0.2) {
+        // Use non-barrel file count for ratio calculation
+        const effectiveFiles = Math.max(totalFiles - 1, 1);
+        const couplingRatio = maxEdgeCount / effectiveFiles;
+        // More granular thresholds
+        if (couplingRatio < 0.15) {
             this.coupling = 95;
         }
-        else if (couplingRatio < 0.4) {
+        else if (couplingRatio < 0.25) {
             this.coupling = 85;
         }
-        else if (couplingRatio < 0.6) {
-            this.coupling = 70;
+        else if (couplingRatio < 0.35) {
+            this.coupling = 75;
+        }
+        else if (couplingRatio < 0.5) {
+            this.coupling = 65;
         }
-        else if (couplingRatio < 0.8) {
+        else if (couplingRatio < 0.7) {
             this.coupling = 50;
         }
+        else if (couplingRatio < 0.85) {
+            this.coupling = 35;
+        }
         else {
-            this.coupling = 30;
+            this.coupling = 20;
         }
     }
     findNodeWithMaxEdges(edges) {
@@ -124,26 +142,44 @@ export class ArchitectureScorer {
         }
         const internalEdges = edges.filter((e) => this.isInternalDependency(e.from, e.to)).length;
         const cohesionRatio = internalEdges / edges.length;
-        if (cohesionRatio > 0.7) {
+        // More granular thresholds
+        if (cohesionRatio > 0.8) {
             this.cohesion = 95;
         }
-        else if (cohesionRatio > 0.5) {
-            this.cohesion = 80;
+        else if (cohesionRatio > 0.6) {
+            this.cohesion = 85;
+        }
+        else if (cohesionRatio > 0.45) {
+            this.cohesion = 75;
         }
         else if (cohesionRatio > 0.3) {
             this.cohesion = 65;
         }
-        else if (cohesionRatio > 0.1) {
-            this.cohesion = 45;
+        else if (cohesionRatio > 0.15) {
+            this.cohesion = 50;
         }
         else {
             this.cohesion = 30;
         }
     }
+    /**
+     * Determines if a dependency is "internal" (cohesive).
+     * Two files are considered cohesive if they share the same top-level
+     * package/directory (e.g., deepguard/cli.py → deepguard/analyzer.py).
+     * This is crucial for Python flat packages where all files live in
+     * one directory but ARE cohesive.
+     */
     isInternalDependency(from, to) {
-        const fromModule = from.split('/').slice(0, -1).join('/');
-        const toModule = to.split('/').slice(0, -1).join('/');
-        return fromModule === toModule;
+        const fromParts = from.split('/');
+        const toParts = to.split('/');
+        // If both are in root (no directory), they're cohesive
+        if (fromParts.length <= 1 && toParts.length <= 1)
+            return true;
+        // Compare top-level directory (package name)
+        // e.g., "deepguard/cli.py" and "deepguard/analyzer.py" → same package
+        const fromTopLevel = fromParts.length > 1 ? fromParts[0] : '';
+        const toTopLevel = toParts.length > 1 ? toParts[0] : '';
+        return fromTopLevel === toTopLevel;
     }
     calculateLayering(antiPatterns) {
         const layeringViolations = antiPatterns.filter((p) => p.name === 'Leaky Abstraction' ||
@@ -169,4 +205,12 @@ export class ArchitectureScorer {
         }
     }
 }
+/**
+ * Barrel/index files that naturally have many connections and should be
+ * excluded from coupling max-edge penalty calculations.
+ */
+ArchitectureScorer.BARREL_FILES = new Set([
+    '__init__.py', 'index.ts', 'index.js', 'index.tsx', 'index.jsx',
+    'mod.rs', '__init__.pyi',
+]);
 //# sourceMappingURL=scorer.js.map

package/dist/scorer.js.map

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

package/dist/types.d.ts

@@ -103,4 +103,55 @@ export interface ParsedImport {
     isDefault: boolean;
     isNamespace: boolean;
 }
+export interface RefactoringPlan {
+    timestamp: string;
+    projectPath: string;
+    currentScore: ArchitectureScore;
+    estimatedScoreAfter: {
+        overall: number;
+        breakdown: Record<string, number>;
+    };
+    steps: RefactorStep[];
+    totalOperations: number;
+    tier1Steps: number;
+    tier2Steps: number;
+}
+export interface RefactorStep {
+    id: number;
+    tier: 1 | 2;
+    rule: string;
+    priority: 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW';
+    title: string;
+    description: string;
+    rationale: string;
+    operations: FileOperation[];
+    scoreImpact: {
+        metric: string;
+        before: number;
+        after: number;
+    }[];
+    codePreview?: string;
+}
+export interface FileOperation {
+    type: 'CREATE' | 'MOVE' | 'MODIFY' | 'DELETE';
+    path: string;
+    newPath?: string;
+    content?: string;
+    diff?: string;
+    description: string;
+}
+export interface CodeSymbol {
+    name: string;
+    type: 'function' | 'class' | 'variable' | 'import' | 'export';
+    startLine: number;
+    endLine: number;
+    lines: number;
+    dependencies: string[];
+    usedBy: string[];
+}
+export interface RefactorRule {
+    name: string;
+    tier: 1 | 2;
+    analyze(report: AnalysisReport, projectPath: string): RefactorStep[];
+}
 //# sourceMappingURL=types.d.ts.map