beads/docs/cli-reference
Chris Sells 4ea6fa3ac0 docs(emitter): emit Mintlify CLI reference and generated docs.json nav
bd help --docs-root now additionally writes docs/cli-reference/ in Mintlify
form (frontmatter title as H1, extensionless root-relative links, JSX
auto-generated markers since Mintlify parses .md through MDX) and rewrites
the CLI Reference pages array inside docs/docs.json via a textual splice
that leaves the rest of the file byte-identical — the ~113 nav entries are
never hand-maintained. The Docusaurus outputs (docs/CLI_REFERENCE.md,
website/docs/cli-reference/, versioned snapshots) are unchanged.

generate-cli-docs.sh --check seeds docs/docs.json and docs/cli-reference/
into its scratch root and diffs both; check-cli-docs-drift.sh adds them to
GEN_PATHSPECS and the regeneration fingerprint; docs-autofix-push.sh
allowlists the new generated paths; check-doc-flags.sh scans the new
docs/ subdirectories and requires command coverage in docs/cli-reference/.

Includes the initial docs/docs.json scaffold (nav mirrors the Docusaurus
sidebar IA) and the generated docs/cli-reference/ pages.

TDD: new emitter behavior covered in cmd/bd/help_all_test.go
(Mintlify page format, nav splice correctness + idempotence, bare-root
generation without docs.json).
2026-07-12 10:37:07 -07:00
..
admin.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
ado.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
assign.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
audit.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
backup.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
batch.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
blocked.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
bootstrap.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
branch.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
children.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
close.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
comment.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
comments.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
compact.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
completion.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
config.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
context.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
cook.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
count.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
create-form.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
create.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
defer.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
delete.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
dep.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
diff.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
doctor.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
dolt.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
duplicate.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
duplicates.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
edit.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
epic.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
export.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
federation.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
find-duplicates.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
flatten.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
forget.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
formula.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
gate.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
gc.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
github.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
gitlab.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
graph.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
heartbeat.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
history.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
hooks.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
human.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
import.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
index.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
info.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
init-safety.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
init.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
jira.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
kv.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
label.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
linear.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
link.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
lint.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
list.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
mail.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
memories.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
merge-slot.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
metrics.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
migrate-personal.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
migrate.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
mol.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
note.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
notion.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
onboard.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
orphans.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
ping.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
preflight.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
prime.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
priority.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
promote.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
prune.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
purge.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
q.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
query.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
quickstart.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
ready.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
recall.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
reclaim.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
recompute-blocked.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
remember.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
rename-prefix.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
rename.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
reopen.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
repo.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
restore.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
rules.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
search.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
set-state.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
setup.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
ship.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
show.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
sql.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
stale.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
state.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
status.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
statuses.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
supersede.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
swarm.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
tag.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
todo.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
types.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
unclaim.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
undefer.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
update.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
upgrade.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
vc.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
version.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
where.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
worktree.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00