โ† Back to Git Spark

Changelog

Every published release of git-spark, newest first. Latest: v2.0.3.
Install with npm ยท Source: CHANGELOG.md

v2.0.3

Latest

Fixed

  • --path accepts Git glob patterns such as src/** and src/core/*.ts. It was validated as a regular expression, so ** failed with "Path pattern is not a valid regex pattern" even though the value is passed to Git as a pathspec
  • --branch combined with --path now analyzes the requested branch. The branch was placed after Git's -- separator, so Git read it as a second path and analyzed the current branch instead
  • The oldest commit in the analyzed range is no longer dropped when its message has a multi-line body. The last record of the Git log stream was parsed as if its header ended at the first newline, so a body spanning several lines made it look malformed and it was silently skipped, undercounting commits, churn, and files in any window or path filter whose oldest commit had a detailed message
  • git-spark validate recognizes a Git repository again. It always reported "Failed to validate Git repository" because a module import lacked the .js extension that Node ESM requires
  • git-spark analyze now applies the global options (--days, --format, --output, --path, and the rest). It only read --repo, so the other options were silently ignored
  • Bus Factor shows 0% instead of NaN% when the analyzed window has no commits, in the CLI summary, health check, and console, HTML, and Markdown reports

Security

  • git-spark html --serve listens on 127.0.0.1 only and no longer sends Access-Control-Allow-Origin: *. It listened on every network interface, so anyone on the local network could read the report, including author names and emails. Requests other than GET and HEAD now return 405

v2.0.2

Added

  • Release history page on the docs site (docs/changelog.html), generated from CHANGELOG.md by scripts/generate-changelog-page.js during npm version and linked from the landing page
  • GitHub Releases are now created automatically after a successful npm publish, using that version's CHANGELOG.md section as the release notes (scripts/extract-release-notes.js)

Changed

  • Updated dependencies, including ora 10 (CLI spinners)
  • CI security audit: npm audit now checks production dependencies only, while audit-ci audits everything with an allowlist (audit-ci.jsonc) for two dev-only advisories that have no upstream fix yet (GHSA-3g3m-2fjr-6pw4 in glob, GHSA-g3hv-75wg-m249 in minimatch)
  • A failed npm publish now opens a GitHub issue instead of only logging a message

Fixed

  • README "Repo Story" link pointed at a file that no longer exists; it now links to a current repository story

v2.0.1

Fixed

  • --days no longer drops recent commits when the window reaches back past the repository's first commit. The adjusted start date was passed to git as a bare YYYY-MM-DD in UTC, which git reads as that date at the current local time of day; when the local and UTC dates differed (for example, US evenings) commits made earlier that day were silently excluded. The start is now a full UTC timestamp
  • Installing git-spark no longer triggers npm's "install scripts blocked" warning. The husky git-hook setup moved from postinstall to prepare, which runs only for contributors installing inside the repository, never for users installing the package from npm
  • The docs site sample report now covers the last 365 days instead of a 30-day window ending at the UTC date, which could produce an empty report when the workflow ran just after midnight UTC

v2.0.0

Breaking

  • Node.js 26.0.0 or newer is now required (previously 22.22.2). engines, .nvmrc, the CI matrix (26.0.0 and 26.x), and the README badge are aligned to the new minimum

Changed

  • Compile with TypeScript 7 while keeping the TypeScript 6 API for tooling (ESLint, Jest, TypeDoc)
  • Refactored GitAnalyzer and related modules for stronger typing of author and file metrics, safer regex validation, and improved error handling in the collector
  • Updated devDependencies to current releases

Security

  • Resolved GHSA-hp3w-g68c-fv3c (sprintf-js DoS, no upstream fix) in the dev toolchain by overriding argparse to 2.x under js-yaml@3; js-yaml only uses argparse in its CLI, so test and coverage behavior is unchanged

Internal

  • Replaced the Bold framework with DevSpark 9.2.0 and added Claude Code /devspark-* command entry points

v1.4.0

Not published to npm. The npm publish for this tag failed with an authentication error, so [email protected] was never released. Every change below shipped in 2.0.0.

Added

  • New git-spark periods command: compares commit churn and activity across consecutive fixed-length periods (e.g. sprints), with console, markdown, and HTML output formats (src/cli/periods-command.ts, src/core/period-summary.ts, src/output/periods-*.ts, src/types/periods.ts)
  • Shallow clone detection: GitExecutor.isShallowRepository() warns when a shallow clone may be missing commits needed for accurate period comparisons
  • Fast type-check in CI: typecheck:fast script using tsgo (TypeScript native preview) added as a non-blocking CI step
  • scripts/update-changelog.js: automatically promotes CHANGELOG.md's [Unreleased] section to a dated version section during npm version (wired in as the version lifecycle script), so npm run release:* keeps the changelog in sync with the version bump instead of requiring a separate manual edit

Changed

  • Hardened the scheduled dependency-update workflow (security.yml) with explicit contents: write / pull-requests: write permissions and persist-credentials: false on checkout

Removed

  • Removed the unimplemented --compare <branch> and --watch CLI flags and their unused ComparisonReport / ComparisonDifferences types

v1.3.2

Changed

  • Updated homepage in package.json to https://git-spark.makeboldspark.com (was GitHub Pages URL)

v1.3.1

Added

  • New live site: hosted at git-spark.makeboldspark.com as part of the Make Bold Spark portfolio migration from GitHub Pages
  • Google Analytics (G-RY77Z11S9E) added to docs/index.html and docs/git-spark-report.html
  • HTML output modularisation: large html.ts split into focused modules โ€” html-author-profiles.ts, html-daily-trends.ts, html-daily-trends-charts.ts, html-daily-trends-tables.ts, html-file-filter.ts, html-scripts.ts, html-static-sections.ts, html-styles-base.ts, html-styles-charts.ts, html-styles-components.ts, html-styles.ts โ€” preserving the full public API surface
  • version-fallback-coverage test suite exercising the package.json fallback branch in version-fallback.ts
  • Dependency hygiene regression tests guarding against future hygiene regressions
  • DevSpark framework: full migration from Speckit โ€” agent shims, prompt templates, scripts, and constitution governance in .devspark/ and .documentation/

Changed

  • Bumped all dev-dependency patch releases: @types/node 25.7โ†’25.9, @typescript-eslint/* 8.59.3โ†’8.59.4, eslint 10.3โ†’10.4, publint 0.3.20โ†’0.3.21, ts-jest 29.4.9โ†’29.4.10
  • README and site links updated to https://git-spark.makeboldspark.com
  • Updated Open Graph metadata (og:url, og:image) in docs/index.html

Fixed

  • CI: npm run prebuild now runs before npm run test:coverage on all matrix jobs, fixing version-fallback-coverage.test.ts failure caused by missing generated src/version.ts
  • Publish workflow: removed broken npm install -g npm@latest step that caused MODULE_NOT_FOUND: promise-retry on every publish run; actions/setup-node@v6 already provides npm 11+
  • Pages deployment: removed stale gitlink test-tmp/cli-test-repo-* from the git index that was breaking git submodule update in the GitHub Pages deployer; added test-tmp/ to .gitignore

v1.3.0

Added

  • Release and Maintenance Tooling
    • Added dedicated HTML report command implementation to keep report generation, preview, and serving logic isolated from the main CLI flow
    • Added DevSpark agent and prompt definitions plus supporting documentation templates for structured project workflows
    • Added repository constitution history and amendment proposal tracking for governance changes

Changed

  • Internal Architecture Refactoring

    • Split large analyzer, daily trends, and HTML output modules into focused helper files for better maintainability
    • Split shared type definitions into smaller domain-focused modules while preserving the public API surface
    • Refined report and analysis utilities to improve readability and long-term maintainability
  • Project Scope Cleanup

    • Removed Azure DevOps integration remnants and related cached artifacts to keep Git Spark focused on Git-derived analytics
    • Updated documentation and site metadata to reflect the current release and repository state

Fixed

  • Security and Validation Hardening
    • Resolved open CodeQL findings and patched a high-severity transitive dependency vulnerability
    • Hardened path-pattern validation to better guard against malformed or dangerous regex input
    • Removed an invalid CLI flag from workflow automation and refreshed publishing documentation

Technical

  • Upgraded ESLint to v10 and aligned the codebase with its updated defaults
  • Expanded coverage around CSV export and validation behavior while keeping the release build green

v1.2.0

Added

  • Interactive Configuration Wizard

    • New git-spark init command for interactive project setup
    • Creates .git-spark.json configuration file with sensible defaults
    • Options for repository path (-r, --repo), non-interactive mode (-y, --yes)
    • Guided prompts for days to analyze, output format, and extension exclusions
  • CLI Entry Point

    • Created bin/git-spark.js for proper global npm installation support
    • Ensures npx git-spark and global installs work correctly
  • Enhanced Package Configuration

    • Added modern exports field for better ESM/bundler compatibility
    • Added module field pointing to ESM entry point
    • Added sideEffects: false for improved tree-shaking
    • Added funding field for sponsor information
    • Improved npm discoverability with additional keywords
    • Added postversion script for automatic documentation version sync

Fixed

  • npm Package Installation
    • Fixed missing CLI entry point that prevented global installations from working

Technical

  • Updated package.json with modern npm best practices
  • Improved pack:test script for better local testing workflow

v1.0.263

Security

  • Command Injection Prevention
    • Implemented robust sanitization for Git operations to prevent command injection vulnerabilities
    • Enhanced regex validation security

Added

  • Team Metrics Enhancements
    • Implemented comprehensive updates for team metrics transparency and accuracy
  • CI Reliability
    • Added robust version fallback mechanism to enhance CI reliability
  • Project Hygiene
    • Updated ignore files to better exclude test, config, and IDE artifacts

Fixed

  • Test Stability
    • Resolved flaky timestamp tests
    • Adjusted coverage thresholds to match CI environments
  • CI Workflow
    • Made macOS tests non-blocking to prevent false negatives in CI pipelines

Technical

  • Added comprehensive test coverage for daily-trends and CSV exporters

v1.0.221

Added

  • Current Repository State Enhancements
    • Executive Summary-style metrics grid layout for consistency
    • Professional table layouts with data-table styling throughout
    • Repository filesystem statistics with extension, category, and directory breakdowns
  • GitIgnore Utility Testing
    • Added comprehensive test suite for GitIgnore utility functionality
    • Improved test coverage for ignore pattern matching and file filtering

Fixed

  • Directory Counting Bug
    • Fixed "N/A" display for directory counts in Current Repository State section
    • Root cause: Interface mismatch between analyzer (topDirectories) and HTML template (directoryBreakdown)
    • Directory count now correctly displays actual numbers and detailed breakdown table
    • Updated HTML template field references to use correct analyzer data structure

Changed

  • Repository Organization
    • Cleaned up repository structure by removing 18 temporary test output folders
    • Removed clutter from root directory (test-, demo- folders)
    • Improved .gitignore patterns to prevent future test output pollution
    • Maintained all essential functionality while achieving cleaner project structure
  • Layout Improvements
    • Current Repository State section now matches Executive Summary styling
    • Consistent metric-card design across all summary sections
    • Enhanced table layouts with proper data-table CSS classes

v1.0.183

Fixed

  • HTML Report Meta Tag

    • Removed extra > character in og:description meta tag causing validation error
  • Volume Trends Sparkline Visualization

    • Fixed completely flat sparklines that weren't reflecting data variation
    • Root cause: CSS flexbox flex: 1 property was overriding height styles
    • Migrated from div-based flexbox implementation to SVG coordinate system for precise control

Changed

  • Volume Trends Layout

    • Made Volume Trends section full-width using grid-column: 1 / -1
    • Matches layout style of Daily Commits and Active Authors sections
    • Improved visual consistency in Visual Trend Analysis section
  • Sparkline Implementation

    • Replaced CSS flexbox bars with SVG <rect> elements
    • Added gradient fills using <linearGradient> for visual enhancement
    • Implemented bottom-aligned coordinate positioning (y = chartHeight - height)
    • Data-driven height calculation now properly visualizes variations

Technical

  • Updated src/output/html.ts - Complete sparkline rewrite using SVG (lines 2755-2825)
  • Modified CSS Grid layout for full-width sparklines (line 1567)
  • Removed flexbox sparkline styles, added SVG container styles (lines 1607-1615)
  • Updated test/html-exporter.test.ts - Changed test expectations from .spark-bar divs to <svg> elements
  • All 217 tests passing with new SVG implementation
  • Version bump from 1.0.175 to 1.0.183

v1.0.170

Fixed

  • Critical Bug: First Commit Date Detection

    • Fixed getFirstCommitDate() method that was returning incorrect dates
    • Removed problematic --max-count=1 flag that limited results before reversing
    • Now uses --all --reverse to find true repository first commit across all branches
    • Resolves issue where --days=300 returned 0 commits despite recent activity
  • Date Range Calculation

    • Added repository lifetime capping to prevent analysis periods before first commit
    • Implemented timezone-safe date handling by subtracting 1 day from first commit
    • Fixed analysis period display showing impossible dates (before repository creation)
    • Added comprehensive debug logging for date comparisons

Changed

  • HTML Report Navigation
    • Reorganized navigation menu to match visual section order
    • Final order: Summary โ†’ Authors โ†’ Team Patterns โ†’ Files โ†’ Author Details โ†’ Detailed Daily Tables โ†’ Limitations โ†’ Documentation โ†’ Metadata
    • Split "Daily Activity Trends" section for better organization:
      • Moved visualizations (Analysis Period Overview, Contributions Calendar, Visual Trend Analysis) to Team Patterns section
      • Kept detailed tables in separate "Detailed Daily Tables" section at bottom
    • Positioned "Detailed Daily Tables" between Author Details and Limitations for logical flow

Technical

  • Updated src/utils/git.ts - Complete rewrite of getFirstCommitDate() method
  • Enhanced src/core/collector.ts - Added repository lifetime capping with timezone safety
  • Modified src/output/html.ts - Navigation reordering and date display improvements
  • Updated test/git-utils.test.ts - Test expectations match new implementation
  • All 217 tests passing with updated logic

v1.0.0

Added

  • Core Analytics Engine

    • Repository health scoring with actionable recommendations
    • Team collaboration analysis and contribution patterns
    • Code quality metrics and risk assessment
    • Timeline visualization and trend analysis
    • Bus factor calculation for team resilience
  • Interactive HTML Reports

    • Multi-series timeline charts (commits, churn, active authors)
    • Risk factors bar chart with visual breakdown
    • Governance radar chart for commit quality assessment
    • Dark mode toggle with persistent preferences
    • One-click data export (JSON/CSV bundles)
    • Progressive table pagination for performance
    • Dataset toggles with live updates
    • Open Graph preview image generation
    • Accessibility enhancements (ARIA, keyboard navigation)
    • Security-first delivery (CSP, SRI, no unsafe-inline)
  • CLI Interface

    • Intuitive command-line tool with progress indicators
    • Comprehensive configuration options
    • Email redaction for privacy-sensitive audits
    • Heavy analysis mode with temporal coupling
    • Multiple output format support
    • Cross-platform shell scripts (PowerShell, Batch)
  • Programmatic API

    • TypeScript/JavaScript library for custom integrations
    • Streaming analysis for large repositories (100k+ commits)
    • Progress callbacks for UI integration
    • Memory optimization and buffer limits
    • Configurable chunking and caching
  • Enterprise Features

    • Input validation and security hardening
    • Safe Git operations with parameterized commands
    • Comprehensive error handling and logging
    • Configuration-driven analysis with .git-spark.json
    • CI/CD integration with JSON output
    • Performance testing and benchmarking

Technical

  • TypeScript 5.9+ with strict configuration
  • Jest testing framework with comprehensive coverage
  • ESLint + Prettier for code quality
  • Commander.js for CLI argument parsing
  • Chalk and Boxen for terminal output
  • Date-fns for date manipulation
  • Glob for file pattern matching
  • Node.js 18+ requirement

Documentation

  • Comprehensive README with examples
  • TypeScript type definitions
  • Configuration schema documentation
  • Best practices and troubleshooting guides
  • API reference and usage examples

Security

  • Input sanitization and validation
  • Path traversal protection
  • Buffer size limits for DoS prevention
  • Email redaction capabilities
  • Safe shell command execution
  • Security-focused HTML output (CSP headers)