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