repo-wrapped 0.0.7 → 0.0.9

package/dist/features/velocity/analyzer.test.js

@@ -0,0 +1,383 @@
+"use strict";
+/**
+ * Unit tests for Velocity Analyzer
+ *
+ * Tests the analyzeVelocity function which calculates:
+ * - Weekly commit timeline
+ * - Rolling averages
+ * - Trend detection (increasing, decreasing, stable, volatile)
+ * - Peak and lowest weeks
+ * - Anomaly detection (spikes, drops, zero-activity)
+ *
+ * @spec TEST-02 - Core Analyzers Unit Tests
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const analyzer_1 = require("./analyzer");
+const date_fns_1 = require("date-fns");
+// ============================================================================
+// Test Helpers
+// ============================================================================
+function createCommit(date, overrides = {}) {
+    return {
+        hash: `hash-${date.getTime()}`,
+        author: 'Test Author',
+        date: date.toISOString(),
+        message: 'test: commit message',
+        ...overrides,
+    };
+}
+function createCommitsForWeek(weekStart, count) {
+    const commits = [];
+    for (let i = 0; i < count; i++) {
+        // Spread commits across the week
+        const day = i % 5; // Mon-Fri
+        commits.push(createCommit((0, date_fns_1.addDays)(weekStart, day)));
+    }
+    return commits;
+}
+function createCommitsOverWeeks(startDate, weeklyCommits) {
+    const commits = [];
+    let currentWeek = startDate;
+    for (const count of weeklyCommits) {
+        commits.push(...createCommitsForWeek(currentWeek, count));
+        currentWeek = (0, date_fns_1.addDays)(currentWeek, 7);
+    }
+    return commits;
+}
+// ============================================================================
+// Tests
+// ============================================================================
+(0, vitest_1.describe)('analyzeVelocity', () => {
+    // ==========================================================================
+    // Empty/Basic Input
+    // ==========================================================================
+    (0, vitest_1.describe)('empty input', () => {
+        (0, vitest_1.it)('returns empty analysis for empty commits', () => {
+            const result = (0, analyzer_1.analyzeVelocity)([]);
+            (0, vitest_1.expect)(result.timeline).toEqual([]);
+            (0, vitest_1.expect)(result.averageCommitsPerWeek).toBe(0);
+            (0, vitest_1.expect)(result.overallTrend).toBe('stable');
+            (0, vitest_1.expect)(result.anomalies).toEqual([]);
+        });
+    });
+    (0, vitest_1.describe)('basic calculations', () => {
+        (0, vitest_1.it)('creates weekly timeline for commits', () => {
+            const start = new Date('2025-06-02'); // Monday
+            const end = new Date('2025-06-15'); // Sunday of week 2
+            const commits = [
+                createCommit(new Date('2025-06-02')), // Week 1
+                createCommit(new Date('2025-06-03')),
+                createCommit(new Date('2025-06-09')), // Week 2
+            ];
+            const result = (0, analyzer_1.analyzeVelocity)(commits, start, end);
+            (0, vitest_1.expect)(result.timeline.length).toBeGreaterThanOrEqual(2);
+        });
+        (0, vitest_1.it)('calculates average commits per week', () => {
+            const start = new Date('2025-06-02');
+            const end = new Date('2025-06-29');
+            // 4 weeks with 5, 3, 7, 5 commits = 20 total / 4 weeks = 5 avg
+            const commits = createCommitsOverWeeks(start, [5, 3, 7, 5]);
+            const result = (0, analyzer_1.analyzeVelocity)(commits, start, end);
+            (0, vitest_1.expect)(result.averageCommitsPerWeek).toBeCloseTo(5, 0);
+        });
+        (0, vitest_1.it)('tracks multiple authors in a week', () => {
+            const start = new Date('2025-06-02');
+            const end = new Date('2025-06-08');
+            const commits = [
+                createCommit(new Date('2025-06-02'), { author: 'Alice' }),
+                createCommit(new Date('2025-06-03'), { author: 'Bob' }),
+                createCommit(new Date('2025-06-04'), { author: 'Alice' }),
+            ];
+            const result = (0, analyzer_1.analyzeVelocity)(commits, start, end);
+            (0, vitest_1.expect)(result.timeline[0].authors).toContain('Alice');
+            (0, vitest_1.expect)(result.timeline[0].authors).toContain('Bob');
+            (0, vitest_1.expect)(result.timeline[0].authors.length).toBe(2);
+        });
+    });
+    // ==========================================================================
+    // Rolling Averages
+    // ==========================================================================
+    (0, vitest_1.describe)('rolling averages', () => {
+        (0, vitest_1.it)('calculates rolling average with default 4-week window', () => {
+            const start = new Date('2025-06-02');
+            const end = new Date('2025-07-27');
+            // 8 weeks of commits
+            const commits = createCommitsOverWeeks(start, [4, 4, 4, 4, 8, 8, 8, 8]);
+            const result = (0, analyzer_1.analyzeVelocity)(commits, start, end);
+            // Week 8 should have higher rolling average than week 4
+            // due to increased commits in weeks 5-8
+            (0, vitest_1.expect)(result.timeline.length).toBeGreaterThanOrEqual(8);
+        });
+        (0, vitest_1.it)('uses custom window size from options', () => {
+            const start = new Date('2025-06-02');
+            const end = new Date('2025-06-29');
+            const commits = createCommitsOverWeeks(start, [2, 4, 6, 8]);
+            // Use 2-week window
+            const result = (0, analyzer_1.analyzeVelocity)(commits, start, end, 2);
+            // Each point should use 2-week rolling window
+            (0, vitest_1.expect)(result.timeline.length).toBeGreaterThanOrEqual(4);
+            // Week 4 rolling avg should be avg of weeks 3,4 = (6+8)/2 = 7
+            const week4 = result.timeline[result.timeline.length - 1];
+            (0, vitest_1.expect)(week4.rollingAverage).toBeGreaterThanOrEqual(5);
+        });
+    });
+    // ==========================================================================
+    // Trend Detection
+    // ==========================================================================
+    (0, vitest_1.describe)('trend detection', () => {
+        (0, vitest_1.it)('detects increasing trend', () => {
+            const start = new Date('2025-01-06');
+            const end = new Date('2025-03-30');
+            // 12 weeks: starts low, ends high
+            const commits = createCommitsOverWeeks(start, [2, 2, 2, 3, 4, 5, 6, 7, 8, 9, 10, 10]);
+            const result = (0, analyzer_1.analyzeVelocity)(commits, start, end);
+            (0, vitest_1.expect)(result.overallTrend).toBe('increasing');
+            (0, vitest_1.expect)(result.trendPercentage).toBeGreaterThan(0);
+        });
+        (0, vitest_1.it)('detects decreasing trend', () => {
+            const start = new Date('2025-01-06');
+            const end = new Date('2025-03-30');
+            // 12 weeks: starts high, ends low
+            const commits = createCommitsOverWeeks(start, [10, 10, 9, 8, 7, 6, 5, 4, 3, 2, 2, 2]);
+            const result = (0, analyzer_1.analyzeVelocity)(commits, start, end);
+            (0, vitest_1.expect)(result.overallTrend).toBe('decreasing');
+            (0, vitest_1.expect)(result.trendPercentage).toBeLessThan(0);
+        });
+        (0, vitest_1.it)('detects stable trend', () => {
+            const start = new Date('2025-01-06');
+            const end = new Date('2025-03-30');
+            // 12 weeks: consistent activity
+            const commits = createCommitsOverWeeks(start, [5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5]);
+            const result = (0, analyzer_1.analyzeVelocity)(commits, start, end);
+            (0, vitest_1.expect)(result.overallTrend).toBe('stable');
+        });
+        (0, vitest_1.it)('detects volatile trend with high variance', () => {
+            const start = new Date('2025-01-06');
+            const end = new Date('2025-03-30');
+            // 12 weeks: wild swings
+            const commits = createCommitsOverWeeks(start, [1, 15, 2, 20, 1, 18, 2, 16, 1, 17, 2, 15]);
+            const result = (0, analyzer_1.analyzeVelocity)(commits, start, end);
+            (0, vitest_1.expect)(result.overallTrend).toBe('volatile');
+        });
+        (0, vitest_1.it)('returns stable for short timelines', () => {
+            const start = new Date('2025-06-02');
+            const end = new Date('2025-06-15');
+            const commits = createCommitsOverWeeks(start, [5, 10]);
+            const result = (0, analyzer_1.analyzeVelocity)(commits, start, end);
+            // Too few weeks to determine trend
+            (0, vitest_1.expect)(result.overallTrend).toBe('stable');
+        });
+    });
+    // ==========================================================================
+    // Peak and Lowest Weeks
+    // ==========================================================================
+    (0, vitest_1.describe)('peak and lowest weeks', () => {
+        (0, vitest_1.it)('identifies peak week correctly', () => {
+            const start = new Date('2025-06-02');
+            const end = new Date('2025-06-29');
+            // Week 3 has the most commits (10)
+            const commits = createCommitsOverWeeks(start, [3, 5, 10, 4]);
+            const result = (0, analyzer_1.analyzeVelocity)(commits, start, end);
+            (0, vitest_1.expect)(result.peakWeek.commits).toBe(10);
+        });
+        (0, vitest_1.it)('identifies lowest non-zero week correctly', () => {
+            const start = new Date('2025-06-02');
+            const end = new Date('2025-06-29');
+            // Week 1 has the fewest commits (2)
+            const commits = createCommitsOverWeeks(start, [2, 5, 8, 6]);
+            const result = (0, analyzer_1.analyzeVelocity)(commits, start, end);
+            (0, vitest_1.expect)(result.lowestWeek.commits).toBe(2);
+        });
+        (0, vitest_1.it)('handles all-zero weeks for lowest', () => {
+            const start = new Date('2025-06-02');
+            const end = new Date('2025-06-15');
+            // No commits at all
+            const commits = [];
+            const result = (0, analyzer_1.analyzeVelocity)(commits, start, end);
+            (0, vitest_1.expect)(result.lowestWeek.commits).toBe(0);
+        });
+    });
+    // ==========================================================================
+    // Anomaly Detection
+    // ==========================================================================
+    (0, vitest_1.describe)('anomaly detection', () => {
+        (0, vitest_1.it)('detects critical drop (>60% decrease)', () => {
+            const start = new Date('2025-06-02');
+            const end = new Date('2025-07-20');
+            // Consistent 10 commits, then sudden drop to 2
+            const commits = createCommitsOverWeeks(start, [10, 10, 10, 10, 10, 2, 5]);
+            const result = (0, analyzer_1.analyzeVelocity)(commits, start, end);
+            const criticalDrops = result.anomalies.filter((a) => a.type === 'drop' && a.severity === 'critical');
+            (0, vitest_1.expect)(criticalDrops.length).toBeGreaterThan(0);
+        });
+        (0, vitest_1.it)('detects significant drop (>40% decrease)', () => {
+            const start = new Date('2025-06-02');
+            const end = new Date('2025-07-20');
+            // 10 commits/week, then 5 (50% drop)
+            const commits = createCommitsOverWeeks(start, [10, 10, 10, 10, 10, 5, 8]);
+            const result = (0, analyzer_1.analyzeVelocity)(commits, start, end);
+            const significantDrops = result.anomalies.filter((a) => a.type === 'drop' && (a.severity === 'significant' || a.severity === 'critical'));
+            (0, vitest_1.expect)(significantDrops.length).toBeGreaterThan(0);
+        });
+        (0, vitest_1.it)('detects significant spike (>100% increase)', () => {
+            const start = new Date('2025-06-02');
+            const end = new Date('2025-07-20');
+            // Consistent 5 commits, then jump to 15
+            const commits = createCommitsOverWeeks(start, [5, 5, 5, 5, 5, 15, 6]);
+            const result = (0, analyzer_1.analyzeVelocity)(commits, start, end);
+            const spikes = result.anomalies.filter((a) => a.type === 'spike' && a.severity === 'significant');
+            (0, vitest_1.expect)(spikes.length).toBeGreaterThan(0);
+        });
+        (0, vitest_1.it)('detects zero-activity weeks', () => {
+            const start = new Date('2025-06-02');
+            const end = new Date('2025-06-29');
+            // Week 3 has no commits
+            const commits = [
+                ...createCommitsForWeek(new Date('2025-06-02'), 5),
+                ...createCommitsForWeek(new Date('2025-06-09'), 5),
+                // Week 3: no commits
+                ...createCommitsForWeek(new Date('2025-06-23'), 5),
+            ];
+            const result = (0, analyzer_1.analyzeVelocity)(commits, start, end);
+            const zeroActivity = result.anomalies.filter((a) => a.type === 'zero-activity');
+            (0, vitest_1.expect)(zeroActivity.length).toBeGreaterThan(0);
+        });
+        (0, vitest_1.it)('includes possible causes for anomalies', () => {
+            const start = new Date('2025-06-02');
+            const end = new Date('2025-07-06');
+            const commits = createCommitsOverWeeks(start, [10, 10, 10, 10, 2]); // Big drop
+            const result = (0, analyzer_1.analyzeVelocity)(commits, start, end);
+            const drops = result.anomalies.filter((a) => a.type === 'drop');
+            if (drops.length > 0) {
+                (0, vitest_1.expect)(drops[0].possibleCauses).toBeDefined();
+                (0, vitest_1.expect)(drops[0].possibleCauses.length).toBeGreaterThan(0);
+            }
+        });
+        (0, vitest_1.it)('returns no anomalies for consistent activity', () => {
+            const start = new Date('2025-06-02');
+            const end = new Date('2025-06-29');
+            // Consistent 5 commits/week
+            const commits = createCommitsOverWeeks(start, [5, 5, 5, 5]);
+            const result = (0, analyzer_1.analyzeVelocity)(commits, start, end);
+            // May have minor anomalies but no critical ones
+            const criticalAnomalies = result.anomalies.filter((a) => a.severity === 'critical');
+            (0, vitest_1.expect)(criticalAnomalies.length).toBe(0);
+        });
+    });
+    // ==========================================================================
+    // Weekly Breakdown
+    // ==========================================================================
+    (0, vitest_1.describe)('weekly breakdown', () => {
+        (0, vitest_1.it)('groups commits by week correctly', () => {
+            const start = new Date('2025-06-02'); // Monday
+            const end = new Date('2025-06-15'); // End of week 2
+            const commits = [
+                createCommit(new Date('2025-06-02')), // Week 1 Mon
+                createCommit(new Date('2025-06-05')), // Week 1 Thu
+                createCommit(new Date('2025-06-06')), // Week 1 Fri
+                createCommit(new Date('2025-06-09')), // Week 2 Mon
+            ];
+            const result = (0, analyzer_1.analyzeVelocity)(commits, start, end);
+            // Week 1 should have 3 commits
+            const week1 = result.timeline[0];
+            (0, vitest_1.expect)(week1.commits).toBe(3);
+            // Week 2 should have 1 commit
+            const week2 = result.timeline[1];
+            (0, vitest_1.expect)(week2.commits).toBe(1);
+        });
+        (0, vitest_1.it)('includes week start and end dates', () => {
+            const start = new Date('2025-06-02');
+            const end = new Date('2025-06-08');
+            const commits = [createCommit(new Date('2025-06-04'))];
+            const result = (0, analyzer_1.analyzeVelocity)(commits, start, end);
+            (0, vitest_1.expect)(result.timeline[0].weekStart).toBeInstanceOf(Date);
+            (0, vitest_1.expect)(result.timeline[0].weekEnd).toBeInstanceOf(Date);
+        });
+    });
+    // ==========================================================================
+    // Context-based API
+    // ==========================================================================
+    (0, vitest_1.describe)('context-based API', () => {
+        (0, vitest_1.it)('works with AnalyzerContext', () => {
+            const commits = createCommitsOverWeeks(new Date('2025-06-02'), [5, 8, 3]);
+            const ctx = {
+                commits,
+                dateRange: {
+                    start: new Date('2025-06-02'),
+                    end: new Date('2025-06-22'),
+                },
+                author: 'Test Author',
+            };
+            const result = (0, analyzer_1.analyzeVelocity)(ctx);
+            (0, vitest_1.expect)(result.timeline.length).toBeGreaterThanOrEqual(3);
+        });
+        (0, vitest_1.it)('respects windowWeeks option from context', () => {
+            const commits = createCommitsOverWeeks(new Date('2025-06-02'), [2, 4, 6, 8]);
+            const ctx = {
+                commits,
+                dateRange: {
+                    start: new Date('2025-06-02'),
+                    end: new Date('2025-06-29'),
+                },
+                author: 'Test Author',
+                options: {
+                    windowWeeks: 2,
+                },
+            };
+            const result = (0, analyzer_1.analyzeVelocity)(ctx);
+            // Should use 2-week rolling window
+            (0, vitest_1.expect)(result.timeline.length).toBeGreaterThanOrEqual(4);
+        });
+    });
+});
+// ============================================================================
+// formatVelocityInsights Tests
+// ============================================================================
+(0, vitest_1.describe)('formatVelocityInsights', () => {
+    (0, vitest_1.it)('returns empty message for no data', () => {
+        const analysis = {
+            timeline: [],
+            overallTrend: 'stable',
+            trendPercentage: 0,
+            averageCommitsPerWeek: 0,
+            peakWeek: { weekStart: new Date(), commits: 0 },
+            lowestWeek: { weekStart: new Date(), commits: 0 },
+            anomalies: [],
+        };
+        const insights = (0, analyzer_1.formatVelocityInsights)(analysis);
+        (0, vitest_1.expect)(insights).toContain('No velocity data available');
+    });
+    (0, vitest_1.it)('includes trend information', () => {
+        const start = new Date('2025-06-02');
+        const commits = createCommitsOverWeeks(start, [5, 5, 5, 5]);
+        const analysis = (0, analyzer_1.analyzeVelocity)(commits, start, new Date('2025-06-29'));
+        const insights = (0, analyzer_1.formatVelocityInsights)(analysis);
+        (0, vitest_1.expect)(insights.some((i) => i.toLowerCase().includes('trend'))).toBe(true);
+    });
+    (0, vitest_1.it)('includes average commits per week', () => {
+        const start = new Date('2025-06-02');
+        const commits = createCommitsOverWeeks(start, [5, 5, 5, 5]);
+        const analysis = (0, analyzer_1.analyzeVelocity)(commits, start, new Date('2025-06-29'));
+        const insights = (0, analyzer_1.formatVelocityInsights)(analysis);
+        (0, vitest_1.expect)(insights.some((i) => i.includes('commits/week'))).toBe(true);
+    });
+    (0, vitest_1.it)('includes peak week information', () => {
+        const start = new Date('2025-06-02');
+        const commits = createCommitsOverWeeks(start, [5, 10, 5, 5]);
+        const analysis = (0, analyzer_1.analyzeVelocity)(commits, start, new Date('2025-06-29'));
+        const insights = (0, analyzer_1.formatVelocityInsights)(analysis);
+        (0, vitest_1.expect)(insights.some((i) => i.toLowerCase().includes('peak'))).toBe(true);
+    });
+    (0, vitest_1.it)('reports critical drops', () => {
+        const start = new Date('2025-06-02');
+        const commits = createCommitsOverWeeks(start, [10, 10, 10, 10, 1]);
+        const analysis = (0, analyzer_1.analyzeVelocity)(commits, start, new Date('2025-07-06'));
+        const insights = (0, analyzer_1.formatVelocityInsights)(analysis);
+        // Should mention critical drops if detected
+        const hasCriticalDrops = analysis.anomalies.some((a) => a.type === 'drop' && a.severity === 'critical');
+        if (hasCriticalDrops) {
+            (0, vitest_1.expect)(insights.some((i) => i.toLowerCase().includes('drop'))).toBe(true);
+        }
+    });
+});

package/dist/features/velocity/index.js

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildVelocitySection = exports.formatVelocityInsights = exports.analyzeVelocity = void 0;
+/**
+ * Velocity Feature
+ * @module features/velocity
+ */
+__exportStar(require("./types"), exports);
+var analyzer_1 = require("./analyzer");
+Object.defineProperty(exports, "analyzeVelocity", { enumerable: true, get: function () { return analyzer_1.analyzeVelocity; } });
+Object.defineProperty(exports, "formatVelocityInsights", { enumerable: true, get: function () { return analyzer_1.formatVelocityInsights; } });
+var template_1 = require("./template");
+Object.defineProperty(exports, "buildVelocitySection", { enumerable: true, get: function () { return template_1.buildVelocitySection; } });

package/dist/features/velocity/template.js

@@ -0,0 +1,189 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildVelocitySection = buildVelocitySection;
+const date_fns_1 = require("date-fns");
+function buildVelocitySection(velocity) {
+    if (velocity.timeline.length === 0) {
+        return `
+      <div class="velocity-section">
+        <h2>📈 Velocity Analysis</h2>
+        <div class="empty-state">No velocity data available</div>
+      </div>
+    `;
+    }
+    const chartHtml = buildVelocityChart(velocity);
+    const statsHtml = buildVelocityStats(velocity);
+    const anomaliesHtml = buildAnomaliesList(velocity.anomalies);
+    return `
+    <div class="velocity-section">
+      <h2>📈 Velocity Analysis</h2>
+      
+      ${statsHtml}
+      
+      <div class="velocity-chart-container">
+        <h3>Commits Per Week</h3>
+        ${chartHtml}
+      </div>
+      
+      ${anomaliesHtml}
+    </div>
+  `;
+}
+function buildVelocityStats(velocity) {
+    const trendEmoji = velocity.overallTrend === 'increasing' ? '📈' :
+        velocity.overallTrend === 'decreasing' ? '📉' :
+            velocity.overallTrend === 'volatile' ? '📊' : '➡️';
+    const trendClass = velocity.overallTrend === 'increasing' ? 'positive' :
+        velocity.overallTrend === 'decreasing' ? 'negative' : 'neutral';
+    const trendSign = velocity.trendPercentage >= 0 ? '+' : '';
+    return `
+    <div class="velocity-stats">
+      <div class="velocity-stat-card">
+        <div class="stat-icon">${trendEmoji}</div>
+        <div class="stat-info">
+          <div class="stat-label">Overall Trend</div>
+          <div class="stat-value ${trendClass}">${velocity.overallTrend}</div>
+          <div class="stat-detail">${trendSign}${velocity.trendPercentage}% over period</div>
+        </div>
+      </div>
+      <div class="velocity-stat-card">
+        <div class="stat-icon">📊</div>
+        <div class="stat-info">
+          <div class="stat-label">Average</div>
+          <div class="stat-value">${velocity.averageCommitsPerWeek}</div>
+          <div class="stat-detail">commits/week</div>
+        </div>
+      </div>
+      <div class="velocity-stat-card">
+        <div class="stat-icon">🚀</div>
+        <div class="stat-info">
+          <div class="stat-label">Peak Week</div>
+          <div class="stat-value">${velocity.peakWeek.commits}</div>
+          <div class="stat-detail">${(0, date_fns_1.format)(velocity.peakWeek.weekStart, 'MMM d, yyyy')}</div>
+        </div>
+      </div>
+      <div class="velocity-stat-card">
+        <div class="stat-icon">🐢</div>
+        <div class="stat-info">
+          <div class="stat-label">Lowest Week</div>
+          <div class="stat-value">${velocity.lowestWeek.commits}</div>
+          <div class="stat-detail">${(0, date_fns_1.format)(velocity.lowestWeek.weekStart, 'MMM d, yyyy')}</div>
+        </div>
+      </div>
+    </div>
+  `;
+}
+function buildVelocityChart(velocity) {
+    const timeline = velocity.timeline;
+    const maxCommits = Math.max(...timeline.map(d => d.commits), 1);
+    const chartWidth = 800;
+    const chartHeight = 200;
+    const padding = { top: 20, right: 20, bottom: 40, left: 50 };
+    const innerWidth = chartWidth - padding.left - padding.right;
+    const innerHeight = chartHeight - padding.top - padding.bottom;
+    // Build SVG path for commits
+    const xScale = (i) => padding.left + (i / (timeline.length - 1 || 1)) * innerWidth;
+    const yScale = (v) => padding.top + innerHeight - (v / maxCommits) * innerHeight;
+    // Commits line
+    const commitsPath = timeline.map((d, i) => `${i === 0 ? 'M' : 'L'} ${xScale(i)} ${yScale(d.commits)}`).join(' ');
+    // Rolling average line
+    const avgPath = timeline.map((d, i) => `${i === 0 ? 'M' : 'L'} ${xScale(i)} ${yScale(d.rollingAverage)}`).join(' ');
+    // Area fill under commits line
+    const areaPath = `${commitsPath} L ${xScale(timeline.length - 1)} ${yScale(0)} L ${xScale(0)} ${yScale(0)} Z`;
+    // Find anomaly positions
+    const anomalyMarkers = velocity.anomalies.map(anomaly => {
+        const idx = timeline.findIndex(d => (0, date_fns_1.format)(d.weekStart, 'yyyy-MM-dd') === (0, date_fns_1.format)(anomaly.weekStart, 'yyyy-MM-dd'));
+        if (idx === -1)
+            return '';
+        const x = xScale(idx);
+        const y = yScale(timeline[idx].commits);
+        const color = anomaly.type === 'drop' ? '#ff6b6b' : anomaly.type === 'spike' ? '#ffa94d' : '#868e96';
+        return `<circle cx="${x}" cy="${y}" r="6" fill="${color}" class="anomaly-marker" data-type="${anomaly.type}" data-severity="${anomaly.severity}"/>`;
+    }).join('');
+    // X-axis labels (show every nth label to avoid crowding)
+    const labelInterval = Math.max(1, Math.floor(timeline.length / 8));
+    const xLabels = timeline.map((d, i) => {
+        if (i % labelInterval !== 0 && i !== timeline.length - 1)
+            return '';
+        return `<text x="${xScale(i)}" y="${chartHeight - 10}" text-anchor="middle" class="axis-label">${(0, date_fns_1.format)(d.weekStart, 'MMM d')}</text>`;
+    }).join('');
+    // Y-axis labels
+    const yTicks = [0, Math.round(maxCommits / 2), maxCommits];
+    const yLabels = yTicks.map(v => `<text x="${padding.left - 10}" y="${yScale(v) + 4}" text-anchor="end" class="axis-label">${v}</text>`).join('');
+    // Grid lines
+    const gridLines = yTicks.map(v => `<line x1="${padding.left}" y1="${yScale(v)}" x2="${chartWidth - padding.right}" y2="${yScale(v)}" class="grid-line"/>`).join('');
+    return `
+    <svg class="velocity-chart" viewBox="0 0 ${chartWidth} ${chartHeight}" preserveAspectRatio="xMidYMid meet">
+      <defs>
+        <linearGradient id="areaGradient" x1="0%" y1="0%" x2="0%" y2="100%">
+          <stop offset="0%" style="stop-color:var(--accent-color);stop-opacity:0.3"/>
+          <stop offset="100%" style="stop-color:var(--accent-color);stop-opacity:0.05"/>
+        </linearGradient>
+      </defs>
+      
+      <!-- Grid -->
+      ${gridLines}
+      
+      <!-- Area fill -->
+      <path d="${areaPath}" fill="url(#areaGradient)" class="area-fill"/>
+      
+      <!-- Commits line -->
+      <path d="${commitsPath}" fill="none" stroke="var(--accent-color)" stroke-width="2" class="commits-line"/>
+      
+      <!-- Rolling average line -->
+      <path d="${avgPath}" fill="none" stroke="#ff922b" stroke-width="3" stroke-dasharray="6,4" class="avg-line"/>
+      
+      <!-- Anomaly markers -->
+      ${anomalyMarkers}
+      
+      <!-- Axes labels -->
+      ${xLabels}
+      ${yLabels}
+      
+      <!-- Legend -->
+      <g transform="translate(${chartWidth - 150}, 10)">
+        <line x1="0" y1="5" x2="20" y2="5" stroke="var(--accent-color)" stroke-width="2"/>
+        <text x="25" y="9" class="legend-label">Commits</text>
+        <line x1="0" y1="20" x2="20" y2="20" stroke="#ff922b" stroke-width="3" stroke-dasharray="6,4"/>
+        <text x="25" y="24" class="legend-label">Rolling Avg</text>
+      </g>
+    </svg>
+  `;
+}
+function buildAnomaliesList(anomalies) {
+    if (anomalies.length === 0) {
+        return '';
+    }
+    const criticalAnomalies = anomalies.filter(a => a.severity === 'critical' || a.severity === 'significant');
+    if (criticalAnomalies.length === 0) {
+        return '';
+    }
+    const anomalyItems = criticalAnomalies.slice(0, 5).map(anomaly => {
+        const typeEmoji = anomaly.type === 'drop' ? '📉' : anomaly.type === 'spike' ? '📈' : '🚫';
+        const severityClass = anomaly.severity === 'critical' ? 'critical' : 'warning';
+        const dateStr = (0, date_fns_1.format)(anomaly.weekStart, 'MMM d, yyyy');
+        return `
+      <div class="anomaly-item ${severityClass}">
+        <span class="anomaly-icon">${typeEmoji}</span>
+        <div class="anomaly-info">
+          <div class="anomaly-header">
+            <span class="anomaly-type">${anomaly.type}</span>
+            <span class="anomaly-date">${dateStr}</span>
+            <span class="anomaly-change">${anomaly.percentageChange >= 0 ? '+' : ''}${anomaly.percentageChange}%</span>
+          </div>
+          <div class="anomaly-causes">
+            Possible: ${anomaly.possibleCauses.slice(0, 2).join(', ')}
+          </div>
+        </div>
+      </div>
+    `;
+    }).join('');
+    return `
+    <div class="anomalies-section">
+      <h3>⚠️ Detected Anomalies</h3>
+      <div class="anomalies-list">
+        ${anomalyItems}
+      </div>
+    </div>
+  `;
+}

package/dist/features/velocity/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/generators/html/scripts/knowledge.js

@@ -118,3 +118,20 @@
     collapseAllRows: collapseAllRows
   };
 })();
+
+/**
+ * Toggle visibility of additional files in the high-risk files list
+ */
+function toggleMoreFiles(button) {
+  const targetGroup = button.getAttribute('data-target');
+  const count = button.getAttribute('data-count');
+  const hiddenRows = document.querySelectorAll(`tr.hidden-file[data-group="${targetGroup}"]`);
+  const isExpanded = button.getAttribute('data-expanded') === 'true';
+  
+  hiddenRows.forEach(row => {
+    row.style.display = isExpanded ? 'none' : 'table-row';
+  });
+  
+  button.setAttribute('data-expanded', !isExpanded);
+  button.textContent = isExpanded ? `+ ${count} more files` : 'Show less';
+}

package/dist/generators/html/styles/base.css

@@ -23,15 +23,19 @@
   --accent-blue: #58a6ff;
   --accent-blue-muted: #388bfd;
   --accent-green: #3fb950;
+  --accent-green-light: #69db7c;
   --accent-green-muted: #238636;
   --accent-gold: #d4a72c;
   --accent-gold-muted: #9e7a1f;
   --accent-purple: #8b5cf6;
+  --accent-orange: #ff922b;
+  --accent-orange-light: #ffa94d;
   
   /* Status Colors */
   --status-success: #238636;
-  --status-warning: #9e6a03;
-  --status-danger: #da3633;
+  --status-warning: #ffd43b;
+  --status-warning-muted: #9e6a03;
+  --status-danger: #ff6b6b;
   --status-info: #58a6ff;
   
   /* Tier Colors (Muted) */
@@ -53,6 +57,7 @@
   --radius-sm: 2px;
   --radius-md: 4px;
   --radius-lg: 6px;
+  --radius-xl: 12px;
   
   /* Shadows */
   --shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.1);
@@ -356,7 +361,7 @@ h3 {
 
 .filter-group {
   display: flex;
-  align-items: center;
+  align-items: baseline;
   gap: var(--spacing-sm);
 }