WIP almost done with track planning

conductor/tracks/tier4_auto_patching_20260306/spec.md

@@ -1,27 +1,22 @@
-# Track Specification: Advanced Tier 4 QA Auto-Patching
+# Track Specification: Advanced Tier 4 QA Auto-Patching (tier4_auto_patching_20260306)
 
 ## Overview
-Elevate Tier 4 to auto-patcher with .patch file generation and diff viewer.
+Elevate Tier 4 from log summarizer to auto-patcher. When verification tests fail, Tier 4 generates a .patch file. GUI displays side-by-side diff; user clicks Apply Patch to resume pipeline.
 
-## Current State Audit
-### Already Implemented
-- Tier 4 log analysis
-- Error detection in tests
-
-### Gaps to Fill
-- No .patch generation
-- No GUI diff viewer
-
-## Goals
-- Tier 4 generates .patch on test failure
-- Side-by-side diff viewer in GUI
-- Apply patch button
+## Architectural Constraints
+- **Safe Preview**: Patches MUST be previewed before application.
+- **Rollback**: Failed patches MUST be revertable.
+- **Atomic Application**: Patch application MUST be atomic (all-or-nothing).
 
 ## Functional Requirements
-- .patch file generation
-- Diff computation
-- Patch application
+- **Patch Generation**: Tier 4 generates .patch file on test failure.
+- **Diff Viewer**: GUI shows side-by-side diff of proposed changes.
+- **Apply Button**: User confirms patch application.
+- **Patch Application**: Apply patch to working directory and verify.
 
-## Non-Functional Requirements
-- Safe patch preview before apply
-- Rollback capability
+## Acceptance Criteria
+- [ ] Tier 4 generates valid .patch file.
+- [ ] GUI displays readable side-by-side diff.
+- [ ] User can approve/reject patch.
+- [ ] Approved patches applied correctly.
+- [ ] Rollback available on failure.