feat(blog): replace ASCII diagram with Mermaid, add theme-mermaid to site

Author: prih

site/blog/2026-03-26-architecture-deep-dive.md

@@ -12,47 +12,46 @@ Graph Memory exposes 70 MCP tools, a REST API, and a WebSocket event stream from
 
 ## The big picture
 
-```
-┌───────────────────────────────────────────────────┐
-│              MCP Clients                          │
-│         (Claude Code, Cursor, etc.)               │
-└────────────────────┬──────────────────────────────┘
-                     │ Streamable HTTP
-┌────────────────────▼──────────────────────────────┐
-│  HTTP Server                                      │
-│                                                   │
-│  ┌────────────┐ ┌────────────┐ ┌───────────────┐  │
-│  │    MCP     │ │  REST API  │ │   WebSocket   │  │
-│  │  Sessions  │ │   /api/*   │ │   /api/ws     │  │
-│  └─────┬──────┘ └─────┬──────┘ └───────▲───────┘  │
-│        │               │               │          │
-│  ┌─────▼───────────────▼───────────────┐│          │
-│  │  PromiseQueue (per project)         ││          │
-│  │  Serializes all mutations           ├┘          │
-│  └─────┬───────────────────────────────┘           │
-│        │                                           │
-│  ┌─────▼─────────────────────────────────────────┐ │
-│  │  Graph Managers                               │ │
-│  │  ┌──────┐ ┌──────┐ ┌───────────┐ ┌─────────┐ │ │
-│  │  │ Docs │ │ Code │ │ Knowledge │ │  Tasks  │ │ │
-│  │  └──────┘ └──────┘ └───────────┘ └─────────┘ │ │
-│  │  ┌────────┐ ┌───────────┐                     │ │
-│  │  │ Skills │ │ FileIndex │                     │ │
-│  │  └────────┘ └───────────┘                     │ │
-│  └─────┬─────────────────────────────────────────┘ │
-│        │                                           │
-│  ┌─────▼─────────────────────────────────────────┐ │
-│  │  Graphology (DirectedGraph)                   │ │
-│  │  Nodes + edges + embeddings in memory         │ │
-│  └─────┬─────────────────────────────────────────┘ │
-│        │                                           │
-│  ┌─────▼──────┐ ┌───────────┐ ┌───────────────┐   │
-│  │ File Mirror│ │ Embedder  │ │  tree-sitter  │   │
-│  │ .notes/    │ │ BGE-M3    │ │  WASM parser  │   │
-│  │ .tasks/    │ │ (ONNX)    │ │ TS/JS/TSX/JSX │   │
-│  │ .skills/    │ └───────────┘ └───────────────┘   │
-│  └────────────┘                                    │
-└────────────────────────────────────────────────────┘
+```mermaid
+graph TD
+    Clients["MCP Clients<br/>(Claude Code, Cursor, etc.)"]
+    Clients -->|Streamable HTTP| Server
+
+    subgraph Server["HTTP Server"]
+        MCP["MCP Sessions"]
+        REST["REST API /api/*"]
+        WS["WebSocket /api/ws"]
+        Queue["PromiseQueue (per project)<br/>Serializes all mutations"]
+
+        MCP --> Queue
+        REST --> Queue
+        Queue -.->|events| WS
+    end
+
+    subgraph Managers["Graph Managers"]
+        Docs
+        Code
+        Knowledge
+        Tasks
+        Skills
+        FileIndex
+    end
+
+    Queue --> Managers
+
+    subgraph Storage["Graphology (DirectedGraph)"]
+        Nodes["Nodes + edges + embeddings in memory"]
+    end
+
+    Managers --> Storage
+
+    Mirror["File Mirror<br/>.notes/ .tasks/ .skills/"]
+    Embedder["Embedder<br/>BGE-M3 (ONNX)"]
+    TreeSitter["tree-sitter<br/>WASM parser<br/>TS/JS/TSX/JSX"]
+
+    Storage --> Mirror
+    Storage --> Embedder
+    Storage --> TreeSitter
 ```
 
 ## Graphology: the storage layer

site/docusaurus.config.ts

@@ -24,8 +24,11 @@ const config: Config = {
     hooks: {
       onBrokenMarkdownLinks: 'warn',
     },
+    mermaid: true,
   },
 
+  themes: ['@docusaurus/theme-mermaid'],
+
   i18n: {
     defaultLocale: 'en',
     locales: ['en'],