nexo/agent-roadmap/phase/messaging-runtime/milestones/macos-notification-preflight.md
toki 9f5e8c2343 feat: add notification preflight milestones for all platforms and update runtime validation docs
- Add iOS notification preflight milestone
- Add macOS notification preflight milestone
- Add Linux notification preflight milestone
- Add Windows notification preflight milestone
- Update notification test milestones for all platforms
- Update phase documentation and current roadmap
- Update runtime image validation docs
- Update compose README
2026-06-01 13:08:25 +09:00

3 KiB

Milestone: macOS 알림 선행 정리

위치

  • Roadmap: agent-roadmap/ROADMAP.md
  • Phase: agent-roadmap/phase/messaging-runtime/PHASE.md

목표

Apple signing, macOS 테스트 장비, 실제 OS notification UI 검증 전에 macOS 알림 구현과 테스트를 막는 선행 계약을 정리한다. macOS native bridge 최소 범위, host placeholder, payload fixture, evidence 템플릿을 먼저 고정해 후속 macOS 알림 테스트가 장비와 OS UI smoke에 집중하게 만든다.

상태

[계획]

승격 조건

  • 없음

구현 잠금

  • 상태: 해제
  • 결정 필요:
    • 없음

범위

  • Dart가 기대하는 macOS EventChannel/MethodChannel 최소 bridge 계약
  • apps/flutter-test/macos host placeholder와 entitlement/signing 기준
  • macOS notification userInfo와 NotificationOpenedEvent 매핑 기준
  • local notification payload fixture와 click/open routing injection 기준
  • 실제 macOS OS UI smoke 전후로 재사용할 evidence 템플릿

기능

Epic: [preflight] macOS 선행 정리

Apple signing, 장비, OS UI 수동 검증 전에 먼저 확정할 수 있는 계약과 검증 표면을 분리한다.

  • [bridge-scope] Dart가 기대하는 EventChannel/MethodChannel 이름, macOS 최소 구현 method, no-op/fallback 경계를 정리한다.
  • [host-placeholder] entitlement, signing/notarization placeholder, ignored credential 위치, macOS target resource 기준을 정리한다.
  • [payload-map] macOS notification userInfo를 NotificationOpenedEvent와 channel/thread callback에 매핑하는 기준을 정리한다.
  • [fixtures] local notification payload fixture와 click/open routing injection 시나리오를 작성한다.
  • [evidence-template] permission, display, click/open routing, lifecycle, ACK/dismiss gap evidence 템플릿을 작성한다.

완료 리뷰

  • 상태: 없음
  • 요청일: 없음
  • 완료 근거: 없음
  • 리뷰 필요:
    • 사용자가 완료 결과를 확인했다
    • archive 이동을 승인했다
  • 리뷰 코멘트: 없음

범위 제외

  • 실제 Apple Team, signing certificate, provisioning, notarization 책임 결정은 이 Milestone에서 하지 않는다.
  • 실제 macOS OS notification UI smoke는 macOS 알림 테스트에서 다룬다.
  • macOS native bridge 전체 구현은 선행 계약 정리 이후 별도 구현 계획으로 분리할 수 있다.
  • iOS/APNs, Windows, Linux 검증은 각 OS별 Milestone에서 다룬다.

작업 컨텍스트

  • 관련 경로: packages/messaging_flutter/macos/, packages/messaging_flutter/lib/, apps/flutter-test/macos/, packages/messaging_flutter/README.md
  • 표준선(선택): 민감값과 실제 장비 없이 placeholder, fixture, event 계약, evidence 양식을 먼저 고정한다
  • 민감값 기준: Apple credential, Team ID, profile, private host 값은 tracked 문서에 쓰지 않는다
  • 선행 작업: 알림 파이프라인 고도화
  • 후속 작업: macOS 알림 테스트
  • 확인 필요: 없음