Code Review Reference - API

[IMPLEMENTING AGENT — READ FIRST] Filling in this file is the mandatory final step of implementation. The task is NOT complete until every implementation-owned section below is filled in. Complete the 구현 체크리스트; the final checklist item is mandatory before saving. Fill implementation-owned sections, then stop with active files in place and report ready for review. If implementation is blocked by a selected Milestone 구현 잠금 > 결정 필요 item, fill 사용자 리뷰 요청 with linked evidence and stop with active files in place; code-review decides whether to write USER_REVIEW.md. Do not ask the user directly, present choices in chat, or call request_user_input during implementation. Finalization is review-agent-only.

개요

date=2026-07-07 task=m-openai-compatible-raw-tunnel-sideband-passthrough/02+01_edge_stream, plan=0, tag=API

Roadmap Targets

Milestone: agent-roadmap/phase/routing-policy-model-orchestration/milestones/openai-compatible-raw-tunnel-sideband-passthrough.md
Milestone link: Milestone 문서
Task ids:
- edge-stream: Edge OpenAI-compatible handler는 tunnel status/headers/body chunks를 caller에게 그대로 write하고 pure passthrough를 기본값으로 적용한다.
Completion mode: check-on-pass

이 파일을 읽는 리뷰 에이전트에게

[REVIEW AGENT ONLY] 아래 종결 절차는 코드리뷰 에이전트 전용이다. 구현 에이전트는 이 섹션을 실행하지 않는다.

각 항목의 구현을 실제 소스 파일과 대조하고, 검증 결과 섹션의 출력이 코드와 일치하는지 확인하세요.

구현 항목별 완료 여부

항목	완료 여부
[API-1] Tunnel Frame Routing	[ ]
[API-2] OpenAI Passthrough Writer	[ ]

구현 체크리스트

01_node_relay predecessor complete.log를 확인하고 경로를 review stub에 기록한다.
Edge transport가 ProviderTunnelFrame을 request-bound channel로 라우팅하되 events.Bus에는 publish하지 않게 구현한다.
Edge service에 provider-pool/direct route 공통 SubmitProviderTunnel 경로를 추가하고 admission slot release를 END/ERROR/cancel에서 보장한다.
OpenAI Chat Completions handler가 OpenAI-compatible provider route의 omitted mode를 pure passthrough로 처리하고 provider status/header/body bytes를 caller에게 그대로 쓴다. 검증: streaming/non-streaming Chat Completions fixture가 provider 원본과 byte-identical하게 반환된다.
caller disconnect/context cancel이 Node cancel/control path로 전파되는지 test한다.
go test ./apps/edge/internal/transport ./apps/edge/internal/service ./apps/edge/internal/openai를 실행한다.
CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.

코드리뷰 전용 체크리스트

[REVIEW AGENT ONLY] 이 체크리스트는 코드리뷰 에이전트만 사용한다.

코드리뷰 결과에 PASS, WARN, FAIL 중 하나의 판정을 append한다.
predecessor 01_node_relay completion evidence가 유효하다.
active CODE_REVIEW-*-G??.md를 code_review_cloud_G07_N.log로 아카이브한다.
active PLAN-*-G??.md를 plan_cloud_G07_M.log로 아카이브한다.
PASS이면 complete.log 작성 후 active task 디렉터리를 agent-task/archive/YYYY/MM/m-openai-compatible-raw-tunnel-sideband-passthrough/02+01_edge_stream/로 이동한다.

계획 대비 변경 사항

구현 에이전트가 계획과 다르게 구현한 부분을 이유와 함께 기록한다.

주요 설계 결정

구현 에이전트가 주요 설계 결정 사항을 기록한다.

사용자 리뷰 요청

기본값은 없음이다. 구현 중 새 결정이 필요해 보여도 직접 질문하거나 선택지를 제시하거나 request_user_input을 호출하지 않는다. 이 섹션은 선택된 Milestone 구현 잠금 > 결정 필요 항목이 실구현을 차단할 때만 채운다. 외부 환경/secret/서비스 준비, 검증 증거 공백, 반복 실패, 일반 범위 조정은 사용자 리뷰 요청이 아니며 검증 결과, 계획 대비 변경 사항, 또는 code-review의 일반 follow-up plan으로 처리한다.

상태: 없음
사유 유형: 없음
연결 대상: 없음
결정 필요: 없음
차단 근거: 없음
실행한 검증/명령: 없음
자동 후속 불가 이유: 없음
재개 조건: 없음

리뷰어를 위한 체크포인트

Pure passthrough body에 IOP sideband/event/field가 섞이지 않는가.
Streaming/non-streaming body byte comparison이 provider fixture와 동일한가.
Provider-pool admission slot이 END/ERROR/cancel에서 release되는가.

검증 결과

API-1 중간 검증

$ go test ./apps/edge/internal/transport ./apps/edge/internal/service
(output)

API-2 중간 검증

$ go test ./apps/edge/internal/openai
(output)

최종 검증

$ go test ./apps/edge/internal/transport ./apps/edge/internal/service ./apps/edge/internal/openai
(output)

5.4 KiB Raw Blame History