feat(spec)!: remove dead author-facing metadata properties (#2377)

Removes spec properties that parsed but had no runtime consumer (ADR-0049
enforce-or-remove) — a false affordance, especially for AI-authored metadata.
Follow-up slice to #2402. Verified dead against packages/spec/liveness/*.json
and a repo-wide reader grep.

Removed:
- field: vectorConfig (+VectorConfigSchema+types), fileAttachmentConfig
  (+FileAttachmentConfigSchema+types), dependencies
- object: versioning, softDelete, search, recordName, keyPrefix (+ their
  sub-schemas/types) — each now a rejecting tombstone in UNKNOWN_KEY_GUIDANCE
- action: timeout
- agent: planning.strategy, planning.allowReplan (keep planning.maxIterations)
- dataset: measures.certified

Ledgers, ledger README table, api-surface.json, and json-schema.manifest.json
updated; spec tests/fixtures migrated (analytics/rest/lint/cli). Deferred the
authoring-form-surfaced dead props (field.index/columnName/referenceFilters;
object.tags/active/isSystem/abstract/enable.searchable/trash/mru; agent.tenantId)
and action.type:'form' — they cascade into i18n/lint/UX and stay authorWarn'd.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011XchBKhKdjbhQZymt9Gn9B

Author: claude

.changeset/remove-dead-metadata-props-2377.md

@@ -0,0 +1,51 @@
+---
+"@objectstack/spec": major
+---
+
+feat(spec)!: remove dead author-facing metadata properties (#2377, ADR-0049 enforce-or-remove)
+
+Removes a batch of spec properties that parsed but had **no runtime consumer** —
+authoring them was a false affordance (especially dangerous for AI-authored
+metadata). Verified dead against the liveness ledger (`packages/spec/liveness/*.json`)
+and a repo-wide grep of readers. This is the follow-up slice to #2402.
+
+## Removed (each was `dead` + no reader anywhere)
+
+- **field** (`field.zod.ts`): `vectorConfig` (+ `VectorConfigSchema` + types),
+  `fileAttachmentConfig` (+ `FileAttachmentConfigSchema` + types), `dependencies`.
+  Vector fields keep the live flat `dimensions` prop; file/image fields keep the
+  live flat `multiple`/`accept`/`maxSize` siblings.
+- **object** (`object.zod.ts`): `versioning` (+ `VersioningConfigSchema`),
+  `softDelete` (+ `SoftDeleteConfigSchema`), `search` (+ `SearchConfigSchema`),
+  `recordName`, `keyPrefix`. Each is now a **rejecting tombstone** in
+  `UNKNOWN_KEY_GUIDANCE` carrying the upgrade prescription.
+- **action** (`action.zod.ts`): `timeout` (server uses `body.timeoutMs`; no
+  action-level timeout is enforced).
+- **agent** (`agent.zod.ts`): `planning.strategy`, `planning.allowReplan`
+  (only `planning.maxIterations` is read by the runtime).
+- **dataset** (`dataset.zod.ts`): `measures.certified` (declared-but-unenforced
+  governance flag — never compiled into the Cube).
+
+Liveness ledgers, the ledger README table, and `api-surface.json` are updated;
+the removed sub-schema keys are dropped from `json-schema.manifest.json`.
+
+## Migration
+
+- **field/agent/dataset/action props**: authoring them is now silently stripped
+  (they never did anything). Remove them. Vector → set flat `dimensions`;
+  file/image → set flat `multiple`/`accept`/`maxSize`.
+- **object props**: `ObjectSchema.create()` now throws a located error naming the
+  replacement — `versioning`/`softDelete` → hard deletes + `Field.trackHistory` /
+  `lifecycle`; `search` → `searchableFields`; `recordName` → an `autonumber`
+  `Field` designated as `nameField`; `keyPrefix` → remove (never had an effect).
+
+## Deliberately NOT removed (dead, but entangled — a scoped follow-up)
+
+`field.index`/`columnName`/`referenceFilters` and object
+`tags`/`active`/`isSystem`/`abstract`/`enable.searchable`/`enable.trash`/`enable.mru`
+and `agent.tenantId` are surfaced in the Studio metadata-authoring forms
+(`*.form.ts`) — removing them cascades into i18n bundle regeneration, so they are
+deferred. `action.type:'form'` has a dedicated build-time lint (`lint-view-refs.ts`)
+and a first-party showcase usage, so it needs a UX decision. `field.columnName`
+additionally has an ADR-0062 D7 lint. These stay `dead` + `authorWarn` in the
+ledgers.

packages/cli/src/utils/lint-liveness-properties.test.ts

@@ -9,7 +9,7 @@ import {
 /**
  * These run against the REAL ledgers shipped by `@objectstack/spec` (the same
  * files the gate enforces), so they double as a contract test: if an
- * `authorWarn` annotation is removed from `versioning` / `columnName` / etc.,
+ * `authorWarn` annotation is removed from `abstract` / `columnName` / etc.,
  * the matching assertion fails.
  */
 
@@ -18,9 +18,9 @@ const rules = (findings: { rule: string }[]) => findings.map((f) => f.rule);
 const paths = (findings: { message: string }[]) => findings.map((f) => f.message);
 
 describe('lintLivenessProperties', () => {
-  it('warns on a present dead object block (versioning)', () => {
-    const findings = lintLivenessProperties(objStack({ versioning: { enabled: true } }));
-    const v = findings.find((f) => f.message.includes('versioning'));
+  it('warns on a present dead object prop (abstract)', () => {
+    const findings = lintLivenessProperties(objStack({ abstract: true }));
+    const v = findings.find((f) => f.message.includes('abstract'));
     expect(v).toBeDefined();
     expect(v!.rule).toBe(LIVENESS_DEAD_PROPERTY);
     expect(v!.where).toBe("object 'widget'");
@@ -71,7 +71,7 @@ describe('lintLivenessProperties', () => {
 
   it('handles objects as a keyed record (not just arrays)', () => {
     const findings = lintLivenessProperties({
-      objects: { widget: { name: 'widget', versioning: { enabled: true } } },
+      objects: { widget: { name: 'widget', abstract: true } },
     });
     expect(rules(findings)).toContain(LIVENESS_DEAD_PROPERTY);
   });
@@ -112,9 +112,9 @@ describe('lintLivenessProperties', () => {
     expect(hits[0].where).toBe("flow 'f1'");
   });
 
-  it('warns on action.timeout (no runtime enforcement)', () => {
-    const findings = lintLivenessProperties({ actions: [{ name: 'a1', timeout: 5000 }] });
-    expect(paths(findings).some((m) => m.includes('`timeout`'))).toBe(true);
+  it('warns on action.undoable (experimental — declared but not enforced)', () => {
+    const findings = lintLivenessProperties({ actions: [{ name: 'a1', undoable: true }] });
+    expect(paths(findings).some((m) => m.includes('`undoable`'))).toBe(true);
   });
 
   it('warns on the security-shaped dead props (tool.permissions / permission.contextVariables)', () => {
@@ -131,13 +131,6 @@ describe('lintLivenessProperties', () => {
     expect(paths(perm).some((m) => m.includes('contextVariables'))).toBe(true);
   });
 
-  it('warns on dataset measure certified flag via array fan-out', () => {
-    const findings = lintLivenessProperties({
-      datasets: [{ name: 'd1', measures: [{ name: 'arr', certified: true }] }],
-    });
-    expect(paths(findings).some((m) => m.includes('measures.certified'))).toBe(true);
-  });
-
   it('stays silent on clean flat-collection items', () => {
     const findings = lintLivenessProperties({
       flows: [{ name: 'clean', nodes: [{ id: 'n1' }] }],

packages/lint/src/validate-widget-bindings.test.ts

@@ -50,7 +50,7 @@ function chartStack(widgetOverrides: Record<string, unknown> = {}) {
       object: 'expense_line',
       dimensions: [{ name: 'category', field: 'category' }],
       measures: [
-        { name: 'sum_amount', label: 'sum_amount', aggregate: 'sum', field: 'amount', certified: true },
+        { name: 'sum_amount', label: 'sum_amount', aggregate: 'sum', field: 'amount' },
         { name: 'ticket_count', label: 'ticket_count', aggregate: 'count' },
       ],
     }],

packages/rest/src/analytics-routes.test.ts

@@ -58,9 +58,9 @@ describe('POST /analytics/dataset/query', () => {
 
     expect(res.statusCode).toBe(200);
     expect(res.body).toEqual({ rows: [{ region: 'NA', revenue: 100 }], fields: [] });
-    // dataset was schema-validated before reaching the service (certified default applied)
+    // dataset was schema-validated before reaching the service
     const passedDataset = queryDataset.mock.calls[0][0];
-    expect(passedDataset.measures[0].certified).toBe(false);
+    expect(passedDataset.measures[0].name).toBe('revenue');
     expect(queryDataset.mock.calls[0][1]).toEqual(selection);
   });
 

packages/services/service-analytics/src/__tests__/dataset-compiler.test.ts

@@ -16,10 +16,10 @@ const salesDataset = DatasetSchema.parse({
     { name: 'close_month', label: 'Close Month', field: 'close_date', type: 'date', dateGranularity: 'month' },
   ],
   measures: [
-    { name: 'revenue', label: 'Revenue', aggregate: 'sum', field: 'amount', certified: true, format: '$0,0.00' },
-    { name: 'deal_count', label: 'Deals', aggregate: 'count', certified: false },
-    { name: 'won_amount', label: 'Won', aggregate: 'sum', field: 'amount', certified: false, filter: { stage: 'won' } },
-    { name: 'win_rate', label: 'Win Rate', aggregate: 'sum', certified: false, derived: { op: 'ratio', of: ['won_amount', 'revenue'] } },
+    { name: 'revenue', label: 'Revenue', aggregate: 'sum', field: 'amount', format: '$0,0.00' },
+    { name: 'deal_count', label: 'Deals', aggregate: 'count' },
+    { name: 'won_amount', label: 'Won', aggregate: 'sum', field: 'amount', filter: { stage: 'won' } },
+    { name: 'win_rate', label: 'Win Rate', aggregate: 'sum', derived: { op: 'ratio', of: ['won_amount', 'revenue'] } },
   ],
 });
 

packages/services/service-analytics/src/__tests__/dataset-executor.test.ts

@@ -52,7 +52,7 @@ const dataset = DatasetSchema.parse({
   filter: { is_deleted: { $ne: true } },
   dimensions: [{ name: 'region', field: 'account.region', type: 'string' }],
   measures: [
-    { name: 'revenue', aggregate: 'sum', field: 'amount', certified: true },
+    { name: 'revenue', aggregate: 'sum', field: 'amount' },
     { name: 'won_amount', aggregate: 'sum', field: 'amount', filter: { stage: 'won' } },
     { name: 'win_rate', aggregate: 'sum', derived: { op: 'ratio', of: ['won_amount', 'revenue'] } },
   ],

packages/services/service-analytics/src/__tests__/dataset-rls-integration.test.ts

@@ -25,7 +25,7 @@ const dataset = DatasetSchema.parse({
   object: 'opportunity',
   include: ['account'],
   dimensions: [{ name: 'region', field: 'account.region', type: 'string' }],
-  measures: [{ name: 'revenue', aggregate: 'sum', field: 'amount', certified: true }],
+  measures: [{ name: 'revenue', aggregate: 'sum', field: 'amount' }],
 });
 
 /**

packages/services/service-analytics/src/__tests__/query-dataset.test.ts

@@ -11,7 +11,7 @@ const dataset = DatasetSchema.parse({
   object: 'opportunity',
   include: ['account'],
   dimensions: [{ name: 'region', field: 'account.region', type: 'string' }],
-  measures: [{ name: 'revenue', aggregate: 'sum', field: 'amount', certified: true }],
+  measures: [{ name: 'revenue', aggregate: 'sum', field: 'amount' }],
 });
 
 function service(captured: { sql: string; params: unknown[] }[]) {
@@ -103,7 +103,7 @@ describe('AnalyticsService.queryDataset', () => {
     const priced = DatasetSchema.parse({
       name: 'sales_priced', label: 'Sales', object: 'opportunity', include: [],
       dimensions: [{ name: 'stage', field: 'stage', type: 'string' }],
-      measures: [{ name: 'revenue', aggregate: 'sum', field: 'amount', label: 'Revenue', format: '0,0', currency: 'USD', certified: true }],
+      measures: [{ name: 'revenue', aggregate: 'sum', field: 'amount', label: 'Revenue', format: '0,0', currency: 'USD' }],
     });
     const svc = new AnalyticsService({
       queryCapabilities: () => ({ nativeSql: true, objectqlAggregate: false, inMemory: false }),
@@ -165,7 +165,7 @@ describe('AnalyticsService.queryDataset', () => {
     const labeled = DatasetSchema.parse({
       name: 'sales2', label: 'Sales', object: 'opportunity', include: ['account'],
       dimensions: [{ name: 'region', field: 'account.region', type: 'string', label: 'Region' }],
-      measures: [{ name: 'revenue', aggregate: 'sum', field: 'amount', label: 'Revenue', certified: true }],
+      measures: [{ name: 'revenue', aggregate: 'sum', field: 'amount', label: 'Revenue' }],
     });
     const result = await service([]).queryDataset(
       labeled,
@@ -180,7 +180,7 @@ describe('AnalyticsService.queryDataset', () => {
     const dated = DatasetSchema.parse({
       name: 'sales3', label: 'Sales', object: 'opportunity', include: [],
       dimensions: [{ name: 'closed', field: 'close_date', type: 'date' }],
-      measures: [{ name: 'revenue', aggregate: 'sum', field: 'amount', certified: true }],
+      measures: [{ name: 'revenue', aggregate: 'sum', field: 'amount' }],
     });
     const svc = new AnalyticsService({
       queryCapabilities: () => ({ nativeSql: true, objectqlAggregate: false, inMemory: false }),
@@ -198,7 +198,7 @@ describe('AnalyticsService.queryDataset', () => {
     const byAccount = DatasetSchema.parse({
       name: 'sales_acct', label: 'Sales', object: 'opportunity', include: [],
       dimensions: [{ name: 'account', field: 'account', type: 'lookup', label: 'Account' }],
-      measures: [{ name: 'revenue', aggregate: 'sum', field: 'amount', certified: true }],
+      measures: [{ name: 'revenue', aggregate: 'sum', field: 'amount' }],
     });
     const svc = new AnalyticsService({
       queryCapabilities: () => ({ nativeSql: true, objectqlAggregate: false, inMemory: false }),

packages/spec/api-surface.json

@@ -321,9 +321,6 @@
     "FieldReferenceSchema (const)",
     "FieldSchema (const)",
     "FieldType (type)",
-    "FileAttachmentConfig (type)",
-    "FileAttachmentConfigInput (type)",
-    "FileAttachmentConfigSchema (const)",
     "Filter (type)",
     "FilterCondition (type)",
     "FilterConditionSchema (const)",
@@ -460,7 +457,6 @@
     "ScriptBodySchema (const)",
     "ScriptValidation (type)",
     "ScriptValidationSchema (const)",
-    "SearchConfigSchema (const)",
     "Seed (type)",
     "SeedIdentity (type)",
     "SeedIdentitySchema (const)",
@@ -485,8 +481,6 @@
     "SetOperatorSchema (const)",
     "ShardingConfig (type)",
     "ShardingConfigSchema (const)",
-    "SoftDeleteConfig (type)",
-    "SoftDeleteConfigSchema (const)",
     "SortNode (type)",
     "SortNodeSchema (const)",
     "SpecialOperatorSchema (const)",
@@ -506,11 +500,6 @@
     "VALID_AST_OPERATORS (const)",
     "ValidationRule (type)",
     "ValidationRuleSchema (const)",
-    "VectorConfig (type)",
-    "VectorConfigInput (type)",
-    "VectorConfigSchema (const)",
-    "VersioningConfig (type)",
-    "VersioningConfigSchema (const)",
     "WindowFunction (const)",
     "WindowFunctionNode (type)",
     "WindowFunctionNodeSchema (const)",

packages/spec/json-schema.manifest.json

@@ -789,7 +789,6 @@
     "data/FieldNode",
     "data/FieldReference",
     "data/FieldType",
-    "data/FileAttachmentConfig",
     "data/FilterCondition",
     "data/FormatValidation",
     "data/FullTextSearch",
@@ -844,7 +843,6 @@
     "data/SSLConfig",
     "data/ScriptBody",
     "data/ScriptValidation",
-    "data/SearchConfig",
     "data/Seed",
     "data/SeedIdentity",
     "data/SeedLoadResult",
@@ -855,7 +853,6 @@
     "data/SelectOption",
     "data/SetOperator",
     "data/ShardingConfig",
-    "data/SoftDeleteConfig",
     "data/SortNode",
     "data/SpecialOperator",
     "data/StateMachineValidation",
@@ -865,8 +862,6 @@
     "data/TimeUpdateInterval",
     "data/TransformType",
     "data/ValidationRule",
-    "data/VectorConfig",
-    "data/VersioningConfig",
     "data/WindowFunction",
     "data/WindowFunctionNode",
     "data/WindowSpec",