docs(M03): accept WMO render resource cache state
This commit is contained in:
@@ -80,12 +80,14 @@ cache-format validation.
|
|||||||
|
|
||||||
## Status
|
## Status
|
||||||
|
|
||||||
- State: ready for integration
|
- State: accepted
|
||||||
- Done: state holder implemented; loader cache/request/reset/metrics adapters
|
- Done: state holder implemented; loader cache/request/reset/metrics adapters
|
||||||
migrated; shutdown regression and required documentation updated
|
migrated; shutdown regression and required documentation updated
|
||||||
- Next: integrate and run post-merge smoke on master
|
- Next: cached WMO scene/load state or liquid service extraction
|
||||||
- Blocked by:
|
- Blocked by:
|
||||||
|
|
||||||
|
<!-- OPENWC_INTEGRATION:ACCEPTED:M03-RND-WMO-RENDER-RESOURCE-CACHE-001:b4955d6 -->
|
||||||
|
|
||||||
## Handoff
|
## Handoff
|
||||||
|
|
||||||
- Commit: `d39f591`
|
- Commit: `d39f591`
|
||||||
@@ -105,5 +107,9 @@ cache-format validation.
|
|||||||
`docs/modules/wmo-render-resource-cache-state.md`; module registry, WMO queue,
|
`docs/modules/wmo-render-resource-cache-state.md`; module registry, WMO queue,
|
||||||
world renderer and `RENDER.md`; data-flow/state/sequence diagrams, ownership,
|
world renderer and `RENDER.md`; data-flow/state/sequence diagrams, ownership,
|
||||||
threading, cache-version boundary, failure/recovery and source map included.
|
threading, cache-version boundary, failure/recovery and source map included.
|
||||||
|
- Integration: merged as `b4955d6`; post-merge cache state (`cases=10`,
|
||||||
|
`iterations=100`, `elapsed_ms=51.949`), shutdown, WMO queue/resolver, facade,
|
||||||
|
internal-access (`private_symbols=41`), `7/7` manifest, documentation and
|
||||||
|
coordination gates passed.
|
||||||
|
|
||||||
<!-- OPENWC_HANDOFF:READY:M03-RND-WMO-RENDER-RESOURCE-CACHE-001:d39f591 -->
|
<!-- OPENWC_HANDOFF:READY:M03-RND-WMO-RENDER-RESOURCE-CACHE-001:d39f591 -->
|
||||||
|
|||||||
@@ -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`, `a878e7c`, `60603e1`;
|
- Revision/worktree: master merges `7ece2ab`, `7e35de7`, `80cb084`, `d6e5b53`, `c69abd6`, `606770c`, `630a0c1`, `f36fabb`, `24aef13`, `2342430`, `396be5e`, `f88bf97`, `3f84717`, `d2cb52f`, `f9e5a4f`, `c06aed5`, `a878e7c`, `60603e1`, `b4955d6`;
|
||||||
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`,
|
||||||
@@ -39,7 +39,8 @@ Runtime и Editor используют facade; planner/scheduler тестиру
|
|||||||
`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`
|
`M03-RND-WMO-RENDER-BUILD-QUEUE-001`,
|
||||||
|
`M03-RND-WMO-RENDER-RESOURCE-CACHE-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
|
||||||
@@ -93,6 +94,13 @@ Runtime и Editor используют facade; planner/scheduler тестиру
|
|||||||
(`57.835ms`), and post-fix master passed queue (`56.454ms`), planner,
|
(`57.835ms`), and post-fix master passed queue (`56.454ms`), planner,
|
||||||
registry, resolver, shutdown, facade, documentation and coordination gates
|
registry, resolver, shutdown, facade, documentation and coordination gates
|
||||||
without parse diagnostics.
|
without parse diagnostics.
|
||||||
|
WMO render Resource cache state passed `cases=10 iterations=100
|
||||||
|
elapsed_ms=58.727`; direct no-`.godot` service verification passed
|
||||||
|
(`45.361ms`), WMO queue/planner/registry/resolver/material/shutdown and 18
|
||||||
|
adjacent regressions passed, and the checkpoint dry-run retained `7/7` plans.
|
||||||
|
Post-merge cache state (`51.949ms`), shutdown, WMO queue/resolver, facade,
|
||||||
|
internal-access `41`, `7/7` manifest, documentation and coordination gates
|
||||||
|
remained 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
|
||||||
@@ -134,6 +142,10 @@ Runtime и Editor используют facade; planner/scheduler тестиру
|
|||||||
duplicate replacement, stale-front pop, first-occurrence cancel and three
|
duplicate replacement, stale-front pop, first-occurrence cancel and three
|
||||||
idempotent clear sites. Queue release never frees engine objects; the loader
|
idempotent clear sites. Queue release never frees engine objects; the loader
|
||||||
retains validity checks, materialization, permits and Node destruction.
|
retains validity checks, materialization, permits and Node destruction.
|
||||||
|
Lightweight WMO render cache paths retain the same cached/pending/missing
|
||||||
|
transitions, retry behavior for absent files and map-reset versus final-shutdown
|
||||||
|
lifetime. `ResourceLoader`, script identity and `FORMAT_VERSION` validation
|
||||||
|
remain loader-owned before the extracted state accepts a Resource.
|
||||||
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;
|
||||||
@@ -151,6 +163,8 @@ Runtime и Editor используют facade; planner/scheduler тестиру
|
|||||||
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,
|
typed WMO render build job/queue and loader enqueue/drain/cancel/clear adapters,
|
||||||
|
lightweight WMO render Resource/missing/request state and loader I/O/validation/
|
||||||
|
reset 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
|
||||||
@@ -165,7 +179,8 @@ 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
|
||||||
WMO cache/load requests and group materialization remain in the loader;
|
cached-scene WMO cache/load requests, ResourceLoader I/O and group
|
||||||
|
materialization remain in the loader;
|
||||||
asset-backed WMO placement/portal/material/leak/p95/p99 evidence remains 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