<!-- task=m-inbound-queue-ordering/04_dart_gateway plan=1 tag=REVIEW_API -->

# Dart Worker Gateway 최종 검증 회수 계획

## 이 파일을 읽는 구현 에이전트에게

구현 후 `CODE_REVIEW-cloud-G08.md`의 구현 에이전트 소유 섹션에 실제 변경 내용과 검증 stdout/stderr를 채운 뒤 active 파일을 그대로 두고 리뷰를 요청한다. 사용자 결정, 사용자 소유 환경, scope 충돌로 막히면 review stub의 `사용자 리뷰 요청` 섹션을 채우고 중단한다. `complete.log` 작성, archive 이동, 최종 판정은 code-review 전용이다.

## 배경

이전 루프의 Dart gateway 코드는 계획 범위에 맞게 구현된 것으로 보이나, 최종 검증 항목이 미완료 상태로 남았다. `CODE_REVIEW-cloud-G08.md`에는 `run_matrix.sh --all` 결과가 `(실행 중)` placeholder로 남아 있어 completeness와 verification trust를 만족하지 못했다.

## 사용자 리뷰 요청 흐름

구현 중 user-only blocker가 있으면 active `CODE_REVIEW-cloud-G08.md`의 `사용자 리뷰 요청` 섹션에 결정 필요 항목과 실행한 명령 출력을 기록한다. code-review가 정당성을 검토하고 실제 `USER_REVIEW.md` 작성 여부를 판단한다.

## Roadmap Targets

- Milestone: `agent-roadmap/milestones/inbound-queue-ordering.md`
- Task ids:
  - `dart-gateway`: Dart IO 구현에서 상시 isolate gateway를 두고 순수 bytes 작업을 분리한다.
- Completion mode: check-on-pass

## 분석 결과

### 이전 루프 결과

- Archived plan: `agent-task/m-inbound-queue-ordering/04_dart_gateway/plan_cloud_G08_0.log`
- Archived review: `agent-task/m-inbound-queue-ordering/04_dart_gateway/code_review_cloud_G08_0.log`
- Verdict: FAIL
- Required: 최종 매트릭스 검증 미완료 및 실제 stdout/stderr 부재.

### 범위 결정 근거

- 새 기능을 확장하지 않는다.
- 우선 `bash agent-ops/skills/project/run-proto-socket-test-matrix/scripts/run_matrix.sh --all`을 실제로 완료하고 결과를 기록한다.
- 매트릭스가 Dart gateway 변경 때문에 실패하면 필요한 최소 코드/테스트 수정만 포함한다.
- 외부 환경 문제라면 정확한 명령, stdout/stderr, `command -v` 등 확인 근거, 재개 조건을 `사용자 리뷰 요청`에 기록한다.

### 빌드 등급

- build: `cloud-G08`, review: `cloud-G08`. 이유: 전체 로컬 매트릭스 검증과 실패 시 크로스 언어/Dart gateway 경계 판단이 필요하다.

## 구현 체크리스트

- [ ] `bash agent-ops/skills/project/run-proto-socket-test-matrix/scripts/run_matrix.sh --all`을 repo root에서 끝까지 실행하고 exit code, 실제 stdout/stderr, 결과 기록 파일 경로를 `CODE_REVIEW-cloud-G08.md`에 기록한다.
- [ ] 매트릭스 실패가 Dart gateway 구현에서 비롯되면 최소 범위로 수정하고 관련 Dart 중간 검증과 전체 매트릭스를 다시 실행해 실제 stdout/stderr를 기록한다.
- [ ] 외부 환경 또는 사용자 소유 전제 때문에 매트릭스를 완료할 수 없으면 `사용자 리뷰 요청`에 정확한 차단 근거, 실행한 명령 출력, 자동 후속 불가 이유, 재개 조건을 기록한다.
- [ ] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.

### [REVIEW_API-1] 최종 매트릭스 검증 회수

#### 문제

- 이전 review stub의 최종 검증 항목이 미체크였고, `검증 결과`에도 실제 출력 대신 `(실행 중)` placeholder가 남았다.

#### 해결 방법

- repo root에서 고정 명령을 실행한다.
- 성공하면 결과 파일 경로와 핵심 PASS 요약을 기록한다.
- 실패하면 실패 원인이 코드 문제인지, 테스트 환경 문제인지, 기록 누락인지 분리한다.
- 코드 문제면 Dart gateway 범위 내에서만 수정하고 검증을 재실행한다.

#### 수정 파일 및 체크리스트

- [ ] `agent-task/m-inbound-queue-ordering/04_dart_gateway/CODE_REVIEW-cloud-G08.md`
- [ ] 실패 시 필요한 최소 Dart 파일

#### 테스트 작성

- 새 테스트 작성은 기본 범위가 아니다.
- 매트릭스 실패가 기존 테스트 공백을 드러내는 경우에만 관련 Dart 테스트를 최소 추가한다.

#### 중간 검증

```bash
cd dart && dart test test/communicator_test.dart && dart compile js test/browser_ws_import_compile.dart -o /tmp/proto_socket_browser_ws_import_compile.js
```

기대 결과: Dart gateway 관련 communicator tests PASS, browser import compile PASS.

## 수정 파일 요약

| 파일 | 항목 |
|------|------|
| `agent-task/m-inbound-queue-ordering/04_dart_gateway/CODE_REVIEW-cloud-G08.md` | REVIEW_API-1 |
| 실패 시 필요한 최소 Dart 파일 | REVIEW_API-1 |

## 최종 검증

```bash
bash agent-ops/skills/project/run-proto-socket-test-matrix/scripts/run_matrix.sh --all
```

기대 결과: exit code 0, matrix 결과 파일의 최종 결과값 PASS.

모든 작업 완료 후 반드시 `CODE_REVIEW-*-G??.md`의 구현 에이전트 소유 섹션을 채운다. 이 파일 작성이 구현의 마지막 단계다.
