<!-- task=m-high-performance-parallel-operations/03+01_payload_matrix plan=1 tag=REVIEW_PAYLOAD_MATRIX -->

# Plan - REVIEW_PAYLOAD_MATRIX

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

`code_review_cloud_G08_0.log`의 Required 이슈만 해결한다. 코드 변경은 full payload 실행에서 실제 실패가 확인될 때만 최소 범위로 수행하고, 마지막에 `CODE_REVIEW-cloud-G08.md`의 구현 에이전트 소유 섹션을 실제 검증 출력으로 채운다.

## 배경

1차 리뷰는 payload profile 구현 자체보다 검증 완결성과 증거 기록을 실패로 판정했다. 계획의 통합 검증 항목은 1KB, 64KB, 1MB payload row 기록을 요구하지만, 구현 증거는 quick 1KB/64KB만 포함했고 active review에는 실제 stdout/stderr 대신 요약만 남았다.

## 사용자 리뷰 요청 흐름

구현 중 사용자 결정이나 외부 환경 준비가 필요한 경우 review stub의 `사용자 리뷰 요청` 섹션에 기록한다. 단, full payload 실행 실패, timeout, 또는 증거 공백은 먼저 자동 후속으로 재실행/수집한다.

## Roadmap Targets

- Milestone: `agent-roadmap/milestones/high-performance-parallel-operations.md`
- Task ids:
  - `payload-matrix`: payload size matrix를 추가한다.
- Completion mode: check-on-pass

## 분석 결과

### 읽은 파일

- `agent-task/m-high-performance-parallel-operations/03+01_payload_matrix/plan_cloud_G08_0.log`
- `agent-task/m-high-performance-parallel-operations/03+01_payload_matrix/code_review_cloud_G08_0.log`
- `agent-test/runs/20260602-203309-proto-socket-stress-quick.md`
- `agent-test/runs/20260602-203419-proto-socket-full-matrix.md`

### 범위 결정 근거

- 후속 범위는 verification trust/completeness 복구로 제한한다.
- full payload 실행에서 1MB 관련 실제 코드 실패가 발견되면 해당 실패를 고치는 최소 코드 변경만 허용한다.
- Go WS 32KiB read limit, Kotlin TCP delayed-ACK deferred 정책 자체를 바꾸는 작업은 optimize Epic 범위이므로 이번 후속에서 기본 정책을 바꾸지 않는다. 다만 full payload 결과에서 어떤 축이 측정/skip됐는지는 정확히 기록한다.

### 빌드 등급

- build=`cloud-G08`, review=`cloud-G08`. terminal benchmark evidence와 full payload 결과 신뢰성 복구가 핵심이다.

## 구현 체크리스트

- [x] full payload matrix를 실행하고 1KB, 64KB, 1MB row 또는 required SKIP/BLOCKED 축을 결과 파일에 기록한다.
- [x] `CODE_REVIEW-cloud-G08.md`에 quick/full payload, TypeScript check/test, full matrix, `git diff --check`의 실제 stdout/stderr tail 또는 정확한 저장 evidence path를 기록한다.
- [x] full payload 실행에서 코드 결함이 확인되면 최소 범위로 수정하고 관련 검증을 재실행한다.
- [x] payload별 결과 row가 공통 schema의 `Payload(bytes)`와 stability counters를 채우는지 결과 파일 기준으로 확인한다.
- [x] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.

### [REVIEW_PAYLOAD_MATRIX-1] full payload evidence 복구

#### 문제

[code_review_cloud_G08_0.log](/config/workspace/proto-socket/agent-task/m-high-performance-parallel-operations/03+01_payload_matrix/code_review_cloud_G08_0.log:72)는 `--full` payload 미실행을 명시한다. 이 상태에서는 [plan_cloud_G08_0.log](/config/workspace/proto-socket/agent-task/m-high-performance-parallel-operations/03+01_payload_matrix/plan_cloud_G08_0.log:67)의 1KB/64KB/1MB 통합 검증 항목을 완료로 볼 수 없다.

#### 해결 방법

- `bash agent-ops/skills/project/run-proto-socket-test-matrix/scripts/run_stress.sh --full --profile payload`를 실행한다.
- 실행 결과 파일에서 1MB rows 또는 required SKIP/BLOCKED 축을 확인한다.
- 결과가 FAIL이면 실패 언어/transport/axis를 기준으로 최소 수정 후 같은 명령을 재실행한다.
- 결과가 INCOMPLETE이면 stability 위반 0 여부와 required SKIP 사유를 명확히 기록한다.

#### 테스트 작성

- 새 테스트 파일 작성 없음. 기존 stress harness full profile 실행으로 검증한다.

#### 중간 검증

```bash
bash agent-ops/skills/project/run-proto-socket-test-matrix/scripts/run_stress.sh --full --profile payload
```

기대: 1KB, 64KB, 1MB payload rows 또는 명시적 required SKIP/BLOCKED 축이 결과 파일에 기록되고, stability violations가 0이거나 실제 실패 원인이 코드 수정으로 해소된다.

### [REVIEW_PAYLOAD_MATRIX-2] 리뷰 증거 기록 보강

#### 문제

[code_review_cloud_G08_0.log](/config/workspace/proto-socket/agent-task/m-high-performance-parallel-operations/03+01_payload_matrix/code_review_cloud_G08_0.log:66)는 검증 결과를 요약으로만 남겼다. review stub 계약은 실제 stdout/stderr 또는 검증 가능한 저장 evidence path를 요구한다.

#### 해결 방법

- `CODE_REVIEW-cloud-G08.md`의 검증 결과에 각 명령의 실제 stdout/stderr tail을 붙인다.
- 출력이 긴 명령은 결과 기록 파일과 로그 경로를 함께 쓰고, 해당 파일에 포함된 핵심 row/SKIP/exit status를 발췌한다.
- quick payload 기존 결과를 그대로 사용할 경우에도 실제 결과 파일 경로와 해당 row/SKIP 근거를 함께 기록한다.

#### 테스트 작성

- 문서 증거 보강 작업이다. 별도 테스트 파일 작성 없음.

#### 중간 검증

```bash
rg --sort path "payload=1MB|overall_result|SKIPPED/BLOCKED|stability_violations" agent-test/runs
```

기대: 새 full payload 결과 파일에서 1MB row 또는 SKIP/BLOCKED 축과 전체 결과값을 확인할 수 있다.

## 의존 관계 및 구현 순서

1. `code_review_cloud_G08_0.log`의 Required 이슈를 읽는다.
2. full payload matrix를 실행한다.
3. 필요 시 최소 코드 수정 후 full payload를 재실행한다.
4. TypeScript check/test, full matrix, `git diff --check`를 재확인한다.
5. review stub에 실제 증거를 기록한다.

## 수정 파일 요약

| 파일 | 항목 |
|---|---|
| `CODE_REVIEW-cloud-G08.md` | REVIEW_PAYLOAD_MATRIX-1, REVIEW_PAYLOAD_MATRIX-2 |
| payload harness files | full payload 실패가 코드 결함으로 확인된 경우에만 최소 수정 |

## 최종 검증

```bash
bash agent-ops/skills/project/run-proto-socket-test-matrix/scripts/run_stress.sh --full --profile payload
cd typescript && npm run check && npm test
bash agent-ops/skills/project/run-proto-socket-test-matrix/scripts/run_matrix.sh --all
git diff --check
```

기대: full payload 결과가 1MB evidence를 남기고, TypeScript check/test와 full matrix가 PASS하며, whitespace error가 없다. 모든 코드 변경과 증거 기록 완료 후 반드시 `CODE_REVIEW-cloud-G08.md`의 구현 에이전트 소유 섹션을 채운다.
