[SELF-SPEC-02] Spec Quality Heatmap — identify ambiguous specs

## SELF-GENERATED SPEC — Created by Foundry Retrospective System This spec was auto-generated from retrospective analysis identifying a gap: "No visibility into which specs produce chronic retries vs first-pass successes." ### User Story As a Foundry operator, I want to see a heatmap of spec quality scores so I can identify ambiguous specs that waste pipeline cycles on retries and rewrite them. ### Target File: `foundry-dashboard/src/components/spec-quality-heatmap.tsx` (NEW) Integration: Import in `foundry-dashboard/src/components/foundry-control-plane.tsx` ### Tech Stack (match existing codebase) - Next.js 16 + React 19 + Tailwind 4 - Server-side data via props (no client-side Supabase) - Dark mode, monospace, card-based layout ### Component Spec ```typescript interface SpecQualityHeatmapProps { specs: Array<{ spec_id: string; spec_title: string; total_tasks: number; first_pass_rate: number; // Tasks that passed on first attempt / total avg_retries: number; // Average retry_count across tasks avg_quality: number; // Average quality.overall quality_score: number; // 0-1 composite from _compute_spec_quality() }>; } ``` ### Visual Layout 1. **Grid of spec cards** — each card is a colored tile 2. **Color**: quality_score mapped to gradient (dark red 0.0 → yellow 0.5 → green 1.0) 3. **Card content**: spec_title (truncated), first_pass_rate %, avg_retries, total_tasks 4. **Hover/click**: expands to show full spec_id, quality breakdown 5. **Sort toggle**: by quality_score (worst first = find problems) or by total_tasks (most active first) 6. **Summary bar**: "12 specs scored — 3 need rewrite (score < 0.4)" ### Data Source Computed by `_compute_spec_quality()` in `foundry_retrospective.py`, passed via `fetchControlPlaneData()`. Query: SELECT spec_id, task metadata (retry_count), quality FROM foundry_tasks WHERE quality IS NOT NULL, GROUP BY spec_id. ### Acceptance Criteria (Grader Tests) - File `foundry-dashboard/src/components/spec-quality-heatmap.tsx` must exist - Must contain `quality_score` (at least 2 occurrences) - Must contain `first_pass_rate` (at least 1 occurrence) - Must contain `avg_retries` or `retry` (at least 1 occurrence) - Must contain `spec_id` (at least 1 occurrence) - Must contain color gradient logic (e.g., `bg-red` or `bg-green` or `hsl` or `rgb`) - Must contain `export` (component is exported) - Must NOT contain `createClient` (data via props only)