docs(M03): accept ADT water scene finalizer
This commit is contained in:
@@ -81,12 +81,14 @@ the existing `ADTBuilder` geometry/material implementation.
|
|||||||
|
|
||||||
## Status
|
## Status
|
||||||
|
|
||||||
- State: ready for integration
|
- State: accepted
|
||||||
- Done: stateless finalizer implemented; both loader water paths migrated;
|
- Done: stateless finalizer implemented; both loader water paths migrated;
|
||||||
synthetic scene/owner regression and required documentation added
|
synthetic scene/owner regression and required documentation added
|
||||||
- Next: integrate and run post-merge smoke on master
|
- Next: continue liquid parsing/task execution extraction or another remaining M03 boundary
|
||||||
- Blocked by:
|
- Blocked by:
|
||||||
|
|
||||||
|
<!-- OPENWC_INTEGRATION:ACCEPTED:M03-RND-ADT-WATER-SCENE-FINALIZER-001:874fd0f -->
|
||||||
|
|
||||||
## Handoff
|
## Handoff
|
||||||
|
|
||||||
- Commit: `235be3a`
|
- Commit: `235be3a`
|
||||||
@@ -106,5 +108,9 @@ the existing `ADTBuilder` geometry/material implementation.
|
|||||||
`docs/modules/adt-water-scene-finalizer.md`; water-pipeline spec, module registry,
|
`docs/modules/adt-water-scene-finalizer.md`; water-pipeline spec, module registry,
|
||||||
world renderer and `RENDER.md`; data-flow/state/sequence/dependency diagrams,
|
world renderer and `RENDER.md`; data-flow/state/sequence/dependency diagrams,
|
||||||
ownership, main-thread effects, failure/recovery, migration and source map included.
|
ownership, main-thread effects, failure/recovery, migration and source map included.
|
||||||
|
- Integration: merged as `874fd0f`; post-merge finalizer (`cases=8`,
|
||||||
|
`iterations=100`, `elapsed_ms=0.025`), water pipeline (`98.398ms`), shutdown,
|
||||||
|
renderer materials, facade, internal-access (`private_symbols=36`), `7/7`
|
||||||
|
manifest, documentation and coordination gates passed.
|
||||||
|
|
||||||
<!-- OPENWC_HANDOFF:READY:M03-RND-ADT-WATER-SCENE-FINALIZER-001:235be3a -->
|
<!-- OPENWC_HANDOFF:READY:M03-RND-ADT-WATER-SCENE-FINALIZER-001:235be3a -->
|
||||||
|
|||||||
@@ -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`, `b4955d6`, `ada0fd9`, `f470775`;
|
- 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`;
|
||||||
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`,
|
||||||
@@ -42,7 +42,8 @@ Runtime и Editor используют facade; planner/scheduler тестиру
|
|||||||
`M03-RND-WMO-RENDER-BUILD-QUEUE-001`,
|
`M03-RND-WMO-RENDER-BUILD-QUEUE-001`,
|
||||||
`M03-RND-WMO-RENDER-RESOURCE-CACHE-001`,
|
`M03-RND-WMO-RENDER-RESOURCE-CACHE-001`,
|
||||||
`M03-RND-WMO-SCENE-RESOURCE-CACHE-001`,
|
`M03-RND-WMO-SCENE-RESOURCE-CACHE-001`,
|
||||||
`M03-RND-ADT-WATER-LOAD-PIPELINE-001`
|
`M03-RND-ADT-WATER-LOAD-PIPELINE-001`,
|
||||||
|
`M03-RND-ADT-WATER-SCENE-FINALIZER-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
|
||||||
@@ -117,6 +118,14 @@ Runtime и Editor используют facade; planner/scheduler тестиру
|
|||||||
checkpoint dry-run retained `7/7` plans. Post-merge water state (`86.935ms`),
|
checkpoint dry-run retained `7/7` plans. Post-merge water state (`86.935ms`),
|
||||||
shutdown, renderer materials, facade, internal-access `36`, `7/7` manifest,
|
shutdown, renderer materials, facade, internal-access `36`, `7/7` manifest,
|
||||||
documentation and coordination gates remained green.
|
documentation and coordination gates remained green.
|
||||||
|
ADT water scene finalizer passed `cases=8 iterations=100 elapsed_ms=0.042`
|
||||||
|
after an initial `0.024ms` run; synthetic data produced one four-vertex/
|
||||||
|
six-index liquid surface with exact tile attachment and recursive editor owner.
|
||||||
|
Water pipeline, WMO/M2/terrain/facade/scheduler/streaming/coordinate, material,
|
||||||
|
shutdown and 32 headless contract regressions passed; checkpoint dry-run
|
||||||
|
retained `7/7` plans. Post-merge finalizer (`0.025ms`), water pipeline
|
||||||
|
(`98.398ms`), shutdown, materials, facade, internal-access `36`, `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
|
||||||
@@ -172,7 +181,11 @@ Runtime и Editor используют facade; planner/scheduler тестиру
|
|||||||
result publication order are unchanged, and the mutex remains limited to the
|
result publication order are unchanged, and the mutex remains limited to the
|
||||||
worker/main-thread mailbox. The loader still owns ADT parsing, concurrency and
|
worker/main-thread mailbox. The loader still owns ADT parsing, concurrency and
|
||||||
profile limits, stale tile/path/root rejection, `WATER_FINALIZE` permits,
|
profile limits, stale tile/path/root rejection, `WATER_FINALIZE` permits,
|
||||||
water Node construction/attachment and `water_loaded` timing.
|
tile subtree lifetime and `water_loaded` timing.
|
||||||
|
Both raw-tile and delayed cached-tile water paths now call the same stateless
|
||||||
|
finalizer. It invokes the unchanged `ADTBuilder.build_tile_water_scene`,
|
||||||
|
attaches the returned root once and applies the existing optional recursive
|
||||||
|
Editor ownership; tile subtree lifetime and dry-root cleanup are unchanged.
|
||||||
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;
|
||||||
@@ -196,6 +209,7 @@ Runtime и Editor используют facade; planner/scheduler тестиру
|
|||||||
validation/reset adapters,
|
validation/reset adapters,
|
||||||
ADT water pending/task/result pipeline state and loader enqueue/start/publish/
|
ADT water pending/task/result pipeline state and loader enqueue/start/publish/
|
||||||
drain/release/reset/shutdown/metrics adapters,
|
drain/release/reset/shutdown/metrics adapters,
|
||||||
|
stateless ADT water scene finalizer and both loader build/attach 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: worker concurrency and stale-result validation remain
|
- Remaining risks: worker concurrency and stale-result validation remain
|
||||||
streamer-owned; cancellation stops new permits but does not interrupt
|
streamer-owned; cancellation stops new permits but does not interrupt
|
||||||
@@ -213,7 +227,8 @@ Runtime и Editor используют facade; planner/scheduler тестиру
|
|||||||
WMO ResourceLoader/FileAccess I/O, live fallback and group materialization
|
WMO ResourceLoader/FileAccess I/O, live fallback and group materialization
|
||||||
remain in the loader;
|
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;
|
||||||
ADT water parsing, main-thread materialization and active worker interruption
|
ADT water parsing and active worker interruption remain loader-owned;
|
||||||
remain loader-owned, and asset-backed MH2O/MCLQ traversal/leak/p95/p99/
|
materialization is separated but remains synchronous main-thread work behind
|
||||||
|
the existing permit, and asset-backed MH2O/MCLQ traversal/leak/p95/p99/
|
||||||
original-client evidence is pending; M03 still needs further terrain/M2/WMO/
|
original-client evidence is pending; M03 still needs further terrain/M2/WMO/
|
||||||
liquid service extraction and dependency/performance acceptance.
|
liquid service extraction and dependency/performance acceptance.
|
||||||
|
|||||||
Reference in New Issue
Block a user