gito/agent-roadmap/phase/control-surface-operations-ux/PHASE.md

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 운영 정책은 실제 사용 규모와 보안 요구가 확인된 뒤 계획으로 승격한다.
• 모바일/데스크톱 배포 범위는 별도 결정이 필요하다.