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

#216 swamp-extension-model skill: include field in upgrades quickref

Opened by 4chems · 5/3/2026

The swamp-extension-model skill's "Version Upgrades" quickref shows the no-op upgrade pattern as:

upgrades: [
  {
    fromVersion: "...",
    toVersion: "...",
    upgradeAttributes: (old) => old,
  },
],

But the validator requires a description: string field on every upgrade entry. Authors who copy from the quickref hit a fairly opaque load-time error on first describe:

Failed to load user model "<name>.ts":
"Error: upgrades.0.description: Invalid input: expected string, received undefined"

Suggested fix: update the quickref's no-op example to include a description field, e.g.:

upgrades: [
  {
    fromVersion: "2026.01.01.1",
    toVersion: "2026.01.02.1",
    description: "No-op upgrade — globalArguments unchanged.",
    upgradeAttributes: (old) => old,
  },
],

references/upgrades.md may already document this, but the quickref is what most authors copy from.

Hit while authoring @4chems/gitlab-runner v2026.05.03.2 today. Also recorded as a learning at https://gitlab.stressmaniacs.com/4chems/apps/control-plane/operations/-/blob/main/docs/learning/swamp-upgrades-entry-requires-description.md

02Bog Flow
OPENTRIAGEDIN PROGRESSCLOSED

Closed

5/3/2026, 10:28:19 PM

No activity in this phase yet.

03Sludge Pulse

Sign in to post a ripple.