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

Relationships

#2399 Docs: document approve-requires-explicit-grant and the implied approve marker

Opened by stack72 · 9/23/2026

Lab #2384 adds an opt-in serve setting that stops a run grant from implying approve. The default is unchanged. The manual (content/manual in swamp-club) needs to describe it.

reference/swamp-serve/authorization.md, section Run implies approve: keep the default explanation. Add that swamp serve --approve-requires-explicit-grant (config auth.approve-requires-explicit-grant, env SWAMP_APPROVE_REQUIRES_EXPLICIT_GRANT) makes only grants that name approve count for deciding a gate. A deny on run still denies approve. Every replica must share the setting. This replaces the per-group deny-approve workaround described there.

reference/swamp-serve/serve-flags.md: add the new flag, config key, and env var (default false; needs auth mode token or oauth).

reference/swamp-serve/access-commands.md: swamp access check and swamp access can-i mark an approve that comes only from a run grant as [implied by run]. can-i without an action lists an implied approve row for such grants. JSON output carries impliedBy on decisions and approveRequiresExplicitGrant on server responses.

02Bog Flow
✓OPEN○TRIAGED○IN PROGRESS◉CLOSED

Closed

9/23/2026, 10:33:27 PM

No activity in this phase yet.

03Sludge Pulse
Editable. Press Enter to edit.

stack72 commented 9/23/2026, 10:33:27 PM

Fixed in https://github.com/swamp-club/swamp-club/pull/1247 — authorization.md documents --approve-requires-explicit-grant (config, env, deny-on-run still denies, every replica must match); serve-flags.md adds the flag/key/env; access-commands.md documents the [implied by run] marker, impliedBy and approveRequiresExplicitGrant.

Sign in to post a ripple.