Commit graph

10 commits

Author SHA1 Message Date
Chris Sells
789044b83e chore: purge deleted docs-pipeline references from release tooling, CI, and repo plumbing
- beads-release formula: drop the snapshot-docs step (ran the deleted
  scripts/snapshot-release-docs.sh on the critical needs-chain); stamp-
  changelog now needs update-vendorhash
- update-versions.sh: remove the mangled --skip-docs/docs-snapshot logic
  and garbled usage text left by mid-line deletions
- pre-push hook: drop the snapshot-script remediation hint
- release.yml: collapse the prerelease branch; BEADS_REQUIRE_RELEASE_DOCS
  has no consumer since check-docs-version.sh was deleted
- RELEASING.md / scripts/docs.md: describe the current pipeline (no
  --versioned, no website/ outputs, no check-docs-version.sh)
- docs-mintlify.yml: paths filter now includes engdocs/** and the curated
  root markdown files the docsync guard validates
- docs-render-check.sh: pin mint@4.2.687, fail closed when mint dies
  without producing a broken-links report, parse report lines only, drop
  dead extract_page_links(), fix the stale jq requirement; mint.sh pins
  the same version
- nightly.yml: remove the deleted website measurement suite option
- CODEOWNERS: init-safety ADR gate follows the file to engdocs/adr/
- beads-docs skill: align with settled decision 6 — no pointer stubs,
  moved pages get docs.json redirects; bd's printed paths are fixed at
  the source
- CHANGELOG (edited line), FEDERATION-SETUP, README, examples, oracle-a,
  .buildflags, gh-issue-to-pr formula: retarget moved-file references;
  anchor the build/ gitignore pattern
2026-07-12 11:07:26 -07:00
Chris Sells
3198395a32 docs(ci): add Mintlify preview, docsync guard, and broken-links workflow
- mint.sh + make docs-dev: local preview of the docs/ Mintlify site
  (Node 22 handling modeled on the Gas City wrapper).
- test/docsync: Go guard keeping docs/ and docs.json in exact
  correspondence — every nav entry has a file, every page is in the nav
  (tiny stub allowlist for paths released bd binaries print), published
  pages use root-relative extensionless links that resolve, and engdocs/
  plus curated root markdown keep exact GitHub-style paths. Wired into
  make check-docs.
- .github/workflows/docs-mintlify.yml: docsync + baseline-aware
  mint broken-links check on PRs touching docs/**.
- Retire scripts/sync-website-docs.sh and its mirror-drift gate: the six
  mirrored files now live once in the Mintlify site; the committed
  Docusaurus mirrors stay frozen so the parallel-run site keeps building.
- Repoint inbound links to moved docs across README, guides, examples,
  npm-package, plugin resources, and Go comments; add docs/SYNC_CONCEPTS.md
  pointer stub (bd's agent templates print that path). Runtime strings in
  cmd/bd (prime.go, store_factory_nocgo.go, init_git_hooks.go) still print
  old paths — covered by stubs, flagged in the PR.
2026-07-12 10:37:07 -07:00
matt wilkie
c52c23060d
docs: deduplicate release/testing/federation seams (#4660)
Fix four doc-seam duplications (mybd-melg):

1. AGENT_INSTRUCTIONS.md's "Release Process (Maintainers)" duplicated
   RELEASING.md with a divergent 7-step manual process, cited a
   nonexistent ./scripts/update-homebrew.sh, and used a stale 0.9.3
   example. Replaced the section body with a pointer to RELEASING.md.

2. CONTRIBUTING.md's "Testing Guidelines" was a parallel test-running
   guide that never linked docs/TESTING.md, and was self-contradictory
   ("make test" listed as both the fast tier and the full suite;
   described a -short two-tier strategy scripts/test.sh does not
   implement). Cut the command matrix, kept only contributor etiquette
   (what to run before a PR, expectations), and pointed to
   docs/TESTING.md and docs/TESTING_PHILOSOPHY.md.

3. Moved FEDERATION-SETUP.md to docs/FEDERATION.md as the canonical
   federation home. Left a short pointer stub at the root path (inbound
   links from website quickstart pages and llms-full.txt keep
   resolving). Folded DOLT.md's federation section (architecture
   diagram, sync/status/topology commands, credentials) into
   docs/FEDERATION.md, then reduced DOLT.md's section to a summary
   paragraph plus a link. While merging, corrected the stale "Planned
   Features" list (list-peers/sync/status are implemented; only
   single-peer push/pull remain unexposed - bd federation sync already
   covers both directions) and the stale --json output example.
   Added a docs/DOC_INVENTORY.md row for docs/FEDERATION.md.

4. Folded the two divergent hand-maintained "Landing the Plane" /
   session-completion protocols (AGENTS.md, AGENT_INSTRUCTIONS.md) into
   one canonical copy in AGENTS.md - union of the still-true content
   (explicit quality-gate commands, cleanup commands, and the
   next-session hand-off prompt format from AGENT_INSTRUCTIONS.md).
   Reduced the AGENT_INSTRUCTIONS.md copy to a pointer.

Agent-Signature: claude-sonnet-5-high on behalf of matt wilkie
2026-07-08 08:12:46 -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
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
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
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
opal
da8f40b332 chore: audit sync mode complexity — remove stale refs and dead code (bd-shleu)
- Remove stale "realtime" references from comments, docs, and config
  (realtime mode was already removed from valid modes)
- Fix config validation to use actual mode/strategy/sovereignty values
  instead of stale names (local/git-branch/external → git-portable/
  dolt-native/belt-and-suspenders; lww → newest; none/isolated/federated
  → T1/T2/T3/T4)
- Remove 6 dead functions from config.go (IsSyncModeValid,
  IsConflictStrategyValid, IsSovereigntyValid, ShouldExportOnChange,
  ShouldImportOnChange, NeedsDoltRemote) — only used in tests,
  redundant with existing validators in sync.go
- Update tests and docs to match

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

Executed-By: beads/polecats/opal
Rig: beads
Role: polecats
2026-02-19 21:33:22 -08:00
beads/crew/jane
3962285726 chore: clean up stale SQLite references in comments (bd-nlw2m)
Update ~20 stale comments across the Dolt storage layer that still
referenced SQLite after the migration to Dolt-only storage. Rename
LargeSQLite/XLargeSQLite fixture functions to LargeDolt/XLargeDolt.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 11:50:52 -08:00
emma
fa14b9ee24 docs: add federation setup guide (bd-wkumz.7)
Document peer-to-peer Dolt federation setup including:
- Prerequisites and configuration
- Adding peers with bd federation add-peer
- Sync modes (dolt-native, belt-and-suspenders)
- Authentication and security

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-20 23:13:31 -08:00