rstillwell/Submatter
1
0
Fork 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity Actions
Submatter/plans/Plan-automation-foundation/Epic-apps-orchestrator/Epic-apps-orchestrator.md

61 lines
2.2 KiB
Markdown
Raw Normal View History

plan(automation): add mission-control foundation backlog and model-routing ADR Documents the automation foundation plan (nine epics, Epic 1 taskified) and the accepted model-provider registry contract. Updates .env.example for backlog import workspace id and local/cloud AI provider env guidance. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-07 14:55:03 -04:00
---
kind: epic
slug: apps-orchestrator
title: apps/orchestrator — role dispatch and gate pauses
plan_slug: automation-foundation
feat(orchestrator): convoy driver tick loop and Redis job queue (Epic 6) Adds apps/orchestrator with planOrchestratorAction in shared, dry-run mode, Redis role_dispatch enqueue, gate pauses, and stall detection logging. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-07 16:10:59 -04:00
status: done
plan(automation): add mission-control foundation backlog and model-routing ADR Documents the automation foundation plan (nine epics, Epic 1 taskified) and the accepted model-provider registry contract. Updates .env.example for backlog import workspace id and local/cloud AI provider env guidance. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-07 14:55:03 -04:00
priority: P1
tenant_id: global
cursor_epic_id: null
updated_at: "2026-07-03"
---
# Epic objective
Long-running **`apps/orchestrator`** service: Redis job queue, convoy state machine driver, role dispatcher. Inspired by Symphony **concepts** (stall detection, token logging) — **not** Symphony codebase.
On **Go**: enqueue planning roles serially (ia → ux → architect), stop at `convoy_review`; after Gate 1, dispatch implementer jobs (parallel when `slice_dependencies` allow); fan-out audit jobs; stop at `pr_review` and post-merge gates.
**Parallel implementer fan-out:** When multiple implementer jobs target the same Mac inference host, orchestrator should pass the same `qwen-coder-mlx` alias to each job; operator must run a batching-capable MLX server (mlx-openai-server) — see `docs/adr-model-routing.md` § Local MLX. Cap concurrent implementers per host in orchestrator config if OOM occurs (agent-pipeline multitask playbook).
Each job calls `resolveModel(workspace, roleId, convoy, brief)` and passes `ResolvedModel` to worker.
## In scope / out of scope
**In scope**
- `apps/orchestrator` package in monorepo.
- Redis queue (existing infra).
- Deploy on Coolify beside `web`.
- Stall detection → `agent_runs` / convoy `blocked`.
**Out of scope**
- Worker implementation (Epic 7).
- Symphony / Linear integration.
## Dependencies
- Epic 1 (`resolveModel`).
- Epic 3 (repo link for clone path).
- Epic 4 (transitions).
- Epic 5 (gates — for dogfood; orchestrator can run in dry-run before UI).
## Blocks
- Epic 7 (worker consumes jobs).
## Acceptance criteria
feat(orchestrator): convoy driver tick loop and Redis job queue (Epic 6) Adds apps/orchestrator with planOrchestratorAction in shared, dry-run mode, Redis role_dispatch enqueue, gate pauses, and stall detection logging. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-07 16:10:59 -04:00
- [x] Dry-run: orchestrator logs next role for a convoy without worker.
plan(automation): add mission-control foundation backlog and model-routing ADR Documents the automation foundation plan (nine epics, Epic 1 taskified) and the accepted model-provider registry contract. Updates .env.example for backlog import workspace id and local/cloud AI provider env guidance. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-07 14:55:03 -04:00
- [ ] Live: one implementer brief dispatched and paused correctly at gate.
## Tasks
feat(orchestrator): convoy driver tick loop and Redis job queue (Epic 6) Adds apps/orchestrator with planOrchestratorAction in shared, dry-run mode, Redis role_dispatch enqueue, gate pauses, and stall detection logging. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-07 16:10:59 -04:00
- [x] [Task-shared-orchestrator-driver](./Task-shared-orchestrator-driver.md)
- [x] [Task-apps-orchestrator-service](./Task-apps-orchestrator-service.md)
plan(automation): add mission-control foundation backlog and model-routing ADR Documents the automation foundation plan (nine epics, Epic 1 taskified) and the accepted model-provider registry contract. Updates .env.example for backlog import workspace id and local/cloud AI provider env guidance. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-07 14:55:03 -04:00
## Note
Supersedes [Epic-optional-orchestrator](../../Plan-agent-coordination/Epic-optional-orchestrator/Epic-optional-orchestrator.md) deferred stub with a concrete Echodo-native design.
Reference in a new issue Copy permalink