Commit graph

371 commits

Author SHA1 Message Date
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
beads/crew/emma
97e0ee9a30 refactor: remove dead sync mode scaffolding (GH#2485)
Remove SyncMode type, SyncConfig struct, sync trigger constants, and
associated validation/defaults. Active code (ConflictStrategy, FieldStrategy,
Sovereignty tiers, federation) is unchanged.

Co-Authored-By: athosmartins <athosmartins@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 11:48:11 -07:00
furiosa
ba03db09f2 refactor: remove --allow-stale no-op flag and stale docs (w-bd-002)
The 3-way merge engine and staleness checking system were removed in
PR #2369 (staleness.go) and GH#2353 (ConflictStrategy/FieldStrategy).
This removes the final remnants:

- cmd/bd/main.go: Drop hidden no-op --allow-stale flag (4 lines)
- docs/CLI_REFERENCE.md: Remove Staleness Control and Force Import sections
- claude-plugin/skills/beads/resources/CLI_REFERENCE.md: Same
- docs/TROUBLESHOOTING.md: Remove --allow-stale escape hatch guidance,
  update flags table, clean up staleness symptom language

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-08 14:57:31 -07:00
Steve Yegge
9aefaeb5bf
Merge pull request #2457 from weselow/add-community-forks
Community tools addition: beads-web and claude-protocol forks
2026-03-08 14:57:24 -07:00
matt wilkie
e05cd7ed13
docs: replace stale bd sync references with bd dolt push/pull (GH#2442, GH#2435)
Amp-Thread-ID: https://ampcode.com/threads/T-019cce5b-39df-740f-a8e1-5c6b3e389519

Co-authored-by: Amp <amp@ampcode.com>
2026-03-08 10:12:08 -07:00
matt wilkie
0180529edc
Merge pull request #2460 from maphew/fix/stale-migrate-to-dolt-ref
fix: replace stale bd migrate --to-dolt with bd init --from-jsonl (GH#2333)

## Summary

Fixes #2333. The `bd migrate --to-dolt` command was removed in v0.58.0, but three places still referenced it:

- `cmd/bd/init.go` L75-76: deprecation message told users to run removed command
- `cmd/bd/init_test.go` L1886: test assertion matched old string
- `cmd/bd/migrate_test.go` L15: stale comment
- `docs/QUICKSTART.md` L42: quickstart guide recommended removed command

All updated to reference `bd init --from-jsonl`, the current migration path.

## Changes

- **cmd/bd/init.go**: Updated deprecation message from `bd migrate --to-dolt` → `bd init --from-jsonl`
- **cmd/bd/init_test.go**: Updated test assertion to match
- **cmd/bd/migrate_test.go**: Fixed stale comment
- **docs/QUICKSTART.md**: Updated quickstart migration instruction

## Test plan

- [x] `go build ./cmd/bd/` passes
- [x] `go vet ./cmd/bd/` passes
- [x] Relevant test updated to match new output
2026-03-08 10:07:22 -07:00
matt wilkie
cd2f5003f7 fix: replace stale bd migrate --to-dolt with bd init --from-jsonl (GH#2333)
Amp-Thread-ID: https://ampcode.com/threads/T-019cce5b-39df-740f-a8e1-5c6b3e389519
Co-authored-by: Amp <amp@ampcode.com>
Amp-Thread-ID: https://ampcode.com/threads/T-019cce5b-39df-740f-a8e1-5c6b3e389519
Co-authored-by: Amp <amp@ampcode.com>
2026-03-08 10:01:32 -07:00
weselow
3afa9fa5aa docs: add beads-web and claude-protocol to community tools
Add two actively maintained forks to the community tools list:
- beads-web (fork of beads-kanban-ui): cross-platform binaries, 7 themes, Dolt SQL
- claude-protocol (fork of beads-orchestration): rewrite for Claude 4.6, trigger-based rules

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-08 18:35:48 +04:00
Marco Del Pin
b7bd6d6fae fix: replace stale 'bd sync' references with bd dolt push/commit (GH#2435)
bd sync was removed as a command but references persisted in:
- CLI help text (--dolt-auto-commit flag description)
- Code comments (dolt_autocommit.go, init_contributor.go)
- Agent setup generators (aider, cursor, junie, mux)
- Doctor agent remediation commands
- Jujutsu hook alias (init_git_hooks.go)
- Copilot integration docs

All references now point to the current commands:
- bd dolt commit (for committing changes)
- bd dolt push (for pushing to remote)

Tests updated to match.

Complements #2389 (config/sync.mode removal) and #2419 (command removal).
Remaining stale references in other docs tracked in GH#2435.
2026-03-07 17:00:19 +01:00
Rudy Alvarez
df1e6bb08c fix: remove dead 3-way merge config remnants (GH#2353)
Remove ConflictStrategy, FieldStrategy types and all associated config
validation, getters, and tests. The 3-way merge engine was superseded by
Dolt-native cell-level merge. Also adds DOLT_ROOT_HOST=% to test containers
for Docker port-forwarding compatibility.

Co-Authored-By: Rudy Alvarez <rudygt@gmail.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Executed-By: beads/crew/emma
Rig: beads
Role: crew
2026-03-05 15:57:33 -08: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
Steve Yegge
a040a4bd5c
Merge pull request #2356 from fryz/wasteland/w-bd-001-remove-daemon
feat(bd): remove daemon infrastructure
2026-03-05 13:21:52 -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
Peter Chanthamynavong
fff12b2e76
docs(troubleshooting): add circuit breaker and upgrade recovery docs
- Add circuit breaker reset procedure with diagnosis commands for
  state file, port mismatch, and bd dolt status limitation
- Add upgrade recovery flow for pre-Dolt v0.49 to v0.58+ migration
  with reference to scripts/migrate-jsonl-to-dolt.sh
- Update Table of Contents with anchors for both new sections
2026-03-04 13:33:13 -08:00
EC2 Default User
482951258e docs: audit sync mode complexity (w-bd-004)
Comprehensive audit of beads sync subsystem identifying vestigial
SyncMode scaffolding (~180 lines) that can be removed, plus analysis
of federation, conflict resolution, tracker sync engine, and
push/pull routing. Includes prioritized recommendations.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-04 20:15:44 +00: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