feat(lib): implement FW-N1~FW-N4 items and pane snapshot guidelines

2026-06-21 09:19:46 +00:00
parent 8097df0cbe
commit 5258b5013c
6 changed files with 18 additions and 14 deletions
@@ -349,6 +349,10 @@ has been verified (2026-06-21, 6-batch refactoring sprint):
 5. **Batch grouping** — group 2-3 FW items per batch when they touch different
   files (no file overlap). This amortises the dispatch overhead. Items touching
   the same file must be in separate batches to avoid conflicts.
+6. **Pane Snapshots & Truncation Prevention** — to prevent long agent responses from being scrolled out and truncated due to TUI viewport limitations, enforce the following snapshotting pattern:
+   - Immediately after dispatching a brief, capture the pre-brief pane buffer via `capture-pane -S -200`.
+   - During long execution, run a background loop taking incremental snapshots (e.g. every 30 seconds `>> /tmp/pane-snap.txt`).
+   - Immediately after job termination, capture the entire final pane state to ensure no terminal logs are lost.

 ## Verification Checklist