oto/agent-ops/roadmap/milestones/remote-run-lifecycle.md

원격 실행 생명주기

목표

Edge가 OTO agent에 파이프라인 실행을 요청하고, agent가 실행 진행 상황과 산출물을 보고하며, 취소와 상태 조회, self-update까지 이어지는 원격 실행 생명주기를 완성한다.

단계

메시지 기반 빌드 에이전트

상태

계획

구현 잠금

• 상태: 잠금
• 이유: agent 메시지 프로토콜과 OTO agent 등록 흐름이 먼저 확정되어야 원격 실행 생명주기를 구현 가능한 단위로 나눌 수 있다.
• 해제 조건:
  • agent 메시지 프로토콜의 방향성, 최소 필드, 실패 응답, capability 협상 기준이 문서화됨
  • run request와 YAML pipeline 실행 입력의 연결 기준, event/artifact/cancel/status/self-update 책임이 구체화됨
  • 사용자가 이 Milestone의 구현 구체화와 잠금 해제를 명시적으로 승인함
• 잠금 중 금지:
  • 코드 구현 또는 agent-task 구현 계획 생성
  • Edge scheduling policy, artifact transport, self-update 절차를 추측해 확정
  • generic remote shell agent 기능으로 범위를 확장

범위

• run request를 기존 YAML 파이프라인과 커맨드 확장 모델에 연결한다.
• step event, log stream, artifact event를 원격 실행 흐름에 연결한다.
• cancel, status, self-update의 최소 동작과 실패 기준을 정의한다.
• agent 모드가 기존 CLI 실행 모델을 원격 제어 가능한 실행 표면으로 노출하게 한다.

필수 기능

• run request가 pipeline 실행 입력으로 변환되는 기준이 정의되어 있다.
• step event와 log stream이 원격 소비자에게 전달되는 흐름이 정의되어 있다.
• artifact event의 메타데이터와 전달 책임이 정의되어 있다.
• cancel, status, self-update 동작 기준이 정의되어 있다.

완료 기준

• Edge에서 요청한 빌드/배포 작업의 시작, 진행, 완료, 실패, 취소 상태를 추적할 수 있다.
• 기존 YAML 파이프라인과 커맨드 확장 모델을 유지하면서 원격 제어가 가능하다.
• self-update가 agent 안정성을 해치지 않도록 최소 실패 기준이 있다.

범위 제외

• YAML 파이프라인 언어를 새 DSL로 교체하지 않는다.
• generic remote shell agent로 확장하지 않는다.
• Edge 서버의 전체 스케줄링 정책을 구현하지 않는다.

작업 컨텍스트

• agent 메시지 프로토콜과 CLI 자동화 표면 정리 단계의 구조화 출력 기준을 먼저 확인한다.
• 선행 Milestone: agent 메시지 프로토콜
• pipeline, command, core 도메인 rule이 관련될 수 있다.