docs(roadmap): 브리지 선행 경계 상태를 검토중으로 반영한다

워크스페이스 포트/환경 표준화 마일스톤이 완료되었으므로 브릿지 경계 하드닝의 상위 상태를 리뷰 단계로 전환하고, 완료 리뷰 근거를 증빙 로그 기반으로 정리해 다음 승인 흐름으로 넘기기 위해서이다.
This commit is contained in:
toki 2026-06-09 03:40:48 +09:00
parent 3f1a7c0701
commit 4b159c8f46
3 changed files with 20 additions and 17 deletions

View file

@ -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 계약으로 고정한다.

View file

@ -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가 완료되어 완료 리뷰를 요청했다.

View file

@ -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 이동은 다음 단계에서 처리한다.
## 범위 제외