project-stats

What problem does it solve?

Projects and repositories lack a fast, consistent way to measure codebase size, language composition, git activity, test coverage proxies, dependencies, and infrastructure signals and to compare those metrics over time for observable trends and health checks.

Core Features & Use Cases

• Automated collection: Runs a portable shell collector to produce a structured JSON snapshot of a repository including LOC, file counts, test files, and dependency counts.
• Git & activity insights: Reports commit totals, recent velocity, contributors, branches, tags, commit-type breakdowns and AI-collaboration metrics.
• Monorepo and framework detection: Detects common monorepo tools, workspace counts, frameworks, Dockerfiles, and basic i18n statistics for comparison across releases.
• Comparative reporting: Finds the most recent previous report and computes deltas, presenting a formatted markdown report with trend indicators and interpretation notes.

Quick Start

Run the bundled collection script from the repository root to generate a JSON project-stats report and save it under .claude/reports/.