Critical Files
This page lists files that are critical because source inspection shows they own runtime contracts. It avoids stale claims about parameter counts or training runs.
Full Public Reader
Critical Files
This page lists files that are critical because source inspection shows they own
runtime contracts. It avoids stale claims about parameter counts or training runs.
MotionMixApp
| File | Why it matters |
|---|---|
| `MotionMixApp/Services/EchelonBridge.swift` | Main Swift coordinator. Owns Rust brain/audio handles, SANService, ClaimBridgeService, sensor queues, and dynamics overlays. |
| `MotionMixApp/Services/SANService.swift` | Swift wrapper for Rust SAN FFI. Loads `san_weights.bin` and `san_manifest.json`; owns `SANTrajectoryLogger`. |
| `MotionMixApp/Services/SANTrajectoryLogger.swift` | Schema-v2 body/SAN capture logger. Writes `Documents/san-training/<session-id>.jsonl`; can push NDJSON to K11. |
| `MotionMixApp/Services/DiffusionService.swift` | CoreML/phone-hub/fallback generation service. Uses `ConditioningEncoder` and `FlowGenerator1Step` when available. |
| `MotionMixApp/Services/ClaimBridgeService.swift` | Swift wrapper for Rust ClaimBridge. Converts Echelon dynamics into controlled motion inscription claims. |
| `MotionMixApp/Services/MocopiFeatureExtractor.swift` | Compresses mocopi skeletons into the app's 24D feature slice and pose stats. |
| `MotionMixApp/Services/LiveStreamServer.swift` | Camera-node HTTP surface. |
| `MotionMixApp/Services/NodeAdvertiser.swift` | Bonjour camera-node advertisement. |
| `MotionMixApp/Services/CameraService.swift` | AVCapture session and capture pipeline. |
| `MotionMixApp/Frameworks/libechelon_ios.a` | Rust static library consumed by iOS. |
| `MotionMixApp/Resources/san_weights.bin` | Current SAN weight binary. Training provenance must be documented separately. |
| `MotionMixApp/Resources/san_manifest.json` | SAN weight manifest. Current local audit: 76 tensors, 164,248 parameters. |
| `MotionMixApp/MotionMixApp.swift` | App entry and service wiring. |
MotionMixApp CoreML Artifacts
| File | Why it matters |
|---|---|
| `MotionMixApp/MLModels/ConditioningEncoder.mlpackage` | CoreML encoder used by `DiffusionService`; current Swift shim feeds a 104D input prefix. |
| `MotionMixApp/MLModels/FlowGenerator1Step.mlpackage` | CoreML one-step flow/token generator used after the conditioning embedding. |
| `MotionMixApp/Models/MotionToMusic.mlpackage` | Separate model artifact; do not confuse it with SAN or the one-step flow lane without checking call sites. |
Comp-Core Rust
| File | Why it matters |
|---|---|
| `core/audio-media/cc-echelon/crates/cc-brain/src/lib.rs` | Root of the Rust brain crate and public exports. |
| `core/audio-media/cc-echelon/crates/cc-brain/src/ffi.rs` | C FFI contract used by Swift. |
| `core/audio-media/cc-echelon/crates/cc-brain/src/latent/mod.rs` | `LatentUpdater` trait and backend exports. |
| `core/audio-media/cc-echelon/crates/cc-brain/src/latent/simple.rs` | Simple latent updater path. |
| `core/audio-media/cc-echelon/crates/cc-brain/src/latent/learned.rs` | Learned latent updater path. |
| `core/audio-media/cc-echelon/crates/cc-brain/src/latent/dell.rs` | DELL backend. Implemented, but docs must retain its source caveat about synthetic embeddings. |
| `core/audio-media/cc-echelon/crates/cc-brain/src/san/mod.rs` | Rust SAN pipeline. |
| `core/audio-media/cc-echelon/crates/cc-brain/src/san/config.rs` | SAN config defaults and phase/stub notes. |
| `core/audio-media/cc-echelon/crates/cc-brain/src/san/claim_bridge.rs` | Rust motion claim detector used by ClaimBridgeService. |
| `core/audio-media/cc-echelon/crates/motion-bridge/src/lim_rps.rs` | Historical/research LIM-RPS code. Real file, not the canonical name for the whole runtime. |
N'Ko / Semantic Inscription
| File | Why it matters |
|---|---|
| `core/semantic/cc-inscription/README.md` | Typed claim IR and N'Ko surface rendering design. |
| `core/semantic/cc-inscription/src/` | Claim IR, detection, surface rendering, and provenance code. |
| `core/semantic/cc-semantic-language/src/compiler/nko/` | N'Ko segmentation and operator assignment. |
| `core/semantic/cc-semantic-language/src/lifecycle/transitions.rs` | Semantic mutation lifecycle. |
| `apps/convex-memory/convex/inscriptions.ts` | Convex mutations for motion, speech, and conversation inscriptions. |
N'Ko ASR / MAOE
| File | Why it matters |
|---|---|
| `Desktop/nko-brain-scanner/asr/trajectory_asr.py` | Verified trajectory-biased Transformer CTC ASR anchor. |
| `Desktop/nko-brain-scanner/constrained/trajectory_bias.py` | Audio trajectory features and bias network. |
| `Desktop/Comp-Core/experiments/agp_mlx/asr_bridge/partition_policy.py` | MAOE-style partition/correction policy around ASR output. |
| `Desktop/Comp-Core/experiments/agp_mlx/asr_bridge/expert_router.py` | MAOE-style expert routing/admissibility code. |
Mac4 / K11 Live Work
| File or service | Why it matters |
|---|---|
| `com.lume.mocopi-sidecar-mac4` | Mac4 LaunchAgent receiving Sony mocopi, feeding Unity, and relaying low-rate state to MotionMix. |
| `lume_mocopi_motionmix_sidecar.py` | Sidecar implementation for Sony -> Unity + MotionMix. |
| `lume_pose_viewer.py` | K11 pose viewer and camera debug surface. |
| `lume_rekordbox_bridge.py` | K11 Rekordbox command safety bridge. |
| Rekordbox `.mappings` preset | Source of truth for keyboard commands. Do not hardcode keys without checking it. |
Invariants
1. `EchelonHandle` is MainActor-only from Swift.
2. `AudioHandle` has a separate audio-thread contract for rendering.
3. `SANService` is owned by `EchelonBridge`, not by a SwiftUI view.
4. `san_manifest.json` and `san_weights.bin` must match the Rust SAN architecture.
5. `EchelonBridge.getDynamics128()` overlays pose/mocopi/watch slots, but
`ClaimBridgeService` in `step(dt:)` currently receives direct Rust dynamics.
6. Camera-only gestures must keep working when mocopi is disconnected.
7. K11 remains the final Rekordbox safety gate.
8. MotionMix BodyTruth should be treated as the shared authority only after
freshness/stability checks pass.
9. Do not call ClaimBridge a placeholder. It is wired. The future work is richer
phrasing and shared movement/speech training.
10. Do not call MAOE the trained ASR anchor. The verified ASR anchor is
trajectory-biased Transformer CTC.
Promotion Decision
Attach run IDs, datasets, metrics, and reproduction commands.
Source Anchor
computational-choreography/09-reference/critical-files.md
Detected Structure
Method · Evaluation · Code Anchors · Architecture