Skip to content

Waiting on a Developer

Josh edited this page Nov 5, 2026 · 1 revision

Describes robot-council/core v0.8.3.

A coordinator records what the fleet is waiting on a developer for -- the ticket it is about, the question and why it matters -- with POST {prefix}/api/owed-items (or owed_record), naming the developer by GitHub login or leaving it out for General. The lane board lists them General first, then one section per developer. An item settles when its ticket closes or loses its hitl label, as GitHub reports them, or with DELETE {prefix}/api/owed-items/{id} (or owed_settle). An item whose developer has left the fleet stops rendering rather than moving to General.

GET {prefix}/api/owed-items (or owed_list) reads them back, oldest first, each with its id, developer (null for General), ticket, question, why and recorded_at (#503). developer narrows it to one login, compared without case; general=true to the items nobody in particular owes, since a login can itself be General; and ticket, as owner/name#N, to one ticket -- so whether a ticket is already listed under a developer is one call before owed_record. The two developer filters together are refused. Settled items are left out unless include_settled=true, which adds settled_at and settled_because (coordinator, ticket_closed or hitl_removed). An item whose developer has left the fleet is left out here too, settled or not, so this read and the board never disagree. All three need coordinator:direct.

Clone this wiki locally