oto/agent-roadmap/phase/message-based-build-agent/PHASE.md

Phase: 메시지 기반 빌드 에이전트

상태

[검토중]

목표

oto agent 또는 oto daemon 모드에서 OTO Server와 양방향 메시지 통신을 사용한다. OTO를 generic remote shell이 아니라 build/deploy 전용 runner로 노출하고, 기존 YAML 파이프라인과 커맨드 확장 모델을 원격 제어 가능한 실행 표면으로 연결한다.

Milestone 흐름

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

• [완료] agent 메시지 프로토콜
  • 경로: agent-roadmap/archive/phase/message-based-build-agent/milestones/agent-message-protocol.md
  • 요약: OTO Server와 runner가 공유할 capabilities, run request, event/reporting 메시지 프로토콜을 정의한다.
• [완료] 원격 실행 생명주기
  • 경로: agent-roadmap/archive/phase/message-based-build-agent/milestones/remote-run-lifecycle.md
  • 요약: OTO Server가 소유하는 원격 실행, 로그, artifact, cancel, status, self-update 생명주기를 완성한다.
• [계획] agent 등록 capability 경계 정리
  • 경로: agent-roadmap/phase/message-based-build-agent/milestones/agent-registration-capability-boundary.md
  • 요약: agent 등록 경로가 command catalog를 직접 해석하지 않도록 capability provider port와 command adapter로 분리한다.
• [계획] runner 검증 기준 정합화
  • 경로: agent-roadmap/phase/message-based-build-agent/milestones/runner-verification-baseline.md
  • 요약: 현재 OTO Server/Runner 경로 기준으로 runner test, root analyzer, smoke 문서의 기본 검증 범위를 일치시킨다.

완료 리뷰

• 상태: 보류
• 요청일: 2026-06-06
• 보류 근거:
  • agent 메시지 프로토콜 Milestone이 완료되어 archive 경로로 정리되어 있다.
  • 원격 실행 생명주기 Milestone이 완료되어 archive 경로로 정리되어 있다.
  • agent 등록 capability 경계 정리, runner 검증 기준 정합화 Milestone이 새 활성 계획으로 추가되어 Phase 완료 후보가 아니다.
• 리뷰 필요:
  • 신규 계획 Milestone 완료 후 Phase 완료 리뷰를 다시 요청한다
• 리뷰 코멘트: 하위 완료 Milestone의 근거는 유지하되, 신규 정리 Milestone이 추가되어 archive 이동은 보류한다.

Phase 경계

• 기존 YAML 파이프라인 형식과 로컬 CLI 실행 경로를 대체하지 않는다.
• OTO Server 관리 UI, 전체 scheduling policy, artifact storage 운영 정책은 포함하지 않는다.
• 메시지 프로토콜과 원격 실행 생명주기는 build/deploy agent 책임 안에서만 정의한다.
• 이 Phase는 iop Edge 직접 연결 Phase의 후속이 아니라, 독립 Control Plane 기반 OTO Phase에서 확정한 OTO Server/Runner 책임 경계를 소비하는 후속 구현 범위다.