toki
b4c6550eab
- Add node store implementation for edge app - Add adapters factory for node app - Update edge and node transport layers - Update domain rules for edge and node - Add bin scripts for edge and node - Update configs and documentation - Add agent-task node_centralized_mgmt directory
126 lines
4.9 KiB
Text
126 lines
4.9 KiB
Text
<!-- task=node_centralized_mgmt plan=1 tag=REVIEW_REFACTOR -->
|
|
|
|
# Code Review Reference - REVIEW_REFACTOR
|
|
|
|
## 개요
|
|
|
|
date=2026-05-03
|
|
task=node_centralized_mgmt, plan=1, tag=REVIEW_REFACTOR
|
|
|
|
## 이 파일을 읽는 리뷰 에이전트에게
|
|
|
|
각 항목의 구현을 실제 소스 파일과 대조하고, `검증 결과` 섹션의 출력이 코드와 일치하는지 확인하세요.
|
|
리뷰 완료 후 반드시 아래 순서로 아카이브하세요.
|
|
|
|
1. `CODE_REVIEW.md` → `code_review_1.log` (N = 기존 code_review_*.log 수)
|
|
2. `PLAN.md` → `plan_1.log` (M = 기존 plan_*.log 수)
|
|
3. PASS인 경우 `complete.log` 작성 후 종료. WARN/FAIL인 경우 새 `PLAN.md` + `CODE_REVIEW.md` 스텁 작성.
|
|
|
|
---
|
|
|
|
## 구현 항목별 완료 여부
|
|
|
|
| 항목 | 완료 여부 |
|
|
|------|---------|
|
|
| [REVIEW_REFACTOR-1] buildConfigPayload: []string → structpb 오류 수정 | [x] |
|
|
| [REVIEW_REFACTOR-2] LoadFromConfig: 중복 alias 검사 추가 | [x] |
|
|
|
|
## 계획 대비 변경 사항
|
|
|
|
- `buildConfigPayload` 오류 발생 시 거절 응답을 반환하기 전에 registry에 등록되지 않도록, payload 생성 성공 이후 `registry.Register`를 수행하게 순서를 정리했다.
|
|
|
|
## 주요 설계 결정
|
|
|
|
- CLI profile의 `args`/`env`는 `structpb.NewStruct`가 처리 가능한 `[]interface{}`로 변환한다.
|
|
- `structpb.NewStruct` 오류는 더 이상 무시하지 않고 `RegisterResponse{Accepted:false, Reason:"internal config error"}`로 전파한다.
|
|
- alias 중복은 token 중복과 별도로 검사해 `"node-" + alias` 기반 ID 충돌을 차단한다.
|
|
|
|
## 리뷰어를 위한 체크포인트
|
|
|
|
- `buildConfigPayload`가 `(*iop.NodeConfigPayload, error)` 를 반환하는지 확인
|
|
- `stringsToAny` 헬퍼가 추가되어 CLI args/env에 사용되는지 확인
|
|
- `structpb.NewStruct` 오류가 더 이상 `_`로 무시되지 않는지 확인
|
|
- `onNodeConnected` 내에서 `buildConfigPayload` 오류 시 `Accepted: false` 응답하는지 확인
|
|
- `LoadFromConfig`에 alias 중복 검사가 추가되었는지 확인
|
|
- `TestBuildConfigPayload_CLIArgsRoundtrip` 테스트가 존재하고 args/env 값을 검증하는지 확인
|
|
- `TestLoadFromConfig_DuplicateAlias` 테스트가 존재하는지 확인
|
|
|
|
## 검증 결과
|
|
|
|
_구현 에이전트가 각 중간 검증 및 최종 검증 명령 실행 후 출력을 여기에 붙여 넣는다._
|
|
|
|
### REVIEW_REFACTOR-1 중간 검증
|
|
```
|
|
$ go build ./apps/edge/internal/transport/...
|
|
(no output)
|
|
|
|
$ go test ./apps/edge/internal/transport/...
|
|
ok iop/apps/edge/internal/transport 0.005s
|
|
```
|
|
|
|
### REVIEW_REFACTOR-2 중간 검증
|
|
```
|
|
$ go test ./apps/edge/internal/node/...
|
|
ok iop/apps/edge/internal/node 0.003s
|
|
```
|
|
|
|
### 최종 검증
|
|
```
|
|
$ go build ./... && go test ./...
|
|
$ go build ./...
|
|
(no output)
|
|
|
|
$ go test ./...
|
|
? iop/apps/control-plane/cmd/control-plane [no test files]
|
|
? iop/apps/edge/cmd/edge [no test files]
|
|
? iop/apps/edge/internal/bootstrap [no test files]
|
|
ok iop/apps/edge/internal/node (cached)
|
|
ok iop/apps/edge/internal/transport (cached)
|
|
? iop/apps/node/cmd/node [no test files]
|
|
ok iop/apps/node/internal/adapters (cached)
|
|
? iop/apps/node/internal/adapters/cli [no test files]
|
|
? iop/apps/node/internal/adapters/mock [no test files]
|
|
? iop/apps/node/internal/adapters/ollama [no test files]
|
|
? iop/apps/node/internal/adapters/vllm [no test files]
|
|
? iop/apps/node/internal/bootstrap [no test files]
|
|
ok iop/apps/node/internal/node (cached)
|
|
? iop/apps/node/internal/router [no test files]
|
|
? iop/apps/node/internal/runtime [no test files]
|
|
? iop/apps/node/internal/store [no test files]
|
|
ok iop/apps/node/internal/transport (cached)
|
|
? iop/apps/worker/cmd/worker [no test files]
|
|
? iop/packages/auth [no test files]
|
|
? iop/packages/config [no test files]
|
|
? iop/packages/jobs [no test files]
|
|
? iop/packages/metadata [no test files]
|
|
? iop/packages/observability [no test files]
|
|
? iop/packages/policy [no test files]
|
|
? iop/packages/version [no test files]
|
|
? iop/proto/gen/iop [no test files]
|
|
```
|
|
|
|
---
|
|
|
|
## 코드리뷰 결과
|
|
|
|
### 종합 판정: PASS
|
|
|
|
### 차원별 평가
|
|
|
|
| 차원 | 판정 | 비고 |
|
|
|------|------|------|
|
|
| Correctness | Pass | `[]string` → `[]interface{}` 변환 정확히 수정, 오류 전파 올바름 |
|
|
| Completeness | Pass | 계획 2개 항목 전부 구현 |
|
|
| Test coverage | Pass | `TestBuildConfigPayload_CLIArgsRoundtrip` args/env 값까지 검증, `TestLoadFromConfig_DuplicateAlias` 추가 |
|
|
| API contract | Pass | `buildConfigPayload` 시그니처 변경이 유일한 호출부 `onNodeConnected`에 반영됨 |
|
|
| Code quality | Pass | `stringsToAny` 범용 헬퍼로 분리, internal test로 unexported 함수 직접 검증 |
|
|
| Plan deviation | Pass | `registry.Register`를 payload 빌드 성공 이후로 이동 — 올바른 순서 개선 |
|
|
| Verification trust | Pass | 검증 출력이 실제 코드와 일치, 테스트 모두 PASS 재확인 |
|
|
|
|
### 발견된 문제
|
|
|
|
없음
|
|
|
|
### 다음 단계
|
|
|
|
PASS: `complete.log`를 작성하고 태스크를 종료한다.
|