From baa201a815e74378930819c37ff40372c4c6deec Mon Sep 17 00:00:00 2001 From: toki Date: Wed, 3 Jun 2026 20:07:21 +0900 Subject: [PATCH] update oto-agent-registration milestone --- .../milestones/oto-agent-registration.md | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/agent-roadmap/phase/edge-direct-oto-agent/milestones/oto-agent-registration.md b/agent-roadmap/phase/edge-direct-oto-agent/milestones/oto-agent-registration.md index a8fbb72..4ade1f3 100644 --- a/agent-roadmap/phase/edge-direct-oto-agent/milestones/oto-agent-registration.md +++ b/agent-roadmap/phase/edge-direct-oto-agent/milestones/oto-agent-registration.md @@ -17,7 +17,7 @@ - 상태: 잠금 - 결정 필요: - - [ ] iop에서 OTO에 대한 Edge 직접 통신 경로가 확보되었는지 확인한다. + - [ ] iop2oto에서 `OTO Agent Registry 구현` → `OTO Bootstrap Command 발급` → `OTO Registration Online Smoke` → `OTO Registration Unlock Handoff` 선행 체인이 충족되었는지 확인한다. ## 범위 @@ -42,7 +42,7 @@ bootstrap으로 설치된 Linux `oto-agent`가 설정 파일을 읽고 Edge에 - 상태: 없음 - 요청일: 없음 -- 완료 근거: `registration-state`와 online/실패/heartbeat 기준이 남아 있어 완료 후보가 아니다. +- 완료 근거: `registration-state`와 iop2oto online smoke 근거가 남아 있어 완료 후보가 아니다. - 리뷰 필요: - [ ] 사용자가 완료 결과를 확인했다 - [ ] archive 이동을 승인했다 @@ -69,12 +69,13 @@ bootstrap으로 설치된 Linux `oto-agent`가 설정 파일을 읽고 Edge에 - 구현 근거: `EdgeRegistrationClient`는 `proto_socket`으로 Edge endpoint에 연결해 enrollment token을 `RegisterRequest`로 전송하고 `RegisterResponse`를 accepted/rejected 결과로 변환한다. - 구현 근거: registration/config/CLI 검증은 `test/oto_agent_config_test.dart`, `test/oto_agent_registration_test.dart`, `test/oto_agent_cli_test.dart`, `test/oto_iop_connection_smoke_test.dart`에 있다. - MVP 재시작 기준: bootstrap으로 시작한 background 프로세스의 pid/log를 기준으로 사용자가 상태를 확인하고 `oto agent run --config `를 재실행한다. 자동 재시작과 systemd user service는 후속 강화로 둔다. -- 남은 작업: Edge 등록 완료 이후 최초 heartbeat 도착까지의 online 판정과 재시도 정책은 agent 메시지/heartbeat 흐름과 맞물려 별도 정리가 필요하다. +- 남은 작업: Edge 등록 완료 이후 최초 heartbeat 도착까지의 online 판정과 재시도 정책은 iop2oto의 `OTO Registration Unlock Handoff` 완료 근거와 맞춰 정리한다. - 선행 OTO Milestone: OTO-iop proto-socket 통신 기반 -- 선행 iop Milestone: agent bootstrap OTO enrollment -- 외부 의존 잠금: iop에서 OTO에 대한 Edge 직접 통신 경로가 확보되면 이 Milestone은 잠금 해제 후보가 된다. 런타임 판별은 프로젝트 상위 `.agent-roadmap-sync/locks.yaml`에서 관리한다. -- 책임 경계: iop는 Edge outbound enrollment를 받아들이는 registry/protocol/credential 기준을 정리한다. +- 선행 iop2oto Milestone: OTO Agent Registry 구현 → OTO Bootstrap Command 발급 → OTO Registration Online Smoke → OTO Registration Unlock Handoff +- iop2oto 진행 현황(2026-06-03): `OTO Agent Registry 구현`은 [진행중]이며, `OTO Bootstrap Command 발급`, `OTO Registration Online Smoke`, `OTO Registration Unlock Handoff`는 [계획]이다. +- 외부 의존 잠금: iop2oto에서 OTO agent registry, bootstrap command 발급, registration accepted 및 최초 heartbeat 기반 online smoke, OTO unlock handoff evidence가 충족되면 이 Milestone은 잠금 해제 후보가 된다. 런타임 판별은 프로젝트 상위 `.agent-roadmap-sync/locks.yaml`에서 관리한다. +- 책임 경계: iop2oto는 Edge outbound enrollment를 받아들이는 registry/protocol/credential 기준을 정리한다. - 책임 경계: OTO는 설치된 `oto-agent`가 해당 기준을 소비해 설정을 만들고 Edge에 직접 outbound 연결하는 상태 전이를 정리한다. - 네트워크, 설치, packaging 관련 코드나 문서가 추가될 경우 관련 도메인 rule을 먼저 확인한다. - 구현 계획: `agent-task/m-oto-agent-registration/` 하위 plan-code-review 루프로 진행한다. -- 확인 필요: Edge 등록 완료 이후 최초 heartbeat 도착까지의 online 판정과 재시도 정책을 agent 메시지/heartbeat 흐름과 맞춰 정리한다. +- 확인 필요: iop2oto `OTO Registration Unlock Handoff` 완료 evidence를 받아 Edge 등록 완료 이후 최초 heartbeat 도착까지의 online 판정과 재시도 정책을 OTO `registration-state`에 반영한다.