Architecture

🌌 Architecture

Overview

Browser / Electron
       │
       ▼
React 18 SPA (React Router v6)
  ├─ /              → OverviewPage  (Three.js 176-node hypergraph + telemetry)
  ├─ /jarvis        → JarvisPage   (multi-persona chat, voice TTS/STT, SSE stream)
  ├─ /subsystems    → SubsystemsPage (176-card catalog + detail modal + probe)
  ├─ /cockpit       → CockpitPage  (quantum hardware runner panel)
  └─ /mcp           → MCPPage      (JSON-RPC 2.0 raw console)
       │
       │  REST /api/*    WebSocket /ws
       ▼
Python ZASIUnifiedHandler (http.server + RFC 6455)
  ├─ Auth middleware   (X-API-Key header, ZASI_API_KEY env)
  ├─ Rate limiter      (60 req/min sliding window per IP)
  ├─ REST router       (28 GET/POST endpoints)
  ├─ SSE streamer      (/api/jarvis/stream)
  ├─ WebSocket server  (/ws — 2s telemetry broadcast)
  ├─ SQLite state      (data/zasi_state.db)
  ├─ Gemini bridge     (GEMINI_API_KEY → Gemini 2.0 Flash)
  └─ Background daemon (30s autonomous cognitive ticks)
       │
       ▼
176-Subsystem Engine (src/)
  ├─ Formal Core       (#1–#128)  — SMT, QEC, ZK-STARK, MCTS
  ├─ Real Hardware      (#129–#136) — FPGA, QPU, HSM, DNA sequencer
  ├─ Omniversal Cores  (#137–#168) — Apex Prime, consciousness grid
  └─ Hyper-Cosmology   (#169–#176) — Hilbert space, wormhole router

Key Design Principles

• Zero external runtime dependencies — pure Python stdlib backend
• SPA fallback routing — all client routes (/jarvis, /subsystems, etc.) served index.html
• Formal invariant guarantees — every cognitive cycle verified by First-Order SMT
• Safe RSI — upgrades require Pareto dominance + debate consensus + governor audit