gito/agent-roadmap/phase/agent-shell-iop-execution/PHASE.md

Phase: Agent Shell IOP Execution

상태

[계획]

목표

agent-shell을 실제 workspace command 실행 주체로 세우고 IOP CLI와 연결한다. control plane은 operation을 만들고, worker는 lease와 실행을 조율하며, agent-shell은 Git CLI와 IOP CLI 실행, 로그 streaming, cancel/timeout, dirty guard를 담당한다.

Milestone 흐름

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

• [계획] Agent Shell Runtime Channel

  • 경로: agent-roadmap/phase/agent-shell-iop-execution/milestones/agent-shell-runtime-channel.md
  • 요약: agent-shell이 outbound proto-socket으로 control plane에 연결하고 command dispatch/heartbeat/log stream을 처리한다.

• [계획] IOP Agent Run Bridge

  • 경로: agent-roadmap/phase/agent-shell-iop-execution/milestones/iop-agent-run-bridge.md
  • 요약: IOP CLI를 workspace operation의 agent 실행 통로로 연결하고 run 결과를 Git operation과 event로 수렴시킨다.

• [계획] Command Policy and Cancellation

  • 경로: agent-roadmap/phase/agent-shell-iop-execution/milestones/command-policy-and-cancellation.md
  • 요약: command allowlist, timeout, cancel, dirty workspace guard, log redaction 기준을 실행 경계에 적용한다.

Phase 경계

• agent-shell은 local workspace command 실행만 맡고 provider API 호출을 직접 소유하지 않는다.
• IOP 내부 모델 라우팅, RAG, output validation은 Gito의 소유 범위가 아니다.
• control plane은 arbitrary shell command를 직접 실행하지 않고 agent-shell capability로 위임한다.
• provider-specific PR/MR 작업은 ChangeRequest adapter Phase에서 처리한다.