docs(overhaul): contract exact S5 c4 detail material

This commit is contained in:
Erik 2026-09-04 23:02:33 +02:00
parent 678bffaa85
commit 9f410d8b75
3 changed files with 282 additions and 4 deletions

View file

@ -39,6 +39,32 @@ confirmed closed by the owner, 11 need a focused live gate, and 43 are safe to
remain closed. See
[`docs/research/2026-08-28-owner-closed-issue-validity-audit.md`](research/2026-08-28-owner-closed-issue-validity-audit.md).
## #471 — Production walk-ordered building detail is classified but never rendered
**Status:** OPEN — confirmed 2026-09-04 by the S5-c4 production audit;
Campaign OVERHAUL v2 S5-c4 scope.
**Evidence/mechanism:** the production path is
`RetailPViewRenderer.DrawWalkDrivenStatics``WalkFrameDriver.Replay`
`PrepareOrderedStream``DrawOrderedRange`. Detail-category commands are
uploaded and deliberately force solo merge runs, but
`WbDrawDispatcher.OrderedStream.cs` issues only the base-pipeline indirect draw.
Its file header still says the detail overlay was deferred. The classic
`SubmitRhi` path does perform the second detail replay. Consequently opaque and
ClipMap building shells drawn through the mandatory production walk omit their
detail material even while the setting and category texture are live. The
existing ordered submitter test proves only three base draws and therefore
does not detect the omission.
**Bounded repair:** S5-c4 packet §22 replaces all base-plus-overlay detail with
retail's exact one-pass combined fragment. Arm that combine on the existing
walk-ordered solo base run and retain its original order, blend/depth/cull,
geometry, transform/sidecars, selected GfxObj, setting, sampler, and mip chain.
Do not add an overlay replay or a compensating terrain flush. Prove an ordered
ordinary → opaque-detail → ClipMap-detail → ordinary transcript, exact one draw
per source subset, setting/unavailable-category off rows, nonzero shared
transform prefix, and a pixel mutation that removes only the ordered arm.
## #470 — Atmospheric ordered world draws use absolute transform indices for local sidecars
**Status:** OPEN — found 2026-09-04 while auditing the S5-c3 graphical gate;