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

Relationships

#481 Docs: update extension-trust reference for swamp-only default + lockfile version pinning (swamp-club#465)

Opened by stack72 · 5/28/2026· Shipped 5/28/2026

Problem

The extension-trust documentation describes the OLD trust model and will be factually wrong once swamp-club#465 ships (default trust narrowed to the swamp collective only; membership collectives now require explicit opt-in; auto-resolve now honors the committed lockfile version pin).

Files and exact changes

content/manual/reference/repository-configuration.md (Trust Configuration)

trustedCollectives:

  • Default: ["swamp", "si"]["swamp"]
  • YAML example: drop si (keep swamp + my-collective)

trustMemberCollectives:

  • Default: truefalse
  • Description: change "When true (or not set), the user's membership collectives are merged with trustedCollectives. When false, only the explicit list is used." to: "When true, the user's membership collectives from their auth credentials are merged with trustedCollectives. When false (or not set), only the explicit list is used."

Add a short note to the Trust Configuration section explaining the security rationale + version pinning (currently undocumented anywhere user-facing):

  • Membership in a collective grants publish access, not install consent — so member collectives are not trusted automatically; trust each explicitly with swamp extension trust add <collective> (or set trustMemberCollectives: true to trust all memberships).
  • Once a collective is trusted, its extensions auto-resolve but are pinned to the version + checksum recorded in the committed upstream_extensions.json lockfile. A trusted collective cannot silently push an updated version; moving versions requires an explicit swamp extension pull / swamp extension update. A drifted checksum fails the install with actionable guidance.

content/manual/explanation/how-swamp-works.md (~line 101)

The sentence about @swamp/aws auto-resolving is still accurate, but add a one-line clarifier that collectives other than the first-party swamp collective must be trusted explicitly (membership does not grant install consent).

Notes

  • Coordinate merge with the swamp CLI fix for swamp-club#465 so docs match released behavior.
  • content/manual/reference/extensions/manifest.md uses "auto-resolved" for local import resolution during packaging — unrelated to collective trust, no change needed.
02Bog Flow
OPENTRIAGEDIN PROGRESSSHIPPED+ 1 MOREASSIGNED+ 5 MOREREVIEW+ 3 MOREPR_MERGED+ 1 MORENOTIFICATION_SKIPPED

Shipped

5/28/2026, 11:25:10 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack725/28/2026, 11:03:25 PM

Sign in to post a ripple.