⚙️ Sovereign OS Subsystems Catalog

🏠 Home | 🎛️ Console | 🤖 Copilot | 📐 Architecture | ⚙️ Subsystems | 🌐 API Reference | 💻 REPL Commands | ☸️ K8s CRDs | 🛡️ Invariants & Rules | 🔄 Bi-Directional Sync

---

1. SPRL — Sovereign Peer Reputation Layer (ops/sprl)

**Purpose**: Calculates and maintains decentralized reputation scores for peer nodes and agents based on ticket completion rates, SLA adherence, and gossip honesty.

**Key Structs**: PeerReputation, ReputationManager, ReputationScore.

**Invariants**: Reputation decays exponentially on unverified claims; zero-fault history increases peer trust radius.

2. SUVL — Sovereign Unit Valuation Layer (ops/suvl)

**Purpose**: Dynamic pricing and valuation engine for cognitive compute units, micro-transactions, and gas expenditure forecasting.

**Key Structs**: UnitValuationEngine, ComputeUnitPrice, ValuationMetrics.

**Invariants**: Strictly enforces live on-chain and hardware telemetry pricing; zero synthetic numbers.

3. Master Operator Console (ops/operator_console)

**Purpose**: Central operative command center and single pane of glass for human operators and sovereign agents. Unites the embedded Sovereign Copilot workspace, 12-layer civilizational matrix, and interactive kernel REPL. Detailed in Master Operator Console Specification.

**Key Structs**: OperatorDashboard, ConsoleNodeView, ConsoleMissionView, ConsoleReliabilityView, ConsoleUpgradeView, ConsoleAccessView.

**HTTP Endpoints**:

- GET / & GET /console — Interactive Master Operator Console HTML UI

- GET /console/dashboard — JSON telemetry payload

4. Economic Substrate (governance/economic_substrate & economy/pqr_coin)

**Purpose**: Dual-entry atomic ledger accounting for the sovereign currency (PQR Coin). Tracks hot balances, mission escrows, and miner rewards.

**Key Structs**: EconomicSubstrate, AccountLedger, PqrCoin, TransactionReceipt.

**HTTP Endpoints**: Exposed via PQR API (/pqr/*).

5. PQR API (ops/pqr_api)

**Purpose**: REST and programmatic API contracts for querying account balances, executing atomic transfers, and disbursing mission bounties.

**Key Structs**: WalletBalanceRequest, WalletBalanceResponse, TransferRequest, RewardRequest.

**HTTP Endpoints**:

- POST /pqr/wallet/balance

- POST /pqr/mission/balance

- POST /pqr/transfer

- POST /pqr/reward

6. Cognitive Surface (ops/cognitive_surface)

**Purpose**: Intent classification, semantic prompt routing, and agent persona arbitration.

**Key Structs**: CognitiveSurface, IntentClassification, LaneHint.

7. Cognitive Bridge & Sovereign Copilot (ops/cognitive_bridge)

**Purpose**: Multi-LLM hybrid router bridging the cluster's 24/7 headless Copilot browser (gemma-cobrowser:3456), local Ollama/NPU models (qwen2:1.5b), Claude, Gemini, and native Rust provers. Powers the embedded Sovereign Copilot workspace. Detailed in Copilot Interface Specification.

**Key Structs**: CognitiveBridge, CognitiveExecutionRequest, CognitiveExecutionResult, PromptPlan.

**HTTP Endpoints**:

- POST /api/copilot/chat — Interactive Sovereign Copilot prompt endpoint

- GET /api/copilot/history — Session turn history

- POST /cog/execute — Kernel cognitive execution surface

8. SAMC — Sovereign Autonomic Mission Controller (ops/samc)

**Purpose**: High-level autonomic mission planner and supervisor. Decomposes macro directives into discrete 5DHCP tickets, assigns agents, and tracks lifecycle states.

**Key Structs**: MissionController, MissionContract, MissionTicketAssignment.

9. SAEL — Sovereign Audit & Event Ledger (ops/sael)

**Purpose**: Append-only cryptographic audit trail recording all state mutations, tickets, CLI commands, and macro-decisions.

**Key Structs**: AuditLedger, AuditEvent, AuditEventKind, MerkleReceipt.

10. HUD Unification (ops/hud_unification)

**Purpose**: Single Source of Truth aggregator for operator cockpits. Consolidates mesh topology, peer reputations, wallet balances, autonomic status, and macro tensors into a single payload.

**Key Structs**: HudMasterSnapshot, HudAuditReport.

**HTTP Endpoints**: GET /hud/master, GET /hud/audit.

11. Autonomic Playbooks (ops/autonomic_playbooks)

**Purpose**: Self-healing incident response and policy automation engine. Executes pre-approved runbooks when telemetry breaches safety thresholds.

**Key Structs**: Playbook, AutonomicPolicy, PlaybookRun, PlaybookAuditReport.

**HTTP Endpoints**:

- GET /autonomic/playbooks, POST /autonomic/playbooks

- GET /autonomic/policies, POST /autonomic/policies

- POST /autonomic/playbooks/:id/run

- GET /autonomic/runs

- GET /autonomic/audit

12. SCK — Sovereign Civilization Kernel (ops/civilization_kernel)

**Purpose**: Highest-order steering kernel. Evaluates 12-dimensional civilizational tensors ($C_{12}$), applies policy constraints, and authorizes macro-evolutionary state deltas.

**Key Structs**: CivilizationKernel, CivilizationTensor, CivilizationState, CivilizationDelta, CivilizationDecision, CivilizationExecutionReceipt.

**HTTP Endpoints**:

- GET /civilization/state

- POST /civilization/decision

- POST /civilization/execute

- GET /civilization/audit