Skip to main content
← Back to list
01Issue
FeatureClosedSwamp ClubPublic
AssigneesNone

Relationships

#3312 Docs: extension pull before/after summary, published vs followed channel, and publishedChannel in the lockfile and list

Opened by skunk-ape · 10/12/2026

swamp-club#2877 changes what swamp extension pull and swamp extension list show. Two manual pages need updating once it ships.

reference/extensions/management.md

  • The paragraph saying the lockfile records the installed channel so that update checks stay on it. The lockfile's channel is the channel the install follows, which --channel sets and which defaults to stable. A new publishedChannel field records the channel the registry lists the installed version on. The two differ when an exact version is pulled from another channel, or when the version was promoted after it was pulled.
  • Pull output examples. Before replacing an installed extension, pull now logs a two-line summary. For example: '@x/y: installed 2026.09.23.1 (stable) -> incoming 2026.10.01.1 (beta, following stable)', then 'Upgrade: 2026.10.01.1 is newer than the installed 2026.09.23.1. Channel change: stable to beta.' This appears above the overwrite prompt and under --yes/--force. The prompt also says what y and N do.
  • The list output tag, for example v2026.10.01.1 [beta, following stable], and the publishedChannel field in JSON entries.

how-to/extensions/publish-prerelease.md

  • Pulling an exact beta or rc version without --channel still installs it, but now warns that swamp extension update keeps following stable, and says to pull with --channel beta (or rc) to follow that channel.

JSON fields: the conflict document gains name, current, incoming (each {version, channel, publishedChannel}), change and channelChanged. A successful pull's first document gains channel, publishedChannel, previous, change and channelChanged.

02Bog Flow
✓OPEN○TRIAGED○IN PROGRESS◉CLOSED

Closed

10/14/2026, 12:48:29 AM

No activity in this phase yet.

03Sludge Pulse
Editable. Press Enter to edit.

stack72 commented 10/14/2026, 12:48:29 AM

Fixed in swamp-club#1339: reference/extensions/management covers followed vs publishedChannel, the pull summary and prompt, list tags and the new JSON fields; how-to/extensions/publish-prerelease covers the warning when an exact beta/rc version is pulled without --channel.

Sign in to post a ripple.