repo-wrapped 0.0.5 → 0.0.7

package/dist/generators/html/templates/velocitySection.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="#ffa94d" stroke-width="2" stroke-dasharray="5,5" 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="#ffa94d" stroke-width="2" stroke-dasharray="5,5"/>
+        <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/generators/html/utils/styleLoader.js

@@ -13,5 +13,6 @@ function loadStyles() {
     const componentsCSS = (0, fs_1.readFileSync)((0, path_1.join)(stylesDir, 'components.css'), 'utf-8');
     const achievementsCSS = (0, fs_1.readFileSync)((0, path_1.join)(stylesDir, 'achievements.css'), 'utf-8');
     const knowledgeCSS = (0, fs_1.readFileSync)((0, path_1.join)(stylesDir, 'knowledge.css'), 'utf-8');
-    return `${baseCSS}\n\n${componentsCSS}\n\n${achievementsCSS}\n\n${knowledgeCSS}`;
+    const leaddevCSS = (0, fs_1.readFileSync)((0, path_1.join)(stylesDir, 'leaddev.css'), 'utf-8');
+    return `${baseCSS}\n\n${componentsCSS}\n\n${achievementsCSS}\n\n${knowledgeCSS}\n\n${leaddevCSS}`;
 }

package/dist/index.js

@@ -31,6 +31,21 @@ Generate Options:
   --body-check            Include commit body in quality scoring
   --deep-analysis         Enable file-level knowledge distribution analysis
 
+Strategic Insights:
+  --velocity              Enable velocity timeline analysis
+  --velocity-window <w>   Rolling average window in weeks (default: 4)
+  --gap-analysis          Enable gap detection and blocker analysis
+  --gap-threshold <days>  Minimum gap days to report (default: 3)
+  --compare <r1> <r2>     Compare two date ranges (format: YYYY-MM-DD..YYYY-MM-DD)
+  --compare-labels <l>    Labels for comparison (format: "Label1,Label2")
+  --author <name>         Filter to specific author (partial match)
+  --authors <names>       Filter to multiple authors (comma-separated)
+  --team <file>           Path to team members file (one name per line)
+  --exclude-author <name> Exclude specific author (e.g., bots)
+  --executive-summary     Generate executive summary with KPIs
+  --summary-only          Output only the executive summary (terminal or HTML)
+  --events <file>         Path to events annotation JSON file
+
 Wrapped Options:
   --html                  Generate HTML slideshow and open in browser
   --compare               Compare with previous year
@@ -38,6 +53,9 @@ Wrapped Options:
 Examples:
   repo-wrapped generate . --html
   repo-wrapped generate . --all --html --deep-analysis
+  repo-wrapped generate . --velocity --gap-analysis --executive-summary
+  repo-wrapped generate . --compare "2025-01-01..2025-06-30" "2025-07-01..2025-12-31"
+  repo-wrapped generate . --author "John" --html
   repo-wrapped wrapped 2025 . --html
 `);
 program
@@ -50,6 +68,21 @@ program
     .option('--html', 'Generate HTML output and open in browser')
     .option('--body-check', 'Include commit body in quality scoring')
     .option('--deep-analysis', 'Enable file-level analysis for detailed knowledge distribution')
+    // Lead Developer Insights options
+    .option('--velocity', 'Enable velocity timeline analysis')
+    .option('--velocity-window <weeks>', 'Rolling average window in weeks', '4')
+    .option('--gap-analysis', 'Enable gap detection and blocker analysis')
+    .option('--gap-threshold <days>', 'Minimum gap days to report', '3')
+    .option('--compare <ranges...>', 'Compare two date ranges (format: YYYY-MM-DD..YYYY-MM-DD)')
+    .option('--compare-labels <labels>', 'Labels for comparison (comma-separated)')
+    .option('--author <name>', 'Filter to specific author (partial match)')
+    .option('--authors <names>', 'Filter to multiple authors (comma-separated)')
+    .option('--team <file>', 'Path to team members file (one name per line)')
+    .option('--exclude-author <name>', 'Exclude specific author')
+    .option('--exclude-authors <names>', 'Exclude multiple authors (comma-separated)')
+    .option('--executive-summary', 'Generate executive summary with KPIs')
+    .option('--summary-only', 'Output only the executive summary')
+    .option('--events <file>', 'Path to events annotation JSON file')
     .action(generate_js_1.generateMatrix);
 program
     .command('wrapped')

package/dist/utils/eventAnnotationParser.js

@@ -0,0 +1,253 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadEventsFile = loadEventsFile;
+exports.parseEventsInline = parseEventsInline;
+exports.correlateEventsWithMetrics = correlateEventsWithMetrics;
+exports.getEventTypeEmoji = getEventTypeEmoji;
+exports.getEventTypeColor = getEventTypeColor;
+exports.formatEventsInsights = formatEventsInsights;
+const fs = __importStar(require("fs"));
+const date_fns_1 = require("date-fns");
+const commitQualityAnalyzer_1 = require("./commitQualityAnalyzer");
+/**
+ * Load events from a JSON file
+ */
+function loadEventsFile(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const parsed = JSON.parse(content);
+        // Validate and transform
+        const events = (parsed.events || []).map((event) => ({
+            date: new Date(event.date),
+            label: event.label,
+            type: validateEventType(event.type),
+            description: event.description,
+        }));
+        return { events };
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new Error(`Events file not found: ${filePath}`);
+        }
+        throw new Error(`Failed to parse events file: ${error.message}`);
+    }
+}
+/**
+ * Parse inline events JSON
+ */
+function parseEventsInline(jsonStr) {
+    try {
+        const parsed = JSON.parse(jsonStr);
+        const events = (parsed.events || [parsed]).map((event) => ({
+            date: new Date(event.date),
+            label: event.label,
+            type: validateEventType(event.type),
+            description: event.description,
+        }));
+        return { events };
+    }
+    catch (error) {
+        throw new Error(`Failed to parse inline events JSON: ${error.message}`);
+    }
+}
+function validateEventType(type) {
+    const validTypes = ['disruption', 'attrition', 'growth', 'release', 'incident', 'external', 'custom'];
+    if (validTypes.includes(type)) {
+        return type;
+    }
+    return 'custom';
+}
+/**
+ * Calculate correlation between events and metrics changes
+ */
+function correlateEventsWithMetrics(events, commits, windowDays = 14, skipBodyCheck = true) {
+    return events.map(event => ({
+        ...event,
+        correlation: calculateEventCorrelation(event, commits, windowDays, skipBodyCheck),
+    }));
+}
+function calculateEventCorrelation(event, commits, windowDays, skipBodyCheck) {
+    const eventDate = event.date;
+    // Before period
+    const beforeStart = (0, date_fns_1.subDays)(eventDate, windowDays);
+    const beforeEnd = (0, date_fns_1.subDays)(eventDate, 1);
+    const beforeCommits = commits.filter(c => {
+        const d = new Date(c.date);
+        return d >= beforeStart && d <= beforeEnd;
+    });
+    // After period
+    const afterStart = (0, date_fns_1.addDays)(eventDate, 1);
+    const afterEnd = (0, date_fns_1.addDays)(eventDate, windowDays);
+    const afterCommits = commits.filter(c => {
+        const d = new Date(c.date);
+        return d >= afterStart && d <= afterEnd;
+    });
+    const metricsBefore = calculatePeriodMetrics(beforeCommits, beforeStart, beforeEnd, skipBodyCheck);
+    const metricsAfter = calculatePeriodMetrics(afterCommits, afterStart, afterEnd, skipBodyCheck);
+    // Calculate changes
+    const velocityChange = calculatePercentageChange(metricsBefore.commitsPerWeek ?? 0, metricsAfter.commitsPerWeek ?? 0);
+    const qualityChange = calculatePercentageChange(metricsBefore.qualityScore ?? 0, metricsAfter.qualityScore ?? 0);
+    const activeAuthorsChange = (metricsAfter.totalAuthors ?? 0) - (metricsBefore.totalAuthors ?? 0);
+    // Generate assessment
+    const assessment = generateAssessment(event, velocityChange, qualityChange, activeAuthorsChange);
+    return {
+        metricsBefore,
+        metricsAfter,
+        impact: {
+            velocityChange,
+            qualityChange,
+            activeAuthorsChange,
+        },
+        assessment,
+    };
+}
+function calculatePeriodMetrics(commits, startDate, endDate, skipBodyCheck) {
+    const days = (0, date_fns_1.differenceInDays)(endDate, startDate) + 1;
+    const weeks = Math.max(1, days / 7);
+    const totalCommits = commits.length;
+    const commitsPerWeek = Math.round((totalCommits / weeks) * 10) / 10;
+    const totalAuthors = new Set(commits.map(c => c.author)).size;
+    const qualityResult = commits.length > 0
+        ? (0, commitQualityAnalyzer_1.analyzeCommitQuality)(commits, { skipBodyCheck })
+        : { overallScore: 0 };
+    return {
+        totalCommits,
+        commitsPerWeek,
+        totalAuthors,
+        qualityScore: Math.round(qualityResult.overallScore * 10) / 10,
+    };
+}
+function calculatePercentageChange(before, after) {
+    if (before === 0) {
+        return after > 0 ? 100 : 0;
+    }
+    return Math.round(((after - before) / before) * 1000) / 10;
+}
+function generateAssessment(event, velocityChange, qualityChange, authorChange) {
+    const parts = [];
+    const eventLabel = `"${event.label}"`;
+    if (velocityChange <= -30) {
+        parts.push(`velocity dropped ${Math.abs(velocityChange)}%`);
+    }
+    else if (velocityChange >= 30) {
+        parts.push(`velocity increased ${velocityChange}%`);
+    }
+    if (qualityChange <= -20) {
+        parts.push(`quality decreased ${Math.abs(qualityChange)}%`);
+    }
+    else if (qualityChange >= 20) {
+        parts.push(`quality improved ${qualityChange}%`);
+    }
+    if (authorChange < 0) {
+        parts.push(`${Math.abs(authorChange)} fewer active contributor(s)`);
+    }
+    else if (authorChange > 0) {
+        parts.push(`${authorChange} more active contributor(s)`);
+    }
+    if (parts.length === 0) {
+        return `No significant metric changes detected after ${eventLabel}`;
+    }
+    return `After ${eventLabel}: ${parts.join(', ')}`;
+}
+/**
+ * Get emoji for event type
+ */
+function getEventTypeEmoji(type) {
+    const emojis = {
+        disruption: '⚡',
+        attrition: '👋',
+        growth: '🌱',
+        release: '🚀',
+        incident: '🔥',
+        external: '📅',
+        custom: '📌',
+    };
+    return emojis[type] || '📌';
+}
+/**
+ * Get color for event type (for HTML)
+ */
+function getEventTypeColor(type) {
+    const colors = {
+        disruption: '#ff6b6b',
+        attrition: '#ffa94d',
+        growth: '#69db7c',
+        release: '#4dabf7',
+        incident: '#ff8787',
+        external: '#868e96',
+        custom: '#9775fa',
+    };
+    return colors[type] || '#9775fa';
+}
+/**
+ * Format events for display
+ */
+function formatEventsInsights(events) {
+    const insights = [];
+    if (events.length === 0) {
+        return ['No events annotated'];
+    }
+    insights.push(`📅 ${events.length} Event(s) Annotated`);
+    insights.push('');
+    // Sort by date
+    const sortedEvents = [...events].sort((a, b) => a.date.getTime() - b.date.getTime());
+    for (const event of sortedEvents) {
+        const emoji = getEventTypeEmoji(event.type);
+        const dateStr = (0, date_fns_1.format)(event.date, 'MMM d, yyyy');
+        insights.push(`${emoji} ${dateStr}: ${event.label}`);
+        if (event.description) {
+            insights.push(`   ${event.description}`);
+        }
+        if (event.correlation) {
+            const { impact } = event.correlation;
+            const impactParts = [];
+            if (Math.abs(impact.velocityChange) >= 10) {
+                impactParts.push(`velocity ${impact.velocityChange >= 0 ? '+' : ''}${impact.velocityChange}%`);
+            }
+            if (Math.abs(impact.qualityChange) >= 10) {
+                impactParts.push(`quality ${impact.qualityChange >= 0 ? '+' : ''}${impact.qualityChange}%`);
+            }
+            if (impact.activeAuthorsChange !== 0) {
+                impactParts.push(`${impact.activeAuthorsChange >= 0 ? '+' : ''}${impact.activeAuthorsChange} contributors`);
+            }
+            if (impactParts.length > 0) {
+                insights.push(`   📊 Impact: ${impactParts.join(', ')}`);
+            }
+        }
+        insights.push('');
+    }
+    return insights;
+}