docs(pipeline): iteration-3 end-to-end validation + campaign re-bake notes

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Parley Hatch 2026-06-15 22:24:33 -06:00
parent 5506c38a51
commit 3773ac2ad7

View file

@ -84,12 +84,26 @@ Ran the A/B + strength sweep (16 renders) and follow-ups. Findings:
a symlink to the base interpreter, so the realpath check wrongly skipped the hop — a symlink to the base interpreter, so the realpath check wrongly skipped the hop —
now an env-sentinel guard); montage now succeeds in one invocation. now an env-sentinel guard); montage now succeeds in one invocation.
### Still open after iteration 3 ### Iteration 3 end-to-end result — VALIDATED ✅
- **Pick the production strength.** Sweep rendered 0.55/0.7/0.85/1.0; 0.85 looks good Full seed-7 re-bake (67/68; one transient ComfyUI miss, re-rendered) through rev-3
on open frames now. Eyeball the full montage for the lowest strength that still maps + closed-body prompts. Old-vs-new montage (`tools/out/compare/`):
honors geometry (lower = more natural texture). Then set `bake_atlas.py --strength`. - **r0_N (threshold, closed):** OLD painted a grand gateway + portcullis on a solid
- **Re-bake a full atlas** (seed 7) with rev-3 maps + closed-body prompts and montage wall; NEW renders a clean ashlar wall with torches. Phantom door gone.
vs the old `a12bcbb` bake to confirm the end-to-end win across all themes. - **r16_E (throne, closed):** clean wall with banners/columns — theme flavor survives
with zero opening nouns. Generalizes past threshold.
- **r16_N (throne, open) / r8_N (hall, open):** rich themed scenes, passage exactly on
the depth recess. Forge lava / crypt sarcophagi / library shelves / den all good.
- Strength **0.85 kept** — honors geometry without stiffness on the high-contrast maps.
### Campaign upgrade (in progress)
DESCENT loads these atlases directly (`game.js setFrame /out/atlas/<seed>/r<room>_<dir>.png`).
Campaign = seeds **7, 69, 59** (`game-web/game.js CAMPAIGN`), all previously baked at
the broken rev-2 (`a12bcbb`). Seed 7 done. Re-baking 69 + 59 through rev-3 (depths
re-exported headless, old frames backed up to `compare/old_bake_<seed>/`).
### Optional later
- Lower strength A/B (0.7) for more natural texture if any frame reads stiff.
- The single-frame retry-on-empty in bake_atlas would avoid the occasional ComfyUI miss.
## Open levers if still hit-and-miss after strength tuning ## Open levers if still hit-and-miss after strength tuning
- `nearPlane`/`minSpan`/`gamma` are now tunable per-export — A/B if near surfaces - `nearPlane`/`minSpan`/`gamma` are now tunable per-export — A/B if near surfaces