@girardelli/architect-core 8.1.0

package/dist/src/core/plugin-loader.js.map

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

package/dist/src/core/project-summarizer.d.ts

@@ -0,0 +1,16 @@
+import { AnalysisReport } from './types/core.js';
+import { ProjectSummary } from './types/summarizer.js';
+/**
+ * ProjectSummarizer — infers what a project does from its metadata,
+ * structure, README, package.json, and file naming conventions.
+ *
+ * Refactored via Facade pattern in v5.0.0
+ */
+export declare class ProjectSummarizer {
+    private packageReader;
+    private readmeReader;
+    private keywordExtractor;
+    private purposeInferrer;
+    private moduleInferrer;
+    summarize(projectPath: string, report: AnalysisReport): ProjectSummary;
+}

package/dist/src/core/project-summarizer.js

@@ -0,0 +1,37 @@
+import { PackageReader } from './summarizer/package-reader.js';
+import { ReadmeReader } from './summarizer/readme-reader.js';
+import { KeywordExtractor } from './summarizer/keyword-extractor.js';
+import { PurposeInferrer } from './summarizer/purpose-inferrer.js';
+import { ModuleInferrer } from './summarizer/module-inferrer.js';
+/**
+ * ProjectSummarizer — infers what a project does from its metadata,
+ * structure, README, package.json, and file naming conventions.
+ *
+ * Refactored via Facade pattern in v5.0.0
+ */
+export class ProjectSummarizer {
+    packageReader = new PackageReader();
+    readmeReader = new ReadmeReader();
+    keywordExtractor = new KeywordExtractor();
+    purposeInferrer = new PurposeInferrer();
+    moduleInferrer = new ModuleInferrer();
+    summarize(projectPath, report) {
+        const packageInfo = this.packageReader.readPackageJson(projectPath);
+        const readmeContent = this.readmeReader.readReadme(projectPath);
+        const modules = this.moduleInferrer.inferModules(report, projectPath);
+        const entryPoints = this.purposeInferrer.findEntryPoints(report, projectPath);
+        const keywords = this.keywordExtractor.extractKeywords(packageInfo, readmeContent, modules, report);
+        const techStack = this.purposeInferrer.buildTechStack(report, packageInfo);
+        const description = this.purposeInferrer.buildDescription(packageInfo, readmeContent, report);
+        const purpose = this.purposeInferrer.inferPurpose(keywords, modules, report);
+        return {
+            description,
+            purpose,
+            modules,
+            techStack,
+            entryPoints,
+            keywords,
+        };
+    }
+}
+//# sourceMappingURL=project-summarizer.js.map

package/dist/src/core/project-summarizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-summarizer.js","sourceRoot":"","sources":["../../../src/core/project-summarizer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,OAAO,iBAAiB;IACpB,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;IACpC,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;IAClC,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAC1C,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;IACxC,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;IAE9C,SAAS,CAAC,WAAmB,EAAE,MAAsB;QACnD,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QACpE,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACtE,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC9E,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,eAAe,CAAC,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACpG,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC3E,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,WAAW,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;QAC9F,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAE7E,OAAO;YACL,WAAW;YACX,OAAO;YACP,OAAO;YACP,SAAS;YACT,WAAW;YACX,QAAQ;SACT,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,18 @@
+import { AnalysisReport } from './types/core.js';
+import { RefactoringPlan } from './types/rules.js';
+/**
+ * Refactoring Engine v2.0
+ * Orchestrates Tier 1 (rule-based) and Tier 2 (AST) refactoring rules.
+ */
+export declare class RefactorEngine {
+    private rules;
+    constructor();
+    /**
+     * Analyze a project and generate a refactoring plan.
+     */
+    analyze(report: AnalysisReport, projectPath: string): RefactoringPlan;
+    /**
+     * Estimates the architecture score after applying all refactoring steps.
+     */
+    private estimateScoreAfter;
+}

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

@@ -0,0 +1,87 @@
+// ── Tier 1 Rules ──
+import { HubSplitterRule } from './rules/hub-splitter.js';
+import { BarrelOptimizerRule } from './rules/barrel-optimizer.js';
+import { ImportOrganizerRule } from './rules/import-organizer.js';
+import { ModuleGrouperRule } from './rules/module-grouper.js';
+import { DeadCodeDetectorRule } from './rules/dead-code-detector.js';
+/**
+ * Refactoring Engine v2.0
+ * Orchestrates Tier 1 (rule-based) and Tier 2 (AST) refactoring rules.
+ */
+export class RefactorEngine {
+    rules;
+    constructor() {
+        this.rules = [
+            // Tier 1: Rule Engine (pattern matching)
+            new HubSplitterRule(),
+            new BarrelOptimizerRule(),
+            new ImportOrganizerRule(),
+            new ModuleGrouperRule(),
+            new DeadCodeDetectorRule(),
+        ];
+    }
+    /**
+     * Analyze a project and generate a refactoring plan.
+     */
+    analyze(report, projectPath) {
+        const allSteps = [];
+        let stepId = 1;
+        // Run each rule
+        for (const rule of this.rules) {
+            const steps = rule.analyze(report, projectPath);
+            for (const step of steps) {
+                step.id = stepId++;
+                allSteps.push(step);
+            }
+        }
+        // Sort by priority
+        const priorityOrder = {
+            CRITICAL: 0,
+            HIGH: 1,
+            MEDIUM: 2,
+            LOW: 3,
+        };
+        allSteps.sort((a, b) => priorityOrder[a.priority] - priorityOrder[b.priority]);
+        // Re-number after sorting
+        allSteps.forEach((s, i) => (s.id = i + 1));
+        // Calculate total operations
+        const totalOperations = allSteps.reduce((sum, s) => sum + s.operations.length, 0);
+        // Estimate score after refactoring
+        const estimatedScoreAfter = this.estimateScoreAfter(report, allSteps);
+        return {
+            timestamp: new Date().toISOString(),
+            projectPath,
+            currentScore: report.score,
+            estimatedScoreAfter,
+            steps: allSteps,
+            totalOperations,
+            tier1Steps: allSteps.filter((s) => s.tier === 1).length,
+            tier2Steps: allSteps.filter((s) => s.tier === 2).length,
+        };
+    }
+    /**
+     * Estimates the architecture score after applying all refactoring steps.
+     */
+    estimateScoreAfter(report, steps) {
+        const breakdown = { ...report.score.breakdown };
+        for (const step of steps) {
+            for (const impact of step.scoreImpact) {
+                if (impact.metric in breakdown) {
+                    // Use estimated after value, capped at 95
+                    const key = impact.metric;
+                    breakdown[key] = Math.min(95, Math.max(breakdown[key], impact.after));
+                }
+            }
+        }
+        // Recalculate overall with same weights
+        const overall = Math.round(breakdown.modularity * 0.4 +
+            breakdown.coupling * 0.25 +
+            breakdown.cohesion * 0.2 +
+            breakdown.layering * 0.15);
+        return {
+            overall: Math.min(100, overall),
+            breakdown,
+        };
+    }
+}
+//# sourceMappingURL=refactor-engine.js.map

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

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

package/dist/src/core/rules/barrel-optimizer.d.ts

@@ -0,0 +1,13 @@
+import { AnalysisReport } from '../types/core.js';
+import { RefactorRule, RefactorStep } from '../types/rules.js';
+/**
+ * Barrel Optimizer Rule (Tier 1)
+ * Analyzes barrel files (__init__.py, index.ts) and suggests optimization.
+ * Barrel files that re-export everything create unnecessary coupling.
+ */
+export declare class BarrelOptimizerRule implements RefactorRule {
+    name: string;
+    tier: 1;
+    private static readonly BARREL_FILES;
+    analyze(report: AnalysisReport, _projectPath: string): RefactorStep[];
+}

package/dist/src/core/rules/barrel-optimizer.js

@@ -0,0 +1,76 @@
+import { basename, dirname } from 'path';
+/**
+ * Barrel Optimizer Rule (Tier 1)
+ * Analyzes barrel files (__init__.py, index.ts) and suggests optimization.
+ * Barrel files that re-export everything create unnecessary coupling.
+ */
+export class BarrelOptimizerRule {
+    name = 'barrel-optimizer';
+    tier = 1;
+    static BARREL_FILES = new Set([
+        '__init__.py', 'index.ts', 'index.js', 'index.tsx', 'index.jsx',
+    ]);
+    analyze(report, _projectPath) {
+        const steps = [];
+        // Find barrel files in the dependency graph
+        const barrelNodes = report.dependencyGraph.nodes.filter((n) => BarrelOptimizerRule.BARREL_FILES.has(basename(n)));
+        for (const barrel of barrelNodes) {
+            // Count how many things this barrel re-exports (outgoing edges)
+            const outgoing = report.dependencyGraph.edges.filter((e) => e.from === barrel);
+            const incoming = report.dependencyGraph.edges.filter((e) => e.to === barrel);
+            if (outgoing.length < 3)
+                continue;
+            // Check for "pass-through" pattern: files import from barrel
+            // but barrel just re-exports from siblings
+            const siblingDir = dirname(barrel);
+            const siblingExports = outgoing.filter((e) => dirname(e.to) === siblingDir);
+            const operations = [];
+            // Suggest direct imports instead of barrel
+            for (const consumer of incoming) {
+                const consumedModules = outgoing
+                    .filter((e) => {
+                    // Check if consumer actually needs this module
+                    return report.dependencyGraph.edges.some((edge) => edge.from === consumer.from && edge.to === e.to);
+                })
+                    .map((e) => e.to);
+                if (consumedModules.length > 0) {
+                    operations.push({
+                        type: 'MODIFY',
+                        path: consumer.from,
+                        description: `Replace barrel import from \`${basename(barrel)}\` with direct imports: ${consumedModules.map((m) => basename(m)).join(', ')}`,
+                    });
+                }
+            }
+            // Suggest simplifying the barrel
+            if (siblingExports.length > 5) {
+                operations.push({
+                    type: 'MODIFY',
+                    path: barrel,
+                    description: `Simplify ${basename(barrel)}: only re-export public API (${siblingExports.length} re-exports detected, consider reducing)`,
+                });
+            }
+            if (operations.length > 0) {
+                steps.push({
+                    id: 0,
+                    tier: 1,
+                    rule: this.name,
+                    priority: outgoing.length >= 8 ? 'HIGH' : 'MEDIUM',
+                    title: `Optimize barrel: ${barrel}`,
+                    description: `\`${barrel}\` re-exports ${outgoing.length} modules. ` +
+                        `This creates a "Shotgun Surgery" risk — any change propagates widely.`,
+                    rationale: `Barrel files that re-export everything make it hard to tree-shake unused code ` +
+                        `and create implicit dependencies. Direct imports make dependency relationships explicit ` +
+                        `and reduce the blast radius of changes.`,
+                    operations,
+                    scoreImpact: [
+                        { metric: 'coupling', before: report.score.breakdown.coupling, after: Math.min(95, report.score.breakdown.coupling + 10) },
+                        { metric: 'layering', before: report.score.breakdown.layering, after: Math.min(95, report.score.breakdown.layering + 5) },
+                    ],
+                    aiPrompt: `Analyze the barrel file \`${barrel}\` which re-exports ${outgoing.length} modules. This is creating a "Shotgun Surgery" risk.\nPlease optimize it by:\n1. Removing wildcard exports (e.g., \`export *\`) if any.\n2. Only re-exporting the public API interfaces/classes meant for consumers outside this module.\n3. Updating consumers (${incoming.map(i => basename(i.from)).join(', ')}) to import from the specific files directly instead of passing through this barrel file where appropriate.`,
+                });
+            }
+        }
+        return steps;
+    }
+}
+//# sourceMappingURL=barrel-optimizer.js.map

package/dist/src/core/rules/barrel-optimizer.js.map

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

package/dist/src/core/rules/dead-code-detector.d.ts

@@ -0,0 +1,21 @@
+import { AnalysisReport } from '../types/core.js';
+import { RefactorRule, RefactorStep } from '../types/rules.js';
+/**
+ * Dead Code Detector Rule (Tier 1)
+ * Finds files with no incoming edges (nobody imports them)
+ * and exports that are never used.
+ *
+ * Handles both path-style (deepguard/report.py) and
+ * dot-notation (deepguard.report) references.
+ */
+export declare class DeadCodeDetectorRule implements RefactorRule {
+    name: string;
+    tier: 1;
+    private static readonly ENTRY_POINTS;
+    analyze(report: AnalysisReport, _projectPath: string): RefactorStep[];
+    /**
+     * Generate dot-notation variants for a file path.
+     * "deepguard/report.py" → ["deepguard.report", ".report"]
+     */
+    private getDotVariants;
+}

package/dist/src/core/rules/dead-code-detector.js

@@ -0,0 +1,116 @@
+import { basename } from 'path';
+/**
+ * Dead Code Detector Rule (Tier 1)
+ * Finds files with no incoming edges (nobody imports them)
+ * and exports that are never used.
+ *
+ * Handles both path-style (deepguard/report.py) and
+ * dot-notation (deepguard.report) references.
+ */
+export class DeadCodeDetectorRule {
+    name = 'dead-code-detector';
+    tier = 1;
+    static ENTRY_POINTS = new Set([
+        'main.py', 'cli.py', 'app.py', 'manage.py', 'wsgi.py', 'asgi.py',
+        'main.ts', 'main.js', 'app.ts', 'app.js', 'server.ts', 'server.js',
+        'index.html', 'setup.py', 'setup.cfg', 'pyproject.toml',
+    ]);
+    analyze(report, _projectPath) {
+        const steps = [];
+        const edges = report.dependencyGraph.edges;
+        // Build a set of ALL referenced targets (both path and dot-notation)
+        const allTargets = new Set();
+        const allSources = new Set();
+        for (const edge of edges) {
+            allTargets.add(edge.to);
+            allSources.add(edge.from);
+        }
+        // Only consider actual files (with path separators) as candidates
+        const fileNodes = report.dependencyGraph.nodes.filter((n) => n.includes('/') || n.includes('\\'));
+        // Build incoming edge count considering dot-notation matches
+        const incomingCount = {};
+        for (const file of fileNodes) {
+            incomingCount[file] = 0;
+            // Direct incoming edges
+            for (const edge of edges) {
+                if (edge.to === file) {
+                    incomingCount[file]++;
+                }
+            }
+            // Check dot-notation references:
+            // deepguard/report.py might be referenced as deepguard.report or .report
+            const dotVariants = this.getDotVariants(file);
+            for (const variant of dotVariants) {
+                if (allTargets.has(variant)) {
+                    incomingCount[file]++;
+                }
+            }
+        }
+        // Find orphan files
+        const orphans = [];
+        for (const [file, count] of Object.entries(incomingCount)) {
+            const fileName = basename(file);
+            // Skip entry points and config files
+            if (DeadCodeDetectorRule.ENTRY_POINTS.has(fileName))
+                continue;
+            if (fileName.startsWith('__'))
+                continue;
+            if (fileName.startsWith('.'))
+                continue;
+            if (fileName.endsWith('.test.ts') || fileName.endsWith('.spec.ts'))
+                continue;
+            if (fileName.endsWith('_test.py') || fileName.endsWith('.test.py'))
+                continue;
+            // Also skip if the file has outgoing edges (it's active code)
+            if (allSources.has(file))
+                continue;
+            if (count === 0) {
+                orphans.push(file);
+            }
+        }
+        if (orphans.length > 0) {
+            const operations = orphans.map((file) => ({
+                type: 'DELETE',
+                path: file,
+                description: `\`${basename(file)}\` has no incoming dependencies — verify if still needed`,
+            }));
+            steps.push({
+                id: 0,
+                tier: 1,
+                rule: this.name,
+                priority: orphans.length >= 3 ? 'MEDIUM' : 'LOW',
+                title: `Review ${orphans.length} potentially unused file(s)`,
+                description: `Found ${orphans.length} file(s) with no incoming dependencies: ` +
+                    `${orphans.map((f) => `\`${basename(f)}\``).join(', ')}. ` +
+                    `These may be dead code or missing from the module's public API.`,
+                rationale: `Files with zero incoming edges are either entry points (already excluded), ` +
+                    `or potentially dead code. Removing dead code reduces maintenance burden ` +
+                    `and improves modularity scores.`,
+                operations,
+                scoreImpact: [
+                    { metric: 'modularity', before: report.score.breakdown.modularity, after: Math.min(95, report.score.breakdown.modularity + 5) },
+                ],
+                aiPrompt: `Analyze the following files: ${orphans.map(f => `\`${f}\``).join(', ')}.\nThese files currently have zero incoming dependencies across the architecture, meaning they might be dead code.\nPlease review them:\n1. If they are unused, explicitly delete them to shrink the blast radius.\n2. If they are entry points that the Architect missed, add them to the ignore list or document their usage.\n3. Make sure to remove any vestigial exports or imports pointing to them from the rest of the codebase.`,
+            });
+        }
+        return steps;
+    }
+    /**
+     * Generate dot-notation variants for a file path.
+     * "deepguard/report.py" → ["deepguard.report", ".report"]
+     */
+    getDotVariants(filePath) {
+        const variants = [];
+        const withoutExt = filePath.replace(/\.[^.]+$/, '');
+        const dotPath = withoutExt.replace(/[/\\]/g, '.');
+        variants.push(dotPath);
+        // Relative dot-notation: .report
+        const parts = filePath.split('/');
+        if (parts.length >= 2) {
+            const lastPart = parts[parts.length - 1].replace(/\.[^.]+$/, '');
+            variants.push(`.${lastPart}`);
+        }
+        return variants;
+    }
+}
+//# sourceMappingURL=dead-code-detector.js.map

package/dist/src/core/rules/dead-code-detector.js.map

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

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

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

package/dist/src/core/rules/hub-splitter.js

@@ -0,0 +1,117 @@
+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 {
+    name = 'hub-splitter';
+    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;
+            // Ignora Tipos base/DTOs - Alto acoplamento em tipos é sinal de maturidade, não gargalo
+            const lowerFile = file.toLowerCase();
+            if (lowerFile.includes('types') || lowerFile.includes('interface') || lowerFile.includes('/types/')) {
+                continue;
+            }
+            // Tolerância Arquitetural: Eleva de 5 pra 8 dependentes pra engatilhar quebra (Módulos Coesos maduros)
+            if (connections.incoming.length < 8)
+                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) },
+                    ],
+                    aiPrompt: `Analyze the file \`${file}\`. Based on its incoming connections, it acts as a coupling bottleneck. Please split this file into the following smaller modules:\n` +
+                        dependentGroups.map(g => `- \`${moduleName}_${g.name}.${ext}\`: Extract functionality specific to these dependents: ${g.dependents.join(', ')}`).join('\n') +
+                        `\n\nAfter splitting, securely and automatically update all ${connections.incoming.length} dependent files to import from the new specific modules instead of the monolithic \`${moduleName}.${ext}\`. DO NOT remove any functionality, only move it.`,
+                });
+            }
+        }
+        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/src/core/rules/hub-splitter.js.map

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

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

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