Skip to main content
← Back to list
01Issue
FeatureShippedSwamp CLIPublic
Assigneeszack

Relationships

#4675 Docs: datastore-configuration vault.get section says extension vault types must be pre-installed

Opened by zack · 11/12/2026· Shipped 11/12/2026

What changed

swamp-club#4671 (swamp PR swamp-club/swamp#3759) changed how datastore config resolves vault.get(...) during early boot:

  • When a vault named in a vault.get() in the datastore config has an extension vault type that is not cached in .swamp/vault-bundles/ (for example on a fresh clone or git worktree), swamp now auto-resolves and installs that vault type from the trusted collectives, as it already does for an extension datastore type. Callers that run installed-only (autoResolve: false) never install.
  • Only vaults actually named in a vault.get() are resolved; other extension vaults in vaults/ are left alone.
  • When the type cannot be installed (collective not trusted, not found, network error), the error now says the vault is defined in vaults/ but its vault type is not installed, and gives swamp extension pull <type>, instead of the misleading "Vault 'X' not found".
  • Cached extension vault bundles now load at early boot even when no other extension has loaded yet.

Page that needs updating

content/manual/reference/datastore-configuration.md, the vault.get section, currently says:

Extension vault bundles are loaded from the .swamp/vault-bundles/ cache during early boot, so the extension must be installed before referencing it in datastore config.

That last clause is now stale.

Suggested content

Extension vault bundles are loaded from the .swamp/vault-bundles/ cache during early boot. If a vault named in a vault.get() has an extension type that is not installed in the checkout, as on a fresh clone or worktree, swamp auto-resolves it from your trusted collectives, as it does for an extension datastore type. If the type cannot be installed, for example because its collective is not trusted, the error names the vault type and the swamp extension pull <type> command to install it.

Optionally link to the extension trust how-to (content/manual/how-to/set-up-extension-trust.md), since trustedCollectives now gates this path.

02Bog Flow
✓OPEN✓TRIAGED✓IN PROGRESS✓SHIPPED+ 2 MORETRIAGE+ 3 MOREREVIEW+ 7 MOREPR_MERGED+ 2 MORESESSION_SUMMARIZED

Shipped

11/12/2026, 4:56:05 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
zack assigned zack11/12/2026, 2:27:25 PM

Sign in to post a ripple.