docs(M03): accept WMO render build queue
This commit is contained in:
@@ -82,12 +82,14 @@ the loader.
|
|||||||
|
|
||||||
## Status
|
## Status
|
||||||
|
|
||||||
- State: ready for integration
|
- State: accepted
|
||||||
- Done: typed job/queue implemented; three clear sites, metrics, enqueue, drain and
|
- Done: typed job/queue implemented; three clear sites, metrics, enqueue, drain and
|
||||||
cancel migrated; engine destruction/materialization retained in loader
|
cancel migrated; engine destruction/materialization retained in loader
|
||||||
- Next: integrator merge and post-merge verification
|
- Next: WMO cache/load state or liquid service extraction
|
||||||
- Blocked by:
|
- Blocked by:
|
||||||
|
|
||||||
|
<!-- OPENWC_INTEGRATION:ACCEPTED:M03-RND-WMO-RENDER-BUILD-QUEUE-001:60603e1 -->
|
||||||
|
|
||||||
## Handoff
|
## Handoff
|
||||||
|
|
||||||
- Commit: `e576ae2` (implementation `e1bb105` plus cold-load fix)
|
- Commit: `e576ae2` (implementation `e1bb105` plus cold-load fix)
|
||||||
@@ -106,5 +108,10 @@ the loader.
|
|||||||
`docs/modules/wmo-render-build-queue.md`, build-step planner spec, module
|
`docs/modules/wmo-render-build-queue.md`, build-step planner spec, module
|
||||||
registry, world renderer and `RENDER.md`; data-flow/state/sequence diagrams,
|
registry, world renderer and `RENDER.md`; data-flow/state/sequence diagrams,
|
||||||
ownership, threading, failure/recovery and source map included.
|
ownership, threading, failure/recovery and source map included.
|
||||||
|
- Integration: implementation merged as `a878e7c`; its first post-merge smoke
|
||||||
|
exposed and rejected a cold global-class registration dependency. Fix merged
|
||||||
|
as `60603e1`; post-fix master queue (`cases=11`, `iterations=100`,
|
||||||
|
`elapsed_ms=56.454`), planner, registry, resolver, shutdown, facade,
|
||||||
|
documentation and coordination gates passed without parse diagnostics.
|
||||||
|
|
||||||
<!-- OPENWC_HANDOFF:READY:M03-RND-WMO-RENDER-BUILD-QUEUE-001:e576ae2 -->
|
<!-- OPENWC_HANDOFF:READY:M03-RND-WMO-RENDER-BUILD-QUEUE-001:e576ae2 -->
|
||||||
|
|||||||
@@ -27,7 +27,7 @@ Runtime и Editor используют facade; planner/scheduler тестиру
|
|||||||
## Evidence
|
## Evidence
|
||||||
|
|
||||||
- Date: 2026-07-17
|
- Date: 2026-07-17
|
||||||
- Revision/worktree: master merges `7ece2ab`, `7e35de7`, `80cb084`, `d6e5b53`, `c69abd6`, `606770c`, `630a0c1`, `f36fabb`, `24aef13`, `2342430`, `396be5e`, `f88bf97`, `3f84717`, `d2cb52f`, `f9e5a4f`, `c06aed5`;
|
- Revision/worktree: master merges `7ece2ab`, `7e35de7`, `80cb084`, `d6e5b53`, `c69abd6`, `606770c`, `630a0c1`, `f36fabb`, `24aef13`, `2342430`, `396be5e`, `f88bf97`, `3f84717`, `d2cb52f`, `f9e5a4f`, `c06aed5`, `a878e7c`, `60603e1`;
|
||||||
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`,
|
||||||
@@ -38,7 +38,8 @@ Runtime и Editor используют facade; planner/scheduler тестиру
|
|||||||
`M03-RND-M2-BUILD-BATCH-PLANNER-001`,
|
`M03-RND-M2-BUILD-BATCH-PLANNER-001`,
|
||||||
`M03-RND-WMO-PLACEMENT-RESOLVER-001`,
|
`M03-RND-WMO-PLACEMENT-RESOLVER-001`,
|
||||||
`M03-RND-WMO-PLACEMENT-REGISTRY-001`,
|
`M03-RND-WMO-PLACEMENT-REGISTRY-001`,
|
||||||
`M03-RND-WMO-RENDER-BUILD-PLANNER-001`
|
`M03-RND-WMO-RENDER-BUILD-PLANNER-001`,
|
||||||
|
`M03-RND-WMO-RENDER-BUILD-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
|
||||||
@@ -85,6 +86,13 @@ Runtime и Editor используют facade; planner/scheduler тестиру
|
|||||||
regressions and the `7/7` checkpoint dry-run passed; post-merge planner
|
regressions and the `7/7` checkpoint dry-run passed; post-merge planner
|
||||||
(`11.059ms`), registry, resolver, shutdown, facade, documentation and
|
(`11.059ms`), registry, resolver, shutdown, facade, documentation and
|
||||||
coordination gates remained green.
|
coordination gates remained green.
|
||||||
|
WMO render build queue passed `cases=11 iterations=100 elapsed_ms=59.874`;
|
||||||
|
WMO planner/registry/resolver/material/shutdown, 18 adjacent regressions and
|
||||||
|
the `7/7` checkpoint dry-run passed. The first post-merge smoke exposed an
|
||||||
|
editor class-cache dependency; a fresh no-`.godot` run verified the fix
|
||||||
|
(`57.835ms`), and post-fix master passed queue (`56.454ms`), planner,
|
||||||
|
registry, resolver, shutdown, facade, documentation and coordination gates
|
||||||
|
without parse diagnostics.
|
||||||
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
|
||||||
@@ -122,6 +130,10 @@ Runtime и Editor используют facade; planner/scheduler тестиру
|
|||||||
Lightweight WMO render groups retain mesh-before-MultiMesh order, one cursor
|
Lightweight WMO render groups retain mesh-before-MultiMesh order, one cursor
|
||||||
increment and one budget permit per valid or null group; completion still
|
increment and one budget permit per valid or null group; completion still
|
||||||
cancels the job after both raw integer cursor comparisons are exhausted.
|
cancels the job after both raw integer cursor comparisons are exhausted.
|
||||||
|
Pending WMO render builds retain typed root/resource/cursors, FIFO order,
|
||||||
|
duplicate replacement, stale-front pop, first-occurrence cancel and three
|
||||||
|
idempotent clear sites. Queue release never frees engine objects; the loader
|
||||||
|
retains validity checks, materialization, permits and Node destruction.
|
||||||
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;
|
||||||
@@ -138,6 +150,7 @@ Runtime и Editor используют facade; planner/scheduler тестиру
|
|||||||
stateless WMO placement resolver and seven cache/identity/transform adapters,
|
stateless WMO placement resolver and seven cache/identity/transform adapters,
|
||||||
stateful WMO placement registry and global/tile add/release/clear adapters,
|
stateful WMO placement registry and global/tile add/release/clear adapters,
|
||||||
stateless WMO render build step planner and loader cursor-adoption adapter,
|
stateless WMO render build step planner and loader cursor-adoption adapter,
|
||||||
|
typed WMO render build job/queue and loader enqueue/drain/cancel/clear adapters,
|
||||||
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
|
||||||
@@ -152,7 +165,7 @@ Runtime и Editor используют facade; planner/scheduler тестиру
|
|||||||
asset-backed visual transform recheck, grouping/build/tasks/caches/finalization
|
asset-backed visual transform recheck, grouping/build/tasks/caches/finalization
|
||||||
and boundary traversal p95/p99 remain pending; path grouping is not yet
|
and boundary traversal p95/p99 remain pending; path grouping is not yet
|
||||||
culling-driven spatial-cell grouping; M2 resource/queue transitions and raw
|
culling-driven spatial-cell grouping; M2 resource/queue transitions and raw
|
||||||
build-job Dictionaries remain in the loader; WMO build job/resource state and
|
WMO cache/load requests and group materialization remain in the loader;
|
||||||
asset-backed placement/portal/material evidence remain pending;
|
asset-backed WMO placement/portal/material/leak/p95/p99 evidence remains pending;
|
||||||
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