Convert knowledgebase links to Obsidian wikilinks
This commit is contained in:
parent
d20d22bb69
commit
4085f933a8
14 changed files with 177 additions and 154 deletions
|
|
@ -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]]
|
||||||
|
|
|
||||||
|
|
@ -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
|
||||||
|
|
|
||||||
|
|
@ -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.
|
||||||
|
|
|
||||||
|
|
@ -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.
|
||||||
|
|
|
||||||
|
|
@ -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
|
||||||
|
|
|
||||||
|
|
@ -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:
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -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
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -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
|
||||||
|
|
|
||||||
10
index.md
10
index.md
|
|
@ -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]]
|
||||||
|
|
|
||||||
|
|
@ -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:
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -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.
|
||||||
|
|
|
||||||
|
|
@ -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.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -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
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -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:
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue