repo-wrapped 0.0.7 → 0.0.9

package/dist/html/shared/weekGrouper.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.groupDaysIntoWeeks = groupDaysIntoWeeks;
+exports.getDayLabels = getDayLabels;
+const date_fns_1 = require("date-fns");
+/**
+ * Groups days into weeks for the contribution graph
+ */
+function groupDaysIntoWeeks(startDate, endDate) {
+    const days = (0, date_fns_1.eachDayOfInterval)({ start: startDate, end: endDate });
+    const weeks = [];
+    let currentWeek = [];
+    days.forEach(day => {
+        currentWeek.push(day);
+        if (currentWeek.length === 7) {
+            weeks.push(currentWeek);
+            currentWeek = [];
+        }
+    });
+    return weeks;
+}
+/**
+ * Gets day labels for the contribution graph
+ */
+function getDayLabels() {
+    return ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
+}

package/dist/html/types.js

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

package/dist/index.js

@@ -18,45 +18,45 @@ program
     .name('repo-wrapped')
     .description('Generate Git repository analytics and visualizations')
     .version('1.0.0')
-    .addHelpText('after', `
-Commands:
-  generate [path]         Generate commit visualization (default command)
-  wrapped [year] [path]   Generate Year in Code summary
-
-Generate Options:
-  -y, --year <year>       Year to analyze (default: current year)
-  -m, --months <months>   Number of months to show (default: 12)
-  -a, --all               Analyze entire repository lifetime
-  --html                  Generate HTML report and open in browser
-  --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
-
-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
+    .addHelpText('after', `
+Commands:
+  generate [path]         Generate commit visualization (default command)
+  wrapped [year] [path]   Generate Year in Code summary
+
+Generate Options:
+  -y, --year <year>       Year to analyze (default: current year)
+  -m, --months <months>   Number of months to show (default: 12)
+  -a, --all               Analyze entire repository lifetime
+  --html                  Generate HTML report and open in browser
+  --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
+
+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
     .command('generate')

package/dist/test/helpers/commitFactory.js

@@ -0,0 +1,166 @@
+"use strict";
+/**
+ * Test Commit Factory
+ *
+ * Provides utilities for creating test commit data with sensible defaults.
+ * Use these helpers to create consistent test data across all test files.
+ *
+ * @module test/helpers/commitFactory
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCommit = createCommit;
+exports.createCommitSequence = createCommitSequence;
+exports.createWorkWeekCommits = createWorkWeekCommits;
+exports.createCommitsByHour = createCommitsByHour;
+exports.createConventionalCommits = createConventionalCommits;
+exports.resetHashCounter = resetHashCounter;
+/**
+ * Creates a single CommitData object with default values.
+ * Override any property by passing it in the overrides object.
+ *
+ * @param overrides - Partial commit data to override defaults
+ * @returns Complete CommitData object
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const commit = createCommit();
+ *
+ * // With overrides
+ * const feat = createCommit({ message: 'feat: add login' });
+ *
+ * // With specific date
+ * const oldCommit = createCommit({ date: '2025-01-01T10:00:00Z' });
+ * ```
+ */
+function createCommit(overrides = {}) {
+    return {
+        hash: generateHash(),
+        author: 'Test Author',
+        date: '2025-06-15T10:00:00Z',
+        message: 'test: example commit message',
+        ...overrides,
+    };
+}
+/**
+ * Creates an array of commits on consecutive days.
+ *
+ * @param count - Number of commits to create
+ * @param options - Configuration options
+ * @returns Array of CommitData objects
+ *
+ * @example
+ * ```typescript
+ * // 5 commits on consecutive days
+ * const commits = createCommitSequence(5);
+ *
+ * // Starting from a specific date
+ * const commits = createCommitSequence(3, {
+ *   startDate: new Date('2025-01-01')
+ * });
+ *
+ * // With gaps between commits
+ * const commits = createCommitSequence(3, { intervalDays: 7 });
+ * ```
+ */
+function createCommitSequence(count, options = {}) {
+    const { startDate = new Date('2025-06-01'), intervalDays = 1, author = 'Test Author', messagePrefix = 'test', } = options;
+    return Array.from({ length: count }, (_, i) => {
+        const date = new Date(startDate);
+        date.setDate(date.getDate() + i * intervalDays);
+        return createCommit({
+            hash: `hash${String(i).padStart(3, '0')}`,
+            date: date.toISOString(),
+            author,
+            message: `${messagePrefix}: commit ${i + 1}`,
+        });
+    });
+}
+/**
+ * Creates commits for a full work week (Monday-Friday).
+ *
+ * @param weekStartMonday - The Monday to start the week
+ * @param commitsPerDay - Number of commits per day (default: 1)
+ * @returns Array of commits for Mon-Fri
+ */
+function createWorkWeekCommits(weekStartMonday, commitsPerDay = 1) {
+    const commits = [];
+    for (let day = 0; day < 5; day++) {
+        for (let c = 0; c < commitsPerDay; c++) {
+            const date = new Date(weekStartMonday);
+            date.setDate(date.getDate() + day);
+            date.setHours(9 + c, 0, 0, 0);
+            commits.push(createCommit({
+                hash: `week${day}commit${c}`,
+                date: date.toISOString(),
+                message: `feat: day ${day + 1} commit ${c + 1}`,
+            }));
+        }
+    }
+    return commits;
+}
+/**
+ * Creates commits with specific hour distribution for time pattern testing.
+ *
+ * @param hourCommitMap - Map of hour (0-23) to number of commits
+ * @param baseDate - Base date for all commits
+ * @returns Array of commits at specified hours
+ *
+ * @example
+ * ```typescript
+ * // 3 commits at 9am, 5 commits at 2pm
+ * const commits = createCommitsByHour({ 9: 3, 14: 5 });
+ * ```
+ */
+function createCommitsByHour(hourCommitMap, baseDate = new Date('2025-06-15')) {
+    const commits = [];
+    for (const [hour, count] of Object.entries(hourCommitMap)) {
+        for (let i = 0; i < count; i++) {
+            const date = new Date(baseDate);
+            date.setHours(Number(hour), i * 10, 0, 0);
+            commits.push(createCommit({
+                hash: `hour${hour}commit${i}`,
+                date: date.toISOString(),
+            }));
+        }
+    }
+    return commits;
+}
+/**
+ * Creates commits with various conventional commit types for quality testing.
+ *
+ * @param typeCounts - Map of commit type to count
+ * @returns Array of commits with specified types
+ *
+ * @example
+ * ```typescript
+ * const commits = createConventionalCommits({
+ *   feat: 5,
+ *   fix: 3,
+ *   docs: 1,
+ * });
+ * ```
+ */
+function createConventionalCommits(typeCounts) {
+    const commits = [];
+    for (const [type, count] of Object.entries(typeCounts)) {
+        for (let i = 0; i < count; i++) {
+            commits.push(createCommit({
+                hash: `${type}${i}`,
+                message: `${type}: example ${type} commit ${i + 1}`,
+            }));
+        }
+    }
+    return commits;
+}
+// Internal helper
+let hashCounter = 0;
+function generateHash() {
+    return `abc${String(++hashCounter).padStart(10, '0')}`;
+}
+/**
+ * Resets the hash counter. Call this in beforeEach for deterministic hashes.
+ */
+function resetHashCounter() {
+    hashCounter = 0;
+}

package/dist/test/helpers/dateUtils.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * Date Testing Utilities
+ *
+ * Helpers for working with dates in tests.
+ *
+ * @module test/helpers/dateUtils
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TEST_TODAY = void 0;
+exports.getMonday = getMonday;
+exports.daysAgo = daysAgo;
+exports.daysFromNow = daysFromNow;
+exports.isWeekend = isWeekend;
+exports.getBusinessDaysBetween = getBusinessDaysBetween;
+exports.mockDateNow = mockDateNow;
+exports.toISOString = toISOString;
+exports.parseDate = parseDate;
+/**
+ * Gets the Monday of a given week.
+ *
+ * @param date - Any date in the target week
+ * @returns The Monday of that week
+ */
+function getMonday(date) {
+    const d = new Date(date);
+    const day = d.getDay();
+    const diff = d.getDate() - day + (day === 0 ? -6 : 1);
+    d.setDate(diff);
+    d.setHours(0, 0, 0, 0);
+    return d;
+}
+/**
+ * Creates a date N days ago from a base date.
+ *
+ * @param days - Number of days ago
+ * @param from - Base date (default: 2025-06-15)
+ * @returns Date N days before the base
+ */
+function daysAgo(days, from = new Date('2025-06-15')) {
+    const date = new Date(from);
+    date.setDate(date.getDate() - days);
+    return date;
+}
+/**
+ * Creates a date N days from now relative to base date.
+ */
+function daysFromNow(days, from = new Date('2025-06-15')) {
+    const date = new Date(from);
+    date.setDate(date.getDate() + days);
+    return date;
+}
+/**
+ * Checks if a date is a weekend (Saturday or Sunday).
+ */
+function isWeekend(date) {
+    const day = date.getDay();
+    return day === 0 || day === 6;
+}
+/**
+ * Gets business days between two dates (Mon-Fri).
+ */
+function getBusinessDaysBetween(start, end) {
+    let count = 0;
+    const current = new Date(start);
+    while (current <= end) {
+        if (!isWeekend(current)) {
+            count++;
+        }
+        current.setDate(current.getDate() + 1);
+    }
+    return count;
+}
+/**
+ * Fixed "today" for deterministic tests.
+ * Use this instead of new Date() in tests.
+ */
+exports.TEST_TODAY = new Date('2025-06-15T12:00:00Z');
+/**
+ * Mock Date.now() to return a fixed timestamp.
+ * Call in beforeEach and restore in afterEach.
+ */
+function mockDateNow(fixedDate = exports.TEST_TODAY) {
+    const originalNow = Date.now;
+    Date.now = () => fixedDate.getTime();
+    return () => {
+        Date.now = originalNow;
+    };
+}
+/**
+ * Converts a Date to ISO string for CommitData compatibility.
+ */
+function toISOString(date) {
+    return date.toISOString();
+}
+/**
+ * Parses an ISO date string to Date object.
+ */
+function parseDate(isoString) {
+    return new Date(isoString);
+}

package/dist/test/helpers/index.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Test Helpers
+ *
+ * Central export for all test utilities.
+ *
+ * @module test/helpers
+ * @example
+ * ```typescript
+ * import { createCommit, createCommitSequence, daysAgo } from '../test/helpers';
+ * ```
+ */
+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 });
+__exportStar(require("./commitFactory"), exports);
+__exportStar(require("./dateUtils"), exports);

package/dist/test/setup.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Global Test Setup
+ *
+ * Runs before all tests. Configure global mocks and settings here.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const commitFactory_1 = require("./helpers/commitFactory");
+// Reset hash counter before each test for deterministic results
+(0, vitest_1.beforeEach)(() => {
+    (0, commitFactory_1.resetHashCounter)();
+});
+// Global cleanup if needed
+(0, vitest_1.afterEach)(() => {
+    // Add any global cleanup here
+});

package/dist/test/smoke.test.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * Smoke Test for Test Infrastructure
+ *
+ * Verifies that the test setup and helpers work correctly.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const helpers_1 = require("./helpers");
+const dateUtils_1 = require("./helpers/dateUtils");
+(0, vitest_1.describe)('Test Infrastructure', () => {
+    (0, vitest_1.describe)('commitFactory', () => {
+        (0, vitest_1.it)('creates a valid commit with defaults', () => {
+            const commit = (0, helpers_1.createCommit)();
+            (0, vitest_1.expect)(commit.hash).toBeDefined();
+            (0, vitest_1.expect)(commit.author).toBe('Test Author');
+            (0, vitest_1.expect)(commit.date).toBeDefined();
+            (0, vitest_1.expect)(commit.message).toBe('test: example commit message');
+        });
+        (0, vitest_1.it)('creates a commit with overrides', () => {
+            const commit = (0, helpers_1.createCommit)({
+                author: 'Custom Author',
+                message: 'feat: custom feature',
+            });
+            (0, vitest_1.expect)(commit.author).toBe('Custom Author');
+            (0, vitest_1.expect)(commit.message).toBe('feat: custom feature');
+        });
+        (0, vitest_1.it)('creates a sequence of commits', () => {
+            const commits = (0, helpers_1.createCommitSequence)(5);
+            (0, vitest_1.expect)(commits).toHaveLength(5);
+            commits.forEach((commit, i) => {
+                (0, vitest_1.expect)(commit.hash).toBe(`hash${String(i).padStart(3, '0')}`);
+            });
+        });
+        (0, vitest_1.it)('creates commits on consecutive days', () => {
+            const commits = (0, helpers_1.createCommitSequence)(3, {
+                startDate: new Date('2025-06-01'),
+            });
+            (0, vitest_1.expect)(new Date(commits[0].date).getDate()).toBe(1);
+            (0, vitest_1.expect)(new Date(commits[1].date).getDate()).toBe(2);
+            (0, vitest_1.expect)(new Date(commits[2].date).getDate()).toBe(3);
+        });
+        (0, vitest_1.it)('creates work week commits', () => {
+            const monday = new Date('2025-06-02'); // A Monday
+            const commits = (0, helpers_1.createWorkWeekCommits)(monday);
+            (0, vitest_1.expect)(commits).toHaveLength(5);
+        });
+        (0, vitest_1.it)('creates commits by hour', () => {
+            const commits = (0, helpers_1.createCommitsByHour)({ 9: 2, 14: 3 });
+            (0, vitest_1.expect)(commits).toHaveLength(5);
+        });
+        (0, vitest_1.it)('creates conventional commits', () => {
+            const commits = (0, helpers_1.createConventionalCommits)({
+                feat: 2,
+                fix: 1,
+            });
+            (0, vitest_1.expect)(commits).toHaveLength(3);
+            (0, vitest_1.expect)(commits.filter((c) => c.message.startsWith('feat:'))).toHaveLength(2);
+            (0, vitest_1.expect)(commits.filter((c) => c.message.startsWith('fix:'))).toHaveLength(1);
+        });
+    });
+    (0, vitest_1.describe)('dateUtils', () => {
+        (0, vitest_1.it)('TEST_TODAY is a fixed date', () => {
+            (0, vitest_1.expect)(dateUtils_1.TEST_TODAY).toEqual(new Date('2025-06-15T12:00:00Z'));
+        });
+        (0, vitest_1.it)('getMonday returns the Monday of a week', () => {
+            const wednesday = new Date('2025-06-11'); // Wednesday
+            const monday = (0, dateUtils_1.getMonday)(wednesday);
+            (0, vitest_1.expect)(monday.getDay()).toBe(1); // Monday
+            (0, vitest_1.expect)(monday.getDate()).toBe(9); // June 9, 2025
+        });
+        (0, vitest_1.it)('daysAgo calculates correct date', () => {
+            const result = (0, dateUtils_1.daysAgo)(5, new Date('2025-06-15'));
+            (0, vitest_1.expect)(result.getDate()).toBe(10);
+        });
+        (0, vitest_1.it)('daysFromNow calculates correct date', () => {
+            const result = (0, dateUtils_1.daysFromNow)(5, new Date('2025-06-15'));
+            (0, vitest_1.expect)(result.getDate()).toBe(20);
+        });
+        (0, vitest_1.it)('isWeekend detects weekends correctly', () => {
+            const saturday = new Date('2025-06-14');
+            const sunday = new Date('2025-06-15');
+            const monday = new Date('2025-06-16');
+            (0, vitest_1.expect)((0, dateUtils_1.isWeekend)(saturday)).toBe(true);
+            (0, vitest_1.expect)((0, dateUtils_1.isWeekend)(sunday)).toBe(true);
+            (0, vitest_1.expect)((0, dateUtils_1.isWeekend)(monday)).toBe(false);
+        });
+        (0, vitest_1.it)('getBusinessDaysBetween counts correctly', () => {
+            const start = new Date('2025-06-09'); // Monday
+            const end = new Date('2025-06-13'); // Friday
+            (0, vitest_1.expect)((0, dateUtils_1.getBusinessDaysBetween)(start, end)).toBe(5);
+        });
+    });
+});

package/dist/types/achievements.js

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

package/dist/types/analysis.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Analysis result types for file hotspots and code ownership.
+ *
+ * @module types/analysis
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/core.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Core data structures used throughout the application.
+ *
+ * @module types/core
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/index.js

@@ -1,2 +1,40 @@
 "use strict";
+/**
+ * Type definitions for repo-wrapped.
+ *
+ * This module re-exports all types for backward compatibility.
+ * For new code, consider importing from specific domain modules:
+ *
+ * - `./shared` - Shared type aliases (RiskLevel, TrendDirection, etc.)
+ * - `./core` - Core data structures (CommitData, StreakData, etc.)
+ * - `./analysis` - File analysis types (FileHotspot, ImpactAnalysis, etc.)
+ * - `../features/achievements` - Achievement system types
+ * - `./strategic` - Strategic insights (Velocity, Gaps, Team, etc.)
+ * - `./summary` - Year-in-code summary types
+ * - `./options` - CLI and generation options
+ *
+ * @module types
+ */
+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 });
+// Re-export all types for backward compatibility
+__exportStar(require("./shared"), exports);
+__exportStar(require("./core"), exports);
+__exportStar(require("./analysis"), exports);
+__exportStar(require("../features/achievements/types"), exports);
+__exportStar(require("./strategic"), exports);
+__exportStar(require("./summary"), exports);
+__exportStar(require("./options"), exports);

package/dist/types/options.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * CLI and generation options types.
+ *
+ * @module types/options
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/shared.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Shared type aliases used across all modules.
+ *
+ * @module types/shared
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/strategic.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Strategic insights types for velocity, gaps, team analysis, etc.
+ *
+ * @module types/strategic
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/summary.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Year-in-code summary and comparison types.
+ *
+ * @module types/summary
+ */
+Object.defineProperty(exports, "__esModule", { value: true });