repo-wrapped 0.0.7 → 0.0.9

package/dist/features/achievements/evaluators.js

@@ -0,0 +1,246 @@
+"use strict";
+/**
+ * Achievement Evaluators Module
+ *
+ * Pure functions that evaluate achievement criteria against analysis data.
+ * Each evaluator returns { earned: boolean, progress: number } where progress is 0-100.
+ *
+ * @module achievementEvaluators
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluate = evaluate;
+exports.evaluateMeta = evaluateMeta;
+exports.isMetaCriteria = isMetaCriteria;
+/**
+ * Calculate progress as percentage (capped at 100)
+ */
+function progressPercent(current, target) {
+    if (target === 0)
+        return 100;
+    return Math.min(100, Math.round((current / target) * 100));
+}
+/**
+ * Evaluate commit count threshold
+ */
+function evaluateCommitCount(data, criteria) {
+    const count = data.totalCommits ?? 0;
+    const threshold = criteria.threshold ?? 0;
+    return {
+        earned: count >= threshold,
+        progress: progressPercent(count, threshold),
+    };
+}
+/**
+ * Evaluate exact commit count (for special achievements)
+ */
+function evaluateExactCommitCount(data, criteria) {
+    const count = data.totalCommits ?? 0;
+    const threshold = criteria.threshold ?? 0;
+    return {
+        earned: count === threshold,
+        progress: count === threshold ? 100 : progressPercent(count, threshold),
+    };
+}
+/**
+ * Evaluate streak length
+ */
+function evaluateStreak(data, criteria) {
+    const streak = data.streakData?.longestStreak?.days ?? 0;
+    const threshold = criteria.threshold ?? 0;
+    return {
+        earned: streak >= threshold,
+        progress: progressPercent(streak, threshold),
+    };
+}
+/**
+ * Evaluate quality score threshold
+ */
+function evaluateQualityScore(data, criteria) {
+    const score = data.commitQuality?.overallScore ?? 0;
+    const threshold = criteria.threshold ?? 0;
+    return {
+        earned: score >= threshold,
+        progress: progressPercent(score, threshold),
+    };
+}
+/**
+ * Evaluate conventional commit adherence percentage
+ */
+function evaluateConventionalAdherence(data, criteria) {
+    const adherence = data.commitQuality?.conventionalCommits?.adherence ?? 0;
+    const threshold = criteria.threshold ?? 0;
+    return {
+        earned: adherence >= threshold,
+        progress: progressPercent(adherence, threshold),
+    };
+}
+/**
+ * Evaluate percentage of commits with body content
+ */
+function evaluateBodyPercentage(data, criteria) {
+    const withBody = data.commitQuality?.bodyQuality?.withBody ?? 0;
+    const total = data.totalCommits ?? 1;
+    const percentage = (withBody / total) * 100;
+    const threshold = criteria.threshold ?? 0;
+    return {
+        earned: percentage >= threshold,
+        progress: progressPercent(percentage, threshold),
+    };
+}
+/**
+ * Evaluate commits within a time range (e.g., early morning)
+ */
+function evaluateTimeRangeCommits(data, criteria) {
+    const hourlyData = data.timePattern?.hourly ?? [];
+    const startHour = criteria.startHour ?? 0;
+    const endHour = criteria.endHour ?? 24;
+    const threshold = criteria.threshold ?? 0;
+    let count = 0;
+    for (const hourEntry of hourlyData) {
+        if (hourEntry.hour >= startHour && hourEntry.hour < endHour) {
+            count += hourEntry.commitCount;
+        }
+    }
+    return {
+        earned: count >= threshold,
+        progress: progressPercent(count, threshold),
+    };
+}
+/**
+ * Evaluate night commits (after 9pm or before 5am)
+ */
+function evaluateNightCommits(data, criteria) {
+    const hourlyData = data.timePattern?.hourly ?? [];
+    const threshold = criteria.threshold ?? 0;
+    let count = 0;
+    for (const hourEntry of hourlyData) {
+        // Night hours: 21, 22, 23, 0, 1, 2, 3, 4
+        if (hourEntry.hour >= 21 || hourEntry.hour < 5) {
+            count += hourEntry.commitCount;
+        }
+    }
+    return {
+        earned: count >= threshold,
+        progress: progressPercent(count, threshold),
+    };
+}
+/**
+ * Evaluate chronotype match
+ */
+function evaluateChronotype(data, criteria) {
+    const chronotype = data.timePattern?.chronotype ?? '';
+    const targetValue = criteria.value ?? '';
+    const earned = chronotype.toLowerCase() === targetValue.toLowerCase();
+    return {
+        earned,
+        progress: earned ? 100 : 0,
+    };
+}
+/**
+ * Evaluate work-life balance score
+ */
+function evaluateWorkLifeScore(data, criteria) {
+    const score = data.timePattern?.workLifeBalance?.score ?? 0;
+    const threshold = criteria.threshold ?? 0;
+    return {
+        earned: score >= threshold,
+        progress: progressPercent(score, threshold),
+    };
+}
+/**
+ * Evaluate if any commit was made at exactly midnight
+ */
+function evaluateMidnightCommit(data) {
+    const commits = data.commits ?? [];
+    const hasMidnightCommit = commits.some((commit) => {
+        const date = new Date(commit.date);
+        return date.getHours() === 0 && date.getMinutes() === 0;
+    });
+    return {
+        earned: hasMidnightCommit,
+        progress: hasMidnightCommit ? 100 : 0,
+    };
+}
+/**
+ * Evaluate weekend commit percentage
+ */
+function evaluateWeekendPercentage(data, criteria) {
+    const commits = data.commits ?? [];
+    const threshold = criteria.threshold ?? 0;
+    if (commits.length === 0) {
+        return { earned: false, progress: 0 };
+    }
+    const weekendCommits = commits.filter((commit) => {
+        const day = new Date(commit.date).getDay();
+        return day === 0 || day === 6;
+    }).length;
+    const percentage = (weekendCommits / commits.length) * 100;
+    return {
+        earned: percentage >= threshold,
+        progress: progressPercent(percentage, threshold),
+    };
+}
+/**
+ * Evaluate badge count for meta achievements
+ */
+function evaluateBadgeCount(earnedCount, criteria) {
+    const threshold = criteria.threshold ?? 0;
+    return {
+        earned: earnedCount >= threshold,
+        progress: progressPercent(earnedCount, threshold),
+    };
+}
+/**
+ * Registry of all evaluator functions by criteria type
+ */
+const evaluators = {
+    'commit-count': evaluateCommitCount,
+    'exact-commit-count': evaluateExactCommitCount,
+    streak: evaluateStreak,
+    'quality-score': evaluateQualityScore,
+    'conventional-adherence': evaluateConventionalAdherence,
+    'body-percentage': evaluateBodyPercentage,
+    'time-range-commits': evaluateTimeRangeCommits,
+    'night-commits': evaluateNightCommits,
+    chronotype: evaluateChronotype,
+    'work-life-score': evaluateWorkLifeScore,
+    'midnight-commit': evaluateMidnightCommit,
+    'weekend-percentage': evaluateWeekendPercentage,
+};
+/**
+ * Evaluate an achievement criteria against analysis data
+ * @param data Analysis data to evaluate against
+ * @param criteria The criteria to evaluate
+ * @returns Evaluation result with earned status and progress
+ */
+function evaluate(data, criteria) {
+    const evaluator = evaluators[criteria.type];
+    if (!evaluator) {
+        console.warn(`Unknown criteria type: ${criteria.type}`);
+        return { earned: false, progress: 0 };
+    }
+    return evaluator(data, criteria);
+}
+/**
+ * Evaluate badge-count criteria (for meta achievements)
+ * This is separate because it depends on the count of earned achievements,
+ * not on the raw analysis data.
+ * @param earnedCount Number of achievements already earned
+ * @param criteria The criteria to evaluate
+ * @returns Evaluation result with earned status and progress
+ */
+function evaluateMeta(earnedCount, criteria) {
+    if (criteria.type !== 'badge-count') {
+        console.warn(`evaluateMeta only supports badge-count criteria, got: ${criteria.type}`);
+        return { earned: false, progress: 0 };
+    }
+    return evaluateBadgeCount(earnedCount, criteria);
+}
+/**
+ * Check if a criteria type is a meta achievement type
+ * @param type The criteria type to check
+ * @returns True if this is a meta achievement type
+ */
+function isMetaCriteria(type) {
+    return type === 'badge-count';
+}

package/dist/features/achievements/helpers.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * Achievement Helper Functions
+ *
+ * Utility functions for achievement display formatting.
+ * Achievement data is now loaded from src/data/achievements.json
+ * via the achievementLoader module.
+ *
+ * @module achievementDefinitions
+ * @deprecated Import from achievementLoader for achievement data
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTierColor = getTierColor;
+exports.getCategoryLabel = getCategoryLabel;
+/**
+ * Get the display color for an achievement tier
+ * @param tier Achievement tier level
+ * @returns CSS color value for the tier
+ */
+function getTierColor(tier) {
+    switch (tier) {
+        case 'bronze':
+            return '#cd7f32';
+        case 'silver':
+            return '#c0c0c0';
+        case 'gold':
+            return '#ffd700';
+        case 'platinum':
+            return '#e5e4e2';
+        case 'legendary':
+            return '#ff6b6b';
+        default:
+            return '#8b949e';
+    }
+}
+/**
+ * Get the display label for an achievement category
+ * @param category Achievement category
+ * @returns Formatted label with emoji
+ */
+function getCategoryLabel(category) {
+    switch (category) {
+        case 'milestone':
+            return '🎯 Milestone';
+        case 'quality':
+            return '🎨 Quality';
+        case 'collaboration':
+            return '🤝 Collaboration';
+        case 'time':
+            return '⏰ Time & Consistency';
+        case 'special':
+            return '🎮 Special';
+        case 'meta':
+            return '🏆 Meta';
+        default:
+            return category;
+    }
+}

package/dist/features/achievements/index.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * Achievements Feature
+ *
+ * Self-contained achievement system including:
+ * - Data: JSON achievement definitions
+ * - Types: Achievement interfaces
+ * - Engine: Processing and evaluation
+ * - Template: HTML rendering
+ *
+ * @module features/achievements
+ */
+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.buildAchievementsSection = exports.getCategoryLabel = exports.getTierColor = exports.isMetaCriteria = exports.evaluateMeta = exports.evaluate = exports.getTotalAchievementCount = exports.getMetaAchievements = exports.getNonMetaAchievements = exports.getAchievementsByTier = exports.getDefinitionsByCategory = exports.getAchievementById = exports.loadAchievementDefinitions = exports.getNextMilestone = exports.getAchievementsByCategory = exports.getRecentAchievements = exports.checkAchievements = void 0;
+// Types
+__exportStar(require("./types"), exports);
+// Engine & Processing
+var engine_1 = require("./engine");
+Object.defineProperty(exports, "checkAchievements", { enumerable: true, get: function () { return engine_1.checkAchievements; } });
+Object.defineProperty(exports, "getRecentAchievements", { enumerable: true, get: function () { return engine_1.getRecentAchievements; } });
+Object.defineProperty(exports, "getAchievementsByCategory", { enumerable: true, get: function () { return engine_1.getAchievementsByCategory; } });
+Object.defineProperty(exports, "getNextMilestone", { enumerable: true, get: function () { return engine_1.getNextMilestone; } });
+// Loader
+var loader_1 = require("./loader");
+Object.defineProperty(exports, "loadAchievementDefinitions", { enumerable: true, get: function () { return loader_1.loadAchievementDefinitions; } });
+Object.defineProperty(exports, "getAchievementById", { enumerable: true, get: function () { return loader_1.getAchievementById; } });
+Object.defineProperty(exports, "getDefinitionsByCategory", { enumerable: true, get: function () { return loader_1.getAchievementsByCategory; } });
+Object.defineProperty(exports, "getAchievementsByTier", { enumerable: true, get: function () { return loader_1.getAchievementsByTier; } });
+Object.defineProperty(exports, "getNonMetaAchievements", { enumerable: true, get: function () { return loader_1.getNonMetaAchievements; } });
+Object.defineProperty(exports, "getMetaAchievements", { enumerable: true, get: function () { return loader_1.getMetaAchievements; } });
+Object.defineProperty(exports, "getTotalAchievementCount", { enumerable: true, get: function () { return loader_1.getTotalAchievementCount; } });
+// Evaluators
+var evaluators_1 = require("./evaluators");
+Object.defineProperty(exports, "evaluate", { enumerable: true, get: function () { return evaluators_1.evaluate; } });
+Object.defineProperty(exports, "evaluateMeta", { enumerable: true, get: function () { return evaluators_1.evaluateMeta; } });
+Object.defineProperty(exports, "isMetaCriteria", { enumerable: true, get: function () { return evaluators_1.isMetaCriteria; } });
+// Helpers
+var helpers_1 = require("./helpers");
+Object.defineProperty(exports, "getTierColor", { enumerable: true, get: function () { return helpers_1.getTierColor; } });
+Object.defineProperty(exports, "getCategoryLabel", { enumerable: true, get: function () { return helpers_1.getCategoryLabel; } });
+// Template
+var template_1 = require("./template");
+Object.defineProperty(exports, "buildAchievementsSection", { enumerable: true, get: function () { return template_1.buildAchievementsSection; } });

package/dist/features/achievements/loader.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * Achievement Loader Module
+ *
+ * Loads achievement definitions from JSON and constructs Achievement objects.
+ * This separates data (JSON) from logic (evaluators).
+ *
+ * @module achievementLoader
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadAchievementDefinitions = loadAchievementDefinitions;
+exports.getAchievementById = getAchievementById;
+exports.getAchievementsByCategory = getAchievementsByCategory;
+exports.getAchievementsByTier = getAchievementsByTier;
+exports.getNonMetaAchievements = getNonMetaAchievements;
+exports.getMetaAchievements = getMetaAchievements;
+exports.createRuntimeAchievement = createRuntimeAchievement;
+exports.getTotalAchievementCount = getTotalAchievementCount;
+const achievements_json_1 = __importDefault(require("./data/achievements.json"));
+/**
+ * Load all achievement definitions from JSON
+ * @returns Array of achievement definitions
+ */
+function loadAchievementDefinitions() {
+    return achievements_json_1.default.achievements;
+}
+/**
+ * Get achievement definition by ID
+ * @param id Achievement ID to find
+ * @returns Achievement definition or undefined
+ */
+function getAchievementById(id) {
+    return loadAchievementDefinitions().find((a) => a.id === id);
+}
+/**
+ * Get achievements by category
+ * @param category Category to filter by
+ * @returns Array of achievements in that category
+ */
+function getAchievementsByCategory(category) {
+    return loadAchievementDefinitions().filter((a) => a.category === category);
+}
+/**
+ * Get achievements by tier
+ * @param tier Tier to filter by
+ * @returns Array of achievements at that tier
+ */
+function getAchievementsByTier(tier) {
+    return loadAchievementDefinitions().filter((a) => a.tier === tier);
+}
+/**
+ * Get all non-meta achievements (for evaluating before meta achievements)
+ * @returns Array of non-meta achievements
+ */
+function getNonMetaAchievements() {
+    return loadAchievementDefinitions().filter((a) => a.category !== 'meta');
+}
+/**
+ * Get all meta achievements (evaluated last, based on badge count)
+ * @returns Array of meta achievements
+ */
+function getMetaAchievements() {
+    return loadAchievementDefinitions().filter((a) => a.category === 'meta');
+}
+/**
+ * Create a runtime achievement from a definition
+ * @param definition Achievement definition from JSON
+ * @returns LoadedAchievement with default runtime state
+ */
+function createRuntimeAchievement(definition) {
+    return {
+        ...definition,
+        progress: 0,
+        isUnlocked: false,
+        earnedDate: undefined,
+        rarity: undefined,
+    };
+}
+/**
+ * Get total count of all achievements
+ * @returns Total number of achievements
+ */
+function getTotalAchievementCount() {
+    return loadAchievementDefinitions().length;
+}

package/dist/features/achievements/template.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAchievementsSection = buildAchievementsSection;
+// Helper: Build SVG progress ring
+function buildProgressRing(progress, size = 50) {
+    const radius = (size / 2) - 4;
+    const circumference = 2 * Math.PI * radius;
+    const offset = circumference * (1 - progress / 100);
+    return `
+    <svg class="progress-ring" width="${size}" height="${size}" viewBox="0 0 ${size} ${size}">
+      <circle class="progress-ring-bg" cx="${size / 2}" cy="${size / 2}" r="${radius}" 
+              fill="none" stroke="var(--border-subtle)" stroke-width="3" />
+      <circle class="progress-ring-fill" cx="${size / 2}" cy="${size / 2}" r="${radius}"
+              fill="none" stroke="var(--accent-blue)" stroke-width="3"
+              stroke-dasharray="${circumference}"
+              stroke-dashoffset="${offset}"
+              stroke-linecap="round"
+              transform="rotate(-90 ${size / 2} ${size / 2})" />
+    </svg>
+  `;
+}
+// Helper: Build individual achievement card
+function buildAchievementCard(achievement) {
+    const cardClass = achievement.isUnlocked ? 'unlocked' : 'locked';
+    const showProgress = !achievement.isUnlocked && achievement.progress > 0;
+    return `
+    <div class="achievement-card ${cardClass}">
+      ${showProgress ? `
+        <div class="achievement-ring-wrapper">
+          ${buildProgressRing(achievement.progress, 60)}
+        </div>
+      ` : ''}
+      <div class="achievement-emoji">${achievement.emoji}</div>
+      <div class="achievement-name">${achievement.name}</div>
+      ${!achievement.isSecret || achievement.isUnlocked ? `
+        <div class="achievement-description">${achievement.description}</div>
+      ` : `
+        <div class="achievement-description">???</div>
+      `}
+      <div class="badge-tier ${achievement.tier}">${achievement.tier}</div>
+      ${showProgress ? `
+        <div class="achievement-progress-text">${achievement.progress.toFixed(0)}%</div>
+      ` : ''}
+    </div>
+  `;
+}
+// Helper: Generate growth narrative
+function buildGrowthNarrative(progress) {
+    const { unlockedCount, totalCount, completionPercentage, categories, nextMilestones } = progress;
+    // Find strongest category
+    let strongestCategory = '';
+    let strongestCount = 0;
+    if (categories && categories.length > 0) {
+        for (const cat of categories) {
+            if (cat.unlocked > strongestCount) {
+                strongestCount = cat.unlocked;
+                strongestCategory = cat.name;
+            }
+        }
+    }
+    // Get next milestone info
+    let nextMilestoneText = '';
+    if (nextMilestones && nextMilestones.length > 0) {
+        const next = nextMilestones[0];
+        const remaining = 100 - next.progress;
+        nextMilestoneText = `Next milestone: <strong>${next.name}</strong> — ${remaining.toFixed(0)}% to go.`;
+    }
+    return `
+    <div class="growth-narrative">
+      <h3>Your Developer Journey</h3>
+      <p class="narrative-text">
+        You've unlocked <strong>${unlockedCount} of ${totalCount}</strong> achievements (${completionPercentage.toFixed(0)}%).
+        ${strongestCategory ? `Your strongest area is <strong>${strongestCategory}</strong> with ${strongestCount} badges earned.` : ''}
+        ${nextMilestoneText}
+      </p>
+    </div>
+  `;
+}
+function buildAchievementsSection(achievementProgress) {
+    return `
+    <div class="achievements-section">
+      <h2>Achievements</h2>
+      
+      ${buildGrowthNarrative(achievementProgress)}
+      
+      <div class="achievement-stats">
+        <div class="stat-card">
+          <div class="stat-value">${achievementProgress.unlockedCount}</div>
+          <div class="stat-label">Badges Unlocked</div>
+        </div>
+        <div class="stat-card">
+          <div class="stat-value">${achievementProgress.completionPercentage.toFixed(0)}%</div>
+          <div class="stat-label">Completion</div>
+        </div>
+        <div class="stat-card">
+          <div class="stat-value">${achievementProgress.totalCount - achievementProgress.unlockedCount}</div>
+          <div class="stat-label">Remaining</div>
+        </div>
+      </div>
+      
+      ${achievementProgress.nextMilestones && achievementProgress.nextMilestones.length > 0 ? `
+        <div class="next-milestones">
+          <h3>Next Milestones</h3>
+          ${achievementProgress.nextMilestones.slice(0, 3).map(milestone => `
+            <div class="milestone-item">
+              <div class="milestone-header">
+                <span class="milestone-emoji">${milestone.emoji}</span>
+                <span class="milestone-name">${milestone.name}</span>
+              </div>
+              <div class="milestone-description">${milestone.description}</div>
+              <div class="milestone-progress-bar">
+                <div class="milestone-progress-fill" style="width: ${milestone.progress}%"></div>
+                <div class="milestone-progress-text">${milestone.progress.toFixed(0)}%</div>
+              </div>
+            </div>
+          `).join('')}
+        </div>
+      ` : ''}
+      
+      ${achievementProgress.newBadges && achievementProgress.newBadges.length > 0 ? `
+        <div class="new-badges">
+          <h3>Recently Unlocked</h3>
+          <div class="badge-list">
+            ${achievementProgress.newBadges.map(badge => `
+              <div class="badge-item-mini">${badge.emoji} ${badge.name}</div>
+            `).join('')}
+          </div>
+        </div>
+      ` : ''}
+      
+      ${achievementProgress.categories ? `
+      <div class="achievement-categories">
+        ${achievementProgress.categories.map(category => `
+          <div class="category-section">
+            <h3>${category.emoji} ${category.name}</h3>
+            <div class="category-progress">
+              <div class="category-bar">
+                <div class="category-fill" style="width: ${category.progress}%"></div>
+              </div>
+              <span class="category-count">${category.unlocked}/${category.total}</span>
+            </div>
+            <div class="achievement-grid">
+              ${category.achievements.map(achievement => buildAchievementCard(achievement)).join('')}
+            </div>
+          </div>
+        `).join('')}
+      </div>
+      ` : achievementProgress.achievements && achievementProgress.achievements.length > 0 ? `
+      <div class="achievements-grid">
+        ${achievementProgress.achievements.map(achievement => buildAchievementCard(achievement)).join('')}
+      </div>
+      ` : ''}
+    </div>
+  `;
+}

package/dist/features/achievements/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Achievement system types.
+ *
+ * @module types/achievements
+ */
+Object.defineProperty(exports, "__esModule", { value: true });