Skip to main content
← Back to list
01Issue
FeatureShippedSwamp CLIPublic
Assigneesskunk-ape

Relationships

#4988 stagecraft examples: the release gate says which SHA goes in commit and which in mergeCommit

Opened by skunk-ape · 11/21/2026· Shipped 11/21/2026

Problem

In the shipped example factories (build-swamp-extension, openapi-models, starter), the release stage's gate checks evidence["release"].payload.commit == artifacts["change-summary"].payload.commit, with the message "the release must ship the reviewed commit".

When the change lands by rebase or squash, the landed commit differs from the reviewed one. An agent that records the landed SHA in release.commit is refused, and the message doesn't say which field takes which SHA. In a reported case the agent first concluded the change needed a fresh review, then worked out by trial that commit takes the reviewed SHA and the landed SHA goes elsewhere.

build-swamp-extension already has a mergeCommit field for the landed commit, but neither the schema nor the gate message says so, and the other examples' release evidence may not have it.

Proposed

  • Describe the release evidence fields in each example's schema: commit is the reviewed head (change-summary's commit); the merged, squashed or rebased commit that landed goes in mergeCommit.
  • Reword the gate message to say the same, for example: "release.commit must be the reviewed head (change-summary's commit); record the commit that landed in mergeCommit".
  • Make the three examples consistent about where the landed commit goes.

Done when

  • An agent reading only the stage's description, schema and gate message can tell which SHA goes in which field.
  • The three examples agree, validate, and their walkthrough docs match.
02Bog Flow
✓OPEN✓TRIAGED✓IN PROGRESS✓SHIPPED+ 1 MOREASSIGNED+ 2 MOREREVIEW+ 7 MOREPR_MERGED+ 2 MORESESSION_SUMMARIZED

Shipped

11/21/2026, 10:33:33 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
skunk-ape assigned skunk-ape11/21/2026, 9:44:10 PM

Sign in to post a ripple.