ARCHITECTURE.md

Architecture

Full documentation: docs/architecture.md

┌──────────────────────────────────────────────────────────────────────┐
│                              CLI                                     │
│                   src/cli/index.ts (Commander)                       │
│                                                                      │
│   index ──── scan + embed + save + exit                              │
│   serve ──── HTTP server + MCP + REST API + UI + WebSocket           │
│   users ──── user management (add users to config)                   │
└──────────────────────────┬───────────────────────────────────────────┘
                           │
            ┌──────────────┴──────────────┐
            ▼                              ▼
     ┌─────────────┐            ┌──────────────────┐
     │ YAML Config │            │ ProjectManager   │
     │ (Zod valid) │            │ (multi-project)  │
     └──────┬──────┘            └────────┬─────────┘
            │                            │
            ▼                            ▼
     ┌──────────────────────────────────────────┐
     │           ProjectIndexer                 │
     │   3 serial queues: docs / code / files   │
     │   chokidar watcher for live updates      │
     └──────────────────┬───────────────────────┘
                        │
                        ▼
     ┌──────────────────────────────────────────┐
     │         Embedding (transformers.js)      │
     │   embed() / embedBatch() / loadModel()   │
     │   named registry + model deduplication   │
     └──────────────────┬───────────────────────┘
                        │
                        ▼
     ┌──────────────────────────────────────────┐
     │           Graphs (Graphology)            │
     │                                          │
     │   DocGraph ────── markdown chunks        │
     │   CodeGraph ───── AST symbols            │
     │   KnowledgeGraph  user notes + facts     │
     │   FileIndexGraph  all project files      │
     │   TaskGraph ───── tasks + kanban          │
     │   SkillGraph ──── reusable recipes       │
     └──────────────────┬───────────────────────┘
                        │
     ┌──────────────────┴───────────────────────┐
     │        Graph Managers (unified API)       │
     │                                          │
     │   embed + CRUD + dirty + events          │
     │   + cross-graph cleanup                  │
     └──────────────────┬───────────────────────┘
                        │
         ┌──────────────┼──────────────┐
         ▼              ▼              ▼
     ┌────────┐   ┌──────────┐   ┌──────────┐
     │  MCP   │   │ REST API │   │    UI    │
     │ Tools  │   │ Express  │   │  React   │
     │ (58)   │   │ + WS     │   │  + Vite  │
     └────────┘   └──────────┘   └──────────┘

Detailed documentation

Topic	Document
System architecture	docs/architecture.md
Configuration	docs/configuration.md
CLI commands	docs/cli.md
Indexing pipeline	docs/indexer.md
File watching	docs/watcher.md
Graph types	docs/graphs-overview.md
Search algorithms	docs/search.md
Embedding system	docs/embeddings.md
REST API	docs/api-rest.md
MCP tools	docs/api-mcp.md
Authentication	docs/authentication.md
Security	docs/security.md
File mirror	docs/file-mirror.md
UI architecture	docs/ui-architecture.md
Testing	docs/testing.md