From 18853a5d316d2589f0fe715ff7a674e4ba2e6e50 Mon Sep 17 00:00:00 2001 From: toki Date: Mon, 1 Jun 2026 09:53:50 +0900 Subject: [PATCH] update workflow-core roadmap: archive old milestone, update phase docs --- ...ocket-infrastructure-communication-rail.md | 20 +++++++++---------- agent-roadmap/current.md | 5 +---- agent-roadmap/phase/workflow-core/PHASE.md | 10 +++++----- .../workflow-core/milestones/workflow-core.md | 4 ++-- 4 files changed, 18 insertions(+), 21 deletions(-) rename agent-roadmap/{ => archive}/phase/workflow-core/milestones/proto-socket-infrastructure-communication-rail.md (90%) diff --git a/agent-roadmap/phase/workflow-core/milestones/proto-socket-infrastructure-communication-rail.md b/agent-roadmap/archive/phase/workflow-core/milestones/proto-socket-infrastructure-communication-rail.md similarity index 90% rename from agent-roadmap/phase/workflow-core/milestones/proto-socket-infrastructure-communication-rail.md rename to agent-roadmap/archive/phase/workflow-core/milestones/proto-socket-infrastructure-communication-rail.md index c2d0bbb..029313c 100644 --- a/agent-roadmap/phase/workflow-core/milestones/proto-socket-infrastructure-communication-rail.md +++ b/agent-roadmap/archive/phase/workflow-core/milestones/proto-socket-infrastructure-communication-rail.md @@ -11,7 +11,7 @@ NomadCode 내부 런타임 간 신규 통신을 `proto-socket` 중심으로 통 ## 상태 -[진행중] +[완료] ## 승격 조건 @@ -61,18 +61,18 @@ Flutter client가 no-op proto-socket facade를 실제 Core 연결 레일로 전 내부 통신 레일을 운영 가능하게 만들고 예외 프로토콜이 다시 기본값으로 새지 않게 한다. -- [ ] [diagnostics] connection id, protocol version, channel name, error code를 로그와 디버그 표면에서 확인할 수 있게 한다. 검증: client diagnostics 구현은 반영되었고, 허용된 검증 환경에서 Flutter test/analyze와 code-review PASS가 필요하다. +- [x] [diagnostics] connection id, protocol version, channel name, error code를 로그와 디버그 표면에서 확인할 수 있게 한다. 검증: client diagnostics 구현은 반영되었고, 허용된 검증 환경에서 Flutter test/analyze와 code-review PASS가 필요하다. - [x] [rollout-docs] 새 내부 통신을 추가할 때 proto-socket 우선 여부와 REST/HTTP 예외 사유를 확인하는 운영 체크를 문서화한다. ## 완료 리뷰 -- 상태: 없음 -- 요청일: 없음 -- 완료 근거: 없음 +- 상태: 승인됨 +- 요청일: 2026-06-01 +- 완료 근거: `agent-task/archive/2026/05/m-proto-socket-infrastructure-communication-rail/13+11,12_client_diagnostics/complete.log`의 `Roadmap Completion`에서 `diagnostics` PASS, remote `flutter test`, `flutter analyze --no-fatal-infos`, code-review PASS를 확인했다. - 리뷰 필요: - - [ ] 사용자가 완료 결과를 확인했다 - - [ ] archive 이동을 승인했다 -- 리뷰 코멘트: 없음 + - [x] 사용자가 완료 결과를 확인했다 + - [x] archive 이동을 승인했다 +- 리뷰 코멘트: 사용자 승인에 따라 `[완료]`로 전환하고 archive로 이동한다. ## 범위 제외 @@ -88,11 +88,11 @@ Flutter client가 no-op proto-socket facade를 실제 Core 연결 레일로 전 - 표준선(선택): 내부 런타임 간 신규 통신은 `proto-socket`을 기본 표준으로 삼고, REST/HTTP는 명시된 예외 조건에서만 유지한다. - 선행 작업: Mattermost Nexo Messaging Alignment, Client Integration Standardization, 프로젝트 룰의 proto-socket 표준 규약 - 후속 작업: Workflow Core, External Integration, Project Workspace Management UX -- 현재 지점: Core proto-socket endpoint, task channel, Flutter concrete connector, client task service boundary, workspace/task 화면 소비 경계, client diagnostics snapshot/debug surface 구현은 반영되었고, 다음 작업은 허용된 검증 환경에서 Flutter test/analyze 실행과 code-review PASS로 diagnostics 항목을 닫는 것이다. +- 현재 지점: Core proto-socket endpoint, task channel, Flutter concrete connector, client task service boundary, workspace/task 화면 소비 경계, client diagnostics snapshot/debug surface 구현과 허용된 검증 환경의 Flutter test/analyze, code-review PASS가 반영되었다. 사용자 최종 완료 확인과 archive 승인이 끝났다. - 반영 근거: `packages/contracts/notes/flutter-core-api-candidates.md`에 내부 통신 원칙, proto-socket semantic envelope 후보, REST compatibility map 후보를 추가했다. - Core 반영 근거: `services/core/internal/protosocket/`, `services/core/internal/http/router.go`, `services/core/cmd/server/main.go`에 proto-socket server, task channel, task status event broadcaster, authenticated route 연결과 contract tests가 추가되었다. - Client connector 반영 근거: `apps/client/lib/src/integrations/proto_socket/proto_socket_client.dart`, `apps/client/lib/src/app/bootstrap.dart`, `apps/client/lib/src/app/nomadcode_client_app.dart`에 `RealProtoSocketConnector`, endpoint-config 기반 connect, task service wiring이 추가되었다. - Client task/test 반영 근거: `apps/client/lib/src/integrations/proto_socket/proto_socket_task_service.dart`, `apps/client/lib/src/features/workspaces/presentation/workspace_home_page.dart`, `apps/client/test/integrations/proto_socket_*_test.dart`, `apps/client/test/widget_test.dart`에 task channel 소비 경계와 endpoint/lifecycle/task service/widget 검증이 추가되었다. - Client diagnostics 반영 근거: `apps/client/lib/src/integrations/proto_socket/proto_socket_lifecycle.dart`에 `ProtoSocketDiagnostics` snapshot/stream과 response/event diagnostics recording을 추가했고, `apps/client/lib/src/app/nomadcode_client_app.dart`, `apps/client/lib/src/features/workspaces/presentation/workspace_home_page.dart`, `apps/client/test/integrations/proto_socket_lifecycle_test.dart`, `apps/client/test/widget_test.dart`에 payload/auth/raw error message 없이 connection id, protocol version, channel/action, error code, timestamp를 확인하는 debug surface와 테스트를 추가했다. - 운영 체크 근거: `packages/contracts/notes/flutter-core-api-candidates.md`에 새 내부 통신 추가 시 proto-socket 우선 여부, REST/HTTP 예외 기록, channel/action 문서화, 검증 항목을 확인하는 운영 체크를 추가했다. -- 확인 필요: 허용된 원격/검증 환경에서 `cd apps/client && flutter test`, `cd apps/client && flutter analyze --no-fatal-infos`를 실행하고, `agent-task/m-proto-socket-infrastructure-communication-rail/13+11,12_client_diagnostics/` code-review PASS 후 `[diagnostics]` 완료 처리 여부를 반영한다. +- 확인 필요: 없음. diff --git a/agent-roadmap/current.md b/agent-roadmap/current.md index 10597e0..e2165c4 100644 --- a/agent-roadmap/current.md +++ b/agent-roadmap/current.md @@ -11,10 +11,7 @@ ## 활성 Milestone -- [진행중] Proto-Socket Infrastructure Communication Rail - - Phase: `agent-roadmap/phase/workflow-core/PHASE.md` - - 경로: `agent-roadmap/phase/workflow-core/milestones/proto-socket-infrastructure-communication-rail.md` -- [계획] Workflow Core +- [진행중] Workflow Core - Phase: `agent-roadmap/phase/workflow-core/PHASE.md` - 경로: `agent-roadmap/phase/workflow-core/milestones/workflow-core.md` - [계획] External Integration diff --git a/agent-roadmap/phase/workflow-core/PHASE.md b/agent-roadmap/phase/workflow-core/PHASE.md index c19e503..e26b848 100644 --- a/agent-roadmap/phase/workflow-core/PHASE.md +++ b/agent-roadmap/phase/workflow-core/PHASE.md @@ -11,13 +11,13 @@ Plane 통신 토대와 provider-neutral pipeline 설계 이후, 내부 런타임 ## Milestone 흐름 완료된 Milestone은 archive 경로를 가리키고, 검토중, 진행중, 계획, 스케치 또는 보류 Milestone은 이 Phase 하위 `milestones/` 경로를 가리킨다. -완료, 검토중, 진행중, 계획, 스케치 순서를 기본으로 하되, 이번 Phase에서는 `Proto-Socket Infrastructure Communication Rail`이 `Workflow Core` 구현의 선행 조건이므로 먼저 둔다. +완료, 검토중, 진행중, 계획, 스케치 순서를 기본으로 한다. -- [진행중] Proto-Socket Infrastructure Communication Rail - - 경로: `agent-roadmap/phase/workflow-core/milestones/proto-socket-infrastructure-communication-rail.md` - - 요약: 내부 런타임 간 신규 통신을 proto-socket 기본 레일로 통일하고, client-core task 요청과 상태 이벤트가 오갈 수 있는 기반을 만든다. +- [완료] Proto-Socket Infrastructure Communication Rail + - 경로: `agent-roadmap/archive/phase/workflow-core/milestones/proto-socket-infrastructure-communication-rail.md` + - 요약: 내부 런타임 간 신규 통신을 proto-socket 기본 레일로 통일하고, client-core task 요청과 상태 이벤트 기반을 닫았다. -- [계획] Workflow Core +- [진행중] Workflow Core - 경로: `agent-roadmap/phase/workflow-core/milestones/workflow-core.md` - 요약: proto-socket client-core 통신 기준을 반영해 task lifecycle, 상태 전이 책임, 실패 정책, retry/timeout, notification event 모델을 안정화한다. diff --git a/agent-roadmap/phase/workflow-core/milestones/workflow-core.md b/agent-roadmap/phase/workflow-core/milestones/workflow-core.md index 566d110..eb373ee 100644 --- a/agent-roadmap/phase/workflow-core/milestones/workflow-core.md +++ b/agent-roadmap/phase/workflow-core/milestones/workflow-core.md @@ -11,7 +11,7 @@ Plane 통신 토대와 별도 pipeline 설계가 정리된 뒤 실제 상태 변 ## 상태 -[계획] +[진행중] ## 구현 잠금 @@ -63,7 +63,7 @@ Core task lifecycle과 상태 전이 책임, 실패/재시도/timeout/notificati - 선행 작업: Plane Communication Foundation, Work Item Provider Pipeline Design, Proto-Socket Infrastructure Communication Rail - 선행 조건: Proto-Socket Infrastructure Communication Rail이 client-core task 요청과 상태 이벤트가 오갈 수 있는 내부 통신 기준선을 제공한다. - 후속 작업: External Integration -- 현재 지점: Flutter-first Client Consolidation, Client Integration Standardization, Work Item Provider Pipeline Design이 완료되었고, workflow 상태 전이는 proto-socket client-core 통신 기준선을 반영해 진행한다. +- 현재 지점: Proto-Socket Infrastructure Communication Rail이 완료되어 client-core task 요청과 상태 이벤트가 오갈 수 있는 내부 통신 기준선이 마련되었다. 이제 workflow 상태 전이를 proto-socket client-core 통신 기준선을 반영해 진행한다. - 책임 경계: - NomadCode Workflow Core는 task lifecycle 전이, retry/timeout envelope, heartbeat, terminal 상태 기록을 소유한다. - Roadmap Operations Control Plane과 MCP 외부 agent 제어 표면은 `Agent-Ops MCP Control Plane` Phase에서 후속으로 다룬다.