Commit graph

11 commits

Author SHA1 Message Date
Chris Sells
f05b2b0a6a
docs: scope the shared-server read failure to pre-1.2.0 schemas; add eight community tools (#7301)
* docs(upgrading): scope the shared-server read failure to pre-1.2.0 schemas

#7284 said most reads fail between upgrading a shared server's clients
and running `bd migrate schema`. That only holds for a schema older than
1.2.0: the leases table ships with main migration 0055 and ignored 0012
and 0016, all in v1.2.0. From 1.2.x, reads keep working and only writes
are refused (probed against a 1.2.1 server with 1.3.1 and main builds).

Restore the original wording and add the pre-1.2.0 caveat, naming only
the observed `bd list` failure from #6929.

Refs #6929

* docs: add beads-viewer (Paseo plugin) to community tools

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
(cherry picked from commit ad28cf00ba)

* Add LazyBeads (lb) to community tools

- List lesliesrussell/lazybeads under Terminal UIs
- Note that it is unrelated to the earlier lazybeads under Historical

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
(cherry picked from commit 1aa2b645e2)

* docs(community-tools): update the beads-web entry

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
(cherry picked from commit aa177110b3)

* docs(community-tools): mention the beads-web tree view

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QebAVaD36wUemAsdBx8wwJ
(cherry picked from commit e0eb482a11)

* Updated community tools documentation with Beads Tracker

Applied changes from BB to 1 file

Files modified:
- docs/community-tools.md

Updated community tools documentation

Applied changes from BB to 1 file

Files modified:
- docs/community-tools.md

Updated community tools documentation

Applied changes from BB to 1 file

Files modified:
- docs/community-tools.md

(cherry picked from commit 75d0f8de0c)

* docs: add b9s to community tools (TUI and web UI)

(cherry picked from commit 8bb6ab6913)

* docs: add btui to community tools (btui-bb2)

Agent-Signature: codex-unknown-model-unknown-reasoning on behalf of Andreas Dellrud
(cherry picked from commit 81da372c63)

* docs: mention released btui Beads 1.3 support (btui-0fm)

Agent-Signature: codex-unknown-model-unknown-reasoning on behalf of Andreas Dellrud
(cherry picked from commit 8f27445bee)

* docs: add beadside to community tools

(cherry picked from commit 2c2cb1fd5c)

* docs: add Beads for Obsidian to community tools

(cherry picked from commit cb82d067d8)

---------

Co-authored-by: cuongntr <cuongntr@users.noreply.github.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: Leslie Russell <leslierussell@gmail.com>
Co-authored-by: weselow <598746@gmail.com>
Co-authored-by: Beyond Better <git@beyondbetter.app>
Co-authored-by: vanderheijden86 <vanderheijden86@gmail.com>
Co-authored-by: Andreas Dellrud <andreas.dellrud@gmail.com>
Co-authored-by: michal.psencik <misa.psencik@gmail.com>
Co-authored-by: Rome-1 <romethorstenson@gmail.com>
2026-10-06 10:56:39 -07:00
Trey Stout
08fda16e47
docs: add beadcyte to community tools (Web UIs) (#6332)
* docs: add beadcyte to community tools (Web UIs)

Local web app that draws bead history and a projected future: a
historical-median estimator, a greedy WIP-cap scheduler, and an
eight-signal triage score, each with its own uncertainty. Reads and
writes only through the bd CLI.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* docs: correct beadcyte storage-access claim and normalize emphasis

The beadcyte entry said the tool "reads and writes exclusively through
the `bd` CLI ... never the Dolt files or `.beads/issues.jsonl`". The
first half is false for the shipped package. Measured against
beadcyte@0.9.0, the latest published version (tarball sha1
93964d9632cc1b1cc846f5d84f0dfa8a79a4ef57, matching the registry
shasum):

  - The package starts exactly one process that is not `bd`:
    `spawn("dolt", ["sql", "-r", "json", "-q", sql], ...)` with cwd
    <project>/.beads/embeddeddolt (src/history-sql.mjs:250,
    `doltSqlRunner`).
  - `beadcyte freeze` reaches it through `readDoltDates`
    (src/freeze-cli.mjs:110). `freeze` is a dispatched subcommand
    (bin/beadcyte.mjs:37, 63-65). The path is on by default:
    freeze-cli.mjs:33 sets `dolt: true`, and `--no-dolt` (:38) turns
    it off.
  - The author's own comment agrees: "`beadcyte freeze` is the ONE
    place beadcyte reads Dolt directly ... read-only"
    (src/history-sql.mjs:42-44).

Correcting an over-broad claim can easily introduce a new one, so each
clause of the replacement was checked:

  - "reads and writes through the `bd` CLI": every other process the
    package starts is `bd`. Writes go through `bd update`, including
    freeze's own write-back (freeze-cli.mjs:127), and through
    `bd dolt pull`/`push` (src/serve.mjs:498, 509).
  - "read-only": `QUERIES` (history-sql.mjs:115-124) holds 4
    statements, all SELECT. Every SQL call site passes one of them
    (history-sql.mjs:302-303, 467-470).
  - "never `.beads/issues.jsonl`": the package contains zero `jsonl`
    references, so the entry still meets the page's compatibility bar
    (docs/community-tools.md:8-11).

Emphasis: 51 of the page's 52 entries carry exactly one bold span, the
linked name. beadcyte carried three. Removing the bold from "happened"
and "expects to happen" brings it to 52/52.

Length: the correction adds 74 characters, bringing the entry to 1073.
That is still the longest of the 7 Web UIs entries, and 3rd on the
page after Beadazzle (1579) and Beads Dashboard (1300). Review
suggested trimming it to a feature summary. That suggestion is
optional and does not gate the review, and how the product is
described is the contributor's call, so this commit does not make it.

Gates: git diff --cached --check is clean. check-doc-flags.sh returns
rc=0 against the pinned v1.2.2 bd. check-doc-freshness.sh reports 68
PASS / 0 FAIL. go test ./test/docsync passes 8/8.
go test -tags integration -run TestDocFreshness ./scripts gives
37 pass / 0 fail / 1 skip.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
Co-authored-by: Eddie the Engineer <adopt-pr@gascity.local>
2026-10-01 01:17:19 -07:00
Bùi Phan Viết Cường
16873dd2bd
docs(community-tools): add beads-pm-kit (#6239)
Add beads-pm-kit to the orchestration section: ten PM skills for running
a Beads board (split, estimate, take, loop, fleet, pm-loop, report,
forecast, audit, handoff), installable with
`npx skills add cuongbphv/beads-pm-kit`. The entry is sized to match its
neighbours in the section.
2026-09-28 21:22:15 -07:00
Juan Reyero
b42e6916f0
community-tools: add the aweb mail delegate for bd mail (#6300)
An implementation of the mail.delegate seam that gives any beads repo a
working bd mail. aweb is an open-source communication layer for agents:
durable mail and chat, wake-up events, local (team) or global
(cross-organization, federated) identities, signed and verified senders;
self-hostable or hosted. Guide and recording:
https://aweb.ai/docs/beads-mail/

Co-authored-by: Juan Reyero <juan@thestarmaps.com>
2026-09-28 13:34:09 -07:00
Julian Sommer
511849496b
docs: add Maggie to community tools (#6446) 2026-09-26 19:12:59 -07:00
Graeme Foster
59485e385f
docs: add beady-eye to community tools (#6502)
* docs: add beady-eye to community tools

* docs: add beady-eye to community tools

* docs: add beady-eye to community tools

* docs: add beady-eye to community tools

* docs: add beady-eye to community tools

* docs: add beady-eye to community tools
2026-09-26 14:29:24 -07:00
Bùi Phan Viết Cường
086f91003e
docs: add Beads Dashboard to Editor Extensions in community-tools.md (#5336) 2026-08-07 05:55:02 -07:00
Ransom
446538a8e4
docs: add Beadazzle to Native Apps in community-tools.md (#4735) 2026-07-26 12:28:50 -07:00
Jackson Cantrell
3ab419583e
docs: add emBEADings to community tools (#4850)
* docs: add emBEADings to community tools

* docs: use PyPI install for emBEADings

---------

Co-authored-by: Jackson Cantrell <cantrelljax@gmail.com>
2026-07-23 22:26:13 -07:00
Chris Sells
69e33099b8 docs: apply PR #4722 review feedback to user docs
- FAQ: fix bulk migration/export commands (tracker pull/push need explicit
  IDs; bulk lives on sync --pull-only / --pull / --push-only / --push) and
  correct the cross-project isolation claim (hydration + external targets)
- quickstart: replace the broken DOLT.md blob URL with site links
- installation: Quick Install Script heading matches its macOS/Linux/FreeBSD
  body
- rewrite 33 stale SCREAMING_CASE link labels to the target pages' titles
- add description frontmatter to the 55 authored pages missing it
- docs.json: wildcard redirects for the old /next/ and version-prefixed
  route spaces (1.0.0, 1.0.4, 1.0.5)
2026-07-12 11:06:57 -07:00
Chris Sells
a86a2c5dfc docs: port user docs into the Mintlify site tree under docs/
Port the website's current (non-versioned) authored pages into docs/ as
Mintlify pages: frontmatter title as H1 (body H1s removed), Docusaurus
admonitions converted to Mintlify components, root-relative extensionless
links, mermaid fences kept as-is. website/docs/** is untouched and keeps
serving the Docusaurus site until cutover.

git-mv the user-facing docs/ originals with no website twin into the new
IA (core-concepts/, architecture/, workflows/, recovery/, multi-agent/,
integrations/, reference/), converted to Mintlify form. The six files
previously mirrored by sync-website-docs.sh now live once in the site.
ERROR_HANDLING.md and CONTRIBUTOR_NAMESPACE_ISOLATION.md move to engdocs/
(contributor pattern guide and design doc per content review).

Pointer stubs remain at docs/{DOLT,STORAGE-BACKENDS,PLUGIN,RECOVERY,
JSON_SCHEMA}.md because released bd binaries print those paths; QUICKSTART
and DOLT-BACKEND stay as existing pointer stubs.

Corrected while porting: the intro's storage diagram claimed data lives at
.beads/dolt/; embedded mode (the default) uses .beads/embeddeddolt/
(internal/storage/embeddeddolt/store.go), server mode uses .beads/dolt/.
2026-07-12 10:37:07 -07:00
Renamed from docs/COMMUNITY_TOOLS.md (Browse further)