---
kind: task
slug: automation-tiers
title: Automation tiers — supervised, semi-auto, full-auto gate policy
plan_slug: automation-foundation
epic_slug: mission-control-gates-ui
status: draft
priority: P2
tenant_id: global
owner: unassigned
cursor_todo_id: null
updated_at: "2026-08-03"
---

# Task summary

Per-convoy (or per-workspace default) **automation tier** controlling which human gates auto-advance when CI and review agents pass.

## Description

**Benchmark:** Autensa automation tiers (Supervised / Semi-Auto / Full Auto). Maps onto Echodo's explicit gate model without removing human override.

| Tier | Gate 1 (plan) | Gate 2 (merge) | Gate 3 (prod) |
|------|---------------|----------------|---------------|
| **Supervised** | Human | Human | Human |
| **Semi-auto** | Human | Auto when CI green + review agent pass | Human |
| **Full-auto** | Human | Auto when CI green | Auto when deploy webhook fires (future) |

### Schema

- `convoys` metadata field `automation_tier`: `supervised` | `semi_auto` | `full_auto` (default `supervised`)
- Workspace default in settings (optional)

### Behavior

- Orchestrator / webhook handlers consult tier before calling `transition_convoy_status` with `actor: automation`
- Mission control shows tier badge on convoy card; editable before **Go**

### Out of scope

- Auto-approving Gate 1 (plan always human in v1)
- Autopilot research/ideation (Autensa-specific)

## Dependencies

- Epic 5 gates UI
- Epic 8 webhooks for semi-auto Gate 2

## Subtasks

- [ ] Zod enum in `packages/shared/convoy-lifecycle`
- [ ] Create convoy dialog + detail panel tier selector
- [ ] Orchestrator respects tier on CI webhook path
- [ ] Document tier semantics in `docs/orchestrator.md`

## Estimation

S

## Acceptance criteria

- [ ] Semi-auto convoy auto-transitions `pr_review` → `merged` on merge webhook only when CI was green at merge time
- [ ] Supervised convoy never auto-merges
- [ ] Tier visible on kanban card tooltip

## Links

- Epic: `./Epic-mission-control-gates-ui.md`