<!-- task=m-performance-hotspot-optimization/12+10,11_dart_isolate_large_payload plan=0 tag=REFACTOR -->

# Code Review Reference - REFACTOR

> **[IMPLEMENTING AGENT — READ FIRST] Filling in this file is the mandatory final step of implementation.**
> Do not implement until predecessors `10` and `11` have `complete.log`.

## 개요

date=2026-06-06
task=m-performance-hotspot-optimization/12+10,11_dart_isolate_large_payload, plan=0, tag=REFACTOR

## Roadmap Targets

- Milestone: `agent-roadmap/milestones/performance-hotspot-optimization.md`
- Task ids:
  - `dart-isolate-large-payload-transfer`: isolate gateway large payload 전달 비용 축소
- Completion mode: check-on-pass

## 이 파일을 읽는 리뷰 에이전트에게

> **[REVIEW AGENT ONLY]** 종결 절차는 코드리뷰 에이전트 전용이다.

## 구현 항목별 완료 여부

| 항목 | 완료 여부 |
|------|---------|
| [REFACTOR-1] Transferable IO frame handoff | [ ] |
| [REFACTOR-2] Web fallback and cleanup preservation | [ ] |
| [REFACTOR-3] 1MB payload performance evidence | [ ] |

## 구현 체크리스트

- [ ] predecessor `10`과 `11` complete.log 존재를 확인한다.
- [ ] IO gateway에서 large frame submit에 `TransferableTypedData` 또는 동등한 최소-copy 방식을 적용한다.
- [ ] web fallback은 `dart:isolate` import 없이 기존 sync path를 유지한다.
- [ ] 1MB frame decode correctness와 close cleanup tests를 추가/갱신한다.
- [ ] `run_stress.sh --full --lang dart --transport tcp,ws --profile payload` 결과에서 TCP/WS 1MB p99/throughput/memory/stability를 기록한다.
- [ ] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.

## 코드리뷰 전용 체크리스트

- [ ] 판정을 append한다.
- [ ] PASS이면 complete/archive 절차와 런타임 완료 이벤트를 처리한다.

## 계획 대비 변경 사항

_구현 에이전트가 계획과 다르게 구현한 부분을 이유와 함께 기록한다._

## 주요 설계 결정

_구현 에이전트가 주요 설계 결정 사항을 기록한다._

## 사용자 리뷰 요청

- 상태: 없음
- 사유 유형: 없음
- 결정 필요: 없음
- 차단 근거: 없음
- 실행한 검증/명령: 없음
- 자동 후속 불가 이유: 없음
- 재개 조건: 없음

## 리뷰어를 위한 체크포인트

- `TransferableTypedData`가 IO-only 파일에 갇혀 web compile을 깨지 않는지 확인한다.
- 1MB correctness test와 full payload row가 모두 있는지 확인한다.
- 다른 host baseline과 절대 비교를 단정하지 않았는지 확인한다.

## 검증 결과

### REFACTOR-1 중간 검증
```text
$ cd dart && dart test test/communicator_test.dart -r expanded
(output)
```

### REFACTOR-3 중간 검증
```text
$ bash agent-ops/skills/project/run-proto-socket-test-matrix/scripts/run_stress.sh --full --lang dart --transport tcp,ws --profile payload
(output)
```

### 최종 검증
```text
$ cd dart && dart test test/communicator_test.dart test/socket_test.dart -r expanded
(output)
$ cd dart && dart compile js test/browser_ws_import_compile.dart -o /tmp/proto_socket_browser_ws_import_compile.js
(output)
$ bash agent-ops/skills/project/run-proto-socket-test-matrix/scripts/run_performance.sh --quick
(output)
```
