diff --git a/agent-ops/roadmap/ROADMAP.md b/agent-ops/roadmap/ROADMAP.md index 32fa461..b00447d 100644 --- a/agent-ops/roadmap/ROADMAP.md +++ b/agent-ops/roadmap/ROADMAP.md @@ -25,18 +25,18 @@ RAG, context 구성/압축, web search, MCP 정책, tool policy, output validati - 경로: `agent-ops/roadmap/archive/phase/edge-node-execution-foundation/PHASE.md` - 요약: Edge-Node 소켓 실행 경로, Node adapter execution, CLI session, 최소 외부 입력 표면을 안정화한 단계다. -- [진행중] Automation Runtime과 Bridge 확장 - - 경로: `agent-ops/roadmap/phase/automation-runtime-bridge/PHASE.md` - - 요약: Runtime과 Automation 실행 흐름을 공통화하고, agent 설치형/비설치형 대상 제어 경로를 분리해 확장하는 단계다. - -- [진행중] Control Plane과 Client 운영 - - 경로: `agent-ops/roadmap/phase/control-plane-portal-ops/PHASE.md` - - 요약: 여러 Edge를 관찰하고 운영하는 중앙 제어면과 Flutter client 운영면을 구축하는 단계다. - - [진행중] 서빙 라우팅과 최적화 기반 - 경로: `agent-ops/roadmap/phase/serving-routing-optimization/PHASE.md` - 요약: Edge OpenAI-compatible API에서 Node의 Ollama serving을 호출하는 E2E 한 사이클을 먼저 완성하고, 이후 로컬/클라우드 모델 profile, 부하 라우팅, 품질 평가 기준과 최적화 계층으로 확장하는 단계다. +- [계획] Automation Runtime과 Bridge 확장 + - 경로: `agent-ops/roadmap/phase/automation-runtime-bridge/PHASE.md` + - 요약: Runtime과 Automation 실행 흐름을 공통화하고, agent 설치형/비설치형 대상 제어 경로를 분리해 확장하는 단계다. + +- [계획] Control Plane과 Client 운영 + - 경로: `agent-ops/roadmap/phase/control-plane-portal-ops/PHASE.md` + - 요약: 여러 Edge를 관찰하고 운영하는 중앙 제어면과 Flutter client 운영면을 구축하는 단계다. + ## 로딩 정책 - 일반 작업에서는 `agent-ops/roadmap/ROADMAP.md`를 매번 읽지 않는다. diff --git a/agent-ops/roadmap/current.md b/agent-ops/roadmap/current.md index 16c5368..050be02 100644 --- a/agent-ops/roadmap/current.md +++ b/agent-ops/roadmap/current.md @@ -5,37 +5,11 @@ - [진행중] 서빙 라우팅과 최적화 기반 - 경로: `agent-ops/roadmap/phase/serving-routing-optimization/PHASE.md` -- [진행중] Automation Runtime과 Bridge 확장 - - 경로: `agent-ops/roadmap/phase/automation-runtime-bridge/PHASE.md` - -- [진행중] Control Plane과 Client 운영 - - 경로: `agent-ops/roadmap/phase/control-plane-portal-ops/PHASE.md` - ## 활성 Milestone -- [계획] 지식, 도구 정책, 검증 최적화 +- [진행중] Ollama 실테스트와 후속 안정화 - Phase: `agent-ops/roadmap/phase/serving-routing-optimization/PHASE.md` - - 경로: `agent-ops/roadmap/phase/serving-routing-optimization/milestones/knowledge-tool-validation-optimization.md` - -- [검토중] Specialized Agent proto-socket 연결 기반 - - Phase: `agent-ops/roadmap/phase/automation-runtime-bridge/PHASE.md` - - 경로: `agent-ops/roadmap/phase/automation-runtime-bridge/milestones/specialized-agent-proto-socket-foundation.md` - -- [진행중] Agent Bootstrap과 OTO 등록 - - Phase: `agent-ops/roadmap/phase/automation-runtime-bridge/PHASE.md` - - 경로: `agent-ops/roadmap/phase/automation-runtime-bridge/milestones/agent-bootstrap-oto-enrollment.md` - -- [계획] Client Integration Clone Adoption - - Phase: `agent-ops/roadmap/phase/control-plane-portal-ops/PHASE.md` - - 경로: `agent-ops/roadmap/phase/control-plane-portal-ops/milestones/client-integration-clone-adoption.md` - -- [진행중] Control Plane과 Client - - Phase: `agent-ops/roadmap/phase/control-plane-portal-ops/PHASE.md` - - 경로: `agent-ops/roadmap/phase/control-plane-portal-ops/milestones/control-plane-portal.md` - -- [계획] 원격 터미널 브리지 POC - - Phase: `agent-ops/roadmap/phase/automation-runtime-bridge/PHASE.md` - - 경로: `agent-ops/roadmap/phase/automation-runtime-bridge/milestones/remote-terminal-bridge-poc.md` + - 경로: `agent-ops/roadmap/phase/serving-routing-optimization/milestones/ollama-field-validation-follow-up.md` ## 선택 규칙 diff --git a/agent-ops/roadmap/phase/automation-runtime-bridge/PHASE.md b/agent-ops/roadmap/phase/automation-runtime-bridge/PHASE.md index 48965a5..8154d60 100644 --- a/agent-ops/roadmap/phase/automation-runtime-bridge/PHASE.md +++ b/agent-ops/roadmap/phase/automation-runtime-bridge/PHASE.md @@ -2,7 +2,7 @@ ## 상태 -[진행중] +[계획] ## 목표 @@ -22,7 +22,7 @@ CLI 실행, specialized agent 등록, bootstrap/enrollment, 원격 터미널 브 - 경로: `agent-ops/roadmap/phase/automation-runtime-bridge/milestones/specialized-agent-proto-socket-foundation.md` - 요약: OTO의 node-compatible proto-socket registration smoke를 바탕으로 Edge의 specialized agent kind, registry/config, message boundary, reconnect 정책과 runtime 경로 구분을 완료 후보로 정리했다. -- [진행중] Agent Bootstrap과 OTO 등록 +- [계획] Agent Bootstrap과 OTO 등록 - 경로: `agent-ops/roadmap/phase/automation-runtime-bridge/milestones/agent-bootstrap-oto-enrollment.md` - 요약: specialized domain agent의 bootstrap command 발급, 설치, 등록, 장기 credential 흐름을 설계한다. diff --git a/agent-ops/roadmap/phase/automation-runtime-bridge/milestones/agent-bootstrap-oto-enrollment.md b/agent-ops/roadmap/phase/automation-runtime-bridge/milestones/agent-bootstrap-oto-enrollment.md index b01fdf6..9bbaa55 100644 --- a/agent-ops/roadmap/phase/automation-runtime-bridge/milestones/agent-bootstrap-oto-enrollment.md +++ b/agent-ops/roadmap/phase/automation-runtime-bridge/milestones/agent-bootstrap-oto-enrollment.md @@ -12,7 +12,7 @@ OTO는 build/deploy domain agent의 대표 후보로 둔다. ## 상태 -[진행중] +[계획] ## 구현 잠금 @@ -74,7 +74,7 @@ OTO는 build/deploy domain agent의 대표 후보로 둔다. ## 작업 컨텍스트 - 관련 경로: `apps/edge`, `docs/deploy-dev.md`, `docs/architecture.md`, `../oto/agent-ops/roadmap/phase/edge-direct-oto-agent/milestones/oto-agent-registration.md`, `../oto/agent-ops/roadmap/phase/message-based-build-agent/milestones/agent-message-protocol.md`, `../oto/assets/script/shell/oto_agent_bootstrap.sh` -- 전환 상태: `Specialized Agent proto-socket 연결 기반`이 `[검토중]`으로 전환되어 이 마일스톤이 다음 구현 후보이며, 구현 시작 전 `enrollment_token` 범위와 HTTP local/insecure bootstrap 정책 결정을 먼저 해소한다. +- 전환 상태: Ollama 실테스트와 후속 안정화를 우선 열어두는 동안 이 마일스톤은 계획 후보로 대기한다. 구현 시작 전 `enrollment_token` 범위와 HTTP local/insecure bootstrap 정책 결정을 먼저 해소한다. - 표준선(선택): OTO agent는 `iop-node` 하위 프로세스가 아니라 Edge에 직접 outbound 연결하는 specialized domain agent로 둔다. - 표준선(선택): Edge는 `oto-agent` record를 만들고, agent id/alias/enrollment token/release base URL/bootstrap script URL을 포함한 one-line command를 발급한다. - 표준선(선택): OTO Linux MVP command 형식은 `curl -fsSL "${OTO_BOOTSTRAP_URL}" | bash -s -- --edge-url "${EDGE_URL}" --agent-id "${AGENT_ID}" --enrollment-token "${ENROLLMENT_TOKEN}" --release-base-url "${OTO_RELEASE_BASE_URL}" --agent-alias "${AGENT_ALIAS}"`를 기준으로 한다. diff --git a/agent-ops/roadmap/phase/control-plane-portal-ops/PHASE.md b/agent-ops/roadmap/phase/control-plane-portal-ops/PHASE.md index 3070b8c..6e548f2 100644 --- a/agent-ops/roadmap/phase/control-plane-portal-ops/PHASE.md +++ b/agent-ops/roadmap/phase/control-plane-portal-ops/PHASE.md @@ -2,7 +2,7 @@ ## 상태 -[진행중] +[계획] ## 목표 @@ -21,7 +21,7 @@ - 경로: `agent-ops/roadmap/phase/control-plane-portal-ops/milestones/client-integration-clone-adoption.md` - 요약: NomadCode client 표준을 IOP client에 복제하기 위한 모듈명, bootstrap, proto-socket, Mattermost push host integration 기준을 정리한다. -- [진행중] Control Plane과 Client +- [계획] Control Plane과 Client - 경로: `agent-ops/roadmap/phase/control-plane-portal-ops/milestones/control-plane-portal.md` - 요약: 여러 Edge를 연결하고 관찰하며 Edge 설정 변경, 명령 전달, 이벤트 수신을 담당하는 중앙 제어면과 Flutter client 운영면을 구축한다. diff --git a/agent-ops/roadmap/phase/control-plane-portal-ops/milestones/control-plane-portal.md b/agent-ops/roadmap/phase/control-plane-portal-ops/milestones/control-plane-portal.md index 5e9d3b5..0c38a77 100644 --- a/agent-ops/roadmap/phase/control-plane-portal-ops/milestones/control-plane-portal.md +++ b/agent-ops/roadmap/phase/control-plane-portal-ops/milestones/control-plane-portal.md @@ -12,7 +12,7 @@ Client는 NomadCode 전용 화면이 아니라 IOP가 독립적으로 운영되 ## 상태 -[진행중] +[계획] ## 구현 잠금 diff --git a/agent-ops/roadmap/phase/serving-routing-optimization/PHASE.md b/agent-ops/roadmap/phase/serving-routing-optimization/PHASE.md index 73bac59..5c1ead7 100644 --- a/agent-ops/roadmap/phase/serving-routing-optimization/PHASE.md +++ b/agent-ops/roadmap/phase/serving-routing-optimization/PHASE.md @@ -17,6 +17,10 @@ - 경로: `agent-ops/roadmap/archive/phase/serving-routing-optimization/milestones/model-serving-load-routing.md` - 요약: Edge OpenAI-compatible API를 통해 Node에서 serving 중인 Ollama를 일반 OpenAI/Ollama client 경험에 가깝게 조회, 선택, 호출하는 E2E 한 사이클과 Ollama option/API passthrough를 완료했다. 자동 라우팅, cloud fallback, 품질 평가는 후속으로 미룬다. +- [진행중] Ollama 실테스트와 후속 안정화 + - 경로: `agent-ops/roadmap/phase/serving-routing-optimization/milestones/ollama-field-validation-follow-up.md` + - 요약: 완료 처리된 Ollama E2E baseline을 사용자 실테스트로 다시 확인하고, 실제 사용 중 발견되는 후속 안정화 작업을 정리한다. + - [계획] 지식, 도구 정책, 검증 최적화 - 경로: `agent-ops/roadmap/phase/serving-routing-optimization/milestones/knowledge-tool-validation-optimization.md` - 요약: 기본 서빙과 부하 라우팅 이후 RAG, context 구성/압축, web search, MCP/tool policy, output validation, retry/fallback을 IOP 최적화 계층으로 확장한다. diff --git a/agent-ops/roadmap/phase/serving-routing-optimization/milestones/ollama-field-validation-follow-up.md b/agent-ops/roadmap/phase/serving-routing-optimization/milestones/ollama-field-validation-follow-up.md new file mode 100644 index 0000000..1b18f30 --- /dev/null +++ b/agent-ops/roadmap/phase/serving-routing-optimization/milestones/ollama-field-validation-follow-up.md @@ -0,0 +1,69 @@ +# Milestone: Ollama 실테스트와 후속 안정화 + +## 위치 + +- Roadmap: `agent-ops/roadmap/ROADMAP.md` +- Phase: `agent-ops/roadmap/phase/serving-routing-optimization/PHASE.md` + +## 목표 + +완료 처리된 Ollama E2E baseline을 사용자 실테스트로 다시 확인하고, 실제 사용 중 발견되는 Ollama 연동 후속 작업을 안정화 범위로 정리한다. +기존 archive 기록은 완료 스냅샷으로 보존하고, 이 Milestone은 실테스트 결과와 추가 작업을 현재 활성 좌표로 받는다. + +## 상태 + +[진행중] + +## 승격 조건 + +- 없음 + +## 구현 잠금 + +- 상태: 잠금 +- 결정 필요: 아래 체크리스트 + - [ ] 사용자 실테스트 결과와 재현 로그를 공유한다. + - [ ] 실테스트 뒤 생긴 후속 작업을 이 Milestone에서 처리할지, 별도 routing/fallback 또는 compatibility Milestone으로 분리할지 결정한다. + +## 범위 + +- 실제 Ollama endpoint를 대상으로 Edge OpenAI-compatible API, Edge-Node relay, Node Ollama adapter의 사용자 재현 흐름을 다시 확인한다. +- `/v1/models`, `/v1/chat/completions` non-streaming/streaming, reasoning/content 분리, Ollama option/API passthrough의 실제 사용 결과를 기록한다. +- 실테스트에서 나온 문제를 compatibility, config/docs, reasoning stream, option passthrough, routing/fallback 후보로 분류한다. +- archive된 `Ollama E2E 서빙 안정화` 완료 기록은 재포맷하지 않고, 새 후속 작업만 이 Milestone에서 관리한다. + +## 기능 + +### Epic: [field-validation] Field Validation and Follow-up + +사용자 실테스트 결과를 현재 활성 Ollama 연동 작업으로 받아 후속 안정화 범위를 정한다. + +- [ ] [field-test] 실제 Ollama 연동 실테스트 결과와 재현 로그가 기록되어 있다. 검증: 실제 모델 조회와 non-streaming/streaming chat 결과 또는 실패 로그가 남아 있다. +- [ ] [issue-triage] 실테스트에서 나온 후속 작업이 API compatibility, option passthrough, reasoning stream, config/docs, routing/fallback 후보로 분류되어 있다. +- [ ] [follow-up-scope] 코드 수정이 필요한 항목은 이 Milestone의 추가 Task 또는 별도 후속 Milestone 후보로 정리되어 있다. + +## 완료 리뷰 + +- 상태: 없음 +- 요청일: 없음 +- 완료 근거: 사용자 실테스트와 후속 작업 분류가 아직 충족되지 않았다. +- 리뷰 필요: + - [ ] 사용자가 완료 결과를 확인했다 + - [ ] archive 이동을 승인했다 +- 리뷰 코멘트: 없음 + +## 범위 제외 + +- archive된 `Ollama E2E 서빙 안정화` 문서 재포맷 +- cloud fallback, 자동 부하 라우팅, 품질 평가 feedback의 본격 구현 +- RAG, web search, MCP/tool policy, output validation/fallback 최적화 구현 +- Responses API 세부 호환 구현 + +## 작업 컨텍스트 + +- 관련 경로: `apps/edge`, `apps/node`, `packages/config`, `proto/iop`, `configs`, `bin/edge.sh`, `bin/node.sh`, `docs/deploy-dev.md` +- 표준선(선택): 내부 실행 계약은 `adapter + target`을 유지하고, OpenAI-compatible API는 외부 호환 입력 표면으로 둔다. +- 표준선(선택): Ollama 실테스트 후속 작업은 먼저 재현 로그와 사용자 기대 동작을 기준으로 분류한 뒤 구현 계획으로 내린다. +- 선행 작업: Ollama E2E 서빙 안정화 +- 후속 작업: 지식, 도구 정책, 검증 최적화 +- 확인 필요: 사용자 실테스트 결과, 후속 작업의 처리 위치, cloud fallback/Responses API/품질 평가로 넘길 항목