history

/crucible:history — Review History

List past Crucible reviews and offer to show one in full. Reviews are stored at .review/reports/<review_id>.md in the project root.

Steps

1. List reports. Find every file under .review/reports/ matching the pattern *.md. If none exist, print:

   No past reviews found. Run /crucible to create one.
   

   and exit.

2. Parse metadata from each report. For each file, extract:

   • review_id — from the filename (strip .md).
   • final_score — from the line beginning with **Score:** (or fall back to Score: if formatting differs).
   • final_verdict — from the line beginning with **Verdict:**.
   • scope_description — from the H1 line # Crucible Review — <description>.
   • completed_at — from the metadata line _Review ID: ... · Generated: <timestamp>_.

   If parsing fails on any field, fall back to ? for that field.

3. Sort reports newest-first by completed_at if available, else by filename (which encodes the timestamp prefix).

4. Print a table. Use fixed-width columns. Truncate long descriptions to 40 chars with ….

   #   Review ID                          Score  Verdict                Scope
   ─────────────────────────────────────────────────────────────────────────────────
   1   2026-05-10-1430-auth-refactor      7.1    conditional_approval   auth module rewrite
   2   2026-05-09-1620-api-rewrite        8.4    approved               /api/v2 endpoints
   ...
   

5. Prompt for selection.

   Show full report for which # (or `n` to exit)?
   

   • If the user enters a number that maps to a row, print the full contents of that report file.
   • If the user enters n, no, exit, quit, or empty, exit silently.
   • If the input is invalid, print Not a valid selection. and exit.

6. For partial reports. Files matching *-PARTIAL.md (incomplete runs) appear in the listing with a ⚠️ prefix in the Verdict column to make it clear they don't represent a complete pipeline run.

Edge cases

• No .review/ directory. Treat as no past reviews.
• A report file exists but has no parseable metadata. Show it with ? placeholders. Don't crash.
• Many reports (≥ 50). Limit the table to the most recent 25 entries. Print a footer: ... and <N> older reviews. Browse .review/reports/ directly to see all.
• The user pipes input or runs in a non-interactive shell. If stdin is not a TTY, skip the selection prompt and only print the table.

Notes

This skill is read-only. It does not modify any files, does not invoke any subagents, and does not consume model budget. It's purely a navigator over the user's review history.