# Flutter-first Client Consolidation

## 목표

NomadCode의 제품 UI source of truth를 Flutter 앱으로 정하고, React/Vite 웹 콘솔을 장기 제품 경로에서 걷어낸다. 모바일, 데스크톱, 필요 시 Flutter Web까지 같은 앱 구조로 확장할 수 있게 클라이언트 경계와 repo entrypoint를 정리한다.

## 단계

Client Platform Consolidation

## 상태

완료

## 구현 잠금

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

## 범위

- Flutter 앱을 NomadCode 제품 UI의 기준 구현으로 정리
- React/Vite 웹 콘솔 scaffold를 제거하여 제품 경로 밖으로 격리/폐기 완료
- root dev/test/lint/build entrypoint에서 React web 의존을 제거하거나 명확히 비활성화
- README, docs, roadmap, domain rule에서 web/app 책임 경계를 Flutter-first 기준으로 갱신
- code-server는 React wrapper를 거치지 않고 Flutter 앱에서 직접 열거나 embed하는 표면으로 정리
- 공통 계약은 UI 코드 공유가 아니라 `services/core` API와 `packages/contracts`를 기준으로 유지

## 필수 기능

- [x] [ui-source] Flutter 앱을 제품 UI source of truth로 선언하고 React web을 기준 구현에서 제외한다.
- [x] [react-retire] `apps/web` React/Vite scaffold의 제거, 격리, 또는 폐기 경로를 정리한다.
- [x] [entrypoints] root `bin/*` 개발/검증 entrypoint가 Flutter-first 클라이언트 구조를 반영하도록 한다.
- [x] [docs-rules] README, docs, roadmap, domain rule의 web/app 설명을 Flutter-first 기준으로 맞춘다.
- [x] [codeserver-direct] code-server, workspace, diff/terminal/editor 표면은 React wrapper 없이 Flutter 앱에서 직접 연결하는 기준을 정한다.
- [x] [contract-boundary] Flutter 앱과 core가 공유할 API/schema 경계를 `packages/contracts` 후보로 정리한다.

## 완료 기준

- [x] 로드맵과 프로젝트 문서에서 React/Vite 웹 콘솔이 장기 제품 UI 기준 구현으로 설명되지 않는다.
- [x] Flutter 앱이 모바일/데스크톱/선택적 web target의 기준 클라이언트로 설명된다.
- [x] `apps/web`의 처리 방침이 삭제, 격리, 보류 중 하나로 코드와 문서에서 일관된다.
- [x] root `bin/test`, `bin/lint`, `bin/build`, `bin/dev`가 React web 제거 이후의 검증 흐름과 충돌하지 않는다.
- [x] code-server를 React로 감싸고 다시 Flutter로 감싸는 구조를 만들지 않는다는 기준이 문서화되어 있다.
- [x] 후속 Project Workspace Management UX가 Flutter-first 클라이언트 구조 위에서 진행될 수 있다.

## 범위 제외

- core workflow 상태 전이, retry, timeout, notification event 구현
- IOP 내부 모델 라우팅, RAG, MCP, output validation 구현
- code-server, Monaco, terminal 자체를 Flutter native widget으로 재구현
- App Store, Play Store 배포와 심사 대응
- push notification 기능 재설계

## 작업 컨텍스트

- 관련 경로: `apps/mobile/`, `apps/web/`, `bin/`, `README.md`, `docs/`, `agent-ops/rules/project/`, `agent-roadmap/`, `packages/contracts/`
- 표준선(선택): 앱은 필수 제품 표면이며 Flutter가 클라이언트 source of truth다. React/Vite web은 장기 기준 구현이 아니고, 필요한 웹 타깃은 Flutter Web 또는 Flutter 앱에서 직접 연결하는 웹 surface로 다룬다.
- 완료 근거: `apps/web` React/Vite scaffold가 제거되었고, root `bin/test`, `bin/lint`, `bin/build`, `bin/dev`는 core와 `apps/mobile` Flutter 흐름만 참조한다. `apps/mobile/lib/services/workspace_launcher.dart`와 workspace 화면은 code-server URL을 Flutter 앱에서 직접 외부 실행 표면으로 연다. `packages/contracts/notes/flutter-core-api-candidates.md`는 Flutter 앱과 core 사이의 공유 API/schema 후보를 기록한다.
- 선행 작업: 없음
- 후속 작업: Project Workspace Management UX, Workflow Core 이후의 사용자-facing task state UX
- 확인 필요: 없음
