mirror of
https://github.com/gastownhall/beads.git
synced 2026-09-14 20:17:24 +08:00
Chris Sells
4ea6fa3ac0
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).
34 lines
1.3 KiB
Markdown
34 lines
1.3 KiB
Markdown
---
|
|
title: "bd show"
|
|
description: "Show issue details"
|
|
---
|
|
|
|
{/* AUTO-GENERATED: do not edit manually */}
|
|
|
|
Generated from `bd help --doc show`.
|
|
|
|
Show issue details
|
|
|
|
```
|
|
bd show [id...] [--id=<id>...] [--current] [flags]
|
|
```
|
|
|
|
**Aliases:** view
|
|
|
|
**Flags:**
|
|
|
|
```
|
|
--as-of string Show issue as it existed at a specific commit hash or branch (requires Dolt)
|
|
--children Show only the children of this issue
|
|
--current Show the currently active issue (in-progress, hooked, or last touched)
|
|
--id stringArray Issue ID (use for IDs that look like flags, e.g., --id=gt--xyz)
|
|
--include-comments Stream full comment bodies in JSON output (--json only; may be slow on issues with many comments)
|
|
--include-dependents Stream full dependent issues in JSON output (--json only; may be slow on hub beads)
|
|
--local-time Show timestamps in local time instead of UTC
|
|
--long Show all available fields (extended metadata, agent identity, gate fields, etc.)
|
|
--refs Show issues that reference this issue (reverse lookup)
|
|
--short Show compact one-line output per issue
|
|
--thread Show full conversation thread (for messages)
|
|
-w, --watch Watch for changes and auto-refresh display
|
|
```
|