diff --git a/coordination/claims/M03-RND-WMO-SCENE-RESOURCE-FINALIZER-001.md b/coordination/claims/M03-RND-WMO-SCENE-RESOURCE-FINALIZER-001.md new file mode 100644 index 0000000..f0bd21b --- /dev/null +++ b/coordination/claims/M03-RND-WMO-SCENE-RESOURCE-FINALIZER-001.md @@ -0,0 +1,68 @@ +# M03-RND-WMO-SCENE-RESOURCE-FINALIZER-001 + + + +## Owner + +- Agent ID: `sindo-main-codex` +- Target: M03 Renderer Facade and Safe Extraction +- Branch: `work/sindo-main-codex/m03-wmo-scene-resource-finalizer` +- Worktree: `C:\Users\sindo\open-wc-worktrees\m03-wmo-scene-resource-finalizer` + +## Outcome + +Move cached WMO PackedScene terminal ResourceLoader polling, probe validation, +probe lifetime and scene/missing publication from the loader into one service. + +## Non-goals + +- Change `.tscn` path selection, file-size admission or request start behavior. +- Own live fallback, placement/build jobs, attached Nodes or scheduler permits. +- Change WMOBuilder cache metadata/version rules or visible output. +- Merge PackedScene and lightweight render Resource finalization generically. + +## Paths + +- Exclusive: `src/render/wmo/wmo_scene_resource_finalizer.gd`, + `src/tools/verify_wmo_scene_resource_finalizer.gd`, + `docs/modules/wmo-scene-resource-finalizer.md`, this claim +- Shared: loader, WMO scene cache state spec/verifier, world renderer registry/spec, + `RENDER.md`, M03 Evidence + +## Contracts and data + +- Pending requests are polled in detached Dictionary insertion order. +- Only LOADED/FAILED statuses complete requests. +- Failed, null, non-PackedScene, non-Node3D and stale scenes publish missing. +- Accepted PackedScenes retain exact Resource identity. +- Validation instantiates once and releases accepted/rejected Node3D probes once. +- Admission, oversize logging, live fallback and shutdown order are unchanged. + +## Dependencies + +- Requires: accepted WMO scene Resource cache state +- Blocks: remaining loader-owned WMO live fallback/materialization cleanup + +## Verification + +- Synthetic status/order/type/probe/validation/lifetime/adoption/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: active +- Done: ownership/compatibility contract +- Next: implementation, verification and documentation +- Blocked by: + +## Handoff + +- Commit: +- Results: +- Remaining risks: +- Documentation updated: