Skip to content

Commit 5d79f48

Browse files
committed
feat(spec): record the maintainer's rulings in the override classification and basedOn
The maintainer agreed the seven open points on #28404. Two wording changes follow from that ruling: - `OVERRIDE_TYPE_CLASSIFICATION`: `seed`, `datasource`, `tool` and `skill` stay `excluded`, but on a decided basis instead of `undecided`. `adr_0126_one_shot` (seed), `setup_owned_connection` (datasource: ADR-0146 D1 plus ADR-0126 §3 origin-gated) and `behavioural_switch_first` (tool, skill: action's path). The `undecided` basis is gone, and a test pins that no row carries it. - `overrides.basedOn` records the base package's `manifest.version` the override was taken from, not a history version of the item. It is still recorded and never judged. Reference pages regenerated. Co-Authored-By: Claude <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017ihL2fi9zfJhUTubyJYb6V
1 parent e55a4e7 commit 5d79f48

18 files changed

Lines changed: 60 additions & 39 deletions

‎content/docs/references/api/automation-api.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -192,7 +192,7 @@ const result = AutomationApiErrorCode.parse(data);
192192
| Property | Type | Required | Description |
193193
| :--- | :--- | :--- | :--- |
194194
| **package** | `string` | ✅ | The base package id whose same-named item this item replaces whole (e.g. "com.acme.crm"). Only an item of the base's paired "`<base>`.custom" package declares an override. |
195-
| **basedOn** | `string` | ✅ | Recorded, never judged: the version of the base item this override was taken from (e.g. "3.2.0"). No door compares it with the installed base, no upgrade diff is produced from it, and nothing is refused on it; it tells a person re-basing the override where it started (ADR-0146 D2). |
195+
| **basedOn** | `string` | ✅ | Recorded, never judged: the base package's `manifest.version` this override was taken from (e.g. "3.2.0"), not a history version of the item. No door compares it with the installed base, no upgrade diff is produced from it, and nothing is refused on it; it tells a person re-basing the override where it started (ADR-0146 D2). |
196196

197197

198198
---

‎content/docs/references/automation/flow.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -113,7 +113,7 @@ const result = FlowSchema.parse(data);
113113
| Property | Type | Required | Description |
114114
| :--- | :--- | :--- | :--- |
115115
| **package** | `string` | ✅ | The base package id whose same-named item this item replaces whole (e.g. "com.acme.crm"). Only an item of the base's paired "`<base>`.custom" package declares an override. |
116-
| **basedOn** | `string` | ✅ | Recorded, never judged: the version of the base item this override was taken from (e.g. "3.2.0"). No door compares it with the installed base, no upgrade diff is produced from it, and nothing is refused on it; it tells a person re-basing the override where it started (ADR-0146 D2). |
116+
| **basedOn** | `string` | ✅ | Recorded, never judged: the base package's `manifest.version` this override was taken from (e.g. "3.2.0"), not a history version of the item. No door compares it with the installed base, no upgrade diff is produced from it, and nothing is refused on it; it tells a person re-basing the override where it started (ADR-0146 D2). |
117117

118118

119119
---

‎content/docs/references/data/mapping.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,7 @@ const result = ImportFieldMappingSchema.parse(data);
8383
| Property | Type | Required | Description |
8484
| :--- | :--- | :--- | :--- |
8585
| **package** | `string` | ✅ | The base package id whose same-named item this item replaces whole (e.g. "com.acme.crm"). Only an item of the base's paired "`<base>`.custom" package declares an override. |
86-
| **basedOn** | `string` | ✅ | Recorded, never judged: the version of the base item this override was taken from (e.g. "3.2.0"). No door compares it with the installed base, no upgrade diff is produced from it, and nothing is refused on it; it tells a person re-basing the override where it started (ADR-0146 D2). |
86+
| **basedOn** | `string` | ✅ | Recorded, never judged: the base package's `manifest.version` this override was taken from (e.g. "3.2.0"), not a history version of the item. No door compares it with the installed base, no upgrade diff is produced from it, and nothing is refused on it; it tells a person re-basing the override where it started (ADR-0146 D2). |
8787

8888

8989
---

‎content/docs/references/kernel/override-declaration.mdx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ base's paired writable package `<base>.custom` (ADR-0146 D3). An item of that
1313
package that bears a base item's name and carries
1414

1515
```ts
16-
overrides: { package: '<base package id>', basedOn: '<the base item's version>' }
16+
overrides: { package: '<base package id>', basedOn: '<the base package's manifest.version>' }
1717
```
1818
1919
replaces the base's item WHOLE for every read that serves the base's name
@@ -68,7 +68,7 @@ Override declaration (ADR-0146 D2): this item, of the base's paired "`<base>`.cu
6868
| Property | Type | Required | Description |
6969
| :--- | :--- | :--- | :--- |
7070
| **package** | `string` | ✅ | The base package id whose same-named item this item replaces whole (e.g. "com.acme.crm"). Only an item of the base's paired "`<base>`.custom" package declares an override. |
71-
| **basedOn** | `string` | ✅ | Recorded, never judged: the version of the base item this override was taken from (e.g. "3.2.0"). No door compares it with the installed base, no upgrade diff is produced from it, and nothing is refused on it; it tells a person re-basing the override where it started (ADR-0146 D2). |
71+
| **basedOn** | `string` | ✅ | Recorded, never judged: the base package's `manifest.version` this override was taken from (e.g. "3.2.0"), not a history version of the item. No door compares it with the installed base, no upgrade diff is produced from it, and nothing is refused on it; it tells a person re-basing the override where it started (ADR-0146 D2). |
7272
7373
7474
---

‎content/docs/references/system/book.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -80,7 +80,7 @@ const result = BookSchema.parse(data);
8080
| Property | Type | Required | Description |
8181
| :--- | :--- | :--- | :--- |
8282
| **package** | `string` | ✅ | The base package id whose same-named item this item replaces whole (e.g. "com.acme.crm"). Only an item of the base's paired "`<base>`.custom" package declares an override. |
83-
| **basedOn** | `string` | ✅ | Recorded, never judged: the version of the base item this override was taken from (e.g. "3.2.0"). No door compares it with the installed base, no upgrade diff is produced from it, and nothing is refused on it; it tells a person re-basing the override where it started (ADR-0146 D2). |
83+
| **basedOn** | `string` | ✅ | Recorded, never judged: the base package's `manifest.version` this override was taken from (e.g. "3.2.0"), not a history version of the item. No door compares it with the installed base, no upgrade diff is produced from it, and nothing is refused on it; it tells a person re-basing the override where it started (ADR-0146 D2). |
8484

8585

8686
---

‎content/docs/references/system/doc.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,7 @@ const result = DocSchema.parse(data);
7171
| Property | Type | Required | Description |
7272
| :--- | :--- | :--- | :--- |
7373
| **package** | `string` | ✅ | The base package id whose same-named item this item replaces whole (e.g. "com.acme.crm"). Only an item of the base's paired "`<base>`.custom" package declares an override. |
74-
| **basedOn** | `string` | ✅ | Recorded, never judged: the version of the base item this override was taken from (e.g. "3.2.0"). No door compares it with the installed base, no upgrade diff is produced from it, and nothing is refused on it; it tells a person re-basing the override where it started (ADR-0146 D2). |
74+
| **basedOn** | `string` | ✅ | Recorded, never judged: the base package's `manifest.version` this override was taken from (e.g. "3.2.0"), not a history version of the item. No door compares it with the installed base, no upgrade diff is produced from it, and nothing is refused on it; it tells a person re-basing the override where it started (ADR-0146 D2). |
7575

7676

7777
---

‎content/docs/references/system/email-template.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -90,7 +90,7 @@ const result = EmailTemplateDefinitionSchema.parse(data);
9090
| Property | Type | Required | Description |
9191
| :--- | :--- | :--- | :--- |
9292
| **package** | `string` | ✅ | The base package id whose same-named item this item replaces whole (e.g. "com.acme.crm"). Only an item of the base's paired "`<base>`.custom" package declares an override. |
93-
| **basedOn** | `string` | ✅ | Recorded, never judged: the version of the base item this override was taken from (e.g. "3.2.0"). No door compares it with the installed base, no upgrade diff is produced from it, and nothing is refused on it; it tells a person re-basing the override where it started (ADR-0146 D2). |
93+
| **basedOn** | `string` | ✅ | Recorded, never judged: the base package's `manifest.version` this override was taken from (e.g. "3.2.0"), not a history version of the item. No door compares it with the installed base, no upgrade diff is produced from it, and nothing is refused on it; it tells a person re-basing the override where it started (ADR-0146 D2). |
9494

9595

9696
---

‎content/docs/references/system/translation.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -953,7 +953,7 @@ Translation data for a single object
953953
| Property | Type | Required | Description |
954954
| :--- | :--- | :--- | :--- |
955955
| **package** | `string` | ✅ | The base package id whose same-named item this item replaces whole (e.g. "com.acme.crm"). Only an item of the base's paired "`<base>`.custom" package declares an override. |
956-
| **basedOn** | `string` | ✅ | Recorded, never judged: the version of the base item this override was taken from (e.g. "3.2.0"). No door compares it with the installed base, no upgrade diff is produced from it, and nothing is refused on it; it tells a person re-basing the override where it started (ADR-0146 D2). |
956+
| **basedOn** | `string` | ✅ | Recorded, never judged: the base package's `manifest.version` this override was taken from (e.g. "3.2.0"), not a history version of the item. No door compares it with the installed base, no upgrade diff is produced from it, and nothing is refused on it; it tells a person re-basing the override where it started (ADR-0146 D2). |
957957

958958

959959
---

‎content/docs/references/ui/action.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -187,7 +187,7 @@ L2 sandboxed JS body — runs inside an isolated VM with declared capabilities
187187
| Property | Type | Required | Description |
188188
| :--- | :--- | :--- | :--- |
189189
| **package** | `string` | ✅ | The base package id whose same-named item this item replaces whole (e.g. "com.acme.crm"). Only an item of the base's paired "`<base>`.custom" package declares an override. |
190-
| **basedOn** | `string` | ✅ | Recorded, never judged: the version of the base item this override was taken from (e.g. "3.2.0"). No door compares it with the installed base, no upgrade diff is produced from it, and nothing is refused on it; it tells a person re-basing the override where it started (ADR-0146 D2). |
190+
| **basedOn** | `string` | ✅ | Recorded, never judged: the base package's `manifest.version` this override was taken from (e.g. "3.2.0"), not a history version of the item. No door compares it with the installed base, no upgrade diff is produced from it, and nothing is refused on it; it tells a person re-basing the override where it started (ADR-0146 D2). |
191191

192192

193193
---

‎content/docs/references/ui/app.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -324,7 +324,7 @@ Documentation entry on the app menu (ADR-0046). Targets a `book` and/or a `doc`
324324
| Property | Type | Required | Description |
325325
| :--- | :--- | :--- | :--- |
326326
| **package** | `string` | ✅ | The base package id whose same-named item this item replaces whole (e.g. "com.acme.crm"). Only an item of the base's paired "`<base>`.custom" package declares an override. |
327-
| **basedOn** | `string` | ✅ | Recorded, never judged: the version of the base item this override was taken from (e.g. "3.2.0"). No door compares it with the installed base, no upgrade diff is produced from it, and nothing is refused on it; it tells a person re-basing the override where it started (ADR-0146 D2). |
327+
| **basedOn** | `string` | ✅ | Recorded, never judged: the base package's `manifest.version` this override was taken from (e.g. "3.2.0"), not a history version of the item. No door compares it with the installed base, no upgrade diff is produced from it, and nothing is refused on it; it tells a person re-basing the override where it started (ADR-0146 D2). |
328328

329329

330330
---

0 commit comments

Comments
 (0)