re: additive blending refuted, the swoosh is not displaced, and the

residual is smaller than I said

Testing the candidate I raised last iteration rather than carrying it.
Blending bit-0x02 sprites additively moves every measure the wrong way --
whole-frame mean diff +0.55 to +1.04, swoosh-band mean +1.83 to +3.98,
band edge-correlation 0.6971 down to 0.5578. So the bit is real and
independent but does not select an additive blend. I reverted the
experiment and kept the word as T8adImage::flags, documented and not
acted on; the render is byte-identical to before.

Second refutation: the swoosh is not displaced. Shifting the band over
plus or minus 80 by 8 pixels peaks sharply at zero, 0.7342, falling to
0.22 at 24 px. So the pivot story is dead twice over -- inert at scale
100, and no displacement to explain anyway.

And I have restated the residual, because earlier sections overstated it.
The +16 to +34 band tiles I quoted were measured WITHOUT --primitives.
With the dim drawn the band's average is nearly right at +1.83; what is
wrong is its structure, tiles running -38.6 then +33.8 and cancelling.
Six candidates eliminated now and none confirmed.

One caveat I owe the port agent about the capture I gave them: it is at
t=4.0s, roughly 174 keyframe units into a screen whose elements have
keyframes out to t=600. I judged "settled" from mean luminance, which
cannot see a thin sprite still moving. It is settled for the bulk of the
screen and not proven settled for every element -- which is a live
alternative explanation for a structural difference in exactly the band
the sweeps cross.

METHOD: cargo build passing does not mean cargo test compiles. Adding the
field built the library in 1.48s and broke two test-only struct literals;
cargo test failed with exit 101.

docs/re/METHOD.md

@@ -294,3 +294,8 @@ agent's loop prompt, i.e. nowhere durable. See [`README.md`](README.md) for the
   first one in the file. It failed its own control instantly: different sprites
   reported identical dimensions. Match on something the header itself carries
   (here width × height against the decoded PNGs) rather than on proximity.
+* **`cargo build` passing does not mean `cargo test` compiles.** Adding a field to
+  `T8adImage` built the library fine in 1.48 s — and broke two *test-only* struct
+  literals, so `cargo test` failed to compile with exit 101. A green build on the
+  binary is not a gate for a struct change; run the tests before believing a
+  data-structure edit is safe.

docs/re/structures/ui-paint-order-key.md

@@ -477,10 +477,22 @@ and the texture itself is blue-leaning
 mode** is what is left, and this is the only per-sprite field found that
 distinguishes the elements involved.
 
-⚠️ **This is a correlation, not a decode.** Nothing here shows the bit *means*
-additive. The test: blend bit-`0x02` sprites additively and re-correlate the title
-render against
+### 🔴 Tested — it does NOT select an additive blend
+
+Blending bit-`0x02` sprites additively and re-correlating against the title
+capture moved **every** measure the wrong way:
+
+| | alpha-over | additive |
+|---|---|---|
+| whole-frame mean diff | **+0.55** | +1.04 |
+| swoosh-band mean diff | **+1.83** | +3.98 |
+| swoosh-band edge-corr | **0.6971** | 0.5578 |
+
+So the bit is real and independent, but **additive is refuted**. `T8adImage` now
+carries the word as `flags`, documented and *not* acted on.
+
+⚠️ **What remains is a correlation, not a decode.** The original test was against
 [`../captures/title-builds/live-title-build4-no-plate.png`](../captures/title-builds/live-title-build4-no-plate.png).
 Worth noting `ptlogo_back2eff` carries `0x8830` **despite** having `eff` in its
-name — so the split is the field's, not a naming pattern's, which is the one thing
-that makes it more than a guess.
+name — so the split is the field's, not a naming pattern's. What the bit *does*
+mean is still unknown.

docs/re/ui-title-build-map.md

@@ -500,3 +500,44 @@ The obvious guess — *our dim is applied over the whole frame instead of beneat
 the UI, where its layer key puts it* — is **wrong**. If it were, the logo would
 render too dark; it reads **+2.36** against a background of **−0.74**. The
 compositor honours the paint order here.
+
+
+## 🔴 The swoosh is not displaced either — and the residual is restated
+
+Two more candidates eliminated, and the residual is smaller than earlier sections
+implied.
+
+**Not a displacement.** Shifting the render's swoosh band over ±80 px × ±8 px and
+re-correlating peaks **sharply at (0, 0)** — 0.7342, falling to 0.22 at ±24 px and
+0.10 at ±48. The swoosh is where it should be.
+
+**Not additive blending.** See
+[`structures/ui-paint-order-key.md`](structures/ui-paint-order-key.md): every
+measure worsens.
+
+**And the residual, restated with the current best render** (`--black
+--primitives`, `rest()` fixed):
+
+| | |
+|---|---|
+| whole-frame mean diff | **+0.55** |
+| swoosh-band mean diff | **+1.83** |
+| swoosh-band edge-correlation | **0.6971** (vs ≈ 0.92 frame-wide) |
+
+⚠️ Earlier sections quoted band tiles at **+16 … +34**. Those were measured on a
+render **without** `--primitives`. With the dim drawn the band's *average* is
+nearly right; what is wrong is its **structure** — the tiles run −38.6 then +33.8
+across the band and cancel. So the defect is neither brightness, nor position, nor
+additive blending: it is a shape difference in one band, and it is **not
+diagnosed**. Six candidates eliminated: pivot (twice — inert at scale 100, and no
+measured displacement), `fade`, `tint`, texture colour, additive blend.
+
+### ⚠️ A caveat on the plate-free capture
+
+It was taken at **t ≈ 4.0 s**, about **2.9 s** (≈ 174 keyframe units) after the
+screen begins. Several title elements have keyframes running to **t = 600**
+(10 s) — the `ptloop` sweeps among them. "Settled" was judged from mean
+luminance, which cannot see a thin sprite still in motion. The capture is settled
+for the bulk of the screen; it is **not proven settled for every element**, and
+that is a live alternative explanation for a structural difference in exactly the
+band those sweeps cross.