# 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