Commit graph

386 commits

Author SHA1 Message Date
Sam
7e4da9ab20
Add credentials file support for Dolt server passwords (#2854)
* feat: add credentials file support for Dolt server passwords

Add INI-style credentials file (~/.config/beads/credentials) as a
fallback for Dolt server passwords, keyed by [host:port] section.
This lets users working with multiple servers avoid juggling env vars
per project.

Lookup order: BEADS_DOLT_PASSWORD env var > credentials file > empty.
Path overridable via BEADS_CREDENTIALS_FILE env var.
Warns on overly permissive file permissions (unix only, mirrors ssh).

* docs: document credentials file in DOLT.md

Add credentials file section to the Dolt backend docs covering file
format, default location, permission warnings, and password resolution
order. Update the config reference and env var table to reference the
new feature.

* fix: use resolved runtime port for credentials file lookup

The credential file lookup in GetDoltServerPassword() used the port
from metadata.json, but the actual connection port comes from
doltserver.DefaultConfig() which has its own priority chain (port file >
config.yaml > metadata.json). When these diverge — e.g., IAP tunnel on
3308 vs local Dolt on 3307 — the credentials file lookup used the wrong
[host:port] section.

Add GetDoltServerPasswordForPort() that accepts an explicit port, and
use it in main.go where the resolved runtime port is already known.
Existing GetDoltServerPassword() delegates to the new method for
backward compatibility.

* fix: use mysql.Config.FormatDSN for proper password escaping

Passwords with special characters (& < > / % etc.) were inserted raw
into the DSN string, breaking go-sql-driver/mysql parsing. Passwords
like "zId&z,L9P4X,%k4n4rylGV<Ibos9<)/p" would cause "Access denied"
errors even though the password was correct.

Switch from manual fmt.Sprintf DSN construction to mysql.Config's
FormatDSN(), which handles escaping correctly. This also consolidates
timeout and TLS configuration into the typed Config struct instead of
string concatenation.

* test: add DSN special character password roundtrip tests

Covers passwords with &, <, >, /, ?, %, @, :, and () — all of which
broke the old fmt.Sprintf DSN construction. Verifies that FormatDSN
produces a parseable DSN and the password survives the roundtrip.
2026-04-02 20:35:56 -07:00
Anupam Chugh
6863ca7be8
Add bd rules audit and bd rules compact commands (#2810)
Filesystem-only tooling to detect contradictions, near-duplicates,
and merge opportunities in .claude/rules/*.md files.

- `bd rules audit` scans rules for contradictions and merge candidates
  using Jaccard similarity, antonym detection, and scope analysis
- `bd rules compact` merges related rules into composites (manual or auto)
- 20 tests, no new dependencies (stdlib + cobra only)
- CheckReadonly guard on compact for consistency with other write commands

Resubmission of #1625, rebased cleanly on current main.

Co-authored-by: anupamchugh <anupamchugh@gmail.com>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-02 20:29:34 -07:00
matt wilkie
9d7882c049
Add release stability gate for upgrade safety (GH#2951) (#2963)
- Add docs/RELEASE-STABILITY-GATE.md defining the upgrade matrix,
  verification criteria, and sign-off process
- Add scripts/upgrade-smoke-test.sh that tests data preservation,
  mode preservation, role preservation, and doctor health across
  upgrade scenarios (embedded maintainer, contributor, mode flip)
- Add 'make test-upgrade' target
- Update RELEASING.md checklist with upgrade smoke tests, regression
  tests, and breaking-change documentation requirements
- Links to #2764, #2765, #2949, #2950 for related test gap work

Amp-Thread-ID: https://ampcode.com/threads/T-019d4a99-63c8-779f-bb8e-ee8522b61cdf

Co-authored-by: Amp <amp@ampcode.com>
2026-04-01 17:00:25 -07:00
matt wilkie
4a05952a46
Merge pull request #2882 from REMvisual/add-claude-workspace-snapshot
Add claude-workspace-snapshot to COMMUNITY_TOOLS.md
2026-04-01 06:38:27 -07:00
coffeegoddd☕️✨
44c764e5a3 /{cmd,docs,internal}: more cleanup 2026-03-31 12:33:52 -07:00
coffeegoddd☕️✨
f1bf098d07 /{cmd,docs,internal}: remove file removal that can cause data corruption 2026-03-31 12:04:55 -07:00
Harry
917c5f6f40 Improve quickstart docs with Why Beads section and --explain examples
- Add 'Why Beads?' section contrasting flat trackers vs dependency-aware ready queue
- Add bd ready --explain example showing full graph reasoning output
- Document bd ready vs bd list --status open distinction
- Add graph check and explain commands to Next Steps section

Fixes: bd-47m

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-30 09:13:16 -07:00
Harry
5d524cf7e9 Add Integration Charter: define scope boundary for tracker integrations
Formally documents what beads tracker integrations will and will not build.
Establishes that integrations are an adoption bridge, not a product.

Explicit out-of-scope: webhooks, cross-tracker orchestration, attachment
sync, comment mirroring, credential vaults, UI parity features.

Includes design guidelines for new integrations and a decision log.

Fixes: bd-9go

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-30 09:12:28 -07:00
REMvisual
bbd6c41a9c Add claude-workspace-snapshot to Claude Code Orchestration 2026-03-28 21:04:19 -07:00
coffeegoddd☕️✨
fb8ff3b46d /{README,cmd}: go back to init 2026-03-28 13:47:20 -07:00
coffeegoddd☕️✨
9134355618 /{README.md,cmd,docs,internal,website}: doc updates 2026-03-28 13:47:20 -07:00
coffeegoddd☕️✨
33eed5d14f /{docs,website}: wip, updating docs 2026-03-28 13:47:20 -07:00
Harry
3ae2ef3a5a feat: multi-project/team support for Linear, Jira, and ADO
Add support for syncing issues across multiple projects/teams in all
three tracker integrations, with shared infrastructure to avoid
duplicating logic.

Shared infrastructure (internal/tracker/multiproject.go):
- ParseCommaSeparated: splits comma-separated config values
- DeduplicateStrings: removes duplicates preserving order
- ResolveProjectIDs: config precedence (CLI > plural > singular)

Linear (closes #2791):
- Tracker: map[string]*Client with per-team routing
- FetchIssues iterates all teams, deduplicates by issue ID
- UpdateIssue routes to owning team via FetchIssueByIdentifier
- Config: linear.team_ids / LINEAR_TEAM_IDS + --team flag

Jira:
- projectKey string → projectKeys []string
- FetchIssues uses JQL IN clause (single query, no iteration)
- Config: jira.projects / JIRA_PROJECTS + --project flag

ADO:
- project string → projects []string
- WIQL uses TeamProject IN clause (single query)
- Config: ado.projects / AZURE_DEVOPS_PROJECTS + --project flag

All singular config keys remain supported for backward compatibility.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-28 13:40:39 -07:00
emma
083181e1ea feat: reimplement Notion sync on REST data sources (fix-merge PR #2759)
Adds internal/notion/ package with direct REST API client, field mapping,
and tracker adapter. Adds bd notion init/connect/status/sync commands.
Enhances tracker engine: conflict detection before pull, label sync,
no-op skip, batch push interface, RFC3339Nano timestamps. Removed dead
matchesFetchOptions function, added gosec nolint for Notion API client.

Co-Authored-By: Osamu Okano <okano.osamu@gmail.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-27 19:20:40 -07:00
zenchantlive
ee811804ab
docs: update BeadBoard listing in COMMUNITY_TOOLS.md 2026-03-26 17:47:56 -07:00
Steve Yegge
9afbe259ae
Merge pull request #2762 from harry-miller-trimble/cleanup/gh-2758-remove-gas-town-terminology
cleanup: remove remaining Gas Town terminology from help text, docs, and comments
2026-03-23 13:17:51 -07:00
Steve Yegge
2a2981a4a8
Merge pull request #2778 from maphew/docs/gh-2707-setup-sync-guide
docs: add sync setup guide for new computers (GH#2707)
2026-03-23 13:17:46 -07:00
Matt Wilkie
b61fe903b1 docs: add sync setup guide for new computers (GH#2707)
Amp-Thread-ID: https://ampcode.com/threads/T-019d1b5c-9a3b-763f-9ad3-6e9fd53a47ae
Co-authored-by: Amp <amp@ampcode.com>
2026-03-23 08:50:19 -07:00
Harry
1067967f0a docs: add Lista Beads VS Code extension to community tools
Add Lista Beads to the Editor Extensions section of COMMUNITY_TOOLS.md.
Full-featured VS Code extension with tree view, dashboard, dependency
graph, CodeLens, wisps/formulas, and multi-tracker sync.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-22 13:56:07 -07:00
Harry
a82d500129 cleanup: remove remaining Gas Town terminology from help text, docs, and comments
Replace Gas Town-specific terminology with generic equivalents across
user-facing help text, documentation, code comments, MCP integration,
and scripts.

Terminology replacements:
- polecat → agent/worker
- witness → observer
- deacon → patrol system
- refinery → processor
- mayor → coordinator
- crew → assistant
- gt (command) → bd
- Gas Town role lists → generic role descriptions

Changes by category:
- User-facing help text (7 files): create.go, state.go, mol_bond.go,
  gate.go, mol_ready_gated.go, memory.go, swarm.go
- Documentation (5 files): dolt-concurrency.md (reframed for standalone
  beads), MOLECULES.md, LABELS.md, CLI_REFERENCE.md,
  CONTRIBUTOR_NAMESPACE_ISOLATION.md
- Code comments (5 files): dolt.go, doctor/artifacts.go,
  fix/artifacts.go, store.go, queries.go, formula/types.go
- MCP integration (2 files): tools.py comments, test docstring
- Scripts (1 file): release.sh

Backwards compatibility: Doctor artifact detection patterns for
polecats/crew/refinery directories are retained with updated comments
noting they exist for orchestrator backwards compatibility. MCP redirect
test paths also retained for the same reason.

Fixes #2758

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-22 13:27:43 -07:00
emma
71a0360cd2 fix(hooks): increase shim timeout from 30s to 300s for chained hooks (GH#2732)
The 30s default was killing legitimate chained pre-commit pipelines
(linters, formatters, type-checkers) before they could complete.
Increase to 300s with BEADS_HOOK_TIMEOUT env var documented as
escape hatch. Users can still Ctrl-C out of truly hung hooks.

PR: #2746

Co-Authored-By: matt wilkie <maphew@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-21 13:58:30 -07:00
emma
9b2c012e7e feat: custom status categories (active/wip/done/frozen)
Add category-aware custom statuses that control behavior in bd ready
and bd list. New config format: bd config set status.custom
"in_review:active,qa_testing:wip,archived:done,on_hold:frozen".
Backward compatible with old flat format. New bd statuses command
lists all statuses with --json support.

Also fix TestKillStaleServersPreservesOtherRepoServers to clear
BEADS_DOLT_AUTO_START env var, since the new IsAutoStartDisabled guard
in killStaleServersForDir short-circuits when set.

PR: #2665

Co-Authored-By: Harry Miller <harry-miller-trimble@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-21 12:35:03 -07:00
garnet
3dae6bb3df refactor: remove gastown/Gas Town string references from beads code and docs (bd-1ue8)
Replace gastown-specific references with generic alternatives throughout
the codebase:

- Rename --gastown flag to --orchestrator in bd doctor
- Rename gastownMode/gastownThreshold params to orchestratorMode/orchestratorThreshold
- Rename isGasTownTownRoot() to isOrchestratorRoot()
- Replace "gastown" in CLI examples with generic rig names (my-project, other-project)
- Update comments replacing "Gas Town" with "orchestrator" or "multi-agent workspace"
- Update active docs (DOLT.md, CONFIG.md, ADVANCED.md, etc.)
- Update test data to use generic names instead of "gastown"
- Update role templates (deacon, witness, refinery) to use generic language

Preserved as historical (not changed):
- CHANGELOG.md entries (historical record)
- ARTICLES.md (links to real published articles)
- info.go version notes (historical release notes)
- gastown/ file path references in dolt-concurrency.md (point to actual repo)
2026-03-20 18:39:50 -07:00
amber
6468766523 fix: remove hardcoded ~/gt/ paths from beads codebase (bd-h615)
Replace ~/gt/ and ~/hop/ hardcoded paths with generic placeholders:
- routes.go comments: use <town-root> and <town> placeholders
- routing_test.go comments: use <town> placeholder
- deacon.md.tmpl: use {{ .TownRoot }} template variable
- witness.md.tmpl: use {{ .TownRoot }} template variable
- docs/DOLT.md: use <town-root> placeholder in example
- scripts/release.sh: reference docs by name, not path
- federation_test.go: reference HOP docs by name, not path

CHANGELOG.md entries left unchanged (historical records).
2026-03-20 18:31:13 -07:00
jade
13a83b080c refactor: make BEADS_ACTOR primary env var, BD_ACTOR deprecated fallback (bd-hm9r)
Simplify actor resolution chain to: --actor > BEADS_ACTOR > BD_ACTOR (deprecated) >
git config user.name > $USER > "unknown". BD_ACTOR still works for backwards compat
but BEADS_ACTOR is now the canonical beads-native env var. Updates all code paths,
tests, and documentation.
2026-03-20 18:30:20 -07:00
beads/crew/emma
5d958d16d2 docs: add claude-handoff to community tools (fix-merge PR #2731)
Session handoff skills for Claude Code with beads integration.
Fixed typo in original PR (stray 'n' prefix).

Co-Authored-By: REMvisual <noreply@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-20 18:29:53 -07:00
beads/crew/emma
0469a9ab18 docs: add Azure DevOps configuration reference
Document ADO config keys (ado.pat, ado.org, ado.project, ado.url),
environment variable mappings, state/type/priority mapping examples,
and pull filter options.

Co-Authored-By: Harry Miller <harry_miller@trimble.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 14:35:32 -07:00
emma
63432acf64 fix: --validate checks --acceptance field, add validation.on-close config (PR #2654)
Three fixes for validation consistency:

1. bd create --validate now uses LintIssue() instead of ValidateTemplate(),
   bringing it to parity with bd lint. A non-empty --acceptance field now
   satisfies the "Acceptance Criteria" requirement without needing the
   heading in --description. (GH#2468 parity)

2. --dry-run no longer bypasses --validate. Validation now runs before the
   dry-run exit, so users get feedback on template issues during preview.

3. New validation.on-close config option (none|warn|error, default: none).
   When enabled, warns on terse close reasons (<20 chars) or default
   "Closed" reasons. Mirrors existing validation.on-create pattern.

Co-Authored-By: seanmartinsmith <114885497+seanmartinsmith@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-18 22:21:23 -07:00
emma
cf8513a2f8 refactor: clean up residual sync.mode references (PR #2661)
Remove all remaining string/comment references to the removed SyncMode type.
Purely cosmetic cleanup with no behavioral changes.

- config.go: remove sync.mode from yamlKeys, update validate help text
- contributor_routing_e2e_test.go: rename TestRoutingWithAllSyncModes to
  TestRoutingWithAllOperationalModes (also fixes unrenamed loop variable)
- kv_test.go: change test case from sync.mode to sync.git-remote
- Comment updates across test helpers and config packages
- TROUBLESHOOTING.md: update example from sync.mode to sync.git-remote
- .gitignore: add .opencode/

Co-Authored-By: Amperstrand <amperstrand@localhost>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-18 12:07:13 -07:00
maphew
6edd905b1b feat(setup): target CLAUDE.md and GEMINI.md for hooks integrations
Amp-Thread-ID: https://ampcode.com/threads/T-019cf2bd-bf1b-7269-abd8-ec65edb98bd5
Co-authored-by: Amp <amp@ampcode.com>
2026-03-15 15:02:52 -07:00
maphew
a0720f2402 feat: prime SSOT tasks 8-12 — init upgrade, recipe cleanup, symlink safety, staleness detection (#2139)
Task 8: bd init now upgrades legacy beads sections to versioned format
instead of silently skipping them. New files created via EmbeddedDefault()
also get versioned markers.

Task 9: Replace stale bd sync references with bd dolt push in recipes
template. Add bd prime SSOT messaging.

Task 10: installAgents resolves symlinks via ResolveForWrite before
reading content. Profile precedence: if file already has full profile
and minimal is requested, full is preserved to avoid information loss.

Task 11: Added tests for staleness detection, profile extraction,
profile precedence, symlink safety, and legacy-to-new migration.
checkAgents now reports stale/current/missing status.

Task 12: Updated SETUP.md with prime SSOT, profiles, and profile
precedence documentation. Updated CLI_REFERENCE.md with --check
behavior and Gemini integration description.

Amp-Thread-ID: https://ampcode.com/threads/T-019ced7a-0c86-708d-930c-ee35d00eda8d
Co-authored-by: Amp <amp@ampcode.com>
2026-03-15 15:02:52 -07:00
maphew
323e813e72 docs: add central Dolt server setup guide for macOS
Add new section to DOLT-BACKEND.md covering:
- Embedded vs central server comparison table
- Why 'brew services start dolt' silently ignores config
- Step-by-step custom LaunchAgent setup with plist
- Environment variables to point beads at central server
- Service management (stop/restart/logs)

Also fix default port from 3306 to 3307 in the server
configuration table to match DefaultSQLPort in code.

Closes #2323

Amp-Thread-ID: https://ampcode.com/threads/T-019ced53-6c5c-71de-8092-b834c879a68a
Co-authored-by: Amp <amp@ampcode.com>
2026-03-15 15:02:52 -07:00
beads/crew/emma
ef59bd00f0 Merge PR #2585: feat: auto-detect beads database on git origin during init/bootstrap
Probe origin for refs/dolt/data during bootstrap and auto-clone
the database if found. bd init warns when existing data is detected.
Eliminates the no-common-ancestor error in fresh clones.

PR: https://github.com/steveyegge/beads/pull/2585
Author: cwalv
2026-03-15 14:07:59 -07:00
beads/crew/emma
14343daeec Merge PR #2621: Harden install trust model and clarify security guidance
Add SHA256 checksum verification to install scripts and reorder
security verification steps in documentation.

PR: https://github.com/steveyegge/beads/pull/2621
Author: maphew
2026-03-15 12:15:38 -07:00
beads/crew/emma
f9a6831247 Merge PR #2613: backup: add fetch-git and clean up JSONL backup docs
Document fetch-git workflow and clean up JSONL backup documentation.
Resolved conflict with UUID migration that removed LastEventID.

PR: https://github.com/steveyegge/beads/pull/2613
Author: turian
2026-03-15 12:15:30 -07:00
beads/crew/emma
549345f7e3 Merge PR #2604: fix: key circuit breaker on host:port instead of port only
Key circuit breaker state files on host:port instead of port only,
preventing cross-host blocking when multiple servers share a port.

PR: https://github.com/steveyegge/beads/pull/2604
Author: trillium
2026-03-15 12:03:40 -07:00
maphew
4d23a6cc7e harden installers and docs for transparent trust model (GH#1857)
Amp-Thread-ID: https://ampcode.com/threads/T-019cf2b7-8afa-717c-abda-e7a8000e1b9b
Co-authored-by: Amp <amp@ampcode.com>
2026-03-15 12:02:56 -07:00
Joseph Turian
6f0e2208ec Add backup fetch-git and git snapshot follow-ups (bd-mtqql) 2026-03-14 23:12:47 -04:00
obsidian
3158495b41 fix: key circuit breaker on host:port instead of port only (bd-ic2)
The circuit breaker was keyed on port number only, causing a breaker
tripped for one host (e.g. localhost:3307) to block connections to a
completely different host on the same port (e.g. 100.111.197.110:3307).

Changes:
- Add host field to circuitBreaker struct
- newCircuitBreaker now takes host+port, file path includes sanitized host
- probe() dials actual host:port instead of hardcoded 127.0.0.1
- Log messages include host:port for better diagnostics
- Add test verifying different hosts have independent breaker state
2026-03-14 14:46:19 -07:00
human
fca3d3cd47 fix: complete UUID primary keys cleanup across codebase
Follow-up to 1ce765ee (UUID primary keys for federation-safe events).
The core migration changed types and schema, but many files still
referenced the old AUTO_INCREMENT design. This commit makes the
codebase internally consistent:

- Update embedded Dolt schema SQL files to use CHAR(36) UUID PKs
- Fix backup restore: json.Number -> string for UUID event/comment IDs
  (fixes TestBackupRestoreRoundTrip)
- Remove dead LastEventID field from backup state (never set)
- Update comments in issueops/create.go, import test, git_remote_test
- Update docs/audit-sync-mode-complexity.md (mark auto-increment resolved)
- Update version history in info.go

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-14 10:12:04 -07:00
cwalv
4d14fb8ce1 feat: auto-detect beads database on git origin during bootstrap
When running `bd bootstrap` in a fresh clone, probe origin for
refs/dolt/data and automatically clone the existing beads database
instead of creating unrelated state. `bd init` warns if the ref
exists and suggests using `bd bootstrap` instead.

Fixes #2580
2026-03-14 00:18:13 -07:00
Steve Yegge
2c5cfcb6e7
Merge PR #2552: docs: replace git-backed with Dolt-powered, document git-free usage
docs: replace "git-backed" with "Dolt-powered", document git-free usage
2026-03-13 17:28:27 -07:00
Pedro Alcocer
19a21ede42 docs: move stale community tools to historical section 2026-03-13 17:10:42 -04:00
cwalv
e31428f053 docs: replace "git-backed" with "Dolt-powered", add git-free usage guide
Beads' storage backend is Dolt, not git. Git integration (hooks, repo
discovery, identity) is optional — `BEADS_DIR` + `--stealth` provides
fully functional git-free operation with zero git calls.

Changes across 15 files:
- Replace all "git-backed" references with "Dolt-powered" or "Dolt-backed"
- Add "Git-Free Usage" section to README.md documenting BEADS_DIR + --stealth
- Fix stale "JSONL" storage reference in llms-full.txt
- Update SKILL.md to mark git as optional prerequisite

Complements GH#2522 (stale command cleanup) — that PR fixed removed
commands, this one fixes misleading storage backend framing.
2026-03-13 11:44:50 -07:00
matt wilkie
6673026068 feat: add --skip-agents flag and branchless/JJ docs (GH#1335)
- Add --skip-agents flag to bd init to skip AGENTS.md and Claude
  settings generation, addressing concern about invasive file modifications
- Add 'Branchless Workflows (Jujutsu / jj)' section to GIT_INTEGRATION.md
  documenting what works without hooks and without branch concepts
- Fix dead link to non-existent docs/JUJUTSU.md in printJJAliasInstructions

Closes #1335

Amp-Thread-ID: https://ampcode.com/threads/T-019ce867-cdd6-77cf-bb69-f8c1af71227a
Co-authored-by: Amp <amp@ampcode.com>
2026-03-13 11:19:10 -07:00
Steve Yegge
e42d222bae
Merge pull request #2526 from maphew/fix/docs-purge-stale-refs
fix(docs): purge stale command/flag refs + add CI doc validation (GH#2522)
2026-03-11 18:20:49 -07:00
Amp
a333dcaa75 fix(docs): purge stale bd sync/import/--branch refs + add CI doc validation (GH#2522)
Systematic cleanup of stale documentation references left over from the
Dolt migration:

- Replace all 'bd sync' → 'bd dolt push' / 'bd dolt pull' across 40+ files
- Replace all 'bd import' → 'bd init --from-jsonl' or remove
- Replace 'bd init --branch' → note about refs/dolt/data separation
- Fix AGENT_INSTRUCTIONS.md (highest impact: agents read this directly)
- Fix npm-package, claude-plugin, integrations, examples, website docs

Add scripts/check-doc-flags.sh to catch stale doc references:
- Checks for removed commands (bd sync, bd import)
- Checks for removed flags (bd init --branch)
- Warns on legacy SQLite/beads.db references
- Compares CLI_REFERENCE.md against bd help --all

Add CI job (check-doc-flags) and Makefile target (check-docs) to gate
PRs against doc freshness.

Prior art: feat/help-doc-generator branch has bd help --doc/--list for
generating docs FROM CLI output. This script validates docs AGAINST CLI
output — complementary approaches.

Amp-Thread-ID: https://ampcode.com/threads/T-019cde77-0722-7353-b63a-1779a5773ca6
Co-authored-by: Amp <amp@ampcode.com>
2026-03-11 13:25:40 -07:00
matt wilkie
f7061f9782
fix(docs): remove stale --branch flag and SQLite refs from QUICKSTART (GH#2522) (#2525)
- Remove bd init --branch beads-sync (flag no longer exists)
- Replace stale ~/.beads/default.db with correct .beads/dolt/ location
- Add outdated-content disclaimer to Community Articles in ARTICLES.md


Amp-Thread-ID: https://ampcode.com/threads/T-019cde55-544a-701a-a0e2-c06dee329d6a

Co-authored-by: Amp <amp@example.com>
Co-authored-by: Amp <amp@ampcode.com>
2026-03-11 12:54:30 -07:00
beads/crew/emma
396c944a5e fix: add shared Dolt server mode for multi-repo/agent setups (GH#2416)
Introduces BEADS_DOLT_SHARED_SERVER mode where multiple beads projects
share a single Dolt server on a fixed port (3308), avoiding per-project
server sprawl. Includes `bd init --shared-server`, `bd dolt shared-*`
commands, doctor checks, and comprehensive tests.

Co-Authored-By: Shybko <shybko@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 17:38:00 -07:00
beads/crew/emma
84494b7e1a cleanup: remove daemon infrastructure remnants (GH#2431)
Remove all BEADS_NO_DAEMON env var handling from test files (dead code
since daemon removal in v0.50.0), delete stopRepoDaemon() and daemon
file guards from test setup, remove no-daemon config key from tests,
and update daemon→server wording in docs and comments.

37 files changed, -193 lines net.

Co-Authored-By: davetashner <davetashner@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 15:24:27 -07:00