Convert assets to ozzx/ozz during loading phase POC works

Author: yohjimane

src/xrAnimation/AGENT_DOCS.md

@@ -17,9 +17,10 @@
 - IK limbs and step manager paths now bail out cleanly when an Ozz visual is active, so missing `IKinematicsAnimated` no longer hard-asserts during experiments.
 - `OzzBundleRuntime` regression test hydrates `OzzKinematics` and mesh payloads from a `.ozzx` bundle to guard bundle/runtime parity.
 - Parity/unit tests require the generated `src/xrAnimation/tests/testdata/stalker_hero_1.ozz` and `.ozzx` fixtures; rerun `convert_assets.sh` if they are missing before executing the suites.
+- Startup boot now rebuilds `.ozzx` bundles and `.ozz` animations under `$game_meshes$` / `$game_anims$` when the inventory digest drifts or assets are missing, persisting the fresh digest back to `user.ltx` once conversions succeed.
 
 ## Active Objective
-- Stand up a startup conversion stage that hooks into the level loading flow (after `IGame_Persistent::Prefetch()`), converts any `.ogf/.omf` discovered during prefetch into `.ozz/.ozzx`, and drops the bundles into `gamedata` with progress surfaced via `g_loading_stages`.
+- Surface the new startup conversion stage through the loading UI once localisation strings are ready so players see a "converting Ozz assets" progress step.
 - Harden the MVP: keep converter/runtime parity tests green, expand automation around bundle hydration, and chase down any gameplay regressions surfaced by smoke tests.
 - Gather frame-cost telemetry comparing legacy vs. Ozz paths and publish the results alongside configuration guidance.
 - Capture follow-up requirements (threading, GPU skinning, richer metadata) and turn them into a prioritised roadmap for the next phase.

src/xrAnimation/AGENT_NEXT_STEPS.md

@@ -8,9 +8,8 @@
 
 ## Post-MVP Focus
 1. **Startup Conversion Stage**
-   - Introduce a loading-stage hook that runs after the existing object/model prefetch to walk legacy `.ogf/.omf` assets, invoke the converter, and persist `.ozz/.ozzx` bundles into `gamedata`.
-   - Surface the stage through `g_loading_stages` so players/devs can track progress, and ensure the UI copy reflects the new work.
-   - Coordinate with asset caches to avoid duplicate loads, respect `-noprefetch`, and fall back gracefully when conversion fails or assets are already cached.
+   - Polish the new conversion pass (already invoked from `OnGameStart`) by surfacing progress through `g_loading_stages`, enriching diagnostics, and ensuring failures fall back cleanly to legacy assets.
+   - Coordinate with asset caches to avoid duplicate loads, respect `-noprefetch`, and keep rebuilds idempotent when outputs already exist.
 2. **Stability & Regression Automation**
    - Keep the converter/runtime suites green, add smoke coverage for newly converted startup bundles, and automate checks that guard palette/visibility behaviour.
 3. **Telemetry & Documentation**

src/xrAnimation/CMakeLists.txt

@@ -36,11 +36,18 @@ set(SOURCES
     OzzKinematics.h
     StartupConversionInventory.cpp
     StartupConversionInventory.h
+    ../../Externals/ozz-animation/samples/framework/mesh.cc
 )
 
 # Create static library
 add_library(xrAnimation STATIC ${SOURCES})
 
+set_source_files_properties(
+    ../../Externals/ozz-animation/samples/framework/mesh.cc
+    PROPERTIES
+        SKIP_PRECOMPILE_HEADERS ON
+)
+
 # Link libraries
 target_link_libraries(xrAnimation
     PRIVATE

src/xrAnimation/STARTUP_CONVERSION_STAGE.md

@@ -8,7 +8,7 @@ Stand up a level-loading stage that converts legacy `.ogf/.omf` assets into `.oz
 - Motions are discovered directly from the `.ogf` references; the inventory crawls the same visual roots for `.omf` payloads, capturing metadata (root alias, relative path, size, timestamp, VFS flag).
 - `ComputeLegacyAssetInventoryDigest` folds the full inventory (visual sources + motion metadata) into a deterministic CRC32 digest. `Load/StoreInventoryDigestInUserConfig` persist that digest inside `user.ltx` so we can tell whether the startup scan matches the last cached run.
 - `LegacyOgfConverter` exposes `ConvertLegacyVisualToOzzBundle` so runtime callers and the CLI share identical conversion code paths.
-- `CGamePersistent::OnGameStart()` now loads the cached digest from `user.ltx` whenever `g_use_ozz_visuals` is enabled (and prefetching is active), recomputes the inventory, and logs whether the digest matches. This wiring is the precursor to the conversion pass.
+- `CGamePersistent::OnGameStart()` now loads the cached digest from `user.ltx`, verifies that previously generated `.ozzx`/`.ozz` artefacts exist, and triggers a rebuild (writing outputs under `$game_meshes$`/`$game_anims$`) whenever the digest changes or assets are missing. Successful runs persist the freshly computed digest for subsequent boots.
 - `test_startup_conversion.cpp` exercises inventory construction, digest stability, digest invalidation on asset edits, and digest persistence round-tripping through an `.ltx` file.
 
 ## Inventory Builder
@@ -24,9 +24,8 @@ Stand up a level-loading stage that converts legacy `.ogf/.omf` assets into `.oz
 - After successfully processing the queue, write the new digest back to `user.ltx` so the next boot can skip the heavy scan.
 
 ## Outstanding Integration Work
-- Trigger the conversion stage from `CGamePersistent::OnGameStart()` once the digest reports a mismatch, enqueueing `.ogf/.omf` work and surfacing progress via the loading screen.
+- Surface progress through the loading screen (`LoadTitle`/`LoadStage`) once localisation strings are in place so the UI communicates the new conversion work clearly.
 - After wiring the conversion jobs, verify bundle timestamps before writing new digests so we only persist once outputs are safely on disk. Continue to fallback gracefully to legacy visuals when conversion fails and emit clear telemetry for mismatched assets.
-- Define the output locations for generated skeletons/bundles (most likely under `$gamedata$`) and ensure the stage mirrors the legacy directory structure when writing `.ozz/.ozzx` artefacts.
 - Record per-asset timings so we can report aggregate conversion costs and feed the legacy vs. Ozz frame-cost telemetry workstream.
 - Extend console/debug tooling to dump the current digest, force regeneration, or purge cached bundles when investigating asset issues.