Repository navigation
SuperX becomes a platform: everything since v1.0.0 (2026-08-18) arrived as pluggable modules on the epic #141 contract — own database, dir, log, CLI, parameters, UUIDv7 identity, first-class ledger row — while the kernel stayed locked (one author: the operator, now CI-enforced).
Modules
- Entities (epic #166) — the product graph substrate: typed nodes (18 seeded types, runtime-extensible), native SurrealDB edges, identity/state split, text-as-entity, documents as nodes, BFS tree/JSON traversal, full append-only history.
- Runner (epic #189) — schedule any entity, plan dependency waves with cycle refusal, execute task nodes via the configured agent command with parallel dispatch, write results back into the graph, steerable in flight.
- UI, unified (#172–#208) — sessions are the top-level grouping of ALL captured activity; ONE live feed everywhere (history + SSE, chronological, auto-scrolling, every row session-attributed, CVD-validated dark palette); context-window bars, token telemetry, and total-activity counts per session; row-click navigation; whitelisted console.
Framework & operations
- Full module facility contract + live enable/disable + module registration ledger (schema v2.2) +
superx-mod-helloreference + contribution guide (docs/MODULES.md). - Self-upgrading schema path: a new binary on an older substrate never bricks the boot (#158).
- Module contract cemented: KERNEL OFF LIMITS banner + a kernel-immutability CI gate — PRs touching
crates/superx-kernel/fail without an operator-written approval marker (#210). - Capture hardening: sessions attributed from transcript filenames (no more 'unknown'), unparseable lines carry their session (#186),
session_discoveredpayload contract (#209 records the operator ratify/revert decision).
Gates on the release commit: cargo test --workspace · clippy -D warnings · skill_audit — all green in CI.