* test(cmd/bd): pin the command tree and representative --help output Add two in-process goldens for the bd command surface, so any added, removed, hidden or reworded command or flag fails until the goldens are regenerated and shows up as a reviewed testdata diff: - TestCommandTreeGolden walks the whole cobra tree (hidden commands included) and records, per command, Use, Aliases, Short, Long, Example, group, hidden/deprecated state, runnability and annotations, plus every local and persistent flag it defines (name, shorthand, type, default, usage, hidden, deprecation, annotations). Output is sorted and rendered twice to prove it is deterministic. - TestCommandHelpGolden runs `bd <cmd> --help` through rootCmd for root, create, show, list, update, close, version, versions, config and serve. --help returns before the root pre-run, so no store is opened; color escapes are stripped. The snapshots are byte-identical to a built bd binary's --help output. Both run from a fresh ordinary (dependency-mode) workspace: a .beads/metadata.json with no graph marker and no database behind it. The tree is primed the way the binary is (main()'s help command and its --all/--doc/--list/--docs-root flags, ExecuteC's completion command), and cobra's history-dependent pieces (the lazily added per-command --help flag, the __complete request commands) are excluded, so the result does not depend on which in-process tests ran first. The help runs reset every flag afterwards so a later in-process command does not inherit --help. docs/cli-docs.pin holds check-doc-flags at the v1.2.2 release, so drift on main is not caught there; these goldens are the live guard. They pin the cgo build (the !cgo build swaps in a federation stub). Regenerate with BD_UPDATE_GOLDEN=1 go test -tags gms_pure_go ./cmd/bd -run '^TestCommand(Tree|Help)Golden$'. Agent-Signature: claude-code-claude-opus-5-5-unknown-reasoning on behalf of Julian Knutsen Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> * test(cmd/bd): keep the command goldens from merging flags into the shared tree TestCommandTreeGolden read each command's flags through LocalNonPersistentFlags, and TestCommandHelpGolden dispatches `bd serve --help`. Both run cobra's mergePersistentFlags, which copies every inherited persistent flag (--json, --db, ...) into the command's own flag set for the rest of the process. TestServeFlags pins serveCmd's exact flag set, so it failed whenever a golden test ran before it in the same test binary: tree then serve flags, help then serve flags, and -test.shuffle seeds 2 and 3, on the PR head and on its merge with main. CI passes only because bd_test's 16 Bazel shards happen to run them in different processes. Of 37 candidate tests, TestServeFlags is the only one affected. - goldenLocalFlags reads the set LocalNonPersistentFlags reports without calling it: c.Flags() minus c's own persistent flags and minus inherited copies. Like cobra, it treats a flag as inherited only if it is the nearest ancestor's own *pflag.Flag, so copies left by an earlier in-process execution are skipped and a flag that shadows an inherited one still renders. - TestCommandTreeGolden fails if rendering changes the number of flags in any command's flag set. - TestCommandHelpGolden calls restoreServeGlobals, which re-registers serveCmd's flags after the `bd serve --help` dispatch. Review minors: - The regeneration command (doc comment, failure-message constant, tree.golden header) sets CGO_ENABLED=1. Without cgo the file does not build, so the command matches no test and exits 0. - enterOrdinaryWorkspaceForGolden calls isolateBeadsDirForTest. - renderCommandHelpGolden's comment says when the ANSI strip matters. - cmd/bd/AGENTS.md lists the goldens under "Adding a command" and "Guard tests". Agent-Signature: claude-code-claude-opus-5-5-unknown-reasoning on behalf of Julian Knutsen Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Co-authored-by: Eddie the Engineer <338826946+gascity-eddie[bot]@users.noreply.github.com>
78 lines
7.5 KiB
Text
78 lines
7.5 KiB
Text
Update one or more issues.
|
|
|
|
If no issue ID is provided, updates the last touched issue (from most recent
|
|
create, update, show, or close operation). This fallback only applies in
|
|
interactive sessions (stdin is a terminal); in scripts and agent sessions a
|
|
missing ID is an error, so a command built from an empty variable cannot
|
|
silently mutate an unrelated issue. Set BD_LAST_TOUCHED_FALLBACK=1 to allow
|
|
the fallback anywhere, or =0 to disable it entirely.
|
|
|
|
Updates are applied per issue ID, not atomically across IDs: when some IDs
|
|
fail, the remaining issues are still updated, every failed ID is reported on
|
|
stderr, and the command exits nonzero.
|
|
|
|
Exit codes: 1 for general failures; 13 when every failure is a stale
|
|
--if-assignee/--if-status guard (the precondition no longer held, nothing was
|
|
written — another actor won the race, so retrying the same guard is
|
|
pointless).
|
|
|
|
Usage:
|
|
bd update [id...] [flags]
|
|
|
|
Flags:
|
|
--acceptance string Acceptance criteria
|
|
-l, --add-label strings Add labels (repeatable); -l matches bd create -l
|
|
--allow-empty-description Allow empty description replacement when reading from stdin or file
|
|
--append-notes string Append to existing notes (with newline separator)
|
|
-a, --assignee string Assignee
|
|
--await-id string Set gate await_id (e.g., GitHub run ID for gh:run gates)
|
|
--body-file string Read description from file (use - for stdin)
|
|
--claim Atomically claim the issue (sets assignee to you, status to in_progress; idempotent if already claimed by you; issues assigned to a pool alias listed in the claim.pools config are claimable too)
|
|
--clear-notes Clear the notes field (--notes "" is refused: an empty value is usually a dead command substitution)
|
|
--defer string Defer until date (empty to clear). Issue hidden from bd ready until then, then auto-wakes to open
|
|
-d, --description string Issue description
|
|
--design string Design notes
|
|
--design-file string Read design from file (use - for stdin)
|
|
--due string Due date/time (empty to clear). Formats: +6h, +1d, +2w, tomorrow, next monday, 2025-01-15
|
|
--ephemeral Mark issue as ephemeral (wisp) - not exported to JSONL
|
|
-e, --estimate int Time estimate in minutes (e.g., 60 for 1 hour)
|
|
--external-ref string External reference (e.g., 'gh-9', 'jira-ABC', Linear URL)
|
|
--force Override refusals: let -a/--assignee overwrite another actor's live in_progress claim (use only for abandoned claims — crashed agent, expired lease; prefer bd reclaim), let -s/--status move the issue into closed (or a configured done status) despite open children or a live blocker (same as bd close --force), and let --notes overwrite existing non-empty notes (use --append-notes to preserve history instead)
|
|
-h, --help help for update
|
|
--history Clear no-history flag (re-enable Dolt commit history)
|
|
--if-assignee string Apply the update only if the current assignee equals this value (--if-assignee '' requires unassigned); a mismatch writes nothing and exits 13 (vs 1 for other failures). Requires a field update; cannot combine with --claim
|
|
--if-revision bd show --json Apply the write only if the issue's current revision equals this value (the decimal int64 from bd show --json's "revision" field). One id only: refused before any write when combined with more than one issue id. A mismatch writes nothing and exits 13 (vs 1 for other failures). Composes with --if-assignee/--if-status: all guards present must hold.
|
|
--if-status string Apply the update only if the current status equals this value; a mismatch writes nothing and exits 13 (vs 1 for other failures). Requires a field update; cannot combine with --claim
|
|
--metadata string Set custom metadata (JSON object, or @file.json to read from file)
|
|
--no-history Mark issue as no-history (skip Dolt commits, not GC-eligible)
|
|
--notes string Replace the notes field (requires --force over existing non-empty notes; --clear-notes clears; --append-notes appends instead)
|
|
--parent string New parent issue ID (reparents the issue, use empty string to remove parent)
|
|
--persistent Mark issue as persistent (promote wisp to regular issue)
|
|
-p, --priority string Priority (0-4 or P0-P4, 0=highest)
|
|
--remove-label strings Remove labels (repeatable)
|
|
--session string Claude Code session ID for status=closed (or set CLAUDE_SESSION_ID env var)
|
|
--set-labels strings Set labels, replacing all existing (repeatable)
|
|
--set-metadata stringArray Set metadata key=value (repeatable, e.g., --set-metadata team=platform)
|
|
--spec-id string Link to specification document
|
|
-s, --status string New status
|
|
--stdin Read description from stdin (alias for --body-file -)
|
|
--title string New title
|
|
-t, --type string New type (bug|feature|task|epic|chore|decision|spike|story|milestone); custom types require types.custom config; aliases: enhancement/feat→feature, dec/adr→decision
|
|
--unset-metadata stringArray Remove metadata key (repeatable, e.g., --unset-metadata team)
|
|
|
|
Global Flags:
|
|
--actor string Actor name for audit trail (default: $BEADS_ACTOR, git user.name, $USER)
|
|
--cpu-profile Generate CPU profile for performance analysis
|
|
--database string Run against a different server database for this invocation, without changing the project's configured database (proxied-server mode only)
|
|
--db string Database path (default: auto-discover .beads/*.db). In proxied-server mode, a value that isn't an existing path is treated as a database name override (see --database)
|
|
-C, --directory string Change to this directory before running the command (like git -C)
|
|
--dolt-auto-commit string Dolt auto-commit policy (off|on|batch). 'on': commit after each write. 'batch': defer commits to bd dolt commit; uncommitted changes persist in the working set until then (a live batch-mode bd process also flushes on SIGTERM/SIGHUP, except in proxied-server mode, where bd dolt commit is the only flush point). In proxied-server mode the deferral covers the writes the CLI makes on that route, including config and version metadata; explicit commit points (bd batch, bd mol bond/pour/squash, bd mol wisp create, and the wisp half of bd mol burn) still commit, and a bd serve process on the same database is unaffected. Default: on. Override via config key dolt.auto-commit
|
|
--global Use the global shared-server database (beads_global)
|
|
--ignore-schema-skew Proceed despite forward schema drift (some queries may fail)
|
|
--json Output in JSON format
|
|
--mem-profile string Write heap profile to FILE on exit (also respects BEADS_MEM_PROFILE)
|
|
--no-color Disable color output (also: NO_COLOR=1 or CLICOLOR=0)
|
|
-q, --quiet Suppress non-essential output (errors only)
|
|
--readonly Read-only mode: block write operations (for worker sandboxes)
|
|
--sandbox Sandbox mode: disables Dolt auto-push
|
|
-v, --verbose Enable verbose/debug output
|