docs(M03): accept terrain chunk queue planner
This commit is contained in:
@@ -77,11 +77,14 @@ streamer into a scene-free `TerrainChunkGeometryQueuePlanner`.
|
|||||||
|
|
||||||
## Status
|
## Status
|
||||||
|
|
||||||
- State: handoff
|
- State: accepted
|
||||||
- Done: pure planner, loader queue adoption, semantic/timing regressions and docs
|
- Done: pure planner, loader queue adoption, semantic/timing regressions and docs
|
||||||
- Next: milestone integrator merge and asset-backed performance acceptance later in M03
|
- Next: asset-backed performance acceptance and further terrain-service extraction later in M03
|
||||||
- Blocked by:
|
- Blocked by:
|
||||||
|
|
||||||
|
<!-- OPENWC_HANDOFF:READY:M03-RND-TERRAIN-CHUNK-QUEUE-001:f800e11 -->
|
||||||
|
<!-- OPENWC_INTEGRATION:ACCEPTED:M03-RND-TERRAIN-CHUNK-QUEUE-001:24aef13 -->
|
||||||
|
|
||||||
## Handoff
|
## Handoff
|
||||||
|
|
||||||
- Commit: `f800e11` (`refactor(M03): extract terrain chunk queue planner`)
|
- Commit: `f800e11` (`refactor(M03): extract terrain chunk queue planner`)
|
||||||
@@ -97,3 +100,5 @@ streamer into a scene-free `TerrainChunkGeometryQueuePlanner`.
|
|||||||
- Documentation updated: `terrain-chunk-geometry-queue-planner.md`, module
|
- Documentation updated: `terrain-chunk-geometry-queue-planner.md`, module
|
||||||
registry, `world-renderer.md`, `RENDER.md`, inline API documentation and
|
registry, `world-renderer.md`, `RENDER.md`, inline API documentation and
|
||||||
data-flow/lifecycle/sequence diagrams
|
data-flow/lifecycle/sequence diagrams
|
||||||
|
- Integration: accepted in master merge `24aef13`; post-merge planner,
|
||||||
|
internal-access, facade and manifest gates passed
|
||||||
|
|||||||
@@ -27,11 +27,11 @@ Runtime и Editor используют facade; planner/scheduler тестиру
|
|||||||
## Evidence
|
## Evidence
|
||||||
|
|
||||||
- Date: 2026-07-16
|
- Date: 2026-07-16
|
||||||
- Revision/worktree: master merges `7ece2ab`, `7e35de7`, `80cb084`, `d6e5b53`, `c69abd6`, `606770c`, `630a0c1`, `f36fabb`;
|
- Revision/worktree: master merges `7ece2ab`, `7e35de7`, `80cb084`, `d6e5b53`, `c69abd6`, `606770c`, `630a0c1`, `f36fabb`, `24aef13`;
|
||||||
packages `M03-RND-SCHEDULER-001`, `M03-RND-INTERNAL-ACCESS-GATE-001`,
|
packages `M03-RND-SCHEDULER-001`, `M03-RND-INTERNAL-ACCESS-GATE-001`,
|
||||||
`M03-RND-FACADE-GROUND-QUERY-001`, `M03-RND-FACADE-ENVIRONMENT-001`,
|
`M03-RND-FACADE-GROUND-QUERY-001`, `M03-RND-FACADE-ENVIRONMENT-001`,
|
||||||
`M03-RND-FACADE-ENTITY-001`, `M03-RND-TERRAIN-CACHE-SERVICE-001`,
|
`M03-RND-FACADE-ENTITY-001`, `M03-RND-TERRAIN-CACHE-SERVICE-001`,
|
||||||
`M03-RND-TERRAIN-LOD-PLANNER-001`
|
`M03-RND-TERRAIN-LOD-PLANNER-001`, `M03-RND-TERRAIN-CHUNK-QUEUE-001`
|
||||||
- Commands: dedicated scheduler/planner/facade/focus/coordinate/manifest/shutdown
|
- Commands: dedicated scheduler/planner/facade/focus/coordinate/manifest/shutdown
|
||||||
headless verifiers; Godot cold editor parse; coordination, documentation and diff gates.
|
headless verifiers; Godot cold editor parse; coordination, documentation and diff gates.
|
||||||
- Results: scheduler `cases=6 iterations=20000 elapsed_ms=10.216`; planner
|
- Results: scheduler `cases=6 iterations=20000 elapsed_ms=10.216`; planner
|
||||||
@@ -50,6 +50,9 @@ Runtime и Editor используют facade; planner/scheduler тестиру
|
|||||||
inventory decreased to `42` because the loader no longer owns the LRU-order field.
|
inventory decreased to `42` because the loader no longer owns the LRU-order field.
|
||||||
Terrain chunk LOD planner passed `cases=7 iterations=250 elapsed_ms=12.630`;
|
Terrain chunk LOD planner passed `cases=7 iterations=250 elapsed_ms=12.630`;
|
||||||
post-merge facade, internal-access and `7/7` manifest gates remained green.
|
post-merge facade, internal-access and `7/7` manifest gates remained green.
|
||||||
|
Terrain chunk geometry queue planner passed `cases=8 iterations=100
|
||||||
|
elapsed_ms=229.324`; internal-access remained `42` and post-merge facade and
|
||||||
|
`7/7` manifest gates stayed green.
|
||||||
M02 terrain-query regression
|
M02 terrain-query regression
|
||||||
remained green (13 pre-existing expired M00 claim warnings).
|
remained green (13 pre-existing expired M00 claim warnings).
|
||||||
- Fidelity comparison: all 16 historical operation limits and drain sites were
|
- Fidelity comparison: all 16 historical operation limits and drain sites were
|
||||||
@@ -65,6 +68,9 @@ Runtime и Editor используют facade; planner/scheduler тестиру
|
|||||||
profile capacities and three loader adapter sites; no cache format changed.
|
profile capacities and three loader adapter sites; no cache format changed.
|
||||||
Chunk LOD keeps horizontal XZ chunk-center distance, inclusive squared thresholds,
|
Chunk LOD keeps horizontal XZ chunk-center distance, inclusive squared thresholds,
|
||||||
sparse-index omission and raw negative-radius squaring at both loader call sites.
|
sparse-index omission and raw negative-radius squaring at both loader call sites.
|
||||||
|
Chunk operation planning preserves stable removals, nearest-first create sorting,
|
||||||
|
tile-LOD remove-all takeover, sparse tile-origin fallback and XZ-only distance;
|
||||||
|
loader still drains removals first through the shared `chunk_geometry` budget.
|
||||||
No new build-12340 parity claim is made; asset-backed visual/p95/p99 comparison remains pending.
|
No new build-12340 parity claim is made; asset-backed visual/p95/p99 comparison remains pending.
|
||||||
- Changed files: scene-free scheduler and verifier; streamer budget composition/
|
- Changed files: scene-free scheduler and verifier; streamer budget composition/
|
||||||
permit delegation; scheduler module spec; world renderer/module registry/RENDER notes;
|
permit delegation; scheduler module spec; world renderer/module registry/RENDER notes;
|
||||||
@@ -73,6 +79,7 @@ Runtime и Editor используют facade; planner/scheduler тестиру
|
|||||||
contract-v1 entity snapshot, renderer-owned entity presenter, runtime composition,
|
contract-v1 entity snapshot, renderer-owned entity presenter, runtime composition,
|
||||||
scene-free terrain quality Mesh cache and loader store/restore/clear adapters,
|
scene-free terrain quality Mesh cache and loader store/restore/clear adapters,
|
||||||
immutable terrain chunk LOD policy, pure planner and both loader plan adapters,
|
immutable terrain chunk LOD policy, pure planner and both loader plan adapters,
|
||||||
|
pure terrain chunk geometry queue planner and loader queue-adoption adapter,
|
||||||
expanded facade/internal-access/coordinate verifiers; work-package claims and this evidence.
|
expanded facade/internal-access/coordinate verifiers; work-package claims and this evidence.
|
||||||
- Remaining risks: queue storage length and worker concurrency/stale-result logic
|
- Remaining risks: queue storage length and worker concurrency/stale-result logic
|
||||||
remain streamer-owned; cancellation stops new permits but does not interrupt
|
remain streamer-owned; cancellation stops new permits but does not interrupt
|
||||||
@@ -81,5 +88,7 @@ Runtime и Editor используют facade; planner/scheduler тестиру
|
|||||||
network-scale hot paths; terrain cache is entry-count bounded without Mesh-byte
|
network-scale hot paths; terrain cache is entry-count bounded without Mesh-byte
|
||||||
metrics and the remaining terrain build/tasks/state/finalization stay monolithic;
|
metrics and the remaining terrain build/tasks/state/finalization stay monolithic;
|
||||||
chunk LOD asset-backed p95/p99 and visual acceptance remain pending;
|
chunk LOD asset-backed p95/p99 and visual acceptance remain pending;
|
||||||
|
chunk queue planning adds a second tile-state pass whose asset-backed p95/p99
|
||||||
|
still needs acceptance, while queue drains and geometry finalization remain monolithic;
|
||||||
M03 still needs further terrain/M2/WMO/liquid service extraction
|
M03 still needs further terrain/M2/WMO/liquid service extraction
|
||||||
and dependency/performance acceptance.
|
and dependency/performance acceptance.
|
||||||
|
|||||||
Reference in New Issue
Block a user