iop/agent-roadmap/phase/automation-runtime-bridge/PHASE.md
toki 672b4cdb5d refactor(bridge): 실행 경계 선행 안정화를 반영한다
원격 터미널 브리지 POC 전에 Client HTTP lifecycle과 Edge run result surface 계약을 고정해야 하므로 관련 구현, 테스트, 로드맵 상태를 함께 정리한다.
2026-06-07 08:40:36 +09:00

4.9 KiB

Phase: Automation Runtime과 Bridge 확장

상태

[진행중]

목표

Runtime과 Automation 실행 흐름을 공통화하고, agent 설치형 대상과 비설치형 대상의 제어 경로를 분리해 확장한다. CLI 실행, specialized agent 등록, bootstrap/enrollment, 원격 터미널 브리지를 서로 충돌하지 않는 운영 경로로 정리한다.

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 경계의 설계 부채를 정리했고, 잔여 리스크는 후속 선행 안정화 마일스톤으로 넘겼다.
  • [폐기] 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/bridge-boundary-hardening.md
    • 요약: 원격 터미널 브리지 POC 전에 남은 호환성/소유권 리스크를 Client HTTP lifecycle, Edge run surface, Node terminal core, typed adapter config 계약으로 고정한다.
  • [계획] 원격 터미널 브리지 POC

    • 경로: agent-roadmap/phase/automation-runtime-bridge/milestones/remote-terminal-bridge-poc.md
    • 요약: Agent를 설치하기 어려운 host/device를 위해 Edge broker와 Node terminal transport 기반 원격 터미널 브리지 POC를 만든다.

Phase 경계

  • OpenAI-compatible API와 A2A API에 terminal 제어 기능을 억지로 싣지 않는다.
  • Edge는 실행 요청의 broker 역할을 하고, Node는 대상 transport 실행자 역할을 유지한다.
  • 설치 가능한 대상은 bootstrap/enrollment 경로로, 설치가 어렵거나 일회성 유지보수 대상은 remote terminal bridge 경로로 구분한다.