repo-wrapped 0.0.6 → 0.0.9

package/dist/config/defaults.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG = void 0;
+exports.getConfig = getConfig;
+/**
+ * Central configuration for all analysis thresholds and defaults.
+ * Modify these values to tune analysis behavior.
+ *
+ * This file consolidates magic numbers from across the codebase,
+ * making it easy to find, modify, and understand analysis parameters.
+ */
+exports.CONFIG = {
+    /**
+     * Commit message quality thresholds
+     * Used by: commitQualityAnalyzer.ts
+     */
+    commitQuality: {
+        subject: {
+            /** Minimum characters for a valid subject line */
+            minLength: 10,
+            /** Maximum characters for a valid subject line */
+            maxLength: 72,
+            /** Ideal minimum for high-quality subjects */
+            idealMinLength: 20,
+            /** Ideal maximum for high-quality subjects */
+            idealMaxLength: 50,
+        },
+        body: {
+            /** Minimum characters for a meaningful body */
+            minLength: 20,
+        },
+    },
+    /**
+     * Activity gap analysis thresholds
+     * Used by: gapAnalyzer.ts
+     */
+    gaps: {
+        /** Default number of days without activity to flag as gap */
+        defaultThresholdDays: 3,
+        /** Risk level thresholds (in days) */
+        risk: {
+            medium: 7,
+            high: 14,
+            critical: 21,
+        },
+    },
+    /**
+     * Contribution graph settings
+     * Used by: contributionGraph.ts
+     */
+    contributions: {
+        /** Activity levels for contribution graph coloring (commits per day) */
+        activityLevels: [0, 3, 6, 9],
+    },
+    /**
+     * Knowledge distribution and bus factor analysis
+     * Used by: knowledgeDistributionAnalyzer.ts
+     */
+    knowledge: {
+        /** Percentage ownership to be considered the primary owner */
+        significantOwnershipPercent: 65,
+        /** Minimum commits to assess a file's ownership */
+        minCommitsForAssessment: 20,
+        /** Number of owners needed for low bus factor risk */
+        safeOwnerCount: 2,
+        /** Bus factor risk thresholds */
+        busFactor: {
+            low: 2, // 2+ owners
+            medium: 4, // Score threshold
+            high: 6, // Score threshold
+            critical: 8, // Score threshold
+        },
+    },
+    /**
+     * Velocity analysis settings
+     * Used by: velocityAnalyzer.ts
+     */
+    velocity: {
+        /** Rolling average window in weeks */
+        defaultWindowWeeks: 4,
+        /** Deviation from average to flag as anomaly (percentage) */
+        anomalyThresholdPercent: 30,
+        /** Threshold for spike detection multiplier */
+        spikeMultiplier: 2.0,
+        /** Threshold for drop detection percentage */
+        dropThresholdPercent: 50,
+    },
+    /**
+     * Achievement system thresholds
+     * Used by: achievementDefinitions.ts, achievementEngine.ts
+     */
+    achievements: {
+        /** Thresholds for commit count achievements */
+        commitMilestones: {
+            gettingStarted: 10,
+            onFire: 50,
+            centuryClub: 100,
+            champion: 200,
+            master: 300,
+            legend: 500,
+        },
+        /** Thresholds for streak achievements (business days) */
+        streakMilestones: {
+            consistency: 3,
+            weekWarrior: 5,
+            onFire: 10,
+            unstoppable: 20,
+            ironWill: 40,
+            codeMachine: 60,
+        },
+        /** Quality score thresholds */
+        qualityThresholds: {
+            qualityConscious: 70,
+            craftsman: 80,
+            perfectionist: 90,
+            qualityGuru: 95,
+        },
+        /** Collaboration thresholds */
+        collaborationThresholds: {
+            teamPlayer: 10,
+            socialCoder: 25,
+            communityBuilder: 50,
+        },
+    },
+    /**
+     * Time pattern analysis settings
+     * Used by: timePatternAnalyzer.ts
+     */
+    timePatterns: {
+        /** Minimum commits to consider a chronotype reliable */
+        minCommitsForChronotype: 10,
+        /** Hours that define work boundaries */
+        workHours: {
+            start: 9,
+            end: 17,
+        },
+        /** Evening/night boundaries */
+        eveningStart: 18,
+        nightStart: 22,
+        nightEnd: 5,
+        morningStart: 5,
+        morningEnd: 9,
+    },
+    /**
+     * Streak calculation settings
+     * Used by: streakCalculator.ts
+     */
+    streaks: {
+        /** Business days per week (excludes weekends by default) */
+        businessDaysPerWeek: 5,
+    },
+};
+/**
+ * Helper to access nested config with type safety
+ */
+function getConfig(section) {
+    return exports.CONFIG[section];
+}

package/dist/config/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfig = exports.CONFIG = void 0;
+/**
+ * Configuration module for analysis thresholds and defaults.
+ * Import from here to access centralized configuration.
+ */
+var defaults_1 = require("./defaults");
+Object.defineProperty(exports, "CONFIG", { enumerable: true, get: function () { return defaults_1.CONFIG; } });
+Object.defineProperty(exports, "getConfig", { enumerable: true, get: function () { return defaults_1.getConfig; } });

package/dist/features/achievements/data/achievements.json

@@ -0,0 +1,284 @@
+{
+    "achievements": [
+        {
+            "id": "first-steps",
+            "name": "First Steps",
+            "emoji": "🌱",
+            "description": "Made your first commit",
+            "category": "milestone",
+            "tier": "bronze",
+            "isSecret": false,
+            "criteria": { "type": "commit-count", "threshold": 1 }
+        },
+        {
+            "id": "getting-started",
+            "name": "Getting Started",
+            "emoji": "⭐",
+            "description": "Reached 10 commits",
+            "category": "milestone",
+            "tier": "bronze",
+            "isSecret": false,
+            "criteria": { "type": "commit-count", "threshold": 10 }
+        },
+        {
+            "id": "on-fire",
+            "name": "On Fire",
+            "emoji": "🔥",
+            "description": "Reached 50 commits",
+            "category": "milestone",
+            "tier": "silver",
+            "isSecret": false,
+            "criteria": { "type": "commit-count", "threshold": 50 }
+        },
+        {
+            "id": "century-club",
+            "name": "Century Club",
+            "emoji": "👑",
+            "description": "Reached 100 commits",
+            "category": "milestone",
+            "tier": "gold",
+            "isSecret": false,
+            "criteria": { "type": "commit-count", "threshold": 100 }
+        },
+        {
+            "id": "champion",
+            "name": "Champion",
+            "emoji": "🏆",
+            "description": "Reached 200 commits",
+            "category": "milestone",
+            "tier": "gold",
+            "isSecret": false,
+            "criteria": { "type": "commit-count", "threshold": 200 }
+        },
+        {
+            "id": "master",
+            "name": "Master",
+            "emoji": "💫",
+            "description": "Reached 300 commits",
+            "category": "milestone",
+            "tier": "platinum",
+            "isSecret": false,
+            "criteria": { "type": "commit-count", "threshold": 300 }
+        },
+        {
+            "id": "legend",
+            "name": "Legend",
+            "emoji": "🌟",
+            "description": "Reached 500 commits",
+            "category": "milestone",
+            "tier": "legendary",
+            "isSecret": false,
+            "criteria": { "type": "commit-count", "threshold": 500 }
+        },
+        {
+            "id": "consistency",
+            "name": "Consistency",
+            "emoji": "📅",
+            "description": "Maintained a 3-day business day streak",
+            "category": "time",
+            "tier": "bronze",
+            "isSecret": false,
+            "criteria": { "type": "streak", "threshold": 3 }
+        },
+        {
+            "id": "week-warrior",
+            "name": "Week Warrior",
+            "emoji": "⚡",
+            "description": "Maintained a 5-day business day streak (full week)",
+            "category": "time",
+            "tier": "silver",
+            "isSecret": false,
+            "criteria": { "type": "streak", "threshold": 5 }
+        },
+        {
+            "id": "streak-on-fire",
+            "name": "Streak On Fire",
+            "emoji": "🔥",
+            "description": "Maintained a 10-day business day streak (2 weeks)",
+            "category": "time",
+            "tier": "gold",
+            "isSecret": false,
+            "criteria": { "type": "streak", "threshold": 10 }
+        },
+        {
+            "id": "unstoppable",
+            "name": "Unstoppable",
+            "emoji": "💪",
+            "description": "Maintained a 20-day business day streak (1 month)",
+            "category": "time",
+            "tier": "platinum",
+            "isSecret": false,
+            "criteria": { "type": "streak", "threshold": 20 }
+        },
+        {
+            "id": "iron-will",
+            "name": "Iron Will",
+            "emoji": "🦾",
+            "description": "Maintained a 40-day business day streak (2 months)",
+            "category": "time",
+            "tier": "platinum",
+            "isSecret": false,
+            "criteria": { "type": "streak", "threshold": 40 }
+        },
+        {
+            "id": "code-machine",
+            "name": "Code Machine",
+            "emoji": "👾",
+            "description": "Maintained a 60-day business day streak (3 months)",
+            "category": "time",
+            "tier": "legendary",
+            "isSecret": false,
+            "criteria": { "type": "streak", "threshold": 60 }
+        },
+        {
+            "id": "clean-coder",
+            "name": "Clean Coder",
+            "emoji": "✨",
+            "description": "90%+ commits follow conventions",
+            "category": "quality",
+            "tier": "gold",
+            "isSecret": false,
+            "criteria": { "type": "conventional-adherence", "threshold": 90 }
+        },
+        {
+            "id": "documentarian",
+            "name": "Documentarian",
+            "emoji": "📝",
+            "description": "50%+ commits include detailed bodies",
+            "category": "quality",
+            "tier": "silver",
+            "isSecret": false,
+            "criteria": { "type": "body-percentage", "threshold": 50 }
+        },
+        {
+            "id": "quality-champion",
+            "name": "Quality Champion",
+            "emoji": "🏅",
+            "description": "Achieved 9.0+ overall quality score",
+            "category": "quality",
+            "tier": "platinum",
+            "isSecret": false,
+            "criteria": { "type": "quality-score", "threshold": 9.0 }
+        },
+        {
+            "id": "rising-star",
+            "name": "Rising Star",
+            "emoji": "📈",
+            "description": "Quality score above 7.0",
+            "category": "quality",
+            "tier": "gold",
+            "isSecret": false,
+            "criteria": { "type": "quality-score", "threshold": 7.0 }
+        },
+        {
+            "id": "early-bird",
+            "name": "Early Bird",
+            "emoji": "🌅",
+            "description": "20+ commits before 9am",
+            "category": "time",
+            "tier": "silver",
+            "isSecret": false,
+            "criteria": { "type": "time-range-commits", "startHour": 5, "endHour": 9, "threshold": 20 }
+        },
+        {
+            "id": "night-owl",
+            "name": "Night Owl",
+            "emoji": "🦉",
+            "description": "20+ commits after 9pm",
+            "category": "time",
+            "tier": "silver",
+            "isSecret": false,
+            "criteria": { "type": "night-commits", "threshold": 20 }
+        },
+        {
+            "id": "balanced-soul",
+            "name": "Balanced Soul",
+            "emoji": "⚖️",
+            "description": "Even distribution across all time periods",
+            "category": "time",
+            "tier": "gold",
+            "isSecret": false,
+            "criteria": { "type": "chronotype", "value": "balanced" }
+        },
+        {
+            "id": "work-life-balance",
+            "name": "Balanced Life",
+            "emoji": "🌴",
+            "description": "Excellent work-life balance score",
+            "category": "time",
+            "tier": "gold",
+            "isSecret": false,
+            "criteria": { "type": "work-life-score", "threshold": 4 }
+        },
+        {
+            "id": "midnight-coder",
+            "name": "Midnight Coder",
+            "emoji": "🎆",
+            "description": "Committed at exactly midnight",
+            "category": "special",
+            "tier": "silver",
+            "isSecret": true,
+            "criteria": { "type": "midnight-commit" }
+        },
+        {
+            "id": "lucky-seven",
+            "name": "Lucky Seven",
+            "emoji": "🎰",
+            "description": "Reached exactly 777 commits",
+            "category": "special",
+            "tier": "gold",
+            "isSecret": true,
+            "criteria": { "type": "exact-commit-count", "threshold": 777 }
+        },
+        {
+            "id": "binary-master",
+            "name": "Binary Master",
+            "emoji": "🔢",
+            "description": "Reached exactly 1024 commits",
+            "category": "special",
+            "tier": "platinum",
+            "isSecret": true,
+            "criteria": { "type": "exact-commit-count", "threshold": 1024 }
+        },
+        {
+            "id": "weekend-warrior",
+            "name": "Weekend Warrior",
+            "emoji": "🎪",
+            "description": "20%+ commits on weekends",
+            "category": "special",
+            "tier": "silver",
+            "isSecret": false,
+            "criteria": { "type": "weekend-percentage", "threshold": 20 }
+        },
+        {
+            "id": "collector",
+            "name": "Collector",
+            "emoji": "🎖️",
+            "description": "Earned 10 badges",
+            "category": "meta",
+            "tier": "silver",
+            "isSecret": false,
+            "criteria": { "type": "badge-count", "threshold": 10 }
+        },
+        {
+            "id": "completionist",
+            "name": "Completionist",
+            "emoji": "🏅",
+            "description": "Earned 25 badges",
+            "category": "meta",
+            "tier": "gold",
+            "isSecret": false,
+            "criteria": { "type": "badge-count", "threshold": 25 }
+        },
+        {
+            "id": "badge-king",
+            "name": "Badge King",
+            "emoji": "👑",
+            "description": "Earned 50 badges",
+            "category": "meta",
+            "tier": "legendary",
+            "isSecret": false,
+            "criteria": { "type": "badge-count", "threshold": 50 }
+        }
+    ]
+}

package/dist/features/achievements/engine.js

@@ -0,0 +1,140 @@
+"use strict";
+/**
+ * Achievement Engine Module
+ *
+ * Processes achievements against analysis data using data-driven definitions
+ * loaded from JSON and evaluated with pure functions.
+ *
+ * @module achievementEngine
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkAchievements = checkAchievements;
+exports.getRecentAchievements = getRecentAchievements;
+exports.getAchievementsByCategory = getAchievementsByCategory;
+exports.getNextMilestone = getNextMilestone;
+const loader_1 = require("./loader");
+const evaluators_1 = require("./evaluators");
+/**
+ * Convert a definition to a runtime achievement with evaluation results
+ */
+function evaluateAchievement(definition, data) {
+    const result = (0, evaluators_1.evaluate)(data, definition.criteria);
+    return {
+        id: definition.id,
+        name: definition.name,
+        emoji: definition.emoji,
+        description: definition.description,
+        category: definition.category,
+        tier: definition.tier,
+        isSecret: definition.isSecret,
+        criteria: {
+            type: definition.criteria.type,
+            threshold: definition.criteria.threshold,
+        },
+        progress: result.progress,
+        isUnlocked: result.earned,
+        earnedDate: result.earned ? new Date() : undefined,
+    };
+}
+/**
+ * Evaluate meta achievements based on earned badge count
+ */
+function evaluateMetaAchievement(definition, earnedCount) {
+    const result = (0, evaluators_1.evaluateMeta)(earnedCount, definition.criteria);
+    return {
+        id: definition.id,
+        name: definition.name,
+        emoji: definition.emoji,
+        description: definition.description,
+        category: definition.category,
+        tier: definition.tier,
+        isSecret: definition.isSecret,
+        criteria: {
+            type: definition.criteria.type,
+            threshold: definition.criteria.threshold,
+        },
+        progress: result.progress,
+        isUnlocked: result.earned,
+        earnedDate: result.earned ? new Date() : undefined,
+    };
+}
+/**
+ * Check all achievements against analysis data
+ * @param data Analysis data to evaluate achievements against
+ * @returns Achievement progress including all achievements with their status
+ */
+function checkAchievements(data) {
+    const newlyEarned = [];
+    // First, evaluate all non-meta achievements
+    const nonMetaDefinitions = (0, loader_1.getNonMetaAchievements)();
+    const nonMetaAchievements = nonMetaDefinitions.map((def) => {
+        const achievement = evaluateAchievement(def, data);
+        if (achievement.isUnlocked) {
+            newlyEarned.push(achievement);
+        }
+        return achievement;
+    });
+    // Count earned non-meta achievements for meta evaluation
+    const earnedCount = nonMetaAchievements.filter((a) => a.isUnlocked).length;
+    // Then evaluate meta achievements based on earned count
+    const metaDefinitions = (0, loader_1.getMetaAchievements)();
+    const metaAchievements = metaDefinitions.map((def) => {
+        const achievement = evaluateMetaAchievement(def, earnedCount);
+        if (achievement.isUnlocked) {
+            newlyEarned.push(achievement);
+        }
+        return achievement;
+    });
+    // Combine all achievements
+    const achievements = [...nonMetaAchievements, ...metaAchievements];
+    // Find next milestones (top 3 closest to unlocking)
+    const lockedAchievements = achievements.filter((a) => !a.isUnlocked);
+    const nextMilestones = lockedAchievements.sort((a, b) => b.progress - a.progress).slice(0, 3);
+    const totalUnlocked = achievements.filter((a) => a.isUnlocked).length;
+    const completionPercentage = (totalUnlocked / achievements.length) * 100;
+    return {
+        achievements,
+        unlockedCount: totalUnlocked,
+        totalCount: achievements.length,
+        recentlyEarned: newlyEarned,
+        nextMilestones,
+        completionPercentage,
+    };
+}
+/**
+ * Get recently earned achievements within a time window
+ * @param progress Achievement progress to filter
+ * @param days Number of days to look back (default: 7)
+ * @returns Array of recently earned achievements
+ */
+function getRecentAchievements(progress, days = 7) {
+    const cutoffDate = new Date();
+    cutoffDate.setDate(cutoffDate.getDate() - days);
+    return progress.achievements
+        .filter((a) => a.isUnlocked && a.earnedDate && a.earnedDate >= cutoffDate)
+        .sort((a, b) => {
+        if (!a.earnedDate || !b.earnedDate)
+            return 0;
+        return b.earnedDate.getTime() - a.earnedDate.getTime();
+    });
+}
+/**
+ * Get achievements filtered by category
+ * @param progress Achievement progress to filter
+ * @param category Category to filter by
+ * @returns Array of achievements in that category
+ */
+function getAchievementsByCategory(progress, category) {
+    return progress.achievements.filter((a) => a.category === category);
+}
+/**
+ * Get the next closest achievement to being unlocked
+ * @param progress Achievement progress to analyze
+ * @returns The achievement with highest progress that isn't unlocked, or null
+ */
+function getNextMilestone(progress) {
+    const locked = progress.achievements.filter((a) => !a.isUnlocked);
+    if (locked.length === 0)
+        return null;
+    return locked.reduce((closest, current) => current.progress > closest.progress ? current : closest);
+}