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: claimed
• Done: exact rules, consumers and ownership boundary published
• Next: implement resolver, migrate adapters, tests and docs
• Blocked by:

Handoff

• Commit:
• Results:
• Remaining risks:
• Documentation updated: