# yuxiaoma66/antigravity-mission-control architecture

> Architecture diagram of the GitHub repository yuxiaoma66/antigravity-mission-control, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yuxiaoma66/antigravity-mission-control
- Repository: https://github.com/yuxiaoma66/antigravity-mission-control

## Overview

Antigravity Mission Control is a policy-aware command-line orchestrator for Antigravity workers, used alongside a human-supervised coding agent. The workflow is to inspect policy and model choices, obtain task-bound approval, dispatch bounded work, then inspect durable job results and workspace evidence; acceptance remains with the host agent. Separate capabilities cover quota telemetry, workspace trust, host Skill installation, and runtime diagnostics. The map uses the documented commands and sampled module responsibilities; unsampled internal call wiring is kept conservative.

Main entry points: [`antigravity_mission_control/cli.py`](https://github.com/yuxiaoma66/antigravity-mission-control/blob/main/antigravity_mission_control/cli.py) (Command Interface), [`antigravity_mission_control/jobs.py`](https://github.com/yuxiaoma66/antigravity-mission-control/blob/main/antigravity_mission_control/jobs.py) (Worker Lifecycle), [`antigravity_mission_control/approvals.py`](https://github.com/yuxiaoma66/antigravity-mission-control/blob/main/antigravity_mission_control/approvals.py) (Bound Approvals), [`antigravity_mission_control/routing.py`](https://github.com/yuxiaoma66/antigravity-mission-control/blob/main/antigravity_mission_control/routing.py) (Model Routing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["User Control"]
  node_cli["Command Interface<br/>[cli.py]"]
end

subgraph group_governance["Policy And Routing"]
  node_approval["Bound Approvals<br/>[approvals.py]"]
  node_policies["Policy Presets"]
  node_routing["Model Routing<br/>[routing.py]"]
  node_workspace["Workspace Trust<br/>[workspace.py]"]
end

subgraph group_execution["Worker Execution"]
  node_jobs["Worker Lifecycle<br/>[jobs.py]"]
  node_jobstore[("Durable Jobs<br/>[jobstore.py]")]
  node_evidence["Change Evidence<br/>[workspace.py]"]
end

subgraph group_operations["Operations"]
  node_quota["Quota Telemetry<br/>[usage.py]"]
  node_skill["Host Skill Setup<br/>[skill.py]"]
  node_skillcontent["Skill Guidance"]
  node_diagnostics["Runtime Checks<br/>[cli.py]"]
end

node_host(("Host Agent / User"))
node_agy["Antigravity CLI"]

node_host -->|"invokes commands"| node_cli
node_cli -->|"creates approvals"| node_approval
node_approval -->|"loads policy"| node_policies
node_cli -->|"selects models"| node_routing
node_routing -->|"lists models"| node_agy
node_cli -->|"dispatches work"| node_jobs
node_jobs -->|"runs workers"| node_agy
node_jobs -->|"records jobs"| node_jobstore
node_cli -->|"queries jobs"| node_jobstore
node_cli -->|"checks trust"| node_workspace
node_cli -->|"captures changes"| node_evidence
node_cli -->|"fetches quota"| node_quota
node_quota -->|"reads usage"| node_agy
node_cli -->|"manages Skill"| node_skill
node_skill -->|"installs content"| node_skillcontent
node_cli -->|"checks runtime"| node_diagnostics
node_diagnostics -->|"checks session"| node_agy
node_host -->|"reviews evidence"| node_evidence

click node_cli "https://github.com/yuxiaoma66/antigravity-mission-control/blob/main/antigravity_mission_control/cli.py"
click node_approval "https://github.com/yuxiaoma66/antigravity-mission-control/blob/main/antigravity_mission_control/approvals.py"
click node_policies "https://github.com/yuxiaoma66/antigravity-mission-control/tree/main/policies"
click node_routing "https://github.com/yuxiaoma66/antigravity-mission-control/blob/main/antigravity_mission_control/routing.py"
click node_jobs "https://github.com/yuxiaoma66/antigravity-mission-control/blob/main/antigravity_mission_control/jobs.py"
click node_jobstore "https://github.com/yuxiaoma66/antigravity-mission-control/blob/main/antigravity_mission_control/jobstore.py"
click node_workspace "https://github.com/yuxiaoma66/antigravity-mission-control/blob/main/antigravity_mission_control/workspace.py"
click node_evidence "https://github.com/yuxiaoma66/antigravity-mission-control/blob/main/antigravity_mission_control/workspace.py"
click node_quota "https://github.com/yuxiaoma66/antigravity-mission-control/blob/main/antigravity_mission_control/usage.py"
click node_skill "https://github.com/yuxiaoma66/antigravity-mission-control/blob/main/antigravity_mission_control/skill.py"
click node_skillcontent "https://github.com/yuxiaoma66/antigravity-mission-control/tree/main/antigravity_mission_control/skill_bundle"
click node_diagnostics "https://github.com/yuxiaoma66/antigravity-mission-control/blob/main/antigravity_mission_control/cli.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_host toneBlue
class node_approval,node_policies,node_routing,node_workspace toneAmber
class node_jobs,node_jobstore,node_evidence toneMint
class node_quota,node_skill,node_skillcontent,node_diagnostics toneRose
class node_agy toneIndigo
```

## Components

### User Control

- [Command Interface](https://github.com/yuxiaoma66/antigravity-mission-control/blob/main/antigravity_mission_control/cli.py): `antigravity_mission_control/cli.py`

### Policy And Routing

- [Bound Approvals](https://github.com/yuxiaoma66/antigravity-mission-control/blob/main/antigravity_mission_control/approvals.py): `antigravity_mission_control/approvals.py`
- [Policy Presets](https://github.com/yuxiaoma66/antigravity-mission-control/tree/main/policies): `policies`
- [Model Routing](https://github.com/yuxiaoma66/antigravity-mission-control/blob/main/antigravity_mission_control/routing.py): `antigravity_mission_control/routing.py`
- [Workspace Trust](https://github.com/yuxiaoma66/antigravity-mission-control/blob/main/antigravity_mission_control/workspace.py): `antigravity_mission_control/workspace.py`

### Worker Execution

- [Worker Lifecycle](https://github.com/yuxiaoma66/antigravity-mission-control/blob/main/antigravity_mission_control/jobs.py): `antigravity_mission_control/jobs.py`
- [Durable Jobs](https://github.com/yuxiaoma66/antigravity-mission-control/blob/main/antigravity_mission_control/jobstore.py): `antigravity_mission_control/jobstore.py`
- [Change Evidence](https://github.com/yuxiaoma66/antigravity-mission-control/blob/main/antigravity_mission_control/workspace.py): `antigravity_mission_control/workspace.py`

### Operations

- [Quota Telemetry](https://github.com/yuxiaoma66/antigravity-mission-control/blob/main/antigravity_mission_control/usage.py): `antigravity_mission_control/usage.py`
- [Host Skill Setup](https://github.com/yuxiaoma66/antigravity-mission-control/blob/main/antigravity_mission_control/skill.py): `antigravity_mission_control/skill.py`
- [Skill Guidance](https://github.com/yuxiaoma66/antigravity-mission-control/tree/main/antigravity_mission_control/skill_bundle): `antigravity_mission_control/skill_bundle`
- [Runtime Checks](https://github.com/yuxiaoma66/antigravity-mission-control/blob/main/antigravity_mission_control/cli.py): `antigravity_mission_control/cli.py`

### Other components

- **Host Agent / User**
- **Antigravity CLI**

## Connections

- Host Agent / User → Command Interface: invokes commands
- Command Interface → Bound Approvals: creates approvals
- Bound Approvals → Policy Presets: loads policy
- Command Interface → Model Routing: selects models
- Model Routing → Antigravity CLI: lists models
- Command Interface → Worker Lifecycle: dispatches work
- Worker Lifecycle → Antigravity CLI: runs workers
- Worker Lifecycle → Durable Jobs: records jobs
- Command Interface → Durable Jobs: queries jobs
- Command Interface → Workspace Trust: checks trust
- Command Interface → Change Evidence: captures changes
- Command Interface → Quota Telemetry: fetches quota
- Quota Telemetry → Antigravity CLI: reads usage
- Command Interface → Host Skill Setup: manages Skill
- Host Skill Setup → Skill Guidance: installs content
- Command Interface → Runtime Checks: checks runtime
- Runtime Checks → Antigravity CLI: checks session
- Host Agent / User → Change Evidence: reviews evidence