74 lines
2.4 KiB
Markdown
74 lines
2.4 KiB
Markdown
<!-- task=03_cli_emitter_interface plan=0 tag=REFACTOR -->
|
|
|
|
# Code Review Reference - REFACTOR
|
|
|
|
## 개요
|
|
|
|
date=2026-05-04
|
|
task=03_cli_emitter_interface, plan=0, tag=REFACTOR
|
|
|
|
## 이 파일을 읽는 리뷰 에이전트에게
|
|
|
|
각 항목의 구현을 실제 소스 파일과 대조하고, `검증 결과` 섹션의 출력이 코드와 일치하는지 확인하세요.
|
|
리뷰 완료 후 반드시 아래 순서로 아카이브하세요.
|
|
|
|
1. `CODE_REVIEW.md` → `code_review_N.log`
|
|
2. `PLAN.md` → `plan_M.log`
|
|
3. PASS인 경우 `complete.log` 작성 후 종료. WARN/FAIL인 경우 새 `PLAN.md` + `CODE_REVIEW.md` 스텁 작성.
|
|
|
|
---
|
|
|
|
## 구현 항목별 완료 여부
|
|
|
|
| 항목 | 완료 여부 |
|
|
|------|---------|
|
|
| [REFACTOR-1] lineEmitter 인터페이스와 공통 driveJSONLines 도입 | [ ] |
|
|
| [REFACTOR-2] 5개 포맷을 인터페이스 구현으로 이전 | [ ] |
|
|
| [REFACTOR-3] executeCommand switch를 registry 조회로 단순화 | [ ] |
|
|
|
|
## 계획 대비 변경 사항
|
|
|
|
_구현 에이전트가 계획과 다르게 구현한 부분을 이유와 함께 기록한다._
|
|
|
|
## 주요 설계 결정
|
|
|
|
_구현 에이전트가 주요 설계 결정 사항을 기록한다._
|
|
|
|
## 리뷰어를 위한 체크포인트
|
|
|
|
- 5개 emit* 함수가 모두 삭제되고 oneshot.go가 명시적으로 짧아졌는지 (`wc -l`로 확인)
|
|
- `driveJSONLines`가 RunID/Timestamp 자동 채움을 책임지고 emitter 구조체에는 그 정보가 새지 않는지
|
|
- 알 수 없는 `OutputFormat`에 대한 fallback이 raw stdout chunks로 일관되는지(또는 결정된 정책대로 동작하는지)
|
|
- 큰 라인이 필요한 claude/cline 포맷에서 `scanBufMax`가 8MB로 유지되는지
|
|
- raw `emitStdoutChunks`는 인터페이스에서 제외된 채 그대로 동작하는지
|
|
- 회귀 테스트(black-box)가 모두 PASS이며 신규 emitter 단위 테스트가 추가됐는지
|
|
|
|
## 검증 결과
|
|
|
|
_구현 에이전트가 각 중간 검증 및 최종 검증 명령 실행 후 출력을 여기에 붙여 넣는다._
|
|
|
|
### REFACTOR-1 중간 검증
|
|
```
|
|
$ go test ./apps/node/internal/adapters/cli/...
|
|
(output)
|
|
```
|
|
|
|
### REFACTOR-2 중간 검증
|
|
```
|
|
$ go test ./apps/node/internal/adapters/cli/...
|
|
(output)
|
|
```
|
|
|
|
### REFACTOR-3 중간 검증
|
|
```
|
|
$ go test ./apps/node/internal/adapters/cli/...
|
|
(output)
|
|
```
|
|
|
|
### 최종 검증
|
|
```
|
|
$ go build ./...
|
|
$ go test ./apps/node/...
|
|
$ wc -l apps/node/internal/adapters/cli/oneshot.go apps/node/internal/adapters/cli/emitters.go
|
|
(output)
|
|
```
|