Pm Stats

Runtime Configuration (Step 0)

Read ops/derivation-manifest.md for vocabulary. Read ops/config.yaml for health metric sources.

EXECUTE NOW

Target: $ARGUMENTS

Parse immediately:

• If empty: full dashboard
• If "health": health trajectory only
• If "decisions": decision system statistics only
• If "issues": issue lifecycle statistics only
• If "velocity": sprint velocity statistics only

START NOW.

Philosophy

What gets measured gets managed. What stays unmeasured stays invisible.

The PM system tracks a project health trajectory (31/100 → target 65-70/100 across 5 sprints). But without quantitative statistics on the knowledge system itself — how many decisions exist, how many are stale, what percentage of issues get resolved — it is impossible to know if the PM system is working.

/pm-stats provides the dashboard. It is a read-only operation — no files are modified. It takes approximately 2-3 minutes to run across a large vault. The output should be reviewed at the start of sprint planning and at the end of retrospectives.

Statistics to Compute

1. Decision System Statistics

# Total decisions by type
echo "=== Decision Counts by Type ==="
for type in architectural tech-fact enforcement issue sprint-record tension; do
  count=$(rg "^type: $type" decisions/ --include="*.md" -l 2>/dev/null | wc -l)
  echo "  $type: $count"
done

# Total decisions by status
echo "=== Decision Counts by Status ==="
for status in active superseded invalidated open in-progress resolved speculative; do
  count=$(rg "^status: $status" decisions/ --include="*.md" -l 2>/dev/null | wc -l)
  echo "  $status: $count"
done

# Total decisions by meta_state
echo "=== Decision Counts by meta_state ==="
for state in current outdated speculative; do
  count=$(rg "^meta_state: $state" decisions/ --include="*.md" -l 2>/dev/null | wc -l)
  echo "  $state: $count"
done

2. Issue Lifecycle Statistics

# Open issues
open=$(rg "^type: issue" decisions/ --include="*.md" -l | xargs -I{} sh -c 'rg "^status: open" "{}" && echo "{}"' 2>/dev/null | grep "decisions/" | wc -l)
# Resolved issues
resolved=$(rg "^type: issue" decisions/ --include="*.md" -l | xargs -I{} sh -c 'rg "^status: resolved" "{}" && echo "{}"' 2>/dev/null | grep "decisions/" | wc -l)

echo "Issue resolution rate: $resolved / $((open + resolved))"

3. Sprint Statistics

# Number of sprint records
sprint_count=$(rg "^type: sprint-record" decisions/ --include="*.md" -l 2>/dev/null | wc -l)

# Health trajectory — extract health_before and health_after from sprint records
rg "^health_before:|^health_after:" decisions/ --include="*.md" -h | sort

4. Enforcement Compliance Statistics

# Count sprint records with validation enforcement noted
rg "Was validation block embedded" decisions/ --include="*.md" -A 1 | rg "YES|NO"

5. Observation and Tension Backlog

# Observations by status
for status in pending promoted implemented archived; do
  count=$(rg "^status: $status" ops/observations/ --include="*.md" -l 2>/dev/null | wc -l)
  echo "  observations/$status: $count"
done

# Tensions by status
for status in pending resolved dissolved escalated; do
  count=$(rg "^status: $status" ops/tensions/ --include="*.md" -l 2>/dev/null | wc -l)
  echo "  tensions/$status: $count"
done

6. Vault Coverage

# Decisions per register
for reg in decisions/*-register.md decisions/index.md; do
  [ -f "$reg" ] && count=$(rg "\[\[" "$reg" 2>/dev/null | wc -l) && echo "$(basename $reg): $count refs"
done

# Orphan decisions (not referenced in any register)
total=$(ls decisions/*.md 2>/dev/null | grep -v "\-register\|index" | wc -l)

Output Format

## PM System Dashboard — YYYY-MM-DD

### Decision System
Total decisions: N
By type:
  architectural: N
  tech-fact: N
  enforcement: N
  issue: N (open: N, resolved: N, in-progress: N)
  sprint-record: N
  tension: N

By meta_state:
  current: N (N%)
  outdated: N (N%)
  speculative: N (N%)

### Issue Lifecycle
Total issues tracked: N
  Open: N
  In-progress: N
  Resolved: N
Resolution rate: N%

### Sprint Velocity
Sprints documented: N
Health trajectory:
  Sprint 1: N → N (delta: +N)
  Sprint 2: N → N (delta: +N)
  ...
Current estimated health: N/100
Target: 65-70/100
Gap: N points

### Enforcement Compliance
Sprints with validation block: N/N (N%)
Sprints where deliverables rejected: N

### Observation/Tension Backlog
Observations: N pending / N total
Tensions: N pending / N total
Backlog status: [CLEAR / MODERATE / NEEDS RETROSPECT]

### Vault Coverage
Decision registers: N
  [[architecture-register]]: N decisions
  [[qftest-register]]: N decisions
  [[sprint-register]]: N decisions
  [[issue-register]]: N decisions
  [[enforcement-register]]: N decisions
Orphan decisions: N [WARN if > 0]

### System Health Assessment
[GREEN / YELLOW / RED] — [one sentence explanation]
Recommended action: [/pm-command]