iop/agent-roadmap/phase/automation-runtime-bridge/PHASE.md

Phase: Automation Runtime과 Bridge 확장

상태

[계획]

목표

Runtime과 Automation 실행 흐름을 공통화하고, agent 설치형 대상과 비설치형 대상의 제어 경로를 분리해 확장한다. CLI 실행, specialized agent 등록, bootstrap/enrollment, OpenAI-compatible workspace agent 실행 계약을 서로 충돌하지 않는 운영 경로로 정리했다. NomadCode가 IOP를 실행 백엔드로 사용할 수 있도록 하는 Responses 기반 workspace agent 실행 계약은 완료되었고, 다음 MVP 후보는 CLI Agent 사용량 limit 알림과 자동 이어받기 같은 운영 기능이다. 원격 터미널/CLI 터널링과 oto scheduler/CI-CD 자동화는 2차 스케치로 잠그고, 현재 활성 구현 범위로 끌어오지 않는다.

Milestone 흐름

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

• [완료] CLI Automation Runtime 안정화

  • 경로: cli-automation-runtime-stabilization
  • 요약: one-shot, persistent terminal, opencode SSE, codex exec 계열 CLI 실행 모드와 운영 command 응답을 같은 adapter execution 모델 안에서 안정화했다.

• [완료] Agent Bootstrap과 Domain Agent 등록

  • 경로: agent-bootstrap-domain-agent-enrollment
  • 요약: Edge 직접 연결 specialized domain agent 등록을 위한 MVP enrollment 계약과 후속 구현 Milestone 경계를 확정했다.

• [완료] Domain Agent Registry 구현

  • 경로: domain-agent-registry-implementation
  • 요약: Edge-side generic-node/domain-agent 구분을 config/store, registry/transport, service snapshot에 반영하고 검증을 완료했다.

• [완료] Domain Agent Bootstrap Command 발급

  • 경로: domain-agent-bootstrap-command-issue
  • 요약: iop-edge agent register가 domain agent record와 Linux bootstrap script 인자를 포함한 one-line command를 발급하고 config roundtrip 검증을 완료했다.

• [완료] IOP 전용 Domain Agent 경로 제거

  • 경로: domain-agent-specific-iop-removal
  • 요약: 독립 Control Plane 전환에 맞춰 IOP 활성 코드와 문서에서 전용 agent kind, bootstrap, smoke, 운영 문구를 제거했다.

• [완료] 전역 설계 부채 리팩토링 기반

  • 경로: architecture-refactor-foundation
  • 요약: 원격 터미널 브리지와 이후 운영 확장 전에 Edge, Node, Control Plane, Client, proto/config 경계의 설계 부채를 정리했고, 잔여 리스크는 후속 선행 안정화 마일스톤으로 넘겼다.

• [완료] OpenAI Responses Input Surface

  • 경로: openai-responses-input-surface
  • 요약: Edge OpenAI-compatible 입력 표면에 non-streaming POST /v1/responses, metadata 전달 계약, response subset, iop-edge smoke openai Responses 검증을 추가하고 실제 Edge/Node/fake Ollama smoke evidence를 확보했다.

• [폐기] Specialized Agent proto-socket 연결 기반

  • 경로: specialized-agent-proto-socket-foundation
  • 요약: domain agent가 독립형 실행 방식으로 전환될 예정이므로 Edge 직접 proto-socket specialized peer 기준의 연결 기반 정리는 폐기한다.

• [폐기] Domain Agent Registration Online Smoke

  • 경로: domain-agent-registration-online-smoke
  • 요약: 독립형 실행 방식으로 전환될 예정이므로 Edge 직접 registration online smoke는 폐기한다.

• [폐기] Domain Agent Registration Unlock Handoff

  • 경로: domain-agent-registration-unlock-handoff
  • 요약: 독립형 실행 전환으로 Edge 직접 등록 흐름 잠금 해제 handoff가 필요 없어져 폐기한다.

• [폐기] Domain Agent Message Boundary

  • 경로: domain-agent-message-boundary
  • 요약: 독립형 실행 전환으로 Edge 직접 domain payload boundary 정리가 현재 범위에서 필요 없어져 폐기한다.

• [완료] 워크스페이스 포트/환경 표준화

  • 경로: workspace-port-env-standardization
  • 요약: Control Plane, Edge, Node, Client, OpenAI-compatible, A2A, wire, metrics, DB/cache 포트를 workspace 공통 대역으로 정렬한다.

• [완료] 브리지 선행 경계 안정화

  • 경로: bridge-boundary-hardening
  • 요약: 원격 터미널 브리지 POC 전에 남은 호환성/소유권 리스크를 Client HTTP lifecycle, Edge run surface, Node terminal core, typed adapter config 계약으로 고정한다.

• [완료] Codex App Server 스트리밍 전환

  • 경로: codex-app-server-streaming-migration
  • 요약: Codex CLI target의 기본 codex profile을 app-server 기반으로 전환하고 실제 codex foreground/background smoke와 app-server session lifecycle 검증을 완료했다.

• [완료] OpenAI Workspace Agent Execution Contract

  • 경로: openai-workspace-agent-execution-contract
  • 요약: NomadCode가 IOP CLI를 직접 실행하지 않고 IOP Edge OpenAI-compatible HTTP 호출의 metadata.workspace와 task/source metadata만으로 내부 workspace-bound agent target이 해당 checkout에서 산출물을 만들 수 있게 하는 최우선 contract/serving hardening 작업이다.

• [계획] Pi CLI Provider Integration

  • 경로: pi-cli-provider-integration
  • 요약: Node CLI adapter의 실행 profile 후보에 Pi를 추가하고, Pi JSON stream 출력 파서, config 예시, OpenAI-compatible route smoke를 통해 adapter=cli,target=pi를 안정적으로 사용할 수 있게 한다.

• [계획] CLI Agent Group Grade Routing

  • 경로: cli-agent-group-grade-routing
  • 요약: PLAN-local-G08.md, CODE_REVIEW-cloud-G07.md 같은 예약어/lane/grade 파일명을 기준으로 CLI provider agent를 목적별 agent group에 라우팅하고, 수동/자동 grade range assignment와 OpenAI-compatible metadata.agent_group.task_file 계약을 정리한다.

• [스케치] CLI Agent 사용량 알림과 자동 이어받기 MVP

  • 경로: cli-agent-usage-notification-continuation
  • 요약: CLI Agent limit 도달 감지, 사용자 알림, 작업 자동 이어받기의 MVP 경계를 스케치한다.

• [스케치] 원격 코딩/유지보수 작업 환경

  • 경로: remote-workspace-operations-environment
  • 요약: CLI Agent와 workspace-bound execution을 이용한 원격 코딩/유지보수 환경의 운영 경계를 스케치한다.

• [스케치] oto 자동화 스케줄러와 CI-CD 연동 (2차)

  • 경로: oto-automation-scheduler-second-wave
  • 요약: oto를 이용한 자동화, scheduler, CI-CD 연동은 MVP 이후 2차 후보로 스케치한다.

• [보류] 원격 터미널/CLI 터널링 POC (2차)

  • 경로: remote-terminal-bridge-poc
  • 요약: Agent를 설치하기 어려운 host/device 또는 특정 Node의 CLI agent를 Socket 경유로 다른 원격지에 연결하는 터널링 POC는 MVP 이후 2차로 보류한다.

Phase 경계

• OpenAI-compatible API와 A2A API에 terminal 제어 기능을 억지로 싣지 않는다.
• Edge는 실행 요청의 broker 역할을 하고, Node는 대상 transport 실행자 역할을 유지한다.
• 설치 가능한 대상은 bootstrap/enrollment 경로로, 설치가 어렵거나 일회성 유지보수 대상은 remote terminal bridge 경로로 구분한다.
• OpenAI-compatible Responses 표면은 외부 모델 호출 호환을 위한 입력 표면이며, IOP 고유 운영 제어는 native protocol이나 명시 운영 API로 분리한다.
• NomadCode 지원을 위한 metadata.workspace 실행 계약은 provider 확장, Lemonade 추가, remote terminal bridge보다 먼저 닫는다.
• CLI Agent 사용량 알림과 자동 이어받기는 기존 CLI usage checker와 runtime command 경계를 기준으로 스케치하되, 사용자 검토 전에는 세부 자동화 정책을 확정하지 않는다.
• 원격 터미널/CLI 터널링 POC와 oto scheduler/CI-CD 연동은 현재 활성 작업에서 제외하고, provider 상태/capacity queue와 운영 관측 MVP 이후 재개 후보로 둔다.