# Implementation Plan: Asynchronous Tool Execution Engine (async_tool_execution_20260303)

> **TEST DEBT FIX:** Due to ongoing test architecture instability (documented in `test_architecture_integrity_audit_20260304`), do NOT write new `live_gui` integration tests for this track. Use purely in-process mocks to verify concurrency logic.

## Phase 1: Engine Refactoring
- [x] Task: Initialize MMA Environment `activate_skill mma-orchestrator`
- [x] Task: Refactor `mcp_client.py` for async execution (60e1dce)
    - [x] WHERE: `mcp_client.py`
    - [x] WHAT: Convert tool execution wrappers to `async def` or wrap them in thread executors.
    - [x] HOW: Use `asyncio.to_thread` for blocking I/O bound tools.
    - [x] SAFETY: Ensure thread safety for shared resources.
- [x] Task: Update `ai_client.py` dispatcher (87dbfc5)
    - [x] WHERE: `ai_client.py` (around tool dispatch loop)
    - [x] WHAT: Use `asyncio.gather` to execute multiple tool calls concurrently.
    - [x] HOW: Await the gathered results before proceeding with the AI loop.
    - [x] SAFETY: Handle tool execution exceptions gracefully without crashing the gather group.
- [x] Task: Conductor - User Manual Verification 'Phase 1' (Protocol in workflow.md)

## Phase 2: Testing & Validation
- [x] Task: Implement async tool execution tests (eddc245)
    - [x] WHERE: `tests/test_async_tools.py`
    - [x] WHAT: Write a test verifying that multiple tools run concurrently (e.g., measuring total time vs sum of individual sleep times).
    - [x] HOW: Use a mock tool with an explicit sleep delay.
    - [x] SAFETY: Standard pytest setup.
- [x] Task: Full Suite Validation (3bc900b)
- [x] Task: Conductor - User Manual Verification 'Phase 2' (Protocol in workflow.md)