Skip to content

Commit 2e575f1

Browse files
committed
chore(spec): cite the sibling retirement by its D3 id, not a tracker number that no longer resolves
Co-authored-by: Claude <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Rjy9MeetSfq34PKn81CRiN
1 parent 6f95c58 commit 2e575f1

3 files changed

Lines changed: 12 additions & 8 deletions

File tree

‎packages/spec/src/migrations/entries/retired-keys/18.api__RestApiConfig__responseFormat.ts‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,8 +9,9 @@
99
// `retiredKey()` tombstone (a bare deletion would strip the key silently), the
1010
// ledger row stays `dead` with a REMOVED note, and there is no D2 conversion: a
1111
// `RestServerConfig` is plugin TS configuration, never a stack collection member
12-
// or a `sys_metadata` row — the `api/RestServerConfig:openApi31` and #14691
13-
// precedent. D3 semantic entry `rest-api-config-dead-keys-retired`. Registered
12+
// or a `sys_metadata` row — the `api/RestServerConfig:openApi31` precedent, and
13+
// the `rest-server-config-dead-keys-retired` one on the four sibling
14+
// sub-objects. D3 semantic entry `rest-api-config-dead-keys-retired`. Registered
1415
// under 18 for the launch-window reason its neighbours state.
1516
//
1617
// `responseFormat` is retired WHOLE — `envelope`, `includeMetadata` and

‎packages/spec/src/migrations/entries/semantic/18.rest-api-config-dead-keys-retired.ts‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,9 @@ import type { SemanticMigration } from '../../types.js';
88
// `api/RestApiConfig:responseFormat` and `api/RestApiConfig:documentation.enabled`
99
// — four ledger keys, since `responseFormat` retires whole with its three
1010
// members. No D2 conversion: a `RestServerConfig` is plugin TS configuration,
11-
// never a stack collection member or a stored row (the #14691 precedent on the
12-
// four sibling sub-objects), so this entry is where the prescription reaches
11+
// never a stack collection member or a stored row (the
12+
// `rest-server-config-dead-keys-retired` precedent on the four sibling
13+
// sub-objects), so this entry is where the prescription reaches
1314
// `os migrate meta`, the upgrade guide and `spec-changes.json`.
1415
export const entry: SemanticMigration = {
1516
id: 'rest-api-config-dead-keys-retired',

‎packages/spec/src/migrations/registry.ts‎

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -13308,8 +13308,9 @@ const step18: MigrationStep = {
1330813308
// `api/RestApiConfig:responseFormat` and `api/RestApiConfig:documentation.enabled`
1330913309
// — four ledger keys, since `responseFormat` retires whole with its three
1331013310
// members. No D2 conversion: a `RestServerConfig` is plugin TS configuration,
13311-
// never a stack collection member or a stored row (the #14691 precedent on the
13312-
// four sibling sub-objects), so this entry is where the prescription reaches
13311+
// never a stack collection member or a stored row (the
13312+
// `rest-server-config-dead-keys-retired` precedent on the four sibling
13313+
// sub-objects), so this entry is where the prescription reaches
1331313314
// `os migrate meta`, the upgrade guide and `spec-changes.json`.
1331413315
{
1331513316
id: 'rest-api-config-dead-keys-retired',
@@ -16979,8 +16980,9 @@ export const RETIRED_KEYS_BY_MAJOR: Readonly<Record<number, readonly string[]>>
1697916980
// `retiredKey()` tombstone (a bare deletion would strip the key silently), the
1698016981
// ledger row stays `dead` with a REMOVED note, and there is no D2 conversion: a
1698116982
// `RestServerConfig` is plugin TS configuration, never a stack collection member
16982-
// or a `sys_metadata` row — the `api/RestServerConfig:openApi31` and #14691
16983-
// precedent. D3 semantic entry `rest-api-config-dead-keys-retired`. Registered
16983+
// or a `sys_metadata` row — the `api/RestServerConfig:openApi31` precedent, and
16984+
// the `rest-server-config-dead-keys-retired` one on the four sibling
16985+
// sub-objects. D3 semantic entry `rest-api-config-dead-keys-retired`. Registered
1698416986
// under 18 for the launch-window reason its neighbours state.
1698516987
//
1698616988
// `responseFormat` is retired WHOLE — `envelope`, `includeMetadata` and

0 commit comments

Comments
 (0)