repo-wrapped 0.0.6 → 0.0.9

package/dist/generators/html/templates/teamSection.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTeamSection = buildTeamSection;
+/**
+ * Builds the HTML section for team analysis visualization
+ */
+function buildTeamSection(analysis) {
+    if (!analysis || analysis.members.length === 0) {
+        return '<p class="no-data">No team data available</p>';
+    }
+    const { teamMetrics, memberBreakdown, loadDistribution } = analysis;
+    // Build summary cards
+    const summaryHtml = buildSummaryCards(teamMetrics, analysis.members.length);
+    // Build load distribution indicator
+    const loadDistHtml = buildLoadDistribution(loadDistribution);
+    // Build member breakdown
+    const membersHtml = buildMemberList(memberBreakdown);
+    // Build insights
+    const insightsHtml = buildInsights(loadDistribution.insights);
+    return `
+    <div class="team-section">
+      ${summaryHtml}
+      ${loadDistHtml}
+      ${membersHtml}
+      ${insightsHtml}
+    </div>
+  `;
+}
+function buildSummaryCards(metrics, memberCount) {
+    return `
+    <div class="team-summary">
+      <div class="team-stat-card">
+        <span class="stat-value">${metrics.totalCommits.toLocaleString()}</span>
+        <span class="stat-label">Total Commits</span>
+      </div>
+      <div class="team-stat-card">
+        <span class="stat-value">${memberCount}</span>
+        <span class="stat-label">Team Members</span>
+      </div>
+      <div class="team-stat-card">
+        <span class="stat-value">${metrics.commitsPerMember.toFixed(1)}</span>
+        <span class="stat-label">Commits/Member</span>
+      </div>
+      <div class="team-stat-card">
+        <span class="stat-value">${metrics.activeDays}</span>
+        <span class="stat-label">Active Days</span>
+      </div>
+      <div class="team-stat-card">
+        <span class="stat-value">${metrics.qualityScore.toFixed(1)}</span>
+        <span class="stat-label">Avg Quality</span>
+      </div>
+    </div>
+  `;
+}
+function buildLoadDistribution(loadDist) {
+    const gini = loadDist.giniCoefficient;
+    const percentage = Math.round(gini * 100);
+    // Color based on assessment
+    let colorClass = 'balanced';
+    let statusIcon = '✅';
+    if (loadDist.assessment === 'moderate-imbalance') {
+        colorClass = 'moderate';
+        statusIcon = '⚠️';
+    }
+    else if (loadDist.assessment === 'high-imbalance') {
+        colorClass = 'imbalanced';
+        statusIcon = '🚨';
+    }
+    const assessmentLabel = loadDist.assessment.replace('-', ' ').replace(/\b\w/g, c => c.toUpperCase());
+    return `
+    <div class="load-distribution">
+      <h3>Load Distribution</h3>
+      <div class="gini-container">
+        <div class="gini-bar-bg">
+          <div class="gini-bar ${colorClass}" style="width: ${percentage}%"></div>
+        </div>
+        <div class="gini-info">
+          <span class="gini-value">Gini: ${gini.toFixed(2)}</span>
+          <span class="gini-assessment ${colorClass}">${statusIcon} ${assessmentLabel}</span>
+        </div>
+      </div>
+      <p class="gini-explanation">
+        ${gini < 0.3 ? 'Work is evenly distributed across the team.' :
+        gini < 0.5 ? 'Some team members are contributing more than others.' :
+            'Work is concentrated among a few contributors. Consider redistributing.'}
+      </p>
+    </div>
+  `;
+}
+function buildMemberList(members) {
+    // Sort by commits descending
+    const sorted = [...members].sort((a, b) => b.commits - a.commits);
+    const maxCommits = sorted[0]?.commits || 1;
+    const membersHtml = sorted.map((member, index) => {
+        const barWidth = (member.commits / maxCommits) * 100;
+        const rankBadge = index === 0 ? '👑' : index < 3 ? '⭐' : '';
+        return `
+      <div class="member-card">
+        <div class="member-rank">${index + 1}</div>
+        <div class="member-info">
+          <div class="member-name">${rankBadge} ${escapeHtml(member.author)}</div>
+          <div class="member-areas">${member.topAreas.slice(0, 3).map(a => `<span class="area-tag">${escapeHtml(a)}</span>`).join('')}</div>
+        </div>
+        <div class="member-bar-container">
+          <div class="member-bar" style="width: ${barWidth}%"></div>
+        </div>
+        <div class="member-stats">
+          <span class="member-commits">${member.commits}</span>
+          <span class="member-percentage">(${member.percentage.toFixed(1)}%)</span>
+        </div>
+        <div class="member-quality" title="Commit quality score">
+          <span class="quality-badge">${member.qualityScore.toFixed(1)}</span>
+        </div>
+      </div>
+    `;
+    }).join('');
+    return `
+    <div class="member-breakdown">
+      <h3>Team Members</h3>
+      <div class="member-list">
+        ${membersHtml}
+      </div>
+    </div>
+  `;
+}
+function buildInsights(insights) {
+    if (!insights || insights.length === 0) {
+        return '';
+    }
+    return `
+    <div class="team-insights">
+      <h3>Insights</h3>
+      <ul class="insights-list">
+        ${insights.map(insight => `<li class="insight-item">💡 ${escapeHtml(insight)}</li>`).join('')}
+      </ul>
+    </div>
+  `;
+}
+function escapeHtml(str) {
+    return str
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}

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="#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/generators/html/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Types for HTML generation pipeline.
+ *
+ * @module generators/html/types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/generators/html/utils/analysisRunner.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * Analysis runner - executes all analyzers with shared context.
+ *
+ * @module generators/html/utils/analysisRunner
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runAllAnalyzers = runAllAnalyzers;
+const streaks_1 = require("../../../features/streaks");
+const time_patterns_1 = require("../../../features/time-patterns");
+const commitQualityAnalyzer_1 = require("../../../utils/commitQualityAnalyzer");
+const fileHotspotAnalyzer_1 = require("../../../utils/fileHotspotAnalyzer");
+const impactAnalyzer_1 = require("../../../utils/impactAnalyzer");
+const knowledgeDistributionAnalyzer_1 = require("../../../utils/knowledgeDistributionAnalyzer");
+const achievements_1 = require("../../../features/achievements");
+const commitMapBuilder_1 = require("./commitMapBuilder");
+/**
+ * Run all analyzers for the given context.
+ *
+ * @param context - The HTML generation context
+ * @param skipBodyCheck - Whether to skip commit body validation
+ * @param deepAnalysis - Whether to enable deep analysis
+ * @param leadDevFeatures - Pre-computed strategic insights (optional)
+ * @returns Analysis results for all views
+ */
+function runAllAnalyzers(context, skipBodyCheck = false, deepAnalysis = false, leadDevFeatures) {
+    const { filteredCommits, personalCommits, dateRange, repoInfo } = context;
+    const { start: startDate, end: endDate } = dateRange;
+    // Create commit maps for overall
+    const { commitMap, commitDetailsMap } = (0, commitMapBuilder_1.createCommitMaps)(filteredCommits, startDate, endDate);
+    const totalCommits = Array.from(commitMap.values()).reduce((sum, count) => sum + count, 0);
+    // Create commit maps for personal
+    const { commitMap: personalCommitMap, commitDetailsMap: personalCommitDetailsMap } = (0, commitMapBuilder_1.createCommitMaps)(personalCommits, startDate, endDate);
+    const totalPersonalCommits = Array.from(personalCommitMap.values()).reduce((sum, count) => sum + count, 0);
+    // Run overall analyzers
+    const streakData = (0, streaks_1.calculateStreaks)(filteredCommits, startDate, endDate);
+    const timePattern = (0, time_patterns_1.analyzeTimePatterns)(filteredCommits, startDate, endDate);
+    const commitQuality = (0, commitQualityAnalyzer_1.analyzeCommitQuality)(filteredCommits, { skipBodyCheck });
+    // Run personal analyzers
+    const personalStreakData = (0, streaks_1.calculateStreaks)(personalCommits, startDate, endDate);
+    const personalTimePattern = (0, time_patterns_1.analyzeTimePatterns)(personalCommits, startDate, endDate);
+    const personalCommitQuality = (0, commitQualityAnalyzer_1.analyzeCommitQuality)(personalCommits, { skipBodyCheck });
+    // Run enterprise insight analyzers
+    const fileHotspots = (0, fileHotspotAnalyzer_1.analyzeFileHotspots)(repoInfo.path, startDate, endDate);
+    const impactAnalysis = (0, impactAnalyzer_1.analyzeImpact)(filteredCommits);
+    const knowledgeDistribution = (0, knowledgeDistributionAnalyzer_1.analyzeKnowledgeDistribution)(filteredCommits, repoInfo.path, deepAnalysis);
+    // Build analysis data for achievements
+    const overallAnalysisData = {
+        commits: filteredCommits,
+        totalCommits,
+        streakData,
+        timePattern,
+        commitQuality,
+        fileHotspots,
+        dateRange: { start: startDate, end: endDate }
+    };
+    const personalAnalysisData = {
+        commits: personalCommits,
+        totalCommits: totalPersonalCommits,
+        streakData: personalStreakData,
+        timePattern: personalTimePattern,
+        commitQuality: personalCommitQuality,
+        fileHotspots,
+        dateRange: { start: startDate, end: endDate }
+    };
+    // Check achievements
+    const achievementProgress = (0, achievements_1.checkAchievements)(overallAnalysisData);
+    const personalAchievementProgress = (0, achievements_1.checkAchievements)(personalAnalysisData);
+    return {
+        overall: {
+            commitMap,
+            commitDetailsMap,
+            totalCommits,
+            streakData,
+            timePattern,
+            commitQuality,
+            achievementProgress,
+        },
+        personal: {
+            commitMap: personalCommitMap,
+            commitDetailsMap: personalCommitDetailsMap,
+            totalCommits: totalPersonalCommits,
+            streakData: personalStreakData,
+            timePattern: personalTimePattern,
+            commitQuality: personalCommitQuality,
+            achievementProgress: personalAchievementProgress,
+        },
+        fileHotspots,
+        impactAnalysis,
+        knowledgeDistribution,
+        leadDev: leadDevFeatures,
+    };
+}

package/dist/generators/html/utils/cardBuilder.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Shared utility for building consistent stat cards across templates
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildStatCard = buildStatCard;
+exports.buildStatGrid = buildStatGrid;
+exports.buildCardSection = buildCardSection;
+/**
+ * Builds a single stat card with consistent styling
+ */
+function buildStatCard(options) {
+    const { icon, value, label, detail, className = '', valueClass = '' } = options;
+    return `
+    <div class="stat-card-base ${className}">
+      ${icon ? `<div class="stat-icon">${icon}</div>` : ''}
+      <div class="stat-info">
+        <div class="stat-label">${label}</div>
+        <div class="stat-value ${valueClass}">${value}</div>
+        ${detail ? `<div class="stat-detail">${detail}</div>` : ''}
+      </div>
+    </div>
+  `;
+}
+/**
+ * Builds a grid of stat cards
+ */
+function buildStatGrid(options) {
+    return `
+    <div class="stat-grid ${options.className || ''}">
+      ${options.cards.map(card => buildStatCard(card)).join('')}
+    </div>
+  `;
+}
+/**
+ * Builds a card section with title and content
+ */
+function buildCardSection(options) {
+    const { title, content, className = '', icon } = options;
+    const titleContent = icon ? `${icon} ${title}` : title;
+    return `
+    <div class="card-section ${className}">
+      <h3>${titleContent}</h3>
+      ${content}
+    </div>
+  `;
+}

package/dist/generators/html/utils/contextBuilder.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * Context builder for HTML generation.
+ *
+ * @module generators/html/utils/contextBuilder
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildHtmlContext = buildHtmlContext;
+const dateRangeCalculator_1 = require("./dateRangeCalculator");
+const developerStatsCalculator_1 = require("./developerStatsCalculator");
+/**
+ * Build the HTML generation context from options.
+ *
+ * @param options - Generation options
+ * @returns Fully populated context for HTML generation
+ */
+function buildHtmlContext(options) {
+    const { commits, repoPath, repoName, repoUrl, year = new Date().getFullYear(), monthsToShow = 12, allTime = false, } = options;
+    // Get current git user
+    const { getCurrentGitUser } = require('../../../utils/gitParser');
+    const currentUser = getCurrentGitUser(repoPath);
+    // Calculate date ranges
+    const dateRanges = allTime
+        ? (0, dateRangeCalculator_1.calculateDateRangesFromCommits)(commits)
+        : (0, dateRangeCalculator_1.calculateDateRanges)(year, monthsToShow);
+    const { startDate, endDate, weekStartDate, weekEndDate } = dateRanges;
+    // Filter commits to date range
+    const filteredCommits = commits.filter(commit => {
+        const commitDate = new Date(commit.date);
+        return commitDate >= startDate && commitDate <= endDate;
+    });
+    // Filter personal commits
+    const personalCommits = filteredCommits.filter(c => c.author === currentUser);
+    // Calculate developer stats
+    const developerStats = (0, developerStatsCalculator_1.calculateDeveloperStats)(filteredCommits, startDate, endDate);
+    return {
+        options,
+        repoInfo: {
+            name: repoName,
+            url: repoUrl,
+            path: repoPath,
+        },
+        currentUser,
+        dateRange: {
+            start: startDate,
+            end: endDate,
+            weekStart: weekStartDate,
+            weekEnd: weekEndDate,
+        },
+        filteredCommits,
+        personalCommits,
+        developerStats,
+    };
+}