Convert knowledgebase links to Obsidian wikilinks

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

View file

@ -6,47 +6,47 @@ corpus.
## Start Here ## Start Here
- [README](README.md) - [[README]]
- [Current System Map](notes/current-system-map.md) - [[notes/current-system-map|Current System Map]]
- [Fresh Workspace Handoff](notes/fresh-workspace-handoff.md) - [[notes/fresh-workspace-handoff|Fresh Workspace Handoff]]
- [Implementation Plan](docs/implementation-plan.md) - [[docs/implementation-plan|Implementation Plan]]
- [Code Algorithm Map](docs/code-algorithm-map.md) - [[docs/code-algorithm-map|Code Algorithm Map]]
- [Perfect Machine Domain Index](docs/perfect-machine-domain-index.md) - [[docs/perfect-machine-domain-index|Perfect Machine Domain Index]]
## Live Architecture ## Live Architecture
- [Architecture](docs/architecture.md) - [[docs/architecture|Architecture]]
- [Perfect Machine](docs/perfect-machine.md) - [[docs/perfect-machine|Perfect Machine]]
- [Viable Stream App](docs/viable-stream-app.md) - [[docs/viable-stream-app|Viable Stream App]]
- [Audio Field](docs/audio-field.md) - [[docs/audio-field|Audio Field]]
- [Sensor Fusion Architecture](docs/sensor-fusion-architecture.md) - [[docs/sensor-fusion-architecture|Sensor Fusion Architecture]]
- [Native Rebuild Plan](docs/native-rebuild-plan.md) - [[docs/native-rebuild-plan|Native Rebuild Plan]]
- [Native Capture Cadence](docs/native-capture-cadence.md) - [[docs/native-capture-cadence|Native Capture Cadence]]
- [Fensalir Spatial Audio](docs/fensalir-spatial-audio.md) - [[docs/fensalir-spatial-audio|Fensalir Spatial Audio]]
## Current Deep Study ## Current Deep Study
- [Study Reading Guide](research/perfect-machine-study-2026-05-23/reading-guide.md) - [[research/perfect-machine-study-2026-05-23/reading-guide|Study Reading Guide]]
- [Study Index](research/perfect-machine-study-2026-05-23/index.md) - [[research/perfect-machine-study-2026-05-23/index|Study Index]]
- [Research Claims Digest](research/perfect-machine-study-2026-05-23/research-claims-digest.md) - [[research/perfect-machine-study-2026-05-23/research-claims-digest|Research Claims Digest]]
- [Implementation Roadmap](research/perfect-machine-study-2026-05-23/implementation-roadmap.md) - [[research/perfect-machine-study-2026-05-23/implementation-roadmap|Implementation Roadmap]]
- [Benchmark Plan](research/perfect-machine-study-2026-05-23/benchmark-plan.md) - [[research/perfect-machine-study-2026-05-23/benchmark-plan|Benchmark Plan]]
- [Calibration Session Spec](research/perfect-machine-study-2026-05-23/calibration-session-spec.md) - [[research/perfect-machine-study-2026-05-23/calibration-session-spec|Calibration Session Spec]]
- [Fensalir Integration Map](research/perfect-machine-study-2026-05-23/fensalir-integration-map.md) - [[research/perfect-machine-study-2026-05-23/fensalir-integration-map|Fensalir Integration Map]]
- [Native Boundary Map](research/perfect-machine-study-2026-05-23/native-boundary-map.md) - [[research/perfect-machine-study-2026-05-23/native-boundary-map|Native Boundary Map]]
## Research Archives ## Research Archives
- [Research Index](research/README.md) - [[research/README|Research Index]]
- [Chirplet Sync Decoder](research/chirplet-sync-decoder/summary.md) - [[research/chirplet-sync-decoder/summary|Chirplet Sync Decoder]]
- [Live Adaptive Sync](research/live-adaptive-sync/summary.md) - [[research/live-adaptive-sync/summary|Live Adaptive Sync]]
- [GPU Fusion Splatting](research/gpu-fusion-splatting/summary.md) - [[research/gpu-fusion-splatting/summary|GPU Fusion Splatting]]
- [Visual Spatial Map](research/visual-spatial-map/summary.md) - [[research/visual-spatial-map/summary|Visual Spatial Map]]
- [Ambisonic AquaSynth](research/ambisonic-aquasynth/summary.md) - [[research/ambisonic-aquasynth/summary|Ambisonic AquaSynth]]
- [Feedback Calibration](research/feedback-calibration/summary.md) - [[research/feedback-calibration/summary|Feedback Calibration]]
- [Playback Calibration](research/playback-calibration/summary.md) - [[research/playback-calibration/summary|Playback Calibration]]
- [Spout OBS Bridge](research/spout-obs-bridge/summary.md) - [[research/spout-obs-bridge/summary|Spout OBS Bridge]]
## Persistence And Identity ## Persistence And Identity
- [Mimir Face](docs/mimir-face.md) - [[docs/mimir-face|Mimir Face]]

View file

@ -99,13 +99,17 @@ and separate from the louder chirp-only lab gain.
Research notes: 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. 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. 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. 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. response calibration.
## Next Cut ## Next Cut

View file

@ -3,7 +3,7 @@
## What This File Is ## What This File Is
This is a source-grounded map of the code currently in this repo. It follows the 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. plain about ownership, and explicit about which blocks deserve to live.
Generated build trees under `native/**/build/` are not mapped as source. Stored Generated build trees under `native/**/build/` are not mapped as source. Stored
@ -1410,17 +1410,24 @@ Live role:
Linked notes: 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. 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. transform references.
- `research/live-adaptive-sync/summary.md`: passive timing, drift, and SRO. - [[research/live-adaptive-sync/summary|Live Adaptive Sync Summary]]: passive
- `research/feedback-calibration/summary.md`: room/speaker/mic calibration. timing, drift, and SRO.
- `research/perfect-machine-hypotheses/summary.md`: hypotheses added by this - [[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. 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. 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. optimization ledger, references, and sample implementation sketches.
Hypotheses: Hypotheses:
@ -1453,7 +1460,8 @@ Hypotheses:
This map describes the repo's code shape. It is not a replacement for: 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. - [[audio-field|Audio Field]] for the audio-side algorithm and measurement
- `docs/native-capture-cadence.md` for camera/USB evidence. narrative.
- `docs/implementation-plan.md` for current build plan. - [[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. - `state/map.yaml` for canonical repo state.

View file

@ -3,9 +3,9 @@
## Current Cut Line ## Current Cut Line
Mimir is now a C# app/runtime plus native reservoir project. The live stream 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 - `src/Mimir.App` hosts Fensalir for windowing, rendering, and the D3D12
bridge. bridge.

View file

@ -135,8 +135,9 @@ temptation to call a pile of moving parts a system.
When VoidBot wakes Mimir for a heartbeat: When VoidBot wakes Mimir for a heartbeat:
1. Read `state/map.yaml`, `notes/fresh-workspace-handoff.md`, 1. Read `state/map.yaml`, [[notes/fresh-workspace-handoff|Fresh Workspace Handoff]],
`notes/current-system-map.md`, and `docs/implementation-plan.md`. [[notes/current-system-map|Current System Map]], and
[[implementation-plan|Implementation Plan]].
2. Check `git status --short --branch`. 2. Check `git status --short --branch`.
3. Read the tail of `state/evidence.jsonl`. 3. Read the tail of `state/evidence.jsonl`.
4. Report only meaningful drift, completed work, blockers, or next bounded 4. Report only meaningful drift, completed work, blockers, or next bounded

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 ## V1 Smoke Gate
Before adding receiver plugins, native OBS surfaces, or new bridge elegance, run 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: The required artifact is:

View file

@ -8,26 +8,29 @@ open architectural cut.
Read this with: Read this with:
- `docs/code-algorithm-map.md` for source-level ownership. - [[code-algorithm-map|Code Algorithm Map]] for source-level ownership.
- `docs/audio-field.md` for current audio sync narrative. - [[audio-field|Audio Field]] for current audio sync narrative.
- `docs/perfect-machine-full-field.md` for the article-form full-field vision: - [[perfect-machine-full-field|The Perfect Machine Full Field]] for the
article-form full-field vision:
direct/network cameras, microphones, tracked phones, glowing markers, direct/network cameras, microphones, tracked phones, glowing markers,
chirplet room mapping, motion capture, and the spatiotemporal reservoir. chirplet room mapping, motion capture, and the spatiotemporal reservoir.
- `docs/native-capture-cadence.md` for measured camera/USB evidence. - [[native-capture-cadence|Native Capture Cadence]] for measured camera/USB
- `research/perfect-machine-study-2026-05-23/architecture-rumination.md` for evidence.
the long-form design argument. - [[research/perfect-machine-study-2026-05-23/architecture-rumination|Architecture Rumination]]
- `research/perfect-machine-study-2026-05-23/index.md` for the study directory for the long-form design argument.
and sample-code index. - [[research/perfect-machine-study-2026-05-23/index|Perfect Machine Study Index]]
- `research/perfect-machine-study-2026-05-23/reading-guide.md` for task-oriented for the study directory and sample-code index.
navigation through the study. - [[research/perfect-machine-study-2026-05-23/reading-guide|Reading Guide]] for
- `research/perfect-machine-study-2026-05-23/optimization-ledger.md` for hot task-oriented navigation through the study.
- [[research/perfect-machine-study-2026-05-23/optimization-ledger|Optimization Ledger]]
for hot
loop candidates. loop candidates.
- `research/perfect-machine-study-2026-05-23/fensalir-integration-map.md` for - [[research/perfect-machine-study-2026-05-23/fensalir-integration-map|Fensalir Integration Map]]
the Mimir/Fensalir ownership cut. for the Mimir/Fensalir ownership cut.
- `research/perfect-machine-study-2026-05-23/calibration-session-spec.md` for - [[research/perfect-machine-study-2026-05-23/calibration-session-spec|Calibration Session Spec]]
the planned physical-path calibration command. for the planned physical-path calibration command.
- `research/perfect-machine-study-2026-05-23/samples/README.md` for sample - [[research/perfect-machine-study-2026-05-23/samples/README|Sample Implementation Sketches]]
implementation sketches. for sample implementation sketches.
## One-Sentence Machine ## One-Sentence Machine

View file

@ -9,7 +9,7 @@ OBS output.
For the larger public-facing field article that includes direct and networked For the larger public-facing field article that includes direct and networked
cameras, tracked smartphones, glowing motion-capture markers, chirplet room cameras, tracked smartphones, glowing motion-capture markers, chirplet room
mapping, and the shared spatiotemporal reservoir, read 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 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 volumetric field with explicit owners: visual evidence becomes Fensalir sensor

View file

@ -5,8 +5,8 @@ signals, and runtime evidence pulled into one coherent OBS-facing surface.
## Start Here ## Start Here
- [Current System Map](notes/current-system-map.md) - [[notes/current-system-map|Current System Map]]
- [Perfect Machine Domain Index](docs/perfect-machine-domain-index.md) - [[docs/perfect-machine-domain-index|Perfect Machine Domain Index]]
- [Code Algorithm Map](docs/code-algorithm-map.md) - [[docs/code-algorithm-map|Code Algorithm Map]]
- [Implementation Plan](docs/implementation-plan.md) - [[docs/implementation-plan|Implementation Plan]]
- [Study Reading Guide](research/perfect-machine-study-2026-05-23/reading-guide.md) - [[research/perfect-machine-study-2026-05-23/reading-guide|Study Reading Guide]]

View file

@ -1,7 +1,8 @@
# Current System Map # Current System Map
Source-level code ownership is mapped in `docs/code-algorithm-map.md`. 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.md`; the The indexed problem-domain map is
[[docs/perfect-machine-domain-index|Perfect Machine Domain Index]]; the
current architecture/optimization/sample-code study lives under current architecture/optimization/sample-code study lives under
`research/perfect-machine-study-2026-05-23/`. `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. names still use `localcast` until a deliberate rename cut exists.
The live target is the native rolling field machine described in 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`. `config/perfect-machine.example.json`.
## Perfect Machine Target ## Perfect Machine Target
@ -46,10 +48,10 @@ No private history outlives the rolling buffer.
## Viable Stream App ## Viable Stream App
`docs/viable-stream-app.md` defines the near-term app target. Fensalir hosts the [[docs/viable-stream-app|Viable Stream App]] defines the near-term app target.
running Mimir app, keeps the default five-second runtime in memory, exposes Fensalir hosts the running Mimir app, keeps the default five-second runtime in
debug/settings/output controls, and emits synchronized OBS program video plus memory, exposes debug/settings/output controls, and emits synchronized OBS
separately controllable audio stems. program video plus separately controllable audio stems.
`Mimir.Runtime` currently provides: `Mimir.Runtime` currently provides:

View file

@ -18,7 +18,7 @@ Get-Content .\state\evidence.jsonl -Tail 8
## Current Shape ## Current Shape
- Public brand/Face is Mimir. - 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/`. - VoidBot persona/state live under `.voidbot/voice/` and `.voidbot/state/`.
Commit `.voidbot` dirt in a separate state commit whenever it appears. Commit `.voidbot` dirt in a separate state commit whenever it appears.
- V1 still has FFmpeg/SRT/OBS bridge utilities for LAN ingest. - 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 - `src/Mimir.Runtime` owns `MimirSynchronizationHub`, configurable five-second
rolling buffers, stream descriptors, source adapters, direct native ingest, rolling buffers, stream descriptors, source adapters, direct native ingest,
audio chirplet delay estimation, and the video capture driver seam. 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. the fastest re-entry maps for source ownership and problem-domain cuts.
- `research/perfect-machine-study-2026-05-23/` contains the architecture - `research/perfect-machine-study-2026-05-23/` contains the architecture
rumination, optimization ledger, references, boundary maps, benchmark plan, rumination, optimization ledger, references, boundary maps, benchmark plan,
calibration-session spec, distributed receiver spec, failure ledger, data calibration-session spec, distributed receiver spec, failure ledger, data
dictionary, low-level implementation notes, and sample code sketches for the dictionary, low-level implementation notes, and sample code sketches for the
next decoder/DSP/native-ring/Fensalir implementation passes. Start with 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 - Local six-camera ingest should use direct driver adapters. Process-backed
sources are bridge/network edges only. sources are bridge/network edges only.
- Leap stereo IR is the first timing-camera candidate for direct ingest. - Leap stereo IR is the first timing-camera candidate for direct ingest.

View file

@ -18,14 +18,18 @@ Use it to shape native implementation decisions:
Audio timing research entry points: 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 matched-filter search was cut from the hybrid hot path, and the current
dechirp plus FFT/Goertzel decoder shape. 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. 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. 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 material; useful background, not a license to call unsynchronized mics a
coherent field. coherent field.

View file

@ -10,36 +10,36 @@ needs the reason a cut exists.
| File | Use It For | | File | Use It For |
| --- | --- | | --- | --- |
| `architecture-rumination.md` | System ownership, current machine critique, coherent next cuts. | | [[architecture-rumination|Architecture Rumination]] | System ownership, current machine critique, coherent next cuts. |
| `optimization-ledger.md` | Hot loop risks, low-level implementation options, micro-optimization candidates. | | [[optimization-ledger|Optimization Ledger]] | Hot loop risks, low-level implementation options, micro-optimization candidates. |
| `references.md` | Research links for chirplets, CSS/LoRa, GCC-PHAT, D3D12/FFT/GPU compute. | | [[references|References]] | 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. | | [[current-hotspot-audit|Current Hotspot Audit]] | Static audit of likely runtime allocation/scan/driver-pressure hotspots. |
| `implementation-roadmap.md` | Phase plan, invariants, proofs, and benchmark harnesses. | | [[implementation-roadmap|Implementation Roadmap]] | Phase plan, invariants, proofs, and benchmark harnesses. |
| `questions-and-hypotheses.md` | Open questions and falsifiable hypotheses by domain. | | [[questions-and-hypotheses|Questions And Hypotheses]] | Open questions and falsifiable hypotheses by domain. |
| `reading-guide.md` | Task-oriented route through the study docs and samples. | | [[reading-guide|Reading Guide]] | 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. | | [[data-dictionary|Data Dictionary]] | 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. | | [[volumetric-audio-field|Volumetric Audio Field]] | Sound-field reconstruction decomposition and first practical audio target. |
| `acoustic-field-models.md` | Field reconstruction models and the first honest acoustic source proof. | | [[acoustic-field-models|Acoustic Field Models]] | Field reconstruction models and the first honest acoustic source proof. |
| `chirplet-transform-deep-dive.md` | Controlled chirp receiver versus generic chirplet transform. | | [[chirplet-transform-deep-dive|Chirplet Transform Deep Dive]] | Controlled chirp receiver versus generic chirplet transform. |
| `decoder-architecture-options.md` | Active receiver implementation options and promotion criteria. | | [[decoder-architecture-options|Decoder Architecture Options]] | 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. | | [[distributed-receiver-spec|Distributed Receiver Spec]] | 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. | | [[visual-fusion-4dgs-study|Visual Fusion 4DGS Study]] | Sensor fusion and realtime Gaussian splatting architecture study. |
| `open-implementation-catalog.md` | Implementation families to study before inventing local machinery. | | [[open-implementation-catalog|Open Implementation Catalog]] | 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. | | [[prior-research-synthesis|Prior Research Synthesis]] | 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. | | [[research-claims-digest|Research Claims Digest]] | 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. | | [[fensalir-integration-map|Fensalir Integration Map]] | 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. | | [[native-boundary-map|Native Boundary Map]] | 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. | | [[option-matrix|Option Matrix]] | 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. | | [[benchmark-plan|Benchmark Plan]] | 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. | | [[calibration-session-spec|Calibration Session Spec]] | 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. | | [[low-level-implementation-notes|Low-Level Implementation Notes]] | 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. | | [[microsecond-sync-math|Microsecond Sync Math]] | 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. | | [[state-machine-invariants|State Machine Invariants]] | 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. | | [[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.md` | Code-shaped intended hot paths for streaming decode, calibration weighting, actuator, native rings, camera rings, and Fensalir lowering. | | [[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.md` | Short definitions for the synchronization, acoustic, visual, and reservoir terms used across the study. | | [[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. | | `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 ## Sample Code

View file

@ -9,13 +9,13 @@ entering a future implementation pass cold.
Read in order: Read in order:
1. `chirplet-transform-deep-dive.md` 1. [[chirplet-transform-deep-dive|Chirplet Transform Deep Dive]]
2. `decoder-architecture-options.md` 2. [[decoder-architecture-options|Decoder Architecture Options]]
3. `microsecond-sync-math.md` 3. [[microsecond-sync-math|Microsecond Sync Math]]
4. `current-hotspot-audit.md` 4. [[current-hotspot-audit|Current Hotspot Audit]]
5. `optimization-ledger.md` 5. [[optimization-ledger|Optimization Ledger]]
6. `low-level-implementation-notes.md` 6. [[low-level-implementation-notes|Low-Level Implementation Notes]]
7. `benchmark-plan.md` 7. [[benchmark-plan|Benchmark Plan]]
6. sample sketches: 6. sample sketches:
- `samples/StreamingChirpBinDecoderSketch.cs` - `samples/StreamingChirpBinDecoderSketch.cs`
- `samples/BatchedChirpScoreAbiSketch.h` - `samples/BatchedChirpScoreAbiSketch.h`
@ -33,12 +33,12 @@ Decision:
Read in order: Read in order:
1. `volumetric-audio-field.md` 1. [[volumetric-audio-field|Volumetric Audio Field]]
2. `acoustic-field-models.md` 2. [[acoustic-field-models|Acoustic Field Models]]
3. `calibration-session-spec.md` 3. [[calibration-session-spec|Calibration Session Spec]]
4. `prior-research-synthesis.md` 4. [[prior-research-synthesis|Prior Research Synthesis]]
5. `benchmark-plan.md` 5. [[benchmark-plan|Benchmark Plan]]
6. `references.md` 6. [[references|References]]
Decision: Decision:
@ -51,9 +51,9 @@ Decision:
Read in order: Read in order:
1. `prior-research-synthesis.md` 1. [[prior-research-synthesis|Prior Research Synthesis]]
2. `optimization-ledger.md` 2. [[optimization-ledger|Optimization Ledger]]
3. `benchmark-plan.md` 3. [[benchmark-plan|Benchmark Plan]]
4. sample sketches: 4. sample sketches:
- `samples/FarrowFractionalDelaySketch.cpp` - `samples/FarrowFractionalDelaySketch.cpp`
- `samples/SroPllAsrcControllerSketch.cpp` - `samples/SroPllAsrcControllerSketch.cpp`
@ -68,13 +68,13 @@ Decision:
Read in order: Read in order:
1. `native-boundary-map.md` 1. [[native-boundary-map|Native Boundary Map]]
2. `visual-fusion-4dgs-study.md` 2. [[visual-fusion-4dgs-study|Visual Fusion 4DGS Study]]
3. `low-level-implementation-notes.md` 3. [[low-level-implementation-notes|Low-Level Implementation Notes]]
4. `current-hotspot-audit.md` 4. [[current-hotspot-audit|Current Hotspot Audit]]
5. `benchmark-plan.md` 5. [[benchmark-plan|Benchmark Plan]]
6. `docs/native-capture-cadence.md` 6. [[docs/native-capture-cadence|Native Capture Cadence]]
7. `docs/native-rebuild-plan.md` 7. [[docs/native-rebuild-plan|Native Rebuild Plan]]
Decision: Decision:
@ -86,9 +86,9 @@ Decision:
Read in order: Read in order:
1. `fensalir-integration-map.md` 1. [[fensalir-integration-map|Fensalir Integration Map]]
2. `native-boundary-map.md` 2. [[native-boundary-map|Native Boundary Map]]
3. `visual-fusion-4dgs-study.md` 3. [[visual-fusion-4dgs-study|Visual Fusion 4DGS Study]]
4. sample sketches: 4. sample sketches:
- `samples/AquariumGpuSensorFrameBridgeSketch.cs` - `samples/AquariumGpuSensorFrameBridgeSketch.cs`
- `samples/AcousticConstraintLoweringSketch.cs` - `samples/AcousticConstraintLoweringSketch.cs`
@ -104,12 +104,12 @@ Decision:
Read in order: Read in order:
1. `implementation-roadmap.md` 1. [[implementation-roadmap|Implementation Roadmap]]
2. `option-matrix.md` 2. [[option-matrix|Option Matrix]]
3. `research-claims-digest.md` 3. [[research-claims-digest|Research Claims Digest]]
4. `questions-and-hypotheses.md` 4. [[questions-and-hypotheses|Questions And Hypotheses]]
5. `distributed-receiver-spec.md` 5. [[distributed-receiver-spec|Distributed Receiver Spec]]
6. `current-hotspot-audit.md` 6. [[current-hotspot-audit|Current Hotspot Audit]]
Recommended next code cut: Recommended next code cut:
@ -121,10 +121,10 @@ Recommended next code cut:
Read: Read:
1. `docs/perfect-machine-domain-index.md` 1. [[docs/perfect-machine-domain-index|Perfect Machine Domain Index]]
2. `docs/code-algorithm-map.md` 2. [[docs/code-algorithm-map|Code Algorithm Map]]
3. `notes/current-system-map.md` 3. [[notes/current-system-map|Current System Map]]
4. this directory's `index.md` 4. this directory's [[index|Study Index]]
Rule: Rule: