bob capture-task-sections¶

List the ALL-CAPS direct-child section bullets of one task in a routed Bob note.

The command is read-only and reports every qualifying section in document order with its original title, whitespace-free slug, line, child count, and depth. It uses the same parent-task lookup and error messages as `bob capture`: a missing, duplicated, or non-task block ID is an error, as is a stale or ambiguous --task-ref. A resolved task with no sections returns a successful empty list so picker callers can skip the chooser.

Exactly one of -i/--block-id or -t/--task-ref is required. Use --block-id when the parent already has an ID, and --task-ref for the stale-safe picker ref from `bob capture-complete` or `bob capture-tasks`.

Usage: bob capture-task-sections [OPTIONS]

Options:
  -i, --block-id <ID>
          Block ID of the parent task

  -b, --bob-dir <DIR>
          Bob vault root; defaults to BOB_DIR or ~/bob

  -f, --format <FORMAT>
          Output format: human or json

          [default: human]
          [possible values: human, json]

  -h, --help
          Show help

  -r, --route <NAME>
          Route/name of the note that contains the task

  -t, --task-ref <REF>
          Stale-safe task ref from capture-complete or capture-tasks

Examples:
  bob capture-task-sections --route foo --block-id bar
  bob capture-task-sections -r foo -i bar -f json
  bob capture-task-sections -r cash -t 12:abcd1234
  bob capture-task-sections -b ~/bob -r project-alpha -i goog-exit

Environment:
  BOB_DIR                    Bob vault root when --bob-dir is omitted