# Milestone: 원격 코딩/유지보수 작업 환경

## 위치

- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
- Phase: [PHASE.md](../PHASE.md)

## 목표

CLI Agent와 workspace-bound execution을 이용해 원격 코딩 환경과 원격 유지보수 환경을 운영할 수 있는 경계를 스케치한다.
이미 완료된 OpenAI-compatible workspace agent 계약을 기준으로 삼되, 실제 제품 UX와 보안/권한 정책은 별도 검토 전까지 확정하지 않는다.

## 상태

[스케치]

## 승격 조건

- [ ] 원격 코딩과 원격 유지보수 중 1차 MVP에서 우선할 사용 사례를 결정한다.
- [ ] workspace 접근, artifact, 승인, 취소, 결과 회수의 최소 운영 흐름을 정리한다.
- [ ] Control Plane/Client/Edge CLI 중 어떤 표면을 MVP에 포함할지 결정한다.
- [ ] 원격 터미널/CLI 터널링 POC와의 경계를 정리한다.

## 구현 잠금

- 상태: 잠금
- 결정 필요: 아래 체크리스트
  - [ ] 원격 코딩과 원격 유지보수 중 우선순위를 결정한다.
  - [ ] workspace 접근 권한과 승인 정책의 MVP 기준을 결정한다.
  - [ ] 결과 확인과 artifact 회수 표면을 어디에 둘지 결정한다.

## 범위

- workspace-bound CLI Agent 실행 기반 원격 작업 환경
- 원격 코딩, 유지보수, 결과 확인, artifact 회수의 MVP 흐름 후보
- OpenAI-compatible `metadata.workspace` 계약과 IOP native 운영 표면의 책임 분리
- 원격 터미널/CLI 터널링과 겹치지 않는 작업 위임 방식 정리

## 기능

### Epic: [remote-workspace] Remote Workspace Operations

원격 작업을 세션과 workspace 중심으로 운영하기 위한 최소 산출물을 묶는다.

- [ ] [use-case] 원격 코딩/유지보수 MVP 사용 사례와 제외 범위가 정리되어 있다.
- [ ] [workspace-flow] workspace 접근, 승인, 취소, artifact 회수 흐름 후보가 정리되어 있다.
- [ ] [surface-boundary] OpenAI-compatible 호출 표면과 IOP native 운영 표면의 책임 경계가 정리되어 있다.
- [ ] [ops-review] 사용자가 원격 작업 환경 MVP 범위와 2차 후보를 검토했다.

## 완료 리뷰

- 상태: 없음
- 요청일: 없음
- 완료 근거: 스케치 Milestone이며 기능 Task가 아직 충족되지 않았다.
- 리뷰 필요:
  - [ ] 사용자가 완료 결과를 확인했다
  - [ ] archive 이동을 승인했다
- 리뷰 코멘트: 없음

## 범위 제외

- Agent를 설치할 수 없는 host/device의 terminal tunneling
- 모든 IDE/SCM/CI 시스템 통합
- 상세 권한/audit schema 구현

## 작업 컨텍스트

- 관련 경로: `apps/edge`, `apps/node`, `apps/control-plane`, `apps/client`, [openai-compatible-api.md](../../../../agent-contract/outer/openai-compatible-api.md)
- 표준선(선택): 외부 실행 호출은 OpenAI-compatible shape와 `metadata.workspace`를 유지하고, lifecycle/artifact/approval은 IOP native 운영 표면에서 다룬다.
- 선행 작업: OpenAI Workspace Agent Execution Contract
- 후속 작업: 원격 터미널/CLI 터널링 POC, 정책/이력/감사
- 확인 필요: 우선 사용 사례, 권한/승인 기준, 결과 회수 표면
