What's New 🎉

v1.8.1

User feedback collection — Optional 1-10 rating with reason, what went well, and what went poorly
- Finalize prompt (Step 5) asks for optional feedback before archival, writes structured table to overview.md
- Collector parses ## User Feedback table from overview.md into RunMetrics.user_feedback
- Aggregator computes avg_user_rating and feedback_count per cohort
- CLI offers interactive feedback collection if none found during metrics collection
- Analysis and improvement prompts reference avg_user_rating metric target (≥ 7.0)
- UserFeedback type exported from public API
Pipe-safe feedback parsing — User text containing | characters is escaped on write and correctly unescaped on parse using negative lookbehind regex

Duplicate run files — Interactive feedback no longer creates a second run JSON; the original is deleted before re-collecting
Finalize step ordering — Feedback collection moved to Step 5 (before archival at Step 6), ensuring overview.md is written while still in the active spec directory

plan2code-metrics — New recursive self-improvement toolchain for plan2code contributors (plan2code-metrics/)
- Fully interactive menu-driven CLI — no flags, all inputs collected via prompts
- Collect metrics from completed project specs (plan, document, implement, finalize steps)
- Import run data from other projects for cross-project aggregation
- View metrics status with health indicators and generation-over-generation deltas
- Analyze weak steps via AI-powered diagnosis (Claude Code or GitHub Copilot CLI)
- Generate surgical improvement proposals with automatic validation (char count limits, edit verification)
- Review and apply proposals with interactive diff review
- Cohort-based aggregation groups runs by prompt generation (SHA fingerprint of prompt files)
- Supports both Claude Code and GitHub Copilot CLI as AI backends
- Standalone TypeScript package with tsup build (ESM), installed via npm link

plan2code-4--finalize.md — Added "Metrics Capture (Contributors)" note in Step 6 directing contributors to run plan2code-metrics after finalization
plan2code-loop index.ts — Added dim hint "run plan2code-metrics" after session summary