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

Relationships

#1926 docs: fix grant file examples to use actions (plural array) not action (singular)

Opened by stack72 · 9/1/2026

Summary

The canonical grant file schema uses actions: (plural, array of strings) — defined in src/domain/access/grant_file.ts and src/domain/models/access/grant_model.ts. However, a customer reported that some docs show the singular action: form, which is inconsistent with the schema and could cause silent validation failures.

What to fix

Audit all documentation, examples, and README references for grant file syntax and ensure they use the correct form:

grants:
  - subject: "user:someone"
    effect: allow
    actions: [run]              # always plural, always an array
    resource: "workflow:@acme/*"

The singular action: form is not supported by the Zod schema and should not appear in any docs.

Where to look

  • Any markdown files referencing grant YAML syntax
  • Example grant files in the repo or docs site
  • CLI help text for grant-related commands

🤖 Generated with Claude Code


Automoved by swampadmin from https://github.com/swamp-club/swamp/issues/2331

02Bog Flow
OPENTRIAGEDIN PROGRESSCLOSED+ 1 MOREASSIGNED

Closed

9/1/2026, 1:26:06 AM

No activity in this phase yet.

03Sludge Pulse
stack72 assigned stack729/1/2026, 12:45:02 AM

Sign in to post a ripple.