162 Python modules across 18 subpackages + 54 Rust modules in spo-kernel (20,784 LOC).
| Package | Modules | Responsibility |
|---|---|---|
| upde | 25 | 12 UPDE engine variants (Kuramoto, Stuart-Landau, Inertial, Swarmalator, Simplicial, Stochastic, Geometric, Delay, Ott-Antonsen, Hypergraph, Variational, Market) |
| monitor | 20 | 19 dynamical observers: R, PLV, PAC, chimera, Lyapunov, entropy, TE, EVS, sleep, winding, ITPC, PID, NPE, STL, Poincaré, HCP, psychedelic, session gate |
| adapters | 18 | 12 bridges: OpenTelemetry, Modbus TLS, Redis, Quantum, Fusion, Plasma, Prometheus, gRPC, WebSocket, MQTT, Nengo, Lava |
| nn | 14 | JAX differentiable: KuramotoLayer, StuartLandauLayer, BOLD generator, Reservoir, UDE, Inverse, OIM, SAF spectral loss |
| coupling | 12 | Knm construction, Hodge decomposition, plasticity, TE-adaptive, spectral, connectome, prior |
| ssgf | 8 | Self-Stabilising Gauge Field: carrier, ethical constraints, identity costs |
| supervisor | 8 | Regime manager (NOMINAL/DEGRADED/CRITICAL), policy engine, MPC, Petri nets, coherence projector |
| oscillators | 7 | P/I/S phase extractors: Hilbert, event, ring, graph, wavelet, zero-crossing |
| autotune | 6 | Frequency ID, coupling estimation, phase extraction, SINDy data-driven discovery |
| binding | 5 | YAML spec loading, validation, schema enforcement |
| grpc_gen | 5 | Protocol buffer stubs for gRPC service |
| drivers | 4 | External forcing across P/I/S channels |
| actuation | 4 | Control output mapping with safety constraints |
| visualization | 4 | D3 network graph, Three.js torus, matplotlib |
| imprint | 3 | History-dependent coupling modulation |
| audit | 3 | SHA256-chained JSONL audit trail + replay |
| reporting | 2 | Coherence plots and PDF reporting |
| apps | 1 | QueueWaves FastAPI cascade detector |
5 Rust crates. PyO3 cdylib + WebAssembly target. Pure Python fallback guaranteed.
| Crate | Modules | Purpose |
|---|---|---|
| spo-engine | 53 | All 12 UPDE engines, coupling, monitors, SSGF, autotune in Rust |
| spo-oscillators | 5 | Phase extraction (P/I/S channels) |
| spo-supervisor | 6 | Regime manager, policy, coherence projector |
| spo-types | 4 | Shared config and state types |
| spo-ffi | 1 | PyO3 bindings (cdylib) |
| spo-wasm | — | WebAssembly target (browser demo) |
[rust][nn][quantum][plasma][fusion][queuewaves][otel][full]