status

Draft Status

Display a comprehensive overview of project progress.

Red Flags - STOP if you're

• Reporting status without actually reading the files
• Making up progress percentages
• Skipping blocked items in the report
• Not checking each active track's actual state
• Summarizing without evidence from the files

Always read before reporting.

---

Gather Data

1. Read draft/tracks.md for track list
2. For each active track, read:
   • draft/tracks/<id>/metadata.json for stats. If metadata.json is malformed or unreadable, display (metadata unavailable) for that track's statistics instead of failing.
   • draft/tracks/<id>/plan.md for task status
   • draft/tracks/<id>/architecture.md for module status (if exists)
   • metadata.json:scope_includes / scope_excludes for the track's scope footprint. Surface these in the status output so reviewers can spot overlap at a glance. Conflicts are detected by scripts/tools/check-scope-conflicts.sh (see core/shared/template-contract.md).
3. Check for project-wide draft/.ai-context.md (or legacy draft/architecture.md) for module status
4. Detect orphaned tracks:
   • Scan draft/tracks/ for all directories
   • For each directory, check if it has metadata.json
   • Cross-reference with draft/tracks.md entries
   • If directory has metadata.json but NOT in tracks.md → orphaned track
   • Collect list of orphaned track IDs for warning section

Optional: report rollup & freshness signals

If parse-reports.sh and freshness-check.sh are available, gather structured signals to enrich the status output (severity counts per track, stale draft/ docs). Resolve via the canonical tool resolver (see core/shared/tool-resolver.md):

DRAFT_TOOLS="${DRAFT_PLUGIN_ROOT:-$(cat ~/.cache/draft/plugin-root 2>/dev/null)}/scripts/tools"
[ -d "$DRAFT_TOOLS" ] || DRAFT_TOOLS="$(ls -d ~/.claude/plugins/cache/*/draft/*/scripts/tools 2>/dev/null | sort -V | tail -1)"
[ -d "$DRAFT_TOOLS" ] || DRAFT_TOOLS="$(ls -d ~/.claude/plugins/marketplaces/*draft*/scripts/tools 2>/dev/null | tail -1)"
[ -d "$DRAFT_TOOLS" ] || DRAFT_TOOLS="$PWD/scripts/tools"

# Per-track report severity rollup (bughunt, review, tech-debt, etc.):
[ -x "$DRAFT_TOOLS/parse-reports.sh" ] && \
  bash "$DRAFT_TOOLS/parse-reports.sh" --root draft/

# Stale draft/ docs (sha256 drift since last index):
[ -x "$DRAFT_TOOLS/freshness-check.sh" ] && [ -f draft/.state/freshness.json ] && \
  bash "$DRAFT_TOOLS/freshness-check.sh" --state draft/.state/freshness.json