refactor(M03): extract raw M2 model repository

docs/modules/m2-runtime-mesh-finalizer.md

@@ -29,7 +29,7 @@ UV-rotation cases and returning the historical original-Mesh fallback.
 flowchart LR
     Extractor[M2MeshResourceExtractor] --> Loader[StreamingWorldLoader]
     Loader -->|is raw data required?| Finalizer[M2RuntimeMeshFinalizer]
-    Loader --> Raw[M2Loader raw Dictionary]
+    Loader --> Raw[M2RawModelRepository]
     Raw --> Finalizer
     Finalizer --> Classifier[M2RuntimeMeshRebuildClassifier]
     Finalizer --> Builder[M2Builder]
@@ -55,7 +55,7 @@ Nodes outside temporary rebuild roots and other application layers are forbidden
 | Direction | Contract/data | Producer | Consumer | Ownership | Thread/lifetime |
 |---|---|---|---|---|---|
 | Input | Extracted Mesh and normalized M2 path | Loader/extractor adapter | Finalizer | Borrowed Mesh reference/String copy | One call |
-| Input | Already-loaded raw M2 Dictionary | Loader raw-file boundary | Classifier/M2Builder | Caller-owned value container | One call |
+| Input | Already-loaded raw M2 Dictionary | `M2RawModelRepository` through loader adapter | Classifier/M2Builder | Caller-owned value container | One call |
 | Input | Extracted directory path | Loader configuration | M2Builder texture resolution | Copied String | One rebuild |
 | Output | Original or rebuilt current Mesh | Finalizer | Cache/prototype adapter | Borrowed/new Resource reference | Cache may retain |
 
@@ -68,7 +68,7 @@ M2Builder prototype creation/destruction during required rebuilds.
 flowchart TD
     Mesh[Extracted Mesh] --> Current{Refresh version >= 2?}
     Current -->|yes| ReturnOriginal[Return original unchanged]
-    Current -->|no| NeedRaw[Loader supplies raw M2 data]
+    Current -->|no| NeedRaw[Repository supplies raw M2 data through loader]
     NeedRaw --> HasData{Raw data available?}
     HasData -->|no| Mark[Mark original version 2]
     HasData -->|yes| Classify{Billboard or UV rotation?}
@@ -111,7 +111,7 @@ sequenceDiagram
         Finalizer-->>Loader: false; reuse Mesh
     else stale Mesh
         Finalizer-->>Loader: true
-        Loader->>Raw: load raw Dictionary
+        Loader->>Raw: load static raw Dictionary
         Loader->>Finalizer: finalize_mesh(path, mesh, raw, extracted dir)
         Finalizer->>Classifier: needs_runtime_mesh_rebuild(path, raw)
         opt rebuild required
@@ -130,7 +130,7 @@ flowchart TB
     Finalizer --> Classifier[M2RuntimeMeshRebuildClassifier]
     Finalizer --> Extractor[M2MeshResourceExtractor]
     Finalizer --> Builder[M2Builder]
-    Loader --> Raw[FileAccess / ClassDB M2Loader]
+    Loader --> Raw[M2RawModelRepository]
     Loader --> Cache[M2MeshResourceCacheState]
     Finalizer -. no dependency .-> Raw
     Finalizer -. no dependency .-> Cache
@@ -139,7 +139,7 @@ flowchart TB
 ## Ownership, threading and resources
 
 - Renderer main thread executes metadata changes and M2Builder work.
-- Loader owns raw M2 file existence/load calls and supplies value data.
+- `M2RawModelRepository` owns raw M2 file/native calls; loader supplies its value result.
 - Finalizer owns classifier memoization and temporary rebuild prototype lifetime.
 - M2Builder owns construction rules; extractor selects the first rebuilt Mesh.
 - Cache/prototype adapters decide where the returned Mesh reference is retained.
@@ -183,8 +183,8 @@ logs/queue metrics are unchanged. Normalized M2 path remains the correlation key
 
 ## Extension points
 
-- Raw M2 file loading may later move behind a dedicated repository without
-  changing the finalizer's value-data contract.
+- Asset-backed fixture coverage can be added without changing the finalizer's
+  value-data contract.
 - Refresh versions above `2` require explicit cache/fidelity evidence and docs.
 
 ## Capability status
@@ -193,7 +193,7 @@ logs/queue metrics are unchanged. Normalized M2 path remains the correlation key
 |---|---|---|---|
 | Runtime Mesh refresh/fallback | Implemented extraction | Synthetic transition/rebuild verifier | Asset-backed corrupt/stale cache pending |
 | Rebuild predicate | Implemented extraction dependency | Classifier fixtures | Original-client material comparison pending |
-| Raw M2 refresh I/O | Existing loader-owned | Source boundary | Separate repository extraction optional |
+| Raw M2 refresh I/O | Implemented repository dependency | Repository source/invalid verifier | Legal success fixture pending |
 
 ## Known gaps and risks
 
@@ -207,7 +207,8 @@ logs/queue metrics are unchanged. Normalized M2 path remains the correlation key
 | Path | Responsibility |
 |---|---|
 | `src/render/m2/m2_runtime_mesh_finalizer.gd` | Refresh version, classification, rebuild and fallback |
-| `src/scenes/streaming/streaming_world_loader.gd` | Raw-file I/O and returned-Mesh adoption |
+| `src/render/m2/m2_raw_model_repository.gd` | Raw-file/native I/O and Dictionary result |
+| `src/scenes/streaming/streaming_world_loader.gd` | Repository call and returned-Mesh adoption |
 | `src/render/m2/m2_runtime_mesh_rebuild_classifier.gd` | Memoized billboard/UV-rotation predicate |
 | `src/render/m2/m2_mesh_resource_extractor.gd` | First rebuilt-Mesh selection |
 | `src/tools/verify_m2_runtime_mesh_finalizer.gd` | Transition/rebuild/boundary/timing regression |
@@ -217,6 +218,7 @@ logs/queue metrics are unchanged. Normalized M2 path remains the correlation key
 - [`m2-runtime-mesh-rebuild-classifier.md`](m2-runtime-mesh-rebuild-classifier.md)
 - [`m2-mesh-resource-extractor.md`](m2-mesh-resource-extractor.md)
 - [`m2-mesh-resource-cache-state.md`](m2-mesh-resource-cache-state.md)
+- [`m2-raw-model-repository.md`](m2-raw-model-repository.md)
 - [`world-renderer.md`](world-renderer.md)
 - [`../../RENDER.md`](../../RENDER.md)
 - [`../../targets/roadmap/02-rendering-and-graphics.md`](../../targets/roadmap/02-rendering-and-graphics.md)