Every published release of git-spark, newest first. Latest: v2.0.3.
Install with npm
ยท Source: CHANGELOG.md
--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 insteadgit-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 requiresgit-spark analyze now applies the global options (--days, --format, --output, --path, and the rest). It only read --repo, so the other options were silently ignored0% instead of NaN% when the analyzed window has no commits, in the CLI summary, health check, and console, HTML, and Markdown reportsgit-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 405docs/changelog.html), generated from CHANGELOG.md by scripts/generate-changelog-page.js during npm version and linked from the landing pagescripts/extract-release-notes.js)ora 10 (CLI spinners)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)--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 timestamppostinstall to prepare, which runs only for contributors installing inside the repository, never for users installing the package from npmengines, .nvmrc, the CI matrix (26.0.0 and 26.x), and the README badge are aligned to the new minimumGitAnalyzer and related modules for stronger typing of author and file metrics, safer regex validation, and improved error handling in the collectorsprintf-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/devspark-* command entry pointsNot 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.
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)GitExecutor.isShallowRepository() warns when a shallow clone may be missing commits needed for accurate period comparisonstypecheck:fast script using tsgo (TypeScript native preview) added as a non-blocking CI stepscripts/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 editsecurity.yml) with explicit contents: write / pull-requests: write permissions and persist-credentials: false on checkout--compare <branch> and --watch CLI flags and their unused ComparisonReport / ComparisonDifferences typeshomepage in package.json to https://git-spark.makeboldspark.com (was GitHub Pages URL)docs/index.html and docs/git-spark-report.htmlhtml.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 surfaceversion-fallback-coverage test suite exercising the package.json fallback branch in version-fallback.ts.devspark/ and .documentation/@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.10https://git-spark.makeboldspark.comog:url, og:image) in docs/index.htmlnpm 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.tsnpm install -g npm@latest step that caused MODULE_NOT_FOUND: promise-retry on every publish run; actions/setup-node@v6 already provides npm 11+test-tmp/cli-test-repo-* from the git index that was breaking git submodule update in the GitHub Pages deployer; added test-tmp/ to .gitignoreInternal Architecture Refactoring
Project Scope Cleanup
Interactive Configuration Wizard
git-spark init command for interactive project setup.git-spark.json configuration file with sensible defaults-r, --repo), non-interactive mode (-y, --yes)CLI Entry Point
bin/git-spark.js for proper global npm installation supportnpx git-spark and global installs work correctlyEnhanced Package Configuration
exports field for better ESM/bundler compatibilitymodule field pointing to ESM entry pointsideEffects: false for improved tree-shakingfunding field for sponsor informationpostversion script for automatic documentation version syncpack:test script for better local testing workflowtopDirectories) and HTML template (directoryBreakdown)HTML Report Meta Tag
> character in og:description meta tag causing validation errorVolume Trends Sparkline Visualization
flex: 1 property was overriding height stylesVolume Trends Layout
grid-column: 1 / -1Sparkline Implementation
<rect> elements<linearGradient> for visual enhancementy = chartHeight - height)src/output/html.ts - Complete sparkline rewrite using SVG (lines 2755-2825)test/html-exporter.test.ts - Changed test expectations from .spark-bar divs to <svg> elementsCritical Bug: First Commit Date Detection
getFirstCommitDate() method that was returning incorrect dates--max-count=1 flag that limited results before reversing--all --reverse to find true repository first commit across all branches--days=300 returned 0 commits despite recent activityDate Range Calculation
src/utils/git.ts - Complete rewrite of getFirstCommitDate() methodsrc/core/collector.ts - Added repository lifetime capping with timezone safetysrc/output/html.ts - Navigation reordering and date display improvementstest/git-utils.test.ts - Test expectations match new implementationCore Analytics Engine
Interactive HTML Reports
CLI Interface
Programmatic API
Enterprise Features
.git-spark.json