npm - @girardelli/architect - Versions diffs - 1.3.0 → 2.2.0 - Mend

@girardelli/architect 1.3.0 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (58) hide show

package/README.md +111 -112
package/dist/agent-generator.d.ts +106 -0
package/dist/agent-generator.d.ts.map +1 -0
package/dist/agent-generator.js +1398 -0
package/dist/agent-generator.js.map +1 -0
package/dist/cli.js +132 -15
package/dist/cli.js.map +1 -1
package/dist/html-reporter.d.ts +8 -2
package/dist/html-reporter.d.ts.map +1 -1
package/dist/html-reporter.js +773 -50
package/dist/html-reporter.js.map +1 -1
package/dist/index.d.ts +26 -2
package/dist/index.d.ts.map +1 -1
package/dist/index.js +25 -1
package/dist/index.js.map +1 -1
package/dist/refactor-engine.d.ts +18 -0
package/dist/refactor-engine.d.ts.map +1 -0
package/dist/refactor-engine.js +86 -0
package/dist/refactor-engine.js.map +1 -0
package/dist/refactor-reporter.d.ts +20 -0
package/dist/refactor-reporter.d.ts.map +1 -0
package/dist/refactor-reporter.js +389 -0
package/dist/refactor-reporter.js.map +1 -0
package/dist/rules/barrel-optimizer.d.ts +13 -0
package/dist/rules/barrel-optimizer.d.ts.map +1 -0
package/dist/rules/barrel-optimizer.js +77 -0
package/dist/rules/barrel-optimizer.js.map +1 -0
package/dist/rules/dead-code-detector.d.ts +21 -0
package/dist/rules/dead-code-detector.d.ts.map +1 -0
package/dist/rules/dead-code-detector.js +117 -0
package/dist/rules/dead-code-detector.js.map +1 -0
package/dist/rules/hub-splitter.d.ts +13 -0
package/dist/rules/hub-splitter.d.ts.map +1 -0
package/dist/rules/hub-splitter.js +110 -0
package/dist/rules/hub-splitter.js.map +1 -0
package/dist/rules/import-organizer.d.ts +13 -0
package/dist/rules/import-organizer.d.ts.map +1 -0
package/dist/rules/import-organizer.js +85 -0
package/dist/rules/import-organizer.js.map +1 -0
package/dist/rules/module-grouper.d.ts +13 -0
package/dist/rules/module-grouper.d.ts.map +1 -0
package/dist/rules/module-grouper.js +110 -0
package/dist/rules/module-grouper.js.map +1 -0
package/dist/types.d.ts +51 -0
package/dist/types.d.ts.map +1 -1
package/package.json +1 -1
package/src/agent-generator.ts +1526 -0
package/src/cli.ts +150 -15
package/src/html-reporter.ts +799 -51
package/src/index.ts +39 -1
package/src/refactor-engine.ts +117 -0
package/src/refactor-reporter.ts +408 -0
package/src/rules/barrel-optimizer.ts +97 -0
package/src/rules/dead-code-detector.ts +132 -0
package/src/rules/hub-splitter.ts +123 -0
package/src/rules/import-organizer.ts +98 -0
package/src/rules/module-grouper.ts +124 -0
package/src/types.ts +52 -0

package/dist/refactor-reporter.js ADDED Viewed

@@ -0,0 +1,389 @@
+/**
+ * Generates interactive HTML report for refactoring plans.
+ * Includes step-by-step roadmap, score predictions, and file operation previews.
+ */
+export class RefactorReportGenerator {
+    generateHtml(plan) {
+        return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Architect Refactoring Plan</title>
+${this.getStyles()}
+</head>
+<body>
+${this.renderHeader(plan)}
+<div class="container">
+  ${this.renderScoreComparison(plan)}
+  ${this.renderSummaryStats(plan)}
+  ${this.renderRoadmap(plan)}
+</div>
+${this.renderFooter()}
+</body>
+</html>`;
+    }
+    scoreColor(score) {
+        if (score >= 70)
+            return '#22c55e';
+        if (score >= 50)
+            return '#f59e0b';
+        return '#ef4444';
+    }
+    escapeHtml(text) {
+        return text
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;');
+    }
+    opColor(type) {
+        switch (type) {
+            case 'CREATE': return '#22c55e';
+            case 'MOVE': return '#3b82f6';
+            case 'MODIFY': return '#f59e0b';
+            case 'DELETE': return '#ef4444';
+            default: return '#64748b';
+        }
+    }
+    opIcon(type) {
+        switch (type) {
+            case 'CREATE': return '➕';
+            case 'MOVE': return '📦';
+            case 'MODIFY': return '✏️';
+            case 'DELETE': return '🗑️';
+            default: return '📄';
+        }
+    }
+    renderHeader(plan) {
+        const date = new Date(plan.timestamp).toLocaleDateString('en-US', {
+            year: 'numeric', month: 'long', day: 'numeric',
+        });
+        return `
+<div class="header">
+  <h1>🔧 Architect — Refactoring Plan</h1>
+  <p class="subtitle">Actionable roadmap to improve your architecture</p>
+  <div class="meta">
+    <span>📂 <strong>${this.escapeHtml(plan.projectPath)}</strong></span>
+    <span>📋 <strong>${plan.steps.length}</strong> steps</span>
+    <span>🔄 <strong>${plan.totalOperations}</strong> operations</span>
+    <span>📅 <strong>${date}</strong></span>
+  </div>
+</div>`;
+    }
+    renderScoreComparison(plan) {
+        const current = plan.currentScore;
+        const estimated = plan.estimatedScoreAfter;
+        const improvement = estimated.overall - current.overall;
+        const metrics = Object.keys(current.breakdown);
+        const bars = metrics.map(metric => {
+            const before = current.breakdown[metric];
+            const after = estimated.breakdown[metric];
+            const diff = after - before;
+            return `
+      <div class="comparison-row">
+        <div class="metric-name">${metric}</div>
+        <div class="metric-bars">
+          <div class="bar-before" style="width: ${before}%; background: ${this.scoreColor(before)}40">
+            <span>${before}</span>
+          </div>
+          <div class="bar-after" style="width: ${after}%; background: ${this.scoreColor(after)}">
+            <span>${after}</span>
+          </div>
+        </div>
+        <div class="metric-diff" style="color: ${diff > 0 ? '#22c55e' : '#64748b'}">
+          ${diff > 0 ? `+${diff}` : diff === 0 ? '—' : diff}
+        </div>
+      </div>`;
+        }).join('');
+        return `
+<h2 class="section-title">📊 Score Prediction</h2>
+<div class="card score-comparison">
+  <div class="score-pair">
+    <div class="score-box">
+      <div class="score-num" style="color: ${this.scoreColor(current.overall)}">${current.overall}</div>
+      <div class="score-label">Current</div>
+    </div>
+    <div class="score-arrow">
+      <svg width="60" height="30" viewBox="0 0 60 30">
+        <path d="M5 15 L45 15 M40 8 L48 15 L40 22" stroke="#818cf8" stroke-width="2.5" fill="none"/>
+      </svg>
+    </div>
+    <div class="score-box">
+      <div class="score-num" style="color: ${this.scoreColor(estimated.overall)}">${estimated.overall}</div>
+      <div class="score-label">Estimated</div>
+    </div>
+    <div class="score-diff" style="color: #22c55e">+${improvement} pts</div>
+  </div>
+  <div class="score-bars-section">
+    <div class="bars-legend">
+      <span class="legend-tag before">Before</span>
+      <span class="legend-tag after">After</span>
+    </div>
+    ${bars}
+  </div>
+</div>`;
+    }
+    renderSummaryStats(plan) {
+        const criticalCount = plan.steps.filter(s => s.priority === 'CRITICAL').length;
+        const highCount = plan.steps.filter(s => s.priority === 'HIGH').length;
+        const mediumCount = plan.steps.filter(s => s.priority === 'MEDIUM').length;
+        const lowCount = plan.steps.filter(s => s.priority === 'LOW').length;
+        return `
+<div class="stats-grid">
+  <div class="stat-card">
+    <div class="value">${plan.steps.length}</div>
+    <div class="label">Total Steps</div>
+  </div>
+  <div class="stat-card">
+    <div class="value">${plan.tier1Steps}</div>
+    <div class="label">Tier 1 (Rules)</div>
+  </div>
+  <div class="stat-card">
+    <div class="value">${plan.tier2Steps}</div>
+    <div class="label">Tier 2 (AST)</div>
+  </div>
+  <div class="stat-card">
+    <div class="value">${plan.totalOperations}</div>
+    <div class="label">File Operations</div>
+  </div>
+</div>
+<div class="priority-bar">
+  ${criticalCount ? `<div class="prio-seg prio-critical" style="flex: ${criticalCount}">🔴 ${criticalCount}</div>` : ''}
+  ${highCount ? `<div class="prio-seg prio-high" style="flex: ${highCount}">🟠 ${highCount}</div>` : ''}
+  ${mediumCount ? `<div class="prio-seg prio-medium" style="flex: ${mediumCount}">🔵 ${mediumCount}</div>` : ''}
+  ${lowCount ? `<div class="prio-seg prio-low" style="flex: ${lowCount}">🟢 ${lowCount}</div>` : ''}
+</div>`;
+    }
+    renderRoadmap(plan) {
+        if (plan.steps.length === 0) {
+            return `
+<h2 class="section-title">✅ No Refactoring Needed</h2>
+<div class="card success-card">
+  <p>Your architecture is clean! No refactoring suggestions at this time.</p>
+</div>`;
+        }
+        const stepsHtml = plan.steps.map(step => this.renderStep(step)).join('');
+        return `
+<h2 class="section-title">🗺️ Refactoring Roadmap</h2>
+<div class="roadmap">
+  ${stepsHtml}
+</div>`;
+    }
+    renderStep(step) {
+        const operationsHtml = step.operations.map(op => `
+      <div class="operation">
+        <span class="op-icon">${this.opIcon(op.type)}</span>
+        <span class="op-badge" style="background: ${this.opColor(op.type)}20; color: ${this.opColor(op.type)}; border: 1px solid ${this.opColor(op.type)}40">${op.type}</span>
+        <code class="op-path">${this.escapeHtml(op.path)}</code>
+        ${op.newPath ? `<span class="op-arrow">→</span> <code class="op-path">${this.escapeHtml(op.newPath)}</code>` : ''}
+        <div class="op-desc">${this.escapeHtml(op.description)}</div>
+      </div>
+    `).join('');
+        const impactHtml = step.scoreImpact.map(i => `<span class="impact-tag">${i.metric}: ${i.before}→${i.after} <span class="impact-diff">+${i.after - i.before}</span></span>`).join('');
+        return `
+<div class="step-card" data-priority="${step.priority}">
+  <div class="step-header">
+    <div class="step-number">${step.id}</div>
+    <div class="step-info">
+      <div class="step-title-row">
+        <h3>${this.escapeHtml(step.title)}</h3>
+        <span class="severity-badge severity-${step.priority}">${step.priority}</span>
+        <span class="tier-badge">Tier ${step.tier}</span>
+      </div>
+      <p class="step-desc">${this.escapeHtml(step.description)}</p>
+      <details class="step-details">
+        <summary>📖 Why?</summary>
+        <p class="rationale">${this.escapeHtml(step.rationale)}</p>
+      </details>
+    </div>
+  </div>
+  <div class="step-operations">
+    <h4>📋 Operations (${step.operations.length})</h4>
+    ${operationsHtml}
+  </div>
+  <div class="step-impact">
+    <h4>📈 Score Impact</h4>
+    <div class="impact-tags">${impactHtml}</div>
+  </div>
+</div>`;
+    }
+    renderFooter() {
+        return `
+<div class="footer">
+  <p>Generated by <a href="https://github.com/camilooscargbaptista/architect">🏗️ Architect v2.0</a> — Refactoring Engine</p>
+  <p>By <strong>Camilo Girardelli</strong> · <a href="https://www.girardellitecnologia.com">Girardelli Tecnologia</a></p>
+</div>`;
+    }
+    getStyles() {
+        return `<style>
+  @import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700;800;900&display=swap');
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  body {
+    font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif;
+    background: #0f172a; color: #e2e8f0; line-height: 1.6; min-height: 100vh;
+  }
+  .container { max-width: 1100px; margin: 0 auto; padding: 2rem; }
+  .header {
+    text-align: center; padding: 3rem 2rem;
+    background: linear-gradient(135deg, #1e293b 0%, #0f172a 50%, #1e1b4b 100%);
+    border-bottom: 1px solid #334155; margin-bottom: 2rem;
+  }
+  .header h1 {
+    font-size: 2.5rem; font-weight: 900;
+    background: linear-gradient(135deg, #818cf8, #c084fc, #f472b6);
+    -webkit-background-clip: text; -webkit-text-fill-color: transparent;
+    margin-bottom: 0.5rem;
+  }
+  .header .subtitle { color: #94a3b8; font-size: 1.1rem; font-weight: 300; }
+  .header .meta {
+    margin-top: 1rem; display: flex; justify-content: center; gap: 1rem; flex-wrap: wrap;
+  }
+  .header .meta span {
+    background: #1e293b; padding: 0.4rem 1rem; border-radius: 99px;
+    font-size: 0.85rem; color: #94a3b8; border: 1px solid #334155;
+  }
+  .header .meta span strong { color: #e2e8f0; }
+  .section-title {
+    font-size: 1.4rem; font-weight: 700; margin: 2.5rem 0 1rem;
+    display: flex; align-items: center; gap: 0.5rem;
+  }
+  .card {
+    background: #1e293b; border-radius: 16px; border: 1px solid #334155;
+    padding: 1.5rem; margin-bottom: 1rem;
+  }
+  .success-card { border-color: #22c55e40; color: #22c55e; text-align: center; padding: 2rem; }
+  /* Score Comparison */
+  .score-comparison { padding: 2rem; }
+  .score-pair {
+    display: flex; align-items: center; justify-content: center; gap: 1.5rem;
+    margin-bottom: 2rem; flex-wrap: wrap;
+  }
+  .score-box { text-align: center; }
+  .score-num { font-size: 3.5rem; font-weight: 900; line-height: 1; }
+  .score-label { font-size: 0.85rem; color: #94a3b8; text-transform: uppercase; letter-spacing: 1px; }
+  .score-diff { font-size: 1.5rem; font-weight: 700; }
+  .bars-legend { display: flex; gap: 1rem; margin-bottom: 0.5rem; }
+  .legend-tag { font-size: 0.75rem; padding: 0.2rem 0.6rem; border-radius: 6px; }
+  .legend-tag.before { background: rgba(255,255,255,0.05); color: #94a3b8; }
+  .legend-tag.after { background: rgba(129,140,248,0.2); color: #818cf8; }
+  .comparison-row {
+    display: flex; align-items: center; gap: 1rem; margin-bottom: 0.5rem;
+  }
+  .metric-name { width: 100px; font-size: 0.8rem; text-transform: uppercase; color: #94a3b8; font-weight: 600; }
+  .metric-bars { flex: 1; position: relative; height: 30px; }
+  .bar-before, .bar-after {
+    position: absolute; top: 0; left: 0; height: 15px; border-radius: 4px;
+    display: flex; align-items: center; padding-left: 6px;
+    font-size: 0.7rem; font-weight: 600; transition: width 1s ease;
+  }
+  .bar-before { top: 0; }
+  .bar-after { top: 16px; }
+  .metric-diff { width: 50px; text-align: right; font-weight: 700; font-size: 0.85rem; }
+  /* Stats */
+  .stats-grid { display: grid; grid-template-columns: repeat(4, 1fr); gap: 1rem; margin-bottom: 1rem; }
+  .stat-card {
+    background: linear-gradient(135deg, #1e293b, #0f172a);
+    border: 1px solid #334155; border-radius: 16px; padding: 1.5rem; text-align: center;
+  }
+  .stat-card .value {
+    font-size: 2rem; font-weight: 800;
+    background: linear-gradient(135deg, #818cf8, #c084fc);
+    -webkit-background-clip: text; -webkit-text-fill-color: transparent;
+  }
+  .stat-card .label { font-size: 0.85rem; color: #94a3b8; margin-top: 0.3rem; }
+  .priority-bar {
+    display: flex; border-radius: 12px; overflow: hidden; height: 32px; margin-bottom: 2rem;
+  }
+  .prio-seg {
+    display: flex; align-items: center; justify-content: center;
+    font-size: 0.75rem; font-weight: 600;
+  }
+  .prio-critical { background: #ef444430; color: #ef4444; }
+  .prio-high { background: #f59e0b30; color: #f59e0b; }
+  .prio-medium { background: #3b82f630; color: #60a5fa; }
+  .prio-low { background: #22c55e30; color: #22c55e; }
+  /* Steps */
+  .roadmap { display: flex; flex-direction: column; gap: 1rem; }
+  .step-card {
+    background: #1e293b; border-radius: 16px; border: 1px solid #334155;
+    padding: 1.5rem; transition: border-color 0.2s;
+  }
+  .step-card:hover { border-color: #818cf8; }
+  .step-header { display: flex; gap: 1rem; margin-bottom: 1rem; }
+  .step-number {
+    width: 40px; height: 40px; border-radius: 50%;
+    background: linear-gradient(135deg, #818cf8, #c084fc);
+    display: flex; align-items: center; justify-content: center;
+    font-weight: 800; font-size: 1rem; color: white; flex-shrink: 0;
+  }
+  .step-info { flex: 1; }
+  .step-title-row { display: flex; align-items: center; gap: 0.5rem; flex-wrap: wrap; }
+  .step-title-row h3 { font-size: 1.1rem; font-weight: 700; }
+  .step-desc { color: #94a3b8; font-size: 0.9rem; margin-top: 0.3rem; }
+  .severity-badge {
+    display: inline-block; padding: 0.15rem 0.5rem; border-radius: 99px;
+    font-size: 0.65rem; font-weight: 600; letter-spacing: 0.5px;
+  }
+  .severity-CRITICAL { background: #dc262620; color: #ef4444; border: 1px solid #ef444440; }
+  .severity-HIGH { background: #f59e0b20; color: #f59e0b; border: 1px solid #f59e0b40; }
+  .severity-MEDIUM { background: #3b82f620; color: #60a5fa; border: 1px solid #60a5fa40; }
+  .severity-LOW { background: #22c55e20; color: #22c55e; border: 1px solid #22c55e40; }
+  .tier-badge {
+    background: #818cf815; color: #818cf8; border: 1px solid #818cf830;
+    padding: 0.15rem 0.5rem; border-radius: 99px; font-size: 0.65rem; font-weight: 600;
+  }
+  .step-details { margin-top: 0.5rem; }
+  .step-details summary { cursor: pointer; color: #818cf8; font-size: 0.85rem; font-weight: 500; }
+  .rationale { color: #64748b; font-size: 0.85rem; margin-top: 0.3rem; font-style: italic; }
+  .step-operations { margin-top: 1rem; padding-top: 1rem; border-top: 1px solid #334155; }
+  .step-operations h4 { font-size: 0.85rem; color: #94a3b8; margin-bottom: 0.5rem; }
+  .operation { display: flex; align-items: flex-start; gap: 0.5rem; margin-bottom: 0.5rem; flex-wrap: wrap; }
+  .op-icon { font-size: 0.9rem; }
+  .op-badge { padding: 0.1rem 0.4rem; border-radius: 6px; font-size: 0.65rem; font-weight: 700; }
+  .op-path { background: #0f172a; padding: 1px 6px; border-radius: 4px; font-size: 0.8rem; color: #c084fc; }
+  .op-arrow { color: #818cf8; font-weight: 700; }
+  .op-desc { width: 100%; color: #64748b; font-size: 0.8rem; padding-left: 1.8rem; }
+  .step-impact { margin-top: 0.5rem; }
+  .step-impact h4 { font-size: 0.85rem; color: #94a3b8; margin-bottom: 0.3rem; }
+  .impact-tags { display: flex; gap: 0.5rem; flex-wrap: wrap; }
+  .impact-tag {
+    background: #22c55e10; color: #22c55e; border: 1px solid #22c55e30;
+    padding: 0.2rem 0.6rem; border-radius: 8px; font-size: 0.75rem; font-weight: 500;
+  }
+  .impact-diff { font-weight: 700; }
+  .footer {
+    text-align: center; padding: 2rem; color: #475569; font-size: 0.85rem;
+    border-top: 1px solid #1e293b; margin-top: 3rem;
+  }
+  .footer a { color: #818cf8; text-decoration: none; }
+  @media (max-width: 768px) {
+    .stats-grid { grid-template-columns: repeat(2, 1fr); }
+    .score-pair { flex-direction: column; }
+    .container { padding: 1rem; }
+  }
+  @media print {
+    body { background: white; color: #1e293b; }
+    .card, .step-card, .stat-card { background: white; border-color: #e2e8f0; }
+  }
+</style>`;
+    }
+}
+//# sourceMappingURL=refactor-reporter.js.map

package/dist/refactor-reporter.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/rules/barrel-optimizer.d.ts ADDED Viewed

@@ -0,0 +1,13 @@
+import { AnalysisReport, RefactorRule, RefactorStep } from '../types.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[];
+}
+//# sourceMappingURL=barrel-optimizer.d.ts.map

package/dist/rules/barrel-optimizer.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"barrel-optimizer.d.ts","sourceRoot":"","sources":["../../src/rules/barrel-optimizer.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,CAAC,QAAQ,CAAC,YAAY,CAEjC;IAEH,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE;CAgFrE"}

package/dist/rules/barrel-optimizer.js ADDED Viewed

@@ -0,0 +1,77 @@
+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 {
+    constructor() {
+        this.name = 'barrel-optimizer';
+        this.tier = 1;
+    }
+    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) },
+                    ],
+                });
+            }
+        }
+        return steps;
+    }
+}
+BarrelOptimizerRule.BARREL_FILES = new Set([
+    '__init__.py', 'index.ts', 'index.js', 'index.tsx', 'index.jsx',
+]);
+//# sourceMappingURL=barrel-optimizer.js.map

package/dist/rules/barrel-optimizer.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/rules/dead-code-detector.d.ts ADDED Viewed

@@ -0,0 +1,21 @@
+import { AnalysisReport, RefactorRule, RefactorStep } from '../types.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;
+}
+//# sourceMappingURL=dead-code-detector.d.ts.map

package/dist/rules/dead-code-detector.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"dead-code-detector.d.ts","sourceRoot":"","sources":["../../src/rules/dead-code-detector.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAiB,MAAM,aAAa,CAAC;AAExF;;;;;;;GAOG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,IAAI,SAAwB;IAC5B,IAAI,EAAG,CAAC,CAAU;IAElB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAIjC;IAEH,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE;IA0FpE;;;OAGG;IACH,OAAO,CAAC,cAAc;CAgBvB"}

package/dist/rules/dead-code-detector.js ADDED Viewed

@@ -0,0 +1,117 @@
+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 {
+    constructor() {
+        this.name = 'dead-code-detector';
+        this.tier = 1;
+    }
+    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) },
+                ],
+            });
+        }
+        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;
+    }
+}
+DeadCodeDetectorRule.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',
+]);
+//# sourceMappingURL=dead-code-detector.js.map

package/dist/rules/dead-code-detector.js.map ADDED Viewed

@@ -0,0 +1 @@

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