beads/website/docs/cli-reference/lint.md
matt wilkie 5d6ffc7c37
docs: regenerate CLI reference (fixes doc-flags-freshness after #4613) (#4616)
The hand-port of gastownhall/beads#3759 (PR #4613) added inline help text
to `bd linear sync` but deliberately skipped a docs regen to avoid
pulling in unrelated churn. "Check doc flags freshness" failed on main
afterward because `docs/CLI_REFERENCE.md` and the website CLI reference
pages had also drifted from several other recent merges (new issue types
spike/story/milestone, the `bd unclaim` command, `bd formula schema`
flag, `bd types --sections`) - the freshness check compares the whole
generated doc set, not per-PR.

Regenerated via `./scripts/generate-cli-docs.sh` using a pinned
CGO_ENABLED=0 -tags gms_pure_go build of bd, confirming no federation
churn (identical diff whether generated via the script's own build or
the pinned pure-Go binary). `./scripts/generate-cli-docs.sh --check`
now passes.

Agent-Signature: claude-fable-5-high on behalf of matt wilkie
2026-07-06 23:03:41 -07:00

1 KiB

id title slug sidebar_position
lint bd lint /cli-reference/lint 999

Generated from bd help --doc lint

bd lint

Check issues for missing recommended sections based on issue type.

By default, lints all open issues. Specify issue IDs to lint specific issues.

Section requirements by type: bug: Steps to Reproduce, Acceptance Criteria task: Acceptance Criteria feature: Acceptance Criteria epic: Success Criteria chore: (none)

Examples: bd lint # Lint all open issues bd lint bd-abc # Lint specific issue bd lint bd-abc bd-def # Lint multiple issues bd lint --type bug # Lint only bugs bd lint --status all # Lint all issues (including closed)

bd lint [issue-id...] [flags]

Flags:

  -s, --status string   Filter by status (default: open, use 'all' for all)
  -t, --type string     Filter by issue type (bug, task, feature, epic, decision, spike, story, chore, milestone)