Skip to content

Commit fa5dcbd

Browse files
committed
spec: the rename prescription carries no version word; a history comment keeps its era's name
- The allowOrgOverride tombstone's prescription reads "was renamed to `allowEnvironmentOverlay` (ADR-0131 D6)": the changeset ships this as major on the 18.0.0-next line, so naming an npm major there contradicts one of the two. The TSDoc's "in 18" names the protocol major and stays. The refusal pin and the generated reference follow. - sys-metadata-repository.ts: the comment recording commit ee58392 names the key that commit rolled back, `allowOrgOverride`. Claude-Session: https://claude.ai/code/session_01KNKBCRDJCu5tGy3TEbvtrF Co-authored-by: Claude <noreply@anthropic.com>
1 parent c0d91e9 commit fa5dcbd

4 files changed

Lines changed: 5 additions & 5 deletions

File tree

‎content/docs/references/kernel/metadata-plugin.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -269,7 +269,7 @@ const result = MetadataBulkResultSchema.parse(data);
269269
| **filePatterns** | `string[]` | ✅ | Glob patterns to discover files of this type |
270270
| **supportsOverlay** | `boolean` | optional (default: `true`) | Whether a stored overlay row of an item a managed package ships may be removed through the ordinary delete door without the type's environment-overlay permission: the removal removes no managed definition, and changes what is served for permission alone; it opens no save and it decides no read |
271271
| **allowEnvironmentOverlay** | `boolean` | optional (default: `false`) | Whether an environment may overlay an item of this type that a managed package ships (ADR-0131 D6 regime O). Decides the save door, the managed-content seal on write and on read, and Studio's write gate; the OS_METADATA_WRITABLE hatch does not reach a managed item. Default false. |
272-
| **allowOrgOverride** | `never` | optional | [REMOVED] `MetadataTypeRegistryEntry.allowOrgOverride` was renamed to `allowEnvironmentOverlay` in @objectstack/spec 17 (ADR-0131 D6) — the per-organization overlay axis was retired, and the key now names the one scope it governs: whether an environment may overlay an item of this type that a managed package ships. Rename the key to `allowEnvironmentOverlay`; the value is unchanged. |
272+
| **allowOrgOverride** | `never` | optional | [REMOVED] `MetadataTypeRegistryEntry.allowOrgOverride` was renamed to `allowEnvironmentOverlay` (ADR-0131 D6) — the per-organization overlay axis was retired, and the key now names the one scope it governs: whether an environment may overlay an item of this type that a managed package ships. Rename the key to `allowEnvironmentOverlay`; the value is unchanged. |
273273
| **allowRuntimeCreate** | `boolean` | optional (default: `true`) | Allow runtime creation via API |
274274
| **supportsVersioning** | `boolean` | optional (default: `false`) | Whether version history is tracked |
275275
| **executionPinned** | `boolean` | optional (default: `false`) | Transaction rows reference a specific version_hash; history GC is disabled and getByHash() MUST resolve old hashes (ADR-0009) |

‎packages/metadata-protocol/src/sys-metadata-repository.ts‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2031,7 +2031,7 @@ export class SysMetadataRepository implements MetadataRepository {
20312031
* kernel (`environmentId === undefined`) skips the protocol's own two-tier
20322032
* block entirely and lands here instead. That made it the second of the two
20332033
* refusal points #6960 measured: on an environment carrying an overlay row
2034-
* authored BEFORE commit ee58392e1 rolled `allowEnvironmentOverlay` back to
2034+
* authored BEFORE commit ee58392e1 rolled `allowOrgOverride` back to
20352035
* `false`, the row kept merging overlay-wins at read time while the ordinary
20362036
* "Reset to package default" answered 403 — the removal reachable only
20372037
* through `OS_METADATA_WRITABLE`. Maintainer ruling, 2026-08-10: the delete

‎packages/spec/src/kernel/metadata-plugin.zod.ts‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -314,8 +314,8 @@ const MetadataTypeRegistryEntryBaseSchema = z.object({
314314
* `undefined`, which closes every type. Read `allowEnvironmentOverlay`.
315315
*/
316316
allowOrgOverride: retiredKey(
317-
'`MetadataTypeRegistryEntry.allowOrgOverride` was renamed to `allowEnvironmentOverlay` in '
318-
+ '@objectstack/spec 17 (ADR-0131 D6) — the per-organization overlay axis was retired, and '
317+
'`MetadataTypeRegistryEntry.allowOrgOverride` was renamed to `allowEnvironmentOverlay` '
318+
+ '(ADR-0131 D6) — the per-organization overlay axis was retired, and '
319319
+ 'the key now names the one scope it governs: whether an environment may overlay an item '
320320
+ 'of this type that a managed package ships. Rename the key to `allowEnvironmentOverlay`; '
321321
+ 'the value is unchanged.',

‎packages/spec/src/kernel/metadata-type-registry-allow-org-override-retirement.test.ts‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ describe('MetadataTypeRegistryEntry.allowOrgOverride is renamed to allowEnvironm
5656
expect(issue!.path).toEqual(['allowOrgOverride']);
5757
// The prescription IS the migration doc for whoever hits it.
5858
expect(issue!.message).toMatch(
59-
/`MetadataTypeRegistryEntry\.allowOrgOverride` was renamed to `allowEnvironmentOverlay` in @objectstack\/spec 17/s,
59+
/`MetadataTypeRegistryEntry\.allowOrgOverride` was renamed to `allowEnvironmentOverlay` \(ADR-0131 D6\)/s,
6060
);
6161
expect(issue!.message).toMatch(/Rename the key to `allowEnvironmentOverlay`; the value is unchanged/s);
6262
// `false` is refused exactly like `true`: the key is gone, not one value of it.

0 commit comments

Comments
 (0)