diff --git a/coordination/claims/M03-RND-WMO-RUNTIME-MESH-FINALIZER-001.md b/coordination/claims/M03-RND-WMO-RUNTIME-MESH-FINALIZER-001.md new file mode 100644 index 0000000..edb072d --- /dev/null +++ b/coordination/claims/M03-RND-WMO-RUNTIME-MESH-FINALIZER-001.md @@ -0,0 +1,68 @@ +# M03-RND-WMO-RUNTIME-MESH-FINALIZER-001 + + + +## 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: