Skip to content

[Gastown] Convoy landing review beads have null body and no task progress granularity #1470

@jp-gorman

Description

@jp-gorman

What happened?

Two related issues with system-generated convoy landing review beads:

Issue 1: body: null on system-generated landing review beads
When a convoy completes and the system auto-creates the final landing review bead (e.g. "Review: convoy/[name]/[id]/head"), the bead body is null. The Refinery agent picks this up with zero context — no description of what the convoy contained, no acceptance criteria from the individual beads, no checklist of what to verify. It can only read the git diff and make a best-guess judgment. This means the final review before landing to main is the weakest review in the entire pipeline.

Expected behaviour: The system should auto-populate the convoy landing review bead body with a summary of all tracked beads, their acceptance criteria, and a verification checklist for the Refinery.

Issue 2: status: in_progress provides no sub-task granularity
The bead status field only has coarse states (open, in_progress, in_review, closed). There is no way to tell how far through a task an agent is, what sub-steps have been completed, or what remains. For agents picking up rework on an in_progress bead, there is no persistent checkpoint or task list to resume from.

Expected behaviour: Beads should support some form of progress tracking — either a sub-task checklist, a checkpoint field, or a progress log — so that both users and agents can understand task completion state beyond a single status flag.

Observed example:
Bead 092a7286-6b24-4e35-abe0-537e43b0239a in rig 4cc89b8a-fb8a-47aa-9e0e-235dc0caa57c (GasTown rig, town e7a04a11-2867-4e09-9a4c-b1688909150d) was the convoy landing review bead. It had body: null, status: in_progress with no granularity, and was created by source_agent_id: system with no acceptance criteria carried over from the 2 convoy beads it was reviewing.

Area

Convoys

Context

  • Town ID: e7a04a11-2867-4e09-9a4c-b1688909150d
  • Agent: Mayor (c271e5f2-8a0a-442c-a356-f9537c90e982)
  • Rig ID: 4cc89b8a-fb8a-47aa-9e0e-235dc0caa57c

Recent Errors

Bead 092a7286: body=null, status stuck on in_progress despite closed_at being set, system-generated with no convoy context propagated

Filed automatically by the Mayor via gt_report_bug.

Metadata

Metadata

Assignees

No one assigned

    Labels

    P2Post-launchenhancementNew feature or requestgt:coreReconciler, state machine, bead lifecycle, convoy flowkilo-auto-fixAuto-generated label by Kilokilo-triagedAuto-generated label by Kilo

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions