@girardelli/architect-core 8.1.0

package/dist/src/core/rules/import-organizer.js

@@ -0,0 +1,84 @@
+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 {
+    name = 'import-organizer';
+    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);
+            }
+        }
+        // Outliers reais espalhados consumindo +5 diretórios. Testa bypass em unit-tests (.test.) naturais de altíssima injeção (mock).
+        const violators = Object.entries(crossBoundary)
+            .filter(([fileName, data]) => data.dirs.size >= 5 && !fileName.includes('.test.'))
+            .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) },
+                ],
+                aiPrompt: `Analyze the file \`${file}\` which currently imports from ${data.dirs.size} cross-boundary distinct directories/modules (${Array.from(data.dirs).join(', ')}).\nPlease refactor this to use the Dependency Injection (DI) or Facade pattern:\n1. Extract these imports into a dedicated file \`${facadePath}\`.\n2. Re-export or bundle them appropriately.\n3. Update \`${file}\` to import strictly from the new \`${facadePath}\` rather than directly reaching into multiple disjointed modules, lowering its afferent coupling.`,
+            });
+        }
+        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/src/core/rules/import-organizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-organizer.js","sourceRoot":"","sources":["../../../../src/core/rules/import-organizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAIzC;;;;GAIG;AACH,MAAM,OAAO,mBAAmB;IAC9B,IAAI,GAAG,kBAAkB,CAAC;IAC1B,IAAI,GAAG,CAAU,CAAC;IAElB,OAAO,CAAC,MAAsB,EAAE,YAAoB;QAClD,MAAM,KAAK,GAAmB,EAAE,CAAC;QAEjC,yDAAyD;QACzD,MAAM,aAAa,GAAgE,EAAE,CAAC;QAEtF,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;YAChD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAE/B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;YACrE,CAAC;YACD,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAE9C,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;gBACtB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QAED,gIAAgI;QAChI,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC;aAC5C,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;aACjF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEnD,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,SAAS,EAAE,CAAC;YACrC,MAAM,UAAU,GAAoB,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAChC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YAE9B,0CAA0C;YAC1C,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC;YAC9C,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YAClD,MAAM,UAAU,GAAG,GAAG,OAAO,IAAI,QAAQ,SAAS,GAAG,EAAE,CAAC;YAExD,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,UAAU;gBAChB,WAAW,EAAE,8BAA8B,QAAQ,CAAC,UAAU,CAAC,oBAAoB,IAAI,CAAC,IAAI,CAAC,IAAI,uBAAuB;gBACxH,OAAO,EAAE,IAAI,CAAC,qBAAqB,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;aAC1F,CAAC,CAAC;YAEH,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,IAAI;gBACV,WAAW,EAAE,cAAc,QAAQ,6CAA6C,IAAI,CAAC,IAAI,CAAC,IAAI,oBAAoB;aACnH,CAAC,CAAC;YAEH,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,CAAC;gBACL,IAAI,EAAE,CAAC;gBACP,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;gBACjD,KAAK,EAAE,kCAAkC,QAAQ,EAAE;gBACnD,WAAW,EAAE,KAAK,IAAI,mBAAmB,IAAI,CAAC,IAAI,CAAC,IAAI,sBAAsB;oBAC3E,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;oBAC9D,kDAAkD;gBACpD,SAAS,EAAE,gFAAgF;oBACzF,4FAA4F;oBAC5F,0DAA0D;gBAC5D,UAAU;gBACV,WAAW,EAAE;oBACX,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE;oBACzH,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE;iBAC1H;gBACD,QAAQ,EAAE,sBAAsB,IAAI,mCAAmC,IAAI,CAAC,IAAI,CAAC,IAAI,iDAAiD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,sIAAsI,UAAU,gEAAgE,IAAI,wCAAwC,UAAU,oGAAoG;aACjhB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,qBAAqB,CAAC,GAAW,EAAE,OAAiB,EAAE,IAAc;QAC1E,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,OAAO;iBACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,aAAa,CAAC;iBACxD,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,OAAO,kEAAkE,OAAO,wBAAwB,IAAI,CAAC,MAAM,iBAAiB,CAAC;QACvI,CAAC;QAED,QAAQ;QACR,MAAM,OAAO,GAAG,OAAO;aACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,2BAA2B,CAAC,IAAI,CAAC;aAC5C,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,OAAO,yEAAyE,OAAO,IAAI,CAAC;IAC9F,CAAC;CACF"}

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

@@ -0,0 +1,13 @@
+import { AnalysisReport } from '../types/core.js';
+import { RefactorRule, RefactorStep } from '../types/rules.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;
+}

package/dist/src/core/rules/module-grouper.js

@@ -0,0 +1,116 @@
+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 {
+    name = 'module-grouper';
+    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 >= 3)
+                .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) {
+                    // Arquitetura Limpa: Impede arrastar Módulos Transversais (DTOs/Types) para se tornarem fechados em Pastas de Domínios
+                    const hasTypes = cluster.some(f => {
+                        const lowerF = f.toLowerCase();
+                        return lowerF.includes('types') || lowerF.includes('interface') || lowerF.includes('/types/');
+                    });
+                    if (hasTypes)
+                        continue;
+                    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) },
+                ],
+                aiPrompt: `Analyze the files: ${cluster.files.map(f => `\`${f}\``).join(', ')}.\nThese files are frequently imported together but are currently scattered across different directories.\nPlease refactor to improve cohesion:\n1. Create a new directory named \`${targetDir}\`.\n2. Move these files solidly into this new directory.\n3. Add an index/barrel file if appropriate.\n4. Securely scan the entire project to fix all broken imports resulting from this move.`,
+            });
+        }
+        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/src/core/rules/module-grouper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-grouper.js","sourceRoot":"","sources":["../../../../src/core/rules/module-grouper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI/C;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IAC5B,IAAI,GAAG,gBAAgB,CAAC;IACxB,IAAI,GAAG,CAAU,CAAC;IAElB,OAAO,CAAC,MAAsB,EAAE,YAAoB;QAClD,MAAM,KAAK,GAAmB,EAAE,CAAC;QAEjC,6DAA6D;QAC7D,MAAM,aAAa,GAA2C,EAAE,CAAC;QAEjE,4CAA4C;QAC5C,MAAM,eAAe,GAA6B,EAAE,CAAC;QACrD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;YAChD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACjE,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,mBAAmB;QACnB,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;YACjE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACxC,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC5C,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;oBACrB,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;oBACrB,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;wBAAE,aAAa,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;oBAC7C,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;wBAAE,aAAa,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;oBAC7C,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;oBACrD,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC;QACH,CAAC;QAED,yDAAyD;QACzD,MAAM,QAAQ,GAAsD,EAAE,CAAC;QACvE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAElC,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YAC9D,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,SAAS;YAEjC,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;iBAC5C,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC;iBAClC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAE/B,IAAI,cAAc,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBAC/B,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC3D,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAC7B,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAC1C,CAAC;gBAEF,oDAAoD;gBACpD,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,uHAAuH;oBACvH,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;wBAChC,MAAM,MAAM,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;wBAC/B,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;oBAChG,CAAC,CAAC,CAAC;oBACH,IAAI,QAAQ;wBAAE,SAAS;oBAEvB,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;oBACjE,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC;oBACxD,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC;QACH,CAAC;QAED,kCAAkC;QAClC,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAC3C,MAAM,UAAU,GAAoB,EAAE,CAAC;YACvC,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC1D,MAAM,SAAS,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC;YAEhE,8BAA8B;YAC9B,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,GAAG,SAAS,cAAc;gBAChC,WAAW,EAAE,uBAAuB,WAAW,gBAAgB,OAAO,CAAC,KAAK,CAAC,MAAM,qBAAqB;gBACxG,OAAO,EAAE,aAAa,WAAW,uCAAuC;aACzE,CAAC,CAAC;YAEH,aAAa;YACb,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBACjC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;gBAChD,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI;oBACV,OAAO;oBACP,WAAW,EAAE,UAAU,QAAQ,CAAC,IAAI,CAAC,UAAU,WAAW,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI;iBACjF,CAAC,CAAC;YACL,CAAC;YAED,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,CAAC;gBACL,IAAI,EAAE,CAAC;gBACP,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,QAAQ,EAAE,QAAQ;gBAClB,KAAK,EAAE,mCAAmC,WAAW,KAAK;gBAC1D,WAAW,EAAE,SAAS,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;oBAChF,sDAAsD,OAAO,CAAC,aAAa,KAAK;oBAChF,kCAAkC;gBACpC,SAAS,EAAE,yEAAyE;oBAClF,gFAAgF;oBAChF,4BAA4B;gBAC9B,UAAU;gBACV,WAAW,EAAE;oBACX,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,GAAG,EAAE,CAAC,EAAE;oBAC1H,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,UAAU,GAAG,CAAC,CAAC,EAAE;iBAChI;gBACD,QAAQ,EAAE,sBAAsB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,sLAAsL,SAAS,iMAAiM;aAC9c,CAAC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,iBAAiB,CAAC,KAAe;QACvC,6CAA6C;QAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAClF,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CACzD,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CACrC,CAAC;QAEF,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC;QAClD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/src/core/rules-engine.d.ts

@@ -0,0 +1,7 @@
+import { AnalysisReport } from './types/core.js';
+import { ArchitectRules, ValidationResult } from './types/architect-rules.js';
+export declare class RulesEngine {
+    validate(report: AnalysisReport, rules: ArchitectRules): ValidationResult;
+    private checkQualityGates;
+    private checkBoundaries;
+}

package/dist/src/core/rules-engine.js

@@ -0,0 +1,89 @@
+export class RulesEngine {
+    validate(report, rules) {
+        const violations = [];
+        this.checkQualityGates(report, rules, violations);
+        this.checkBoundaries(report, rules, violations);
+        return {
+            success: violations.every(v => v.level !== 'error'),
+            violations,
+        };
+    }
+    checkQualityGates(report, rules, violations) {
+        if (!rules.quality_gates)
+            return;
+        const { min_overall_score, max_critical_anti_patterns, max_high_anti_patterns } = rules.quality_gates;
+        // 1. Minimum Overall Score (Error)
+        if (min_overall_score !== undefined && report.score.overall < min_overall_score) {
+            violations.push({
+                level: 'error',
+                rule: 'quality_gates.min_overall_score',
+                message: `Overall score (${report.score.overall}) is below the minimum required (${min_overall_score}).`,
+                actual: report.score.overall,
+                expected: min_overall_score,
+            });
+        }
+        // 2. Max Critical Anti-Patterns (Error)
+        if (max_critical_anti_patterns !== undefined) {
+            const criticalCount = report.antiPatterns.filter(p => p.severity === 'CRITICAL').length;
+            if (criticalCount > max_critical_anti_patterns) {
+                violations.push({
+                    level: 'error',
+                    rule: 'quality_gates.max_critical_anti_patterns',
+                    message: `Too many CRITICAL anti-patterns detected (${criticalCount}). Maximum allowed is ${max_critical_anti_patterns}.`,
+                    actual: criticalCount,
+                    expected: max_critical_anti_patterns,
+                });
+            }
+        }
+        // 3. Max High Anti-Patterns (Warning)
+        if (max_high_anti_patterns !== undefined) {
+            const highCount = report.antiPatterns.filter(p => p.severity === 'HIGH').length;
+            if (highCount > max_high_anti_patterns) {
+                violations.push({
+                    level: 'warning',
+                    rule: 'quality_gates.max_high_anti_patterns',
+                    message: `High number of HIGH severity anti-patterns (${highCount}). Maximum recommended is ${max_high_anti_patterns}.`,
+                    actual: highCount,
+                    expected: max_high_anti_patterns,
+                });
+            }
+        }
+    }
+    checkBoundaries(report, rules, violations) {
+        if (!rules.boundaries)
+            return;
+        const { allow_circular_dependencies, banned_imports } = rules.boundaries;
+        // 1. Allow Circular Dependencies
+        if (allow_circular_dependencies === false) {
+            const hasCycles = report.antiPatterns.filter(p => p.name === 'Circular Dependency');
+            if (hasCycles.length > 0) {
+                violations.push({
+                    level: 'error',
+                    rule: 'boundaries.allow_circular_dependencies',
+                    message: `Circular dependencies are strictly forbidden, but ${hasCycles.length} were found.`,
+                    actual: hasCycles.length,
+                    expected: 0,
+                });
+            }
+        }
+        // 2. Banned Imports (Checks the AST Dependency Graph edges)
+        if (banned_imports && banned_imports.length > 0) {
+            for (const edge of report.dependencyGraph.edges) {
+                // Look through 'to' targets
+                for (const banned of banned_imports) {
+                    if (edge.to.includes(banned)) {
+                        // Found a banned import!
+                        violations.push({
+                            level: 'error',
+                            rule: 'boundaries.banned_imports',
+                            message: `Banned import detected: File '${edge.from}' imports '${banned}'.`,
+                            actual: edge.to,
+                            expected: `Not to include ${banned}`,
+                        });
+                    }
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=rules-engine.js.map

package/dist/src/core/rules-engine.js.map

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

package/dist/src/core/scorer.d.ts

@@ -0,0 +1,15 @@
+import { ArchitectureScore, DependencyEdge, AntiPattern } from './types/core.js';
+export declare class ArchitectureScorer {
+    /**
+     * 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;
+    private isInternalDependency;
+    private calculateLayering;
+}

package/dist/src/core/scorer.js

@@ -0,0 +1,165 @@
+import { basename } from 'path';
+export class ArchitectureScorer {
+    /**
+     * Barrel/index files that naturally have many connections and should be
+     * excluded from coupling max-edge penalty calculations.
+     */
+    static BARREL_FILES = new Set([
+        '__init__.py', 'index.ts', 'index.js', 'index.tsx', 'index.jsx',
+        'mod.rs', '__init__.pyi', 'types.ts', 'types.js', 'logger.ts', 'logger.js'
+    ]);
+    score(edges, antiPatterns, totalFiles) {
+        const modularity = this.calculateModularity(edges, totalFiles);
+        const coupling = this.calculateCoupling(edges, totalFiles);
+        const cohesion = this.calculateCohesion(edges);
+        const layering = this.calculateLayering(antiPatterns, totalFiles);
+        const components = [
+            {
+                name: 'Modularity',
+                score: Math.round(modularity),
+                maxScore: 100,
+                weight: 0.4,
+                explanation: 'Measures appropriate module boundaries and single responsibility principle adherence',
+            },
+            {
+                name: 'Coupling',
+                score: Math.round(coupling),
+                maxScore: 100,
+                weight: 0.25,
+                explanation: 'Evaluates interdependencies between modules; lower coupling is better',
+            },
+            {
+                name: 'Cohesion',
+                score: Math.round(cohesion),
+                maxScore: 100,
+                weight: 0.2,
+                explanation: 'Assesses how closely related functionality is grouped together',
+            },
+            {
+                name: 'Layering',
+                score: Math.round(layering),
+                maxScore: 100,
+                weight: 0.15,
+                explanation: 'Checks adherence to architectural layer separation',
+            },
+        ];
+        const overall = Math.round(components[0].score * components[0].weight +
+            components[1].score * components[1].weight +
+            components[2].score * components[2].weight +
+            components[3].score * components[3].weight);
+        return {
+            overall: Math.min(100, Math.max(0, overall)),
+            components,
+            breakdown: {
+                modularity: Math.round(modularity),
+                coupling: Math.round(coupling),
+                cohesion: Math.round(cohesion),
+                layering: Math.round(layering),
+            },
+        };
+    }
+    calculateModularity(edges, totalFiles) {
+        if (totalFiles === 0)
+            return 50;
+        const avgEdgesPerFile = edges.length / totalFiles;
+        if (avgEdgesPerFile < 2)
+            return 100;
+        if (avgEdgesPerFile < 4)
+            return 85;
+        if (avgEdgesPerFile < 6)
+            return 70;
+        if (avgEdgesPerFile < 10)
+            return 50;
+        return 30;
+    }
+    calculateCoupling(edges, totalFiles) {
+        if (totalFiles === 0 || totalFiles === 1)
+            return 50;
+        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 effectiveFiles = Math.max(totalFiles - 1, 1);
+        const couplingRatio = maxEdgeCount / effectiveFiles;
+        if (couplingRatio < 0.15)
+            return 100;
+        if (couplingRatio < 0.25)
+            return 85;
+        if (couplingRatio < 0.35)
+            return 75;
+        if (couplingRatio < 0.5)
+            return 65;
+        if (couplingRatio < 0.7)
+            return 50;
+        if (couplingRatio < 0.85)
+            return 35;
+        return 20;
+    }
+    findNodeWithMaxEdges(edges) {
+        const nodeEdgeCount = {};
+        for (const edge of edges) {
+            nodeEdgeCount[edge.from] = (nodeEdgeCount[edge.from] || 0) + 1;
+            nodeEdgeCount[edge.to] = (nodeEdgeCount[edge.to] || 0) + 1;
+        }
+        let maxNode = null;
+        let maxCount = 0;
+        for (const [node, count] of Object.entries(nodeEdgeCount)) {
+            if (count > maxCount) {
+                maxCount = count;
+                maxNode = node;
+            }
+        }
+        return maxNode ? { node: maxNode, count: maxCount } : null;
+    }
+    calculateCohesion(edges) {
+        if (edges.length === 0)
+            return 50;
+        const internalEdges = edges.filter((e) => this.isInternalDependency(e.from, e.to)).length;
+        const cohesionRatio = internalEdges / edges.length;
+        if (cohesionRatio > 0.8)
+            return 100;
+        if (cohesionRatio > 0.6)
+            return 85;
+        if (cohesionRatio > 0.45)
+            return 75;
+        if (cohesionRatio > 0.3)
+            return 65;
+        if (cohesionRatio > 0.15)
+            return 50;
+        return 30;
+    }
+    isInternalDependency(from, to) {
+        const fromParts = from.split('/');
+        const toParts = to.split('/');
+        if (fromParts.length <= 1 && toParts.length <= 1)
+            return true;
+        const fromTopLevel = fromParts.length > 1 ? fromParts[0] : '';
+        const toTopLevel = toParts.length > 1 ? toParts[0] : '';
+        return fromTopLevel === toTopLevel;
+    }
+    calculateLayering(antiPatterns, totalFiles) {
+        const layeringViolations = antiPatterns.filter((p) => p.name === 'Leaky Abstraction' ||
+            p.name === 'Shotgun Surgery' ||
+            p.name === 'Circular Dependency').length;
+        if (layeringViolations === 0)
+            return 100;
+        const fileCount = Math.max(totalFiles || 50, 10);
+        const violationRatio = layeringViolations / fileCount;
+        if (violationRatio < 0.05)
+            return 95;
+        if (violationRatio < 0.15)
+            return 85;
+        if (violationRatio < 0.25)
+            return 70;
+        if (violationRatio < 0.40)
+            return 50;
+        if (violationRatio < 0.60)
+            return 35;
+        return 20;
+    }
+}
+//# sourceMappingURL=scorer.js.map

package/dist/src/core/scorer.js.map

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

package/dist/src/core/summarizer/keyword-extractor.d.ts

@@ -0,0 +1,6 @@
+import { AnalysisReport } from '../types/core.js';
+import { ProjectSummary } from '../types/summarizer.js';
+export declare class KeywordExtractor {
+    static readonly KEYWORD_BLACKLIST: Set<string>;
+    extractKeywords(packageInfo: Record<string, unknown>, _readme: string, modules: ProjectSummary['modules'], report: AnalysisReport): string[];
+}

package/dist/src/core/summarizer/keyword-extractor.js

@@ -0,0 +1,38 @@
+// import { FileNode, WorkspaceInfo } from '../types/infrastructure.js';
+export class KeywordExtractor {
+    static KEYWORD_BLACKLIST = new Set([
+        'node_modules', 'dist', 'build', '.git', '.next', 'coverage',
+        '__tests__', '__mocks__', 'src', 'lib', 'index', 'main',
+        'out', 'tmp', '.cache', 'vendor', '.vscode', '.idea',
+    ]);
+    extractKeywords(packageInfo, _readme, modules, report) {
+        const keywords = new Set();
+        // From package.json keywords
+        if (Array.isArray(packageInfo.keywords)) {
+            for (const kw of packageInfo.keywords) {
+                if (typeof kw === 'string')
+                    keywords.add(kw.toLowerCase());
+            }
+        }
+        // From module names (only clean names)
+        for (const mod of modules) {
+            const name = mod.name.toLowerCase();
+            if (!KeywordExtractor.KEYWORD_BLACKLIST.has(name)) {
+                keywords.add(name);
+            }
+        }
+        // From frameworks detected
+        for (const fw of report.projectInfo.frameworks) {
+            keywords.add(fw.toLowerCase());
+        }
+        // From languages
+        for (const lang of report.projectInfo.primaryLanguages) {
+            keywords.add(lang.toLowerCase());
+        }
+        // Filter out blacklisted and generic entries
+        return [...keywords]
+            .filter(kw => !KeywordExtractor.KEYWORD_BLACKLIST.has(kw) && kw.length > 1)
+            .slice(0, 20);
+    }
+}
+//# sourceMappingURL=keyword-extractor.js.map

package/dist/src/core/summarizer/keyword-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyword-extractor.js","sourceRoot":"","sources":["../../../../src/core/summarizer/keyword-extractor.ts"],"names":[],"mappings":"AAIA,wEAAwE;AAExE,MAAM,OAAO,gBAAgB;IACpB,MAAM,CAAU,iBAAiB,GAAG,IAAI,GAAG,CAAC;QACjD,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU;QAC5D,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM;QACvD,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO;KACrD,CAAC,CAAC;IAEE,eAAe,CAClB,WAAoC,EACpC,OAAe,EACf,OAAkC,EAClC,MAAsB;QAEtB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QAEnC,6BAA6B;QAC7B,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxC,KAAK,MAAM,EAAE,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;gBACtC,IAAI,OAAO,EAAE,KAAK,QAAQ;oBAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;QAED,uCAAuC;QACvC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACpC,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClD,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QAED,2BAA2B;QAC3B,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;YAC/C,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QACjC,CAAC;QAED,iBAAiB;QACjB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,WAAW,CAAC,gBAAgB,EAAE,CAAC;YACvD,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACnC,CAAC;QAED,6CAA6C;QAC7C,OAAO,CAAC,GAAG,QAAQ,CAAC;aACjB,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;aAC1E,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClB,CAAC"}

package/dist/src/core/summarizer/module-inferrer.d.ts

@@ -0,0 +1,11 @@
+import { AnalysisReport } from '../types/core.js';
+import { ProjectSummary } from '../types/summarizer.js';
+import { WorkspaceInfo } from '../types/infrastructure.js';
+export declare class ModuleInferrer {
+    inferModules(report: AnalysisReport, _projectPath: string): ProjectSummary['modules'];
+    inferModulesFromWorkspaces(workspaces: WorkspaceInfo[], report: AnalysisReport): ProjectSummary['modules'];
+    getWorkspaceDescription(ws: WorkspaceInfo): string;
+    countFilesInDir(dirPath: string): number;
+    inferModulesFromStructure(report: AnalysisReport): ProjectSummary['modules'];
+    describeModule(name: string, hints: Set<string>): string;
+}