iter-3 polish pass on Plan 04-08 per checker iter-2 verdict PASSED
(commit 9c334b7). Five cosmetic-level fixes; no thesis/scope changes;
BLOCKER fixes from iter-2 + WARNING fixes from iter-2 preserved verbatim.
Remediations:
- WARNING 1 (low-severity; displaySurface sub-gate scope ambiguity):
HIGH-LATENCY catch path locked in; the under-specified
`--check-display-surface-only` spike-script mode is dropped (would have
required 5-10 LOC of executor improvisation for no meaningful latency
win over the canonical spike re-run's assertA2 fast-fail at <30s).
- Advisory 1 (symbol-name mismatch): Tier-2 snippet's `collectDistFiles`
replaced with the actual helper `listAllFilesRecursive(DIST_DIR)` from
tests/background/no-test-hooks-in-prod-bundle.test.ts:152; also uses
the existing `countOccurrencesInFile` for binary-extension-aware grep.
- Advisory 2 (SUMMARY-write practice for WARNING 1): explicit note added
that 04-08-SUMMARY.md documents the WARNING 1 closure path (no Plan B
fallback; explicit error-class identifier; observable via offscreen
console capture).
- Advisory 3 (vitest math): 183 -> 184 clarified consistently across
must_haves truth + Step 5 body + acceptance_criteria + verification +
success_criteria (+1 from the new Tier-2 `test(...)` block).
- Advisory 4 (duration-N/A rationale): moved out of the PLAN body into
the SUMMARY content list (Step 6); PLAN keeps only the load-bearing
size gate + loop-attr behavioral assertion + spike-re-run empirical
catch; 1.9 MB / ~400 kbps / ~38s decoded-timeline reasoning lands at
SUMMARY-time.
Frontmatter:
- Added iter-2 entry to revision_history (iter-3 polish closure).
- Tag flipped planner-iter-2-revision -> planner-iter-3-revision.
Plan validates via gsd-sdk frontmatter.validate + verify.plan-structure:
- valid: true; 0 errors; 0 warnings; 2 tasks; all 4 task elements present.
Diff: +51/-22 lines (5640 chars net). Branch ready for plan-checker
iter-3 (cosmetic-only polish review expected to PASS without further
findings).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>