@girardelli/architect 2.2.0 → 4.0.0

package/dist/analyzers/git-history.js

@@ -0,0 +1,333 @@
+/**
+ * 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
+ */
+import { execSync } from 'child_process';
+const DEFAULT_CONFIG = {
+    periodWeeks: 24,
+    rollingWindowWeeks: 4,
+    hotspotChurnThreshold: 500,
+    couplingMinCochanges: 3,
+    cacheDir: '.architect-cache',
+};
+// ═══════════════════════════════════════════════════════════════
+// GIT HISTORY ANALYZER
+// ═══════════════════════════════════════════════════════════════
+export class GitHistoryAnalyzer {
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Analyze git history for the project at the given path.
+     * Returns a comprehensive GitHistoryReport.
+     */
+    analyze(projectPath) {
+        this.validateGitRepo(projectPath);
+        const sinceDate = this.getSinceDate();
+        const commits = this.parseGitLog(projectPath, sinceDate);
+        const fileHistories = this.buildFileHistories(commits);
+        const modules = this.groupByModule(fileHistories);
+        const hotspots = this.detectHotspots(fileHistories);
+        const changeCouplings = this.detectChangeCoupling(commits);
+        const timeline = this.buildTimeline(commits);
+        const allAuthors = new Set();
+        commits.forEach(c => allAuthors.add(c.author));
+        return {
+            projectPath,
+            analyzedAt: new Date().toISOString(),
+            periodWeeks: this.config.periodWeeks,
+            totalCommits: commits.length,
+            totalAuthors: allAuthors.size,
+            modules,
+            hotspots,
+            changeCouplings,
+            commitTimeline: timeline,
+        };
+    }
+    // ── Git Log Parsing ──
+    parseGitLog(projectPath, since) {
+        const cmd = `git log --format='%H|%an|%aI|%s' --numstat --since="${since}" -- .`;
+        let output;
+        try {
+            output = execSync(cmd, {
+                cwd: projectPath,
+                encoding: 'utf-8',
+                maxBuffer: 10 * 1024 * 1024, // 10MB buffer for large repos
+            });
+        }
+        catch {
+            return [];
+        }
+        return this.parseLogOutput(output);
+    }
+    parseLogOutput(output) {
+        const commits = [];
+        const lines = output.trim().split('\n');
+        let current = null;
+        for (const line of lines) {
+            if (!line.trim()) {
+                // Blank lines separate numstat blocks, but also appear between
+                // the commit header and its numstat output. Only finalize a commit
+                // on blank line if it already has file changes (otherwise it's just
+                // the gap between header and numstat).
+                if (current && current.files.length > 0) {
+                    commits.push(current);
+                    current = null;
+                }
+                continue;
+            }
+            // Commit header: hash|author|date|message
+            if (line.includes('|') && !line.startsWith('\t') && /^[0-9a-f]{7,}/.test(line)) {
+                if (current)
+                    commits.push(current);
+                const parts = line.split('|');
+                if (parts.length >= 4) {
+                    current = {
+                        hash: parts[0],
+                        author: parts[1],
+                        date: new Date(parts[2]),
+                        message: parts.slice(3).join('|'),
+                        files: [],
+                    };
+                }
+                continue;
+            }
+            // Numstat line: additions\tdeletions\tfilepath
+            if (current && /^\d+\t\d+\t/.test(line)) {
+                const [add, del, filePath] = line.split('\t');
+                if (filePath && !filePath.includes('{') /* skip renames */) {
+                    current.files.push({
+                        path: filePath,
+                        additions: parseInt(add, 10) || 0,
+                        deletions: parseInt(del, 10) || 0,
+                    });
+                }
+            }
+        }
+        if (current)
+            commits.push(current);
+        return commits;
+    }
+    // ── File History Building ──
+    buildFileHistories(commits) {
+        const histories = new Map();
+        const now = new Date();
+        const windowMs = this.config.rollingWindowWeeks * 7 * 24 * 60 * 60 * 1000;
+        const windowStart = new Date(now.getTime() - windowMs);
+        for (const commit of commits) {
+            for (const file of commit.files) {
+                if (!histories.has(file.path)) {
+                    histories.set(file.path, {
+                        path: file.path,
+                        commits: 0,
+                        totalAdditions: 0,
+                        totalDeletions: 0,
+                        churnRate: 0,
+                        authors: new Set(),
+                        busFactor: 0,
+                        lastModified: commit.date,
+                        weeklyCommitRate: 0,
+                        isHotspot: false,
+                    });
+                }
+                const h = histories.get(file.path);
+                h.commits++;
+                h.totalAdditions += file.additions;
+                h.totalDeletions += file.deletions;
+                h.authors.add(commit.author);
+                if (commit.date > h.lastModified) {
+                    h.lastModified = commit.date;
+                }
+            }
+        }
+        // Calculate derived metrics
+        const recentCommits = commits.filter(c => c.date >= windowStart);
+        const weekCount = Math.max(this.config.rollingWindowWeeks, 1);
+        for (const [filePath, h] of histories) {
+            h.churnRate = h.commits > 0
+                ? (h.totalAdditions + h.totalDeletions) / h.commits
+                : 0;
+            h.busFactor = h.authors.size;
+            // Weekly commit rate from rolling window
+            const recentFileCommits = recentCommits.filter(c => c.files.some(f => f.path === filePath)).length;
+            h.weeklyCommitRate = recentFileCommits / weekCount;
+            // Hotspot: high churn + high frequency
+            h.isHotspot = (h.totalAdditions + h.totalDeletions) >= this.config.hotspotChurnThreshold
+                && h.weeklyCommitRate >= 1;
+        }
+        return histories;
+    }
+    // ── Module Grouping ──
+    groupByModule(fileHistories) {
+        const moduleMap = new Map();
+        for (const [filePath, history] of fileHistories) {
+            const modulePath = this.getModulePath(filePath);
+            if (!moduleMap.has(modulePath)) {
+                moduleMap.set(modulePath, []);
+            }
+            moduleMap.get(modulePath).push(history);
+        }
+        return Array.from(moduleMap.entries()).map(([modulePath, files]) => {
+            const aggregateCommits = files.reduce((s, f) => s + f.commits, 0);
+            const aggregateChurn = files.reduce((s, f) => s + f.totalAdditions + f.totalDeletions, 0);
+            const avgWeeklyRate = files.reduce((s, f) => s + f.weeklyCommitRate, 0) / Math.max(files.length, 1);
+            const allAuthors = new Set();
+            files.forEach(f => f.authors.forEach(a => allAuthors.add(a)));
+            const topHotspots = files
+                .filter(f => f.isHotspot)
+                .sort((a, b) => (b.totalAdditions + b.totalDeletions) - (a.totalAdditions + a.totalDeletions))
+                .slice(0, 5);
+            return {
+                modulePath,
+                files,
+                aggregateCommits,
+                aggregateChurn,
+                avgWeeklyRate,
+                topHotspots,
+                velocityVector: this.calculateVelocity(files),
+                busFactor: allAuthors.size,
+            };
+        }).sort((a, b) => b.aggregateChurn - a.aggregateChurn);
+    }
+    // ── Velocity Calculation ──
+    calculateVelocity(files) {
+        if (files.length === 0) {
+            return { commitAcceleration: 0, churnTrend: 0, direction: 'stable' };
+        }
+        // Sort files by last modified (most recent first)
+        const sorted = [...files].sort((a, b) => b.lastModified.getTime() - a.lastModified.getTime());
+        // Split into halves: recent vs older
+        const mid = Math.floor(sorted.length / 2) || 1;
+        const recentHalf = sorted.slice(0, mid);
+        const olderHalf = sorted.slice(mid);
+        const recentAvgRate = recentHalf.reduce((s, f) => s + f.weeklyCommitRate, 0) / recentHalf.length;
+        const olderAvgRate = olderHalf.length > 0
+            ? olderHalf.reduce((s, f) => s + f.weeklyCommitRate, 0) / olderHalf.length
+            : recentAvgRate;
+        const recentAvgChurn = recentHalf.reduce((s, f) => s + f.churnRate, 0) / recentHalf.length;
+        const olderAvgChurn = olderHalf.length > 0
+            ? olderHalf.reduce((s, f) => s + f.churnRate, 0) / olderHalf.length
+            : recentAvgChurn;
+        const commitAcceleration = olderAvgRate > 0
+            ? ((recentAvgRate - olderAvgRate) / olderAvgRate) * 100
+            : 0;
+        const churnTrend = olderAvgChurn > 0
+            ? ((recentAvgChurn - olderAvgChurn) / olderAvgChurn) * 100
+            : 0;
+        let direction = 'stable';
+        if (commitAcceleration > 15)
+            direction = 'accelerating';
+        else if (commitAcceleration < -15)
+            direction = 'decelerating';
+        return {
+            commitAcceleration: Math.round(commitAcceleration * 10) / 10,
+            churnTrend: Math.round(churnTrend * 10) / 10,
+            direction,
+        };
+    }
+    // ── Hotspot Detection ──
+    detectHotspots(fileHistories) {
+        return Array.from(fileHistories.values())
+            .filter(f => f.isHotspot)
+            .sort((a, b) => (b.totalAdditions + b.totalDeletions) - (a.totalAdditions + a.totalDeletions))
+            .slice(0, 20);
+    }
+    // ── Change Coupling Detection ──
+    detectChangeCoupling(commits) {
+        const cochangeMap = new Map();
+        const fileCommitCount = new Map();
+        for (const commit of commits) {
+            const files = commit.files.map(f => f.path).sort();
+            for (const f of files) {
+                fileCommitCount.set(f, (fileCommitCount.get(f) || 0) + 1);
+            }
+            // Pairwise co-change counting (limit to 10 files per commit to avoid explosion)
+            const limited = files.slice(0, 10);
+            for (let i = 0; i < limited.length; i++) {
+                for (let j = i + 1; j < limited.length; j++) {
+                    const key = `${limited[i]}|||${limited[j]}`;
+                    cochangeMap.set(key, (cochangeMap.get(key) || 0) + 1);
+                }
+            }
+        }
+        const couplings = [];
+        for (const [key, count] of cochangeMap) {
+            if (count < this.config.couplingMinCochanges)
+                continue;
+            const [fileA, fileB] = key.split('|||');
+            const maxCommits = Math.max(fileCommitCount.get(fileA) || 1, fileCommitCount.get(fileB) || 1);
+            couplings.push({
+                fileA,
+                fileB,
+                cochangeCount: count,
+                confidence: Math.round((count / maxCommits) * 100) / 100,
+            });
+        }
+        return couplings
+            .sort((a, b) => b.confidence - a.confidence)
+            .slice(0, 50);
+    }
+    // ── Timeline Building ──
+    buildTimeline(commits) {
+        if (commits.length === 0)
+            return [];
+        const snapshots = new Map();
+        const toMonday = (d) => {
+            d.setHours(0, 0, 0, 0);
+            d.setDate(d.getDate() - ((d.getDay() + 6) % 7));
+            return d.toISOString().split('T')[0];
+        };
+        const now = new Date();
+        for (let w = 0; w < this.config.periodWeeks; w++) {
+            const key = toMonday(new Date(now.getTime() - w * 604800000));
+            if (!snapshots.has(key)) {
+                snapshots.set(key, { weekStart: key, commits: 0, churn: 0, activeFiles: 0 });
+            }
+        }
+        for (const commit of commits) {
+            const key = toMonday(new Date(commit.date));
+            const snap = snapshots.get(key);
+            if (snap) {
+                snap.commits++;
+                snap.churn += commit.files.reduce((s, f) => s + f.additions + f.deletions, 0);
+                snap.activeFiles += commit.files.length;
+            }
+        }
+        return Array.from(snapshots.values()).sort((a, b) => a.weekStart.localeCompare(b.weekStart));
+    }
+    // ── Utilities ──
+    validateGitRepo(projectPath) {
+        try {
+            execSync('git rev-parse --is-inside-work-tree', {
+                cwd: projectPath,
+                encoding: 'utf-8',
+                stdio: 'pipe',
+            });
+        }
+        catch {
+            throw new Error(`Not a git repository: ${projectPath}`);
+        }
+    }
+    getSinceDate() {
+        const d = new Date();
+        d.setDate(d.getDate() - (this.config.periodWeeks * 7));
+        return d.toISOString().split('T')[0];
+    }
+    getModulePath(filePath) {
+        const parts = filePath.split('/');
+        // Use first directory as module, or "root" if no directory
+        return parts.length > 1 ? parts[0] : 'root';
+    }
+}
+//# sourceMappingURL=git-history.js.map

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

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

package/dist/analyzers/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Architect v4.0 Analyzers — Temporal & Predictive
+ */
+export { GitHistoryAnalyzer } from './git-history.js';
+export type { GitCommit, FileChange, FileHistory, ModuleHistory, VelocityVector, ChangeCoupling, GitHistoryReport, WeeklySnapshot, GitAnalyzerConfig, } from './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';
+//# sourceMappingURL=index.d.ts.map

package/dist/analyzers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analyzers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EACV,SAAS,EACT,UAAU,EACV,WAAW,EACX,aAAa,EACb,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EACV,KAAK,EACL,aAAa,EACb,cAAc,EACd,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,eAAe,EACf,cAAc,GACf,MAAM,eAAe,CAAC"}

package/dist/analyzers/index.js

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

package/dist/analyzers/index.js.map

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

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

@@ -0,0 +1,72 @@
+/**
+ * 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 './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;
+}
+//# sourceMappingURL=temporal-scorer.d.ts.map

package/dist/analyzers/temporal-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-scorer.d.ts","sourceRoot":"","sources":["../../src/analyzers/temporal-scorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAEV,cAAc,EACd,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAM1B,MAAM,MAAM,KAAK,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,yCAAyC;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gCAAgC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAClD,oBAAoB;IACpB,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,KAAK,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClC,gBAAgB,EAAE,aAAa,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,yEAAyE;IACzE,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAcD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAiC;gBAEnC,MAAM,CAAC,EAAE,oBAAoB;IAIzC;;;;;OAKG;IACH,KAAK,CACH,SAAS,EAAE,gBAAgB,EAC3B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,cAAc;IAiCjB,OAAO,CAAC,WAAW;IA6CnB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,oBAAoB;IAc5B,0EAA0E;IAC1E,OAAO,CAAC,gBAAgB;CAQzB"}

package/dist/analyzers/temporal-scorer.js

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

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

package/dist/cli.d.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
- * Architect CLI
- * Executa análise arquitetural e gera relatórios em múltiplos formatos
+ * Architect CLI v3.1
+ * Enterprise Architecture Analysis — @girardelli/architect
  *
  * Uso:
  *   npx architect analyze ./src
@@ -9,7 +9,6 @@
  *   npx architect diagram ./src
  *   npx architect score ./src
  *   npx architect anti-patterns ./src
- *   npx architect layers ./src
  */
 export {};
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;GAWG"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;GAUG"}