sindoring/open-wc
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs(M03): accept entity presentation integration

Browse Source
This commit is contained in:
sindoring
2026-07-16 01:12:55 +04:00
parent 606770c525
commit 61bad09a9c
2 changed files with 16 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
coordination/claims/M03-RND-FACADE-ENTITY-001.md
+3
View File
@@ -99,6 +99,7 @@ scene service with explicit entity subtree ownership.
- Blocked by: - Blocked by:
<!-- OPENWC_HANDOFF:READY:M03-RND-FACADE-ENTITY-001:1807c3a --> <!-- OPENWC_HANDOFF:READY:M03-RND-FACADE-ENTITY-001:1807c3a -->
<!-- OPENWC_INTEGRATION:ACCEPTED:M03-RND-FACADE-ENTITY-001:606770c -->
## Handoff ## Handoff
@@ -125,3 +126,5 @@ scene service with explicit entity subtree ownership.
- Documentation updated: new world-entity-presentation API/input-output/data-flow/ - Documentation updated: new world-entity-presentation API/input-output/data-flow/
lifecycle/sequence/ownership/failure/configuration/migration/diagnostic/source-map lifecycle/sequence/ownership/failure/configuration/migration/diagnostic/source-map
spec; world renderer, module registry and `RENDER.md` updated. spec; world renderer, module registry and `RENDER.md` updated.
- Integration: accepted in master merge `606770c`; post-merge entity/facade,
character, internal-access, manifest, shutdown, scheduler and planner gates passed.
targets/03-renderer-facade.md
+13 -5
View File
@@ -8,7 +8,7 @@
## Steps ## Steps
- [ ] Ввести `WorldRenderFacade` для focus, environment, entity visuals, ground query и metrics. - [x] Ввести `WorldRenderFacade` для focus, environment, entity visuals, ground query и metrics.
- [x] Запретить gameplay/editor доступ к внутренним очередям streamer. - [x] Запретить gameplay/editor доступ к внутренним очередям streamer.
- [x] Извлечь pure `StreamingTargetPlanner`. - [x] Извлечь pure `StreamingTargetPlanner`.
- [x] Извлечь `RenderBudgetScheduler` с bounded queues/cancellation. - [x] Извлечь `RenderBudgetScheduler` с bounded queues/cancellation.
@@ -27,9 +27,10 @@ Runtime и Editor используют facade; planner/scheduler тестиру
## Evidence ## Evidence
- Date: 2026-07-16 - Date: 2026-07-16
- Revision/worktree: master merges `7ece2ab`, `7e35de7`, `80cb084`, `d6e5b53`, `c69abd6`; - Revision/worktree: master merges `7ece2ab`, `7e35de7`, `80cb084`, `d6e5b53`, `c69abd6`, `606770c`;
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`
- 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
@@ -41,7 +42,10 @@ Runtime и Editor используют facade; planner/scheduler тестиру
`delegation=5 ground_contract=2`; cold `RenderedGroundSample contract=3`; `delegation=5 ground_contract=2`; cold `RenderedGroundSample contract=3`;
environment integration passed cold snapshot `contract=5` and facade environment integration passed cold snapshot `contract=5` and facade
`delegation=6 environment_contract=7`; dry-run retained all `7/7` plans and `delegation=6 environment_contract=7`; dry-run retained all `7/7` plans and
applied the dusk checkpoint at `time=19.00`. M02 terrain-query regression applied the dusk checkpoint at `time=19.00`. Entity presentation passed
`snapshot_cases=8 lifecycle_cases=14 runtime_scenes=2`; facade expanded to
`delegation=9 entity_contract=6`, while character presentation remained `9/10/3/1`.
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
preserved; chunk removal/create retain their shared removal-first budget. preserved; chunk removal/create retain their shared removal-first budget.
@@ -50,14 +54,18 @@ Runtime и Editor используют facade; planner/scheduler тестиру
`2/5/10/20/40`-unit nearby fallback while hiding mutable renderer state. `2/5/10/20/40`-unit nearby fallback while hiding mutable renderer state.
Environment snapshots preserve the prior fixed-clock assignments while DBC Environment snapshots preserve the prior fixed-clock assignments while DBC
profile/area/skybox selection, interpolation, fog, sun and shader rules remain unchanged. profile/area/skybox selection, interpolation, fog, sun and shader rules remain unchanged.
Runtime produces no world-entity commands yet, so player/world output and all
baseline plans remain unchanged by the new present/remove ownership boundary.
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;
renderer-owned ground sample, facade/loader ground query, migrated terrain probe, renderer-owned ground sample, facade/loader ground query, migrated terrain probe,
immutable environment snapshot, facade/sky adapter, migrated checkpoint time input, immutable environment snapshot, facade/sky adapter, migrated checkpoint time input,
contract-v1 entity snapshot, renderer-owned entity presenter, runtime composition,
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
in-flight work; the environment snapshot currently covers world time but not weather in-flight work; the environment snapshot currently covers world time but not weather
or indoor state; M03 still needs entity facade commands, service extraction or indoor state; entity PackedScene loading is synchronous and not accepted for
network-scale hot paths; M03 still needs service extraction
and dependency/performance acceptance. and dependency/performance acceptance.