release: stamp v0.8.1 — docs refresh + npm README reshape

CHANGELOG.md

@@ -12,11 +12,13 @@ beeperbox follows [Semantic Versioning 2.0.0](https://semver.org/) with one conc
 
 Published tags on GHCR: `:X.Y.Z` (exact, immutable), `:X.Y` (rolling within a minor), `:X` (rolling within a major — always `:0` today), `:latest` (newest release tag, rebuilt weekly to pick up upstream Beeper AppImage drift), `:edge` (every push to `master`, may break).
 
-## [Unreleased]
+## [0.8.1] — 2026-06-17 `[PATCH]`
+
+Documentation only. PATCH per the versioning policy — the MCP tool surface, raw/HTTP API, `Chat`/`Message` schemas, and default ports are bit-identical to v0.8.0, and no client-code edits are required. The headline is that the READMEs are now current with v0.6 → v0.8: the root README gained a **The MCP** map of all 12 verbs (including the previously undocumented `poll_messages` watch primitive and `download_asset` attachment reach), and the npm-page README was reshaped onto the shared `bare`-ecosystem skeleton. This is the first release whose npm tarball carries the reshaped lite-mode README — npm versions are immutable, so the doc refresh ships under a new version by necessity.
 
 ### Documentation
 
-- **README rewrite to reflect v0.6 → v0.8.** The root README was restructured onto the shared `bare`-ecosystem skeleton and brought current with the last three releases. The lead now names both run modes (Docker *and* `npx`), a **Two ways to run** table up top contrasts Container vs Lite (where Beeper lives, deps, start command, first-run login) and states the same-single-file version-parity guarantee, and `Quick start` / `Lite mode` are retitled **Quick start (container)** / **Lite mode (`npx`)** with the now-redundant inline comparison table dropped. New **The MCP** section — the "what's inside" map — documents all 12 verbs grouped Read/triage · Write/act · Watch/reach, surfacing the previously undocumented `poll_messages` watch primitive + restart-safe cursor + `source` echo-guard (0.6.0) and `attachments[]` + `download_asset` byte reach (0.7.0). Stale `BEEPERBOX_IMAGE_TAG=0.7.0` pin example bumped to `0.8.0`. The npm-page `mcp/README.md` was reshaped onto the same `bare`-ecosystem skeleton (banner, badges, quick start, a compact 12-verb map, the bare-ecosystem footer) but kept lighter than the full README — still a focused lite-mode landing page, not a copy; cross-links repointed to the renamed/added anchors (`#quick-start-container`, `#the-mcp`).
+- **README rewrite to reflect v0.6 → v0.8.** The root README was restructured onto the shared `bare`-ecosystem skeleton and brought current with the last three releases. The lead now names both run modes (Docker *and* `npx`), a **Two ways to run** table up top contrasts Container vs Lite (where Beeper lives, deps, start command, first-run login) and states the same-single-file version-parity guarantee, and `Quick start` / `Lite mode` are retitled **Quick start (container)** / **Lite mode (`npx`)** with the now-redundant inline comparison table dropped. New **The MCP** section — the "what's inside" map — documents all 12 verbs grouped Read/triage · Write/act · Watch/reach, surfacing the previously undocumented `poll_messages` watch primitive + restart-safe cursor + `source` echo-guard (0.6.0) and `attachments[]` + `download_asset` byte reach (0.7.0). Stale `BEEPERBOX_IMAGE_TAG=0.7.0` pin example bumped to `0.8.0`. The npm-page `mcp/README.md` was reshaped onto the same `bare`-ecosystem skeleton (banner, badges, quick start, a compact 12-verb map, the bare-ecosystem footer) but kept lighter than the full README — still a focused lite-mode landing page, not a copy; cross-links repointed to the renamed/added anchors (`#quick-start-container`, `#the-mcp`), and `mcp/package.json`'s `homepage` anchor updated to `#lite-mode-npx`.
 
 ## [0.8.0] — 2026-06-16 `[MINOR]`
 

mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "beeperbox",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Lite mode for beeperbox — the opinionated MCP verb server for Beeper Desktop, run standalone against a Beeper you already have open (no Docker, no Electron). The full headless-Beeper-in-Docker build lives at github.com/hamr0/beeperbox.",
   "bin": {
     "beeperbox": "server.js"
@@ -34,7 +34,7 @@
     "url": "git+https://github.com/hamr0/beeperbox.git",
     "directory": "mcp"
   },
-  "homepage": "https://github.com/hamr0/beeperbox#lite-mode",
+  "homepage": "https://github.com/hamr0/beeperbox#lite-mode-npx",
   "bugs": "https://github.com/hamr0/beeperbox/issues",
   "author": "hamr0",
   "license": "Apache-2.0"