coord(M03): claim M2 runtime mesh finalizer
Work-Package: M03-RND-M2-RUNTIME-MESH-FINALIZER-001 Agent: sindo-main-codex Tests: coordination gate passed before claim Fidelity: extraction-only package; refresh version and visible behavior unchanged
This commit is contained in:
@@ -0,0 +1,91 @@
|
||||
# M03-RND-M2-RUNTIME-MESH-FINALIZER-001 — M2 runtime mesh finalizer
|
||||
|
||||
<!-- OPENWC_CLAIM:M03-RND-M2-RUNTIME-MESH-FINALIZER-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-runtime-mesh-finalizer`
|
||||
- Lease expires UTC: 2026-07-20
|
||||
- Integrator: M03 milestone integrator
|
||||
|
||||
## Outcome
|
||||
|
||||
Extract stale cached-Mesh refresh classification, metadata adoption,
|
||||
M2Builder rebuild and fallback from `StreamingWorldLoader` into one runtime M2
|
||||
Mesh finalizer while retaining raw-file I/O in the loader.
|
||||
|
||||
## Non-goals
|
||||
|
||||
- Load raw `.m2` files, call FileAccess/ClassDB M2Loader or choose cache paths.
|
||||
- Own ResourceLoader requests, Mesh cache/missing state or MultiMesh builds.
|
||||
- Change material refresh version `2`, classifier predicates or rebuild behavior.
|
||||
- Change cache formats, profiles or visible output.
|
||||
|
||||
## Paths
|
||||
|
||||
- Exclusive: `src/render/m2/m2_runtime_mesh_finalizer.gd`,
|
||||
`src/tools/verify_m2_runtime_mesh_finalizer.gd`,
|
||||
`docs/modules/m2-runtime-mesh-finalizer.md`, this claim
|
||||
- Shared/hotspots: `src/scenes/streaming/streaming_world_loader.gd`, M2
|
||||
classifier/extractor/cache/pipeline/material/shutdown 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
|
||||
|
||||
- Refresh version remains `2`; already-current Meshes return unchanged without raw data.
|
||||
- Stale Meshes require caller-supplied raw data only when refresh is necessary.
|
||||
- Empty/ordinary raw data marks the original Mesh current and returns it.
|
||||
- Billboard/UV-rotation data attempts M2Builder rebuild and returns the rebuilt
|
||||
first Mesh; rebuild failure marks and returns the original Mesh.
|
||||
- Classifier memoization retains both existing clear sites through finalizer clear.
|
||||
|
||||
## Dependencies
|
||||
|
||||
- Requires: accepted Mesh resource extractor package on master `dd8cfbf`
|
||||
- Blocks: further M2 raw-data I/O/prototype state extraction
|
||||
- External state: none; verification uses synthetic Mesh/raw-data fixtures
|
||||
|
||||
## Verification
|
||||
|
||||
- Commands: dedicated current/stale/ordinary/rebuild/fallback/clear/source/timing
|
||||
verifier; classifier/extractor/cache/pipeline/material/shutdown/M2 build/facade/
|
||||
internal-access/manifest, documentation and coordination gates
|
||||
- Fixtures: ArrayMesh and one synthetic triangle/billboard M2 Dictionary
|
||||
- Fidelity evidence: exact refresh version, predicate, rebuild and fallback transitions
|
||||
- Performance budget: 100 cycles over 256 ordinary finalizations 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
|
||||
- Classifier/extractor/cache/pipeline, world-renderer, registry and RENDER updates
|
||||
|
||||
## Simplicity and naming
|
||||
|
||||
- Important name introduced: `M2RuntimeMeshFinalizer`
|
||||
- Simplest solution: one service composing existing classifier/extractor and M2Builder
|
||||
- Rejected complexity: callbacks for loader I/O, generic material pipeline,
|
||||
cache ownership, signals or strategy framework
|
||||
- Unavoidable complexity: two-phase raw-data request avoids loading raw files for current Meshes
|
||||
- Measured optimization evidence: bounded synthetic ordinary finalization loop
|
||||
|
||||
## Status
|
||||
|
||||
- State: claimed
|
||||
- Done: refresh, raw-data boundary, rebuild/fallback and both clear sites identified
|
||||
- Next: implement finalizer, migrate adapters, verify and document
|
||||
- Blocked by:
|
||||
|
||||
## Handoff
|
||||
|
||||
- Commit:
|
||||
- Results:
|
||||
- Remaining risks:
|
||||
- Documentation updated:
|
||||
Reference in New Issue
Block a user