113 lines
4.8 KiB
Markdown
113 lines
4.8 KiB
Markdown
# M03-RND-M2-ANIMATION-LOAD-PIPELINE-001 — M2 animation load pipeline state
|
|
|
|
<!-- OPENWC_CLAIM:M03-RND-M2-ANIMATION-LOAD-PIPELINE-001:sindo-main-codex:2026-07-20 -->
|
|
|
|
## Ownership
|
|
|
|
- Target: M03
|
|
- Program: RND
|
|
- Owner/Agent ID: sindo-main-codex
|
|
- Branch: `work/sindo-main-codex/m03-m2-animation-load-pipeline`
|
|
- Lease expires UTC: 2026-07-20
|
|
- Integrator: M03 milestone integrator
|
|
|
|
## Outcome
|
|
|
|
Extract threaded animated-M2 pending request records and completion-order
|
|
finalize FIFO from `StreamingWorldLoader` into an explicit state service.
|
|
|
|
## Non-goals
|
|
|
|
- Call ResourceLoader, select/validate GLB paths or interpret status values.
|
|
- Instantiate/repair/cache animated Nodes or own prototype outcomes.
|
|
- Change animation allow/deny/candidate policy, permits or visible behavior.
|
|
- Add cancellation, persistence, retries, dependencies or cache-format changes.
|
|
|
|
## Paths
|
|
|
|
- Exclusive: `src/render/m2/m2_animation_load_pipeline_state.gd`,
|
|
`src/tools/verify_m2_animation_load_pipeline_state.gd`,
|
|
`docs/modules/m2-animation-load-pipeline-state.md`, this claim
|
|
- Shared/hotspots: `src/scenes/streaming/streaming_world_loader.gd`, M2
|
|
prototype/shutdown/material/build/facade/internal-access/manifest verifiers
|
|
and module specs, `docs/modules/world-renderer.md`, `docs/modules/README.md`,
|
|
`RENDER.md`, `targets/03-renderer-facade.md`
|
|
- Generated/ignored: `.godot`, native DLL, generated M2 resources, caches and
|
|
proprietary renderer corpus
|
|
|
|
## Contracts and data
|
|
|
|
- One non-empty normalized path has at most one pending cache path.
|
|
- Pending snapshots preserve Dictionary insertion order and detach records.
|
|
- Completing a known request moves one copied record with opaque status into a
|
|
completion-order FIFO; unknown/duplicate completion is rejected.
|
|
- Defensive discard removes pending state without creating a finalize record.
|
|
- Total work remains pending plus finalize count at all three historical metrics.
|
|
- Map reset and shutdown retain the same two clear sites; shutdown still drains
|
|
ResourceLoader paths before clear.
|
|
|
|
## Dependencies
|
|
|
|
- Requires: accepted prototype cache package on master `20a64b5`
|
|
- Blocks: animated M2 finalization/materialization service extraction
|
|
- External state: ResourceLoader request statuses remain loader-owned
|
|
|
|
## Verification
|
|
|
|
- Commands: dedicated validation/dedupe/order/transition/discard/snapshot/clear/
|
|
source/timing verifier; prototype/shutdown/material/M2 build/facade/internal-
|
|
access/manifest and adjacent M2 regressions; docs/coordination/dry-run gates
|
|
- Fixtures: synthetic normalized/cache paths and opaque integer statuses
|
|
- Fidelity evidence: request insertion, terminal FIFO, metrics and clear transitions
|
|
- Performance budget: 100 cycles over 256 request completions under 1 second
|
|
|
|
## Documentation deliverables
|
|
|
|
- Inline public API docs
|
|
- Module specification with inputs/outputs, ownership and source map
|
|
- Data-flow, lifecycle/state, sequence and dependency diagrams
|
|
- Adjacent M2/world-renderer/module-registry/RENDER updates
|
|
|
|
## Simplicity and naming
|
|
|
|
- Important name introduced: `M2AnimationLoadPipelineState`
|
|
- Simplest solution: one main-thread RefCounted with pending map and finalize FIFO
|
|
- Rejected complexity: generic Resource pipeline, signals, callbacks, typed
|
|
ResourceLoader enum wrapper, Node ownership or async abstraction
|
|
- Unavoidable complexity: pending insertion order and terminal completion order differ
|
|
- Measured optimization evidence: bounded synthetic transition loop
|
|
|
|
## Status
|
|
|
|
- State: accepted
|
|
- Done: state, loader adapters, lifecycle verifier and required documentation
|
|
- Next: continue animated M2 finalization/materialization extraction
|
|
- Blocked by:
|
|
|
|
## Handoff
|
|
|
|
- Commit: `b8e0f11`
|
|
- Results: animation pipeline passes 11 validation/dedupe/order/transition/FIFO/
|
|
discard/snapshot/source cases and 100-by-256 cycles in 69.798 ms; all 47
|
|
autonomous headless verifiers pass, while the proprietary ADT placement probe
|
|
is unavailable without `data/extracted`; checkpoint dry-run passes 7/7;
|
|
documentation and coordination gates pass; loader-private inventory decreases
|
|
from 31 to 30.
|
|
- Remaining risks: successful animated-GLB traversal, descriptor pressure,
|
|
leaks, animation fidelity and p95/p99 require proprietary data; no paired
|
|
original-client visual comparison is claimed.
|
|
- Documentation updated: inline API; `m2-animation-load-pipeline-state.md` with
|
|
data-flow, lifecycle, sequence and dependency diagrams; prototype/world-renderer
|
|
specs, module registry and `RENDER.md`.
|
|
|
|
<!-- OPENWC_HANDOFF:READY:M03-RND-M2-ANIMATION-LOAD-PIPELINE-001:b8e0f11 -->
|
|
|
|
## Integration
|
|
|
|
- Merge commit: `3dccd3e`
|
|
- Post-merge results: animation pipeline `cases=11 iterations=100
|
|
elapsed_ms=70.309`; prototype state, shutdown, materials, facade,
|
|
internal-access `30`, manifest `7/7`, documentation and coordination gates passed.
|
|
|
|
<!-- OPENWC_INTEGRATION:ACCEPTED:M03-RND-M2-ANIMATION-LOAD-PIPELINE-001:3dccd3e -->
|