coord(M03): hand off terrain mesh cache service

This commit is contained in:
2026-07-16 09:29:55 +04:00
parent 97480e06bb
commit 10815be766
@@ -83,14 +83,33 @@ source-admission rules from `StreamingWorldLoader` into a small scene-free
## Status ## Status
- State: claimed - State: ready-for-review
- Done: ownership, behavior and non-goals published - Done: scene-free cache ownership/LRU extraction, loader adapter migration,
- Next: implement service, migrate loader wrappers, tests and docs contract regression and module documentation
- Next: M03 integrator reviews and merges `97480e0`
- Blocked by: - Blocked by:
<!-- OPENWC_HANDOFF:READY:M03-RND-TERRAIN-CACHE-SERVICE-001:97480e0 -->
## Handoff ## Handoff
- Commit: - Commit: `97480e0`
- Results: - Results: `TerrainQualityMeshCache` now owns retained full-quality Mesh
- Remaining risks: references, source admission and oldest-to-newest LRU. The loader retains only
- Documentation updated: restore-to-state, store-after-upgrade and clear lifecycle adapters.
- Verification: cache `contract_cases=15 loader_calls=3`; facade/entity/ground/
terrain regressions; internal access `private_symbols=42 gameplay=7
editor_sources=9 renderer_tools=1`; manifest `7/7`; shutdown; scheduler
`20000` iterations; planner `250` iterations; focus; editor parse; dry-run;
coordination, documentation and diff gates passed.
- Fidelity: `baked_full` revisit retention, three excluded splat sources, LRU
touch/trim, profile capacities and all call sites remain unchanged. All seven
checkpoint plans remain valid. No visible or build-12340 parity claim is added.
- External/local inputs: ignored native DLL and generated ADT scripts supported
parse/dry-run only; missing proprietary ADT/DBC/character data produced expected diagnostics.
- Remaining risks: entry count does not measure Mesh bytes; ordered-array touch
remains linear; asset-backed revisit flash, memory and p95/p99 evidence remain pending;
terrain build/tasks/state/finalization are still monolithic.
- Documentation updated: new terrain cache API/input-output/data-flow/lifecycle/
sequence/ownership/failure/configuration/migration/diagnostic/source-map spec;
world renderer, registry and `RENDER.md` updated.