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 backend/runtime이 수행한 agent run을 Gito의 workspace operation과 Git revision event로 수렴시키는 계약을 만든다. ../agent-shell은 host UI/package로 남고, 실제 backend 실행과 IOP CLI/Edge/Node orchestration은 IOP 프로젝트가 소유한다. 성공 기준은 구조화 응답이 아니라 workspace의 실제 Git 상태와 push 결과로 확인한다.

상태

[계획]

승격 조건

• 없음

구현 잠금

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

범위

• IOP backend invocation/result 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 backend를 workspace operation 실행 통로로 연결한다.

• [input] repo, branch, workspace path, user instruction, policy context를 IOP 입력으로 전달하는 형식을 정한다.
• [invoke] Gito가 직접 IOP CLI를 실행하지 않고 IOP backend invocation/result 계약을 호출하거나 수신하는 형식을 정한다. 검증: fake IOP backend result가 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 내부 모델 라우팅
• ../agent-shell package 내부 UI/domain 구현
• provider PR/MR 생성
• Plane/Jira work item lifecycle
• Flutter UI

작업 컨텍스트

• 관련 경로: services/core/internal/worker/, services/core/internal/gitengine/, services/core/internal/events/, packages/contracts/notes/gito-control-plane.md
• 표준선(선택): IOP run 결과는 Git 상태와 operation event로 검증한다.
• 선행 작업: Agent Shell Package and IOP Backend Boundary
• 후속 작업: Command Policy and Cancellation
• 확인 필요: IOP backend invocation/result contract