Skip to content

Commit 1e13bb2

Browse files
committed
docs(platform-objects,changeset): the activation ledger's served descriptions cover environment-authored items; the action door's changed answer is named
Claude-Session: https://claude.ai/code/session_014ifLBrKenJNWpsLxhLfhUg Co-authored-by: Claude <noreply@anthropic.com>
1 parent bf3f890 commit 1e13bb2

2 files changed

Lines changed: 4 additions & 4 deletions

File tree

‎.changeset/15204-catalog-activation-environment-authored.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,4 +14,4 @@ Clause-②: yes (widening)
1414
- **The ledger row of an item no package ships carries no package** (`@objectstack/platform-objects`, `@objectstack/core`). `sys_metadata_activation.package_id` is no longer required. It is empty exactly when no package ships the item. It is not part of the row identity (`metadata_type`, `name`), and no reader decides anything from it. The column was already nullable on disk (ADR-0113: `required` is a write-time check), so there is nothing to migrate.
1515
- **One spelling for "no package"** (`@objectstack/core`). `MetadataActivationRow.packageId` is optional. FROM: `packageId: string`, with `''` the only way to say "no package". TO: omit `packageId` for an item no package ships, and the store writes no value. `ObjectStoreMetadataActivationStore.setActive` refuses `packageId: ''` with a `TypeError` before it reads or writes anything, and `list()` returns `packageId` only when the row names a package. If your code passes `''`, omit the key instead.
1616
- **The flow row follows the shared row** (`@objectstack/service-automation`). `FlowActivationRow.packageId` is optional to match. Every flow row still names its package, because the flow toggle refuses a flow no package ships before it writes.
17-
- **Not changed: the action activation door.** `POST /api/v1/actions/_activation/:object/:action` still passes `''` as the package of an action no package ships. That write is still refused and still writes nothing, but by the store's `TypeError` now, so its answer moves from `503 VALIDATION_FAILED` to `503 SERVICE_UNAVAILABLE`. Whether an environment-authored action gets a switch is not decided here.
17+
- **The action activation door's answer for an action no package ships changes; the action is still refused.** `POST /api/v1/actions/_activation/:object/:action` still passes `''` as the package of such an action. The write is still refused and still writes nothing, but the store's `TypeError` refuses it now, with the store's sentence. FROM: `503 VALIDATION_FAILED`. TO: `503 SERVICE_UNAVAILABLE`. An environment-authored action could not be switched on `main` before this change and cannot after it.

‎packages/platform-objects/src/system/sys-metadata-activation.object.ts‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,7 @@ export const SysMetadataActivation = ObjectSchema.create({
7171
isSystem: true,
7272
managedBy: 'engine-owned',
7373
description:
74-
'Activation ledger for packaged metadata artifacts (ADR-0126 §4): one row per packaged artifact whose armed state has been changed from the packaged default. No row means the packaged default — active.',
74+
'Activation ledger for metadata artifacts (ADR-0126 §4): one row per artifact whose armed state has been changed from its default. No row means the default — active. Packaged artifacts and positions or permission sets authored in this environment are both recorded here.',
7575
displayNameField: 'name',
7676
nameField: 'name', // [ADR-0079] canonical primary-title pointer (mirrors deprecated displayNameField)
7777
highlightFields: ['metadata_type', 'name', 'package_id', 'active'],
@@ -130,7 +130,7 @@ export const SysMetadataActivation = ObjectSchema.create({
130130
required: true,
131131
searchable: true,
132132
maxLength: 255,
133-
description: "The packaged artifact's machine name.",
133+
description: "The artifact's machine name.",
134134
group: 'Identity',
135135
}),
136136

@@ -154,7 +154,7 @@ export const SysMetadataActivation = ObjectSchema.create({
154154
active: Field.boolean({
155155
label: 'Active',
156156
defaultValue: true,
157-
description: 'Is the packaged artifact armed for this scope.',
157+
description: 'Is the artifact armed for this scope.',
158158
group: 'State',
159159
}),
160160
},

0 commit comments

Comments
 (0)