docs(plan): record imessage bluebubbles gap completion

docs/plans/2026-02-06-openclaw-feature-gap-analysis.md

@@ -21,7 +21,7 @@
 | Discord | discord.js | discord.js (guild/channel allowlists, mention gating) | **MATCH** |
 | Slack | Bolt SDK | Bolt SDK Socket Mode (channel allowlists, mention gating) | **MATCH** |
 | Signal | signal-cli | Signal adapter | **MATCH** |
-| iMessage / BlueBubbles | imsg + BlueBubbles | -- | **MISSING** |
+| iMessage / BlueBubbles | imsg + BlueBubbles | BlueBubbles adapter | **MATCH** |
 | Google Chat | Chat API | Google Chat adapter | **MATCH** |
 | Microsoft Teams | Bot Framework | Teams adapter | **MATCH** |
 | Matrix | Extension | -- | **MISSING** |
@@ -291,15 +291,13 @@ All five Tier 3 items implemented: Lane Queue (per-session FIFO in gateway), cre
 - DM pairing codes (PairingManager with TTL codes, all 4 channel adapters, gateway handlers, TUI /pair command)
 
 **Remaining channels (if desired):**
-6. iMessage / BlueBubbles
+6. Zalo / Zalo Personal
-7. Zalo / Zalo Personal
+7. LINE / Feishu / Mattermost
-8. LINE / Feishu / Mattermost
 
 ### Tier 5 — Deferred / Niche
 
 - Companion apps (macOS/iOS/Android) — massive scope
 - LINE, Feishu, Mattermost — niche audience
-- iMessage/BlueBubbles — Apple ecosystem only
 - Canvas/A2UI — experimental visual workspace
 - Voice Wake / Talk Mode — ElevenLabs TTS integration
 - Nix/Fly.io/Railway deployment — platform-specific

docs/plans/2026-02-15-openclaw-gap-roadmap.md

@@ -21,7 +21,6 @@ A gap item is considered implemented when:
 
 ### Channels / Frontends (MISSING)
 
-- iMessage/BlueBubbles
 - Zalo
 - LINE/Feishu/Mattermost
 
@@ -329,7 +328,6 @@ These are substantial UX/ecosystem projects or highly platform-specific; defer u
 - Bonjour/mDNS discovery
 - QMD backend
 - ClawHub registry
-- iMessage/BlueBubbles (Apple ecosystem)
 
 ## Suggested Next Execution Order
 

docs/plans/2026-02-16-imessage-bluebubbles-channel-adapter-checklist.md

@@ -0,0 +1,46 @@
+# iMessage / BlueBubbles Channel Adapter Checklist
+
+Date: 2026-02-16
+Status: completed
+
+## Scope
+
+- Add a first-class iMessage channel path via BlueBubbles.
+- Support inbound webhook events and outbound text replies through the BlueBubbles API.
+
+## Completed
+
+- Added `BlueBubblesAdapter` in `src/channels/bluebubbles/adapter.ts`:
+  - inbound webhook handling for `POST /bluebubbles/events`
+  - optional webhook token validation (`bluebubbles.webhook_token`)
+  - allowlist support for chat GUIDs (`allowed_chat_guids`)
+  - mention-aware group gating (`require_mention`, `mention_name`)
+  - outbound text send via BlueBubbles REST endpoint
+  - reply routing via `metadata.replyPeerId`
+- Registered channel exports:
+  - `src/channels/bluebubbles/index.ts`
+  - `src/channels/index.ts`
+- Added config schema support in `src/config/schema.ts`:
+  - `bluebubbles.endpoint`
+  - `bluebubbles.api_key`
+  - `bluebubbles.webhook_token`
+  - `bluebubbles.allowed_chat_guids`
+  - `bluebubbles.require_mention`
+  - `bluebubbles.mention_name`
+- Wired daemon + gateway integration:
+  - registration in `src/daemon/channels.ts`
+  - gateway route wiring in `src/gateway/server.ts` (`POST /bluebubbles/events`)
+- Updated service discovery + docs:
+  - `src/gateway/handlers/services.ts`
+  - `README.md`
+  - `config/default.yaml`
+  - `docs/api/PROTOCOL.md`
+- Added tests:
+  - `src/channels/bluebubbles/adapter.test.ts`
+  - `src/config/schema.test.ts` (bluebubbles schema coverage)
+  - `src/gateway/handlers/services.test.ts` (bluebubbles service status)
+
+## Verification
+
+- `pnpm test:run src/channels/bluebubbles/adapter.test.ts src/config/schema.test.ts src/gateway/handlers/services.test.ts`
+- `pnpm typecheck`

docs/plans/state.json

@@ -555,6 +555,32 @@
       ],
       "test_status": "pnpm test:run src/channels/googleChat/adapter.test.ts src/config/schema.test.ts src/gateway/handlers/services.test.ts src/cli/shared.test.ts + pnpm typecheck passing"
     },
+    "imessage-bluebubbles-channel-adapter": {
+      "file": "2026-02-16-imessage-bluebubbles-channel-adapter-checklist.md",
+      "status": "completed",
+      "date": "2026-02-16",
+      "updated": "2026-02-16",
+      "summary": "Added a first-class iMessage channel via BlueBubbles with inbound webhook handling (`POST /bluebubbles/events`), optional webhook token validation, chat GUID allowlist/mention gating, outbound BlueBubbles REST send, gateway wiring, docs, and tests.",
+      "files_created": [
+        "docs/plans/2026-02-16-imessage-bluebubbles-channel-adapter-checklist.md",
+        "src/channels/bluebubbles/adapter.ts",
+        "src/channels/bluebubbles/adapter.test.ts",
+        "src/channels/bluebubbles/index.ts"
+      ],
+      "files_modified": [
+        "src/config/schema.ts",
+        "src/config/schema.test.ts",
+        "src/daemon/channels.ts",
+        "src/channels/index.ts",
+        "src/gateway/server.ts",
+        "src/gateway/handlers/services.ts",
+        "src/gateway/handlers/services.test.ts",
+        "README.md",
+        "config/default.yaml",
+        "docs/api/PROTOCOL.md"
+      ],
+      "test_status": "pnpm test:run src/channels/bluebubbles/adapter.test.ts src/config/schema.test.ts src/gateway/handlers/services.test.ts + pnpm typecheck passing"
+    },
     "openclaw-style-personal-agent-without-openclaw-risks": {
       "file": "2026-02-14-openclaw-style-personal-agent-without-openclaw-risks-plan.md",
       "status": "completed",
@@ -2877,12 +2903,12 @@
     "tier2_completion": "4/4 (100%) — inbound webhooks, vector memory search, Dockerfile, heartbeat monitor",
     "tier3_completion": "5/5 (100%) — lane queue, credential redaction, web UI token dashboard, xAI (Grok) provider, Voyage AI embeddings",
     "tier4_completion": "4/4 (100%) — gateway lock, shell completion, Tailscale Serve/Funnel, DM pairing codes",
-    "feature_gap_scorecard": "112/128 match (88%), 0 partial (0%), 16 missing (12%)",
+    "feature_gap_scorecard": "113/128 match (88%), 0 partial (0%), 15 missing (12%)",
     "operator_dx_milestone": "Phase 3 (Live Ops Dashboard): 2/2 plans complete — milestone done",
     "gmail_auth_cli": "flynn gmail-auth command implemented with OAuth2 flow, doctor check, config routed to Telegram",
     "native_audio_support": "completed — smart routing for native audio (Gemini/OpenAI/GitHub) vs Whisper transcription fallback",
     "remaining_phases_completion": "Phase 1: 3/3 (100%) — context levels, command registry, memory structure. Phase 2: 3/3 (100%) — component registry, confidence routing, history index. Phase 3: 2/2 (100%) — adaptive memory/compaction, truthfulness/autonomy hardening",
-    "next_up": "OpenClaw gap: iMessage/BlueBubbles channel adapter (open next scoped implementation checklist)"
+    "next_up": "OpenClaw gap: Zalo channel adapter (open next scoped implementation checklist)"
   },
   "soul_md_and_cron_create": {
     "date": "2026-02-11",