Commands

ub-agents report

Agents run report to record the result of a run. Inside a run they use the launcher's own command from UB_AGENTS_REPORT.

$ ub-agents help report
usage: ub-agents report (--outcome OUTCOME | --status {retry,blocked}) --summary SUMMARY [options]

Record a supervised run's explicit result on GitHub. Use inside the launcher-
provided assignment environment; choose --status or --outcome (required). Stop
reports (--status blocked or an outcome adding a configured stop label) require
--action or --option.

options:
  --outcome OUTCOME      declared project outcome; reports success
  --status {retry,blocked}
                         failure verdict; changes no labels
  --summary SUMMARY      explain the result in 1–8000 characters (required)
  --action ACTION        one independent ask that is needed, at most 300
                         characters; repeat for each ask
  --option OPTION        one alternative way to unblock, at most 300 characters;
                         repeat with the recommendation first; append :
                         `COMMAND` for a command block
  --handoff NUMBER       implementation PR number; its head is recorded
  -h, --help             show this help

examples:
  ub-agents report --outcome handed-off --summary "Ready for review" --handoff 150
  ub-agents report --status blocked --summary "Decision pending" --option "Maintainer: use A." --option "Maintainer: use B."