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

docs(vfx #C.1.5a): ship Phase C.1.5a + file issue #56 for per-part collapse

Browse source 
Visual verification at the Holtburg Town network portal passed for the
slice's mechanism: 10-hook portal script fires end-to-end with correct
color, persistence, orientation, and multi-emitter dispatch. After the
334f0c6 rotation-seed fix, the swirl is oriented correctly along the
portal's facing instead of world-NS.

Known limitation surfaced during verification and filed as issue #56:
ParticleHookSink ignores CreateParticleHook.PartIndex, so all 10 of the
portal's emitters collapse to the entity root position + identity-rotated
offset, producing a compressed and partly-ground-buried swirl instead of
the multi-tier shape retail renders. Mechanism is correct; per-part
transform handling is the next vfx-pipeline concern (will affect every
multi-emitter PES — slice 2 chimneys/fireplaces in particular).

Documentation changes:
- docs/ISSUES.md: new #56 entry with the captured entity guids
  (0x7A9B405B / 0x7A9B4080), script ids (0x3300126D / 0x3300067A),
  symptom data, root-cause hypothesis, file pointers, and acceptance
  criterion. Notes the blocks-slice-2 relationship explicitly.
- docs/superpowers/specs/2026-05-12-phase-c1.5a-portals-design.md §9:
  new limitation #1 documenting the verified PartIndex collapse symptom.
- docs/plans/2026-04-11-roadmap.md: new "C.1.5a" row in the shipped
  table referencing the spec, plan, and #56 caveat.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Erik 2026-05-11 16:13:12 +02:00
parent 334f0c6a26
commit 9009318656
3 changed files with 45 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

16
docs/superpowers/specs/2026-05-12-phase-c1.5a-portals-design.md
View file

@ -335,13 +335,23 @@ do not blindly retry.
These are intentionally not fixed in slice 1; tracked here so the next slice
or a future phase picks them up:
1. **Moving entities** don't re-anchor their DefaultScript emitters per
1. **`PartIndex` collapse on multi-part entities** (NEW — verified 2026-05-12
at the Holtburg Town network portal). `ParticleHookSink.SpawnFromHook`
ignores `CreateParticleHook.PartIndex`, so every emitter in a multi-emitter
script collapses to `entity.Position + rotated(hook.Offset.Origin)`. Retail
distributes the script's emitters across the entity's mesh parts (arch base,
columns, apex). Visual symptom for the Holtburg portal: the 10-hook script
produces a compressed swirl partially buried in the ground instead of the
multi-tier shape retail renders. Filed as `docs/ISSUES.md` #56 with the
captured entity guids + script ids; affects slice 2 (EnvCell chimneys /
fireplaces are multi-part) and any future multi-emitter PES path.
2. **Moving entities** don't re-anchor their DefaultScript emitters per
frame. No evidence retail's portals or chimneys move; revisit if visual
verification surfaces a regression.
2. **WB's re-fire-after-1s loop** is not implemented. Persistent emitters
3. **WB's re-fire-after-1s loop** is not implemented. Persistent emitters
work today; looping non-persistent emitters (if EnvCell static objects
use them) would need it in C.1.5b.
3. **Animation-hook particle path** (`MotionInterpreter` →
4. **Animation-hook particle path** (`MotionInterpreter` →
`ParticleHookSink`) is shipped in C.1 but **not verified** by a recent
visual test in this codebase state. Confirming this path is the second
half of C.1.5b.