gsd-antigravity-kit 1.22.6 → 1.24.0

package/.agent/skills/gsd/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: gsd
-version: 1.22.4
+version: 1.24.0
 description: "Antigravity GSD (Get Stuff Done) - A spec-driven hierarchical planning and execution system. Triggers on project planning, phase management, and GSD slash commands."
 ---
 
@@ -25,6 +25,7 @@ This skill should be used when:
 - `gsd:add-tests`
 - `gsd:add-todo`
 - `gsd:audit-milestone`
+- `gsd:autonomous`
 - `gsd:check-todos`
 - `gsd:cleanup`
 - `gsd:complete-milestone`
@@ -51,6 +52,9 @@ This skill should be used when:
 - `gsd:resume-work`
 - `gsd:set-profile`
 - `gsd:settings`
+- `gsd:stats`
+- `gsd:ui-phase`
+- `gsd:ui-review`
 - `gsd:update`
 - `gsd:validate-phase`
 - `gsd:verify-work`
@@ -70,11 +74,12 @@ The following slash commands are available in this skill. Use them to drive the
 - **[`gsd:add-tests`](references/commands/add-tests.md)**: Generate tests for a completed phase based on UAT criteria and implementation
 - **[`gsd:add-todo`](references/commands/add-todo.md)**: Capture idea or task as todo from current conversation context
 - **[`gsd:audit-milestone`](references/commands/audit-milestone.md)**: Audit milestone completion against original intent before archiving
+- **[`gsd:autonomous`](references/commands/autonomous.md)**: Run all remaining phases autonomously — discuss→plan→execute per phase
 - **[`gsd:check-todos`](references/commands/check-todos.md)**: List pending todos and select one to work on
 - **[`gsd:cleanup`](references/commands/cleanup.md)**: Archive accumulated phase directories from completed milestones
 - **[`gsd:complete-milestone`](references/commands/complete-milestone.md)**: Archive completed milestone and prepare for next version
 - **[`gsd:debug`](references/commands/debug.md)**: Systematic debugging with persistent state across context resets
-- **[`gsd:discuss-phase`](references/commands/discuss-phase.md)**: Gather phase context through adaptive questioning before planning
+- **[`gsd:discuss-phase`](references/commands/discuss-phase.md)**: Gather phase context through adaptive questioning before planning. Use --auto to skip interactive questions (Antigravity picks recommended defaults).
 - **[`gsd:execute-phase`](references/commands/execute-phase.md)**: Execute all plans in a phase with wave-based parallelization
 - **[`gsd:gsd-tools`](references/commands/gsd-tools.md)**: Direct access to GSD internal CLI tools for atomic operations (state, roadmap, phase, config, etc.)
 - **[`gsd:health`](references/commands/health.md)**: Diagnose planning directory health and optionally repair issues
@@ -94,8 +99,11 @@ The following slash commands are available in this skill. Use them to drive the
 - **[`gsd:remove-phase`](references/commands/remove-phase.md)**: Remove a future phase from roadmap and renumber subsequent phases
 - **[`gsd:research-phase`](references/commands/research-phase.md)**: Research how to implement a phase (standalone - usually use /gsd:plan-phase instead)
 - **[`gsd:resume-work`](references/commands/resume-work.md)**: Resume work from previous session with full context restoration
-- **[`gsd:set-profile`](references/commands/set-profile.md)**: Switch model profile for GSD agents (quality/balanced/budget)
+- **[`gsd:set-profile`](references/commands/set-profile.md)**: Switch model profile for GSD agents (quality/balanced/budget/inherit)
 - **[`gsd:settings`](references/commands/settings.md)**: Configure GSD workflow toggles and model profile
+- **[`gsd:stats`](references/commands/stats.md)**: Display project statistics — phases, plans, requirements, git metrics, and timeline
+- **[`gsd:ui-phase`](references/commands/ui-phase.md)**: Generate UI design contract (UI-SPEC.md) for frontend phases
+- **[`gsd:ui-review`](references/commands/ui-review.md)**: Retroactive 6-pillar visual audit of implemented frontend code
 - **[`gsd:update`](references/commands/update.md)**: Update GSD to latest version with changelog display
 - **[`gsd:validate-phase`](references/commands/validate-phase.md)**: Retroactively audit and fill Nyquist validation gaps for a completed phase
 - **[`gsd:verify-work`](references/commands/verify-work.md)**: Validate built features through conversational UAT
@@ -133,4 +141,4 @@ General documentation on the GSD philosophy, usage patterns, and configuration.
 5.  **CLI Invocation**: `gsd-tools` is **NOT** a global command. Always invoke it with the full node path: `node .agent/skills/gsd/bin/gsd-tools.cjs <command> [args]`. Never run `gsd-tools` bare.
 
 ---
-*Generated by gsd-converter on 2026-03-13*
+*Generated by gsd-converter on 2026-03-15*

package/.agent/skills/gsd/assets/templates/UI-SPEC.md

@@ -0,0 +1,100 @@
+---
+phase: {N}
+slug: {phase-slug}
+status: draft
+shadcn_initialized: false
+preset: none
+created: {date}
+---
+
+# Phase {N} — UI Design Contract
+
+> Visual and interaction contract for frontend phases. Generated by gsd-ui-researcher, verified by gsd-ui-checker.
+
+---
+
+## Design System
+
+| Property | Value |
+|----------|-------|
+| Tool | {shadcn / none} |
+| Preset | {preset string or "not applicable"} |
+| Component library | {radix / base-ui / none} |
+| Icon library | {library} |
+| Font | {font} |
+
+---
+
+## Spacing Scale
+
+Declared values (must be multiples of 4):
+
+| Token | Value | Usage |
+|-------|-------|-------|
+| xs | 4px | Icon gaps, inline padding |
+| sm | 8px | Compact element spacing |
+| md | 16px | Default element spacing |
+| lg | 24px | Section padding |
+| xl | 32px | Layout gaps |
+| 2xl | 48px | Major section breaks |
+| 3xl | 64px | Page-level spacing |
+
+Exceptions: {list any, or "none"}
+
+---
+
+## Typography
+
+| Role | Size | Weight | Line Height |
+|------|------|--------|-------------|
+| Body | {px} | {weight} | {ratio} |
+| Label | {px} | {weight} | {ratio} |
+| Heading | {px} | {weight} | {ratio} |
+| Display | {px} | {weight} | {ratio} |
+
+---
+
+## Color
+
+| Role | Value | Usage |
+|------|-------|-------|
+| Dominant (60%) | {hex} | Background, surfaces |
+| Secondary (30%) | {hex} | Cards, sidebar, nav |
+| Accent (10%) | {hex} | {list specific elements only} |
+| Destructive | {hex} | Destructive actions only |
+
+Accent reserved for: {explicit list — never "all interactive elements"}
+
+---
+
+## Copywriting Contract
+
+| Element | Copy |
+|---------|------|
+| Primary CTA | {specific verb + noun} |
+| Empty state heading | {copy} |
+| Empty state body | {copy + next step} |
+| Error state | {problem + solution path} |
+| Destructive confirmation | {action name}: {confirmation copy} |
+
+---
+
+## Registry Safety
+
+| Registry | Blocks Used | Safety Gate |
+|----------|-------------|-------------|
+| shadcn official | {list} | not required |
+| {third-party name} | {list} | shadcn view + diff required |
+
+---
+
+## Checker Sign-Off
+
+- [ ] Dimension 1 Copywriting: PASS
+- [ ] Dimension 2 Visuals: PASS
+- [ ] Dimension 3 Color: PASS
+- [ ] Dimension 4 Typography: PASS
+- [ ] Dimension 5 Spacing: PASS
+- [ ] Dimension 6 Registry Safety: PASS
+
+**Approval:** {pending / approved YYYY-MM-DD}

package/.agent/skills/gsd/assets/templates/codebase/structure.md

@@ -216,7 +216,7 @@ get-shit-done/
 
 **New Workflow:**
 - Implementation: `get-shit-done/workflows/{name}.md`
-- Usage: Reference from command with `@references/workflows/{name}.md`
+- Usage: Reference from command with `@C:/projects/GSD-Antigravityreferences/workflows/{name}.md`
 
 **New Reference Document:**
 - Implementation: `get-shit-done/references/{name}.md`
@@ -229,12 +229,12 @@ get-shit-done/
 ## Special Directories
 
 **get-shit-done/**
-- Purpose: Resources installed to ./.antigravity/
+- Purpose: Resources installed to C:/projects/GSD-Antigravity/.antigravity/
 - Source: Copied by bin/install.js during installation
 - Committed: Yes (source of truth)
 
 **commands/**
-- Purpose: Slash commands installed to ./.antigravity/commands/
+- Purpose: Slash commands installed to C:/projects/GSD-Antigravity/.antigravity/commands/
 - Source: Copied by bin/install.js during installation
 - Committed: Yes (source of truth)
 

package/.agent/skills/gsd/assets/templates/context.md

@@ -54,6 +54,24 @@ Template for `.planning/phases/XX-name/{phase_num}-CONTEXT.md` - captures implem
 
 </specifics>
 
+<canonical_refs>
+## Canonical References
+
+**Downstream agents MUST read these before planning or implementing.**
+
+[List every spec, ADR, feature doc, or design doc that defines requirements or constraints for this phase. Use full relative paths so agents can read them directly. Group by topic area when the phase has multiple concerns.]
+
+### [Topic area 1]
+- `path/to/spec-or-adr.md` — [What this doc decides/defines that's relevant]
+- `path/to/doc.md` §N — [Specific section and what it covers]
+
+### [Topic area 2]
+- `path/to/feature-doc.md` — [What capability this defines]
+
+[If the project has no external specs: "No external specs — requirements are fully captured in decisions above"]
+
+</canonical_refs>
+
 <code_context>
 ## Existing Code Insights
 
@@ -124,6 +142,18 @@ Display posts from followed users in a scrollable feed. Users can view posts and
 
 </decisions>
 
+<canonical_refs>
+## Canonical References
+
+### Feed display
+- `docs/features/social-feed.md` — Feed requirements, post card fields, engagement display rules
+- `docs/decisions/adr-012-infinite-scroll.md` — Scroll strategy decision, virtualization requirements
+
+### Empty states
+- `docs/design/empty-states.md` — Empty state patterns, illustration guidelines
+
+</canonical_refs>
+
 <specifics>
 ## Specific Ideas
 
@@ -186,6 +216,15 @@ CLI command to backup database to local file or S3. Supports full and incrementa
 
 </decisions>
 
+<canonical_refs>
+## Canonical References
+
+### Backup CLI
+- `docs/features/backup-restore.md` — Backup requirements, supported backends, encryption spec
+- `docs/decisions/adr-007-cli-conventions.md` — Flag naming, exit codes, output format standards
+
+</canonical_refs>
+
 <specifics>
 ## Specific Ideas
 
@@ -248,6 +287,15 @@ Organize existing photo library into structured folders. Handle duplicates and a
 
 </decisions>
 
+<canonical_refs>
+## Canonical References
+
+### Organization rules
+- `docs/features/photo-organization.md` — Grouping rules, duplicate policy, naming spec
+- `docs/decisions/adr-003-exif-handling.md` — EXIF extraction strategy, fallback for missing metadata
+
+</canonical_refs>
+
 <specifics>
 ## Specific Ideas
 
@@ -291,7 +339,14 @@ The output should answer: "What does the researcher need to investigate? What ch
 
 **After creation:**
 - File lives in phase directory: `.planning/phases/XX-name/{phase_num}-CONTEXT.md`
-- `gsd-phase-researcher` uses decisions to focus investigation
-- `gsd-planner` uses decisions + research to create executable tasks
+- `gsd-phase-researcher` uses decisions to focus investigation AND reads canonical_refs to know WHAT docs to study
+- `gsd-planner` uses decisions + research to create executable tasks AND reads canonical_refs to verify alignment
 - Downstream agents should NOT need to ask the user again about captured decisions
+
+**CRITICAL — Canonical references:**
+- The `<canonical_refs>` section is MANDATORY. Every CONTEXT.md must have one.
+- If your project has external specs, ADRs, or design docs, list them with full relative paths grouped by topic
+- If ROADMAP.md lists `Canonical refs:` per phase, extract and expand those
+- Inline mentions like "see ADR-019" scattered in decisions are useless to downstream agents — they need full paths and section references in a dedicated section they can find
+- If no external specs exist, say so explicitly — don't silently omit the section
 </guidelines>

package/.agent/skills/gsd/assets/templates/copilot-instructions.md

@@ -0,0 +1,7 @@
+# Instructions for GSD
+
+- Use the get-shit-done skill when the user asks for GSD or uses a `gsd-*` command.
+- Treat `/gsd-...` or `gsd-...` as command invocations and load the matching file from `.github/skills/gsd-*`.
+- When a command says to spawn a subagent, prefer a matching custom agent from `.github/agents`.
+- Do not apply GSD workflows unless the user explicitly asks for them.
+- After completing any `gsd-*` command (or any deliverable it triggers: feature, bug fix, tests, docs, etc.), ALWAYS: (1) offer the user the next step by prompting via `ask_user`; repeat this feedback loop until the user explicitly indicates they are done.

package/.agent/skills/gsd/assets/templates/phase-prompt.md

@@ -38,10 +38,10 @@ Output: [What artifacts will be created]
 </objective>
 
 <execution_context>
-@references/workflows/execute-plan.md
-@assets/templates/summary.md
+@C:/projects/GSD-Antigravityreferences/workflows/execute-plan.md
+@C:/projects/GSD-Antigravityassets/templates/summary.md
 [If plan contains checkpoint tasks (type="checkpoint:*"), add:]
-@references/docs/checkpoints.md
+@C:/projects/GSD-Antigravity/.antigravity/get-shit-done/references/checkpoints.md
 </execution_context>
 
 <context>
@@ -63,21 +63,29 @@ Output: [What artifacts will be created]
 <task type="auto">
   <name>Task 1: [Action-oriented name]</name>
   <files>path/to/file.ext, another/file.ext</files>
-  <action>[Specific implementation - what to do, how to do it, what to avoid and WHY]</action>
+  <read_first>path/to/reference.ext, path/to/source-of-truth.ext</read_first>
+  <action>[Specific implementation - what to do, how to do it, what to avoid and WHY. Include CONCRETE values: exact identifiers, parameters, expected outputs, file paths, command arguments. Never say "align X with Y" without specifying the exact target state.]</action>
   <verify>[Command or check to prove it worked]</verify>
+  <acceptance_criteria>
+    - [Grep-verifiable condition: "file.ext contains 'exact string'"]
+    - [Measurable condition: "output.ext uses 'expected-value', NOT 'wrong-value'"]
+  </acceptance_criteria>
   <done>[Measurable acceptance criteria]</done>
 </task>
 
 <task type="auto">
   <name>Task 2: [Action-oriented name]</name>
   <files>path/to/file.ext</files>
-  <action>[Specific implementation]</action>
+  <read_first>path/to/reference.ext</read_first>
+  <action>[Specific implementation with concrete values]</action>
   <verify>[Command or check]</verify>
+  <acceptance_criteria>
+    - [Grep-verifiable condition]
+  </acceptance_criteria>
   <done>[Acceptance criteria]</done>
 </task>
 
-<!-- For checkpoint task examples and patterns, see @references/docs/checkpoints.md -->
-<!-- Key rule: Antigravity starts dev server BEFORE human-verify checkpoints. User only visits URLs. -->
+<!-- For checkpoint task examples and patterns, see @C:/projects/GSD-Antigravity/.antigravity/get-shit-done/references/checkpoints.md -->
 
 <task type="checkpoint:decision" gate="blocking">
   <decision>[What needs deciding]</decision>
@@ -270,7 +278,7 @@ TDD features get dedicated plans with `type: tdd`.
 → Yes: Create a TDD plan
 → No: Standard task in standard plan
 
-See `./.antigravity/get-shit-done/references/tdd.md` for TDD plan structure.
+See `C:/projects/GSD-Antigravity/.antigravity/get-shit-done/references/tdd.md` for TDD plan structure.
 
 ---
 
@@ -374,9 +382,9 @@ Output: Working dashboard component.
 </objective>
 
 <execution_context>
-@references/workflows/execute-plan.md
-@assets/templates/summary.md
-@references/docs/checkpoints.md
+@C:/projects/GSD-Antigravityreferences/workflows/execute-plan.md
+@C:/projects/GSD-Antigravityassets/templates/summary.md
+@C:/projects/GSD-Antigravity/.antigravity/get-shit-done/references/checkpoints.md
 </execution_context>
 
 <context>
@@ -456,6 +464,39 @@ files_modified: [...]
 </task>
 ```
 
+**Bad: Missing read_first (executor modifies files it hasn't read)**
+```xml
+<task type="auto">
+  <name>Update database config</name>
+  <files>src/config/database.ts</files>
+  <!-- No read_first! Executor doesn't know current state or conventions -->
+  <action>Update the database config to match production settings</action>
+</task>
+```
+
+**Bad: Vague acceptance criteria (not verifiable)**
+```xml
+<acceptance_criteria>
+  - Config is properly set up
+  - Database connection works correctly
+</acceptance_criteria>
+```
+
+**Good: Concrete with read_first + verifiable criteria**
+```xml
+<task type="auto">
+  <name>Update database config for connection pooling</name>
+  <files>src/config/database.ts</files>
+  <read_first>src/config/database.ts, .env.example, docker-compose.yml</read_first>
+  <action>Add pool configuration: min=2, max=20, idleTimeoutMs=30000. Add SSL config: rejectUnauthorized=true when NODE_ENV=production. Add .env.example entry: DATABASE_POOL_MAX=20.</action>
+  <acceptance_criteria>
+    - database.ts contains "max: 20" and "idleTimeoutMillis: 30000"
+    - database.ts contains SSL conditional on NODE_ENV
+    - .env.example contains DATABASE_POOL_MAX
+  </acceptance_criteria>
+</task>
+```
+
 ---
 
 ## Guidelines
@@ -499,7 +540,7 @@ user_setup:
 
 **Result:** Execute-plan generates `{phase}-USER-SETUP.md` with checklist for the user.
 
-See `assets/templates/user-setup.md` for full schema and examples
+See `C:/projects/GSD-Antigravityassets/templates/user-setup.md` for full schema and examples
 
 ---
 
@@ -566,4 +607,4 @@ Task completion ≠ Goal achievement. A task "create chat component" can complet
 5. Gaps found → fix plans created → execute → re-verify
 6. All must_haves pass → phase complete
 
-See `references/workflows/verify-phase.md` for verification logic.
+See `C:/projects/GSD-Antigravityreferences/workflows/verify-phase.md` for verification logic.

package/.agent/skills/gsd/bin/gsd-tools.cjs

@@ -294,6 +294,11 @@ async function main() {
     break;
   }
 
+  case "config-set-model-profile": {
+    config.cmdConfigSetModelProfile(cwd, args[1], raw);
+    break;
+  }
+
   case 'config-get': {
     config.cmdConfigGet(cwd, args[1], raw);
     break;
@@ -405,6 +410,12 @@ async function main() {
     break;
   }
 
+  case 'stats': {
+    const subcommand = args[1] || 'json';
+    commands.cmdStats(cwd, subcommand, raw);
+    break;
+  }
+
   case 'todo': {
     const subcommand = args[1];
     if (subcommand === 'complete') {

package/.agent/skills/gsd/bin/help-manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.22.4",
+  "version": "1.24.0",
   "commands": {
     "add-phase": {
       "description": "Add phase to end of current milestone in roadmap"
@@ -13,6 +13,9 @@
     "audit-milestone": {
       "description": "Audit milestone completion against original intent before archiving"
     },
+    "autonomous": {
+      "description": "Run all remaining phases autonomously \u2014 discuss\u2192plan\u2192execute per phase"
+    },
     "check-todos": {
       "description": "List pending todos and select one to work on"
     },
@@ -26,7 +29,7 @@
       "description": "Systematic debugging with persistent state across context resets"
     },
     "discuss-phase": {
-      "description": "Gather phase context through adaptive questioning before planning"
+      "description": "Gather phase context through adaptive questioning before planning. Use --auto to skip interactive questions (Antigravity picks recommended defaults)."
     },
     "execute-phase": {
       "description": "Execute all plans in a phase with wave-based parallelization"
@@ -87,11 +90,20 @@
       "description": "Resume work from previous session with full context restoration"
     },
     "set-profile": {
-      "description": "Switch model profile for GSD agents (quality/balanced/budget)"
+      "description": "Switch model profile for GSD agents (quality/balanced/budget/inherit)"
     },
     "settings": {
       "description": "Configure GSD workflow toggles and model profile"
     },
+    "stats": {
+      "description": "Display project statistics \u2014 phases, plans, requirements, git metrics, and timeline"
+    },
+    "ui-phase": {
+      "description": "Generate UI design contract (UI-SPEC.md) for frontend phases"
+    },
+    "ui-review": {
+      "description": "Retroactive 6-pillar visual audit of implemented frontend code"
+    },
     "update": {
       "description": "Update GSD to latest version with changelog display"
     },

package/.agent/skills/gsd/bin/lib/commands.cjs

@@ -4,8 +4,9 @@
 const fs = require('fs');
 const path = require('path');
 const { execSync } = require('child_process');
-const { safeReadFile, loadConfig, isGitIgnored, execGit, normalizePhaseName, comparePhaseNum, getArchivedPhaseDirs, generateSlugInternal, getMilestoneInfo, resolveModelInternal, MODEL_PROFILES, toPosixPath, output, error, findPhaseInternal } = require('./core.cjs');
+const { safeReadFile, loadConfig, isGitIgnored, execGit, normalizePhaseName, comparePhaseNum, getArchivedPhaseDirs, generateSlugInternal, getMilestoneInfo, resolveModelInternal, toPosixPath, output, error, findPhaseInternal } = require('./core.cjs');
 const { extractFrontmatter } = require('./frontmatter.cjs');
+const { MODEL_PROFILES } = require('./model-profiles.cjs');
 
 function cmdGenerateSlug(text, raw) {
   if (!text) {
@@ -532,6 +533,123 @@ function cmdScaffold(cwd, type, options, raw) {
   output({ created: true, path: relPath }, raw, relPath);
 }
 
+function cmdStats(cwd, format, raw) {
+  const phasesDir = path.join(cwd, '.planning', 'phases');
+  const reqPath = path.join(cwd, '.planning', 'REQUIREMENTS.md');
+  const statePath = path.join(cwd, '.planning', 'STATE.md');
+  const milestone = getMilestoneInfo(cwd);
+
+  // Phase & plan stats (reuse progress pattern)
+  const phases = [];
+  let totalPlans = 0;
+  let totalSummaries = 0;
+
+  try {
+  const entries = fs.readdirSync(phasesDir, { withFileTypes: true });
+  const dirs = entries.filter(e => e.isDirectory()).map(e => e.name).sort((a, b) => comparePhaseNum(a, b));
+
+  for (const dir of dirs) {
+    const dm = dir.match(/^(\d+(?:\.\d+)*)-?(.*)/);
+    const phaseNum = dm ? dm[1] : dir;
+    const phaseName = dm && dm[2] ? dm[2].replace(/-/g, ' ') : '';
+    const phaseFiles = fs.readdirSync(path.join(phasesDir, dir));
+    const plans = phaseFiles.filter(f => f.endsWith('-PLAN.md') || f === 'PLAN.md').length;
+    const summaries = phaseFiles.filter(f => f.endsWith('-SUMMARY.md') || f === 'SUMMARY.md').length;
+
+    totalPlans += plans;
+    totalSummaries += summaries;
+
+    let status;
+    if (plans === 0) status = 'Pending';
+    else if (summaries >= plans) status = 'Complete';
+    else if (summaries > 0) status = 'In Progress';
+    else status = 'Planned';
+
+    phases.push({ number: phaseNum, name: phaseName, plans, summaries, status });
+  }
+  } catch {}
+
+  const percent = totalPlans > 0 ? Math.min(100, Math.round((totalSummaries / totalPlans) * 100)) : 0;
+
+  // Requirements stats
+  let requirementsTotal = 0;
+  let requirementsComplete = 0;
+  try {
+  if (fs.existsSync(reqPath)) {
+    const reqContent = fs.readFileSync(reqPath, 'utf-8');
+    const checked = reqContent.match(/^- \[x\] \*\*/gm);
+    const unchecked = reqContent.match(/^- \[ \] \*\*/gm);
+    requirementsComplete = checked ? checked.length : 0;
+    requirementsTotal = requirementsComplete + (unchecked ? unchecked.length : 0);
+  }
+  } catch {}
+
+  // Last activity from STATE.md
+  let lastActivity = null;
+  try {
+  if (fs.existsSync(statePath)) {
+    const stateContent = fs.readFileSync(statePath, 'utf-8');
+    const activityMatch = stateContent.match(/\*\*Last Activity:\*\*\s*(.+)/);
+    if (activityMatch) lastActivity = activityMatch[1].trim();
+  }
+  } catch {}
+
+  // Git stats
+  let gitCommits = 0;
+  let gitFirstCommitDate = null;
+  try {
+  const commitCount = execGit(cwd, ['rev-list', '--count', 'HEAD']);
+  gitCommits = parseInt(commitCount.trim(), 10) || 0;
+  const firstDate = execGit(cwd, ['log', '--reverse', '--format=%as', '--max-count=1']);
+  gitFirstCommitDate = firstDate.trim() || null;
+  } catch {}
+
+  const completedPhases = phases.filter(p => p.status === 'Complete').length;
+
+  const result = {
+  milestone_version: milestone.version,
+  milestone_name: milestone.name,
+  phases,
+  phases_completed: completedPhases,
+  phases_total: phases.length,
+  total_plans: totalPlans,
+  total_summaries: totalSummaries,
+  percent,
+  requirements_total: requirementsTotal,
+  requirements_complete: requirementsComplete,
+  git_commits: gitCommits,
+  git_first_commit_date: gitFirstCommitDate,
+  last_activity: lastActivity,
+  };
+
+  if (format === 'table') {
+  const barWidth = 10;
+  const filled = Math.round((percent / 100) * barWidth);
+  const bar = '\u2588'.repeat(filled) + '\u2591'.repeat(barWidth - filled);
+  let out = `# ${milestone.version} ${milestone.name} \u2014 Statistics\n\n`;
+  out += `**Progress:** [${bar}] ${totalSummaries}/${totalPlans} plans (${percent}%)\n`;
+  out += `**Phases:** ${completedPhases}/${phases.length} complete\n`;
+  if (requirementsTotal > 0) {
+    out += `**Requirements:** ${requirementsComplete}/${requirementsTotal} complete\n`;
+  }
+  out += '\n';
+  out += `| Phase | Name | Plans | Completed | Status |\n`;
+  out += `|-------|------|-------|-----------|--------|\n`;
+  for (const p of phases) {
+    out += `| ${p.number} | ${p.name} | ${p.plans} | ${p.summaries} | ${p.status} |\n`;
+  }
+  if (gitCommits > 0) {
+    out += `\n**Git:** ${gitCommits} commits`;
+    if (gitFirstCommitDate) out += ` (since ${gitFirstCommitDate})`;
+    out += '\n';
+  }
+  if (lastActivity) out += `**Last activity:** ${lastActivity}\n`;
+  output({ rendered: out }, raw, out);
+  } else {
+  output(result, raw);
+  }
+}
+
 module.exports = {
   cmdGenerateSlug,
   cmdCurrentTimestamp,
@@ -545,4 +663,5 @@ module.exports = {
   cmdProgressRender,
   cmdTodoComplete,
   cmdScaffold,
+  cmdStats,
 };