┌────────────────────────────────────────────────────────────────────────┐
│                      REA REVERSE-ENGINEERING PHASES                    │
├────────────────────────────────────────────────────────────────────────┤
│ Phase 1: Legacy "Scratch Pad" Autopsy (Postman v9.x / v10.14)          │
│ • Extracted app.asar (313MB) to map offline architecture without root.  │
│ • Discovered the 10 core IndexedDB stores (collections, requests,      │
│   environments, globals, history, scratchpad, workspaces, etc.).       │
│ • Decoded Electron IPC event bus (PM_EB_INT_BROADCAST_MAIN / REND).    │
│ • Implemented the 7 legacy schema migration rules (dataMode: "raw",   │
│   rawModeData, headerData, compound UID decomposition, etc.).          │
├────────────────────────────────────────────────────────────────────────┤
│ Phase 2: Cloud Sync & Export Mechanics                                 │
│ • Analyzed HAR network waterfall captures for Ctrl+S save requests.    │
│ • Deconstructed runtime variable interpolation & URL path variables.  │
│ • Built bidirectional adapter: UI/IPC state <-> Collection v2.1.0.     │
└────────────────────────────────────────────────────────────────────────┘

flowchart TB
    subgraph Clients["Clients and Autonomous Agents"]
        Agent["AI Agents<br/>(Antigravity / Claude / Cursor)"]
        UI["Dark-Mode WebUI<br/>(Linear / Postman Style)"]
        Desktop["Desktop Application<br/>(Tauri v2 / WebView2)"]
    end

    subgraph OpenPost["OpenPost Core Engine"]
        MCP["Model Context Protocol Server<br/>(backend/mcp_server.py - 23 Tools)"]
        API["FastAPI REST Server<br/>(backend/main.py)"]
        
        Parser["Postman v2.1.0 Parser and Exporter<br/>(backend/collection_parser.py)"]
        Engine["HTTP Dispatcher and Var Engine<br/>(backend/request_engine.py)"]
        Sandbox["Node.js pm.* Script Sandbox<br/>(backend/script_sandbox.js)"]
        Store["Local Persistence Layer<br/>(backend/local_db.py)"]
    end

    subgraph Storage["Zero-Cloud Local Storage"]
        JSONFiles["Flat JSON Collections<br/>(data/collections/*.json)"]
        SQLiteDB["SQLite Database<br/>(data/openpost.db)"]
    end

    Agent <-->|"MCP Protocol (stdio/HTTP)"| MCP
    UI <-->|"REST API"| API
    Desktop <-->|"Localhost / IPC"| API

    MCP --> Parser
    MCP --> Engine
    MCP --> Store
    MCP --> Sandbox

    API --> Parser
    API --> Engine
    API --> Store
    API --> Sandbox

    Parser <--> JSONFiles
    Store <--> SQLiteDB
    Engine --> Sandbox

{
  "mcpServers": {
    "openpost": {
      "command": "python",
      "args": ["-m", "backend.mcp_server"],
      "cwd": "/path/to/openpost",
      "env": {
        "PYTHONPATH": "/path/to/openpost;/path/to/openpost/rea_pkg"
      }
    }
  }
}

// Pre-request Script:
pm.environment.set("request_id", "req_" + Date.now());

// Test Script (Chai-Compatible Assertions):
pm.test("Status code is 200", function () {
    pm.response.to.have.status(200);
});

pm.test("Response body matches schema", function () {
    var json = pm.response.json();
    pm.expect(json.status).to.equal("success");
    pm.expect(json.data.user.email).to.include("@example.com");
});

// Chaining Tokens into Environment for Downstream Requests:
pm.environment.set("auth_token", pm.response.json().token);

git clone https://github.com/zshortbusz/openpost.git
cd openpost

python -m venv .venv
.\.venv\Scripts\activate

pip install -r requirements.txt

uvicorn backend.main:app --port 8000 --reload

python desktop/run_desktop.py
# Or: npm run desktop:launch

# Development:
npm run desktop:dev

# Build Windows MSI and EXE Installers:
npm run desktop:build

# In an Administrator PowerShell terminal:
python scripts/block_postman_hosts.py --enable

# Undo / restore hosts file at any time:
python scripts/block_postman_hosts.py --restore

# Check current block status:
python scripts/block_postman_hosts.py --status

pytest -v