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 실행 계약은 완료되었고, 원격 터미널 브리지는 현재 활성 작업에서 제외해 후순위 보류로 둔다.

Milestone 흐름

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

• [완료] CLI Automation Runtime 안정화

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

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

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

• [완료] Domain Agent Registry 구현

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

• [완료] Domain Agent Bootstrap Command 발급

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

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

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

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

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

• [완료] OpenAI Responses Input Surface

  • 경로: agent-roadmap/archive/phase/automation-runtime-bridge/milestones/openai-responses-input-surface.md
  • 요약: 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 연결 기반

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

• [폐기] Domain Agent Registration Online Smoke

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

• [폐기] Domain Agent Registration Unlock Handoff

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

• [폐기] Domain Agent Message Boundary

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

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

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

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

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

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

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

• [완료] OpenAI Workspace Agent Execution Contract

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

• [보류] 원격 터미널 브리지 POC

  • 경로: agent-roadmap/phase/automation-runtime-bridge/milestones/remote-terminal-bridge-poc.md
  • 요약: Agent를 설치하기 어려운 host/device를 위한 Edge broker와 Node terminal transport 기반 원격 터미널 브리지 POC는 provider/capacity 등 운영 품질 확장 뒤의 후순위 작업으로 보류한다.

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보다 먼저 닫는다.
• 원격 터미널 브리지 POC는 현재 활성 작업에서 제외하고, provider 상태/capacity queue와 추가 provider 검증 이후 재개 후보로 둔다.