From 65038e4bce668e39179b4e9ea5b2e3c7837a9d93 Mon Sep 17 00:00:00 2001
From: toki <r0bin5736@gmail.com>
Date: Sat, 30 May 2026 23:07:23 +0900
Subject: [PATCH] =?UTF-8?q?docs(agent-roadmap):=20=EB=A9=94=EC=8B=9C?=
 =?UTF-8?q?=EC=A7=95=20=EA=B3=84=EC=95=BD=20=ED=91=9C=EC=A4=80=ED=99=94=20?=
 =?UTF-8?q?=EB=A7=88=EC=9D=BC=EC=8A=A4=ED=86=A4=EC=9D=84=20=EC=99=84?=
 =?UTF-8?q?=EB=A3=8C=20=EC=B2=98=EB=A6=AC=ED=95=98=EA=B3=A0=20=EC=95=8C?=
 =?UTF-8?q?=EB=A6=BC=20=ED=8C=8C=EC=9D=B4=ED=94=84=EB=9D=BC=EC=9D=B8?=
 =?UTF-8?q?=EC=9D=84=20=EB=8B=A4=EC=9D=8C=20=EB=AA=A9=ED=91=9C=EB=A1=9C=20?=
 =?UTF-8?q?=EC=A0=84=ED=99=98=ED=95=9C=EB=8B=A4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../milestones/messaging-contract.md          | 20 ++++++++++---------
 agent-roadmap/current.md                      |  4 ++--
 .../phase/messaging-runtime/PHASE.md          |  6 +++---
 3 files changed, 16 insertions(+), 14 deletions(-)
 rename agent-roadmap/{ => archive}/phase/messaging-runtime/milestones/messaging-contract.md (84%)

diff --git a/agent-roadmap/phase/messaging-runtime/milestones/messaging-contract.md b/agent-roadmap/archive/phase/messaging-runtime/milestones/messaging-contract.md
similarity index 84%
rename from agent-roadmap/phase/messaging-runtime/milestones/messaging-contract.md
rename to agent-roadmap/archive/phase/messaging-runtime/milestones/messaging-contract.md
index 88371d25..552f7087 100644
--- a/agent-roadmap/phase/messaging-runtime/milestones/messaging-contract.md
+++ b/agent-roadmap/archive/phase/messaging-runtime/milestones/messaging-contract.md
@@ -12,7 +12,7 @@ upstream-followable server/push runtime과 nexo-owned Flutter SDK가 주고받
 
 ## 상태
 
-[검토중]
+[완료]
 
 ## 승격 조건
 
@@ -20,11 +20,12 @@ upstream-followable server/push runtime과 nexo-owned Flutter SDK가 주고받
 
 ## 구현 잠금
 
-- 상태: 잠금
+- 상태: 해제
 - 결정 필요:
-  - [ ] 메시징 전체 기능 중 Flutter 앱에 우선 노출할 범위를 결정한다.
+  - 없음
 - 결정 완료:
   - [x] 2026-05-27: Flutter public API는 nexo-owned SDK wrapper로 유지하고, server/push runtime compatibility와 분리한다.
+  - [x] 2026-05-30: 이번 단계의 Flutter 앱 공식 노출 범위는 메시징 UI 전체가 아니라 알림 수신, 열기 라우팅, device token, auth, signing key, ACK 호환 계약까지로 충분하다고 결정했다.
 
 ## 범위
 
@@ -56,17 +57,18 @@ upstream-followable server/push runtime과 nexo-owned Flutter SDK가 주고받
 
 ## 완료 리뷰
 
-- 상태: 요청됨
+- 상태: 승인됨
 - 요청일: 2026-05-30
+- 승인일: 2026-05-30
 - 완료 근거:
   - `packages/messaging_flutter/README.md`에 plugin-side public API, event shape, token/credential flow, push payload, ACK, routing, reference front compatibility 기준을 정리했다.
   - `services/core/compose/README.md`에 server-side source anchors, payload fields, ACK endpoint, webapp/reference front compatibility 기준을 연결했다.
   - 모든 기능 Task가 문서/테스트/source anchor 근거와 함께 완료 후보가 되었다.
 - 리뷰 필요:
-  - [ ] 사용자가 완료 결과를 확인했다
-  - [ ] Flutter 앱 우선 노출 범위가 현재 Public API Contract 기준으로 충분한지 확인했다
-  - [ ] archive 이동을 승인했다
-- 리뷰 코멘트: 모든 기능 Task는 완료 후보이며, 남은 판단은 사용자 최종 확인과 archive 승인이다.
+  - [x] 사용자가 완료 결과를 확인했다
+  - [x] Flutter 앱 우선 노출 범위가 현재 Public API Contract 기준으로 충분한지 확인했다
+  - [x] archive 이동을 승인했다
+- 리뷰 코멘트: Flutter 앱은 Mattermost 앱 전체를 포함하지 않고 메시징/알림 기본 기능을 사용하기 위한 SDK 범위로 충분하다는 사용자 결정을 반영해 완료 및 archive를 승인했다.
 
 ## 범위 제외
 
@@ -84,4 +86,4 @@ upstream-followable server/push runtime과 nexo-owned Flutter SDK가 주고받
   - 2026-05-30 `packages/messaging_flutter/README.md`와 `services/core/compose/README.md`를 상호 연결해 push payload, ACK, reference front compatibility 계약 기준을 완료 후보로 정리했다.
 - 선행 작업: 정체성 기준선, 업스트림 팔로잉 기준선, 클라이언트 검증 기준선
 - 후속 작업: 알림 파이프라인 고도화, 멀티앱 채널 모델
-- 확인 필요: Flutter 앱 우선 노출 범위
+- 확인 완료: Flutter 앱 우선 노출 범위는 메시징/알림 기본 기능 사용에 필요한 계약까지로 한정한다.
diff --git a/agent-roadmap/current.md b/agent-roadmap/current.md
index 1399bce4..f25f86a3 100644
--- a/agent-roadmap/current.md
+++ b/agent-roadmap/current.md
@@ -7,9 +7,9 @@
 
 ## 활성 Milestone
 
-- [검토중] 메시징 계약 표준화
+- [계획] 알림 파이프라인 고도화
   - Phase: `agent-roadmap/phase/messaging-runtime/PHASE.md`
-  - 경로: `agent-roadmap/phase/messaging-runtime/milestones/messaging-contract.md`
+  - 경로: `agent-roadmap/phase/messaging-runtime/milestones/notification-pipeline.md`
 
 ## 선택 규칙
 
diff --git a/agent-roadmap/phase/messaging-runtime/PHASE.md b/agent-roadmap/phase/messaging-runtime/PHASE.md
index 61a3183c..f9f7773a 100644
--- a/agent-roadmap/phase/messaging-runtime/PHASE.md
+++ b/agent-roadmap/phase/messaging-runtime/PHASE.md
@@ -16,9 +16,9 @@ Mattermost server/webapp/push-proxy는 upstream-followable runtime으로 두고,
 완료, 검토중, 진행중, 계획, 스케치 순서로 두어 아래로 갈수록 미래 작업에 가까워지게 정렬한다.
 스케치 Milestone은 아직 구현 가능한 계획이 아니므로 계획 Milestone보다 아래에 둔다.
 
-- [검토중] 메시징 계약 표준화
-  - 경로: `agent-roadmap/phase/messaging-runtime/milestones/messaging-contract.md`
-  - 요약: 서버와 Flutter 플러그인이 공유할 메시징/알림 API, 이벤트, 저장 계약을 정리한다.
+- [완료] 메시징 계약 표준화
+  - 경로: `agent-roadmap/archive/phase/messaging-runtime/milestones/messaging-contract.md`
+  - 요약: 서버와 Flutter 플러그인이 공유할 메시징/알림 API, 이벤트, 저장 계약을 정리했다.
 - [계획] 알림 파이프라인 고도화
   - 경로: `agent-roadmap/phase/messaging-runtime/milestones/notification-pipeline.md`
   - 요약: FCM, ACK, inline reply, dismiss, open routing을 안정된 플러그인 책임으로 만든다.