<!-- task=node_unit_tests plan=0 tag=TEST -->

# Code Review Reference - TEST

## 개요

date=2026-05-02
task=node_unit_tests, plan=0, tag=TEST

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

각 항목의 구현을 실제 소스 파일과 대조하고, `검증 결과` 섹션의 출력이 코드와 일치하는지 확인하세요.
리뷰 완료 후 반드시 아래 순서로 아카이브하세요.

1. `CODE_REVIEW.md` → `code_review_0.log`
2. `PLAN.md` → `plan_0.log`
3. PASS인 경우 `complete.log` 작성 후 종료. WARN/FAIL인 경우 새 `PLAN.md` + `CODE_REVIEW.md` 스텁 작성.

---

## 구현 항목별 완료 여부

| 항목 | 완료 여부 |
|------|---------|
| [TEST-1] transport/frame 유닛 테스트 | [ ] |
| [TEST-2] transport/codec 유닛 테스트 | [ ] |
| [TEST-3] mock adapter 유닛 테스트 | [ ] |
| [TEST-4] router 유닛 테스트 | [ ] |

## 계획 대비 변경 사항

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

## 주요 설계 결정

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

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

- frame_test.go: `readFrame` / `writeFrame` 모두 `package transport` 화이트박스로 접근하는지 확인
- codec_test.go: 잘못된 JSON 입력 시 nil 이 아닌 error 반환 여부
- mock_test.go: 이벤트 순서가 start → delta+ → complete 이고 RunID가 모든 이벤트에 일관되게 전파되는지 확인
- mock_test.go: cancel 테스트가 `context.Canceled` / `context.DeadlineExceeded` 외 에러는 실패로 처리하는지 확인
- router_test.go: 빈 registry 케이스와 미등록 어댑터 케이스 모두 error 반환하는지 확인

## 검증 결과

_구현 에이전트가 각 중간 검증 및 최종 검증 명령 실행 후 출력을 여기에 붙여 넣는다._

### TEST-1 중간 검증
```
$ go test ./apps/node/internal/transport/... -run TestWriteReadFrame -v
$ go test ./apps/node/internal/transport/... -run TestReadFrame -v
(output)
```

### TEST-2 중간 검증
```
$ go test ./apps/node/internal/transport/... -run TestEncodeDecodeEnvelope -v
$ go test ./apps/node/internal/transport/... -run TestDecodeEnvelope -v
$ go test ./apps/node/internal/transport/... -run TestEncodeDecodePayload -v
(output)
```

### TEST-3 중간 검증
```
$ go test ./apps/node/internal/adapters/mock/... -v
(output)
```

### TEST-4 중간 검증
```
$ go test ./apps/node/internal/router/... -v
(output)
```

### 최종 검증
```
$ go test ./apps/node/internal/transport/... ./apps/node/internal/adapters/mock/... ./apps/node/internal/router/... -v -count=1
$ go build ./...
(output)
```