# Phase: Control Surface Operations UX

## 상태

[계획]

## 목표

Flutter control surface와 향후 `gitoctl`을 통해 repo, workspace, operation, agent-shell, provider event를 관찰하고 제어할 수 있게 한다. UI는 command 실행 주체가 아니라 control plane consumer로 남긴다.

## Milestone 흐름

완료된 Milestone은 archive 경로를 가리키고, 검토중, 진행중, 계획, 스케치 또는 보류 Milestone은 이 Phase 하위 `milestones/` 경로를 가리킨다.
완료, 검토중, 진행중, 계획, 스케치 순서로 두어 아래로 갈수록 미래 작업에 가까워지게 정렬한다.
스케치 Milestone은 아직 구현 가능한 계획이 아니므로 계획 Milestone보다 아래에 둔다.

- [계획] Flutter Control Surface Baseline
  - 경로: `agent-roadmap/phase/control-surface-operations-ux/milestones/flutter-control-surface-baseline.md`
  - 요약: Flutter 앱이 proto-socket으로 operation 상태와 event stream을 읽는 기본 workbench를 제공한다.

- [계획] Operations Observability
  - 경로: `agent-roadmap/phase/control-surface-operations-ux/milestones/operations-observability.md`
  - 요약: operation log, repo revision, workspace lease, runner heartbeat를 사람이 추적 가능한 화면과 API로 제공한다.

- [스케치] Multi Runner Management
  - 경로: `agent-roadmap/phase/control-surface-operations-ux/milestones/multi-runner-management.md`
  - 요약: 여러 agent-shell runner를 등록, 배정, 격리, 회수하는 운영 UX 후보를 정리한다.

## Phase 경계

- Flutter 앱은 Git command를 직접 실행하지 않는다.
- UI는 provider별 DTO에 직접 결합하지 않고 core domain/event 계약을 소비한다.
- multi-runner 운영 정책은 실제 사용 규모와 보안 요구가 확인된 뒤 계획으로 승격한다.
- 모바일/데스크톱 배포 범위는 별도 결정이 필요하다.

