beads/website/docs/cli-reference
matt wilkie b2a4d1d04a
docs: generate CLI reference from live help (#3704)
* docs: generate CLI reference from live help

* docs(cli): move bd version stamp from per-command pages to index only

Drops the `(bd version X.Y.Z)` suffix from the auto-generated header on
every per-command CLI reference page (writeSingleCommandDoc) and the
docs/CLI_REFERENCE.md preamble (writeAllHelp). The version label now
lives only on the index page emitted by scripts/generate-cli-docs.sh:

- Dev tree (website/docs/cli-reference/index.md, docs/CLI_REFERENCE.md):
  labelled "Latest"
- Versioned snapshots (website/versioned_docs/version-X.Y.Z/...):
  labelled with the explicit semver tag parsed from the directory name

This eliminates the 100+-file no-signal diff a release version bump
otherwise produces, restoring the "regen as a separate small commit"
workflow PR #3704 enables. After this change a version bump alone
yields zero diff on the dev tree; only the new versioned snapshot
created at release-cut time carries the new tag. No datestamps are
introduced anywhere — scripts/generate-cli-docs.sh --check remains
deterministic across CI runs.

Refs: mybd-afb, PR #3704

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: CI Bot <ci@beads.test>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 19:43:49 -07:00
..
admin.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
ado.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
assign.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
audit.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
backup.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
batch.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
blocked.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
bootstrap.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
branch.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
children.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
close.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
comment.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
comments.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
compact.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
completion.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
config.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
context.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
cook.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
count.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
create-form.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
create.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
defer.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
delete.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
dep.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
diff.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
doctor.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
dolt.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
duplicate.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
duplicates.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
edit.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
epic.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
export.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
federation.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
find-duplicates.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
flatten.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
forget.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
formula.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
gate.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
gc.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
github.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
gitlab.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
graph.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
history.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
hooks.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
human.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
import.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
index.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
info.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
init-safety.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
init.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
jira.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
kv.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
label.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
linear.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
link.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
lint.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
list.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
mail.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
memories.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
merge-slot.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
migrate.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
mol.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
note.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
notion.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
onboard.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
orphans.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
ping.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
preflight.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
prime.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
priority.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
promote.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
prune.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
purge.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
q.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
query.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
quickstart.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
ready.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
recall.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
remember.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
rename-prefix.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
rename.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
reopen.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
repo.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
restore.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
rules.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
search.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
set-state.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
setup.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
ship.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
show.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
sql.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
stale.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
state.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
status.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
statuses.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
supersede.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
swarm.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
tag.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
todo.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
types.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
undefer.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
update.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
upgrade.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
vc.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
version.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
where.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
worktree.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00