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 orgit 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 invaults/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 givesswamp 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 avault.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 theswamp 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.
Shipped
Click a lifecycle step above to view its details.
Sign in to post a ripple.