repo-wrapped 0.0.7 → 0.0.9

package/dist/utils/achievementDefinitions.js

@@ -59,10 +59,10 @@ exports.ACHIEVEMENTS = [
         id: 'champion',
         name: 'Champion',
         emoji: '🏆',
-        description: 'Reached 500 commits',
+        description: 'Reached 200 commits',
         category: 'milestone',
-        tier: 'platinum',
-        criteria: { type: 'commit-count', threshold: 500, comparator: '>=' },
+        tier: 'gold',
+        criteria: { type: 'commit-count', threshold: 200, comparator: '>=' },
         progress: 0,
         isUnlocked: false,
         isSecret: false
@@ -71,10 +71,10 @@ exports.ACHIEVEMENTS = [
         id: 'master',
         name: 'Master',
         emoji: '💫',
-        description: 'Reached 1000 commits',
+        description: 'Reached 300 commits',
         category: 'milestone',
         tier: 'platinum',
-        criteria: { type: 'commit-count', threshold: 1000, comparator: '>=' },
+        criteria: { type: 'commit-count', threshold: 300, comparator: '>=' },
         progress: 0,
         isUnlocked: false,
         isSecret: false
@@ -83,10 +83,10 @@ exports.ACHIEVEMENTS = [
         id: 'legend',
         name: 'Legend',
         emoji: '🌟',
-        description: 'Reached 5000 commits',
+        description: 'Reached 500 commits',
         category: 'milestone',
         tier: 'legendary',
-        criteria: { type: 'commit-count', threshold: 5000, comparator: '>=' },
+        criteria: { type: 'commit-count', threshold: 500, comparator: '>=' },
         progress: 0,
         isUnlocked: false,
         isSecret: false
@@ -98,7 +98,7 @@ exports.ACHIEVEMENTS = [
         id: 'consistency',
         name: 'Consistency',
         emoji: '📅',
-        description: 'Maintained a 3-day commit streak',
+        description: 'Maintained a 3-day business day streak',
         category: 'time',
         tier: 'bronze',
         criteria: { type: 'streak', threshold: 3, comparator: '>=' },
@@ -110,10 +110,10 @@ exports.ACHIEVEMENTS = [
         id: 'week-warrior',
         name: 'Week Warrior',
         emoji: '⚡',
-        description: 'Maintained a 7-day commit streak',
+        description: 'Maintained a 5-day business day streak (full week)',
         category: 'time',
         tier: 'silver',
-        criteria: { type: 'streak', threshold: 7, comparator: '>=' },
+        criteria: { type: 'streak', threshold: 5, comparator: '>=' },
         progress: 0,
         isUnlocked: false,
         isSecret: false
@@ -122,10 +122,10 @@ exports.ACHIEVEMENTS = [
         id: 'streak-on-fire',
         name: 'Streak On Fire',
         emoji: '🔥',
-        description: 'Maintained a 14-day commit streak',
+        description: 'Maintained a 10-day business day streak (2 weeks)',
         category: 'time',
         tier: 'gold',
-        criteria: { type: 'streak', threshold: 14, comparator: '>=' },
+        criteria: { type: 'streak', threshold: 10, comparator: '>=' },
         progress: 0,
         isUnlocked: false,
         isSecret: false
@@ -134,10 +134,10 @@ exports.ACHIEVEMENTS = [
         id: 'unstoppable',
         name: 'Unstoppable',
         emoji: '💪',
-        description: 'Maintained a 30-day commit streak',
+        description: 'Maintained a 20-day business day streak (1 month)',
         category: 'time',
         tier: 'platinum',
-        criteria: { type: 'streak', threshold: 30, comparator: '>=' },
+        criteria: { type: 'streak', threshold: 20, comparator: '>=' },
         progress: 0,
         isUnlocked: false,
         isSecret: false
@@ -146,10 +146,10 @@ exports.ACHIEVEMENTS = [
         id: 'iron-will',
         name: 'Iron Will',
         emoji: '🦾',
-        description: 'Maintained a 60-day commit streak',
+        description: 'Maintained a 40-day business day streak (2 months)',
         category: 'time',
         tier: 'platinum',
-        criteria: { type: 'streak', threshold: 60, comparator: '>=' },
+        criteria: { type: 'streak', threshold: 40, comparator: '>=' },
         progress: 0,
         isUnlocked: false,
         isSecret: false
@@ -158,10 +158,10 @@ exports.ACHIEVEMENTS = [
         id: 'code-machine',
         name: 'Code Machine',
         emoji: '👾',
-        description: 'Maintained a 100-day commit streak',
+        description: 'Maintained a 60-day business day streak (3 months)',
         category: 'time',
         tier: 'legendary',
-        criteria: { type: 'streak', threshold: 100, comparator: '>=' },
+        criteria: { type: 'streak', threshold: 60, comparator: '>=' },
         progress: 0,
         isUnlocked: false,
         isSecret: false
@@ -230,7 +230,7 @@ exports.ACHIEVEMENTS = [
         id: 'early-bird',
         name: 'Early Bird',
         emoji: '🌅',
-        description: '50+ commits before 9am',
+        description: '20+ commits before 9am',
         category: 'time',
         tier: 'silver',
         criteria: {
@@ -240,7 +240,7 @@ exports.ACHIEVEMENTS = [
                     const hour = new Date(c.date).getHours();
                     return hour >= 5 && hour < 9;
                 }).length;
-                return earlyCommits >= 50;
+                return earlyCommits >= 20;
             }
         },
         progress: 0,
@@ -251,7 +251,7 @@ exports.ACHIEVEMENTS = [
         id: 'night-owl',
         name: 'Night Owl',
         emoji: '🦉',
-        description: '50+ commits after 9pm',
+        description: '20+ commits after 9pm',
         category: 'time',
         tier: 'silver',
         criteria: {
@@ -261,7 +261,7 @@ exports.ACHIEVEMENTS = [
                     const hour = new Date(c.date).getHours();
                     return hour >= 21 || hour < 5;
                 }).length;
-                return lateCommits >= 50;
+                return lateCommits >= 20;
             }
         },
         progress: 0,

package/dist/utils/analyzerContextBuilder.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * Utility functions for building and working with AnalyzerContext.
+ *
+ * @module analyzerContextBuilder
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAnalyzerContext = isAnalyzerContext;
+exports.buildContext = buildContext;
+exports.getOption = getOption;
+exports.computeFileChanges = computeFileChanges;
+exports.withOptions = withOptions;
+/**
+ * Type guard to check if an argument is an AnalyzerContext.
+ *
+ * @param arg - Value to check
+ * @returns True if the argument is an AnalyzerContext
+ *
+ * @example
+ * ```typescript
+ * function analyze(arg1: CommitData[] | AnalyzerContext, ...rest: unknown[]) {
+ *   if (isAnalyzerContext(arg1)) {
+ *     // Use arg1.commits, arg1.dateRange, etc.
+ *   } else {
+ *     // Use positional parameters
+ *   }
+ * }
+ * ```
+ */
+function isAnalyzerContext(arg) {
+    return (typeof arg === 'object' &&
+        arg !== null &&
+        'commits' in arg &&
+        'dateRange' in arg &&
+        typeof arg.dateRange === 'object' &&
+        arg.dateRange !== null &&
+        'start' in arg.dateRange &&
+        'end' in arg.dateRange);
+}
+/**
+ * Build an AnalyzerContext from individual parameters.
+ *
+ * @param commits - Array of commits to analyze
+ * @param startDate - Start of the analysis period
+ * @param endDate - End of the analysis period
+ * @param repoPath - Path to the repository (optional)
+ * @param options - Additional analyzer options (optional)
+ * @returns A fully constructed AnalyzerContext
+ *
+ * @example
+ * ```typescript
+ * const ctx = buildContext(commits, startDate, endDate, '/path/to/repo', { windowWeeks: 8 });
+ * const velocity = analyzeVelocity(ctx);
+ * ```
+ */
+function buildContext(commits, startDate, endDate, repoPath = '', options) {
+    return {
+        commits,
+        dateRange: {
+            start: startDate,
+            end: endDate,
+        },
+        repoPath,
+        options,
+    };
+}
+/**
+ * Get an option value from context with a default fallback.
+ *
+ * @param ctx - The analyzer context
+ * @param key - The option key to retrieve
+ * @param defaultValue - Default value if option is not set
+ * @returns The option value or the default
+ *
+ * @example
+ * ```typescript
+ * const windowWeeks = getOption(ctx, 'windowWeeks', 4);
+ * const thresholdDays = getOption(ctx, 'thresholdDays', 3);
+ * ```
+ */
+function getOption(ctx, key, defaultValue) {
+    return ctx.options?.[key] ?? defaultValue;
+}
+/**
+ * Compute file change data from commits (cached).
+ *
+ * This is an expensive operation that should only be done once
+ * and then shared across analyzers via the context.
+ *
+ * @param _repoPath - Path to the git repository
+ * @param _commits - Commits to analyze for file changes
+ * @returns Map of file paths to change data
+ *
+ * @remarks
+ * This is a placeholder for future implementation.
+ * Currently returns an empty map.
+ */
+function computeFileChanges(_repoPath, _commits) {
+    // TODO: Implement git log --name-only parsing
+    // This would be called once and shared across impact/knowledge analyzers
+    return new Map();
+}
+/**
+ * Clone a context with merged options.
+ *
+ * @param ctx - Original context
+ * @param additionalOptions - Options to merge
+ * @returns New context with merged options
+ *
+ * @example
+ * ```typescript
+ * const velocityCtx = withOptions(ctx, { windowWeeks: 8 });
+ * const gapCtx = withOptions(ctx, { thresholdDays: 5, excludeWeekends: true });
+ * ```
+ */
+function withOptions(ctx, additionalOptions) {
+    return {
+        ...ctx,
+        options: {
+            ...ctx.options,
+            ...additionalOptions,
+        },
+    };
+}

package/dist/utils/commitQualityAnalyzer.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.analyzeCommitQuality = analyzeCommitQuality;
 exports.getQualityRating = getQualityRating;
 exports.getQualityLevel = getQualityLevel;
+const analyzerContextBuilder_1 = require("./analyzerContextBuilder");
 const CONVENTIONAL_COMMIT_REGEX = /^(feat|fix|docs|style|refactor|test|chore|perf|ci|build|revert)(\(.+\))?!?:\s.+/;
 const CODE_HYGIENE_PATTERNS = {
     quickFix: /fix(ed)?\s+(typo|spelling|grammar)/i,
@@ -24,8 +25,18 @@ const IMPERATIVE_STARTERS = [
     'improve', 'optimize', 'enhance', 'change', 'move', 'rename', 'extract',
     'merge', 'bump', 'revert', 'document', 'test', 'upgrade', 'downgrade'
 ];
-function analyzeCommitQuality(commits, options = {}) {
-    const { skipBodyCheck = false } = options;
+function analyzeCommitQuality(ctxOrCommits, options = {}) {
+    // Normalize to internal variables
+    let commits;
+    let skipBodyCheck;
+    if ((0, analyzerContextBuilder_1.isAnalyzerContext)(ctxOrCommits)) {
+        commits = ctxOrCommits.commits;
+        skipBodyCheck = (0, analyzerContextBuilder_1.getOption)(ctxOrCommits, 'skipBodyCheck', false);
+    }
+    else {
+        commits = ctxOrCommits;
+        skipBodyCheck = options.skipBodyCheck ?? false;
+    }
     if (commits.length === 0) {
         return getEmptyQuality();
     }

package/dist/utils/emptyResults.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * Centralized empty result factories for all analyzers
+ * Provides consistent default values when there's no data to analyze
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEmptyImpactAnalysis = getEmptyImpactAnalysis;
+exports.getEmptyVelocityAnalysis = getEmptyVelocityAnalysis;
+exports.getEmptyGapAnalysis = getEmptyGapAnalysis;
+exports.getEmptyKnowledgeDistribution = getEmptyKnowledgeDistribution;
+exports.getEmptyFileHotspotAnalysis = getEmptyFileHotspotAnalysis;
+const date_fns_1 = require("date-fns");
+/**
+ * Creates an empty impact analysis result
+ */
+function getEmptyImpactAnalysis() {
+    return {
+        overallScore: 0,
+        scoreBreakdown: {
+            coreContributions: 0,
+            featureWork: 0,
+            maintenanceWork: 0,
+            documentationWork: 0,
+        },
+        topImpactFiles: [],
+        impactTrend: 'stable',
+        insights: ['No commit data available for analysis']
+    };
+}
+/**
+ * Creates an empty velocity analysis result
+ */
+function getEmptyVelocityAnalysis() {
+    return {
+        timeline: [],
+        overallTrend: 'stable',
+        trendPercentage: 0,
+        averageCommitsPerWeek: 0,
+        peakWeek: { weekStart: new Date(), commits: 0 },
+        lowestWeek: { weekStart: new Date(), commits: 0 },
+        anomalies: [],
+    };
+}
+/**
+ * Creates an empty gap analysis result
+ */
+function getEmptyGapAnalysis(startDate, endDate) {
+    const totalDays = (0, date_fns_1.differenceInDays)(endDate, startDate) + 1;
+    return {
+        gaps: [{
+                start: startDate,
+                end: endDate,
+                durationDays: totalDays,
+                commitBefore: null,
+                commitAfter: null,
+                possibleType: 'blocker',
+            }],
+        totalGapDays: totalDays,
+        percentageOfPeriodInGaps: 100,
+        longestGap: null,
+        averageGapLength: totalDays,
+        gapFrequency: 0,
+        patterns: [],
+        riskLevel: 'critical',
+        riskFactors: ['No commits found in the analysis period'],
+    };
+}
+/**
+ * Creates an empty knowledge distribution result
+ */
+function getEmptyKnowledgeDistribution() {
+    return {
+        directories: [],
+        busFactorRisk: {
+            overall: 0,
+            level: 'low',
+            criticalPaths: []
+        },
+        knowledgeSilos: [],
+        sharedKnowledge: [],
+        recommendations: ['No commit data available for analysis']
+    };
+}
+/**
+ * Creates an empty file hotspot analysis result
+ */
+function getEmptyFileHotspotAnalysis() {
+    return {
+        topFiles: [],
+        topDirectories: [],
+        technicalDebt: [],
+        ownershipRisks: [],
+        totalFilesAnalyzed: 0
+    };
+}

package/dist/utils/fileHotspotAnalyzer.js

@@ -4,6 +4,7 @@ exports.analyzeFileHotspots = analyzeFileHotspots;
 exports.getRiskLevelColor = getRiskLevelColor;
 exports.getOwnershipIcon = getOwnershipIcon;
 const child_process_1 = require("child_process");
+const emptyResults_1 = require("./emptyResults");
 function analyzeFileHotspots(repoPath, startDate, endDate) {
     try {
         // Get file changes with author info from git log
@@ -15,10 +16,10 @@ function analyzeFileHotspots(repoPath, startDate, endDate) {
         }
         catch (gitError) {
             // Git command failed, likely not in a git repo or no commits in range
-            return getEmptyAnalysis();
+            return (0, emptyResults_1.getEmptyFileHotspotAnalysis)();
         }
         if (!gitLog) {
-            return getEmptyAnalysis();
+            return (0, emptyResults_1.getEmptyFileHotspotAnalysis)();
         }
         // Parse git log output
         const fileMap = new Map();
@@ -91,7 +92,7 @@ function analyzeFileHotspots(repoPath, startDate, endDate) {
     }
     catch (error) {
         console.error('Error analyzing file hotspots:', error);
-        return getEmptyAnalysis();
+        return (0, emptyResults_1.getEmptyFileHotspotAnalysis)();
     }
 }
 function shouldIgnoreFile(path) {
@@ -241,15 +242,6 @@ function analyzeOwnership(files) {
         .sort((a, b) => b.busFactorRisk - a.busFactorRisk)
         .slice(0, 10);
 }
-function getEmptyAnalysis() {
-    return {
-        topFiles: [],
-        topDirectories: [],
-        technicalDebt: [],
-        ownershipRisks: [],
-        totalFilesAnalyzed: 0
-    };
-}
 function getRiskLevelColor(level) {
     switch (level) {
         case 'critical': return '🔴';

package/dist/utils/gapAnalyzer.js

@@ -3,20 +3,39 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.analyzeGaps = analyzeGaps;
 exports.formatGapInsights = formatGapInsights;
 const date_fns_1 = require("date-fns");
-/**
- * Analyzes gaps in activity to identify blockers and disruptions
- */
-function analyzeGaps(commits, startDate, endDate, thresholdDays = 3, excludeWeekends = false) {
+const emptyResults_1 = require("./emptyResults");
+const analyzerContextBuilder_1 = require("./analyzerContextBuilder");
+function analyzeGaps(ctxOrCommits, startDate, endDate, thresholdDays = 3, excludeWeekends = false) {
+    // Normalize to internal variables
+    let commits;
+    let start;
+    let end;
+    let threshold;
+    let skipWeekends;
+    if ((0, analyzerContextBuilder_1.isAnalyzerContext)(ctxOrCommits)) {
+        commits = ctxOrCommits.commits;
+        start = ctxOrCommits.dateRange.start;
+        end = ctxOrCommits.dateRange.end;
+        threshold = (0, analyzerContextBuilder_1.getOption)(ctxOrCommits, 'thresholdDays', 3);
+        skipWeekends = (0, analyzerContextBuilder_1.getOption)(ctxOrCommits, 'excludeWeekends', false);
+    }
+    else {
+        commits = ctxOrCommits;
+        start = startDate;
+        end = endDate;
+        threshold = thresholdDays;
+        skipWeekends = excludeWeekends;
+    }
     if (commits.length === 0) {
-        return getEmptyGapAnalysis(startDate, endDate);
+        return (0, emptyResults_1.getEmptyGapAnalysis)(start, end);
     }
     // Sort commits by date
     const sortedCommits = [...commits].sort((a, b) => new Date(a.date).getTime() - new Date(b.date).getTime());
     // Find all gaps
-    const gaps = findGaps(sortedCommits, startDate, endDate, thresholdDays, excludeWeekends);
+    const gaps = findGaps(sortedCommits, start, end, threshold, skipWeekends);
     // Calculate statistics
     const totalGapDays = gaps.reduce((sum, gap) => sum + gap.durationDays, 0);
-    const totalPeriodDays = (0, date_fns_1.differenceInDays)(endDate, startDate) + 1;
+    const totalPeriodDays = (0, date_fns_1.differenceInDays)(end, start) + 1;
     const percentageOfPeriodInGaps = totalPeriodDays > 0
         ? Math.round((totalGapDays / totalPeriodDays) * 1000) / 10
         : 0;
@@ -245,27 +264,6 @@ function assessGapRisk(gaps, percentageInGaps, longestGap) {
     }
     return { riskLevel, riskFactors };
 }
-function getEmptyGapAnalysis(startDate, endDate) {
-    const totalDays = (0, date_fns_1.differenceInDays)(endDate, startDate) + 1;
-    return {
-        gaps: [{
-                start: startDate,
-                end: endDate,
-                durationDays: totalDays,
-                commitBefore: null,
-                commitAfter: null,
-                possibleType: 'blocker',
-            }],
-        totalGapDays: totalDays,
-        percentageOfPeriodInGaps: 100,
-        longestGap: null,
-        averageGapLength: totalDays,
-        gapFrequency: 0,
-        patterns: [],
-        riskLevel: 'critical',
-        riskFactors: ['No commits found in the analysis period'],
-    };
-}
 /**
  * Format gap analysis for display
  */