oto/agent-roadmap/archive/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 생명주기를 완성한다.
• [완료] runner 검증 기준 정합화
  • 경로: agent-roadmap/archive/phase/message-based-build-agent/milestones/runner-verification-baseline.md
  • 요약: 현재 OTO Server/Runner 경로 기준으로 runner test, root analyzer, smoke 문서의 기본 검증 범위를 일치시킨다.
• [완료] agent 등록 capability 경계 정리
  • 경로: agent-roadmap/archive/phase/message-based-build-agent/milestones/agent-registration-capability-boundary.md
  • 요약: agent 등록 경로가 command catalog를 직접 해석하지 않도록 capability provider port와 command adapter로 분리한다.

완료 리뷰

• 상태: 승인됨
• 요청일: 2026-06-06
• 완료 근거:
  • agent 메시지 프로토콜 Milestone이 완료되어 archive 경로로 정리되어 있다.
  • 원격 실행 생명주기 Milestone이 완료되어 archive 경로로 정리되어 있다.
  • runner 검증 기준 정합화 Milestone이 완료되어 archive 경로로 정리되어 있다.
  • agent 등록 capability 경계 정리 Milestone이 완료되어 archive 경로로 정리되어 있다.
• 리뷰 필요:
  • 사용자가 메시지 기반 빌드 에이전트 Phase 완료를 승인한다.
• 리뷰 코멘트: 사용자 승인에 따라 Phase를 완료 처리하고 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 책임 경계를 소비하는 후속 구현 범위다.