Files

T

sindoring 951bd54fff 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

2026-07-17 14:54:16 +04:00

3.6 KiB

Raw Blame History

M03-RND-M2-RUNTIME-MESH-FINALIZER-001 — M2 runtime mesh finalizer

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:

3.6 KiB Raw Blame History