erik/acdream
1
0
Fork 0
Code Issues Pull requests Projects Releases 6 Packages Wiki Activity Actions 1

docs(overhaul): contract issue 470 readback barrier

Browse source
This commit is contained in:
Erik 2026-09-05 03:07:47 +02:00
parent 011ab1c182
commit 56837f547f
3 changed files with 107 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

19
docs/ISSUES.md
View file

@ -68,11 +68,14 @@ inspection).
## #470 — Atmospheric ordered world draws use absolute transform indices for local sidecars
**Status:** FIX ROUND 1 — renderer repair implemented at scratch `51f974da4`,
but retail/behavior review pass 1/10 found its Vulkan hardware witness inside
the portable gate; bounded evidence-lane repair is S5 packet §28; Campaign OVERHAUL v2
renderer-solid/G4 scope. The residual predates S5-c3 and is present at least as
far back as landed S4-c2 `252886e84`.
**Status:** FIX ROUND 2 — renderer repair `51f974da4` is correct and evidence-
lane fix `2cad9c84` passed narrow review pass 2/10. Full production review pass
3/10 found one harness-only P2: the offscreen image-to-buffer readback has no
transfer-write -> host-read memory dependency before mapping. The bounded
barrier/test contract is S5 packet §29; landing and graphical A/B remain
locked. Campaign OVERHAUL v2 renderer-solid/G4 scope. The production residual
predates S5-c3 and is present at least as far back as landed S4-c2
`252886e84`.
**Evidence/mechanism:** `WbDrawDispatcher.PrepareOrderedStream` writes instance
transforms into the shared directional-shadow transform arena and offsets every
@ -106,6 +109,12 @@ and preserve active/inactive receiver selection/binding. Repeat a pinned-camera
retail/off -> High -> retail/off graphical A/B without movement or resize. This
can share #469's final graphical route, but its code contract remains separate.
**Review-only harness tail (packet §29):** after the live image-to-buffer copy,
record an exact readback-buffer barrier from `CopyBit`/`TransferWriteBit` to
`HostBit`/`HostReadBit` before ending the command buffer, and pin both the live
descriptor and copy -> barrier -> end order without initializing Vulkan. No
renderer, shader, lane, recipe, or graphical policy changes.
## #469 — Atmospheric shadow-gate transition switches the whole outdoor lighting direction abruptly and can darken the world
**Status:** OPEN — found 2026-09-04 by the S5-c2 lead graphical gate; Campaign