From 4b159c8f46d823186290df902bdc49a23006a45c Mon Sep 17 00:00:00 2001 From: toki Date: Tue, 9 Jun 2026 03:40:48 +0900 Subject: [PATCH] =?UTF-8?q?docs(roadmap):=20=EB=B8=8C=EB=A6=AC=EC=A7=80=20?= =?UTF-8?q?=EC=84=A0=ED=96=89=20=EA=B2=BD=EA=B3=84=20=EC=83=81=ED=83=9C?= =?UTF-8?q?=EB=A5=BC=20=EA=B2=80=ED=86=A0=EC=A4=91=EC=9C=BC=EB=A1=9C=20?= =?UTF-8?q?=EB=B0=98=EC=98=81=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 워크스페이스 포트/환경 표준화 마일스톤이 완료되었으므로 브릿지 경계 하드닝의 상위 상태를 리뷰 단계로 전환하고, 완료 리뷰 근거를 증빙 로그 기반으로 정리해 다음 승인 흐름으로 넘기기 위해서이다. --- .../phase/automation-runtime-bridge/PHASE.md | 4 ++-- .../milestones/bridge-boundary-hardening.md | 23 +++++++++++-------- .../workspace-port-env-standardization.md | 10 ++++---- 3 files changed, 20 insertions(+), 17 deletions(-) diff --git a/agent-roadmap/phase/automation-runtime-bridge/PHASE.md b/agent-roadmap/phase/automation-runtime-bridge/PHASE.md index 854e931..fdfebfd 100644 --- a/agent-roadmap/phase/automation-runtime-bridge/PHASE.md +++ b/agent-roadmap/phase/automation-runtime-bridge/PHASE.md @@ -58,11 +58,11 @@ CLI 실행, specialized agent 등록, bootstrap/enrollment, 원격 터미널 브 - 경로: `agent-roadmap/archive/phase/automation-runtime-bridge/milestones/domain-agent-message-boundary.md` - 요약: 독립형 실행 전환으로 Edge 직접 domain payload boundary 정리가 현재 범위에서 필요 없어져 폐기한다. -- [검토중] 워크스페이스 포트/환경 표준화 +- [완료] 워크스페이스 포트/환경 표준화 - 경로: `agent-roadmap/phase/automation-runtime-bridge/milestones/workspace-port-env-standardization.md` - 요약: Control Plane, Edge, Node, Client, OpenAI-compatible, A2A, wire, metrics, DB/cache 포트를 workspace 공통 대역으로 정렬한다. -- [진행중] 브리지 선행 경계 안정화 +- [검토중] 브리지 선행 경계 안정화 - 경로: `agent-roadmap/phase/automation-runtime-bridge/milestones/bridge-boundary-hardening.md` - 요약: 원격 터미널 브리지 POC 전에 남은 호환성/소유권 리스크를 Client HTTP lifecycle, Edge run surface, Node terminal core, typed adapter config 계약으로 고정한다. diff --git a/agent-roadmap/phase/automation-runtime-bridge/milestones/bridge-boundary-hardening.md b/agent-roadmap/phase/automation-runtime-bridge/milestones/bridge-boundary-hardening.md index e41a24f..2df4e96 100644 --- a/agent-roadmap/phase/automation-runtime-bridge/milestones/bridge-boundary-hardening.md +++ b/agent-roadmap/phase/automation-runtime-bridge/milestones/bridge-boundary-hardening.md @@ -1,4 +1,4 @@ -# Milestone: 브리지 선행 경계 안정화 + # Milestone: 브리지 선행 경계 안정화 ## 위치 @@ -12,7 +12,7 @@ ## 상태 -[진행중] +[검토중] ## 구현 잠금 @@ -33,19 +33,22 @@ 원격 터미널 브리지 구현이 기존 호환 표면을 확장 경로로 착각하지 않도록 선행 계약을 고정한다. - [x] [client-http-lifecycle] `HttpControlPlaneStatusRepository`가 기본 `http.Client`를 요청마다 새로 만들지 않고 소유/해제 경계를 명확히 하며, 주입된 client는 caller-owned로 유지한다. 검증: `cd apps/client && flutter test test/control_plane_status_controller_test.dart test/widget_test.dart` -- [ ] [edge-run-surface] Edge 신규 native/terminal 표면은 legacy combined `RunHandle` 대신 `RunDispatch`와 `RunStream` 또는 동등한 surface-neutral 계약을 소비하도록 service interface와 테스트를 정리한다. 검증: `go test -count=1 ./apps/edge/internal/service ./apps/edge/internal/openai ./apps/edge/internal/input/a2a` -- [ ] [terminal-core-boundary] persistent PTY 기반 `terminalSessionCore`를 CLI provider 내부 세부가 아니라 remote terminal transport가 재사용할 수 있는 Node terminal boundary로 분리하거나 명시 interface로 고정한다. 검증: `go test -count=1 ./apps/node/internal/adapters/cli ./apps/node/internal/...` -- [ ] [adapter-config-typed] `AdapterConfig.settings`는 구버전 Edge payload fallback으로만 허용하고, Edge mapper와 신규 config는 typed oneof/proto 메시지를 사용한다는 guard를 테스트로 고정한다. 검증: `make proto && go test -count=1 ./apps/edge/internal/node ./apps/edge/internal/transport ./apps/node/internal/adapters ./proto/gen/...` +- [x] [edge-run-surface] Edge 신규 native/terminal 표면은 legacy combined `RunHandle` 대신 `RunDispatch`와 `RunStream` 또는 동등한 surface-neutral 계약을 소비하도록 service interface와 테스트를 정리한다. 검증: `go test -count=1 ./apps/edge/internal/service ./apps/edge/internal/openai ./apps/edge/internal/input/a2a` +- [x] [terminal-core-boundary] persistent PTY 기반 `terminalSessionCore`를 CLI provider 내부 세부가 아니라 remote terminal transport가 재사용할 수 있는 Node terminal boundary로 분리하거나 명시 interface로 고정한다. 검증: `go test -count=1 ./apps/node/internal/adapters/cli ./apps/node/internal/...` +- [x] [adapter-config-typed] `AdapterConfig.settings`는 구버전 Edge payload fallback으로만 허용하고, Edge mapper와 신규 config는 typed oneof/proto 메시지를 사용한다는 guard를 테스트로 고정한다. 검증: `make proto && go test -count=1 ./apps/edge/internal/node ./apps/edge/internal/transport ./apps/node/internal/adapters ./proto/gen/...` ## 완료 리뷰 -- 상태: 없음 -- 요청일: 없음 -- 완료 근거: 모든 기능 Task와 Task 안에 명시된 검증이 아직 충족되지 않았다. +- 상태: 요청됨 +- 요청일: 2026-06-08 +- 완료 근거: + - `[client-http-lifecycle]`은 기존 완료 근거로 `cd apps/client && flutter test test/control_plane_status_controller_test.dart test/widget_test.dart` 통과가 기록되어 있다. + - `[edge-run-surface]`, `[terminal-core-boundary]`, `[adapter-config-typed]`는 각각 `agent-task/archive/2026/06/m-bridge-boundary-hardening/01_edge_run_surface/complete.log`, `02_terminal_core_boundary/complete.log`, `03_adapter_config_typed/complete.log`의 `Roadmap Completion`에서 PASS로 선언됐다. + - 각 Task에 명시된 검증 명령은 해당 `complete.log`의 최종 검증 또는 재실행 증거로 기록되어 있다. - 리뷰 필요: - [ ] 사용자가 완료 결과를 확인했다 - [ ] archive 이동을 승인했다 -- 리뷰 코멘트: 없음 +- 리뷰 코멘트: 모든 기능 Task와 Task 안에 명시된 검증이 충족된 것으로 보이므로 `[검토중]`으로 전환한다. 사용자 완료 확인과 archive 이동 승인을 받기 전까지 Milestone은 활성 경로에 유지한다. ## 범위 제외 @@ -62,4 +65,4 @@ - 선행 작업: 전역 설계 부채 리팩토링 기반 - 후속 작업: 원격 터미널 브리지 POC - 확인 필요: 없음 -- 완료 근거: `[client-http-lifecycle]`은 `cd apps/client && flutter test test/control_plane_status_controller_test.dart test/widget_test.dart` 통과. +- 완료 근거: 모든 기능 Task가 완료되어 완료 리뷰를 요청했다. diff --git a/agent-roadmap/phase/automation-runtime-bridge/milestones/workspace-port-env-standardization.md b/agent-roadmap/phase/automation-runtime-bridge/milestones/workspace-port-env-standardization.md index 3249112..60d510c 100644 --- a/agent-roadmap/phase/automation-runtime-bridge/milestones/workspace-port-env-standardization.md +++ b/agent-roadmap/phase/automation-runtime-bridge/milestones/workspace-port-env-standardization.md @@ -11,7 +11,7 @@ IOP의 Control Plane, Edge, Node, Client, OpenAI-compatible/A2A surface, native ## 상태 -[검토중] +[완료] ## 구현 잠금 @@ -96,16 +96,16 @@ Inventory에서 확인된 drift를 실제 기본값, 문서, smoke evidence로 ## 완료 리뷰 -- 상태: 요청됨 +- 상태: 승인됨 - 요청일: 2026-06-08 - 완료 근거: - Inventory 기능 task 4개는 이미 완료 상태이며, rollout 기능 task `port-default-rollout`은 `03+01,02_remote_smoke_evidence/complete.log`의 `Roadmap Completion`에서 PASS로 선언됐다. - `01`/`02`에서 compose/env/runtime/config/docs/test-rule defaults를 표준 후보에 맞춰 정렬했고, `go test`, `flutter test`, `make client-build-web` 검증 증거가 archive에 있다. - `04`에서 사용자 금지 조건을 지켜 `code-server` stop/start/restart/recreate 없이 remote compose config만 수정했고, `19090`, `19092`, `19190` publish 제거와 `192.168.0.97` 기준 closed 확인을 기록했다. - 리뷰 필요: - - [ ] 사용자가 완료 결과를 확인했다 - - [ ] archive 이동을 승인했다 -- 리뷰 코멘트: 기능 Task는 모두 충족되어 `[검토중]`으로 전환한다. 사용자 완료 확인과 archive 이동 승인을 받기 전까지 Milestone은 활성 경로에 유지한다. +- [x] 사용자가 완료 결과를 확인했다 +- [ ] archive 이동을 승인했다 +- 리뷰 코멘트: 사용자가 "완료 처리해" 요청으로 완료 승인 및 완료 결과 확인을 받음. 기능 Task는 모두 충족되어 `[완료]` 처리로 전환한다. archive 이동은 다음 단계에서 처리한다. ## 범위 제외