coordination: claim WMO runtime Mesh finalizer
This commit is contained in:
@@ -0,0 +1,68 @@
|
|||||||
|
# M03-RND-WMO-RUNTIME-MESH-FINALIZER-001
|
||||||
|
|
||||||
|
<!-- OPENWC_CLAIM:M03-RND-WMO-RUNTIME-MESH-FINALIZER-001:sindo-main-codex:2026-07-20 -->
|
||||||
|
|
||||||
|
## Owner
|
||||||
|
|
||||||
|
- Agent ID: `sindo-main-codex`
|
||||||
|
- Target: M03 Renderer Facade and Safe Extraction
|
||||||
|
- Branch: `work/sindo-main-codex/m03-wmo-runtime-mesh-finalizer`
|
||||||
|
- Worktree: `C:\Users\sindo\open-wc-worktrees\m03-wmo-runtime-mesh-finalizer`
|
||||||
|
|
||||||
|
## Outcome
|
||||||
|
|
||||||
|
Move cached WMO runtime Mesh material refresh versioning, surface iteration and
|
||||||
|
material-definition reconstruction from the loader into one service.
|
||||||
|
|
||||||
|
## Non-goals
|
||||||
|
|
||||||
|
- Change WMO traversal, placement, build-job scheduling or Node materialization.
|
||||||
|
- Change WMOBuilder shader/material behavior or cache formats.
|
||||||
|
- Change texture path ordering, metadata names or visible output.
|
||||||
|
- Generalize M2 and WMO finalization behind a shared abstraction.
|
||||||
|
|
||||||
|
## Paths
|
||||||
|
|
||||||
|
- Exclusive: `src/render/wmo/wmo_runtime_mesh_finalizer.gd`,
|
||||||
|
`src/tools/verify_wmo_runtime_mesh_finalizer.gd`,
|
||||||
|
`docs/modules/wmo-runtime-mesh-finalizer.md`, this claim
|
||||||
|
- Shared: loader, WMO build/cache and world renderer specs/verifiers,
|
||||||
|
`RENDER.md`, M03 Evidence
|
||||||
|
|
||||||
|
## Contracts and data
|
||||||
|
|
||||||
|
- Null meshes remain null; accepted meshes retain exact Resource identity.
|
||||||
|
- Refresh metadata version `10` remains the admission boundary.
|
||||||
|
- Only stale `ArrayMesh` surfaces with cached WMO texture metadata are rebuilt.
|
||||||
|
- Texture indices remain compact and ordered texture0, texture1, texture2.
|
||||||
|
- WMO flags, shader, blend mode and cached colors are forwarded unchanged.
|
||||||
|
- Scene traversal, builder material semantics and shutdown order are unchanged.
|
||||||
|
|
||||||
|
## Dependencies
|
||||||
|
|
||||||
|
- Requires: accepted WMO render and scene Resource finalizers
|
||||||
|
- Blocks: remaining loader-owned WMO runtime materialization cleanup
|
||||||
|
|
||||||
|
## Verification
|
||||||
|
|
||||||
|
- Synthetic identity/version/type/surface/metadata/color/definition/source/timing
|
||||||
|
contracts; adjacent WMO/renderer gates; full suite and checkpoint dry-run.
|
||||||
|
|
||||||
|
## Documentation deliverables
|
||||||
|
|
||||||
|
- Inline API docs; module API/I/O/ownership; data-flow/state/sequence/dependency
|
||||||
|
diagrams; adjacent renderer docs and M03 Evidence.
|
||||||
|
|
||||||
|
## Status
|
||||||
|
|
||||||
|
- State: claimed
|
||||||
|
- Done: package boundary and contracts
|
||||||
|
- Next: implementation, verification and documentation
|
||||||
|
- Blocked by:
|
||||||
|
|
||||||
|
## Handoff
|
||||||
|
|
||||||
|
- Commit:
|
||||||
|
- Results:
|
||||||
|
- Remaining risks:
|
||||||
|
- Documentation updated:
|
||||||
Reference in New Issue
Block a user