iop/agent-task/03_cli_emitter_interface/CODE_REVIEW.md

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)