nexo/docs/macos-notification-test-guide.md

macOS 알림 접근 준비 가이드

마지막 확인일: 2026-06-02

에이전트가 macOS 알림 구현과 smoke 검증을 마무리하려면 macOS runner와 signing 접근 방식이 필요하다. 이 문서는 사용자가 무엇을 준비해야 하는지 정리한 가이드이며, 사용자가 직접 이 문서만 보고 테스트를 실행할 필요는 없다.

준비할 항목

항목	준비 내용
macOS runner	로컬 Mac, 원격 Mac 중 하나를 정하거나 visible smoke 보류 여부를 정한다.
조작 책임	runner가 원격이면 UI prompt를 누가 처리할지 정한다.
Signing mode	local ad hoc, Apple Developer signing, distribution/notarization path 중 하나를 선택한다.
Bundle ID	ad hoc을 넘는 signing이 필요하면 Bundle ID를 준비한다.
Apple 접근	notification entitlement 또는 APNs가 범위에 있으면 Team/provisioning 접근 방식을 정한다.
Push 범위	local notification만 검증할지, APNs/Firebase 기반 smoke까지 할지, push를 보류할지 정한다.
증거 위치	민감값을 제거한 로그, 스크린샷, 실행 메모를 어디에 남길지 정한다.

tracked 파일에 넣지 말아야 할 값

• Team ID, signing identity, provisioning profile, notarization profile, Apple ID
• APNs/Firebase secret, device token, private endpoint, auth token, channel name, user name, server URL

준비 후 에이전트가 할 수 있는 일

• 선택된 signing mode에 맞게 macOS host app을 설정한다.
• native notification/action bridge를 구현하거나 검증한다.
• local routing check를 실행하고, 허용된 경우 visible notification smoke를 수행한다.
• 민감값을 제거한 증거를 task 기록 또는 비공개 실행 메모에 남긴다.

현재 저장소 상태

macOS plugin은 아직 scaffold 상태다. 현재는 legacy nexo_messaging channel만 있으므로 visible notification smoke를 수행하려면 bridge 구현 작업도 필요하다.