diff --git a/coordination/claims/M03-RND-WMO-SCENE-INSTANCE-FACTORY-001.md b/coordination/claims/M03-RND-WMO-SCENE-INSTANCE-FACTORY-001.md new file mode 100644 index 0000000..f512334 --- /dev/null +++ b/coordination/claims/M03-RND-WMO-SCENE-INSTANCE-FACTORY-001.md @@ -0,0 +1,62 @@ +# M03-RND-WMO-SCENE-INSTANCE-FACTORY-001 + + + +## Owner + +- Agent ID: `sindo-main-codex` +- Target: M03 Renderer Facade and Safe Extraction +- Branch: `work/sindo-main-codex/m03-wmo-scene-instance-factory` +- Worktree: `C:\Users\sindo\open-wc-worktrees\m03-wmo-scene-instance-factory` + +## Outcome + +Move WMO cached-scene instantiation/currentness validation and live-prototype +duplication with shared name/placement application into one main-thread factory. + +## Non-goals + +- Change cache lookup/admission, ResourceLoader or prototype construction. +- Change runtime Mesh/material/occluder/shadow preparation. +- Change attachment, placement registry, queues, permits or lifetime. +- Change scene cache version rules or placement formulas. + +## Paths + +- Exclusive: `src/render/wmo/wmo_scene_instance_factory.gd`, + `src/tools/verify_wmo_scene_instance_factory.gd`, + `docs/modules/wmo-scene-instance-factory.md`, this claim +- Shared: loader, adjacent WMO verifier/spec, renderer registry/specification, + `RENDER.md`, M03 Evidence + +## Contracts and data + +- Null scenes/prototypes and non-Node3D instantiation/duplication return null. +- Cached instances failing the injected currentness validator are synchronously freed. +- Accepted instances retain exact descendant Resource identities. +- Both paths apply `relative_path.get_file().get_basename()` and the exact + placement-resolver Transform3D. +- The factory returns detached roots and retains no Node or Resource. + +## Dependencies + +- Requires: accepted WMO placement resolver and runtime scene preparer +- Blocks: remaining loader-owned WMO cache/prototype orchestration cleanup + +## Verification + +- Synthetic cached/live type, validation, freeing, exact identity, name, + transform, dependency/order, ownership, source and bounded-timing contracts; + adjacent WMO/renderer gates and checkpoint dry-run. + +## Documentation deliverables + +- Inline API docs; module API/I/O/ownership; data-flow/sequence/dependency + diagrams; adjacent renderer docs and M03 Evidence. + +## Status + +- State: active +- Done: scope and contracts identified +- Next: implement and verify factory delegation +- Blocked by: