flowchart TB
    subgraph Agents["🤖 AI Coding Agents & IDEs"]
        direction LR
        AG["🚀 Antigravity"]
        OC["💻 OpenCode"]
        CX["⚡ Codex CLI / IDE"]
        OT["🔧 Cursor / Windsurf / Claude"]
    end

    subgraph Transport["🔒 Isolated Zero-HTTP Transport Layer"]
        STDIO["JSON-RPC 2.0 over Stdio\n(No Network Ports / No HTTP Body Parsing)"]
    end

    subgraph MindGate["🧠 MindGate MCP Server (TypeScript)"]
        direction TB
        GUARD["🛡️ Node2Shell Security Guard (CVE-2026-111497)\n• Verifies Patched Runtime (Node >=22.23.4 / >=24.22.1 / >=26.12.1)\n• Disables node:zlib Brotli Decompression APIs at Runtime"]
        
        subgraph Tools["🛠️ MCP Tools & Resources"]
            direction LR
            T1["remember_decision\nSave Architecture & Fixes"]
            T2["recall_context\nBM25 Context Search"]
            T3["log_session_summary\nCross-Agent Handoff"]
            T4["user_preferences\nGlobal Coding Rules"]
        end

        ENGINE["⚙️ Context Router & Workspace Isolation Engine"]
    end

    subgraph Storage["💾 Local Storage (`~/.mindgate/mindgate.db` - SQLite WAL)"]
        direction LR
        DB_MEM[("📌 Memories Table\n(Decisions & Context)")]
        DB_FTS[("🔍 FTS5 Virtual Table\n(BM25 Full-Text Index)")]
        DB_SES[("🔄 Sessions Table\n(Agent Handoff Logs)")]
        DB_PREF[("⚙️ Preferences Table\n(Developer Profile)")]
    end

    AG <--> STDIO
    OC <--> STDIO
    CX <--> STDIO
    OT <--> STDIO
    STDIO <--> GUARD
    GUARD --> Tools
    Tools --> ENGINE
    ENGINE <--> DB_MEM
    ENGINE <--> DB_FTS
    ENGINE <--> DB_SES
    ENGINE <--> DB_PREF

+-------------------+     +-------------------+     +-------------------+
|    Antigravity    |     |     OpenCode      |     |       Codex       |
+---------+---------+     +---------+---------+     +---------+---------+
          |                         |                         |
          +-------------------------+-------------------------+
                                    |
                     [ JSON-RPC 2.0 via Local STDIO ]
                     (No HTTP Server / No Brotli I/O)
                                    |
                                    v
+-----------------------------------------------------------------------+
|                    MINDGATE MCP SERVER (بوابة العقل)                  |
|                                                                       |
|  +-----------------------------------------------------------------+  |
|  | 1. Node2Shell Security Guard (CVE-2026-111497 Protection)       |  |
|  |    - Validates Runtime Version (Node >=22.23.4 / 24.22.1 / 26)  |  |
|  |    - Hard-Blocks node:zlib Brotli Decompression APIs            |  |
|  +-----------------------------------------------------------------+  |
|                                   |                                   |
|                                   v                                   |
|  +-----------------------------------------------------------------+  |
|  | 2. MCP Tool & Resource Router                                   |  |
|  |    - remember_decision()       - log_session_summary()          |  |
|  |    - recall_context()          - set/get_user_preferences()     |  |
|  |    - list_workspaces()         - delete_memory()                |  |
|  +-----------------------------------------------------------------+  |
|                                   |                                   |
|                                   v                                   |
|  +-----------------------------------------------------------------+  |
|  | 3. Local SQLite Engine (~/.mindgate/mindgate.db - WAL Mode)     |  |
|  |    [Memories] + [FTS5 BM25 Search] + [Sessions] + [Preferences] |  |
|  +-----------------------------------------------------------------+  |
+-----------------------------------------------------------------------+

git clone https://github.com/your-username/mindgate-mcp.git
cd mindgate-mcp
npm install
npm run build

node dist/index.js init

{
  "mcpServers": {
    "mindgate": {
      "command": "node",
      "args": ["/absolute/path/to/mindgate-mcp/dist/index.js"],
      "env": {
        "MINDGATE_DEFAULT_WORKSPACE": "my-project"
      }
    }
  }
}

{
  "mcp": {
    "mindgate": {
      "type": "local",
      "command": ["node", "/absolute/path/to/mindgate-mcp/dist/index.js"],
      "enabled": true
    }
  }
}

[mcp_servers.mindgate]
command = "node"
args = ["/absolute/path/to/mindgate-mcp/dist/index.js"]

mindgate-mcp/
├── package.json                  # Package manifest & Node2Shell engine constraints
├── tsconfig.json                 # Strict TypeScript compiler configuration
├── README.md                     # English documentation & architecture diagrams
├── README.ar.md                  # Arabic documentation & architecture diagrams
├── LICENSE                       # MIT Open-Source License
└── src/
    ├── index.ts                  # Main MCP server entrypoint & CLI init helper
    ├── security/
    │   └── node2shellGuard.ts    # Runtime CVE-2026-111497 (Node2Shell) guard & zlib lock
    └── db/
        └── memoryStore.ts        # Local SQLite WAL + FTS5 BM25 storage engine