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

3.2 KiB

Milestone: CLI Agent 사용량 알림과 자동 이어받기 MVP

위치

목표

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 신호 범위, 알림 채널, 자동 이어받기 정책