diff --git a/Mimir Vault.md b/Mimir Vault.md index ec25b5d..391756a 100644 --- a/Mimir Vault.md +++ b/Mimir Vault.md @@ -6,47 +6,47 @@ corpus. ## Start Here -- [README](README.md) -- [Current System Map](notes/current-system-map.md) -- [Fresh Workspace Handoff](notes/fresh-workspace-handoff.md) -- [Implementation Plan](docs/implementation-plan.md) -- [Code Algorithm Map](docs/code-algorithm-map.md) -- [Perfect Machine Domain Index](docs/perfect-machine-domain-index.md) +- [[README]] +- [[notes/current-system-map|Current System Map]] +- [[notes/fresh-workspace-handoff|Fresh Workspace Handoff]] +- [[docs/implementation-plan|Implementation Plan]] +- [[docs/code-algorithm-map|Code Algorithm Map]] +- [[docs/perfect-machine-domain-index|Perfect Machine Domain Index]] ## Live Architecture -- [Architecture](docs/architecture.md) -- [Perfect Machine](docs/perfect-machine.md) -- [Viable Stream App](docs/viable-stream-app.md) -- [Audio Field](docs/audio-field.md) -- [Sensor Fusion Architecture](docs/sensor-fusion-architecture.md) -- [Native Rebuild Plan](docs/native-rebuild-plan.md) -- [Native Capture Cadence](docs/native-capture-cadence.md) -- [Fensalir Spatial Audio](docs/fensalir-spatial-audio.md) +- [[docs/architecture|Architecture]] +- [[docs/perfect-machine|Perfect Machine]] +- [[docs/viable-stream-app|Viable Stream App]] +- [[docs/audio-field|Audio Field]] +- [[docs/sensor-fusion-architecture|Sensor Fusion Architecture]] +- [[docs/native-rebuild-plan|Native Rebuild Plan]] +- [[docs/native-capture-cadence|Native Capture Cadence]] +- [[docs/fensalir-spatial-audio|Fensalir Spatial Audio]] ## Current Deep Study -- [Study Reading Guide](research/perfect-machine-study-2026-05-23/reading-guide.md) -- [Study Index](research/perfect-machine-study-2026-05-23/index.md) -- [Research Claims Digest](research/perfect-machine-study-2026-05-23/research-claims-digest.md) -- [Implementation Roadmap](research/perfect-machine-study-2026-05-23/implementation-roadmap.md) -- [Benchmark Plan](research/perfect-machine-study-2026-05-23/benchmark-plan.md) -- [Calibration Session Spec](research/perfect-machine-study-2026-05-23/calibration-session-spec.md) -- [Fensalir Integration Map](research/perfect-machine-study-2026-05-23/fensalir-integration-map.md) -- [Native Boundary Map](research/perfect-machine-study-2026-05-23/native-boundary-map.md) +- [[research/perfect-machine-study-2026-05-23/reading-guide|Study Reading Guide]] +- [[research/perfect-machine-study-2026-05-23/index|Study Index]] +- [[research/perfect-machine-study-2026-05-23/research-claims-digest|Research Claims Digest]] +- [[research/perfect-machine-study-2026-05-23/implementation-roadmap|Implementation Roadmap]] +- [[research/perfect-machine-study-2026-05-23/benchmark-plan|Benchmark Plan]] +- [[research/perfect-machine-study-2026-05-23/calibration-session-spec|Calibration Session Spec]] +- [[research/perfect-machine-study-2026-05-23/fensalir-integration-map|Fensalir Integration Map]] +- [[research/perfect-machine-study-2026-05-23/native-boundary-map|Native Boundary Map]] ## Research Archives -- [Research Index](research/README.md) -- [Chirplet Sync Decoder](research/chirplet-sync-decoder/summary.md) -- [Live Adaptive Sync](research/live-adaptive-sync/summary.md) -- [GPU Fusion Splatting](research/gpu-fusion-splatting/summary.md) -- [Visual Spatial Map](research/visual-spatial-map/summary.md) -- [Ambisonic AquaSynth](research/ambisonic-aquasynth/summary.md) -- [Feedback Calibration](research/feedback-calibration/summary.md) -- [Playback Calibration](research/playback-calibration/summary.md) -- [Spout OBS Bridge](research/spout-obs-bridge/summary.md) +- [[research/README|Research Index]] +- [[research/chirplet-sync-decoder/summary|Chirplet Sync Decoder]] +- [[research/live-adaptive-sync/summary|Live Adaptive Sync]] +- [[research/gpu-fusion-splatting/summary|GPU Fusion Splatting]] +- [[research/visual-spatial-map/summary|Visual Spatial Map]] +- [[research/ambisonic-aquasynth/summary|Ambisonic AquaSynth]] +- [[research/feedback-calibration/summary|Feedback Calibration]] +- [[research/playback-calibration/summary|Playback Calibration]] +- [[research/spout-obs-bridge/summary|Spout OBS Bridge]] ## Persistence And Identity -- [Mimir Face](docs/mimir-face.md) +- [[docs/mimir-face|Mimir Face]] diff --git a/docs/audio-field.md b/docs/audio-field.md index e84286c..5767d2f 100644 --- a/docs/audio-field.md +++ b/docs/audio-field.md @@ -99,13 +99,17 @@ and separate from the louder chirp-only lab gain. Research notes: -- `research/chirplet-sync-decoder/summary.md` explains why the hot hybrid path +- [[research/chirplet-sync-decoder/summary|Chirplet Sync Decoder Summary]] + explains why the hot hybrid path moved from dense chirplet matching to dechirp plus FFT/Goertzel bin decoding. -- `research/chirplet-sync-decoder/bibliography.md` links the mirrored chirplet, +- [[research/chirplet-sync-decoder/bibliography|Chirplet Sync Decoder Bibliography]] + links the mirrored chirplet, LoRa/chirp-decoder, and fast-transform references. -- `research/live-adaptive-sync/summary.md` covers passive program-audio sync, +- [[research/live-adaptive-sync/summary|Live Adaptive Sync Summary]] covers + passive program-audio sync, GCC-PHAT, and sample-rate-offset estimation. -- `research/feedback-calibration/summary.md` covers online speaker/room/mic +- [[research/feedback-calibration/summary|Feedback Calibration Summary]] covers + online speaker/room/mic response calibration. ## Next Cut diff --git a/docs/code-algorithm-map.md b/docs/code-algorithm-map.md index 2a954c0..14c591c 100644 --- a/docs/code-algorithm-map.md +++ b/docs/code-algorithm-map.md @@ -3,7 +3,7 @@ ## What This File Is This is a source-grounded map of the code currently in this repo. It follows the -style of `repixelizer/docs/lean-optimizer-algorithm-map.md`: stage-oriented, +stage-oriented map style from the Repixelizer optimizer notes: plain about ownership, and explicit about which blocks deserve to live. Generated build trees under `native/**/build/` are not mapped as source. Stored @@ -1410,17 +1410,24 @@ Live role: Linked notes: -- `research/chirplet-sync-decoder/summary.md`: why the active path moved from +- [[research/chirplet-sync-decoder/summary|Chirplet Sync Decoder Summary]]: + why the active path moved from dense chirplet matching to dechirp plus FFT/Goertzel-style bin classification. -- `research/chirplet-sync-decoder/bibliography.md`: chirplet, LoRa/CSS, and +- [[research/chirplet-sync-decoder/bibliography|Chirplet Sync Decoder Bibliography]]: + chirplet, LoRa/CSS, and transform references. -- `research/live-adaptive-sync/summary.md`: passive timing, drift, and SRO. -- `research/feedback-calibration/summary.md`: room/speaker/mic calibration. -- `research/perfect-machine-hypotheses/summary.md`: hypotheses added by this +- [[research/live-adaptive-sync/summary|Live Adaptive Sync Summary]]: passive + timing, drift, and SRO. +- [[research/feedback-calibration/summary|Feedback Calibration Summary]]: + room/speaker/mic calibration. +- [[research/perfect-machine-hypotheses/summary|Perfect Machine Hypotheses]]: + hypotheses added by this documentation pass. -- `docs/perfect-machine-domain-index.md`: indexed domain map for future +- [[perfect-machine-domain-index|Perfect Machine Domain Index]]: indexed + domain map for future implementation passes. -- `research/perfect-machine-study-2026-05-23/`: architecture rumination, +- [[research/perfect-machine-study-2026-05-23/index|Perfect Machine Study Index]]: + architecture rumination, optimization ledger, references, and sample implementation sketches. Hypotheses: @@ -1453,7 +1460,8 @@ Hypotheses: This map describes the repo's code shape. It is not a replacement for: -- `docs/audio-field.md` for the audio-side algorithm and measurement narrative. -- `docs/native-capture-cadence.md` for camera/USB evidence. -- `docs/implementation-plan.md` for current build plan. +- [[audio-field|Audio Field]] for the audio-side algorithm and measurement + narrative. +- [[native-capture-cadence|Native Capture Cadence]] for camera/USB evidence. +- [[implementation-plan|Implementation Plan]] for current build plan. - `state/map.yaml` for canonical repo state. diff --git a/docs/implementation-plan.md b/docs/implementation-plan.md index 2f3d932..15bf77e 100644 --- a/docs/implementation-plan.md +++ b/docs/implementation-plan.md @@ -3,9 +3,9 @@ ## Current Cut Line Mimir is now a C# app/runtime plus native reservoir project. The live stream -machine must be direct-driver and native-buffer first: +machine must be direct-driver and native-buffer first. -For the source-level ownership map, read `docs/code-algorithm-map.md`. +For the source-level ownership map, read [[code-algorithm-map|Code Algorithm Map]]. - `src/Mimir.App` hosts Fensalir for windowing, rendering, and the D3D12 bridge. diff --git a/docs/mimir-face.md b/docs/mimir-face.md index 34f3ce0..3c9ea4d 100644 --- a/docs/mimir-face.md +++ b/docs/mimir-face.md @@ -135,8 +135,9 @@ temptation to call a pile of moving parts a system. When VoidBot wakes Mimir for a heartbeat: -1. Read `state/map.yaml`, `notes/fresh-workspace-handoff.md`, - `notes/current-system-map.md`, and `docs/implementation-plan.md`. +1. Read `state/map.yaml`, [[notes/fresh-workspace-handoff|Fresh Workspace Handoff]], + [[notes/current-system-map|Current System Map]], and + [[implementation-plan|Implementation Plan]]. 2. Check `git status --short --branch`. 3. Read the tail of `state/evidence.jsonl`. 4. Report only meaningful drift, completed work, blockers, or next bounded diff --git a/docs/obs-receiver-setup.md b/docs/obs-receiver-setup.md index ebaa3bd..ae4684b 100644 --- a/docs/obs-receiver-setup.md +++ b/docs/obs-receiver-setup.md @@ -31,7 +31,7 @@ OBS should be open before the sender starts if OBS is the SRT listener. If a sou ## V1 Smoke Gate Before adding receiver plugins, native OBS surfaces, or new bridge elegance, run -the bounded witness ledger in `docs/obs-v1-smoke-test.md`. +the bounded witness ledger in [[obs-v1-smoke-test|OBS V1 Smoke Test]]. The required artifact is: diff --git a/docs/perfect-machine-domain-index.md b/docs/perfect-machine-domain-index.md index 7a5a0c6..992c3aa 100644 --- a/docs/perfect-machine-domain-index.md +++ b/docs/perfect-machine-domain-index.md @@ -8,26 +8,29 @@ open architectural cut. Read this with: -- `docs/code-algorithm-map.md` for source-level ownership. -- `docs/audio-field.md` for current audio sync narrative. -- `docs/perfect-machine-full-field.md` for the article-form full-field vision: +- [[code-algorithm-map|Code Algorithm Map]] for source-level ownership. +- [[audio-field|Audio Field]] for current audio sync narrative. +- [[perfect-machine-full-field|The Perfect Machine Full Field]] for the + article-form full-field vision: direct/network cameras, microphones, tracked phones, glowing markers, chirplet room mapping, motion capture, and the spatiotemporal reservoir. -- `docs/native-capture-cadence.md` for measured camera/USB evidence. -- `research/perfect-machine-study-2026-05-23/architecture-rumination.md` for - the long-form design argument. -- `research/perfect-machine-study-2026-05-23/index.md` for the study directory - and sample-code index. -- `research/perfect-machine-study-2026-05-23/reading-guide.md` for task-oriented - navigation through the study. -- `research/perfect-machine-study-2026-05-23/optimization-ledger.md` for hot +- [[native-capture-cadence|Native Capture Cadence]] for measured camera/USB + evidence. +- [[research/perfect-machine-study-2026-05-23/architecture-rumination|Architecture Rumination]] + for the long-form design argument. +- [[research/perfect-machine-study-2026-05-23/index|Perfect Machine Study Index]] + for the study directory and sample-code index. +- [[research/perfect-machine-study-2026-05-23/reading-guide|Reading Guide]] for + task-oriented navigation through the study. +- [[research/perfect-machine-study-2026-05-23/optimization-ledger|Optimization Ledger]] + for hot loop candidates. -- `research/perfect-machine-study-2026-05-23/fensalir-integration-map.md` for - the Mimir/Fensalir ownership cut. -- `research/perfect-machine-study-2026-05-23/calibration-session-spec.md` for - the planned physical-path calibration command. -- `research/perfect-machine-study-2026-05-23/samples/README.md` for sample - implementation sketches. +- [[research/perfect-machine-study-2026-05-23/fensalir-integration-map|Fensalir Integration Map]] + for the Mimir/Fensalir ownership cut. +- [[research/perfect-machine-study-2026-05-23/calibration-session-spec|Calibration Session Spec]] + for the planned physical-path calibration command. +- [[research/perfect-machine-study-2026-05-23/samples/README|Sample Implementation Sketches]] + for sample implementation sketches. ## One-Sentence Machine diff --git a/docs/perfect-machine.md b/docs/perfect-machine.md index efc87c5..0ee47aa 100644 --- a/docs/perfect-machine.md +++ b/docs/perfect-machine.md @@ -9,7 +9,7 @@ OBS output. For the larger public-facing field article that includes direct and networked cameras, tracked smartphones, glowing motion-capture markers, chirplet room mapping, and the shared spatiotemporal reservoir, read -[`perfect-machine-full-field.md`](perfect-machine-full-field.md). +[[perfect-machine-full-field|The Perfect Machine Full Field]]. The product is not a pile of bridge scripts. The product is a coherent live volumetric field with explicit owners: visual evidence becomes Fensalir sensor diff --git a/index.md b/index.md index 574bc3a..2580d5d 100644 --- a/index.md +++ b/index.md @@ -5,8 +5,8 @@ signals, and runtime evidence pulled into one coherent OBS-facing surface. ## Start Here -- [Current System Map](notes/current-system-map.md) -- [Perfect Machine Domain Index](docs/perfect-machine-domain-index.md) -- [Code Algorithm Map](docs/code-algorithm-map.md) -- [Implementation Plan](docs/implementation-plan.md) -- [Study Reading Guide](research/perfect-machine-study-2026-05-23/reading-guide.md) +- [[notes/current-system-map|Current System Map]] +- [[docs/perfect-machine-domain-index|Perfect Machine Domain Index]] +- [[docs/code-algorithm-map|Code Algorithm Map]] +- [[docs/implementation-plan|Implementation Plan]] +- [[research/perfect-machine-study-2026-05-23/reading-guide|Study Reading Guide]] diff --git a/notes/current-system-map.md b/notes/current-system-map.md index b37baf3..4703bcc 100644 --- a/notes/current-system-map.md +++ b/notes/current-system-map.md @@ -1,7 +1,8 @@ # Current System Map -Source-level code ownership is mapped in `docs/code-algorithm-map.md`. -The indexed problem-domain map is `docs/perfect-machine-domain-index.md`; the +Source-level code ownership is mapped in [[docs/code-algorithm-map|Code Algorithm Map]]. +The indexed problem-domain map is +[[docs/perfect-machine-domain-index|Perfect Machine Domain Index]]; the current architecture/optimization/sample-code study lives under `research/perfect-machine-study-2026-05-23/`. @@ -9,7 +10,8 @@ Mimir is the public Face and product name for this repo. A few lower native ABI names still use `localcast` until a deliberate rename cut exists. The live target is the native rolling field machine described in -`docs/native-rebuild-plan.md`, `docs/perfect-machine.md`, and +[[docs/native-rebuild-plan|Native Rebuild Plan]], +[[docs/perfect-machine|Perfect Machine]], and `config/perfect-machine.example.json`. ## Perfect Machine Target @@ -46,10 +48,10 @@ No private history outlives the rolling buffer. ## Viable Stream App -`docs/viable-stream-app.md` defines the near-term app target. Fensalir hosts the -running Mimir app, keeps the default five-second runtime in memory, exposes -debug/settings/output controls, and emits synchronized OBS program video plus -separately controllable audio stems. +[[docs/viable-stream-app|Viable Stream App]] defines the near-term app target. +Fensalir hosts the running Mimir app, keeps the default five-second runtime in +memory, exposes debug/settings/output controls, and emits synchronized OBS +program video plus separately controllable audio stems. `Mimir.Runtime` currently provides: diff --git a/notes/fresh-workspace-handoff.md b/notes/fresh-workspace-handoff.md index 112814d..df2766d 100644 --- a/notes/fresh-workspace-handoff.md +++ b/notes/fresh-workspace-handoff.md @@ -18,7 +18,7 @@ Get-Content .\state\evidence.jsonl -Tail 8 ## Current Shape - Public brand/Face is Mimir. -- Mimir's Face doctrine lives in `docs/mimir-face.md`. +- Mimir's Face doctrine lives in [[docs/mimir-face|Mimir Face]]. - VoidBot persona/state live under `.voidbot/voice/` and `.voidbot/state/`. Commit `.voidbot` dirt in a separate state commit whenever it appears. - V1 still has FFmpeg/SRT/OBS bridge utilities for LAN ingest. @@ -28,14 +28,15 @@ Get-Content .\state\evidence.jsonl -Tail 8 - `src/Mimir.Runtime` owns `MimirSynchronizationHub`, configurable five-second rolling buffers, stream descriptors, source adapters, direct native ingest, audio chirplet delay estimation, and the video capture driver seam. -- `docs/code-algorithm-map.md` and `docs/perfect-machine-domain-index.md` are +- [[docs/code-algorithm-map|Code Algorithm Map]] and + [[docs/perfect-machine-domain-index|Perfect Machine Domain Index]] are the fastest re-entry maps for source ownership and problem-domain cuts. - `research/perfect-machine-study-2026-05-23/` contains the architecture rumination, optimization ledger, references, boundary maps, benchmark plan, calibration-session spec, distributed receiver spec, failure ledger, data dictionary, low-level implementation notes, and sample code sketches for the next decoder/DSP/native-ring/Fensalir implementation passes. Start with - `research/perfect-machine-study-2026-05-23/reading-guide.md`. + [[research/perfect-machine-study-2026-05-23/reading-guide|Reading Guide]]. - Local six-camera ingest should use direct driver adapters. Process-backed sources are bridge/network edges only. - Leap stereo IR is the first timing-camera candidate for direct ingest. diff --git a/research/README.md b/research/README.md index 74f8ee4..dd76103 100644 --- a/research/README.md +++ b/research/README.md @@ -18,14 +18,18 @@ Use it to shape native implementation decisions: Audio timing research entry points: -- `chirplet-sync-decoder/summary.md`: chirplet transform notes, why dense +- [[chirplet-sync-decoder/summary|Chirplet Sync Decoder Summary]]: chirplet + transform notes, why dense matched-filter search was cut from the hybrid hot path, and the current dechirp plus FFT/Goertzel decoder shape. -- `live-adaptive-sync/summary.md`: passive program-audio synchronization and +- [[live-adaptive-sync/summary|Live Adaptive Sync Summary]]: passive + program-audio synchronization and sample-rate-offset estimation. -- `feedback-calibration/summary.md`: online room/speaker/mic response +- [[feedback-calibration/summary|Feedback Calibration Summary]]: online + room/speaker/mic response calibration. -- `ambisonic-aquasynth/summary.md`: spatial audio and Ambisonic reference +- [[ambisonic-aquasynth/summary|Ambisonic AquaSynth Summary]]: spatial audio + and Ambisonic reference material; useful background, not a license to call unsynchronized mics a coherent field. diff --git a/research/perfect-machine-study-2026-05-23/index.md b/research/perfect-machine-study-2026-05-23/index.md index d5d1a5b..d0104b8 100644 --- a/research/perfect-machine-study-2026-05-23/index.md +++ b/research/perfect-machine-study-2026-05-23/index.md @@ -10,36 +10,36 @@ needs the reason a cut exists. | File | Use It For | | --- | --- | -| `architecture-rumination.md` | System ownership, current machine critique, coherent next cuts. | -| `optimization-ledger.md` | Hot loop risks, low-level implementation options, micro-optimization candidates. | -| `references.md` | Research links for chirplets, CSS/LoRa, GCC-PHAT, D3D12/FFT/GPU compute. | -| `current-hotspot-audit.md` | Static audit of likely runtime allocation/scan/driver-pressure hotspots. | -| `implementation-roadmap.md` | Phase plan, invariants, proofs, and benchmark harnesses. | -| `questions-and-hypotheses.md` | Open questions and falsifiable hypotheses by domain. | -| `reading-guide.md` | Task-oriented route through the study docs and samples. | -| `data-dictionary.md` | Data object definitions for streams, samples, chirp anchors, clock fits, calibration paths, reports, and Fensalir constraints. | -| `volumetric-audio-field.md` | Sound-field reconstruction decomposition and first practical audio target. | -| `acoustic-field-models.md` | Field reconstruction models and the first honest acoustic source proof. | -| `chirplet-transform-deep-dive.md` | Controlled chirp receiver versus generic chirplet transform. | -| `decoder-architecture-options.md` | Active receiver implementation options and promotion criteria. | -| `distributed-receiver-spec.md` | Raven/phone receiver shape for self-locating remote sensors using codebook and schedule state. | -| `visual-fusion-4dgs-study.md` | Sensor fusion and realtime Gaussian splatting architecture study. | -| `open-implementation-catalog.md` | Implementation families to study before inventing local machinery. | -| `prior-research-synthesis.md` | Distillation of the older chirplet, adaptive sync, ambisonic, splatting, calibration, and visual archives. | -| `research-claims-digest.md` | Claim-level digest of external literature and how it steers Mimir. | -| `fensalir-integration-map.md` | Contract-level cut between Mimir runtime truth and Fensalir GPU/render ownership. | -| `native-boundary-map.md` | Native/managed/Fensalir ownership boundaries for ASIO, cameras, reservoir, and GPU payloads. | -| `option-matrix.md` | Implementation alternatives, failure modes, and deciding proofs for the major subsystems. | -| `benchmark-plan.md` | Measurement plan for audio sync, acoustic field, camera capture, Fensalir lowering, and splat fusion. | -| `calibration-session-spec.md` | Command/session shape for learning and validating real output/mic path models. | -| `low-level-implementation-notes.md` | Concrete memory layout, SIMD/GPU, ASIO, camera, and instrumentation notes. | -| `microsecond-sync-math.md` | Timing math for sample period, bandwidth, SNR, subsample delay, and acoustic distance. | -| `state-machine-invariants.md` | Ownership limits for runtime, hub, buffers, decoders, calibration, DSP, capture, Fensalir, network, and OBS. | -| `failure-mode-ledger.md` | Failure modes and coherent fixes across active witness, passive sync, actuator, camera, fusion, and network paths. | -| `hot-path-pseudocode.md` | Code-shaped intended hot paths for streaming decode, calibration weighting, actuator, native rings, camera rings, and Fensalir lowering. | -| `glossary.md` | Short definitions for the synchronization, acoustic, visual, and reservoir terms used across the study. | +| [[architecture-rumination|Architecture Rumination]] | System ownership, current machine critique, coherent next cuts. | +| [[optimization-ledger|Optimization Ledger]] | Hot loop risks, low-level implementation options, micro-optimization candidates. | +| [[references|References]] | Research links for chirplets, CSS/LoRa, GCC-PHAT, D3D12/FFT/GPU compute. | +| [[current-hotspot-audit|Current Hotspot Audit]] | Static audit of likely runtime allocation/scan/driver-pressure hotspots. | +| [[implementation-roadmap|Implementation Roadmap]] | Phase plan, invariants, proofs, and benchmark harnesses. | +| [[questions-and-hypotheses|Questions And Hypotheses]] | Open questions and falsifiable hypotheses by domain. | +| [[reading-guide|Reading Guide]] | Task-oriented route through the study docs and samples. | +| [[data-dictionary|Data Dictionary]] | Data object definitions for streams, samples, chirp anchors, clock fits, calibration paths, reports, and Fensalir constraints. | +| [[volumetric-audio-field|Volumetric Audio Field]] | Sound-field reconstruction decomposition and first practical audio target. | +| [[acoustic-field-models|Acoustic Field Models]] | Field reconstruction models and the first honest acoustic source proof. | +| [[chirplet-transform-deep-dive|Chirplet Transform Deep Dive]] | Controlled chirp receiver versus generic chirplet transform. | +| [[decoder-architecture-options|Decoder Architecture Options]] | Active receiver implementation options and promotion criteria. | +| [[distributed-receiver-spec|Distributed Receiver Spec]] | Raven/phone receiver shape for self-locating remote sensors using codebook and schedule state. | +| [[visual-fusion-4dgs-study|Visual Fusion 4DGS Study]] | Sensor fusion and realtime Gaussian splatting architecture study. | +| [[open-implementation-catalog|Open Implementation Catalog]] | Implementation families to study before inventing local machinery. | +| [[prior-research-synthesis|Prior Research Synthesis]] | Distillation of the older chirplet, adaptive sync, ambisonic, splatting, calibration, and visual archives. | +| [[research-claims-digest|Research Claims Digest]] | Claim-level digest of external literature and how it steers Mimir. | +| [[fensalir-integration-map|Fensalir Integration Map]] | Contract-level cut between Mimir runtime truth and Fensalir GPU/render ownership. | +| [[native-boundary-map|Native Boundary Map]] | Native/managed/Fensalir ownership boundaries for ASIO, cameras, reservoir, and GPU payloads. | +| [[option-matrix|Option Matrix]] | Implementation alternatives, failure modes, and deciding proofs for the major subsystems. | +| [[benchmark-plan|Benchmark Plan]] | Measurement plan for audio sync, acoustic field, camera capture, Fensalir lowering, and splat fusion. | +| [[calibration-session-spec|Calibration Session Spec]] | Command/session shape for learning and validating real output/mic path models. | +| [[low-level-implementation-notes|Low-Level Implementation Notes]] | Concrete memory layout, SIMD/GPU, ASIO, camera, and instrumentation notes. | +| [[microsecond-sync-math|Microsecond Sync Math]] | Timing math for sample period, bandwidth, SNR, subsample delay, and acoustic distance. | +| [[state-machine-invariants|State Machine Invariants]] | Ownership limits for runtime, hub, buffers, decoders, calibration, DSP, capture, Fensalir, network, and OBS. | +| [[failure-mode-ledger|Failure Mode Ledger]] | Failure modes and coherent fixes across active witness, passive sync, actuator, camera, fusion, and network paths. | +| [[hot-path-pseudocode|Hot Path Pseudocode]] | Code-shaped intended hot paths for streaming decode, calibration weighting, actuator, native rings, camera rings, and Fensalir lowering. | +| [[glossary|Glossary]] | Short definitions for the synchronization, acoustic, visual, and reservoir terms used across the study. | | `sample-code-index.json` | Machine-readable index for sample sketches. | -| `samples/README.md` | Index of sample implementation sketches. | +| [[samples/README|Sample Implementation Sketches]] | Index of sample implementation sketches. | ## Sample Code diff --git a/research/perfect-machine-study-2026-05-23/reading-guide.md b/research/perfect-machine-study-2026-05-23/reading-guide.md index 724bc6f..a28b541 100644 --- a/research/perfect-machine-study-2026-05-23/reading-guide.md +++ b/research/perfect-machine-study-2026-05-23/reading-guide.md @@ -9,13 +9,13 @@ entering a future implementation pass cold. Read in order: -1. `chirplet-transform-deep-dive.md` -2. `decoder-architecture-options.md` -3. `microsecond-sync-math.md` -4. `current-hotspot-audit.md` -5. `optimization-ledger.md` -6. `low-level-implementation-notes.md` -7. `benchmark-plan.md` +1. [[chirplet-transform-deep-dive|Chirplet Transform Deep Dive]] +2. [[decoder-architecture-options|Decoder Architecture Options]] +3. [[microsecond-sync-math|Microsecond Sync Math]] +4. [[current-hotspot-audit|Current Hotspot Audit]] +5. [[optimization-ledger|Optimization Ledger]] +6. [[low-level-implementation-notes|Low-Level Implementation Notes]] +7. [[benchmark-plan|Benchmark Plan]] 6. sample sketches: - `samples/StreamingChirpBinDecoderSketch.cs` - `samples/BatchedChirpScoreAbiSketch.h` @@ -33,12 +33,12 @@ Decision: Read in order: -1. `volumetric-audio-field.md` -2. `acoustic-field-models.md` -3. `calibration-session-spec.md` -4. `prior-research-synthesis.md` -5. `benchmark-plan.md` -6. `references.md` +1. [[volumetric-audio-field|Volumetric Audio Field]] +2. [[acoustic-field-models|Acoustic Field Models]] +3. [[calibration-session-spec|Calibration Session Spec]] +4. [[prior-research-synthesis|Prior Research Synthesis]] +5. [[benchmark-plan|Benchmark Plan]] +6. [[references|References]] Decision: @@ -51,9 +51,9 @@ Decision: Read in order: -1. `prior-research-synthesis.md` -2. `optimization-ledger.md` -3. `benchmark-plan.md` +1. [[prior-research-synthesis|Prior Research Synthesis]] +2. [[optimization-ledger|Optimization Ledger]] +3. [[benchmark-plan|Benchmark Plan]] 4. sample sketches: - `samples/FarrowFractionalDelaySketch.cpp` - `samples/SroPllAsrcControllerSketch.cpp` @@ -68,13 +68,13 @@ Decision: Read in order: -1. `native-boundary-map.md` -2. `visual-fusion-4dgs-study.md` -3. `low-level-implementation-notes.md` -4. `current-hotspot-audit.md` -5. `benchmark-plan.md` -6. `docs/native-capture-cadence.md` -7. `docs/native-rebuild-plan.md` +1. [[native-boundary-map|Native Boundary Map]] +2. [[visual-fusion-4dgs-study|Visual Fusion 4DGS Study]] +3. [[low-level-implementation-notes|Low-Level Implementation Notes]] +4. [[current-hotspot-audit|Current Hotspot Audit]] +5. [[benchmark-plan|Benchmark Plan]] +6. [[docs/native-capture-cadence|Native Capture Cadence]] +7. [[docs/native-rebuild-plan|Native Rebuild Plan]] Decision: @@ -86,9 +86,9 @@ Decision: Read in order: -1. `fensalir-integration-map.md` -2. `native-boundary-map.md` -3. `visual-fusion-4dgs-study.md` +1. [[fensalir-integration-map|Fensalir Integration Map]] +2. [[native-boundary-map|Native Boundary Map]] +3. [[visual-fusion-4dgs-study|Visual Fusion 4DGS Study]] 4. sample sketches: - `samples/AquariumGpuSensorFrameBridgeSketch.cs` - `samples/AcousticConstraintLoweringSketch.cs` @@ -104,12 +104,12 @@ Decision: Read in order: -1. `implementation-roadmap.md` -2. `option-matrix.md` -3. `research-claims-digest.md` -4. `questions-and-hypotheses.md` -5. `distributed-receiver-spec.md` -6. `current-hotspot-audit.md` +1. [[implementation-roadmap|Implementation Roadmap]] +2. [[option-matrix|Option Matrix]] +3. [[research-claims-digest|Research Claims Digest]] +4. [[questions-and-hypotheses|Questions And Hypotheses]] +5. [[distributed-receiver-spec|Distributed Receiver Spec]] +6. [[current-hotspot-audit|Current Hotspot Audit]] Recommended next code cut: @@ -121,10 +121,10 @@ Recommended next code cut: Read: -1. `docs/perfect-machine-domain-index.md` -2. `docs/code-algorithm-map.md` -3. `notes/current-system-map.md` -4. this directory's `index.md` +1. [[docs/perfect-machine-domain-index|Perfect Machine Domain Index]] +2. [[docs/code-algorithm-map|Code Algorithm Map]] +3. [[notes/current-system-map|Current System Map]] +4. this directory's [[index|Study Index]] Rule: