Commit graph

22 commits

Author SHA1 Message Date
coffeegoddd☕️✨
44c764e5a3 /{cmd,docs,internal}: more cleanup 2026-03-31 12:33:52 -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
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
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
Joseph Turian
6f0e2208ec Add backup fetch-git and git snapshot follow-ups (bd-mtqql) 2026-03-14 23:12:47 -04: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
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
Steve Yegge
907aca4e5d
Merge pull request #2357 from peterkc/docs/circuit-breaker-troubleshooting
docs: add circuit breaker troubleshooting and clean up stale migration refs
2026-03-05 13:22:10 -08:00
Peter Chanthamynavong
93a934eb88
docs(dolt): deprecate bd migrate --to-dolt in docs
- Replace stale `bd migrate --to-dolt` commands with deprecation
  notes and reference to scripts/migrate-jsonl-to-dolt.sh
- Add TROUBLESHOOTING.md cross-reference for post-migration
  connection errors in both DOLT-BACKEND.md and DOLT.md
2026-03-04 13:37:43 -08:00
dutch
f31acbb892 Remove stale sync mode documentation
Update documentation to reflect that only dolt-native sync mode is supported:

- docs/CONFIG.md: Remove git-portable and belt-and-suspenders references
- docs/DOLT-BACKEND.md: Simplify sync mode section
- FEDERATION-SETUP.md: Remove deprecated sync mode table
- agents.md.tmpl: Update "Git-friendly: JSONL" to "Version-controlled: Dolt"

The sync mode code was already cleaned up (only SyncModeDoltNative is valid
in internal/config/sync.go), but documentation still referenced removed modes.

w-bd-004

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-03-04 12:52:24 -05:00
obsidian
89569b914e feat: add --backend flag to bd init with SQLite deprecation notice (bd-7xj5)
Dolt is now the default (and only) storage backend for bd init. Add a
--backend flag that accepts "dolt" (default) or "sqlite" (prints a
deprecation notice with migration instructions and exits). Unknown
backends produce a clear error.

Update QUICKSTART.md and DOLT-BACKEND.md to reflect that SQLite is no
longer supported and Dolt is the sole backend.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-02 18:33:12 -08:00
Mitesh Ashar
20516a4907 feat(dolt): dual-surface remote management (SQL + CLI)
bd dolt remote add/remove/list now operate on both the SQL server and
filesystem CLI config, ensuring dolt push/pull via CLI can always find
the remote.

- remote add: writes both surfaces, prompts before overwriting
- remote list: shows both surfaces, flags discrepancies
- remote remove: removes both, refuses on URL conflict (--force to override)
- dolt show: includes remotes section
- dolt test: tests remote connectivity (SSH/HTTP)
- doctor: CheckRemoteConsistency in Data & Config, fixable for one-side-only
  (conflicts skipped even with --yes)
- docs: update DOLT-BACKEND.md with dual-surface behavior and refs/dolt/data note

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

Executed-By: beads/crew/emma
Rig: beads
Role: crew
2026-02-28 23:53:39 -08:00
Mitesh Ashar
2b354ffd5e fix(dolt): use CLI fallback for push/pull on SSH remotes (#2118)
CALL DOLT_PUSH/DOLT_PULL through the SQL server times out for SSH
remotes — the MySQL connection drops before the SSH transfer completes.

Detect SSH remote URLs (git+ssh://, ssh://, git@) and shell out to
`dolt push`/`dolt pull` from the database directory instead. Hosted
Dolt, DoltHub, S3, GCS, and file remotes continue using SQL as before.

Also updates DOLT-BACKEND.md to document `bd dolt remote add` (added
in 573bdd1b) instead of the stale `cd .beads/dolt && dolt remote add`
pattern. Remotes added via CLI are not visible to the running SQL
server, causing the "remote 'origin' not found" error in #2118.

Tested with git+ssh:// remotes to GitHub on two standalone repos.
Other remote types (Hosted Dolt, S3, etc.) are untested by this change.

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

Executed-By: beads/crew/emma
Rig: beads
Role: crew
2026-02-28 23:53:39 -08:00
beads/crew/elinor
90da8f6028 docs: remove stale JSONL references from ~73 markdown files (bd-9ni.4)
Replace JSONL storage/sync references with Dolt-native equivalents across
documentation, plugin resources, website docs, agent instructions, and
example READMEs. Preserves legitimate JSONL references (bd import/export
commands, CHANGELOG history, routes.jsonl/interactions.jsonl concepts).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-22 22:18:02 -08:00
beads/crew/emma
bd68c87b00 fix: remove stale embedded Dolt references after server-only migration
Delete broken store_nocgo_test.go (references undefined errNoCGO),
remove dead bootstrapEmbeddedDolt/hasDoltSubdir functions, and clean up
stale comments and docs that still referenced embedded mode, CGO
requirements, or in-process Dolt across 20 files.

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

Executed-By: beads/crew/emma
Rig: beads
Role: crew
2026-02-21 16:59:44 -08:00
beads/crew/emma
5fb306db7b docs: Remove stale daemon/SQLite/JSONL/tombstone documentation for Dolt-native
Phase 9 of dolt-1s40 epic. Remove documentation for features that were
removed in the Dolt-Native Beads v2 migration (Phases 1-8).

Removed files:
- docs/DAEMON.md, docs/daemon-summary.md - daemon architecture docs
- docs/DELETIONS.md - tombstone deletion tracking docs
- docs/SYNC.md - JSONL 3-way merge sync docs
- cmd/bd/doctor/fix/docs.md - tombstone/SQLite doctor docs
- claude-plugin/commands/daemon.md, daemons.md - daemon command refs
- integrations/beads-mcp/SETUP_DAEMON.md - daemon MCP setup
- website/docs/core-concepts/daemon.md - website daemon docs
- website/docs/core-concepts/jsonl-sync.md - website JSONL sync docs
- examples/git-hooks/ - JSONL sync git hooks

Updated files:
- docs/DOLT.md - rewritten for Dolt-only world
- docs/GIT_INTEGRATION.md - rewritten, removed daemon/JSONL/merge driver
- docs/CLI_REFERENCE.md - removed daemon management section
- Fixed broken cross-references to deleted files across 7 docs

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

Executed-By: beads/crew/emma
Rig: beads
Role: crew
2026-02-16 19:19:00 -08:00
Adam D Richman
225ee74929
Fix typo in dolt migrate command
current documentation features an invalid command:
```
$ bd migrate --to=dolt                                                                   
Error: unknown flag: --to
```

The intent was probably `bd migration --to-dolt`.
2026-02-15 18:41:56 -05:00
Peter Chanthamynavong
26ff89405e
test(doctor): verify Dolt data exclusion in doctor gitignore
- Add unit tests for Dolt-specific ignore patterns
- Document manual cleanup steps for committed Dolt data

Coverage: gitignore validation logic in doctor command
2026-02-13 07:45:27 -08:00
Dustin Brown
2c7e2d88af
Revert Dolt lock cleanup workaround; fix embedded Dolt open via driver retries (#1389)
* Revert "fix(dolt): add lock retry and stale lock cleanup for operational reliability (#1260)"

This reverts commit d037158624.

* /{internal,go.mod,go.sum}: bump dolt driver, fix file after revert

* /{go,internal}: fix embedded dolt

* /{docs,internal}: fix path error

* /go.{mod,sum}: bump driver

* /{cmd,.github}: update workflows to pickup go.mod go version, fix lint error

* /.github/workflows/ci.yml: add icu4

* /{cmd,internal}: fix failing tests

---------

Co-authored-by: Test <test@example.com>
2026-01-30 22:25:33 -08:00
groblegark
9b9ef9fdba
docs: add comprehensive Dolt backend guide (#1310)
Add detailed documentation for using Dolt as an alternative storage
backend to SQLite, including:

- Quick start guide with installation instructions
- Server mode vs embedded mode comparison
- Configuration options in metadata.json and config.yaml
- Migration guide from SQLite to Dolt
- AWS S3+DynamoDB remote sync setup
- Performance characteristics and benchmarks
- Troubleshooting common issues

This documentation complements the recently added Dolt test suite
and helps users adopt the Dolt backend for their workflows.

Co-authored-by: upstream_syncer <matthew.baker@pihealth.ai>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 18:00:16 -08:00