# Mock-Only AI Router Implementation Scope

Status: next-phase candidate, not started.

Date: 2026-07-04

## Purpose

Define the smallest safe implementation scope for AI Integration's mock-only AI Router.

This is not real AI execution. It is a local routing decision layer that explains which worker and provider should handle an `MccIntent`.

## In Scope

- Add worker routing metadata:
  - strengths
  - weaknesses
  - defaultModules
  - reviewTypes
- Add provider routing metadata:
  - strengths
  - weaknesses
  - costClass
  - speedClass
  - reliabilityClass
  - contextLimit
- Add pure local function:

```text
routeMccIntent(intent, workers, providers)
```

- Return a routing decision:
  - selected worker
  - selected provider
  - required reviewers
  - fallback plan
  - approval required flag
  - reason
- Default provider remains `mock`.
- Add unit tests for routing decisions.
- Add MCC UI status only if it can stay small and registry-driven.

## Out of Scope

- Real OpenAI / Claude / Gemini / other provider calls.
- Paid API execution.
- Background autonomous execution.
- Google/GitHub/Cloudflare real auth.
- Production Deploy.
- Version4.
- Replacing Codex Handoff.

## Safe First Routing Rules

| Intent Type | Worker | Provider | Review |
| --- | --- | --- | --- |
| MCC development | Codex | mock | Architect + QA |
| Research | Gemini / Research AI | mock | Documentation |
| Security-sensitive | Security Reviewer | mock | Security |
| Docs | Documentation AI | mock | Mia review |
| Unknown | Mia | mock | Architect review |

## Completion Conditions

- `npm test` pass.
- `npm run test:smoke` pass if UI changes.
- HTTP 200.
- secret scan has no findings.
- no external auth.
- no paid API.
- working tree clean.
- local commit created.

## Recommended Next Prompt

Implement mock-only AI Router as a registry-driven local module. Do not call real AI providers. Do not add credentials. Keep Smart Inbox, Codex Handoff, Timeline/Logs, Worker Registry, and AI Provider Registry stable.