@girardelli/architect-core 8.1.0

package/dist/src/core/analyzers/forecast.js

@@ -0,0 +1,338 @@
+/**
+ * Architecture Weather Forecast — Predictive analysis
+ *
+ * Combines temporal scores + velocity vectors + change coupling
+ * to predict which modules will become anti-patterns.
+ *
+ * Key concept: Pre-Anti-Pattern
+ * A module isn't an anti-pattern yet, but its trajectory says it will be.
+ * "Your code doesn't have a problem — it WILL have one in 3 months."
+ *
+ * @author Camilo Girardelli — Girardelli Tecnologia
+ * @license MIT
+ */
+const DEFAULT_CONFIG = {
+    antiPatternThreshold: 40,
+    godClassChurnThreshold: 150,
+    shotgunCouplingThreshold: 5,
+    busFatorRiskThreshold: 1,
+    forecastWeeks: 26,
+};
+// ═══════════════════════════════════════════════════════════════
+// FORECAST ENGINE
+// ═══════════════════════════════════════════════════════════════
+export class ForecastEngine {
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Generate architecture weather forecast.
+     */
+    forecast(gitReport, temporalReport) {
+        const preAntiPatterns = [];
+        const moduleForecastMap = new Map();
+        // Detect pre-anti-patterns for each module
+        for (const module of gitReport.modules) {
+            const temporal = temporalReport.modules.find(m => m.module === module.modulePath);
+            if (!temporal)
+                continue;
+            const patterns = this.detectPreAntiPatterns(module, temporal, gitReport.changeCouplings);
+            preAntiPatterns.push(...patterns);
+            const forecast = this.forecastModule(module, temporal, patterns);
+            moduleForecastMap.set(module.modulePath, forecast);
+        }
+        // Sort by risk
+        const modules = Array.from(moduleForecastMap.values())
+            .sort((a, b) => b.bottleneckProbability - a.bottleneckProbability);
+        const outlook = this.classifyOutlook(temporalReport, preAntiPatterns);
+        const headline = this.generateHeadline(outlook, preAntiPatterns, modules);
+        const topRisks = this.identifyTopRisks(modules, preAntiPatterns);
+        const recommendations = this.generateRecommendations(modules, preAntiPatterns);
+        return {
+            projectPath: gitReport.projectPath,
+            generatedAt: new Date().toISOString(),
+            overallOutlook: outlook,
+            headline,
+            modules,
+            preAntiPatterns: preAntiPatterns.sort((a, b) => a.weeksToThreshold - b.weeksToThreshold),
+            topRisks,
+            recommendations,
+        };
+    }
+    // ── Pre-Anti-Pattern Detection ──
+    detectPreAntiPatterns(module, temporal, couplings) {
+        const patterns = [];
+        patterns.push(...this.detectEmergingGodClass(module, temporal));
+        patterns.push(...this.detectEmergingShotgunSurgery(module, couplings));
+        patterns.push(...this.detectBusFactorRisk(module, temporal));
+        patterns.push(...this.detectComplexitySpiral(module, temporal));
+        patterns.push(...this.detectCouplingMagnet(module, couplings, temporal));
+        return patterns;
+    }
+    detectEmergingGodClass(module, temporal) {
+        const patterns = [];
+        for (const file of module.files) {
+            if (file.churnRate < this.config.godClassChurnThreshold)
+                continue;
+            if (temporal.velocity.churnTrend <= 0)
+                continue;
+            // Project when churn will exceed critical threshold
+            const weeklyGrowth = file.churnRate * (temporal.velocity.churnTrend / 100) / 4;
+            const criticalChurn = this.config.godClassChurnThreshold * 2;
+            const weeksToThreshold = weeklyGrowth > 0
+                ? Math.ceil((criticalChurn - file.churnRate) / weeklyGrowth)
+                : Infinity;
+            if (weeksToThreshold <= this.config.forecastWeeks) {
+                patterns.push({
+                    type: 'emerging-god-class',
+                    module: module.modulePath,
+                    severity: weeksToThreshold <= 8 ? 'alert' : weeksToThreshold <= 16 ? 'warning' : 'watch',
+                    currentScore: temporal.staticScore,
+                    projectedScore: temporal.projectedScore,
+                    weeksToThreshold,
+                    threshold: criticalChurn,
+                    description: `File '${file.path}' has churn rate ${Math.round(file.churnRate)} lines/commit and growing ${Math.round(temporal.velocity.churnTrend)}%`,
+                    evidence: [
+                        `Current churn: ${Math.round(file.churnRate)} lines/commit`,
+                        `Growth rate: ${Math.round(temporal.velocity.churnTrend)}%`,
+                        `${file.commits} commits in analysis period`,
+                        `${file.authors.size} contributor(s)`,
+                    ],
+                    recommendation: 'Split into smaller, focused modules before complexity makes refactoring prohibitively expensive.',
+                    confidence: Math.min(0.9, 0.5 + (file.commits / 50)),
+                });
+            }
+        }
+        return patterns;
+    }
+    detectEmergingShotgunSurgery(module, couplings) {
+        // Count how many files this module is coupled with
+        const moduleCouplings = couplings.filter(c => c.fileA.startsWith(module.modulePath) || c.fileB.startsWith(module.modulePath));
+        if (moduleCouplings.length < this.config.shotgunCouplingThreshold)
+            return [];
+        const avgConfidence = moduleCouplings.reduce((s, c) => s + c.confidence, 0) / moduleCouplings.length;
+        return [{
+                type: 'emerging-shotgun-surgery',
+                module: module.modulePath,
+                severity: moduleCouplings.length > 10 ? 'alert' : 'warning',
+                currentScore: 0,
+                projectedScore: 0,
+                weeksToThreshold: 4,
+                threshold: this.config.shotgunCouplingThreshold,
+                description: `Module '${module.modulePath}' has ${moduleCouplings.length} change-coupled files — changes here ripple across the codebase`,
+                evidence: [
+                    `${moduleCouplings.length} files change together with this module`,
+                    `Average coupling confidence: ${Math.round(avgConfidence * 100)}%`,
+                    ...moduleCouplings.slice(0, 3).map(c => `${c.fileA} ↔ ${c.fileB} (${c.cochangeCount} co-changes)`),
+                ],
+                recommendation: 'Extract shared concerns into a dedicated module. Introduce interfaces to decouple.',
+                confidence: avgConfidence,
+            }];
+    }
+    detectBusFactorRisk(module, temporal) {
+        if (module.busFactor > this.config.busFatorRiskThreshold)
+            return [];
+        if (module.aggregateCommits < 5)
+            return []; // too few commits to judge
+        return [{
+                type: 'bus-factor-risk',
+                module: module.modulePath,
+                severity: temporal.trend === 'degrading' ? 'alert' : 'warning',
+                currentScore: temporal.staticScore,
+                projectedScore: temporal.projectedScore,
+                weeksToThreshold: this.config.forecastWeeks,
+                threshold: 2,
+                description: `Module '${module.modulePath}' has bus factor of ${module.busFactor} — all knowledge in one person`,
+                evidence: [
+                    `Only ${module.busFactor} contributor(s)`,
+                    `${module.aggregateCommits} total commits`,
+                    `${module.files.length} files in module`,
+                ],
+                recommendation: 'Pair programming or code review rotation to spread knowledge. Document critical decisions.',
+                confidence: 0.8,
+            }];
+    }
+    detectComplexitySpiral(module, temporal) {
+        if (temporal.velocity.churnTrend <= 20)
+            return [];
+        if (temporal.velocity.direction !== 'accelerating')
+            return [];
+        // Accelerating churn + increasing commit rate = complexity spiral
+        const weeklyScoreDecay = (temporal.staticScore - temporal.projectedScore) / temporal.projectionWeeks;
+        const weeksToThreshold = weeklyScoreDecay > 0
+            ? Math.ceil((temporal.temporalScore - this.config.antiPatternThreshold) / weeklyScoreDecay)
+            : Infinity;
+        if (weeksToThreshold > this.config.forecastWeeks)
+            return [];
+        return [{
+                type: 'complexity-spiral',
+                module: module.modulePath,
+                severity: weeksToThreshold <= 8 ? 'alert' : 'warning',
+                currentScore: temporal.temporalScore,
+                projectedScore: temporal.projectedScore,
+                weeksToThreshold,
+                threshold: this.config.antiPatternThreshold,
+                description: `Module '${module.modulePath}' is in a complexity spiral — accelerating churn with increasing commit frequency`,
+                evidence: [
+                    `Churn trend: +${Math.round(temporal.velocity.churnTrend)}%`,
+                    `Commit acceleration: +${Math.round(temporal.velocity.commitAcceleration)}%`,
+                    `Current temporal score: ${temporal.temporalScore}/100`,
+                    `Projected score in ${temporal.projectionWeeks} weeks: ${temporal.projectedScore}/100`,
+                ],
+                recommendation: 'Stop adding features to this module. Invest in refactoring and test coverage first.',
+                confidence: temporal.projectionConfidence,
+            }];
+    }
+    detectCouplingMagnet(module, couplings, temporal) {
+        // Files that are increasingly coupled with many others
+        const inboundCouplings = couplings.filter(c => c.fileB.startsWith(module.modulePath) && c.confidence > 0.5);
+        if (inboundCouplings.length < 3)
+            return [];
+        if (temporal.velocity.commitAcceleration <= 0)
+            return [];
+        return [{
+                type: 'coupling-magnet',
+                module: module.modulePath,
+                severity: 'watch',
+                currentScore: temporal.staticScore,
+                projectedScore: temporal.projectedScore,
+                weeksToThreshold: 12,
+                threshold: 10,
+                description: `Module '${module.modulePath}' is becoming a coupling magnet — ${inboundCouplings.length} high-confidence inbound dependencies`,
+                evidence: [
+                    `${inboundCouplings.length} modules depend on changes here`,
+                    `Module commit rate accelerating: +${Math.round(temporal.velocity.commitAcceleration)}%`,
+                ],
+                recommendation: 'Extract stable interfaces. Consider the Dependency Inversion Principle to break inbound coupling.',
+                confidence: 0.6,
+            }];
+    }
+    // ── Module Forecast ──
+    forecastModule(module, temporal, patterns) {
+        const health = this.classifyHealth(temporal);
+        const forecast6m = this.classify6MonthForecast(temporal, patterns);
+        const bottleneckProb = this.calculateBottleneckProbability(temporal, patterns, module);
+        const riskFactors = [];
+        if (temporal.trend === 'degrading')
+            riskFactors.push('Score degrading');
+        if (module.busFactor <= 1)
+            riskFactors.push('Single contributor');
+        if (temporal.velocity.churnTrend > 30)
+            riskFactors.push('Churn increasing');
+        if (patterns.length > 0)
+            riskFactors.push(`${patterns.length} pre-anti-pattern(s)`);
+        const topAction = patterns.length > 0
+            ? patterns[0].recommendation
+            : temporal.trend === 'degrading'
+                ? 'Review recent changes and stabilize'
+                : 'No action needed';
+        return {
+            module: module.modulePath,
+            currentHealth: health,
+            forecast6Months: forecast6m,
+            preAntiPatterns: patterns,
+            bottleneckProbability: bottleneckProb,
+            riskFactors,
+            topAction,
+        };
+    }
+    classifyHealth(temporal) {
+        if (temporal.temporalScore < 30)
+            return 'critical';
+        if (temporal.temporalScore < 50 || temporal.trend === 'degrading')
+            return 'degrading';
+        if (temporal.temporalScore < 70)
+            return 'at-risk';
+        return 'healthy';
+    }
+    classify6MonthForecast(temporal, patterns) {
+        const alerts = patterns.filter(p => p.severity === 'alert');
+        if (alerts.length > 0 || temporal.projectedScore < 30)
+            return 'breakdown';
+        if (temporal.trend === 'degrading' || patterns.length > 0)
+            return 'declining';
+        return 'stable';
+    }
+    calculateBottleneckProbability(temporal, patterns, module) {
+        let prob = 0;
+        // Low score → higher probability
+        if (temporal.temporalScore < 50)
+            prob += 0.3;
+        else if (temporal.temporalScore < 70)
+            prob += 0.1;
+        // Degrading trend
+        if (temporal.trend === 'degrading')
+            prob += 0.2;
+        // Pre-anti-patterns
+        prob += Math.min(0.3, patterns.length * 0.1);
+        // Low bus factor
+        if (module.busFactor <= 1)
+            prob += 0.1;
+        // High churn
+        if (temporal.velocity.churnTrend > 30)
+            prob += 0.1;
+        return Math.min(1, Math.round(prob * 100) / 100);
+    }
+    // ── Overall Analysis ──
+    classifyOutlook(temporal, patterns) {
+        const alerts = patterns.filter(p => p.severity === 'alert');
+        if (alerts.length >= 2 || temporal.overallTrend === 'degrading')
+            return 'stormy';
+        if (alerts.length >= 1 || patterns.length >= 3)
+            return 'cloudy';
+        return 'sunny';
+    }
+    generateHeadline(outlook, patterns, modules) {
+        const critical = modules.filter(m => m.currentHealth === 'critical').length;
+        const degrading = modules.filter(m => m.currentHealth === 'degrading').length;
+        switch (outlook) {
+            case 'stormy':
+                return `${critical + degrading} module(s) at risk. ${patterns.length} pre-anti-pattern(s) detected. Immediate action recommended.`;
+            case 'cloudy':
+                return `Architecture trending stable with ${patterns.length} emerging concern(s). Proactive refactoring recommended.`;
+            case 'sunny':
+                return 'Architecture is healthy and stable. Continue current practices.';
+        }
+    }
+    identifyTopRisks(modules, patterns) {
+        const risks = [];
+        const breakdowns = modules.filter(m => m.forecast6Months === 'breakdown');
+        if (breakdowns.length > 0) {
+            risks.push(`${breakdowns.length} module(s) projected to break down within 6 months: ${breakdowns.map(m => m.module).join(', ')}`);
+        }
+        const busRisks = patterns.filter(p => p.type === 'bus-factor-risk');
+        if (busRisks.length > 0) {
+            risks.push(`Bus factor risk in ${busRisks.length} module(s) — knowledge concentrated in single contributors`);
+        }
+        const spirals = patterns.filter(p => p.type === 'complexity-spiral');
+        if (spirals.length > 0) {
+            risks.push(`Complexity spiral detected in: ${spirals.map(p => p.module).join(', ')}`);
+        }
+        return risks.slice(0, 5);
+    }
+    generateRecommendations(modules, patterns) {
+        const recs = [];
+        const critical = modules.filter(m => m.currentHealth === 'critical');
+        if (critical.length > 0) {
+            recs.push(`Immediate: Stabilize ${critical.map(m => m.module).join(', ')} — freeze features, invest in refactoring`);
+        }
+        const godClasses = patterns.filter(p => p.type === 'emerging-god-class');
+        if (godClasses.length > 0) {
+            recs.push(`Split growing files before they become god classes: ${godClasses.map(p => p.module).join(', ')}`);
+        }
+        const shotgun = patterns.filter(p => p.type === 'emerging-shotgun-surgery');
+        if (shotgun.length > 0) {
+            recs.push(`Decouple modules with high change coupling to prevent shotgun surgery`);
+        }
+        const busRisks = patterns.filter(p => p.type === 'bus-factor-risk');
+        if (busRisks.length > 0) {
+            recs.push(`Spread knowledge: pair programming or rotation for ${busRisks.map(p => p.module).join(', ')}`);
+        }
+        if (recs.length === 0) {
+            recs.push('Architecture is healthy. Continue monitoring temporal trends.');
+        }
+        return recs.slice(0, 5);
+    }
+}
+//# sourceMappingURL=forecast.js.map

package/dist/src/core/analyzers/forecast.js.map

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

package/dist/src/core/analyzers/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Architect v4.0 Analyzers — Temporal & Predictive
+ */
+export { GitHistoryAnalyzer } from '../../infrastructure/git-history.js';
+export type { GitCommit, FileChange, FileHistory, ModuleHistory, VelocityVector, ChangeCoupling, GitHistoryReport, WeeklySnapshot, GitAnalyzerConfig, } from '../../infrastructure/git-history.js';
+export { TemporalScorer } from './temporal-scorer.js';
+export type { Trend, TemporalScore, TemporalReport, TemporalScorerConfig, } from './temporal-scorer.js';
+export { ForecastEngine } from './forecast.js';
+export type { PreAntiPatternType, PreAntiPattern, ModuleForecast, WeatherForecast, ForecastConfig, } from './forecast.js';

package/dist/src/core/analyzers/index.js

@@ -0,0 +1,7 @@
+/**
+ * Architect v4.0 Analyzers — Temporal & Predictive
+ */
+export { GitHistoryAnalyzer } from '../../infrastructure/git-history.js';
+export { TemporalScorer } from './temporal-scorer.js';
+export { ForecastEngine } from './forecast.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/analyzers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/analyzers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAazE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQtD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/src/core/analyzers/temporal-scorer.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Temporal Score Dimension — Adds time-series awareness to architecture scoring
+ *
+ * Combines current static score with historical velocity to produce:
+ * - Trend per module (improving / stable / degrading)
+ * - Temporal risk score (static score penalized by negative velocity)
+ * - Projected score in N weeks
+ *
+ * @author Camilo Girardelli — Girardelli Tecnologia
+ * @license MIT
+ */
+import type { VelocityVector, GitHistoryReport } from '../../infrastructure/git-history.js';
+export type Trend = 'improving' | 'stable' | 'degrading';
+export interface TemporalScore {
+    /** Module or file path */
+    module: string;
+    /** Current static score (from ArchitectureScorer) */
+    staticScore: number;
+    /** Temporal-adjusted score (penalizes degrading trends) */
+    temporalScore: number;
+    /** Direction of change */
+    trend: Trend;
+    /** Projected score in projectionWeeks */
+    projectedScore: number;
+    /** Confidence in the projection (0-1) */
+    projectionConfidence: number;
+    /** Weeks used for projection */
+    projectionWeeks: number;
+    /** Risk level derived from temporal analysis */
+    riskLevel: 'low' | 'medium' | 'high' | 'critical';
+    /** Velocity data */
+    velocity: VelocityVector;
+}
+export interface TemporalReport {
+    projectPath: string;
+    analyzedAt: string;
+    overallTrend: Trend;
+    overallTemporalScore: number;
+    modules: TemporalScore[];
+    degradingModules: TemporalScore[];
+    improvingModules: TemporalScore[];
+}
+export interface TemporalScorerConfig {
+    /** Weeks ahead to project (default: 12) */
+    projectionWeeks?: number;
+    /** Weight of churn trend in temporal penalty (0-1, default: 0.6) */
+    churnWeight?: number;
+    /** Weight of commit acceleration in temporal penalty (0-1, default: 0.4) */
+    commitWeight?: number;
+    /** Threshold for trend classification: accelerating if > threshold % */
+    acceleratingThreshold?: number;
+    /** Threshold for trend classification: decelerating if < -threshold % */
+    deceleratingThreshold?: number;
+}
+export declare class TemporalScorer {
+    private config;
+    constructor(config?: TemporalScorerConfig);
+    /**
+     * Score modules temporally using git history + static scores.
+     *
+     * @param gitReport - Output from GitHistoryAnalyzer
+     * @param staticScores - Map of modulePath → static score (0-100)
+     */
+    score(gitReport: GitHistoryReport, staticScores: Map<string, number>): TemporalReport;
+    private scoreModule;
+    private classifyTrend;
+    private classifyRisk;
+    private classifyOverallTrend;
+    /** Infer a static score when none is provided (based on churn metrics) */
+    private inferStaticScore;
+}

package/dist/src/core/analyzers/temporal-scorer.js

@@ -0,0 +1,141 @@
+/**
+ * Temporal Score Dimension — Adds time-series awareness to architecture scoring
+ *
+ * Combines current static score with historical velocity to produce:
+ * - Trend per module (improving / stable / degrading)
+ * - Temporal risk score (static score penalized by negative velocity)
+ * - Projected score in N weeks
+ *
+ * @author Camilo Girardelli — Girardelli Tecnologia
+ * @license MIT
+ */
+const DEFAULT_CONFIG = {
+    projectionWeeks: 12,
+    churnWeight: 0.6,
+    commitWeight: 0.4,
+    acceleratingThreshold: 15,
+    deceleratingThreshold: -15,
+};
+// ═══════════════════════════════════════════════════════════════
+// TEMPORAL SCORER
+// ═══════════════════════════════════════════════════════════════
+export class TemporalScorer {
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Score modules temporally using git history + static scores.
+     *
+     * @param gitReport - Output from GitHistoryAnalyzer
+     * @param staticScores - Map of modulePath → static score (0-100)
+     */
+    score(gitReport, staticScores) {
+        const modules = [];
+        for (const moduleHistory of gitReport.modules) {
+            const staticScore = staticScores.get(moduleHistory.modulePath)
+                ?? this.inferStaticScore(moduleHistory);
+            const ts = this.scoreModule(moduleHistory, staticScore);
+            modules.push(ts);
+        }
+        // Sort by risk (worst first)
+        modules.sort((a, b) => a.temporalScore - b.temporalScore);
+        const degrading = modules.filter(m => m.trend === 'degrading');
+        const improving = modules.filter(m => m.trend === 'improving');
+        const overallTrend = this.classifyOverallTrend(modules);
+        const overallScore = modules.length > 0
+            ? Math.round(modules.reduce((s, m) => s + m.temporalScore, 0) / modules.length)
+            : 0;
+        return {
+            projectPath: gitReport.projectPath,
+            analyzedAt: new Date().toISOString(),
+            overallTrend: overallTrend,
+            overallTemporalScore: overallScore,
+            modules,
+            degradingModules: degrading,
+            improvingModules: improving,
+        };
+    }
+    scoreModule(module, staticScore) {
+        const velocity = module.velocityVector;
+        // Calculate temporal penalty based on velocity
+        const churnPenalty = velocity.churnTrend > 0
+            ? velocity.churnTrend * this.config.churnWeight * 0.3 // 30% impact per 100% churn increase
+            : velocity.churnTrend * this.config.churnWeight * 0.1; // 10% bonus per 100% churn decrease
+        const commitPenalty = velocity.commitAcceleration > 20
+            ? (velocity.commitAcceleration - 20) * this.config.commitWeight * 0.2 // penalty for excessive churn
+            : 0;
+        const totalPenalty = Math.max(-20, Math.min(30, churnPenalty + commitPenalty));
+        const temporalScore = Math.max(0, Math.min(100, Math.round(staticScore - totalPenalty)));
+        // Trend classification
+        const trend = this.classifyTrend(velocity);
+        // Linear projection
+        const weeklyDelta = totalPenalty / Math.max(this.config.projectionWeeks, 1);
+        const projectedScore = Math.max(0, Math.min(100, Math.round(temporalScore - (weeklyDelta * this.config.projectionWeeks))));
+        // Confidence decreases with projection distance and instability
+        const instability = Math.abs(velocity.churnTrend) + Math.abs(velocity.commitAcceleration);
+        const projectionConfidence = Math.max(0.1, Math.min(1, 1 - (instability / 200) - (this.config.projectionWeeks / 52)));
+        const riskLevel = this.classifyRisk(temporalScore, trend, module.busFactor);
+        return {
+            module: module.modulePath,
+            staticScore,
+            temporalScore,
+            trend,
+            projectedScore,
+            projectionConfidence: Math.round(projectionConfidence * 100) / 100,
+            projectionWeeks: this.config.projectionWeeks,
+            riskLevel,
+            velocity,
+        };
+    }
+    classifyTrend(velocity) {
+        // Degrading: churn increasing significantly or commit acceleration very high
+        if (velocity.churnTrend > 30 || velocity.commitAcceleration > 50) {
+            return 'degrading';
+        }
+        // Improving: churn decreasing and stable or decelerating
+        if (velocity.churnTrend < -10 && velocity.direction !== 'accelerating') {
+            return 'improving';
+        }
+        return 'stable';
+    }
+    classifyRisk(temporalScore, trend, busFactor) {
+        if (temporalScore < 30 || (temporalScore < 50 && trend === 'degrading')) {
+            return 'critical';
+        }
+        if (temporalScore < 50 || (trend === 'degrading' && busFactor <= 1)) {
+            return 'high';
+        }
+        if (temporalScore < 70 || trend === 'degrading') {
+            return 'medium';
+        }
+        return 'low';
+    }
+    classifyOverallTrend(modules) {
+        if (modules.length === 0)
+            return 'stable';
+        const degrading = modules.filter(m => m.trend === 'degrading').length;
+        const improving = modules.filter(m => m.trend === 'improving').length;
+        const degradingRatio = degrading / modules.length;
+        const improvingRatio = improving / modules.length;
+        if (degradingRatio > 0.3)
+            return 'degrading';
+        if (improvingRatio > 0.3)
+            return 'improving';
+        return 'stable';
+    }
+    /** Infer a static score when none is provided (based on churn metrics) */
+    inferStaticScore(module) {
+        const avgChurn = module.aggregateChurn / Math.max(module.aggregateCommits, 1);
+        if (avgChurn < 20)
+            return 85;
+        if (avgChurn < 50)
+            return 75;
+        if (avgChurn < 100)
+            return 65;
+        if (avgChurn < 200)
+            return 50;
+        return 35;
+    }
+}
+//# sourceMappingURL=temporal-scorer.js.map

package/dist/src/core/analyzers/temporal-scorer.js.map

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

package/dist/src/core/anti-patterns.d.ts

@@ -0,0 +1,28 @@
+import { AntiPattern, ArchitectConfig } from './types/core.js';
+import { FileNode } from './types/infrastructure.js';
+import type { CustomAntiPatternDetector } from './types/plugin.js';
+export declare class AntiPatternDetector {
+    private config;
+    private dependencyGraph;
+    /** Paths that indicate third-party or build artifacts — never report anti-patterns here */
+    private static readonly EXCLUDED_PATH_SEGMENTS;
+    private customDetectors;
+    private pluginContext?;
+    constructor(config: ArchitectConfig);
+    setCustomDetectors(detectors: CustomAntiPatternDetector[]): void;
+    /**
+     * Check if a file path belongs to the project's own source code.
+     * Returns false for node_modules, dist, build artifacts, etc.
+     */
+    private isProjectFile;
+    detect(fileTree: FileNode, dependencies: Map<string, Set<string>>): Promise<AntiPattern[]>;
+    private detectGodClasses;
+    private detectCircularDependencies;
+    private findCycle;
+    private detectLeakyAbstractions;
+    private detectFeatureEnvy;
+    private detectShotgunSurgery;
+    private countMethods;
+    private countInternalExports;
+    private walkFileTree;
+}