Diagrams & Workflows

End-to-End Search Flow

sequenceDiagram
    autonumber
    actor User as User / AI Agent
    participant API as API Worker (Hono)
    participant D1 as Cloudflare D1 (FTS5)
    participant Vec as Vectorize + Workers AI
    participant Graph as Knowledge Graph

    User->>API: GET /api/search?q=auth&type=hybrid
    par Keyword Search
        API->>D1: Match FTS5 Trigrams (BM25)
        D1-->>API: Keyword ranked rows
    and Semantic Search
        API->>Vec: Query Embeddings (Cosine Sim)
        Vec-->>API: Vector similarity rows
    end
    API->>Graph: Calculate connectivity boost
    Graph-->>API: Graph boost weights
    API->>API: Fuse scores via Reciprocal Rank Fusion (RRF)
    API-->>User: Ranked JSON search results

Secrets Management Lifecycle

flowchart TD
    A[Admin creates secret] -->|AES-256-GCM| B[Encrypted D1 Store]
    B --> C{Access Request}
    C -->|JWT / API Key check| D{Permission Granted?}
    D -->|No| E[HTTP 403 Forbidden]
    D -->|Yes (Reveal)| F[Audit Log Recorded]
    F --> G[Plaintext Value Returned]