+-------------------------------------------------------------------+
                   |                         AI Coding Agents                          |
                   |       Antigravity • Cursor • Claude Code • Codex • Windsurf       |
                   +-------------------------------------------------------------------+
                                                     |
                                                     | Model Context Protocol (MCP 2024-11-05)
                                                     v HTTP JSON-RPC 2.0 (127.0.0.1:7890/mcp)
+------------------------------------------------------------------------------------------------------+
|                                    AgentXFlow Coordinator Daemon                                     |
|                                                                                                      |
|  [ Masterplan Hub ]      [ Scope Engine ]         [ Policy Engine ]      [ Verification Engine ]     |
|  - Task Decomposition    - File Glob Leases       - Execution Rules      - Cargo / NPM Evaluators    |
|  - Step Reservations     - Mutation Auditing      - Guardrail Policies   - SHA-256 Proof Bundles     |
|                                                                                                      |
|  [ SQLite WAL Database (Migrations 1–18) ]     [ Serialized FIFO Integration Worktree Queue (CAS) ]  |
+------------------------------------------------------------------------------------------------------+
           |                                         |                                     |
           v                                         v                                     v
+-----------------------+                 +-----------------------+             +-----------------------+
|  Git Worktree #1      |                 |  Git Worktree #2      |             | Integration Worktree  |
|  Branch: task-auth-1  |                 |  Branch: task-ui-2    |             | .agentxflow/integr... |
|  Agent: Antigravity   |                 |  Agent: Cursor        |             | CAS -> refs/heads/main|
+-----------------------+                 +-----------------------+             +-----------------------+

:: 1. Run setup script to install dependencies and build assets
setup.bat

:: 2. Launch AgentXFlow
run.bat

# 1. Clone the repository
git clone https://github.com/harlixay7/AgentXFlow.git
cd AgentXFlow

# 2. Install dependencies and build frontend assets
npm install
npm run build

# 3. Launch Tauri application in development mode
npm run tauri dev

{
  "mcpServers": {
    "agentxflow": {
      "url": "http://127.0.0.1:7890/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer <YOUR_COORDINATOR_TOKEN>"
      }
    }
  }
}

{
  "mcpServers": {
    "agentxflow": {
      "url": "http://127.0.0.1:7890/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_COORDINATOR_TOKEN>"
      }
    }
  }
}

{
  "mcpServers": {
    "agentxflow": {
      "url": "http://127.0.0.1:7890/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer <YOUR_COORDINATOR_TOKEN>"
      }
    }
  }
}

[ 1. Discovery & Registration ]
  agentxflow_current_context -> Returns active project, assigned task, and next recommended action.
  agent_register             -> Registers canonical agent name ("Antigravity", "Cursor", "Claude Code").

[ 2. Planning & Chunking ]
  masterplan_get             -> Reads the active masterplan.
  masterplan_decompose       -> Normalizes raw specifications into structured steps.
  masterplan_claim_chunk     -> Atomically reserves a batch of steps and provisions an isolated Git worktree.

[ 3. Lease Acquisition & Implementation ]
  scope_acquire              -> Locks file patterns (e.g. ['src/core/**', 'tests/core_test.rs']).
  task_workspace_write/read  -> Reads and writes code inside the isolated Git worktree.

[ 4. Verification & Submission ]
  task_complete_step         -> Records command verification output for each completed step.
  task_submit                -> Triggers automated test evaluators, audits diffs, and creates ProofBundle.

[ 5. Serialized Integration ]
  merge_enqueue              -> Verified task enters the serialized FIFO merge queue.
  merge_process              -> Background worker tests merge in integration worktree and CAS updates main.

# 1. Run full Rust backend test suite (171+ tests across unit, integration, and security suites)
cargo test --manifest-path src-tauri/Cargo.toml --all-targets

# 2. Run complete end-to-end pipeline test
cargo test --test pipeline_a_to_z_test --manifest-path src-tauri/Cargo.toml

# 3. Run adversarial concurrency and security test suite
cargo test --test adversarial_suite_test --manifest-path src-tauri/Cargo.toml

# 4. Strict Rust linter check (zero warnings allowed)
cargo clippy --manifest-path src-tauri/Cargo.toml --all-targets -- -D warnings

# 5. Rust format check
cargo fmt --manifest-path src-tauri/Cargo.toml --check

# 6. TypeScript type-check
npm test

# 7. Production frontend Vite build
npm run build

AgentXFlow/
├── src-tauri/                   # Rust Core & Tauri Desktop Host
│   ├── src/
│   │   ├── core/                # Coordinator state machine, workspace proxies, IPC endpoints
│   │   ├── mcp/                 # Model Context Protocol (MCP 2024-11-05) Axum HTTP server
│   │   ├── scope/               # Glob pattern collision detection & mutation audit engine
│   │   ├── policies/            # Deterministic policy engine with longest-prefix matching
│   │   ├── security/            # Constant-time token comparison & cryptographic session storage
│   │   ├── dag/                 # Directed Acyclic Graph dependency scheduler
│   │   ├── verification/        # Automated test evaluators & SHA-256 ProofBundle sealing
│   │   ├── merge/               # Serialized FIFO merge queue & disposable integration worktree
│   │   ├── scheduler/           # Background reconciliation & stale agent reclamation sweeps
│   │   ├── db/                  # SQLite migrations (1–18), WAL mode, and mutex locking
│   │   └── git/                 # Git worktree lifecycle, porcelain parsing, and CAS ref advancement
│   └── tests/                   # Concurrency, security, and pipeline test suites
├── src/                         # React 19 Frontend Workbench
│   ├── components/              # Mission Control, Work View, Review Center, etc.
│   ├── api/                     # Tauri IPC client & coordinator API bindings
│   └── index.css                # High-contrast design tokens, 2px/6px radii, tabular numbers
├── scripts/                     # MCP client helper & standalone offline Node MCP bridge
├── docs/                        # Specifications, architecture blueprints, and audit records
├── AGENT_SETUP.md               # Quickstart guide for AI agents and automated workflows
├── SKILL.md                     # Canonical Google Antigravity & AI Agent Skill specification
└── package.json                 # Project manifest & build scripts