Skip to content

Commit b7e2eaf

Browse files
committed
docs(permissions): the walled package refusal on the package delete and permission-set provenance pages
Co-Authored-By: Claude <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015JgoXpZUGtNxnMDvRZsKzP
1 parent 0d0a420 commit b7e2eaf

2 files changed

Lines changed: 8 additions & 2 deletions

File tree

‎content/docs/api/metadata-api.mdx‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -123,7 +123,9 @@ Get package details.
123123

124124
### `DELETE /packages/:id`
125125

126-
Uninstall a package.
126+
Uninstall a package. Under a `group` or `isolated` tenancy posture, a package
127+
holding positions or permission sets is the platform operator's to delete: any
128+
other caller is refused `403 PERMISSION_DENIED` (ADR-0131 D3).
127129

128130
### `PATCH /packages/:id/enable`
129131

‎content/docs/permissions/permission-sets.mdx‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -348,7 +348,11 @@ position/user bindings, and its pending audience-binding suggestions in the
348348
same request (no ghost grants); the uninstall response reports the revocation
349349
under `data.persisted.cleanups` (the dispatcher's `/packages` domain answers
350350
the route, and it nests the protocol's uninstall report under `persisted`).
351-
Environment-authored sets and other packages' rows survive.
351+
Environment-authored sets and other packages' rows survive. Under a `group` or
352+
`isolated` tenancy posture, removing a package that carries positions or
353+
permission sets is the platform operator's (ADR-0131 D3): that delete, and an
354+
`install-local` install, upgrade or uninstall of such a package, refuse any
355+
other caller `403` before anything changes.
352356

353357
## One authoritative store — the record is a projection (ADR-0094)
354358

0 commit comments

Comments
 (0)