beads/docs/reference
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
..
advanced.md docs(events): document the events journal and bd events (bd-opisf) 2026-08-09 01:58:17 +00:00
antivirus.md docs: apply PR #4722 review feedback to user docs 2026-07-12 11:06:57 -07:00
configuration.md docs(config): document claim.pools in the configuration reference (#6607) (#6726) 2026-09-26 04:00:33 -07:00
events-journal.md fix(events): journal delete and cascade dep_remove rows carry the request actor; notice when reading a disabled journal (#5985) (#6061) 2026-08-29 04:14:23 -07:00
faq.md docs(troubleshooting): document the two native-Windows integration traps (#5838) 2026-08-20 05:41:39 -07:00
git-integration.md fix: reject incompatible timeout in generated hooks (#5522) 2026-08-10 20:47:53 -07:00
index.md docs(events): document the events journal and bd events (bd-opisf) 2026-08-09 01:58:17 +00:00
json-schema.md fix(contracts): JSON contract fixes before 1.3.0 freezes them — string revision tokens, --set-metadata scalar typing, create --json nano timestamps (#6053) 2026-08-29 05:20:27 +00:00
observability.md refactor(telemetry): adopt standard OTel SDK env vars with BD_OTEL_* back-compat (#3859) 2026-08-03 00:05:06 -07:00
protected-branches.md docs: apply PR #4722 review feedback to user docs 2026-07-12 11:06:57 -07:00
troubleshooting.md docs(gates): document multi-rig/proxied gate limitations for 1.3.0 (#6052) 2026-08-28 23:23:15 -07:00
worktrees.md docs: apply PR #4722 review feedback to user docs 2026-07-12 11:06:57 -07:00