iop/agent-task/node_testclient/CODE_REVIEW.md
toki 2d6fde0876 기능: IOP 모노레포 스캐폴드 초기 구현
apps/node 중심 구현 — TCP+JSON transport, Hexagonal Architecture,
mock/cli adapter, fx DI, SQLite 실행 이력 저장.
edge/control-plane/worker는 cobra placeholder.
유닛 테스트 및 통합 테스트 클라이언트 계획서 추가.
2026-05-02 13:20:35 +09:00

75 lines
2.2 KiB
Markdown

<!-- task=node_testclient plan=0 tag=TEST -->
# Code Review Reference - TEST
## 개요
date=2026-05-02
task=node_testclient, 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] iop-node-testclient 커맨드 생성 | [ ] |
| [TEST-2] Makefile에 testclient 빌드 타겟 추가 | [ ] |
## 계획 대비 변경 사항
_구현 에이전트가 계획과 다르게 구현한 부분을 이유와 함께 기록한다._
## 주요 설계 결정
_구현 에이전트가 주요 설계 결정 사항을 기록한다._
## 리뷰어를 위한 체크포인트
- `sendMsg` / `recvEnvelope` 의 프레임 포맷이 서버 `transport/frame.go` 와 동일한 `4-byte big-endian length | JSON(Envelope)` 인지 확인
- `internal` 경로 패키지를 import하지 않고 `iop/packages/protocol` 만 사용하는지 확인
- `-caps` 플래그 없이 실행해도 RunRequest → RunEvent 흐름이 정상 동작하는지 확인
- 60s 타임아웃 이전에 complete/error 이벤트 수신 시 정상 종료하는지 확인
- Makefile `build` 타겟에 `iop-node-testclient` 라인이 추가되었는지 확인
## 검증 결과
_구현 에이전트가 각 중간 검증 및 최종 검증 명령 실행 후 출력을 여기에 붙여 넣는다._
### TEST-1 중간 검증
```
$ go build -o bin/iop-node-testclient ./apps/node/cmd/iop-node-testclient
(output)
```
### TEST-2 중간 검증
```
$ make build
$ ls -la bin/
(output)
```
### 최종 검증
```
# 터미널 A
$ ./bin/iop-node serve --config configs/node.yaml
(output)
# 터미널 B
$ ./bin/iop-node-testclient
$ ./bin/iop-node-testclient -caps
$ ./bin/iop-node-testclient -prompt "안녕하세요 IOP!"
(output)
$ go build ./...
(output)
```