Perfect Machine Module Library
This is the runtime shelf for coherent parts that deserve to be inside Mimir, not a trophy wall for abandoned attempts. Each module below has one owner and a job-interview answer for why it belongs in the body of the machine.
Runtime Modules
| Module | Owner | Purpose | Code |
|---|---|---|---|
| Bioacoustic decoder profiles | Mimir.Runtime | Named indexed log-mel/MFCC receiver configurations for clean, compact, robust, and high-band room paths. | src/Mimir.Runtime/Synchronization/MimirBioacousticDecoderConfiguration.cs |
| Bioacoustic language profiles | Mimir.Runtime | Passive, hybrid, continuous, calibration, and phone-witness vocabulary/emission configurations. | src/Mimir.Runtime/Synchronization/MimirBioacousticLanguageConfiguration.cs |
| Bioacoustic clock solver | Mimir.Runtime | Fits canonical source time from decoded word anchors for local, Raven, phone, and microcontroller witnesses. | src/Mimir.Runtime/Synchronization/MimirBioacousticClockHypothesis.cs |
| Alignment actuator | Mimir.Runtime + Faust | Converts sync state into bounded fractional-delay, gain, and sample-rate-offset controls; Faust moves samples. | src/Mimir.Runtime/Synchronization/MimirAudioAlignmentActuator.cs |
| Audio actuator strategies | Mimir.Runtime + Faust | Integer baseline, Farrow fractional delay, variable ASRC, and hybrid delay/ASRC strategy profiles. | src/Mimir.Runtime/Synchronization/MimirAudioActuatorConfiguration.cs |
| CultMesh contracts | Mimir.Runtime | Typed codebook, decoder, acoustic path, actuator, program, Move evidence, and Mimir-fused Move controller pose documents for distributed Mimir nodes. | src/Mimir.Runtime/Synchronization/MimirCultMeshContracts.cs, src/Mimir.Runtime/Synchronization/MimirTrackingObservation.cs |
| Move controller fusion | Mimir.Runtime + native reservoir + Fensalir | Mimir admits Muninn marker candidates plus controller/IMU/button feeds into native move_evidence buffers. MimirMoveCalibrationProtocol defines the Starfire/Nightwing capture run, Muninn records optional Quest USB witness availability as muninn.quest_access.v1, MimirMoveFusion publishes calibrated mimir.move_controller_pose.v1 position/button/gyro poses only when camera witnesses are calibrated, and MimirMovePoseStream carries those poses over a realtime CultMesh frame. IMU orientation/prediction remains the next earned 6DoF step before Fensalir treats the stream as VR-grade controller input. | src/Mimir.Runtime/Synchronization/MimirTrackingObservation.cs, src/Mimir.Runtime/Synchronization/MimirMuninnMoveEvidence.cs, src/Mimir.Runtime/Synchronization/MimirMoveCalibrationProtocol.cs, src/Mimir.Runtime/Synchronization/MimirMoveFusion.cs, src/Mimir.Runtime/Synchronization/MimirMovePoseStream.cs, src/Mimir.Runtime/Synchronization/MimirNativeReservoirRuntime.cs, native/reservoir/src/lib.rs |
| Acoustic path learning | Mimir.Runtime | Calibration stages for usable bands, confusion, global delay, group delay, and codebook adaptation. | src/Mimir.Runtime/Synchronization/MimirAcousticPathLearningConfiguration.cs |
| Acoustic localization | Mimir.Runtime + Fensalir | Pairwise TDOA, SRP-PHAT grid, sparse source, and visual-constrained localization profiles plus a small SRP/TDOA scorer. | src/Mimir.Runtime/Synchronization/MimirAcousticLocalizationConfiguration.cs, src/Mimir.Runtime/Synchronization/MimirAcousticLocalizationSolver.cs |
| Benchmark panels | Mimir.Runtime | Decoder golf and meatspace acceptance degradation panels with receipt roots and thresholds. | src/Mimir.Runtime/Synchronization/MimirBenchmarkPanelConfiguration.cs |
| Capture profiles | Mimir.Runtime + native workers | Hardware intent for Leap, Kiyos, PS Eyes, Starfire Scarlett, Raven Scarlett, and USB-attached Moves on Starfire/Nightwing. | src/Mimir.Runtime/Synchronization/MimirNativeCaptureConfiguration.cs |
| Camera ingest strategies | Mimir.Runtime + native workers | Diagnostic metadata, managed native wrapper, native SPSC ring, and shared-GPU-texture ingest shapes. | src/Mimir.Runtime/Synchronization/MimirCameraIngestConfiguration.cs |
| Reservoir strategies | Mimir.Runtime + native reservoir + Fensalir | Managed rolling buffers, native shared-edge rings, and derived GPU temporal field storage. | src/Mimir.Runtime/Synchronization/MimirReservoirConfiguration.cs |
| Distributed witnesses | Mimir.Runtime + CultMesh | Raven, phone, microcontroller, and remote camera rig configurations for compact timing/path state. | src/Mimir.Runtime/Synchronization/MimirDistributedWitnessConfiguration.cs |
| Network transports | Mimir.Runtime + CultMesh | Typed timing state, debug windows, SRT bridge media, and experimental browser transport policy plus constraint-based selection. | src/Mimir.Runtime/Synchronization/MimirNetworkTransportConfiguration.cs, src/Mimir.Runtime/Synchronization/MimirNetworkTransportSelector.cs |
| Authority policy | Mimir.Runtime | Trust decisions for Starfire loopback, Raven evidence, phone candidates, diagnostic media, and unknown nodes. | src/Mimir.Runtime/Synchronization/MimirAuthorityPolicyConfiguration.cs, src/Mimir.Runtime/Synchronization/MimirAuthorityPolicyEvaluator.cs |
| Audio field configurations | Mimir.Runtime | Six-mic, source-based, ambisonic, and hybrid evidence field shapes. | src/Mimir.Runtime/Synchronization/MimirAudioFieldConfiguration.cs |
| Visual fusion configurations | Mimir.Runtime + Fensalir | Sensor roles and fusion modes from cadence proof through full hybrid evidence. | src/Mimir.Runtime/Synchronization/MimirVisualFusionConfiguration.cs |
| Compute offload configurations | Mimir.Runtime + CultMesh | Local-heavy, distributed witness, and calibration sweep workload placement. | src/Mimir.Runtime/Synchronization/MimirComputeOffloadConfiguration.cs |
| Assembly plans | Mimir.Runtime | Named combinations of modules that prove synthetic, Scarlett, meatspace, and distributed cuts. | src/Mimir.Runtime/Synchronization/MimirMachineAssemblyPlan.cs |
| Program publication profiles | Mimir + Fensalir + Faust + Eve + Yggdrasil | Mimir-owned scene publication, Eve operator surfaces, Yggdrasil site feed, and temporary OBS compatibility adapters. | src/Mimir.Runtime/Synchronization/MimirProgramPublicationConfiguration.cs |
| Fensalir lowering | Mimir.Runtime → Fensalir | Pure mapping from Mimir rolling/video/audio state into Fensalir GPU sensor and acoustic field frames. | src/Mimir.Runtime/Synchronization/MimirFensalirFieldLowering.cs |
| Module catalog | Mimir.Runtime | Indexes the live module set and verification commands. | src/Mimir.Runtime/Synchronization/MimirModuleLibrary.cs |
| Manifest factory | Mimir.Runtime | Produces an exportable JSON manifest for tools, docs, UI, and remote witnesses. | src/Mimir.Runtime/Synchronization/MimirPerfectMachineManifest.cs |
Current Authority Map
Mimir.Runtimeowns device and synchronization truth before it becomes a renderer/DSP packet.- Fensalir owns GPU resource lifetime, temporal field rendering, debug UI, and program video publication.
- Faust owns hot sample movement, alignment, spatialization, separation, and stem generation.
- CultMesh carries typed state surfaces; remote nodes may observe and decode, but they do not become independent clock authorities.
- USB-attached Moves on Starfire and Nightwing publish source-local Muninn
evidence streams: glowing-orb marker candidates and controller/IMU/button
state. Odin discovers/projects those streams. Mimir owns native evidence
buffer admission/layout, calibration, association, triangulation, confidence,
and
mimir.move_controller_pose.v1publication. The current fusion pass resolves calibrated optical position and controller state; orientation remains explicitly unresolved until IMU fusion/prediction lands. Fensalir consumes the resolved pose stream for interactive environments once that contract is wired. - Resolved Move poses are framed as
mimir.move_controller_pose_stream_frame.v1on CultMesh shared-memory bytes streams; the stream is a Mimir output surface, not a new fusion owner. - OBS may receive compatibility program surfaces and stems. It does not own calibration, composition, preview/control, or publication.
Verification Surface
Use these as quick probes after touching the module shelf:
dotnet build .\Mimir.slnx
dotnet run --no-build --project .\src\Mimir.BufferSmoke\Mimir.BufferSmoke.csproj -- --perfect-machine-profile-smoke
dotnet run --no-build --project .\src\Mimir.BufferSmoke\Mimir.BufferSmoke.csproj -- --perfect-machine-lowering-benchmark
dotnet run --no-build --project .\src\Mimir.BufferSmoke\Mimir.BufferSmoke.csproj -- --perfect-machine-contract-smoke
dotnet run --no-build --project .\src\Mimir.BufferSmoke\Mimir.BufferSmoke.csproj -- --move-tracking-contract-smoke
dotnet run --no-build --project .\src\Mimir.BufferSmoke\Mimir.BufferSmoke.csproj -- --move-native-reservoir-smoke --native-reservoir .\native\reservoir\target\debug\localcast_reservoir.dll
dotnet run --no-build --project .\src\Mimir.BufferSmoke\Mimir.BufferSmoke.csproj -- --muninn-move-evidence-smoke --native-reservoir .\native\reservoir\target\debug\localcast_reservoir.dll
dotnet run --no-build --project .\src\Mimir.BufferSmoke\Mimir.BufferSmoke.csproj -- --muninn-move-cultmesh-stream-smoke --native-reservoir .\native\reservoir\target\debug\localcast_reservoir.dll
dotnet run --no-build --project .\src\Mimir.BufferSmoke\Mimir.BufferSmoke.csproj -- --move-calibration-protocol-smoke
dotnet run --no-build --project .\src\Mimir.BufferSmoke\Mimir.BufferSmoke.csproj -- --move-fusion-smoke
dotnet run --no-build --project .\src\Mimir.BufferSmoke\Mimir.BufferSmoke.csproj -- --perfect-machine-manifest
dotnet run --no-build --project .\src\Mimir.BufferSmoke\Mimir.BufferSmoke.csproj -- --bioacoustic-actuator-self-testResearch Links
- Perfect Machine Study Index
- Option Matrix
- State Machine Invariants
- Fensalir Integration Map
- Optimization Ledger
Cut Line
If a future implementation supersedes one of these module shapes, delete or demote the old module in the same pass. The library is meant to keep usable organs ready at hand, not preserve every fossil that once twitched.