Architecture overview — the 8-axis self-improving vault#

flowchart TB
    %% ── Input layer ───────────────────────────────────────────────
    subgraph IN["📥 Input layer (10-raw / immutable)"]
        SESSIONS[("08-Sessions/<br/>~80 session-logs")]
        RAW[("10-raw/<br/>firecrawl + GitHub<br/>+ NotebookLM")]
        BROWSER[("Browser history<br/>(opt-in NLI-filtered)")]
        AGENTS["3 CLI agents<br/>Claude Code · Codex · Gemini"]
    end

    %% ── Crystallization layer ────────────────────────────────────
    subgraph CRYST["🔮 Crystallization (B-1)"]
        STOP["/11.11stop hook"]
        GEVAL["G-Eval scorer<br/>(96.7% verdict-agreement)"]
        CRITIC["Constitutional Critic<br/>(4-layer safety-gate)"]
        APPLY["VAULT_CRYSTALLIZE_APPLY=1<br/>sandbox branch only"]
    end

    %% ── Memory layer ──────────────────────────────────────────────
    subgraph MEM["🧠 Memory (B-2 + B-7)"]
        KO[("KO-DB<br/>13,800 facts<br/>SQLite + WAL")]
        MEMGRAPH[("Memgraph CE 3.9<br/>8,997 entities<br/>24K edges, 100% typed<br/>native vector-index")]
        BGE["bge-m3 multilingual<br/>warm in vault-search.service"]
        RERANK["bge-reranker-v2-m3<br/>keepalive (Round 3)"]
    end

    %% ── Distilled output ─────────────────────────────────────────
    subgraph OUT["✨ Distilled output (11-wiki / evergreen)"]
        WIKI[("11-wiki/<br/>258 pages<br/>71 EN translations")]
        ADRs[("07-Decisions/<br/>45 ADRs")]
        AUDITS[("06-Audits/<br/>104 reports")]
        PROJ[("02-Projects/<br/>20+ project files")]
    end

    %% ── Tooling layer ────────────────────────────────────────────
    subgraph TOOL["🛠️ Tooling (B-4 + B-6)"]
        SKILLS["962 SkillChunks<br/>vector-indexed"]
        VAULTSEARCH["/usr/local/bin/<br/>vault-search<br/>(auto+daemon delegation)"]
        MCP["vault-mcp<br/>STDIO MCP server<br/>7 read-only tools"]
        SLEEP["vault-sleep-<br/>consolidate<br/>nightly REM"]
    end

    %% ── Eval + RSI layer ─────────────────────────────────────────
    subgraph EVAL["📊 Eval + RSI (B-3 + B-8)"]
        REGRESSION["LongMemEval-S<br/>regression-gate<br/>(67.68% R@5)"]
        GEPA["GEPA Pareto<br/>+14.3% on baseline"]
        RSITIER2["Tier-2 Constitutional<br/>RSI (locked)"]
    end

    %% ── NotebookLM layer ─────────────────────────────────────────
    subgraph NB["🎙️ Cognitive (B-5)"]
        NOTEBOOKLM["NotebookLM<br/>cross-project synthesis<br/>+ 3 podcast episodes"]
    end

    %% ── Flow arrows ──────────────────────────────────────────────
    SESSIONS --> STOP
    RAW --> STOP
    BROWSER --> RAW
    AGENTS --> SESSIONS
    AGENTS --> RAW

    STOP --> GEVAL
    GEVAL --> CRITIC
    CRITIC --> APPLY
    APPLY -.write.-> WIKI
    APPLY -.write.-> ADRs

    SESSIONS --> KO
    RAW --> KO
    KO --> MEMGRAPH
    BGE --> MEMGRAPH
    BGE --> RERANK

    WIKI --> SKILLS
    SKILLS --> VAULTSEARCH
    MEMGRAPH --> VAULTSEARCH
    KO --> VAULTSEARCH

    VAULTSEARCH --> MCP
    MCP --> AGENTS

    SLEEP --> CRYST
    WIKI --> SLEEP

    AUDITS --> REGRESSION
    GEPA -.optimize.-> GEVAL
    RSITIER2 -.locked.-> APPLY
    SESSIONS --> NOTEBOOKLM
    NOTEBOOKLM --> RAW

    %% ── Styling ──────────────────────────────────────────────────
    classDef input fill:#e3f2fd,stroke:#1976d2,color:#000
    classDef cryst fill:#fce4ec,stroke:#c2185b,color:#000
    classDef mem fill:#e8f5e9,stroke:#388e3c,color:#000
    classDef out fill:#fff3e0,stroke:#f57c00,color:#000
    classDef tool fill:#f3e5f5,stroke:#7b1fa2,color:#000
    classDef eval fill:#fff9c4,stroke:#f9a825,color:#000
    classDef nb fill:#e0f7fa,stroke:#0097a7,color:#000

    class SESSIONS,RAW,BROWSER,AGENTS input
    class STOP,GEVAL,CRITIC,APPLY cryst
    class KO,MEMGRAPH,BGE,RERANK mem
    class WIKI,ADRs,AUDITS,PROJ out
    class SKILLS,VAULTSEARCH,MCP,SLEEP tool
    class REGRESSION,GEPA,RSITIER2 eval
    class NOTEBOOKLM nb