• Store: ~15ms average
  • Context build: ~25ms
  • Batch ops: 1000+/sec

    • 📊 Capacity

    Request Flow

    How a typical API request flows through the system:

    Client Request
      │
      ▼
┌─────────────┐
│   Nginx     │ ← SSL termination, rate limiting
│   Gateway   │
└──────┬──────┘
       │
       ▼
┌─────────────┐
│    Auth     │ ← API key validation, JWT decode
│   Service   │
└──────┬──────┘
       │
       ▼
┌─────────────┐
│  ProBridgeZ │ ← Route to appropriate service
│   Router    │
└──────┬──────┘
       │
       ├─────────────────┬─────────────────┬─────────────────┐
       ▼                 ▼                 ▼                 ▼
┌─────────────┐   ┌─────────────┐   ┌─────────────┐   ┌─────────────┐
│    Query    │   │   Memory    │   │  Codebase   │   │   Agent     │
│   Handler   │   │   Handler   │   │   Handler   │   │   Handler   │
└──────┬──────┘   └──────┬──────┘   └──────┬──────┘   └──────┬──────┘
       │                 │                 │                 │
       │                 ▼                 │                 │
       │          ┌─────────────┐          │                 │
       │          │Memory Spine │          │                 │
       │          │  Context    │          │                 │
       │          └─────────────┘          │                 │
       │                 │                 │                 │
       └─────────────────┴─────────────────┴─────────────────┘
                                   │
                                   ▼
                          ┌─────────────────┐
                          │   LLM Provider  │
                          │ OpenAI/Anthropic│
                          └────────┬────────┘
                                   │
                                   ▼
                          ┌─────────────────┐
                          │ Response + Cache│
                          └─────────────────┘

    Repository Services (13)

    Specialized services for extended functionality.

    ServicePortPurpose
    AUIE8850UI generation, 100 capabilities
    Agent-Economy8851Multi-agent framework, 5 agent types
    AgentZ8852Agent mesh, discovery, clustering
    ThirdEye8858World events monitoring
    ZDownload8860Download manager
    ASCII Art8862ASCII art generation

    Data Flow & Storage

    Memory Spine Data Flow

    User Input → Embedding → Vector Store → Index Update
                                              ↓
                                         Knowledge Graph Update
                                              ↓
                                         Deduplication Check
                                              ↓
                                         Persistence (SQLite)

    Storage Systems

    🧠 Vector Database

    Memory Spine's vector storage for semantic search. Uses sentence-transformers for embeddings.

    • Capacity: 50,000 vectors
    • Model: all-MiniLM-L6-v2
    • Similarity: Cosine

    📄 SQLite

    Metadata storage for memories, sessions, and configuration.

    • Location: /var/lib/memory-spine/
    • Backup: Daily automated
    • WAL mode enabled

    ⚡ Redis (Optional)

    High-speed cache for sessions and frequently accessed data.

    • Session cache: 24h TTL
    • Rate limit counters
    • Pub/sub for events

    Security Architecture

    🔐 Authentication

    • API key authentication (Bearer tokens)
    • JWT for session management
    • OAuth2 integration (GitHub)
    • Key rotation support

    🛡️ Network Security

    • TLS 1.3 everywhere
    • UFW firewall rules
    • Fail2ban protection
    • DDoS mitigation

    📝 Data Security

    • Encryption at rest
    • API key hashing (SHA256)
    • Memory isolation per user
    • GDPR compliance tools

    🔍 Monitoring

    • Real-time health dashboard
    • Automated security scans
    • Audit logging
    • Anomaly detection

    Scaling Strategy

    Current Infrastructure

    Running on VPS3 (primary) with optional VPS1/VPS2 workers:

    Horizontal Scaling

                        ┌─────────────┐
                    │Load Balancer│
                    └──────┬──────┘
                           │
          ┌────────────────┼────────────────┐
          ▼                ▼                ▼
   ┌─────────────┐  ┌─────────────┐  ┌─────────────┐
   │   VPS3      │  │   Worker 1  │  │   Worker 2  │
   │   Primary   │  │   (VPS1)    │  │   (VPS2)    │
   │   32GB RAM  │  │   2GB RAM   │  │   8GB RAM   │
   └─────────────┘  └─────────────┘  └─────────────┘
          │
          ▼
   ┌─────────────────────────────────────────┐
   │         Shared Memory Spine             │
   │         (Central State)                 │
   └─────────────────────────────────────────┘

    Chaoz Orchestration

    Chaoz (tmux-hero) manages agent scaling and distribution:

    # Auto-scale based on load
chaoz adaptive start

# Manual scaling
chaoz swarm 5           # Spawn 5 agents
chaoz scaler up 3       # Add 3 workers
chaoz cluster           # View cluster status