Skip to content

feat: add /gsd:stats command for project statistics#919

Open
ashanuoc wants to merge 1 commit intogsd-build:mainfrom
ashanuoc:feat/gsd-stats-command
Open

feat: add /gsd:stats command for project statistics#919
ashanuoc wants to merge 1 commit intogsd-build:mainfrom
ashanuoc:feat/gsd-stats-command

Conversation

@ashanuoc
Copy link

@ashanuoc ashanuoc commented Mar 3, 2026

Summary

Adds a new /gsd:stats command that provides comprehensive project statistics at a glance.

  • Phase progress: completed/total phases with per-phase breakdown
  • Plan execution: total plans, summaries completed, overall percentage
  • Requirements tracking: completed/total from REQUIREMENTS.md
  • Git metrics: commit count, first commit date
  • Timeline: last activity date from STATE.md
  • Two output formats: json (default, for programmatic use) and table (human-readable markdown)

Usage

gsd-tools stats          # JSON output
gsd-tools stats table     # Formatted markdown table

Files changed

  • commands/gsd/stats.md — Command definition
  • get-shit-done/workflows/stats.md — Workflow for Claude execution
  • get-shit-done/bin/lib/commands.cjscmdStats() implementation
  • get-shit-done/bin/gsd-tools.cjs — CLI route
  • tests/commands.test.cjs — 5 new tests

Test plan

  • Empty project returns valid JSON with zero counts
  • Phases, plans, and summaries counted correctly
  • Requirements parsed from REQUIREMENTS.md (checked vs unchecked)
  • Last activity read from STATE.md
  • Table format renders readable markdown output
  • All existing 535 tests continue to pass

🤖 Generated with Claude Code

Add a new `/gsd:stats` command that displays comprehensive project
statistics including phase progress, plan execution metrics, requirements
completion, git history, and timeline information.

- New command definition: commands/gsd/stats.md
- New workflow: get-shit-done/workflows/stats.md
- CLI handler: `gsd-tools stats [json|table]`
- Stats function in commands.cjs with JSON and table output formats
- 5 new tests covering empty project, phase/plan counting, requirements
  counting, last activity, and table format rendering

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@ashanuoc ashanuoc requested a review from glittercowboy as a code owner March 3, 2026 21:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant