From 0e6c7ce3c152b8e51f59e4c13e82224e4592930f Mon Sep 17 00:00:00 2001 From: toki Date: Sun, 21 Jun 2026 06:02:35 +0900 Subject: [PATCH] update: operational-observability-provider-management PHASE and provider-catalog-device-status milestone --- .../PHASE.md | 2 +- .../milestones/provider-catalog-device-status.md | 15 +++++++++------ 2 files changed, 10 insertions(+), 7 deletions(-) diff --git a/agent-roadmap/phase/operational-observability-provider-management/PHASE.md b/agent-roadmap/phase/operational-observability-provider-management/PHASE.md index 01483ee..72b5993 100644 --- a/agent-roadmap/phase/operational-observability-provider-management/PHASE.md +++ b/agent-roadmap/phase/operational-observability-provider-management/PHASE.md @@ -16,7 +16,7 @@ provider 확장 Phase에서 검증한 Ollama, vLLM, SGLang, Lemonade 같은 추 완료, 검토중, 진행중, 계획, 스케치 순서로 두어 아래로 갈수록 미래 작업에 가까워지게 정렬한다. 스케치 Milestone은 아직 구현 가능한 계획이 아니므로 사용자 검토와 구체화 후 `[계획]`으로 승격한다. -- [진행중] Model Alias Provider Pool과 Provider Catalog +- [검토중] Model Alias Provider Pool과 Provider Catalog - 경로: `agent-roadmap/phase/operational-observability-provider-management/milestones/provider-catalog-device-status.md` - 요약: `models[]`를 외부 model key이자 운영 catalog model로 두고, Node 하위 provider와 served model list를 기준으로 Edge가 provider 선택, load-ratio routing, target rewrite, read-only catalog 상태를 소유하는 MVP 계약을 구현 계획 대상으로 정리한다. diff --git a/agent-roadmap/phase/operational-observability-provider-management/milestones/provider-catalog-device-status.md b/agent-roadmap/phase/operational-observability-provider-management/milestones/provider-catalog-device-status.md index 5c1e210..5e7ac95 100644 --- a/agent-roadmap/phase/operational-observability-provider-management/milestones/provider-catalog-device-status.md +++ b/agent-roadmap/phase/operational-observability-provider-management/milestones/provider-catalog-device-status.md @@ -14,7 +14,7 @@ provider/device/model별 qualification report와 benchmark/품질 비교는 이 ## 상태 -[진행중] +[검토중] ## 승격 조건 @@ -63,16 +63,18 @@ provider/device/model별 qualification report와 benchmark/품질 비교는 이 운영자가 model provider pool과 provider 상태를 같은 기준으로 비교하기 위한 read-only catalog 산출물을 묶는다. - [x] [category-map] MVP provider category가 `api`, `cli`, `local_inference`로 정리되고 read-only catalog 표시 필드에 반영된다. -- [ ] [device-status] provider health, capacity, in-flight, derived load ratio, served models, queued 상태가 catalog/status 표면에 정리된다. +- [x] [device-status] provider health, capacity, in-flight, derived load ratio, served models, queued 상태가 catalog/status 표면에 정리된다. - [x] [lifecycle-cap] Ollama, Lemonade, vLLM, SGLang 등의 lifecycle 차이가 coarse capability flags로 표시되고 상세 qualification report는 후속 범위로 분리된다. - [x] [boundary] provider adapter 구현, Edge-owned provider pool routing, read-only operations catalog, 후속 runtime control의 책임 경계가 정리되어 있다. -- [ ] [ops-review] Edge config와 Edge-owned read-only catalog/status를 기준으로 `iop-edge` CLI, Control Plane, Client가 어떤 정보를 소비하는지 확인할 수 있다. +- [x] [ops-review] Edge config와 Edge-owned read-only catalog/status를 기준으로 `iop-edge` CLI, Control Plane, Client가 어떤 정보를 소비하는지 확인할 수 있다. ## 완료 리뷰 -- 상태: 없음 -- 요청일: 없음 -- 완료 근거: 진행중 Milestone이며 `agent-task/archive/2026/06/m-provider-catalog-device-status/01_pool_schema/complete.log`와 `agent-task/archive/2026/06/m-provider-catalog-device-status/02+01_edge_dispatch/complete.log`의 Roadmap/Spec Completion 근거로 `alias-contract`, `candidate-schema`, `target-rewrite`, `selection-policy`를 완료 반영했다. `pool-compat`는 `01_pool_schema` 계획의 API-3 compatibility 산출물, `apps/edge/README.md`와 `configs/edge.yaml`의 migration/compat note, `TestLoadEdge_ProviderPoolLegacyCompatibility` 및 OpenAI provider-pool legacy fallback tests를 S05 보조 근거로 완료 반영했다. Provider Operations Catalog는 `packages/go/config`, `proto/iop/runtime.proto`, `apps/edge/internal/service/model_queue.go`, `apps/edge/README.md`, `configs/edge.yaml`, `apps/edge/internal/edgecmd/nodes.go` 근거로 `category-map`, `lifecycle-cap`, `boundary`를 완료 반영했으며, `device-status`와 `ops-review`는 Control Plane/Client 표면 계획이 남아 있다. +- 상태: 검토중 +- 요청일: 2026-06-21 +- 완료 근거: `agent-task/archive/2026/06/m-provider-catalog-device-status/01_pool_schema/complete.log`, `02+01_edge_dispatch/complete.log`, `03_catalog_status_http/complete.log`, `04+03_client_catalog_view/complete.log`의 Roadmap Completion과 Spec Completion 기준으로 모든 기능 Task와 S01-S10 Acceptance Scenario가 PASS 근거를 갖는다. +- 완료 근거: `device-status`는 Control Plane `/edges/{id}/status`의 `provider_snapshots` JSON과 `load_ratio=0` 보존 regression test, `ops-review`는 Client Nodes panel provider catalog/status 렌더링과 health color mapping widget test를 근거로 완료 반영했다. +- 남은 차단 항목: 없음 - 리뷰 필요: - [ ] 사용자가 완료 결과를 확인했다 - [ ] archive 이동을 승인했다 @@ -100,4 +102,5 @@ provider/device/model별 qualification report와 benchmark/품질 비교는 이 - 작업 메모: [sync] `01_pool_schema` 완료 로그로 `alias-contract`, `candidate-schema`를, `02+01_edge_dispatch` 완료 로그로 `target-rewrite`, `selection-policy`를 Roadmap/Spec Completion 기준 완료 처리했다. - 작업 메모: [sync-correction] `pool-compat`는 `01_pool_schema`의 공식 Roadmap/Spec Targets에는 빠졌지만, SDD S05 Evidence Map이 요구한 migration/compat note와 기존 `model_routes` regression evidence가 `apps/edge/README.md`, `configs/edge.yaml`, `packages/go/config/config_test.go`, `apps/edge/internal/openai/server_test.go`에 남아 있어 완료로 보정했다. - 작업 메모: [provider-catalog-small] `api`, `cli`, `local_inference` category는 `config.Category*`와 `ProviderSnapshot.category`에 반영되어 있고, coarse lifecycle capability는 `nodes[].providers[].lifecycle_capabilities`와 `ProviderSnapshot.lifecycle_capabilities` 및 `iop-edge nodes list` configured provider 요약으로 확인 가능하다. 상세 lifecycle/qualification과 runtime control은 SDD/범위 제외 기준에 따라 후속 Milestone으로 분리한다. +- 작업 메모: [sync-complete] `03_catalog_status_http` 완료 로그로 `device-status`를, `04+03_client_catalog_view` 완료 로그로 `ops-review`를 Roadmap/Spec Completion 기준 완료 처리했다. - 확인 필요: 없음