106 lines
4.4 KiB
Markdown
106 lines
4.4 KiB
Markdown
# M03-RND-WMO-PLACEMENT-RESOLVER-001 — WMO placement resolver
|
|
|
|
<!-- OPENWC_CLAIM:M03-RND-WMO-PLACEMENT-RESOLVER-001:sindo-main-codex:2026-07-20 -->
|
|
|
|
## 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: handoff
|
|
- Done: resolver, seven loader adapters, regressions and documentation verified
|
|
- Next: M03 integrator acceptance and merge to master
|
|
- Blocked by:
|
|
|
|
<!-- OPENWC_HANDOFF:READY:M03-RND-WMO-PLACEMENT-RESOLVER-001:05e216a -->
|
|
|
|
## 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`.
|