From a9b38150c044ef80d7a530a67db327f5f99d0d10 Mon Sep 17 00:00:00 2001 From: William Valentin Date: Mon, 16 Feb 2026 09:41:35 -0800 Subject: [PATCH] docs(plan): record imessage bluebubbles gap completion --- ...026-02-06-openclaw-feature-gap-analysis.md | 8 ++-- docs/plans/2026-02-15-openclaw-gap-roadmap.md | 2 - ...e-bluebubbles-channel-adapter-checklist.md | 46 +++++++++++++++++++ docs/plans/state.json | 30 +++++++++++- 4 files changed, 77 insertions(+), 9 deletions(-) create mode 100644 docs/plans/2026-02-16-imessage-bluebubbles-channel-adapter-checklist.md diff --git a/docs/plans/2026-02-06-openclaw-feature-gap-analysis.md b/docs/plans/2026-02-06-openclaw-feature-gap-analysis.md index 8ef2c0b..61004a3 100644 --- a/docs/plans/2026-02-06-openclaw-feature-gap-analysis.md +++ b/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 -7. Zalo / Zalo Personal -8. LINE / Feishu / Mattermost +6. Zalo / Zalo Personal +7. 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 diff --git a/docs/plans/2026-02-15-openclaw-gap-roadmap.md b/docs/plans/2026-02-15-openclaw-gap-roadmap.md index 0f8c1c0..c53b836 100644 --- a/docs/plans/2026-02-15-openclaw-gap-roadmap.md +++ b/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 diff --git a/docs/plans/2026-02-16-imessage-bluebubbles-channel-adapter-checklist.md b/docs/plans/2026-02-16-imessage-bluebubbles-channel-adapter-checklist.md new file mode 100644 index 0000000..81cf8da --- /dev/null +++ b/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` diff --git a/docs/plans/state.json b/docs/plans/state.json index a4d7bac..b3e966e 100644 --- a/docs/plans/state.json +++ b/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",