Skip to content

Commit ee5587b

Browse files
committed
docs(#29594): the ensure door refuses a kernel package; a platform set's copy lands environment-wide
Co-Authored-By: Claude <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01L9qibzCo6pa7SSUFmosQD8
1 parent 1340933 commit ee5587b

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
@@ -111,7 +111,9 @@ capability changes only with a new version of the package that declares it. An
111111
sentence names that type's own route. What the reads then serve is in
112112
[Metadata lifecycle](/docs/concepts/metadata-lifecycle#customizing-an-installed-package-the-paired-custom-override-adr-0146).
113113
`POST /packages/hotcrm/ensure-customization` creates the pair when absent (Studio calls
114-
it on the first change), and `GET /packages/hotcrm/customizations` lists its overrides,
114+
it on the first change); a kernel package (scope `system` or `cloud`) has no pair in this
115+
version and answers `409 RESOURCE_CONFLICT`, though a pair an earlier version created keeps
116+
serving what it holds. `GET /packages/hotcrm/customizations` lists its overrides,
115117
extensions and switched-off items in one read, beside `contributions`: the fields (kind `field`)
116118
and flows (kind `flow`) other installed packages contribute to `hotcrm`'s objects, and the
117119
navigation items (kind `nav`) they contribute to `hotcrm`'s apps, each entry naming its package.

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

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -453,7 +453,11 @@ the source never reach the copy.
453453
package `<X>.custom`, the package that holds everything you changed about X.
454454
The pair is created on the first copy, by the same ensure door as
455455
`POST /api/v1/packages/:id/ensure-customization` (its only creation path),
456-
and reused after. A copy of a set already in a writable package is
456+
and reused after. A copy of a set the platform itself ships (a kernel
457+
package of scope `system` or `cloud`, such as `member_default`) is saved
458+
environment-wide, in no package: a kernel package has no paired
459+
customization package in this version, and the notice says so
460+
(`noticeCode` `PERMISSION_SET_CLONE_ENVIRONMENT_WIDE_KERNEL_SOURCE`). A copy of a set already in a writable package is
457461
saved in that package, and a copy of a set authored in this system stays
458462
environment-wide, in no package. With `package`, the copy is saved there: it
459463
must be an installed, writable package (else `422`

0 commit comments

Comments
 (0)