Commit graph

13 commits

Author SHA1 Message Date
matt wilkie
ec116c46f5
Consolidate docs evidence review inventory
Complete mybd-pnm docs evidence review.\n\n- Add verified docs disposition inventory and canonical seams.\n- Stage stale duplicate docs under docs/staged-for-removal with a manifest.\n- Refresh generated CLI docs and harden the generator for CRLF/stdin handling.\n\nFollow-up: mybd-xfr for automated docs freshness checks.
2026-05-09 07:21:46 -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
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
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
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
Pierre-Alexandre Entraygues
cef38b2dd5 docs(otel): remove absent metrics section from data model appendix
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-28 22:33:59 +01:00
Pierre-Alexandre Entraygues
56a5ae6af2 docs(otel): re-verify data model appendix line numbers against main@371df32b
All line numbers in the Source Reference Audit appendix were stale
(written against the branch commit 986a284c). Re-verified every
reference against main@371df32b:

- retry_count registration: 265 → 302
- lock_wait_ms registration: 269 → 306
- circuit_trips/rejected: remove "on main" qualifier (now the audit ref)
- bd.command span attrs: main.go:266-271 → 262-266
- bd.actor: main.go:478 → 474
- dolt.exec span: 312-318 → 363-368
- dolt.query span: 346-352 → 400-405
- dolt.query_row span: 372-378 → 429-434
- dolt.commit: 913 → 1086
- dolt.push: 1058,1093 → 1231,1266
- dolt.pull: 1122 → 1295
- dolt.merge: 1216 → 1389
- dolt.branch: 1184 → 1357
- dolt.checkout: 1199 → 1372
- hooks_otel.go: 14-25 → 14,20
- haiku.go model/op attrs: 128-131 → 129-130
- haiku.go token attrs: 164-168 → 165-167

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-28 22:33:59 +01:00
Pierre-Alexandre Entraygues
f41397b605 docs(otel): correct data model doc against source code audit
- Add metric naming convention table (SDK dot-notation → Prometheus underscores)
- Move doltserver.* events to roadmap — zero OTel imports in doltserver package
- Clarify hook.exec as span-only (no metric counters or histograms)
- Flag bd.db.lock_wait_ms as registered but never recorded
- Add circuit breaker metrics (bd.db.circuit_trips/rejected)
- Add source reference appendix: every span, metric, and attribute
  backed by file:line to prevent documentation drift
- Correct Init()/Shutdown() signatures to match actual telemetry.go
- Fix SQL span section to reflect actual dolt.query/exec/query_row spans

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-28 22:33:58 +01:00
Pierre-Alexandre Entraygues
8c6375ff13 docs(otel): add OTel architecture and data model design docs
- otel-architecture.md: component overview, implementation status,
  roadmap (Tier 1: trackers/git/doltserver, Tier 2: query/validation,
  Tier 3: command spans/test suite)
- otel-data-model.md: complete event schema for all telemetry signals,
  including new §7 for AI events (compact + find_duplicates),
  AI metrics (bd.ai.input_tokens, bd.ai.output_tokens, bd.ai.request.duration)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-28 22:33:58 +01:00
mayor
397618ece1 docs: update dolt docs with current reality
DOLT.md: fix data location paths to ~/gt/.dolt-data/
dolt-concurrency.md: status from draft to implemented

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-28 10:46:00 -08:00
topaz
062aedbed7 docs: remove stale daemon references from all documentation (GH#1982)
Sweep 65 markdown files across docs/, website/, claude-plugin/, examples/,
integrations/, and root to replace removed `bd daemon` references with
current Dolt server mode equivalents. CHANGELOG.md preserved per policy.

Key replacements:
- `bd daemon start/stop/status` → `bd dolt start/stop` / `bd doctor`
- `bd daemons killall/health/logs` → `bd dolt stop` / `bd doctor`
- `--no-daemon` flag → removed (embedded mode is default)
- `BEADS_NO_DAEMON` / `BEADS_DAEMON_MODE` env vars → removed
- `.beads/bd.sock` → removed
- "daemon mode" / "direct mode" → "server mode" / "embedded mode"
- daemon.pid/daemon.log → .beads/dolt/sql-server.pid/.log

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

Executed-By: beads/polecats/topaz
Rig: beads
Role: polecats
2026-02-22 17:57:53 -08:00
mayor
4766a4f3d9 refactor: remove embedded Dolt server code entirely
Remove all embedded Dolt server spawning, watchdog auto-recovery, and
process management code. Beads now requires a standalone dolt sql-server
(per Tim Sehn's recommendation). The embedded code caused port-hijacking
chaos where watchdog loops respawned rogue servers from .beads/dolt/.

Deleted (6 implementation files):
- internal/storage/dolt/server.go (process spawning)
- internal/storage/dolt/watchdog.go (auto-restart loop)
- internal/storage/dolt/procattr_{unix,windows}.go
- internal/storage/dolt/process_{unix,windows}.go

Deleted (8 test files):
- server_test.go, server_integration_test.go, server_dependency_test.go
- watchdog_test.go, nested_query_test.go
- hub_spokes_integration_test.go, peer_sync_integration_test.go
- cmd/bd/test_dolt_server_test.go

Simplified:
- store.go: removed watchdog fields and start/stop calls
- cmd/bd/dolt.go: removed bd dolt start/stop commands
- doctor/federation.go: replaced GetRunningServerPID with TCP check

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-22 11:55:00 -08:00
beads/crew/collins
8da7f274d6 docs(design): add KV store design for Dolt team review
Inspired by PR #1164 from Piyush Jha (@Hackinet). Groups commands
under 'bd kv' subcommand for cleaner namespacing.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-21 20:39:45 -08:00