toki
2d6fde0876
apps/node 중심 구현 — TCP+JSON transport, Hexagonal Architecture, mock/cli adapter, fx DI, SQLite 실행 이력 저장. edge/control-plane/worker는 cobra placeholder. 유닛 테스트 및 통합 테스트 클라이언트 계획서 추가.
82 lines
2.6 KiB
Markdown
82 lines
2.6 KiB
Markdown
<!-- 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)
|
|
```
|