gito/agent-roadmap/phase/agent-shell-iop-execution/milestones/iop-agent-run-bridge.md

Milestone: IOP Agent Run Bridge

위치

• Roadmap: agent-roadmap/ROADMAP.md
• Phase: agent-roadmap/phase/agent-shell-iop-execution/PHASE.md

목표

IOP CLI를 agent-shell command execution 경계에 연결해 workspace 안에서 agent-driven Git 작업을 수행한다. IOP run은 operation lifecycle과 Git revision event로 수렴해야 하며, 성공 기준은 구조화 응답이 아니라 workspace의 실제 Git 상태와 push 결과로 확인한다.

상태

[계획]

승격 조건

• 없음

구현 잠금

• 상태: 잠금
• 결정 필요:
  • IOP CLI 실행 명령, profile/model 선택, 입력 파일 또는 stdin 계약을 확정한다.
  • IOP credential과 workspace별 secret 주입 방식을 확정한다.

범위

• IOP CLI invocation contract
• workspace path, repo context, operation instruction 전달
• agent run state model
• IOP run success/failure 판정
• run 이후 Git status/diff/commit/push와 revision scan 연결

기능

Epic: [iop-run] IOP execution

IOP CLI를 workspace operation 실행 통로로 연결한다.

• [input] repo, branch, workspace path, user instruction, policy context를 IOP 입력으로 전달하는 형식을 정한다.
• [invoke] agent-shell이 IOP CLI를 실행하고 stdout/stderr를 stream한다. 검증: fake IOP command가 expected input을 받고 operation log를 남긴다.
• [state] queued, running, succeeded, failed, cancelled run state를 operation lifecycle에 매핑한다.
• [result] run 이후 Git status와 revision diff로 성공 여부를 확인한다.

Epic: [git-result] Git result convergence

agent run 결과를 Git revision과 operation event로 수렴한다.

• [dirty-guard] run 종료 후 dirty workspace 정책을 적용한다.
• [commit-push] policy가 허용한 경우 commit/push operation으로 연결한다.
• [revision-event] push 이후 revision scan event를 발행한다.

완료 리뷰

• 상태: 없음
• 요청일: 없음
• 완료 근거: 없음
• 리뷰 필요:
  • 사용자가 완료 결과를 확인했다
  • archive 이동을 승인했다
• 리뷰 코멘트: 없음

범위 제외

• IOP 내부 모델 라우팅
• provider PR/MR 생성
• Plane/Jira work item lifecycle
• Flutter UI

작업 컨텍스트

• 관련 경로: services/core/internal/agentshell/, services/core/internal/worker/, services/core/internal/gitengine/, services/core/internal/events/
• 표준선(선택): IOP run 결과는 Git 상태와 operation event로 검증한다.
• 선행 작업: Agent Shell Runtime Channel
• 후속 작업: Command Policy and Cancellation
• 확인 필요: IOP CLI invocation contract