iop/agent-task/m-node-resource-model-unification/03+01_edge_dispatch_status/CODE_REVIEW-cloud-G07.md

Code Review Reference - REFACTOR

[IMPLEMENTING AGENT - READ FIRST] Filling in this file is the mandatory final step of implementation. Complete the checklist, fill implementation-owned sections, then stop with active files in place and report ready for review. Do not ask the user directly during implementation.

개요

date=2026-06-27 task=m-node-resource-model-unification/03+01_edge_dispatch_status, plan=0, tag=REFACTOR

Roadmap Targets

• Milestone: agent-roadmap/phase/operational-observability-provider-management/milestones/node-resource-model-unification.md
• Task ids:
  • edge-routing-status: Edge provider-only queue routing and resource-first status
• Completion mode: check-on-pass

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

[REVIEW AGENT ONLY] 종결 절차는 코드리뷰 에이전트 전용이다.

구현 항목별 완료 여부

항목	완료 여부
[REFACTOR-1] Provider-only Queue Admission	[ ]
[REFACTOR-2] Provider Adapter Dispatch Validation	[ ]
[REFACTOR-3] Resource-first Status Snapshot	[ ]

구현 체크리스트

• service queue 진입 조건을 ProviderPool && ModelGroupKey != "" && queue != nil로 제한한다.
• CLI/openai legacy route는 ModelGroupKey가 있어도 direct dispatch로 흐르고 provider pool queue/inflight를 사용하지 않게 한다.
• provider-pool candidate resolution에서 provider adapter가 같은 node의 enabled adapter instance인지 확인한다.
• status snapshot은 정의된 resource/provider catalog를 우선하고, legacy adapter snapshot은 catalog가 없을 때만 compat로 낸다.
• provider별 in_flight/queued accounting이 같은 node의 여러 provider에서 독립적으로 유지되는지 test를 보강한다.
• CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.

코드리뷰 전용 체크리스트

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

• 코드리뷰 결과에 PASS, WARN, FAIL 중 하나의 판정을 append한다.
• active files를 .log로 아카이브한다.
• PASS이면 complete.log를 작성하고 archive로 이동한다.
• WARN/FAIL이면 다음 active plan/review 또는 USER_REVIEW.md를 작성한다.

계획 대비 변경 사항

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

주요 설계 결정

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

사용자 리뷰 요청

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

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

리뷰어를 위한 체크포인트

• provider-pool만 queue를 타는지 확인한다.
• bad provider adapter가 config/load 또는 candidate resolution에서 막히는지 확인한다.
• status provider snapshot이 catalog resource 중심으로 중복 없이 나오는지 확인한다.

검증 결과

REFACTOR-1 중간 검증

$ go test -count=1 ./apps/edge/internal/service ./apps/edge/internal/openai
(output)

REFACTOR-2 중간 검증

$ go test -count=1 ./apps/edge/internal/service ./apps/edge/internal/edgevalidate
(output)

REFACTOR-3 중간 검증

$ go test -count=1 ./apps/edge/internal/service
(output)

최종 검증

$ go test -count=1 ./apps/edge/...
(output)

[IMPLEMENTING AGENT - BEFORE SAVING] Have you filled in every implementation-owned section?