Skip to main content
← Back to list
01Issue
BugShippedSwamp CLIPublic
Assigneesstack72

Relationships

#2442 vault not-found errors suggest 'vault create' for names vault create rejects (e.g. _token-secrets)

Opened by stack72 · 9/23/2026· Shipped 9/23/2026

Summary

When a vault is not found and no vaults are configured, swamp vault read-secret, vault list-keys, vault put and vault delete tell the user to run swamp vault create <type> <name> with the name they typed. They do this even when vault create would reject that name. The advice then fails with Invalid vault name.

The most visible case is the reserved control-plane vault:

$ swamp vault read-secret _token-secrets server-token-probe --yes
Error: Vault not found: '_token-secrets'. No vaults are configured.
Create a vault using: swamp vault create <type> _token-secrets

$ swamp vault create local_encryption _token-secrets
Error: Invalid vault name: _token-secrets. Vault names must start with a lowercase letter and contain only lowercase letters, numbers, and hyphens.

Where

  • src/libswamp/vaults/read_secret.ts (not-found branch)
  • src/libswamp/vaults/list_keys.ts (not-found branch)
  • src/libswamp/vaults/put.ts (vaultName not found)
  • src/libswamp/vaults/delete.ts (vaultName not found)

Suggested fix

Only suggest vault create when the name passes the same validation vault create uses. For _-prefixed names, say the name is reserved for swamp's internal vaults instead. VaultService.requireProvider gets this treatment for _token-secrets in the fix for #2437.

Found while fixing #2437.

02Bog Flow
✓OPEN✓TRIAGED✓IN PROGRESS✓SHIPPED+ 1 MOREASSIGNED+ 5 MOREREVIEW+ 6 MOREPR_LINKED+ 2 MORESESSION_SUMMARIZED

Shipped

9/23/2026, 9:37:53 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack729/23/2026, 8:58:38 PM

Sign in to post a ripple.