* 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.
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>
- 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>
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>
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>
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>
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>
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>
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)
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).
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.
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>
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>
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>
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>
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>
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
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
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
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>
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
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.
- 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>
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>
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>