@girardelli/architect 2.2.0 → 5.0.0

package/dist/analyzers/forecast.js

@@ -0,0 +1,337 @@
+/**
+ * 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 {
+    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/analyzers/forecast.js.map

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

package/dist/analyzers/git-cache.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Git History Cache — Serialize/deserialize GitHistoryReport
+ */
+import type { GitHistoryReport } from './git-history.js';
+export declare function saveToCache(report: GitHistoryReport, projectPath: string, cacheDir?: string): void;
+export declare function loadFromCache(projectPath: string, cacheDir?: string, maxAgeMs?: number): GitHistoryReport | null;
+//# sourceMappingURL=git-cache.d.ts.map

package/dist/analyzers/git-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-cache.d.ts","sourceRoot":"","sources":["../../src/analyzers/git-cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,wBAAgB,WAAW,CACzB,MAAM,EAAE,gBAAgB,EACxB,WAAW,EAAE,MAAM,EACnB,QAAQ,SAAqB,GAC5B,IAAI,CAsBN;AAED,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,QAAQ,SAAqB,EAC7B,QAAQ,SAAU,GACjB,gBAAgB,GAAG,IAAI,CAWzB"}

package/dist/analyzers/git-cache.js

@@ -0,0 +1,41 @@
+/**
+ * Git History Cache — Serialize/deserialize GitHistoryReport
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+export function saveToCache(report, projectPath, cacheDir = '.architect-cache') {
+    const dir = path.join(projectPath, cacheDir);
+    fs.mkdirSync(dir, { recursive: true });
+    const serializable = {
+        ...report,
+        modules: report.modules.map(m => ({
+            ...m,
+            files: m.files.map(f => ({
+                ...f,
+                authors: Array.from(f.authors),
+                lastModified: f.lastModified.toISOString(),
+            })),
+        })),
+        hotspots: report.hotspots.map(f => ({
+            ...f,
+            authors: Array.from(f.authors),
+            lastModified: f.lastModified.toISOString(),
+        })),
+    };
+    fs.writeFileSync(path.join(dir, 'git-history.json'), JSON.stringify(serializable, null, 2));
+}
+export function loadFromCache(projectPath, cacheDir = '.architect-cache', maxAgeMs = 3600000) {
+    const cachePath = path.join(projectPath, cacheDir, 'git-history.json');
+    if (!fs.existsSync(cachePath))
+        return null;
+    try {
+        const raw = JSON.parse(fs.readFileSync(cachePath, 'utf-8'));
+        if (Date.now() - new Date(raw.analyzedAt).getTime() > maxAgeMs)
+            return null;
+        return raw;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=git-cache.js.map

package/dist/analyzers/git-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-cache.js","sourceRoot":"","sources":["../../src/analyzers/git-cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B,MAAM,UAAU,WAAW,CACzB,MAAwB,EACxB,WAAmB,EACnB,QAAQ,GAAG,kBAAkB;IAE7B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC7C,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvC,MAAM,YAAY,GAAG;QACnB,GAAG,MAAM;QACT,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAChC,GAAG,CAAC;YACJ,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACvB,GAAG,CAAC;gBACJ,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;gBAC9B,YAAY,EAAE,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE;aAC3C,CAAC,CAAC;SACJ,CAAC,CAAC;QACH,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAClC,GAAG,CAAC;YACJ,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;YAC9B,YAAY,EAAE,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE;SAC3C,CAAC,CAAC;KACJ,CAAC;IAEF,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,WAAmB,EACnB,QAAQ,GAAG,kBAAkB,EAC7B,QAAQ,GAAG,OAAO;IAElB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC;IACvE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;QAC5D,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,GAAG,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC5E,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/analyzers/git-history.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Git History Analyzer — Temporal analysis of codebase evolution
+ *
+ * Reads git log to build velocity vectors, churn rates, and hotspot maps.
+ * Enables Architect v4's predictive capabilities.
+ *
+ * Key metrics per module:
+ * - Commit frequency (commits/week rolling 4-week average)
+ * - Churn rate (lines added + deleted per commit)
+ * - Author diversity (bus factor proxy)
+ * - Change coupling (files that change together)
+ *
+ * @author Camilo Girardelli — Girardelli Tecnologia
+ * @license MIT
+ */
+export interface GitCommit {
+    hash: string;
+    author: string;
+    date: Date;
+    message: string;
+    files: FileChange[];
+}
+export interface FileChange {
+    path: string;
+    additions: number;
+    deletions: number;
+}
+export interface FileHistory {
+    path: string;
+    commits: number;
+    totalAdditions: number;
+    totalDeletions: number;
+    churnRate: number;
+    authors: Set<string>;
+    busFactor: number;
+    lastModified: Date;
+    weeklyCommitRate: number;
+    isHotspot: boolean;
+}
+export interface ModuleHistory {
+    modulePath: string;
+    files: FileHistory[];
+    aggregateCommits: number;
+    aggregateChurn: number;
+    avgWeeklyRate: number;
+    topHotspots: FileHistory[];
+    velocityVector: VelocityVector;
+    busFactor: number;
+}
+export interface VelocityVector {
+    /** Commit rate trend: positive = accelerating, negative = decelerating */
+    commitAcceleration: number;
+    /** Churn trend: positive = increasing complexity, negative = stabilizing */
+    churnTrend: number;
+    /** Overall direction: "accelerating" | "stable" | "decelerating" */
+    direction: 'accelerating' | 'stable' | 'decelerating';
+}
+export interface ChangeCoupling {
+    fileA: string;
+    fileB: string;
+    cochangeCount: number;
+    confidence: number;
+}
+export interface GitHistoryReport {
+    projectPath: string;
+    analyzedAt: string;
+    periodWeeks: number;
+    totalCommits: number;
+    totalAuthors: number;
+    modules: ModuleHistory[];
+    hotspots: FileHistory[];
+    changeCouplings: ChangeCoupling[];
+    commitTimeline: WeeklySnapshot[];
+}
+export interface WeeklySnapshot {
+    weekStart: string;
+    commits: number;
+    churn: number;
+    activeFiles: number;
+}
+export interface GitAnalyzerConfig {
+    /** How many weeks of history to analyze (default: 24) */
+    periodWeeks?: number;
+    /** Rolling window for averages (default: 4 weeks) */
+    rollingWindowWeeks?: number;
+    /** Churn threshold to flag as hotspot (default: 500 lines) */
+    hotspotChurnThreshold?: number;
+    /** Minimum co-change count for coupling (default: 3) */
+    couplingMinCochanges?: number;
+    /** Path to cache dir (default: .architect-cache/) */
+    cacheDir?: string;
+}
+export declare class GitHistoryAnalyzer {
+    private config;
+    constructor(config?: GitAnalyzerConfig);
+    /**
+     * Analyze git history for the project at the given path.
+     * Returns a comprehensive GitHistoryReport.
+     */
+    analyze(projectPath: string): GitHistoryReport;
+    private parseGitLog;
+    private parseLogOutput;
+    private buildFileHistories;
+    private groupByModule;
+    private calculateVelocity;
+    private detectHotspots;
+    private detectChangeCoupling;
+    private buildTimeline;
+    private validateGitRepo;
+    private getSinceDate;
+    private getModulePath;
+}
+//# sourceMappingURL=git-history.d.ts.map

package/dist/analyzers/git-history.d.ts.map

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