docs(M03): accept M2 mesh resource cache state

Work-Package: M03-RND-M2-MESH-RESOURCE-CACHE-001
Agent: sindo-main-codex
Tests: post-merge cache, pipeline, classifier, materials, shutdown, facade, internal-access, manifest, documentation and coordination gates pass
Fidelity: preserves Mesh identity/replacement/final-shutdown lifetime; asset-backed visual parity remains unclaimed
This commit is contained in:
2026-07-17 12:12:19 +04:00
parent 30945615b9
commit 5e2afbc400
2 changed files with 30 additions and 7 deletions
@@ -78,9 +78,9 @@ all existing cache consumers.
## Status
- State: ready
- State: accepted
- Done: cache state, loader/test adapters, contract verifier and required documentation
- Next: integrator merge and post-merge smoke
- Next: isolated M2 Mesh resource finalizer extraction
- Blocked by:
## Handoff
@@ -97,3 +97,12 @@ all existing cache consumers.
registry, `world-renderer.md` and `RENDER.md`.
<!-- OPENWC_HANDOFF:READY:M03-RND-M2-MESH-RESOURCE-CACHE-001:e990a65 -->
## Integration
- Merge commit: `3094561`
- Post-merge results: cache state `cases=9 iterations=100
elapsed_ms=38.686`; pipeline, classifier, materials, shutdown, facade,
internal-access `34`, manifest `7/7`, documentation and coordination gates passed.
<!-- OPENWC_INTEGRATION:ACCEPTED:M03-RND-M2-MESH-RESOURCE-CACHE-001:3094561 -->
+19 -5
View File
@@ -27,7 +27,7 @@ Runtime и Editor используют facade; planner/scheduler тестиру
## Evidence
- 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`, `b4955d6`, `ada0fd9`, `f470775`, `874fd0f`, `38f831e`, `83b3618`;
- Revision/worktree: master merges `7ece2ab`, `7e35de7`, `80cb084`, `d6e5b53`, `c69abd6`, `606770c`, `630a0c1`, `f36fabb`, `24aef13`, `2342430`, `396be5e`, `f88bf97`, `3f84717`, `d2cb52f`, `f9e5a4f`, `c06aed5`, `a878e7c`, `60603e1`, `b4955d6`, `ada0fd9`, `f470775`, `874fd0f`, `38f831e`, `83b3618`, `3094561`;
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-ENTITY-001`, `M03-RND-TERRAIN-CACHE-SERVICE-001`,
@@ -45,7 +45,8 @@ Runtime и Editor используют facade; planner/scheduler тестиру
`M03-RND-ADT-WATER-LOAD-PIPELINE-001`,
`M03-RND-ADT-WATER-SCENE-FINALIZER-001`,
`M03-RND-M2-RUNTIME-REBUILD-CLASSIFIER-001`,
`M03-RND-M2-MESH-LOAD-PIPELINE-001`
`M03-RND-M2-MESH-LOAD-PIPELINE-001`,
`M03-RND-M2-MESH-RESOURCE-CACHE-001`
- Commands: dedicated scheduler/planner/facade/focus/coordinate/manifest/shutdown
headless verifiers; Godot cold editor parse; coordination, documentation and diff gates.
- Results: scheduler `cases=6 iterations=20000 elapsed_ms=10.216`; planner
@@ -143,6 +144,13 @@ Runtime и Editor используют facade; planner/scheduler тестиру
headless regressions and checkpoint dry-run `7/7` passed. Post-merge pipeline
state (`69.196ms`), classifier, materials, shutdown, facade, internal-access
`34`, `7/7` manifest, documentation and coordination gates remained green.
M2 mesh resource cache state passed `cases=9 iterations=100
elapsed_ms=38.974` with invalid-input guards, exact-reference lookup,
replacement, detached path diagnostics, idempotent clear and 100-by-256
timing. Thirty-five renderer/coordinate regressions and checkpoint dry-run
`7/7` passed. Post-merge cache state (`38.686ms`), pipeline, classifier,
materials, shutdown, facade, internal-access `34`, `7/7` manifest,
documentation and coordination gates remained green.
M02 terrain-query regression
remained green (13 pre-existing expired M00 claim warnings).
- Fidelity comparison: all 16 historical operation limits and drain sites were
@@ -212,7 +220,11 @@ Runtime и Editor используют facade; planner/scheduler тестиру
insertion polling order; loaded/failed transitions preserve completion-order
finalization FIFO and opaque statuses. All three pending-plus-finalize metrics,
both clear sites and shutdown ResourceLoader drain order are unchanged; cache
path selection, I/O, permits, Mesh/missing caches and adoption remain loader-owned.
path selection, I/O, permits, shared missing state and adoption remain loader-owned.
Prepared static M2 Mesh lookups retain exact Resource identity, same-path
replacement and map-refresh lifetime; the only clear remains final shutdown
after asynchronous drain. Shared missing/prototype/animated caches, extraction,
refresh/rebuild and materialization remain loader-owned.
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/
permit delegation; scheduler module spec; world renderer/module registry/RENDER notes;
@@ -239,6 +251,7 @@ Runtime и Editor используют facade; planner/scheduler тестиру
stateless ADT water scene finalizer and both loader build/attach adapters,
memoized M2 runtime mesh rebuild classifier and loader query/clear adapters,
M2 mesh load pipeline state and loader request/poll/finalize/metric/clear adapters,
prepared M2 Mesh resource cache state and loader lookup/store/shutdown adapters,
expanded facade/internal-access/coordinate verifiers; work-package claims and this evidence.
- Remaining risks: worker concurrency and stale-result validation remain
streamer-owned; cancellation stops new permits but does not interrupt
@@ -253,8 +266,9 @@ Runtime и Editor используют facade; planner/scheduler тестиру
asset-backed visual transform recheck, grouping/build/tasks/caches/finalization
and boundary traversal p95/p99 remain pending; path grouping is not yet
culling-driven spatial-cell grouping; M2 rebuild classification and static
request/finalize bookkeeping are separated, but ResourceLoader I/O, Mesh/
missing caches and mesh finalization remain in the loader; raw
request/finalize bookkeeping and prepared Mesh cache ownership are separated,
but ResourceLoader I/O, shared missing state, Mesh extraction/preparation and
finalization remain in the loader; raw
WMO ResourceLoader/FileAccess I/O, live fallback and group materialization
remain in the loader;
asset-backed WMO placement/portal/material/leak/p95/p99 evidence remains pending;