96 lines
4.3 KiB
Markdown
96 lines
4.3 KiB
Markdown
# M03-RND-M2-ANIMATED-INSTANCE-MATERIALIZER-001
|
|
|
|
<!-- OPENWC_CLAIM:M03-RND-M2-ANIMATED-INSTANCE-MATERIALIZER-001:sindo-main-codex:2026-07-20 -->
|
|
|
|
## Owner
|
|
|
|
- Agent ID: `sindo-main-codex`
|
|
- Target: M03 Renderer Facade and Safe Extraction
|
|
- Branch: `work/sindo-main-codex/m03-m2-animated-instance-materializer`
|
|
- Worktree: `C:\Users\sindo\open-wc-worktrees\m03-m2-animated-instance-materializer`
|
|
|
|
## Outcome
|
|
|
|
Extract main-thread animated M2 instance duplication, render-property application,
|
|
playback startup and batch attachment from `StreamingWorldLoader`.
|
|
|
|
## Non-goals
|
|
|
|
- Change build-job cursors, budgets, prototype selection or animation eligibility.
|
|
- Change animation selection, phase, native animator behavior or diagnostic text.
|
|
- Own Editor scene persistence, static MultiMesh materialization or tile cleanup.
|
|
- Change visible transforms, visibility ranges, shadows or placement ordering.
|
|
|
|
## Paths
|
|
|
|
- Exclusive: `src/render/m2/m2_animated_instance_materializer.gd`,
|
|
`src/tools/verify_m2_animated_instance_materializer.gd`,
|
|
`docs/modules/m2-animated-instance-materializer.md`, this claim
|
|
- Shared/hotspots: `src/scenes/streaming/streaming_world_loader.gd`, M2 animation
|
|
playback/finalizer/build/facade/internal-access/manifest verifiers and specs,
|
|
`docs/modules/world-renderer.md`, `docs/modules/README.md`, `RENDER.md`,
|
|
`targets/03-renderer-facade.md`
|
|
- Generated/ignored: `.godot`, native DLL, generated resources/caches and proprietary corpus
|
|
|
|
## Contracts and data
|
|
|
|
- Duplicate flags, names, transforms and input order remain unchanged.
|
|
- Visibility end/margin and shadow mode are applied recursively before attachment.
|
|
- Playback data copy/start delegates to the accepted playback controller contract.
|
|
- The batch is attached only when at least one duplicate succeeds.
|
|
- Loader retains diagnostic formatting/path normalization and Editor ownership.
|
|
|
|
## Dependencies
|
|
|
|
- Requires: accepted playback package on master `5b2d9f2`
|
|
- Blocks: further animated M2 build orchestration extraction
|
|
- External state: Godot Node duplication and SceneTree attachment remain main-thread APIs
|
|
|
|
## Verification
|
|
|
|
- Commands: dedicated duplication/order/render/playback/empty/source/timing verifier;
|
|
M2 animated pipeline/finalizer/playback/prototype/build/shutdown/material/facade/
|
|
internal-access/manifest regressions; docs/coordination/dry-run gates
|
|
- Fixtures: synthetic prototype trees with geometry, AnimationPlayer and native animator
|
|
- Fidelity evidence: exact transforms, flags, render settings, playback delegation and order
|
|
- Performance budget: 1,000 synthetic instances under 1 second
|
|
|
|
## Documentation deliverables
|
|
|
|
- Inline API docs
|
|
- Module spec with inputs/outputs, ownership and source map
|
|
- Data-flow, lifecycle/state, sequence and dependency diagrams
|
|
- Adjacent playback/finalizer/build/world-renderer/module-registry/RENDER updates
|
|
|
|
## Simplicity and naming
|
|
|
|
- Important name introduced: `M2AnimatedInstanceMaterializer`
|
|
- Simplest solution: synchronous main-thread RefCounted returning batch diagnostics
|
|
- Rejected complexity: signals, async queue, callbacks and generic scene factory
|
|
- Unavoidable complexity: imported AnimationPlayer and native animator paths coexist
|
|
- Measured optimization evidence: bounded synthetic batch materialization
|
|
|
|
## Status
|
|
|
|
- State: ready for integration
|
|
- Done: materializer, loader adapter, verifier and required documentation
|
|
- Next: integrator merge and post-merge acceptance
|
|
- Blocked by:
|
|
|
|
## Handoff
|
|
|
|
- Commit: `456f3e2`
|
|
- Results: materializer passes 12 duplication/order/render/playback/diagnostic/
|
|
source cases and 1,000 instances in 9.267 ms; all 50 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 remains 30.
|
|
- Remaining risks: private asset traversal/visual comparison, descriptor
|
|
pressure, leaks and p95/p99 remain unavailable; materialization is still
|
|
synchronous main-thread work and no original-client comparison is claimed.
|
|
- Documentation updated: inline API; `m2-animated-instance-materializer.md`
|
|
with data-flow, lifecycle, sequence and dependency diagrams; playback,
|
|
finalizer, build, world-renderer specs, module registry and `RENDER.md`.
|
|
|
|
<!-- OPENWC_HANDOFF:READY:M03-RND-M2-ANIMATED-INSTANCE-MATERIALIZER-001:456f3e2 -->
|