repo-wrapped 0.0.6 → 0.0.9

package/.github/agents/test-writer.agent.md

@@ -0,0 +1,169 @@
+````chatagent
+---
+description: "Generates unit tests for analyzers, utilities, and HTML templates. Creates Jest/Vitest test files with proper coverage of edge cases and expected outputs."
+tools:
+  [
+    "vscode",
+    "read",
+    "edit",
+    "search",
+    "agent",
+  ]
+model: Claude Opus 4.5 (copilot)
+---
+
+You are a test writer for the git-wrapped project. Your job is to generate comprehensive unit tests for analyzers, utilities, and templates.
+
+## Project Context
+
+git-wrapped is a CLI tool that analyzes git history and generates reports. It has:
+- **13 feature analyzers** in `src/features/` - pure functions that transform commits into analysis results
+- **HTML templates** in `src/features/*/template.ts` - render analysis data to HTML strings
+- **Utilities** in `src/utils/` - shared helpers like `gitParser.ts`
+- **Empty result factories** in `src/html/shared/emptyResults.ts` - define expected output shapes
+
+## Test Framework
+
+The project uses **Vitest** (or Jest - check package.json). Tests go in:
+- `src/features/{feature}/__tests__/` for feature tests
+- `src/utils/__tests__/` for utility tests
+- Or colocated as `*.test.ts` next to the source file
+
+## Workflow
+
+1. **Identify what to test** from the user's request:
+   - A specific feature (e.g., "streak calculator")
+   - A utility function (e.g., "git parser")
+   - A template function (e.g., "achievements section")
+   - Or "all" to audit coverage gaps
+
+2. **Read the source file** to understand:
+   - Function signatures and parameters
+   - Return types (check `src/types/index.ts`)
+   - Edge cases from conditional logic
+   - Empty result shape from `emptyResults.ts`
+
+3. **Generate test cases** covering:
+   - Happy path with typical input
+   - Empty input (empty array, no commits)
+   - Single item input
+   - Boundary conditions (date ranges, thresholds)
+   - Error conditions if applicable
+
+4. **Create the test file** with proper structure
+
+## Test Template
+
+```typescript
+import { describe, it, expect, beforeEach } from 'vitest';
+import { analyzeFeature } from '../analyzer';
+import type { Commit } from '../../../types';
+
+// Helper to create test commits
+function createCommit(overrides: Partial<Commit> = {}): Commit {
+  return {
+    hash: 'abc123',
+    author: 'Test Author',
+    email: 'test@example.com',
+    date: new Date('2025-06-15T10:00:00Z'),
+    message: 'test commit',
+    filesChanged: 1,
+    insertions: 10,
+    deletions: 5,
+    files: [],
+    ...overrides,
+  };
+}
+
+describe('analyzeFeature', () => {
+  describe('with empty input', () => {
+    it('returns empty result structure', () => {
+      const result = analyzeFeature([]);
+
+      expect(result).toEqual({
+        // Expected empty shape from emptyResults.ts
+      });
+    });
+  });
+
+  describe('with single commit', () => {
+    it('handles single commit correctly', () => {
+      const commits = [createCommit()];
+      const result = analyzeFeature(commits);
+
+      expect(result).toBeDefined();
+      // Specific assertions
+    });
+  });
+
+  describe('with typical data', () => {
+    it('calculates expected metrics', () => {
+      const commits = [
+        createCommit({ date: new Date('2025-06-01') }),
+        createCommit({ date: new Date('2025-06-02') }),
+        createCommit({ date: new Date('2025-06-03') }),
+      ];
+
+      const result = analyzeFeature(commits);
+
+      // Assert on calculated values
+    });
+  });
+
+  describe('edge cases', () => {
+    it('handles date boundary conditions', () => {
+      // Test start/end of date ranges
+    });
+
+    it('handles commits on same day', () => {
+      // Test deduplication or aggregation
+    });
+  });
+});
+````
+
+## Feature-Specific Testing Patterns
+
+### Analyzers (`src/features/*/analyzer.ts`)
+
+- Test the main `analyze*` function
+- Input is typically `Commit[]` or `AnalysisContext`
+- Output shape defined in types and `emptyResults.ts`
+- Test both positional and context-based calling conventions if both exist
+
+### Templates (`src/features/*/template.ts`)
+
+- Test `build*Section` functions
+- Input is the analysis result type
+- Output is an HTML string
+- Use snapshot testing for complex HTML:
+  ```typescript
+  expect(buildSection(data)).toMatchSnapshot();
+  ```
+- Test with empty/minimal data to verify graceful handling
+
+### Utilities (`src/utils/`)
+
+- Test pure functions with various inputs
+- `gitParser.ts` - test parsing of git log output
+- `achievementEngine.ts` - test achievement unlocking logic
+
+## Reference Files
+
+Always consult:
+
+- `src/types/index.ts` - all type definitions
+- `src/html/shared/emptyResults.ts` - empty result shapes
+- `src/features/{feature}/index.ts` - public API
+- Existing tests (if any) for patterns
+
+## After Creating Tests
+
+1. Suggest running `npm test` or `npx vitest` to verify
+2. Report which test cases were created
+3. Note any edge cases that need manual review
+4. Suggest additional test scenarios if relevant
+
+```
+
+```

package/.stylelintrc.json

@@ -0,0 +1,27 @@
+{
+  "extends": "stylelint-config-standard",
+  "rules": {
+    "color-named": null,
+    "custom-property-pattern": null,
+    "selector-class-pattern": null,
+    "no-descending-specificity": null,
+    "no-duplicate-selectors": null,
+    "property-no-vendor-prefix": null,
+    "value-no-vendor-prefix": null,
+    "comment-empty-line-before": null,
+    "declaration-empty-line-before": null,
+    "rule-empty-line-before": null,
+    "alpha-value-notation": null,
+    "color-function-notation": null,
+    "color-function-alias-notation": null,
+    "import-notation": null,
+    "media-feature-range-notation": null,
+    "declaration-block-single-line-max-declarations": null,
+    "value-keyword-case": null,
+    "declaration-property-value-no-unknown": null
+  },
+  "ignoreFiles": [
+    "dist/**/*",
+    "node_modules/**/*"
+  ]
+}

package/README.md

@@ -1,94 +1,94 @@
-# repo-wrapped
-
-A CLI tool for generating Git repository analytics and visualizations.
-
-## Installation
-
-```bash
-npm install -g repo-wrapped
-```
-
-## Usage
-
-### Generate Visualization
-
-```bash
-# Current directory, current year
-repo-wrapped generate
-
-# Specific repository with HTML output
-repo-wrapped generate /path/to/repo --html
-
-# Analyze entire repository lifetime
-repo-wrapped generate . --all --html
-
-# Deep analysis with file-level knowledge distribution
-repo-wrapped generate . --html --deep-analysis
-```
-
-### Options
-
-| Flag | Description |
-|------|-------------|
-| `-y, --year <year>` | Year to analyze (default: current year) |
-| `-m, --months <months>` | Number of months to show (1-12, 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 analysis for knowledge distribution |
-
-### Year in Code Summary
-
-```bash
-repo-wrapped wrapped 2024 . --html
-```
-
-## HTML Report Sections
-
-- **Contribution Graph** - Interactive commit heatmap
-- **Streak Analytics** - Current and longest streaks, active day percentage
-- **Time Patterns** - Hourly/daily distribution, chronotype detection, burnout risk
-- **Commit Quality** - Message quality scoring, conventional commits adherence
-- **File Hotspots** - Most changed files, technical debt indicators
-- **Achievements** - Progress-based badges and milestones
-- **Impact Analysis** - Lines changed, churn metrics
-- **Knowledge Distribution** - Bus factor risk, ownership analysis
-
-## Development
-
-```bash
-npm install
-npm run build
-npm link
-```
-
-### Project Structure
-
-```
-src/
-├── index.ts                 # CLI entry point
-├── commands/
-│   └── generate.ts          # Generate command
-├── types/
-│   └── index.ts             # TypeScript interfaces
-├── generators/
-│   └── html/
-│       ├── scripts/         # Client-side JS
-│       ├── styles/          # CSS files
-│       ├── templates/       # HTML section builders
-│       └── utils/           # Build utilities
-└── utils/
-    ├── gitParser.ts         # Git log parsing
-    ├── htmlGenerator.ts     # HTML report assembly
-    ├── streakCalculator.ts  # Streak analytics
-    ├── timePatternAnalyzer.ts
-    ├── commitQualityAnalyzer.ts
-    ├── fileHotspotAnalyzer.ts
-    ├── achievementEngine.ts
-    ├── impactAnalyzer.ts
-    └── knowledgeDistributionAnalyzer.ts
-```
-
-## License
-
-MIT
+# repo-wrapped
+
+A CLI tool for generating Git repository analytics and visualizations.
+
+## Installation
+
+```bash
+npm install -g repo-wrapped
+```
+
+## Usage
+
+### Generate Visualization
+
+```bash
+# Current directory, current year
+repo-wrapped generate
+
+# Specific repository with HTML output
+repo-wrapped generate /path/to/repo --html
+
+# Analyze entire repository lifetime
+repo-wrapped generate . --all --html
+
+# Deep analysis with file-level knowledge distribution
+repo-wrapped generate . --html --deep-analysis
+```
+
+### Options
+
+| Flag | Description |
+|------|-------------|
+| `-y, --year <year>` | Year to analyze (default: current year) |
+| `-m, --months <months>` | Number of months to show (1-12, 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 analysis for knowledge distribution |
+
+### Year in Code Summary
+
+```bash
+repo-wrapped wrapped 2024 . --html
+```
+
+## HTML Report Sections
+
+- **Contribution Graph** - Interactive commit heatmap
+- **Streak Analytics** - Current and longest streaks, active day percentage
+- **Time Patterns** - Hourly/daily distribution, chronotype detection, burnout risk
+- **Commit Quality** - Message quality scoring, conventional commits adherence
+- **File Hotspots** - Most changed files, technical debt indicators
+- **Achievements** - Progress-based badges and milestones
+- **Impact Analysis** - Lines changed, churn metrics
+- **Knowledge Distribution** - Bus factor risk, ownership analysis
+
+## Development
+
+```bash
+npm install
+npm run build
+npm link
+```
+
+### Project Structure
+
+```
+src/
+├── index.ts                 # CLI entry point
+├── commands/
+│   └── generate.ts          # Generate command
+├── types/
+│   └── index.ts             # TypeScript interfaces
+├── generators/
+│   └── html/
+│       ├── scripts/         # Client-side JS
+│       ├── styles/          # CSS files
+│       ├── templates/       # HTML section builders
+│       └── utils/           # Build utilities
+└── utils/
+    ├── gitParser.ts         # Git log parsing
+    ├── htmlGenerator.ts     # HTML report assembly
+    ├── streakCalculator.ts  # Streak analytics
+    ├── timePatternAnalyzer.ts
+    ├── commitQualityAnalyzer.ts
+    ├── fileHotspotAnalyzer.ts
+    ├── achievementEngine.ts
+    ├── impactAnalyzer.ts
+    └── knowledgeDistributionAnalyzer.ts
+```
+
+## License
+
+MIT

package/coverage/base.css

@@ -0,0 +1,224 @@
+body, html {
+  margin:0; padding: 0;
+  height: 100%;
+}
+body {
+    font-family: Helvetica Neue, Helvetica, Arial;
+    font-size: 14px;
+    color:#333;
+}
+.small { font-size: 12px; }
+*, *:after, *:before {
+  -webkit-box-sizing:border-box;
+     -moz-box-sizing:border-box;
+          box-sizing:border-box;
+  }
+h1 { font-size: 20px; margin: 0;}
+h2 { font-size: 14px; }
+pre {
+    font: 12px/1.4 Consolas, "Liberation Mono", Menlo, Courier, monospace;
+    margin: 0;
+    padding: 0;
+    -moz-tab-size: 2;
+    -o-tab-size:  2;
+    tab-size: 2;
+}
+a { color:#0074D9; text-decoration:none; }
+a:hover { text-decoration:underline; }
+.strong { font-weight: bold; }
+.space-top1 { padding: 10px 0 0 0; }
+.pad2y { padding: 20px 0; }
+.pad1y { padding: 10px 0; }
+.pad2x { padding: 0 20px; }
+.pad2 { padding: 20px; }
+.pad1 { padding: 10px; }
+.space-left2 { padding-left:55px; }
+.space-right2 { padding-right:20px; }
+.center { text-align:center; }
+.clearfix { display:block; }
+.clearfix:after {
+  content:'';
+  display:block;
+  height:0;
+  clear:both;
+  visibility:hidden;
+  }
+.fl { float: left; }
+@media only screen and (max-width:640px) {
+  .col3 { width:100%; max-width:100%; }
+  .hide-mobile { display:none!important; }
+}
+
+.quiet {
+  color: #7f7f7f;
+  color: rgba(0,0,0,0.5);
+}
+.quiet a { opacity: 0.7; }
+
+.fraction {
+  font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace;
+  font-size: 10px;
+  color: #555;
+  background: #E8E8E8;
+  padding: 4px 5px;
+  border-radius: 3px;
+  vertical-align: middle;
+}
+
+div.path a:link, div.path a:visited { color: #333; }
+table.coverage {
+  border-collapse: collapse;
+  margin: 10px 0 0 0;
+  padding: 0;
+}
+
+table.coverage td {
+  margin: 0;
+  padding: 0;
+  vertical-align: top;
+}
+table.coverage td.line-count {
+    text-align: right;
+    padding: 0 5px 0 20px;
+}
+table.coverage td.line-coverage {
+    text-align: right;
+    padding-right: 10px;
+    min-width:20px;
+}
+
+table.coverage td span.cline-any {
+    display: inline-block;
+    padding: 0 5px;
+    width: 100%;
+}
+.missing-if-branch {
+    display: inline-block;
+    margin-right: 5px;
+    border-radius: 3px;
+    position: relative;
+    padding: 0 4px;
+    background: #333;
+    color: yellow;
+}
+
+.skip-if-branch {
+    display: none;
+    margin-right: 10px;
+    position: relative;
+    padding: 0 4px;
+    background: #ccc;
+    color: white;
+}
+.missing-if-branch .typ, .skip-if-branch .typ {
+    color: inherit !important;
+}
+.coverage-summary {
+  border-collapse: collapse;
+  width: 100%;
+}
+.coverage-summary tr { border-bottom: 1px solid #bbb; }
+.keyline-all { border: 1px solid #ddd; }
+.coverage-summary td, .coverage-summary th { padding: 10px; }
+.coverage-summary tbody { border: 1px solid #bbb; }
+.coverage-summary td { border-right: 1px solid #bbb; }
+.coverage-summary td:last-child { border-right: none; }
+.coverage-summary th {
+  text-align: left;
+  font-weight: normal;
+  white-space: nowrap;
+}
+.coverage-summary th.file { border-right: none !important; }
+.coverage-summary th.pct { }
+.coverage-summary th.pic,
+.coverage-summary th.abs,
+.coverage-summary td.pct,
+.coverage-summary td.abs { text-align: right; }
+.coverage-summary td.file { white-space: nowrap;  }
+.coverage-summary td.pic { min-width: 120px !important;  }
+.coverage-summary tfoot td { }
+
+.coverage-summary .sorter {
+    height: 10px;
+    width: 7px;
+    display: inline-block;
+    margin-left: 0.5em;
+    background: url(sort-arrow-sprite.png) no-repeat scroll 0 0 transparent;
+}
+.coverage-summary .sorted .sorter {
+    background-position: 0 -20px;
+}
+.coverage-summary .sorted-desc .sorter {
+    background-position: 0 -10px;
+}
+.status-line {  height: 10px; }
+/* yellow */
+.cbranch-no { background: yellow !important; color: #111; }
+/* dark red */
+.red.solid, .status-line.low, .low .cover-fill { background:#C21F39 }
+.low .chart { border:1px solid #C21F39 }
+.highlighted,
+.highlighted .cstat-no, .highlighted .fstat-no, .highlighted .cbranch-no{
+  background: #C21F39 !important;
+}
+/* medium red */
+.cstat-no, .fstat-no, .cbranch-no, .cbranch-no { background:#F6C6CE }
+/* light red */
+.low, .cline-no { background:#FCE1E5 }
+/* light green */
+.high, .cline-yes { background:rgb(230,245,208) }
+/* medium green */
+.cstat-yes { background:rgb(161,215,106) }
+/* dark green */
+.status-line.high, .high .cover-fill { background:rgb(77,146,33) }
+.high .chart { border:1px solid rgb(77,146,33) }
+/* dark yellow (gold) */
+.status-line.medium, .medium .cover-fill { background: #f9cd0b; }
+.medium .chart { border:1px solid #f9cd0b; }
+/* light yellow */
+.medium { background: #fff4c2; }
+
+.cstat-skip { background: #ddd; color: #111; }
+.fstat-skip { background: #ddd; color: #111 !important; }
+.cbranch-skip { background: #ddd !important; color: #111; }
+
+span.cline-neutral { background: #eaeaea; }
+
+.coverage-summary td.empty {
+    opacity: .5;
+    padding-top: 4px;
+    padding-bottom: 4px;
+    line-height: 1;
+    color: #888;
+}
+
+.cover-fill, .cover-empty {
+  display:inline-block;
+  height: 12px;
+}
+.chart {
+  line-height: 0;
+}
+.cover-empty {
+    background: white;
+}
+.cover-full {
+    border-right: none !important;
+}
+pre.prettyprint {
+    border: none !important;
+    padding: 0 !important;
+    margin: 0 !important;
+}
+.com { color: #999 !important; }
+.ignore-none { color: #999; font-weight: normal; }
+
+.wrapper {
+  min-height: 100%;
+  height: auto !important;
+  height: 100%;
+  margin: 0 auto -48px;
+}
+.footer, .push {
+  height: 48px;
+}

package/coverage/block-navigation.js

@@ -0,0 +1,87 @@
+/* eslint-disable */
+var jumpToCode = (function init() {
+    // Classes of code we would like to highlight in the file view
+    var missingCoverageClasses = ['.cbranch-no', '.cstat-no', '.fstat-no'];
+
+    // Elements to highlight in the file listing view
+    var fileListingElements = ['td.pct.low'];
+
+    // We don't want to select elements that are direct descendants of another match
+    var notSelector = ':not(' + missingCoverageClasses.join('):not(') + ') > '; // becomes `:not(a):not(b) > `
+
+    // Selector that finds elements on the page to which we can jump
+    var selector =
+        fileListingElements.join(', ') +
+        ', ' +
+        notSelector +
+        missingCoverageClasses.join(', ' + notSelector); // becomes `:not(a):not(b) > a, :not(a):not(b) > b`
+
+    // The NodeList of matching elements
+    var missingCoverageElements = document.querySelectorAll(selector);
+
+    var currentIndex;
+
+    function toggleClass(index) {
+        missingCoverageElements
+            .item(currentIndex)
+            .classList.remove('highlighted');
+        missingCoverageElements.item(index).classList.add('highlighted');
+    }
+
+    function makeCurrent(index) {
+        toggleClass(index);
+        currentIndex = index;
+        missingCoverageElements.item(index).scrollIntoView({
+            behavior: 'smooth',
+            block: 'center',
+            inline: 'center'
+        });
+    }
+
+    function goToPrevious() {
+        var nextIndex = 0;
+        if (typeof currentIndex !== 'number' || currentIndex === 0) {
+            nextIndex = missingCoverageElements.length - 1;
+        } else if (missingCoverageElements.length > 1) {
+            nextIndex = currentIndex - 1;
+        }
+
+        makeCurrent(nextIndex);
+    }
+
+    function goToNext() {
+        var nextIndex = 0;
+
+        if (
+            typeof currentIndex === 'number' &&
+            currentIndex < missingCoverageElements.length - 1
+        ) {
+            nextIndex = currentIndex + 1;
+        }
+
+        makeCurrent(nextIndex);
+    }
+
+    return function jump(event) {
+        if (
+            document.getElementById('fileSearch') === document.activeElement &&
+            document.activeElement != null
+        ) {
+            // if we're currently focused on the search input, we don't want to navigate
+            return;
+        }
+
+        switch (event.which) {
+            case 78: // n
+            case 74: // j
+                goToNext();
+                break;
+            case 66: // b
+            case 75: // k
+            case 80: // p
+                goToPrevious();
+                break;
+        }
+    };
+})();
+window.addEventListener('keydown', jumpToCode);