beads/docs/core-concepts
Chris Sells 5b660081ed docs: fix fact errors found by adversarial review
Every fix verified against the binary or a traced source call path:

- How Beads Works: parent-child DOES affect ready work (a blocked parent
  blocks its children — the blocked-state SQL inherits it), hash-ID
  inputs are title/description/creator/creation-time plus a collision
  nonce (live generator is internal/idgen, not the legacy one), and
  bead gates dropped from the gates bullet (currently unresolvable).
- Graph-link type strings are hyphenated (relates-to, replies-to);
  underscore forms are rejected by the parser. Fixed corpus-wide
  including the README feature bullet.
- upgrading.md: the version-era table's boundaries were refuted by git
  archaeology (embedded Dolt shipped in v0.60.0 and always used
  .beads/embeddeddolt/; nothing changed at the claimed v0.63.3
  boundary) — replaced with a layout-based identification table.
- Phantom .beads/dolt/sql-server.log path in sync-failures and the FAQ;
  the managed server writes .beads/dolt-server.log.
- FAQ: ID growth matches DefaultAdaptiveConfig (min 3, max 8,
  probability-driven), dependency-type wording no longer claims exactly
  four types, and unmeasured performance figures are hedged instead of
  stated as facts.
- quickstart: bd migrate --cleanup doesn't exist; init installs hooks
  by default (no prompt) and has no merge-driver step; ready output
  quote and bd restore recovery source corrected.
- formulas.md: step types map to issue types (task/bug/feature/epic/
  chore; anything else falls back to task — human/gate are not step
  types), and there is no built-in formula search tier.
- todo.md: bd update takes --set-labels, not --labels.
- graph-links.md: broken #dependencies fragment → #add-dependencies.
2026-07-12 10:37:17 -07:00
..
adaptive-ids.md docs: fix phantom command surfaces in workflow pages 2026-07-12 10:37:07 -07:00
dependencies.md docs: canonical concept page, section overviews, and concept diagrams 2026-07-12 10:37:07 -07:00
graph-links.md docs: fix fact errors found by adversarial review 2026-07-12 10:37:17 -07:00
hash-ids.md docs: canonical concept page, section overviews, and concept diagrams 2026-07-12 10:37:07 -07:00
index.md docs: fix fact errors found by adversarial review 2026-07-12 10:37:17 -07:00
issues.md docs: port user docs into the Mintlify site tree under docs/ 2026-07-12 10:37:07 -07:00
labels.md docs: port user docs into the Mintlify site tree under docs/ 2026-07-12 10:37:07 -07:00
metadata.md docs: port user docs into the Mintlify site tree under docs/ 2026-07-12 10:37:07 -07:00
sync-concepts.md docs: port user docs into the Mintlify site tree under docs/ 2026-07-12 10:37:07 -07:00