Comp-Core Architecture Overview

Mocopi UDP → TLV Parse (50μs) → EKF Fusion (100μs) → Anticipation (2ms) → Gesture (500μs) → Audio (1ms)

┌─────────────────────────────────────────────────────────────┐
│                                                             │
│              COMPUTATIONAL CHOREOGRAPHY                     │
│                    The Discipline                           │
│                                                             │
│   "What does movement mean, and how can we compute it?"     │
│                                                             │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│                    TrajectoryOS                             │
│               The Operating System                          │
│                                                             │
│  "What does this moment mean in the context of             │
│   everything else, and where does it sit in the            │
│   long arc?"                                                │
│                                                             │
│  Time Scale: Hours → Years                                  │
│  Operates on: Sessions, projects, creative arcs            │
│  Output: Context, memory, style                             │
│                                                             │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│                      Echelon                                │
│                The Real-Time Engine                         │
│                                                             │
│  "What is happening now, in the body, and how do we        │
│   keep this moment coherent?"                              │
│                                                             │
│  Time Scale: Milliseconds → Seconds                         │
│  Operates on: Continuous motion dynamics                    │
│  Output: Control signals, gestures, audio                   │
│                                                             │
└─────────────────────────────────────────────────────────────┘

flowchart TB
    subgraph Philosophy [Computational Choreography]
        CC[Motion as Meaning<br/>The Discipline]
    end

    subgraph TrajectoryOS [TrajectoryOS - Long Horizon OS]
        direction TB
        subgraph Memory [Memory Layer]
            RAG[RAG++ Memory Fabric<br/>5D Trajectory Coordinates]
            CT[CognitiveTwin<br/>Style Signature]
            HNSW[HNSW Index<br/>O(log n) ANN]
        end
        subgraph Orchestration [Orchestration Layer]
            Orbit[Orbit Server<br/>Axum/Rust]
            Sessions[Session Manager<br/>Supabase]
        end
        subgraph Trajectory [Trajectory Layer]
            TC[5D Coordinates<br/>temporal, semantic, depth, homogeneity, salience]
            IRCP[I-RCP Propagator<br/>Attention Weights]
        end
    end

    subgraph Echelon [Echelon - Real-Time Engine]
        direction TB
        subgraph Sensor [Layer 0-1: Sensor Input]
            Mocopi[Mocopi 27-Bone<br/>UDP 12351]
            Relay[cc-relay<br/>Rust Binary]
            Collection[cc-collection<br/>Extended Kalman Filter]
        end
        subgraph Semantic [Layer 2-3: Semantic]
            Aligner[cc-window-aligner<br/>50 Hz Windows]
            Anticipation[cc-anticipation<br/>Commitment, Uncertainty]
            Gesture[cc-gesture<br/>Neighbor Voting]
        end
        subgraph DELL [Layer 3.5: DELL]
            DELLCoord[DELLCoordinator]
            Fast[Fast Equilibrium<br/>60Hz]
            Slow[Slow Equilibrium<br/>~2.5Hz]
        end
        subgraph Audio [Layer 4-7: Audio]
            Brain[cc-brain<br/>Latent Updater]
            Conductor[cc-conductor<br/>Beat Scheduler]
            DSP[Real-Time DSP<br/>Lock-Free]
        end
    end

    CC --> TrajectoryOS
    CC --> Echelon
    Mocopi --> Relay --> Collection --> Aligner --> Anticipation
    Anticipation --> Gesture --> Brain
    Anticipation --> DELLCoord --> Fast --> Slow
    DELLCoord --> Brain --> Conductor --> DSP
    Echelon -->|Trajectory Segments| TrajectoryOS
    TrajectoryOS -->|Context Window| Echelon

flowchart LR
    subgraph Input [Sensor Input Layer]
        M[Mocopi UDP<br/>12351<br/>30-60 Hz]
        I[iPhone/Watch<br/>WebSocket<br/>60 Hz]
        C[MediaPipe<br/>WebSocket<br/>30 Hz]
    end

    subgraph Relay [cc-relay]
        TLV[TLV Parser<br/>Zero-Copy]
        Batch[Frame Batching<br/>30 frames]
        Sync[Cloud Sync<br/>Circuit Breaker]
    end

    subgraph Fusion [cc-collection]
        EKF[Extended Kalman Filter<br/>13-dim state per limb]
        Occ[Occlusion Handler<br/>Exponential Decay]
    end

    subgraph Window [cc-window-aligner]
        WA[Temporal Alignment<br/>Clock Skew Correction]
        MW[MotionWindow<br/>50 Hz Canonical]
    end

    subgraph Anticipation [cc-anticipation]
        Kernel[Anticipation Kernel<br/>7 Scalars + 3 Vectors]
        Phrase[Phrase Library<br/>HNSW Neighbors]
    end

    subgraph Gesture [cc-gesture]
        Class[Gesture Classifier<br/>Neighbor Voting]
        Hand[Hand Kernel<br/>iPhone/Watch]
    end

    subgraph Brain [cc-brain]
        Latent[Latent Updater<br/>State Machine]
        Lex[Lexicon<br/>Expressive Controls]
    end

    subgraph Output [Output Layer]
        Audio[Audio Engine<br/>48kHz, < 1ms]
        Viz[Visualization<br/>WebSocket]
        DJ[DJ Control<br/>MIDI/OSC]
    end

    M --> TLV --> Batch --> Sync --> EKF
    I --> EKF
    C --> EKF
    EKF --> Occ --> WA --> MW --> Kernel
    Kernel --> Phrase --> Class
    Hand --> Class
    Class --> Latent --> Lex
    Lex --> Audio
    Lex --> Viz
    Class --> DJ

flowchart BT
    subgraph Protocol [Protocol Layer]
        Protocol[cc-protocol<br/>Types, Schemas, Serialization]
    end

    subgraph Input [Input Layer]
        Relay[cc-relay<br/>TLV Parser, UDP]
        Collection[cc-collection<br/>Kalman Fusion]
    end

    subgraph Semantic [Semantic Layer]
        WindowAligner[cc-window-aligner<br/>Temporal Alignment]
        Anticipation[cc-anticipation<br/>Commitment, Uncertainty]
        Gesture[cc-gesture<br/>Classification]
    end

    subgraph Engine [Engine Layer]
        Brain[cc-brain<br/>Latent Equilibrium]
        DELL[dell<br/>Dual Timescale]
        Conductor[cc-conductor<br/>Beat Scheduling]
        AudioEngine[audio-engine<br/>DSP]
    end

    subgraph Memory [Memory Layer]
        RAGCore[rag_plusplus_core<br/>HNSW, IRCP, 5D]
    end

    Protocol --> Relay
    Protocol --> Collection
    Collection --> WindowAligner
    WindowAligner --> Anticipation
    Anticipation --> Gesture
    RAGCore --> Anticipation
    Gesture --> Brain
    Anticipation --> DELL
    DELL --> Brain
    Brain --> Conductor --> AudioEngine

# Build and run the simulator
cd core/cc-relay
cargo run --release --bin mocopi-simulator -- \
    --target [ip]:12351 \
    --motion dance \
    --duration 30 \
    --fps 50

# Available motion patterns: idle, walk, dance, wave, expressive

# Check relay metrics (Prometheus)
curl -s http://[ip]:9090/metrics | grep cc_relay

# Check GCP VM health
curl http://[ip]:8765/health

# Check frame count
curl http://[ip]:8765/mocopi-state | jq '.count'

# Get latest moment
curl http://[ip]:8765/moment | jq

# Terminal 1: Rust relay
cd core/cc-relay && cargo run --release

# Terminal 2: Headless daemon
cd backend/cc-mcs/src-tauri && cargo run --bin cc-mcs-headless

# Terminal 3: RAG++ service
cd core/cc-rag-plus-plus && python -m rag_plusplus.service.app

# Terminal 4: Orbit server
cd apps/trajectory/trajectory-orbit && cargo run

# Full test suite
cargo test --workspace --all-features

# Run cc-echelon tests specifically
cd core/cc-echelon && cargo test --workspace

# Run E2E local test
./scripts/test_e2e_local.sh quick

# Run benchmarks
cargo bench --workspace