beads/docs
Steve Yegge 8bb0d36be0
docs(recovery): fold squash-window lessons into the history-squash runbook (bd-gpgdy) (#5176)
Three operational lessons from the July squash windows, in generic terms:

- Git-backed remotes never shrink on force-push: the remote manifest keeps
  every historical table file listed as current, so the store must be
  replaced in place — delete refs/dolt/data and the __dolt_remote_info__
  branch on the git remote, then force-push a fresh store (verified on two
  production remotes: 587M->57.8M and 274M->2.6M reachable).

- Sync jobs and writers are separate switches: a peer's sync job stays off
  until that machine has verifiably re-cloned; unfencing writers must not
  implicitly re-arm peer sync (the re-pollution hole hit twice).

- First push from a re-cloned machine is far larger than a routine tick;
  timeout-capped sync jobs orphan partial uploads — one manual uncapped
  push before handing back to the schedule.

Gates: go test ./test/docsync PASS, check-doc-freshness.sh PASS.

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-07-30 18:05:31 -07:00
..
architecture docs: align user docs and CLI reference with the v1.1.0 release (#4874) 2026-07-17 14:17:28 -07:00
cli-reference docs(pipeline): pin the CLI docs to the released bd; repair main's broken CLI reference (#4876) 2026-07-17 18:03:28 -07:00
core-concepts Rename the reserved "graph" mermaid node id so diagrams render (#4958) 2026-07-23 17:14:09 -07:00
diagrams docs: port the Excalidraw diagram pipeline (machinery only) 2026-07-12 10:37:17 -07:00
getting-started [codex] Add Kiro setup recipe (#4535) 2026-07-27 22:28:43 -07:00
images docs: port user docs into the Mintlify site tree under docs/ 2026-07-12 10:37:07 -07:00
integrations [codex] Add Kiro setup recipe (#4535) 2026-07-27 22:28:43 -07:00
multi-agent fix(leases): keep node_id off the committed config; tighten the replica guard (wy-jpd3.7) 2026-07-25 02:32:31 -07:00
recovery docs(recovery): fold squash-window lessons into the history-squash runbook (bd-gpgdy) (#5176) 2026-07-30 18:05:31 -07:00
reference docs: remove stale 8-char prefix limit claim from rename-prefix help (GH#770) (#4813) 2026-07-26 12:29:39 -07:00
workflows docs: apply PR #4722 review feedback to user docs 2026-07-12 11:06:57 -07:00
cli-docs.pin docs(pipeline): pin the CLI docs to the released bd; repair main's broken CLI reference (#4876) 2026-07-17 18:03:28 -07:00
CLI_REFERENCE.md docs(pipeline): pin the CLI docs to the released bd; repair main's broken CLI reference (#4876) 2026-07-17 18:03:28 -07:00
community-tools.md docs: add Beadazzle to Native Apps in community-tools.md (#4735) 2026-07-26 12:28:50 -07:00
docs.json [codex] Add Kiro setup recipe (#4535) 2026-07-27 22:28:43 -07:00
index.md docs: align user docs and CLI reference with the v1.1.0 release (#4874) 2026-07-17 14:17:28 -07:00
RECOVERY.md docs(recovery): reduce the stub to a pure pointer 2026-07-17 18:56:33 -07:00
related-projects.md docs: apply PR #4722 review feedback to user docs 2026-07-12 11:06:57 -07:00