Skip to content

Commit 309e2f3

Browse files
committed
fix(spec): os migrate meta guidance for twenty-four more migration-entry families states each lesson in words, not tracker numbers (stage 8)
The stack-, evaluated-, aggregation-, authoring-, automation-, cache-, tenant-, client-, spec-, cli-, identity-, import-, tool-, advanced-, cloud-, startup-, sys-, declarative-, sort-, address-, packages-, platform-, session- and strategy- ADR-0087 semantic entries: every tracker, decision-batch and summon number in replacement / reason / acceptanceCriteria, and in the two surface fields that carried one, is rewritten to say what the cited ruling, measurement or fix decided. ADR ids and contributor-guide rule numbers stay. Text only; the registry, spec-changes.json and the upgrade guide are regenerated. The migrate-meta guidance pin covers the twenty-four prefixes and its REWRITTEN floor rises 174 -> 203. Claude-Session: https://claude.ai/code/session_01Sfe5YjBLwB9J3y8fvm2xq1 Co-authored-by: Claude <noreply@anthropic.com>
1 parent f11b5f2 commit 309e2f3

34 files changed

Lines changed: 549 additions & 315 deletions
Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
---
2+
'@objectstack/spec': patch
3+
---
4+
5+
fix(spec): `os migrate meta` guidance for twenty-four more migration-entry families — `stack-*`, `evaluated-*`, `aggregation-*`, `authoring-*`, `automation-*`, `cache-*`, `tenant-*`, `client-*`, `spec-*`, `cli-*`, `identity-*`, `import-*`, `tool-*`, `advanced-*`, `cloud-*`, `startup-*`, `sys-*`, `declarative-*`, `sort-*`, `address-*`, `packages-*`, `platform-*`, `session-*` and `strategy-*` — states each lesson in words instead of citing tracker numbers
6+
7+
Clause-②: no
8+
9+
The ADR-0087 semantic entries of these twenty-four families are printed by `os migrate meta`
10+
as the header, `why:` and `verify:` lines of a manual change. Their text sent the reader to
11+
issue-tracker, pull-request, decision-batch and summon numbers — some of which no longer
12+
resolve, and some in another repository or a vendor's tracker — for what a ruling,
13+
measurement or fix had decided; it now says what was decided, in the sentence being read.
14+
ADR ids are kept, and so are the rule numbers of this repository's own contributor guide.
15+
16+
Two entries also carried a tracker number in `surface`, the header line itself:
17+
`authoring-schemas-strict-unknown-keys` now names the unknown-key strictness wave, and
18+
`evaluated-expression-slots-source-required` names the census of engine-evaluated slots.
19+
One sentence is corrected while being rewritten: `cli-command-contribution-retired` said the
20+
`manifest.contributes.commands` tombstone was protocol 17; it is registered under protocol 18.
21+
22+
Text only: no entry id, `from` / `to`, conversion or matching logic changes, and the chain
23+
rewrites exactly what it rewrote before. The generated migration registry,
24+
`spec-changes.json` and the protocol upgrade guide carry the same text.

‎docs/protocol-upgrade-guide.md‎

Lines changed: 12 additions & 12 deletions
Large diffs are not rendered by default.

‎packages/cli/test/migrate-meta-engine-guidance.test.ts‎

Lines changed: 40 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,13 @@
88
* `metadata-*`, `rest-*`, `analytics-*`, `view-*`, `package-*`, `object-*`,
99
* `sharing-*`, `audit-*`, `flow-*`, `http-*`, `inline-*`, `actor-*`, `hot-*`,
1010
* `external-*`, `query-*`, `delete-*`, `etl-*`, `storage-*`, `apimethod-*`,
11-
* `dashboard-*`, `notification-*`, `record-*`, `runtime-*`, `rls-*`, `scim-*`)
12-
* states each lesson in words and carries no tracker number.
11+
* `dashboard-*`, `notification-*`, `record-*`, `runtime-*`, `rls-*`, `scim-*`,
12+
* `stack-*`, `evaluated-*`, `aggregation-*`, `authoring-*`, `automation-*`,
13+
* `cache-*`, `tenant-*`, `client-*`, `spec-*`, `cli-*`, `identity-*`,
14+
* `import-*`, `tool-*`, `advanced-*`, `cloud-*`, `startup-*`, `sys-*`,
15+
* `declarative-*`, `sort-*`, `address-*`, `packages-*`, `platform-*`,
16+
* `session-*`, `strategy-*`) states each lesson in words and carries no
17+
* tracker number.
1318
*
1419
* ## What this pins
1520
*
@@ -87,6 +92,10 @@ const COVERED_PREFIXES = [
8792
'actor-', 'hot-', 'external-', 'query-', 'delete-', 'etl-', 'storage-',
8893
'apimethod-', 'dashboard-', 'notification-', 'record-', 'runtime-', 'rls-',
8994
'scim-',
95+
'stack-', 'evaluated-', 'aggregation-', 'authoring-', 'automation-', 'cache-',
96+
'tenant-', 'client-', 'spec-', 'cli-', 'identity-', 'import-', 'tool-',
97+
'advanced-', 'cloud-', 'startup-', 'sys-', 'declarative-', 'sort-', 'address-',
98+
'packages-', 'platform-', 'session-', 'strategy-',
9099
];
91100

92101
/**
@@ -101,6 +110,9 @@ const REWRITTEN = [
101110
'action-engine-facade-find-query-envelope',
102111
'action-session-roles-to-positions',
103112
'actor-user-roles-to-positions',
113+
'address-location-value-unknown-keys-refused',
114+
'advanced-plugin-lifecycle-config-retired',
115+
'aggregation-node-distinct-retired',
104116
'analytics-authorable-unknown-keys-refused',
105117
'analytics-date-range-array-two-bounds-required',
106118
'analytics-query-request-envelope-retired',
@@ -112,6 +124,14 @@ const REWRITTEN = [
112124
'apimethod-enum-shrink',
113125
'audit-log-action-enum-retired',
114126
'audit-log-action-restore-retired',
127+
'authoring-schemas-strict-unknown-keys',
128+
'automation-flow-list-route-retired',
129+
'automation-runs-cursor-retired',
130+
'cache-warmup-scheduled-strategy-retired',
131+
'cli-command-contribution-retired',
132+
'client-delete-result-success',
133+
'client-meta-reset-result-reset',
134+
'cloud-subpath-retired',
115135
'dashboard-header-modal-target-page-only',
116136
'dashboard-widget-chart-config-structure-refused',
117137
'dashboard-widget-compareto-offset',
@@ -134,6 +154,7 @@ const REWRITTEN = [
134154
'datasource-config-url-userinfo-refused',
135155
'datasource-credentialsref-mongo-composed-no-username-refused',
136156
'datasource-credentialsref-mongo-url-no-user-refused',
157+
'declarative-apis-endpoints-live',
137158
'delete-by-id-before-hook-repoint-retired',
138159
'driver-aggregate-undeclared-key-aliases-removed',
139160
'driver-capabilities-inert-bits-removed',
@@ -151,6 +172,7 @@ const REWRITTEN = [
151172
'engine-find-formula-order-by-refused',
152173
'engine-update-upsert-retired',
153174
'etl-pipeline-layer-retired',
175+
'evaluated-expression-slots-source-required',
154176
'export-axis-opt-in',
155177
'export-field-meta-constraints-retired',
156178
'export-job-family-retired',
@@ -185,6 +207,8 @@ const REWRITTEN = [
185207
'hot-reload-watch-placeholder-retired',
186208
'http-request-errors-total-retired',
187209
'http-server-runtime-vocabulary-retired',
210+
'identity-api-key-schema-retired',
211+
'import-run-automations-declared-default-corrected',
188212
'inline-grid-column-currency-scale-refused',
189213
'kernel-compatibility-matrix-estimated-migration-time-unit-in-key',
190214
'kernel-context-preview-mode-retired',
@@ -209,6 +233,8 @@ const REWRITTEN = [
209233
'package-install-request-unknown-keys-refused',
210234
'package-rollback-response-retired',
211235
'package-uninstall-explicit-all-tenants',
236+
'packages-list-pagination-retired',
237+
'platform-timezone-columns-iana-domain-refused',
212238
'plugin-activation-events-retired',
213239
'plugin-auto-restart-never-reinitialised',
214240
'plugin-manifest-contributes-dead-members-retired',
@@ -236,9 +262,18 @@ const REWRITTEN = [
236262
'rls-predicate-stored-list-ordering-refused',
237263
'runtime-httpserver-wrapper-retired',
238264
'scim-provider-object-retired',
265+
'session-payload-positions-security-axis',
266+
'session-user-language-retired',
239267
'sharing-execution-context-retired',
240268
'sharing-rule-recipient-reconcile',
269+
'sort-node-direction-rejected',
270+
'spec-type-alias-input-suffix-retired',
271+
'stack-themes-carrier-retired',
272+
'stack-top-level-unknown-keys-refused',
273+
'startup-orchestrator-retired',
241274
'storage-service-list-retired',
275+
'strategy-context-aggregation-method-narrowed',
276+
'sys-account-issuer-retired',
242277
'system-cache-durations-unit-in-key',
243278
'system-collaboration-durations-unit-in-key',
244279
'system-failover-health-check-interval-unit-in-key',
@@ -249,6 +284,9 @@ const REWRITTEN = [
249284
'system-tracing-otel-exporter-durations-unit-in-key',
250285
'system-tracing-span-duration-unit-in-key',
251286
'system-worker-queue-rate-limit-duration-unit-in-key',
287+
'tenant-schema-cache-ttl-unit-in-key',
288+
'tenant-timeouts-unit-in-key',
289+
'tool-requires-confirmation-retired',
252290
'ui-cloud-connection-widgets-unknown-keys-refused',
253291
'ui-form-field-length-malformed-refused',
254292
'ui-form-field-precision-scale-integer-refused',

0 commit comments

Comments
 (0)