docs(M03): accept M2 placement grouper

This commit is contained in:
2026-07-17 00:07:11 +04:00
parent f88bf9714e
commit 9d74d996d5
2 changed files with 19 additions and 6 deletions
@@ -81,12 +81,13 @@ grouping from the worker callback into a scene-free service.
## Status ## Status
- State: handoff - State: accepted
- Done: pure grouper, worker adapter, regressions and documentation verified - Done: pure grouper, worker adapter, regressions and documentation verified
- Next: M03 integrator acceptance and merge to master - Next: M2 worker/build state extraction and spatial-cell evidence
- Blocked by: - Blocked by:
<!-- OPENWC_HANDOFF:READY:M03-RND-M2-PLACEMENT-GROUPER-001:9df32d3 --> <!-- OPENWC_HANDOFF:READY:M03-RND-M2-PLACEMENT-GROUPER-001:9df32d3 -->
<!-- OPENWC_INTEGRATION:ACCEPTED:M03-RND-M2-PLACEMENT-GROUPER-001:f88bf97 -->
## Handoff ## Handoff
@@ -107,3 +108,7 @@ grouping from the worker callback into a scene-free service.
- Documentation updated: inline public API; new - Documentation updated: inline public API; new
`docs/modules/m2-placement-grouper.md`; transform resolver module spec, `docs/modules/m2-placement-grouper.md`; transform resolver module spec,
renderer module registry, `docs/modules/world-renderer.md` and `RENDER.md`. renderer module registry, `docs/modules/world-renderer.md` and `RENDER.md`.
- Integration: accepted in master merge `f88bf97`; post-merge grouper
(`cases=9`, `iterations=100`, `placements=256`, `elapsed_ms=67.104`),
transform resolver, registry, internal-access, facade, manifest,
documentation and coordination gates passed.
+12 -4
View File
@@ -27,13 +27,14 @@ 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`, `24aef13`, `2342430`, `396be5e`; - Revision/worktree: master merges `7ece2ab`, `7e35de7`, `80cb084`, `d6e5b53`, `c69abd6`, `606770c`, `630a0c1`, `f36fabb`, `24aef13`, `2342430`, `396be5e`, `f88bf97`;
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-CHUNK-QUEUE-001`, `M03-RND-TERRAIN-LOD-PLANNER-001`, `M03-RND-TERRAIN-CHUNK-QUEUE-001`,
`M03-RND-M2-UNIQUE-REGISTRY-001`, `M03-RND-M2-UNIQUE-REGISTRY-001`,
`M03-RND-M2-PLACEMENT-TRANSFORM-001` `M03-RND-M2-PLACEMENT-TRANSFORM-001`,
`M03-RND-M2-PLACEMENT-GROUPER-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
@@ -61,6 +62,9 @@ Runtime и Editor используют facade; planner/scheduler тестиру
M2 placement transform resolver passed `cases=9 iterations=10000 M2 placement transform resolver passed `cases=9 iterations=10000
elapsed_ms=27.409`; post-merge M2 registry, internal-access `42`, facade, elapsed_ms=27.409`; post-merge M2 registry, internal-access `42`, facade,
`7/7` manifest, documentation and coordination gates remained green. `7/7` manifest, documentation and coordination gates remained green.
M2 placement grouper passed `cases=9 iterations=100 placements=256
elapsed_ms=67.104`; post-merge transform resolver, registry, internal-access
`42`, facade, `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
@@ -84,6 +88,9 @@ Runtime и Editor используют facade; planner/scheduler тестиру
M2 regular Euler, Elwynn cliff-rock shell correction, waterfall yaw/local-axis M2 regular Euler, Elwynn cliff-rock shell correction, waterfall yaw/local-axis
twist, tall-waterfall anchor compensation, path normalization and caller scale twist, tall-waterfall anchor compensation, path normalization and caller scale
clamps are unchanged across worker grouping, placeholders and direct instances. clamps are unchanged across worker grouping, placeholders and direct instances.
M2 worker grouping retains invalid-record filtering, case-sensitive lowercase
`.mdx/.mdl` conversion, first-seen group/per-group placement order, tile-local
origin subtraction and the `0.0001` scale clamp.
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;
@@ -95,7 +102,7 @@ Runtime и Editor используют facade; planner/scheduler тестиру
pure terrain chunk geometry queue planner and loader queue-adoption adapter, pure terrain chunk geometry queue planner and loader queue-adoption adapter,
stateful M2 unique placement registry, loader reserve/release/clear adapters and stateful M2 unique placement registry, loader reserve/release/clear adapters and
migrated historical dedupe smoke, stateless M2 placement transform resolver and migrated historical dedupe smoke, stateless M2 placement transform resolver and
three loader transform adapters, three transform consumers, stateless M2 placement grouper and worker 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
@@ -108,6 +115,7 @@ Runtime и Editor используют facade; planner/scheduler тестиру
still needs acceptance, while queue drains and geometry finalization remain monolithic; still needs acceptance, while queue drains and geometry finalization remain monolithic;
private Azeroth data was absent for the asset-backed ADT placement probe; M2 private Azeroth data was absent for the asset-backed ADT placement probe; M2
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; and boundary traversal p95/p99 remain pending; path grouping is not yet
culling-driven spatial-cell grouping;
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.