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