open-wc/coordination/claims/M03-RND-WMO-PLACEMENT-RESOLVER-001.md

M03-RND-WMO-PLACEMENT-RESOLVER-001 — WMO placement resolver

Ownership

• Target: M03
• Program: RND
• Owner/Agent ID: sindo-main-codex
• Branch: work/sindo-main-codex/m03-wmo-placement-resolver
• Lease expires UTC: 2026-07-20
• Integrator: M03 milestone integrator

Outcome

Extract pure WMO cache-path normalization, placement identity and world-transform resolution from the loader into a scene-free service.

Non-goals

• Change WDT/ADT coordinate conversion or WMO placement values.
• Own WMO registry references, tile lifecycle, jobs, queues or retries.
• Load cached/live WMO resources or validate cache format versions.
• Create Nodes, Mesh/MultiMesh, materials or RIDs.
• Change portal/room/material/occlusion behavior or claim WMO parity.

Paths

• Exclusive: src/render/wmo/wmo_placement_resolver.gd, src/tools/verify_wmo_placement_resolver.gd, docs/modules/wmo-placement-resolver.md, this claim
• Shared/hotspots: src/scenes/streaming/streaming_world_loader.gd, docs/modules/world-renderer.md, docs/modules/README.md, RENDER.md, targets/03-renderer-facade.md
• Generated/ignored: .godot, native DLL, generated ADT/WMO resources, caches and proprietary renderer corpus

Contracts and data

• normalize_relative_path: replace backslashes, lowercase entire cache key
• resolve_unique_key: positive unique_id becomes uid:<decimal>; otherwise preserve tile:<tile-key>:<placement-index> fallback
• resolve_world_transform: defaults position/rotation to zero and scale to one; compose the same Godot Euler basis and un-clamped uniform scale
• Three transform consumers: render-cache root, cached scene and live prototype
• Cache/schema/coordinate/profile versions: unchanged

Dependencies

• Requires: current master 4f40c77
• Blocks: WMO registry/build decomposition
• External state: none; tests use synthetic paths and placement dictionaries

Verification

• Commands: dedicated path/identity/default/rotation/scale/source and bounded timing verifier; M2/terrain/facade/internal-access/manifest/shutdown/scheduler/ streaming/coordinate/documentation/coordination gates
• Fidelity evidence: exact normalization, identity and property-transform rules moved unchanged
• Performance budget: constant-time string/value math; no Node, Resource, RID, task, queue, mutex, cache or file access

Documentation deliverables

• Inline resolver API documentation
• New module spec with inputs/outputs, data-flow, lifecycle, ownership, failure, performance, fidelity limitations and source map
• Renderer/module registry and RENDER.md updates

Simplicity and naming

• Important name: WmoPlacementResolver
• Simplest solution: one stateless service with three explicit pure queries
• Rejected complexity: placement class hierarchy, generic model resolver, Resources, strategies, callbacks or registry framework
• Unavoidable complexity: raw placement Dictionary remains parser boundary
• Measured optimization evidence: bounded synthetic resolver loop

Status

• State: accepted
• Done: resolver, seven loader adapters, regressions and documentation verified
• Next: WMO registry/build extraction and asset-backed placement evidence
• Blocked by:

Handoff

• Commit: 05e216a (refactor(M03): extract WMO placement resolver)
• Results: dedicated resolver PASS (cases=9, iterations=20000, elapsed_ms=28.332), including historical Node3D property equivalence; renderer materials, M2 planner/grouper/transform/registry/dedupe, terrain cache/LOD/queue, facade, internal-access, manifest, shutdown, scheduler, streaming planner/focus, terrain-query and coordinate-boundary suites PASS; editor import parsed with only expected missing private corpus diagnostics; documentation PASS (module_specs=19, required_files=7); coordination PASS with 23 pre-existing expired M00/M01 warnings; checkpoint dry-run planned 7/7.
• Remaining risks: no private asset-backed WMO placement/visual/p95/p99 evidence; old caches without positive UID retain per-tile fallback; raw Dictionaries and WMO registry/build/resource state remain loader-owned; scale stays unclamped.
• Documentation updated: inline public API; new docs/modules/wmo-placement-resolver.md; renderer module registry, docs/modules/world-renderer.md and RENDER.md.
• Integration: accepted in master merge d2cb52f; post-merge resolver (cases=9, iterations=20000, elapsed_ms=27.919), renderer materials, shutdown, internal-access, facade, manifest, documentation and coordination gates passed.