@hraness/message-like-me 0.8.11 → 0.8.12

package/docs/textbutler/readiness.md

@@ -0,0 +1,78 @@
+# Textbutler readiness
+
+Textbutler currently supports a local, owner-controlled pilot. Its terminal and
+menu can connect configured messaging accounts, select direct conversations,
+show the reply inbox and manage contacts. An owner can write a reply, review its
+complete disclosed text and explicitly send it. Installation starts no service,
+connects no account and enables no automatic replies.
+
+This is not yet an unattended production assistant. The following boundaries
+remain visible in setup and must be resolved before that claim is made.
+
+| Area | Current state | Remaining acceptance evidence |
+| --- | --- | --- |
+| First use | Guided terminal, actionable readiness, additive configuration, paused defaults | First-run testing with real owner-selected accounts and permissions |
+| Menu bar | Shared native Rust runner; setup, connections, contact controls, bounded menus and recoverable jobs | Confirm native lifecycle on each supported macOS release |
+| Reply review | Complete ordered action review, recipient/context digest, attachment byte verification; typed preview revision checks | Agreed-recipient live delivery and takeover tests |
+| Agent execution | Verified bundle requires reviewed Textbutler composition admission; [external xcb subscription connection](native-subscription.md), with an explicit executable pin, private state, account and model; no default account or automatic activation | Exact xcb build/provider admission, both classifier and reply checks, and authenticated live inference on the selected account; Claude API still requires separate trusted runtime admission |
+| iMessage | Existing native Ghostget connection | Current account permissions and live transport qualification |
+| WhatsApp | Existing Ghostget linked-device connection and explicit sync | Current linked-device identity, sync and live transport qualification |
+| Beeper | Direct text conversations through Ghostget 0.18.14+; independent connection checks | Current Desktop API/account setup, canonical pending-send reconciliation, and edit/delete observation coverage |
+| Uncertain sends | Journal preserves intent and blocks further sends | Owner reconciliation using durable upstream run/message identity; no blind retry |
+| Distribution | Local integrity-checked bundle and inert installer; `external-xcb` capability keeps provider execution in separately configured xcb | Signed/public release provenance, upgrade qualification and provider-specific admission; artifact hashes do not attest providers |
+
+## Interface direction
+
+XCB is a useful interaction reference: a clear status view, filtered pickers,
+contextual choices, complete review and clean cancellation. Textbutler follows
+that separation with a thin terminal client over its owner control protocol.
+All permission, account, contact, grant and dispatch checks remain in the daemon.
+
+The native menu already uses the shared Rust desktop foundation. A new Rust
+runtime is not required to make these controls usable. If the terminal grows
+into a full-screen workspace, XCB's Ratatui/Crossterm interface is an appropriate
+reference. The subscription connection uses xcb's dedicated zero-tool `generate`
+contract. It does not use the workspace coding command or inherit its tools and
+sessions.
+
+## Agent execution direction
+
+The verified bundle connects to an explicitly selected xcb installation after
+its build checks reviewed composition evidence against current source bytes and
+both contact profiles. A source daemon has no embedded admission and keeps
+subscription inference unavailable. xcb handles
+Claude Code or Codex subscription authentication, confinement and provider
+custody. Textbutler uses zero-tool generation, parses one operation proposal at
+a time and applies its contact-scoped broker policy before any effect.
+
+Accounts are unavailable until configured and checked; contacts remain disabled
+until explicitly enabled. No provider qualification is manufactured by setup,
+the installer or a matching hash. The [subscription guide](native-subscription.md)
+explains this reusable application contract and its separate runtime and live
+acceptance requirements. Textbutler's MIT source serves as an xcb reference
+application; publication does not establish unattended operational readiness.
+
+## Messaging expansion
+
+Use Beeper for linked Signal, Telegram and Instagram conversations while
+retaining native iMessage and WhatsApp. Current Beeper automation is text-only;
+capability labels must not promise attachments, reactions, polls or delivery
+confirmation that its adapter does not supply.
+
+A native Telegram client, an owner-linked Signal adapter and an Instagram
+professional-account integration have different account models and operating
+requirements. They should enter through Ghostget's scoped transport contract,
+with explicit capabilities and live acceptance criteria. Business/bot APIs are
+not substitutes for a personal inbox. See [messaging app support](messaging-apps.md)
+for current primary sources and the limits of each approach.
+
+## Operational checks
+
+Before enabling automatic replies, verify the exact installed artifact, model
+account, messaging identity and selected recipient. Exercise pause, owner
+activity during composition, cancellation just before dispatch, transport loss,
+restart during an uncertain send and grant expiry. A passing synthetic suite is
+source evidence; it does not prove real delivery or native agent isolation.
+
+Retain failed or uncertain custody records. Reinstallation, restart and setup
+must not delete them to make an account appear ready.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hraness/message-like-me",
-  "version": "0.8.11",
+  "version": "0.8.12",
   "description": "A local-first CLI and Agent Skill for studying private messaging history and drafting messages that sound like you.",
   "license": "MIT",
   "type": "module",
@@ -77,16 +77,22 @@
     "check:standalone": "bun scripts/check-standalone.ts",
     "check:dist": "bun scripts/check-dist.ts",
     "check:package": "bun scripts/package-smoke.ts",
-    "check:agentrouter-package": "bun scripts/agentrouter-package-smoke.ts",
     "check:cost-surfaces": "bun ./scripts/check-cost-surfaces.mjs",
-    "check": "bun run check:cost-surfaces && bun run typecheck && bun run check:effect && bun run test && bun run check:skill && bun run check:standalone && bun run build && bun run check:public-graphs && bun run check:dist && bun run check:package && bun run check:agentrouter-package && bun run check:textbutler",
-    "check:textbutler": "bun test packages && tsc --noEmit -p packages/agentrouter/tsconfig.json && tsc --noEmit -p packages/transport/tsconfig.json && tsc --noEmit -p packages/textbutler/tsconfig.json",
+    "check": "bun run check:cost-surfaces && bun run typecheck && bun run check:effect && bun run test && bun run check:skill && bun run check:standalone && bun run build && bun run check:public-graphs && bun run check:dist && bun run check:package && bun run check:textbutler",
+    "check:textbutler": "bun test packages && tsc --noEmit -p packages/transport/tsconfig.json && tsc --noEmit -p packages/textbutler/tsconfig.json",
     "textbutler": "bun packages/textbutler/src/cli.ts",
+    "textbutler:build": "bun scripts/build-textbutler.ts",
+    "textbutler:install": "bun scripts/install-textbutler.ts",
+    "textbutler:app": "bun scripts/macos-textbutler-app.ts",
     "prepack": "bun run check",
     "check:effect": "bun scripts/check-effect-architecture.ts",
     "check:public-graphs": "bun scripts/check-public-graphs.ts"
   },
+  "dependencies": {
+    "@hraness/oh": "https://github.com/hraness/oh/releases/download/v0.10.8/hraness-oh-0.10.8.tgz"
+  },
   "devDependencies": {
+    "@hraness/agentmixer": "https://github.com/hraness/agentmixer/releases/download/v0.1.1/hraness-agentmixer-0.1.1.tgz",
     "@anthropic-ai/claude-agent-sdk": "0.3.268",
     "@hraness/desktop-foundation": "https://github.com/hraness/desktop-foundation/releases/download/v0.7.0/hraness-desktop-foundation-0.7.0.tgz",
     "@anthropic-ai/sdk": "0.125.0",
@@ -97,6 +103,7 @@
     "sigstore": "4.1.1",
     "typescript": "6.0.3",
     "zod": "4.6.2",
-    "@hraness/support-foundation": "github:hraness/support-foundation#2d034b357680353574411217d68b02b6755b07ed"
+    "@hraness/support-foundation": "github:hraness/support-foundation#2d034b357680353574411217d68b02b6755b07ed",
+    "@hraness/local-custody": "github:hraness/local-custody#v0.4.0"
   }
 }