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

Relationships

#1925 docs: write enablers/access-control.md design doc

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

Summary

design/primitives/serve.md:185-186 references enablers/access-control.md as the place where principals, grants, subjects, and the can-i request will be documented — but the file doesn't exist yet.

What to document

  • The grant evaluation model: authorization is checked at the serve handler boundary, not at the domain layer
  • Workflow execution context: a run grant on a workflow resource is sufficient for all model method calls within that workflow — individual model grants are not required for workflow-internal steps
  • Grant file schema: actions (plural, array), subject, effect, resource, condition
  • The can-i request flow
  • Principal resolution

Why this matters

A customer asked whether workflow-internal model method calls are authorized against the caller's model grants or the workflow grant. The answer (workflow grant is sufficient) is correct by design but not documented anywhere, leading to confusion and overly broad grant configurations.

🤖 Generated with Claude Code


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

02Bog Flow
OPENTRIAGEDIN PROGRESSSHIPPED+ 1 MOREASSIGNED+ 2 MOREREVIEW+ 7 MOREPR_MERGED+ 2 MORESESSION_SUMMARIZED

Shipped

9/1/2026, 1:28:44 AM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack729/1/2026, 12:44:15 AM

Sign in to post a ripple.