iop/agent-task/node_unit_tests/CODE_REVIEW.md

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)