# 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 경로로 정리되어 있다.
- 리뷰 필요:
  - [x] 사용자가 메시지 기반 빌드 에이전트 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 책임 경계를 소비하는 후속 구현 범위다.
