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