coord(M03): hand off entity presentation facade

This commit is contained in:
2026-07-16 01:12:17 +04:00
parent 1807c3a363
commit b73b2e74a2
@@ -92,14 +92,36 @@ scene service with explicit entity subtree ownership.
## Status ## Status
- State: claimed - State: ready-for-review
- Done: contract, ownership and non-goals published - Done: immutable contract-v1 snapshot, presenter ownership lifecycle, facade
- Next: implement snapshot, presenter, facade wiring, regressions and docs commands, runtime composition, asset-free regressions and module documentation
- Next: M03 integrator reviews and merges `1807c3a`
- Blocked by: - Blocked by:
<!-- OPENWC_HANDOFF:READY:M03-RND-FACADE-ENTITY-001:1807c3a -->
## Handoff ## Handoff
- Commit: - Commit: `1807c3a`
- Results: - Results: facade now exposes idempotent `present_entity`, explicit
- Remaining risks: `remove_entity` and detached diagnostics. Both runtime scenes compose a
- Documentation updated: `WorldEntityPresenter` that owns one replaceable visual subtree per valid
session `EntityId`; local player and authoritative state remain separate.
- Verification: entity `snapshot_cases=8 lifecycle_cases=14 runtime_scenes=2`;
facade `delegation=9 entity_contract=6`; identities `5/5/6/5`; character
presentation `9/10/3/1`; coordinate boundary `files=119`; internal access
`43/7/9/1`; environment/ground/terrain, manifest `7/7`, shutdown, scheduler
(`20000` iterations), planner (`250` iterations), focus, editor parse, dry-run,
coordination, documentation and diff gates passed.
- Fidelity: runtime produces no world-entity commands yet, so all seven baseline
plans and existing player/world output remain unchanged. No build-12340
display, equipment, animation, effects or visibility parity claim is added.
- External/local inputs: ignored native DLL and generated ADT scripts supported
editor/dry-run only. Missing proprietary ADT/DBC/character corpus produced the
expected degraded diagnostics.
- Remaining risks: PackedScene create/replace loads synchronously and is not an
accepted network-scale hot path; resource paths are adapter inputs rather than
stable content IDs; animation/equipment/effects and scale profiling remain open.
- Documentation updated: new world-entity-presentation API/input-output/data-flow/
lifecycle/sequence/ownership/failure/configuration/migration/diagnostic/source-map
spec; world renderer, module registry and `RENDER.md` updated.