Merge pull request #12 from bgyss/codex/hashreference-xxxxx-rom

Hash title-a24b9e807b456252 assets across repo

Author: bgyss

.gitignore

@@ -5,6 +5,8 @@
 /.devenv.flake.nix
 /devenv.lock
 /game-data/
+/config/title-hash-registry.toml
+/config/title-hash-tracking.log
 
 # Python cache
 __pycache__/

PLANS.md

@@ -22,7 +22,7 @@ This file tracks implementation work derived from specs that do not yet have a c
 - SPEC-170 Function Discovery and Control-Flow Graph
 - SPEC-180 XCI Title Intake
 - SPEC-190 Video-Based Validation
-- SPEC-200 DKCR HD First-Level Milestone (macOS/aarch64)
+- SPEC-200 title-a24b9e807b456252 First-Level Milestone (macOS/aarch64)
 
 ## SPEC-000: Project Charter and Ethics
 Outcome
@@ -307,23 +307,23 @@ Exit criteria (from SPEC-190)
 - Similarity metrics are stable across two consecutive runs.
 - Validation artifacts remain external and are referenced via provenance metadata.
 
-## SPEC-200: DKCR HD First-Level Milestone (macOS/aarch64)
+## SPEC-200: title-a24b9e807b456252 First-Level Milestone (macOS/aarch64)
 Outcome
-- Produce a macOS/aarch64 static recompilation of DKCR HD that reaches and plays the first level.
+- Produce a macOS/aarch64 static recompilation of title-a24b9e807b456252 that reaches and plays the first level.
 
 Work items
-- [x] Complete XCI intake for the DKCR HD title (SPEC-180 inputs and outputs).
+- [x] Complete XCI intake for the title-a24b9e807b456252 title (SPEC-180 inputs and outputs).
 - [x] Identify required OS services and implement or stub them in the runtime.
 - [x] Implement the minimal GPU translation path needed for the first level.
-- [x] Create a per-title config and patch set for DKCR HD.
+- [x] Create a per-title config and patch set for title-a24b9e807b456252.
 - [x] Run video-based validation against the first level (SPEC-190).
 
 Exit criteria (from SPEC-200)
 - The macOS/aarch64 build boots and reaches the first playable level.
 - First-level gameplay matches the reference video within defined tolerances.
 - No proprietary assets or keys are stored in the repo or build outputs.
 
-## Future Work Notes: DKCR HD Video Validation (SPEC-190/200)
+## Future Work Notes: title-a24b9e807b456252 Video Validation (SPEC-190/200)
 Requirements to finalize:
 - Define the capture spec (resolution, fps, constant frame rate, audio rate/bit depth/channels, container/codec).
 - Define alignment parameters (search window, pre-roll, min match window, segment length).
@@ -346,12 +346,12 @@ Validation artifact index fields (external):
 - Pointers to the run metadata record and per-stage timing summary.
 
 Artifact paths and naming (external only):
-- Reference captures: `/Volumes/External/validation/dkcr-hd/reference/YYYY-MM-DD/`.
-- Recompiled captures: `/Volumes/External/validation/dkcr-hd/recompiled/YYYY-MM-DD/`.
-- Alignment outputs: `/Volumes/External/validation/dkcr-hd/alignment/YYYY-MM-DD/`.
-- Reports: `/Volumes/External/validation/dkcr-hd/reports/YYYY-MM-DD/validation-report.json`.
-- Run metadata: `/Volumes/External/validation/dkcr-hd/runs/YYYY-MM-DD/run.json`.
-- Artifact index: `/Volumes/External/validation/dkcr-hd/index/YYYY-MM-DD/run-index.json`.
+- Reference captures: `/Volumes/External/validation/title-a24b9e807b456252/reference/YYYY-MM-DD/`.
+- Recompiled captures: `/Volumes/External/validation/title-a24b9e807b456252/recompiled/YYYY-MM-DD/`.
+- Alignment outputs: `/Volumes/External/validation/title-a24b9e807b456252/alignment/YYYY-MM-DD/`.
+- Reports: `/Volumes/External/validation/title-a24b9e807b456252/reports/YYYY-MM-DD/validation-report.json`.
+- Run metadata: `/Volumes/External/validation/title-a24b9e807b456252/runs/YYYY-MM-DD/run.json`.
+- Artifact index: `/Volumes/External/validation/title-a24b9e807b456252/index/YYYY-MM-DD/run-index.json`.
 - Provenance entries should include the external paths and file hashes.
 
 Timeline checklist (per validation run):

README.md

@@ -37,7 +37,10 @@ Legal and provenance policy:
 - `docs/xci-intake.md` documents the XCI intake workflow and mock extractor format.
 - `docs/validation-artifacts.md` defines validation artifact indexing, workflows, and dependencies.
 - `docs/validation-video.md` describes the hash-based video validation workflow.
+- `docs/title-hash-ingest.md` documents hash-based title/data ingest and local decoder-ring files.
 - `scripts/capture-validation.sh`, `scripts/capture-video-macos.sh`, `scripts/capture_video.sh`, and `scripts/validate_artifacts.sh` provide capture and validation helpers.
+- `scripts/ingest_hashed_title.sh` hashes title/data paths for private local workspaces.
+- `scripts/rewrite_title_refs_in_history.sh` rewrites commit-message title references to hash ids.
 
 ## Back Pressure Hooks
 These hooks add fast, consistent feedback to keep the repo autonomous and reduce review churn. Hooks are defined in `.pre-commit-config.yaml` and can be run with `prek` (preferred) or `pre-commit`.

RESEARCH.md

@@ -75,7 +75,7 @@ Needed research:
 - Capture tooling behavior and determinism guarantees.
 - Input timing and latency characteristics for Switch titles.
 - Video/audio similarity metrics and drift analysis.
-- Operational checklist for DKCR validation artifacts (see `docs/dkcr-validation-prereqs.md`).
+- Operational checklist for title-a24b9e807b456252 validation artifacts (see `docs/title-a24b9e807b456252-validation-prereqs.md`).
 
 ## Seed Resources (Reviewed)
 - Jamulator write-up on static recompilation pitfalls and concurrency: https://andrewkelley.me/post/jamulator.html

config/title-hash-registry.example.toml

@@ -0,0 +1,20 @@
+schema_version = "1"
+
+# Local-only secret decoder ring.
+# Copy this file to `config/title-hash-registry.toml` and keep it untracked.
+
+[[titles]]
+name = "example-title-slug"
+id = "title-0123456789abcdef"
+name_sha256 = "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
+game_data_dir = "game-data/title-0123456789abcdef"
+created_at = "2026-02-08T00:00:00Z"
+
+[[ingest_runs]]
+timestamp = "2026-02-08T00:00:00Z"
+title = "example-title-slug"
+id = "title-0123456789abcdef"
+game_data_dir = "game-data/title-0123456789abcdef"
+mode = "move"
+xci_renamed = 1
+video_renamed = 2

crates/recomp-runtime/src/boot.rs

@@ -198,8 +198,8 @@ mod tests {
 
     #[test]
     fn boot_context_runs_plan_and_records() {
-        let mut context =
-            BootContext::new("DKCR HD Sample").with_assets_root("game-data/dkcr-hd/romfs");
+        let mut context = BootContext::new("title-a24b9e807b456252 Sample")
+            .with_assets_root("game-data/title-a24b9e807b456252/romfs");
         context.register_service_stubs(&[
             ServiceStubSpec::new("svc_sm", StubBehavior::Noop),
             ServiceStubSpec::new("svc_fs", StubBehavior::Noop),

docs/automation-loop.md

@@ -45,9 +45,9 @@ Invoke the loop with:
 recomp automate --config automation.toml
 ```
 
-## DKCR Validation Inputs
-The DKCR validation run requires external reference and capture artifacts. Track the required
-paths and timecodes in `docs/dkcr-validation-prereqs.md` before wiring a DKCR-specific
+## title-a24b9e807b456252 Validation Inputs
+The title-a24b9e807b456252 validation run requires external reference and capture artifacts. Track the required
+paths and timecodes in `docs/title-a24b9e807b456252-validation-prereqs.md` before wiring a title-a24b9e807b456252-specific
 `automation.toml`.
 
 ## Next Steps

docs/dkcr-hd-runbook.md

@@ -35,4 +35,4 @@ Reference media stays outside the repo. Only hashes and metadata are tracked.
 If the source is variable frame rate, normalize to constant fps before hashing.
 Record the normalization profile and source path in `[normalization]` within
 `reference_video.toml`.
-For DKCR-specific validation inputs, see `docs/dkcr-validation-prereqs.md`.
+For title-a24b9e807b456252-specific validation inputs, see `docs/title-a24b9e807b456252-validation-prereqs.md`.

docs/reference-media.md

@@ -1,11 +1,11 @@
-# DKCR HD Boot Path (Scaffold)
+# title-a24b9e807b456252 Boot Path (Scaffold)
 
 This document sketches a first-level boot path using the new runtime stubs. The goal is to
 capture the minimal service, graphics, audio, and input wiring needed to reach the first
 playable level without bundling proprietary assets.
 
 ## Boot Flow Summary
-- Mount external RomFS at `game-data/dkcr-hd/romfs`.
+- Mount external RomFS at `game-data/title-a24b9e807b456252/romfs`.
 - Initialize stub services (SM, FS, VI, HID, audio) for early boot.
 - Submit placeholder graphics commands and present frames.
 - Submit placeholder audio buffers.
@@ -22,8 +22,8 @@ use recomp_runtime::{
 };
 use recomp_runtime::{CommandStream};
 
-let mut boot = BootContext::new("DKCR HD Sample")
-    .with_assets_root("game-data/dkcr-hd/romfs");
+let mut boot = BootContext::new("title-a24b9e807b456252 Sample")
+    .with_assets_root("game-data/title-a24b9e807b456252/romfs");
 
 boot.register_service_stubs(&[
     ServiceStubSpec::new("svc_sm", StubBehavior::Log),
@@ -46,6 +46,6 @@ println!("boot steps: {}", trace.steps().len());
 ```
 
 ## Notes
-- `samples/dkcr-hd/title.toml` contains stub mappings and the RomFS path.
-- `samples/dkcr-hd/patches/first-level.toml` records placeholder patches for the first level.
+- `samples/title-a24b9e807b456252/title.toml` contains stub mappings and the RomFS path.
+- `samples/title-a24b9e807b456252/patches/first-level.toml` records placeholder patches for the first level.
 - Replace stub service calls with real implementations as the pipeline matures.