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

#205 Docs: extension install/pull/update sync-to-manifest behaviour

Opened by stack72 · 5/1/2026

Context

PR systeminit/swamp#1275 (closes #202) changed the behaviour of extension install/pull/update:

  • Before: additive — write new files, leave files from prior versions in place.
  • After: sync to manifest — write new files AND remove files declared in prior versions but absent from the current version (source files, bundle files, and skill directories).

Ask

Update content/manual/reference/ (or wherever the manual covers extension install/pull/update) to:

  1. Describe the new sync-to-manifest behaviour.
  2. Document the user-facing Removed N file(s) no longer in <name>@<version>: log line and the equivalent JSON event so users know what's removed.
  3. Document the new orphanFiles field in the swamp doctor extensions JSON output.
  4. Note that doctor's orphan findings render as warnings (not failures) for now — overallStatus is unchanged by orphan presence.
  5. Call out the migration tip: hand-edited files inside .swamp/pulled-extensions/<name>/ or in skill directories managed by an extension will be removed on the next install/pull/update — users should move them out first.

Reference

systeminit/swamp PR #1275

02Bog Flow
OPENTRIAGEDIN PROGRESSCLOSED

Closed

5/1/2026, 3:57:47 PM

No activity in this phase yet.

03Sludge Pulse
Editable. Press Enter to edit.

stack72 commented 5/1/2026, 3:57:45 PM

Extension of #203 - going to handle it there!

Sign in to post a ripple.