beads/docs
Vishnu J d4ed0c7cbd
docs(config): document claim.pools in the configuration reference (#6607) (#6726)
claim.pools shipped with pool-aware claiming (#4843) and is described in
`bd config docs` (cmd/bd/config.go:78-88) and on `bd update --claim`, but
docs/reference/configuration.md never mentions it, so a reader of the
published configuration page cannot find the key or learn where its
value has to live.

Add a claim.pools row to the Project-Level Settings (Database) table and
a short "Claim Pools" subsection at the end of that section. Each
statement follows the code on main:

- The value is read only from the database config table
  (ClaimPoolAliasesInTx -> GetConfigInTx, internal/storage/issueops/
  claim.go:310-315, config_metadata.go:25-35; cmd/bd/show_unit_helpers.go:58,70).
  A config.yaml value is listed by `bd config show` as (config.yaml) but
  does not make an alias claimable.
- Entries are comma-split and whitespace-trimmed (ParseClaimPools,
  claim.go:323-331); membership is an exact, case-sensitive string match
  (claim.go:91, internal/validation/issue.go:217).
- A pool-assigned issue is claimed through the normal CAS, which grants
  the normal lease (claim.go:91, :202).
- Real-actor and unlisted-alias assignees keep anti-steal protection.
- `bd assign` / `bd update --assignee` skip the reassign fence for a
  pool-held in_progress issue (validation/issue.go:217; cmd/bd/assign.go:76,
  cmd/bd/update.go:504).
- `bd ready --claim` claims only unassigned issues (claim.go:256).
- An expired lease is reclaimed to open with no assignee
  (internal/storage/issueops/lease.go:759), not back to the pool alias.

Fixes #6607

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 04:00:33 -07:00
..
architecture fix(gc): flatten/compact run full GC after the rewrite; bd gc --full; low-reclaim hint (#5907) (#6057) 2026-08-29 05:19:06 +00: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 docs: supersedes is a replacement link, not a version chain (#6212) 2026-09-12 06:41:33 -07:00
diagrams docs: port the Excalidraw diagram pipeline (machinery only) 2026-07-12 10:37:17 -07:00
getting-started fix(schema,docs): make the shared data-behind consent step runnable (#6692) 2026-09-23 05:46:48 -07:00
images docs: port user docs into the Mintlify site tree under docs/ 2026-07-12 10:37:07 -07:00
integrations docs: document ado.reconcile_interval and inventory every storage span 2026-08-07 21:20:41 +00:00
multi-agent fix(reclaim): correct the heartbeat re-home invariant's scope in the new docs (wy-sp2l4) 2026-08-13 04:30:30 -07:00
recovery fix(schema,docs): make the shared data-behind consent step runnable (#6692) 2026-09-23 05:46:48 -07:00
reference docs(config): document claim.pools in the configuration reference (#6607) (#6726) 2026-09-26 04:00:33 -07:00
workflows docs(gates): document multi-rig/proxied gate limitations for 1.3.0 (#6052) 2026-08-28 23:23:15 -07:00
cli-docs.pin chore(release): forward-port v1.2.2 to main (version record, retracts, recovery guide, gate record) (#5782) 2026-08-14 21:45:02 -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 Beads Dashboard to Editor Extensions in community-tools.md (#5336) 2026-08-07 05:55:02 -07:00
docs.json chore(release): forward-port v1.2.2 to main (version record, retracts, recovery guide, gate record) (#5782) 2026-08-14 21:45:02 -07:00
index.md release: prep v1.3.0 — version bump, changelog rollup, release process docs, formula fixes (#6038) 2026-08-30 22:19:35 -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