iop/agent-roadmap/phase/automation-runtime-bridge/milestones/cli-agent-usage-notification-continuation.md

73 lines
3.2 KiB
Markdown

# Milestone: CLI Agent 사용량 알림과 자동 이어받기 MVP
## 위치
- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
- Phase: [PHASE.md](../PHASE.md)
## 목표
CLI Agent가 limit에 도달했을 때 운영자가 인지하고, 필요한 경우 작업을 안전하게 이어받을 수 있는 MVP 경계를 스케치한다.
기존 CLI usage checker와 runtime command/status 경로를 기준으로 삼되, 자동 이어받기의 정책과 사용자 승인 방식은 후속 구체화에서 결정한다.
## 상태
[스케치]
## 승격 조건
- [ ] limit 도달 알림을 지원할 CLI target 범위를 결정한다.
- [ ] 자동 이어받기의 기본 정책과 사용자 승인 필요 여부를 결정한다.
- [ ] 알림 표면을 Client, Control Plane, Edge CLI, 외부 webhook 중 어디까지 포함할지 결정한다.
- [ ] 이어받기 실패, 중복 실행, 비용/limit 소진에 대한 MVP 안전장치를 정리한다.
## 구현 잠금
- 상태: 잠금
- 결정 필요: 아래 체크리스트
- [ ] limit 도달 시 자동 이어받기를 기본 on으로 둘지, 명시 승인 후 실행할지 결정한다.
- [ ] 작업 이어받기 대상 CLI/provider 우선순위를 어떻게 정할지 결정한다.
- [ ] 알림 채널과 사용자 확인 UX의 MVP 범위를 결정한다.
## 범위
- CLI Agent usage/limit 상태 감지와 운영 알림 경계
- limit 도달 시 작업 이어받기 후보 선정과 중복 실행 방지 기준
- Client/Control Plane/Edge CLI/외부 webhook 알림 후보 정리
- 자동 이어받기 정책을 세부 구현 전 검토 가능한 수준으로 분리
## 기능
### Epic: [cli-ops] CLI Agent Operations
CLI Agent limit 상태와 작업 이어받기를 운영자가 이해하고 제어하기 위한 최소 capability를 묶는다.
- [ ] [limit-signal] CLI target별 usage/limit 신호와 MVP 지원 범위가 정리되어 있다.
- [ ] [notify-surface] limit 도달 알림 표면 후보와 제외 범위가 정리되어 있다.
- [ ] [continue-policy] 자동 이어받기 정책, 승인 방식, 안전장치 후보가 정리되어 있다.
- [ ] [ops-review] 사용자가 알림/이어받기 MVP 범위와 2차 후보를 검토했다.
## 완료 리뷰
- 상태: 없음
- 요청일: 없음
- 완료 근거: 스케치 Milestone이며 기능 Task가 아직 충족되지 않았다.
- 리뷰 필요:
- [ ] 사용자가 완료 결과를 확인했다
- [ ] archive 이동을 승인했다
- 리뷰 코멘트: 없음
## 범위 제외
- 모든 CLI Agent의 limit parser 완성
- 비용 최적화, 계정 회전, provider credential 자동 전환
- oto scheduler/CI-CD 자동화
- 원격 터미널/CLI 터널링
## 작업 컨텍스트
- 관련 경로: `apps/node/internal/adapters/cli/status`, `apps/edge`, `apps/control-plane`, `apps/client`, `proto/iop/runtime.proto`
- 표준선(선택): 자동화는 runtime command/status 경계를 재사용하고, 사용자가 검토해야 할 정책은 Milestone 잠금으로 유지한다.
- 선행 작업: CLI Automation Runtime 안정화, OpenAI Workspace Agent Execution Contract
- 후속 작업: 운영 관측과 Provider 관리, oto scheduler/CI-CD 연동
- 확인 필요: limit 신호 범위, 알림 채널, 자동 이어받기 정책