@hraness/message-like-me 0.8.11 → 0.8.12

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.8.12 (2026-09-21)
+
+- Bind legacy installation to the exact public `@hraness/message-like-me@0.8.12` npm package, with the same reviewed bytes mirrored in the immutable GitHub Release. This does not install the Textbutler menu companion or enable automatic replies.
+- Add the native TextButler desktop app with scoped guided setup, a menu bar companion, and per-contact review-first controls. New installations start paused and automatic replies stay off per contact.
+- Connect subscription replies through qualified XCB applications: AI suggestions run against an explicitly admitted native Claude Code or Codex subscription account with exact executable, account, and model checks instead of an API key.
+- Add the agent messaging JSON CLI for agents to read and summarize one selected conversation, prepare text or attachment drafts, and send only an explicitly authorized reviewed message.
+- Restore native iMessage discovery and history through the reviewed Ghostget connector, including literal modern coordinates, and provision the pinned private transport during setup so a reviewed connector upgrade cannot leave a stale helper.
+- Refresh the informational site's identity and keep it informational only; it receives no messages or contact data.
+
 ## 0.8.11 (2026-09-16)
 
 - Bind legacy installation to the exact public `@hraness/message-like-me@0.8.11` npm package, with the same reviewed bytes mirrored in the immutable GitHub Release. This does not install the Textbutler menu companion or enable automatic replies.

package/README.md

@@ -2,54 +2,68 @@
 
 [![skills.sh](https://skills.sh/b/hraness/message-like-me)](https://skills.sh/hraness/message-like-me)
 
-Textbutler is a personal message butler for macOS, powered by the coding agent
-you choose. Activate a few contacts, give each relationship a private folder of
-context, and let a clearly identified assistant help when it is useful.
-
-The new product lives at [textbutler.app](https://textbutler.app). Its default
-response looks like `🤖{ hello this is my response }`. Each contact can choose
-the three symbols, a keyword, and smart or keyword-only response mode.
-
-**Development status:** the source includes the macOS daemon lifecycle,
-owner-selected Ghostget conversation enrollment, optional history
-initialization, private memory, executable hooks, reply policy and send journal.
-The supported local surface is the `textbutler` CLI plus its native menu-bar
-companion. It runs from a prebuilt binary and does not require an app bundle,
-signing, notarization, or a download manager. Agentrouter includes a
-restricted Claude Agent SDK adapter and shared account custody. Live automated
-replies remain unavailable until Ghostget's durable events and scoped
-automation grants, and the provider's contact-only execution, are qualified.
-Codex execution and native rich actions are also unavailable. The website is
-informational; it has no connection to private messages or contact folders.
-
-The menu-bar companion uses the shared, unsigned desktop-foundation runner. The
-`textbutler menubar` commands download and verify a pinned release binary on
-first start; nothing compiles source or opens a windowed application.
-
-Start with the [architecture and capability status](docs/textbutler/architecture.md),
-[Textbutler runtime](packages/textbutler/README.md),
-[Agentrouter](packages/agentrouter/README.md),
-[transport adapter](packages/transport/README.md), or the
-[menu companion adapter](packages/textbutler/src/menubar.ts).
+Textbutler is a local message assistant for macOS. Its guided terminal and menu
+bar help you connect selected iMessage, WhatsApp and Beeper conversations, see
+what needs an answer, and review replies before sending them.
+
+**Current status: source pilot.** Messaging setup, conversation selection,
+private contact memory, inbox review and replies you write yourself are
+implemented. AI replies require a verified Textbutler bundle with reviewed
+composition admission and connect to a separately installed
+[xcb](https://github.com/hraness/xcb) native runtime with an explicit subscription
+account and model. Textbutler is an MIT-licensed reference application for xcb's
+zero-tool generation API; xcb keeps provider credentials and custody. Account
+setup, current runtime admission and live verification on your chosen messaging
+account and recipient are required before relying on automatic replies. See the
+[subscription guide](docs/textbutler/native-subscription.md).
+
+Start with the [guided setup](docs/textbutler/getting-started.md) and
+[messaging app support](docs/textbutler/messaging-apps.md). Beeper can connect
+apps such as Signal, Telegram and Instagram through Ghostget's current text
+automation adapter. Its linked apps and account permissions determine what is
+available. The [architecture](docs/textbutler/architecture.md) records the
+runtime boundaries and remaining qualification work.
+
+Agents can use the [JSON CLI](docs/textbutler/agent-cli.md) to read and summarize
+one conversation, prepare text or media drafts, and send an explicitly
+authorized message. Each connection reports its available actions.
+
+## Open the guided terminal
+
+From a Textbutler checkout on your Mac, with Bun 1.3.14:
 
 ```sh
 bun install --frozen-lockfile --ignore-scripts
-bun run check:textbutler
+bun run textbutler tui
 ```
 
-The source is MIT licensed. New packages remain unpublished while their
-contracts are developed. The menu-bar CLI and daemon are the only supported
-Textbutler runtime surfaces. Message Like Me history readers and message-bundle
-contracts are retained below only as compatibility documentation for existing
-consumers; they are not Textbutler runtime components.
+Choose **Setup & readiness**, then **Connect messaging apps**. Textbutler uses
+an existing Ghostget installation for messaging sign-in and permissions. The
+guide explains how to select its executable and accounts, start the background
+service, and add one conversation. New installations start paused and new
+contacts have automatic replies off. Setup and conversation selection never
+send a message.
+
+For AI replies, build and install with `bun run textbutler:install`, then run
+`~/.local/bin/textbutler`. The builder requires the reviewed composition receipt
+to match current source bytes and both contact capability profiles. A source
+daemon has no embedded composition admission and cannot enable subscription
+inference. Source commands remain useful for setup and manual reply controls.
+
+Textbutler's source is MIT licensed and its new packages remain unpublished.
+The published Message Like Me package documented below installs the legacy
+history tools, not Textbutler. The website at
+[textbutler.app](https://textbutler.app) is informational and receives no private
+messages or contact folders.
 
 ## Run the Textbutler menu companion
 
-Start the companion in the background; it stays running until `menubar stop` or
-its menu-bar **Quit** action:
+The native companion downloads and verifies a pinned prebuilt
+desktop-foundation runner on first start. No local Rust build is needed. Start
+it from the terminal's **Menu bar companion** action or run:
 
 ```sh
-bun run textbutler menubar
+bun run textbutler menubar start
 bun run textbutler menubar status
 bun run textbutler menubar stop
 ```
@@ -64,9 +78,51 @@ bun run textbutler menubar uninstall
 
 `menubar doctor` reports the runner artifact, platform capability, and any
 operating-system approval step needed on an unsigned binary. The companion
-shows daemon state, contact and account readiness, capabilities, and recent
-activity. It controls global pause and opens the informational Textbutler
-website. It does not provide contact enrollment or account setup.
+offers pause, connection checks, conversation selection, contact and agent
+settings, inbox previews and recent activity. Use the terminal for complete
+draft review and sending. Menu startup is separate from daemon startup;
+quitting the menu leaves an installed background service running. Use
+`daemon install` or `daemon uninstall` to manage that service. Uninstall retains
+your settings and contact memory.
+
+## Answer your own messages
+
+In the terminal, choose **Inbox & replies**, select a conversation, then choose
+**Type a reply**. Review the recipient and complete text before typing `send`.
+This path needs a ready messaging connection but no AI account. Cancelling the
+review sends nothing.
+
+After the connected AI account passes its readiness check, suggestions use a separate
+review step:
+
+```sh
+bun run textbutler inbox
+bun run textbutler replies suggest CONTACT
+bun run textbutler replies show DRAFT
+bun run textbutler replies send DRAFT DIGEST
+bun run textbutler replies discard DRAFT
+```
+
+`CONTACT` is the exact contact ID or a unique name match. Use the complete draft
+and digest returned by `replies show`; previews alone cannot send. Suggestions
+expire after fifteen minutes. Changed contact settings, conversation context
+or attachment bytes require a fresh review. The CLI also supports an immediate
+explicit reply with `bun run textbutler replies send CONTACT TEXT...`.
+
+`submitted` means the messaging provider accepted the action, not that the
+recipient received or read it. A pending operation prints a job ID: inspect it
+with `bun run textbutler jobs show JOB_ID`. Do not repeat a send with an unknown
+outcome. Uncertain sends remain blocked until reconciled.
+
+Every text reply is wrapped in the contact's three disclosure symbols, rendered
+`🤖{ … }` by default. Each field may be cleared individually; clearing all three
+sends plain text. The review shows the actual outgoing text. The send journal
+retains provider acceptance IDs when available; see the messaging guide for
+connection-specific attribution and delivery limits.
+
+Automatic replies remain a separate choice: they require a qualified agent,
+a ready messaging connection, explicit contact activation and global resume.
+Keep them paused until those requirements and the relevant live checks pass.
 
 ## Legacy Message Like Me history tools
 
@@ -111,7 +167,7 @@ Message Like Me requires Bun 1.3.14 or newer. Install the exact public npm
 package, then install both bundled Agent Skills:
 
 ```sh
-bun add --global @hraness/message-like-me@0.8.11
+bun add --global @hraness/message-like-me@0.8.12
 messagelikeme skill install
 ```
 
@@ -851,7 +907,7 @@ profile to a fixture.
 Read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a change.
 
 The canonical repository is
-[`hraness/message-like-me`](https://github.com/hraness/message-like-me).
+[`hraness/textbutler`](https://github.com/hraness/textbutler).
 The informational project page is
 [`messagelikeme.com`](https://messagelikeme.com). The CLI does not connect to
 the site, and the site never receives message or contact data.