Skip to main content
← Back to list
01Issue
FeatureShippedSwamp CLI
Assigneesstack72

Relationships

#623 Docs: extension-publish skill guide doesn't cover release channels

Opened by magistr · 6/11/2026· Shipped 6/11/2026

Problem

The release channel feature (beta / rc / stable) shipped in #608 and was documented in the manual in #613 (https://swamp-club.com/manual/how-to/extensions/publish-prerelease). However, the bundled swamp agent skill's extension-publish guide (references/extension-publish/guide.md) still describes only the stable-channel flow and never mentions channels.

Specifically the skill guide is missing:

  • swamp extension push --channel beta|rc (State 7/8 of the publish state machine only show plain push)
  • swamp extension promote <ext> <version> --channel rc|stable [--from-channel]
  • swamp extension pull --channel and the lockfile recording the channel preference
  • swamp extension search --channel (repeatable flag; omitting it returns stable only)
  • latestBeta / latestRc fields in swamp extension info output

An agent following the skill state machine will always publish straight to stable and has no way to discover the prerelease workflow.

Proposed solution

Add a 'Release channels' section to the extension-publish skill guide (or a note in States 7–8) covering push --channel, promote, channel-aware pull/search, and linking the manual page above.

Alternatives

Leave the skill as-is and rely on swamp help extension discovery — but the skill explicitly instructs agents to follow its state machine, so the channel flags stay effectively invisible.

02Bog Flow
OPENTRIAGEDIN PROGRESSSHIPPED+ 1 MOREASSIGNED+ 2 MOREREVIEW+ 3 MOREPR_MERGED+ 1 MORECONTRIBUTOR_NOTIFIED

Shipped

6/11/2026, 8:07:27 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack726/11/2026, 6:42:04 PM
Editable. Press Enter to edit.

stack72 commented 6/11/2026, 8:07:43 PM

Thanks @magistr for reporting this! The fix has been merged and a release is on its way. We appreciate your contribution to swamp.

Sign in to post a ripple.