Merge remote-tracking branch 'origin/main' into claude/issue-21828-loader-one-hash

Author: claude

packages/spec/src/data/default-value-shape.test.ts

@@ -22,7 +22,7 @@ import {
 } from './default-value-shape';
 import { DEFAULT_VALUE_TOKENS } from './default-value-tokens';
 
-describe('#7127 discriminateDefaultValueShape — engine-parity classification', () => {
+describe('discriminateDefaultValueShape — engine-parity classification', () => {
   const CASES: Array<{ label: string; dv: unknown; shape: DefaultValueShape }> = [
     // ── Expression envelopes: the engine's structural predicate, verbatim ────
     { label: 'canonical CEL envelope', dv: { dialect: 'cel', source: 'today()' }, shape: 'expression' },
@@ -87,7 +87,7 @@ describe('#7127 discriminateDefaultValueShape — engine-parity classification',
   });
 });
 
-describe('#7127 checkLiteralDefaultValue — the shared stored-form literal check', () => {
+describe('checkLiteralDefaultValue — the shared stored-form literal check', () => {
   it('refuses a literal that cannot satisfy the stored contract, with the contract\'s own detail', () => {
     const v = checkLiteralDefaultValue({ type: 'number' }, 'abc');
     expect(v.ok).toBe(false);
@@ -130,7 +130,7 @@ describe('#7127 checkLiteralDefaultValue — the shared stored-form literal chec
   // also be wrong. Each case below asserts BOTH halves: the prescription is
   // present, AND the half that was being shown instead is gone. Without the
   // second the pin cannot see a regression back to the positional read.
-  it('#16077 prefers the rename over a MISSING-member type error (location)', () => {
+  it('prefers the rename over a MISSING-member type error (location)', () => {
     const v = checkLiteralDefaultValue({ type: 'location' }, { latitude: 1, longitude: 2 });
     expect(v.ok).toBe(false);
     // Positionally this rejection reads
@@ -148,7 +148,7 @@ describe('#7127 checkLiteralDefaultValue — the shared stored-form literal chec
     // discarding it cost the author the whole thing.
   });
 
-  it('#16077 prefers the rename over a WRONG-TYPED-member error (address)', () => {
+  it('prefers the rename over a WRONG-TYPED-member error (address)', () => {
     const v = checkLiteralDefaultValue({ type: 'address' }, { street: 5, postal_code: '98101' });
     expect(v.ok).toBe(false);
     // Every member of `address` is optional, which rules out a MISSING-member
@@ -158,7 +158,7 @@ describe('#7127 checkLiteralDefaultValue — the shared stored-form literal chec
     expect(v.detail).not.toContain('expected string, received number');
   });
 
-  it('#16077 leaves the already-correct case exactly as it was (the asymmetry is gone)', () => {
+  it('leaves the already-correct case exactly as it was (the asymmetry is gone)', () => {
     // No member error to sort ahead, so this one was always right. Pinning it
     // beside the two above is what states the property: the diagnosis no
     // longer depends on whether an unrelated member happened to also be wrong.
@@ -169,7 +169,7 @@ describe('#7127 checkLiteralDefaultValue — the shared stored-form literal chec
     expect(unlucky.detail).toContain('`postal_code` \u2192 `postalCode`');
   });
 
-  it('#16077 is a NO-OP for a class that cannot emit `unrecognized_keys`', () => {
+  it('the rename preference is a NO-OP for a class that cannot emit `unrecognized_keys`', () => {
     // The sweep over all sixteen classes `valueSchemaFor(def, 'stored')`
     // covers found only `location` and `address` backed by a `strictObject`,
     // so only they can emit the issue the preference looks for. For the other

packages/spec/src/data/default-value-tokens.test.ts

@@ -12,7 +12,7 @@ import {
   isAppResolvedDefaultToken,
 } from './default-value-tokens.js';
 
-describe('defaultValue runtime tokens (#4560)', () => {
+describe('defaultValue runtime tokens — one vocabulary the engine and the DDL both read', () => {
   it('declares the complete family, and every member is described', () => {
     expect([...DEFAULT_VALUE_TOKENS]).toEqual(['NOW()', 'current_user']);
     for (const token of DEFAULT_VALUE_TOKENS) {

packages/spec/src/data/document.test.ts

@@ -235,7 +235,7 @@ describe('ESignatureConfigSchema', () => {
   // pin, the tsc `never` channel and the ADR-0087 registration — lives in
   // `esignature-deadline-keys-retirement.test.ts`; these two are the family
   // tests' one-line refusal witnesses (the #14477 house shape).
-  it('REFUSES an authored `expirationDays` — a retiredKey() tombstone since #14477 (ADR-0049)', () => {
+  it('REFUSES an authored `expirationDays` — a retiredKey() tombstone, since nothing ever read it (ADR-0049)', () => {
     const wellFormed = {
       provider: 'custom',
       signers: [{ email: 'test@example.com', name: 'Test', role: 'Test', order: 1 }],
@@ -252,7 +252,7 @@ describe('ESignatureConfigSchema', () => {
     expect(parsed).not.toHaveProperty('expirationDays');
   });
 
-  it('REFUSES an authored `reminderDays` — a retiredKey() tombstone since #14477 (ADR-0049)', () => {
+  it('REFUSES an authored `reminderDays` — a retiredKey() tombstone, since nothing ever read it (ADR-0049)', () => {
     const wellFormed = {
       provider: 'docusign',
       signers: [{ email: 'test@example.com', name: 'Test', role: 'Test', order: 1 }],

packages/spec/src/data/driver-nosql.test.ts

@@ -372,7 +372,7 @@ describe('NoSQL Driver Protocol', () => {
 // never on a bare `toThrow()`. The shape is not strict, so without the
 // tombstone a query authored with `timeout` would have run with NO deadline at
 // all — the failure a driver timeout exists to prevent — and reported nothing.
-describe('NoSQLQueryOptions.timeout carries its unit (#15680)', () => {
+describe('NoSQLQueryOptions.timeout carries its unit', () => {
   it('REFUSES the retired `timeout` with the rename in the message', () => {
     const result = NoSQLQueryOptionsSchema.safeParse({ timeout: 5000 });
     expect(result.success).toBe(false);

packages/spec/src/data/driver.test.ts

@@ -101,15 +101,15 @@ describe('DriverCapabilitiesSchema', () => {
 // Retired capability bits (#4634, ADR-0049 enforce-or-remove)
 // ===========================================================================
 
-describe('[#4634] the 31 inert capability bits are tombstoned, not stripped', () => {
+describe('the 31 inert capability bits are tombstoned, not stripped', () => {
   it.each(RETIRED_BITS)('REJECTS an authored `%s`, with the prescription in the message', (bit) => {
     const value = bit === 'isolationLevels' ? ['read-committed'] : true;
     expect(() => DriverCapabilitiesSchema.parse({ [bit]: value })).toThrow(
       new RegExp(`DriverCapabilities\\.${bit}.*removed.*Delete the key`, 's'),
     );
   });
 
-  it('the streaming prescription carries the #4484 findStream story and the paged-find fix', () => {
+  it('the streaming prescription names the removed findStream and the paged-find fix', () => {
     expect(() => DriverCapabilitiesSchema.parse({ streaming: true })).toThrow(
       /DriverCapabilities\.streaming.*removed.*findStream.*`find\(\)` with `limit`\/`offset`.*Delete the key/s,
     );
@@ -163,7 +163,7 @@ describe('[#4634] the 31 inert capability bits are tombstoned, not stripped', ()
 // so the load-bearing tsc-channel proof is the compiler-API test below, with
 // anti-vacuity guards; sabotage-verified in the PR (S1: re-adding a live
 // `streaming: z.boolean()` turns it red).
-describe('[#4634] tsc channel: the retired bits are unwritable in DriverCapabilities', () => {
+describe('tsc channel: the retired bits are unwritable in DriverCapabilities', () => {
   it('types every retired bit as authored-unwritable and every live bit as writable', async () => {
     const ts = (await import('typescript')).default;
     const { resolve, dirname } = await import('node:path');
@@ -396,7 +396,7 @@ describe('DriverInterfaceSchema', () => {
 // else; the unit now lives in the key name. Tombstoned (the shape is not
 // strict, so a bare deletion would strip the old key in silence) and
 // registered as `data/DriverOptions:timeout` under protocol 18.
-describe('DriverOptions.timeout → DriverOptions.timeoutMs (#14478)', () => {
+describe('DriverOptions.timeout → DriverOptions.timeoutMs: the key carries its unit', () => {
   it('REFUSES the retired `timeout` spelling with the rename in the message', () => {
     const result = DriverOptionsSchema.safeParse({ timeout: 5000 });
     expect(result.success).toBe(false);
@@ -425,7 +425,7 @@ describe('DriverOptions.timeout → DriverOptions.timeoutMs (#14478)', () => {
 // [#18063] driverSupportsTransactions — the one definition of the gate
 // ===========================================================================
 
-describe('[#18063] driverSupportsTransactions', () => {
+describe('driverSupportsTransactions — a driver that cannot honour transactions says so', () => {
   const withMethod = { beginTransaction: async () => ({}) };
 
   it('is false for a driver with no beginTransaction — the pre-existing gate, unchanged', () => {

packages/spec/src/data/esignature-deadline-keys-retirement.test.ts

@@ -141,7 +141,7 @@ function expectTombstoneRefusal(site: Pick<RetiredSite, 'qualified' | 'schema' |
   expect(issue!.message).not.toMatch(/os migrate meta/);
 }
 
-describe('[#14477] ESignatureConfig deadline pair retirement — refusal at every site', () => {
+describe('ESignatureConfig deadline pair retirement — refusal at every site', () => {
   for (const site of SITES) {
     it(`REJECTS an authored \`${site.qualified}\` at path \`${site.issuePath.join('.')}\`, carrying the prescription`, () => {
       expectTombstoneRefusal(site);
@@ -169,7 +169,7 @@ describe('[#14477] ESignatureConfig deadline pair retirement — refusal at ever
   });
 });
 
-describe('[#14477] no-materialize: parsed configurations carry neither key and neither former default', () => {
+describe('no-materialize: parsed configurations carry neither key and neither former default', () => {
   it('on the base schema', () => {
     const parsed = ESignatureConfigSchema.parse(CONFIG);
     expect(parsed).not.toHaveProperty('expirationDays');
@@ -187,7 +187,7 @@ describe('[#14477] no-materialize: parsed configurations carry neither key and n
   });
 });
 
-describe('[#14477] the tsc channel: the input type of both retired keys is `never`', () => {
+describe('the tsc channel: the input type of both retired keys is `never`', () => {
   it('fails tsc at both authoring sites', () => {
     const config: ESignatureConfig = {
       ...CONFIG,
@@ -215,7 +215,7 @@ describe('[#14477] the tsc channel: the input type of both retired keys is `neve
   });
 });
 
-describe('[#14477] ADR-0087 registration', () => {
+describe('ADR-0087 registration', () => {
   it('declares both sites under major 18, with the D3 semantic entry wired and no D2 conversion', () => {
     for (const site of SITES) {
       expect(RETIRED_KEYS_BY_MAJOR[18], `${site.registered} must be declared`).toContain(site.registered);

packages/spec/src/data/external-lookup-retirement.test.ts

@@ -54,7 +54,7 @@ import {
 // Form follows #4988 / #5055: resolved symbol identity over every public entry
 // via the build-time `export-origins/` artifact, plus the file-deletion probe
 // in the #4988 direction (whole-file retirement, no surviving occupant).
-describe('[#8075] data/ external-lookup family retirement', () => {
+describe('data/ external-lookup family retirement', () => {
   /** The 8 names the three retired defs exported (3 schema consts + 5 types). */
   const RETIRED_NAMES = [
     'ExternalDataSourceSchema', 'ExternalDataSource',
@@ -86,7 +86,7 @@ describe('[#8075] data/ external-lookup family retirement', () => {
 
     // ── ABSENCE (every entry, not just ./data) ────────────────────────────
     for (const name of RETIRED_NAMES) {
-      expect(holdersOf(name), `${name} must have zero holders after #8075`).toEqual([]);
+      expect(holdersOf(name), `${name} must have zero holders after the external-lookup retirement`).toEqual([]);
     }
 
     // ── SURVIVAL ──────────────────────────────────────────────────────────
@@ -127,7 +127,7 @@ describe('[#8075] data/ external-lookup family retirement', () => {
       }
     };
     walk(srcRoot);
-    expect(importers, 'a resurrected import means the retirement is being undone — re-read #8075').toEqual([]);
+    expect(importers, 'a resurrected import means the retirement is being undone — the family had no consumer and accepted inline credentials').toEqual([]);
   });
 
   it('runtime namespace agrees with the compiler view', async () => {

packages/spec/src/data/feed.test.ts

@@ -19,7 +19,7 @@ describe('FeedItemType', () => {
   });
 });
 
-describe('SYS_ACTIVITY_BUILTIN_TYPES (#11807)', () => {
+describe('SYS_ACTIVITY_BUILTIN_TYPES — the built-in activity types, published by the spec', () => {
   /**
    * Mechanical invariants only. The semantic pin — every entry has a recorded
    * writer disposition — lives with the object that declares the column:

packages/spec/src/data/field-autonumber-default-format.test.ts

@@ -25,7 +25,7 @@ import { z } from 'zod';
 import { FieldSchema } from './field.zod';
 import { DEFAULT_AUTONUMBER_FORMAT, resolveAutonumberFormat } from './autonumber-format';
 
-describe('FieldSchema.autonumberFormat — the declared contract default (#6555)', () => {
+describe('FieldSchema.autonumberFormat — the declared contract default', () => {
   it('declares `{0000}` as the JSON-Schema default for the key', () => {
     const js = z.toJSONSchema(FieldSchema as unknown as z.ZodType, {
       unrepresentable: 'any',

packages/spec/src/data/field-autonumber-default-unique.test.ts

@@ -51,7 +51,7 @@ function minimalField(type: string): Record<string, unknown> {
   return input;
 }
 
-describe('#13894 — autonumber defaults to unique: organization', () => {
+describe('autonumber defaults to unique: organization', () => {
   it("materializes 'organization' when the author omits `unique`", () => {
     const parsed = FieldSchema.parse({ type: 'autonumber' });
     expect(parsed.unique).toBe('organization');
@@ -101,7 +101,7 @@ describe('#13894 — autonumber defaults to unique: organization', () => {
     expect(text.indexOf('unique')).toBe(text.indexOf('multiple') + 1);
   });
 
-  it('is idempotent — parse(parse(x)) is byte-identical (the #9689 class)', () => {
+  it('is idempotent — parse(parse(x)) is byte-identical', () => {
     for (const input of [{ type: 'autonumber' }, { type: 'autonumber', unique: false }, { type: 'text' }]) {
       const once = FieldSchema.parse(input);
       const twice = FieldSchema.parse(once);