Commands: Calls

These commands lock an experiment before its evidence, record a call, confirm a call or a design in your own terminal, and take anything back.

Generated from the --help of rabbit-brain 0.8.0.

rb freeze

lock an experiment’s spec and criteria before the evidence, recorded with who locked it

usage: rb freeze [-h] [--json] [--dry-run] [--amend] [-m WHY] [--words TEXT]
                 experiment

positional arguments:
  experiment

options:
  -h, --help         show this help message and exit
  --json             print one JSON object (the envelope) instead of text
  --dry-run          run every check the write makes and print what it would
                     write, writing nothing; it exits as the write would
  --amend            the experiment is frozen: adopt it as it is now (with
                     --why)
  -m WHY, --why WHY  the reason, recorded with the call
  --words TEXT       the user's words from the chat that this acts on,
                     verbatim (an agent quoting them); kept beside the reason

rb decide

a call on a criterion, an experiment, a question or a setting: accept, reject, investigate; continue, park, stop, pivot, ship. Recorded with who made it and why; in an agent session it is proposed until the user confirms it

usage: rb decide [-h] [--json] [--dry-run] -m WHY [--words TEXT]
                 [--revisit REVISIT] [--past] [--when TEXT]
                 [--source FILE[:LINE]] [--quote TEXT]
                 subject
                 {accept,reject,investigate,continue,park,stop,pivot,ship}

positional arguments:
  subject
  {accept,reject,investigate,continue,park,stop,pivot,ship}

options:
  -h, --help            show this help message and exit
  --json                print one JSON object (the envelope) instead of text
  --dry-run             run every check the write makes and print what it
                        would write, writing nothing; it exits as the write
                        would
  -m WHY, --why WHY     the reason, recorded with the call
  --words TEXT          the user's words from the chat that this acts on,
                        verbatim (an agent quoting them); kept beside the
                        reason
  --revisit REVISIT     when to look again, e.g. "when the new images are in"
  --past                a call made before it was recorded: it reads
                        Retrospective, dated as --when says
  --when TEXT           with --past: when the call was made, as said (a date,
                        or words); unknown without it
  --source FILE[:LINE]  with --past and --quote: the document that states the
                        call; rb says what git shows of it, and a past call
                        from an agent session still waits for rb confirm
  --quote TEXT          with --source: the document's own words that state the
                        call, naming what it is on; rb checks the file holds
                        them

rb confirm

make a call proposed, or a past call mentioned, in an agent session yours, or an experiment’s design one wrote: run in your own terminal; with no id, list what waits

usage: rb confirm [-h] [--json] [--dry-run] [--all] [ID ...]

positional arguments:
  ID          the calls to confirm, as rb status lists them, or
              <experiment>@<hash> for an experiment's design with its gate, as
              rb confirm lists it; an experiment's id alone lists its design

options:
  -h, --help  show this help message and exit
  --json      print one JSON object (the envelope) instead of text
  --dry-run   run every check the write makes and print what it would write,
              writing nothing; it exits as the write would
  --all       confirm every call, gate and design that waits as it reads now,
              after saying each (the command rb confirm ends with confirms
              them as listed)

rb retract

take anything back: it stays on record, stops counting, and rb says what rested on it

usage: rb retract [-h] [--json] [--dry-run] [--scope MEASUREMENT] -m WHY
                  [--words TEXT]
                  subject

positional arguments:
  subject              an id (a note's too), or <experiment>/<setting>

options:
  -h, --help           show this help message and exit
  --json               print one JSON object (the envelope) instead of text
  --dry-run            run every check the write makes and print what it would
                       write, writing nothing; it exits as the write would
  --scope MEASUREMENT  runs only: supersede these measurements (e.g. --scope
                       latency_ms) and keep the rest counting
  -m WHY, --why WHY    the reason, recorded with the call
  --words TEXT         the user's words from the chat that this acts on,
                       verbatim (an agent quoting them); kept beside the
                       reason