iMessage: promote BlueBubbles and refresh docs/skills (#8415)

* feat: Make BlueBubbles the primary iMessage integration

- Remove old imsg skill (skills/imsg/SKILL.md)
- Create new BlueBubbles skill (skills/bluebubbles/SKILL.md) with message tool examples
- Add keep-alive script documentation for VM/headless setups to docs/channels/bluebubbles.md
  - AppleScript that pokes Messages.app every 5 minutes
  - LaunchAgent configuration for automatic execution
  - Prevents Messages.app from going idle in VM environments
- Update all documentation to prioritize BlueBubbles over legacy imsg:
  - Mark imsg channel as legacy throughout docs
  - Update README.md channel lists
  - Update wizard, hubs, pairing, and index docs
  - Update FAQ to recommend BlueBubbles for iMessage
  - Update RPC docs to note imsg as legacy pattern
  - Update Chinese documentation (zh-CN)
- Replace imsg examples with generic macOS skill examples where appropriate

BlueBubbles is now the recommended first-class iMessage integration,
with the legacy imsg integration marked for potential future removal.

* refactor: Update import paths and improve code formatting

- Adjusted import paths in session-status-tool.ts, whatsapp-heartbeat.ts, and heartbeat-runner.ts for consistency.
- Reformatted code for better readability by aligning and grouping related imports and function parameters.
- Enhanced error messages and conditional checks for clarity in heartbeat-runner.ts.

* skills: restore imsg skill and align bluebubbles skill

* docs: update FAQ for clarity and formatting

- Adjusted the formatting of the FAQ section to ensure consistent bullet point alignment.
- No content changes were made, only formatting improvements for better readability.

* style: oxfmt touched files

* fix: preserve BlueBubbles developer reference (#8415) (thanks @tyler6204)

skills/imsg/SKILL.md

@@ -23,24 +23,52 @@ metadata:
   }
 ---
 
-# imsg
+# imsg Actions
+
+## Overview
 
 Use `imsg` to read and send Messages.app iMessage/SMS on macOS.
 
-Requirements
+Requirements: Messages.app signed in, Full Disk Access for your terminal, and Automation permission to control Messages.app for sending.
 
-- Messages.app signed in
-- Full Disk Access for your terminal
-- Automation permission to control Messages.app (for sending)
+## Inputs to collect
 
-Common commands
+- Recipient handle (phone/email) for `send`
+- `chatId` for history/watch (from `imsg chats --limit 10 --json`)
+- `text` and optional `file` path for sends
 
-- List chats: `imsg chats --limit 10 --json`
-- History: `imsg history --chat-id 1 --limit 20 --attachments --json`
-- Watch: `imsg watch --chat-id 1 --attachments`
-- Send: `imsg send --to "+14155551212" --text "hi" --file /path/pic.jpg`
+## Actions
 
-Notes
+### List chats
+
+```bash
+imsg chats --limit 10 --json
+```
+
+### Fetch chat history
+
+```bash
+imsg history --chat-id 1 --limit 20 --attachments --json
+```
+
+### Watch a chat
+
+```bash
+imsg watch --chat-id 1 --attachments
+```
+
+### Send a message
+
+```bash
+imsg send --to "+14155551212" --text "hi" --file /path/pic.jpg
+```
+
+## Notes
 
 - `--service imessage|sms|auto` controls delivery.
 - Confirm recipient + message before sending.
+
+## Ideas to try
+
+- Use `imsg chats --limit 10 --json` to discover chat ids.
+- Watch a high-signal chat to stream incoming messages.