<!-- 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)
```