From 5e2afbc40099eda262a1c921e859690887111d5d Mon Sep 17 00:00:00 2001 From: sindoring Date: Fri, 17 Jul 2026 12:12:19 +0400 Subject: [PATCH] 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 --- .../M03-RND-M2-MESH-RESOURCE-CACHE-001.md | 13 ++++++++-- targets/03-renderer-facade.md | 24 +++++++++++++++---- 2 files changed, 30 insertions(+), 7 deletions(-) diff --git a/coordination/claims/M03-RND-M2-MESH-RESOURCE-CACHE-001.md b/coordination/claims/M03-RND-M2-MESH-RESOURCE-CACHE-001.md index 4e705e6..c265e7f 100644 --- a/coordination/claims/M03-RND-M2-MESH-RESOURCE-CACHE-001.md +++ b/coordination/claims/M03-RND-M2-MESH-RESOURCE-CACHE-001.md @@ -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`. + +## 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. + + diff --git a/targets/03-renderer-facade.md b/targets/03-renderer-facade.md index 3d19c31..b91d178 100644 --- a/targets/03-renderer-facade.md +++ b/targets/03-renderer-facade.md @@ -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;