# Milestone: Agent Shell Package and IOP Backend Boundary

## 위치

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

## 목표

workspace 상위 sibling 프로젝트 `../agent-shell`을 제품 비종속 Flutter agent UI/package로 사용하는 방향을 확정한다. `agent_shell` package를 사용하는 host의 backend/runtime은 `../iop` 프로젝트로 지정하고, Gito는 agent backend를 직접 소유하지 않고 Git control plane 계약과 operation/event 경계를 제공한다.

## 상태

[완료]

## 승격 조건

- 없음

## 구현 잠금

- 상태: 해제
- 결정 필요: 없음

## 범위

- `../agent-shell` Flutter package 사용 방식
- `../iop` backend/runtime owner 지정
- Gito control plane과 IOP backend 사이의 Git operation/event 경계
- Gito Flutter control surface가 `agent_shell` UI를 붙일 때의 책임 분리
- 기존 Go `gito-shell` scaffold의 향후 정리 방향

## 기능

### Epic: [agent-shell-boundary] Agent shell package boundary

`../agent-shell`은 embeddable UI/domain package로 사용하고, backend/runtime은 IOP 프로젝트가 담당하도록 경계를 정리한다.

- [x] [package-use] Gito/host Flutter surface가 `agent_shell: path: ../agent-shell`로 UI package를 사용하는 방향을 문서화한다.
- [x] [iop-backend] `agent_shell` host의 backend/runtime owner를 `../iop` 프로젝트로 지정한다.
- [x] [gito-boundary] Gito는 agent execution backend가 아니라 repo/workspace/operation/event control plane을 제공한다는 경계를 contracts와 docs에 반영한다.
- [x] [scaffold-cleanup] 기존 Go `gito-shell`/`internal/agentshell` scaffold를 제거하는 경로로 확정하고, build/config/docs에서 legacy shell surface를 정리한다. 증거: `agent-task/archive/2026/06/m-agent-shell-package-iop-backend-boundary/complete.log`

## 완료 리뷰

- 상태: 승인됨
- 요청일: 2026-06-14
- 완료 근거:
  - `README.md`, `docs/architecture.md`, `apps/client/README.md`, `packages/contracts/notes/gito-control-plane.md`에 `agent_shell: path: ../agent-shell`, `../iop` backend/runtime owner, Gito control plane 경계를 반영했다.
  - legacy Go `gito-shell`/`internal/agentshell` scaffold는 `agent-task/archive/2026/06/m-agent-shell-package-iop-backend-boundary/complete.log` 기준으로 제거 완료했고, `bin/build`는 `gito-server`, `gito-worker`만 생성한다.
  - 코드 레벨 종료 검토에서 `cd services/core && go test ./...`, `bin/build`, docs/contracts smoke search, `test ! -e bin/gito-shell`이 통과했다.
- 리뷰 필요:
  - [x] 사용자가 완료 결과를 확인했다
  - [x] archive 이동을 승인했다
- 리뷰 코멘트: 코드 레벨 종료 검토에서 추가 구현 이슈가 없어 완료 처리한다.

## 범위 제외

- `../agent-shell` package 내부 widget/domain model 구현
- IOP backend/Edge/Node 구현
- IOP CLI invocation 세부
- provider API 호출
- Flutter runner management UX
- remote shell installation 자동화

## 작업 컨텍스트

- 관련 경로: `apps/client/`, `packages/contracts/notes/gito-control-plane.md`, `docs/architecture.md`, `README.md`
- 외부 프로젝트: `../agent-shell`은 Flutter UI/package, `../iop`는 agent backend/runtime owner다.
- 표준선(선택): Gito는 agent backend를 직접 구현하지 않고 IOP가 제공하는 runtime/backend와 Git control plane 계약으로 연결한다.
- 선행 작업: Operation Event Outbox
- 후속 작업: IOP Agent Run Bridge
- 확인 필요: 없음
