GameCult/Mimir
Watch
9
0
Fork
You've already forked Mimir
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Convert knowledgebase links to Obsidian wikilinks

Browse source
This commit is contained in:
Meta Vens 2026-05-24 03:46:07 +01:00
commit 4085f933a8
14 changed files with 177 additions and 154 deletions
Download patch file Download diff file Expand all files Collapse all files

64
Mimir Vault.md
View file

@ -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]]

12
docs/audio-field.md
View file

@ -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

30
docs/code-algorithm-map.md
View file

@ -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.

4
docs/implementation-plan.md
View file

@ -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.

5
docs/mimir-face.md
View file

@ -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

2
docs/obs-receiver-setup.md
View file

@ -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:

37
docs/perfect-machine-domain-index.md
View file

@ -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

2
docs/perfect-machine.md
View file

@ -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

10
index.md
View file

@ -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]]

16
notes/current-system-map.md
View file

@ -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:

7
notes/fresh-workspace-handoff.md
View file

@ -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.

12
research/README.md
View file

@ -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.

58
research/perfect-machine-study-2026-05-23/index.md
View file

@ -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

72
research/perfect-machine-study-2026-05-23/reading-guide.md
View file

@ -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: