24Subpackages
670Python Modules
97Rust Modules
25,381Rust LOC

Python Subpackages

PackageModulesResponsibility
monitor8719 dynamical observers: R, PLV, PAC, chimera, Lyapunov, entropy, TE, EVS, sleep, winding, ITPC, PID, NPE, STL, Poincaré, HCP, psychedelic, session gate
upde7312 UPDE engine variants (Kuramoto, Stuart-Landau, Inertial, Swarmalator, Simplicial, Stochastic, Geometric, Delay, Ott-Antonsen, Hypergraph, Variational, Market)
runtime54gRPC server, Redis state, Prometheus metrics, OpenTelemetry export, service lifecycle
supervisor45Regime manager (NOMINAL/DEGRADED/CRITICAL), policy engine, MPC, Petri nets, coherence projector
coupling26Knm construction, Hodge decomposition, plasticity, TE-adaptive, spectral, connectome, prior
nn25JAX differentiable: KuramotoLayer, StuartLandauLayer, BOLD generator, Reservoir, UDE, Inverse, OIM, SAF spectral loss
studio24Backend for the interactive web studio / demo and SCPN-STUDIO surface
binding23YAML spec loading, validation, schema enforcement
adapters2212 bridges: OpenTelemetry, Modbus TLS, Redis, Quantum, Fusion, Plasma, Prometheus, gRPC, WebSocket, MQTT, Nengo, Lava
autotune13Frequency ID, coupling estimation, phase extraction, SINDy data-driven discovery
oscillators10P/I/S phase extractors: Hilbert, event, ring, graph, wavelet, zero-crossing
plugins9Plugin registration and discovery
actuation8Control output mapping with safety constraints
assurance8Assurance and safety-case tooling
ssgf7Self-Stabilising Gauge Field: carrier, ethical constraints, identity costs
apps6QueueWaves FastAPI cascade detector and demo services
grpc_gen4Protocol buffer stubs for the gRPC service
reporting4Coherence plots and PDF reporting
visualization3D3 network graph, Three.js torus, matplotlib
drivers3External forcing across P/I/S channels
imprint2History-dependent coupling modulation
scaffold1Domainpack scaffolding generator
meta1Package metadata and capability registry
artifacts1Evidence and artifact management

The 24 supported subpackages above hold 459 modules; a research/experimental surface (213 modules) and the package top level make up the rest, for 670 Python package modules overall. The generated capability inventory is the source of truth for module, Rust-file, test, and documentation counts.

Rust Kernel (spo-kernel)

7 Rust crates. PyO3 cdylib + WebAssembly target. Pure Python fallback guaranteed.

CrateModulesPurpose
spo-engine57All 12 UPDE engines, coupling, monitors, SSGF, autotune in Rust
spo-supervisor11Regime manager, policy, coherence projector
spo-oscillators5Phase extraction (P/I/S channels)
spo-types5Shared config and state types
spo-ffi1PyO3 bindings (cdylib)
spo-wasm1WebAssembly target (browser demo)
spo-fpgaFPGA / Zynq-7020 target scaffold

Optional Dependencies

[rust]
spo-kernel. 2.4×–96× acceleration. Auto-delegates when available.
[nn]
JAX + Equinox + Optax. Differentiable Kuramoto, GPU, JIT.
[quantum]
scpn-quantum-control. Quantum XY Hamiltonian bridge.
[plasma]
scpn-control. Plasma/MHD control bridge.
[fusion]
scpn-fusion-core. Tokamak equilibrium bridge.
[queuewaves]
FastAPI + uvicorn + WebSocket. QueueWaves cascade detection app.
[otel]
OpenTelemetry export. Trace/metric pipeline for production.
[full]
Everything: gRPC, Modbus, neurolib, ripser, rtamt, diffrax.