Skip to content

docs(readme): refresh for v0.6→v0.8, add MCP tool map#19

Merged
hamr0 merged 1 commit into
masterfrom
docs/readme-v0.6-v0.8-refresh
Jun 16, 2026
Merged

docs(readme): refresh for v0.6→v0.8, add MCP tool map#19
hamr0 merged 1 commit into
masterfrom
docs/readme-v0.6-v0.8-refresh

Conversation

@hamr0

@hamr0 hamr0 commented Jun 16, 2026

Copy link
Copy Markdown
Owner

Refreshes the root README to reflect the last three releases and restructures it onto the shared bare-ecosystem skeleton.

What changed

  • Two run modes up front — the lead names both Docker and npx; a new Two ways to run table contrasts Container vs Lite (where Beeper lives, deps, start command, first-run login) and states the same-single-file version-parity guarantee. Quick start / Lite mode retitled Quick start (container) / Lite mode (npx); the now-redundant inline comparison table dropped.
  • New "The MCP" section — the "what's inside" map documenting all 12 verbs grouped Read/triage · Write/act · Watch/reach. Surfaces 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 pin fixedBEEPERBOX_IMAGE_TAG=0.7.00.8.0.
  • npm READMEmcp/README.md kept as a focused lite-mode landing page (intentionally not a copy of the full README); its two cross-links repointed to the renamed anchors (#quick-start-container, #lite-mode-npx).
  • CHANGELOG — recorded under [Unreleased] / Documentation.

Docs-only; no runtime/version change.

🤖 Generated with Claude Code

Restructure the root README onto the shared bare-ecosystem skeleton and
bring it current with the last three releases:

- Lead names both run modes (Docker + npx); new "Two ways to run" table
  contrasts Container vs Lite and states the single-file version-parity
  guarantee. Retitle Quick start (container) / Lite mode (npx); drop the
  now-redundant inline comparison table.
- New "The MCP" section maps all 12 verbs (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).
- Bump stale BEEPERBOX_IMAGE_TAG pin 0.7.0 -> 0.8.0.
- Repoint mcp/README.md cross-links to the renamed anchors
  (#quick-start-container, #lite-mode-npx); keep it a focused lite-mode
  landing page, not a copy of the full README.
- CHANGELOG: record under [Unreleased] / Documentation.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@hamr0 hamr0 merged commit 26616c7 into master Jun 16, 2026
@hamr0 hamr0 deleted the docs/readme-v0.6-v0.8-refresh branch June 16, 2026 13:05
hamr0 added a commit that referenced this pull request Jun 17, 2026
PATCH per the versioning policy — docs only; the MCP/HTTP surface, schemas,
and ports are bit-identical to v0.8.0. Ships the README refresh (root #19,
npm-page #20) under a new version because npm versions are immutable and the
reshaped lite-mode README only reaches npmjs.com via a fresh publish.

- mcp/package.json 0.8.0 -> 0.8.1 (keeps npm == container == serverInfo.version)
- mcp/package.json homepage anchor -> #lite-mode-npx
- CHANGELOG [Unreleased] -> [0.8.1] 2026-06-17 [PATCH]

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant