retire(metadata-admin): remove the standalone validation resource, move its preview to the embedded path

[yinlianghui]

Fixes#4132

Verdict: shape B landed — the drawer hosts the preview with no structural surgery

The PM ruling was shape B with A as the measured fallback: retire the standalone door (non-negotiable), and wire ValidationPreview into the embedded path if the drawer can host it; fall back to A (retire the preview with the door) only if hosting it is measurably structural surgery.

Measurement of the drawer's structure, taken before writing any wiring:

• MetadataDetailDrawer.tsx:122-132 renders exactly one thing for kind: 'embedded' — EmbeddedItemEditor, inside a plain flex-1 min-h-0 overflow-auto column. No tab strip to extend, no layout to redesign.
• EmbeddedItemEditor already owns the live draft state (:64) and already resolves the sub-type by editAs (:54). MetadataPreviewProps needs { type, name, draft } — all three were in hand.
• So hosting the preview is 6 lines: one getMetadataPreview(editAs) lookup and one conditional mount above the SchemaForm. Diff for the wiring: EmbeddedItemEditor.tsx, +28 lines including the header paragraph explaining why.

Not structural surgery, so the fallback was not taken and no follow-up card is needed for the wiring.

What was retired

anchors.ts registered a standalone validation resource anchored by anchorByField('object'), with createFields / createSchema / createDefaults. That gave every object's Related tab a "Validations" group whose + navigated to validation/_new (RelatedPanel.tsx:257 → the generic metadata/:type/new route at AppContent.tsx:642). Gone, together with the comment that justified it — "usually embedded in the object, but standalone variants do exist" — which the framework contradicts.

Kept: the embedded anchor __object_validation (editAs: 'validation', embeddedPath: 'validations'). That is the path the framework evaluates, and it is the control in the new pin.

Premise check (requirement 1) — all three items hold

item	result
the registrations still exist on my tip	yes — anchors.ts:347 standalone resource + previews/index.ts:45 preview registration, both present at 2776b110b
the installed rc.6 spec has no validation kind	confirmed by parsing the shipped dist, not grep
metadata/validation/new reachable today	confirmed — the red-first run measured listAnchorsFor('object') returning object → validation, a non-embedded group, which is what RelatedPanel renders the + for

The spec probe imported @objectstack/spec/dist/kernel/index.mjs directly. Note the shipped rc.6 names differ from the issue body's: the registry is DEFAULT_METADATA_TYPE_REGISTRY (an array of 27 entries), not METADATA_TYPE_SCHEMAS, and the unregistered-kind list is behind listUnregisteredKindSchemaTypes().

DEFAULT_METADATA_TYPE_REGISTRY (27 kinds) includes 'validation' => false
action, agent, api, app, book, capability, dashboard, dataset, datasource, doc,
email_template, external_catalog, field, flow, hook, job, mapping, object, page,
permission, position, report, seed, skill, tool, translation, view
listUnregisteredKindSchemaTypes() -> 3; includes 'validation' => false
connector, sharing_rule, webhook

What the embedded path renders now

EmbeddedItemEditor looks up getMetadataPreview(editAs) and mounts it on the live draft above the SchemaForm, read-only (no onPatch, editing={false}). The lookup is generic, not a validation special case — today validation is the only embedded sub-type with both an editAs anchor and a registered preview, and the control in the pin asserts a sub-type without one (index) is unchanged and grows no empty preview chrome.

This makes objectstack#7427's validation.label / .description / .tags read points reachable on the evaluated path; those rows were graded dead precisely because the render only existed behind the retired door.

One read retired with the door

ValidationPreview painted an object: < name > pill, explicitly exempted from the #3275 cleanup because "anchors.ts registers a standalone validation resource … so a standalone rule really does carry it". With that registration gone the read has no producer — and it never had one on the governed path either. Measured against the installed spec:

ValidationRuleSchema.safeParse({ ...rule, object: 'sales_order' })
-> unrecognized_keys: ['object']
ValidationRuleSchema.safeParse({ ...rule }) # same draft, no `object`
-> success

So the pill could only ever confirm a key that makes the rule unsaveable — the AGENTS.md #0.1 shape this file already deleted expression and pattern for. Its test case was replaced, not re-spelled (re-spelling would have kept a green test for a key nothing can produce): the schema's own verdict is the instrument, plus a negative render assertion.

Pins, and their reverse verification

Three files reverted one at a time against HEAD, direction predicted first:

1. anchors.ts reverted → anchors.validation-retired.test.ts: 7 red, controls green (predicted red)

x has no entry in the resource registry
x offers no create affordance - createFields / createSchema are gone with it
x the object Related tab has no standalone "Validations" group
x no anchored group anywhere routes standalone validation authoring
x declares no standalone validation resource registration
x does not carry the stale "standalone variants do exist" justification
x records the retirement where the registration used to be
/ non-vacuity: the registry IS populated and other standalone kinds are in it
/ `__object_validation` is still anchored at object
/ its group is reachable from the object Related tab
/ the drawer still hands the embedded editor its `editAs`
/ previews/index.ts still registers ValidationPreview

⚠️The first pass of this reverse verification was 5 red, not 7 — and the two that stayed green were my own vacuous assertions, fixed in the second commit:

• not.toMatch(/standalone variants do exist/) never matched, because the comment it guards wraps across two lines in the source.
• toMatch(/ADR-0088/) was already satisfied by the neighbouring trigger retirement note, so it passed on a file that still registered the door.

Both now assert wording unique to this retirement. This is the whole reason the fix is taken out and the pins re-run rather than reasoned about.

2. EmbeddedItemEditor.tsx reverted → EmbeddedItemEditor.preview.test.tsx: 4 red, 4 controls green (predicted red)

x renders the rule label - objectstack#7427 `validation.label`
x renders the rule description - `validation.description`
x renders the rule tags - `validation.tags`
x renders the type-specific body, not just the envelope
/ `validation` still has a registered preview after the standalone retirement
/ control: a sub-type with no preview is genuinely unregistered
/ ALONGSIDE, not instead of: the SchemaForm is still mounted and editable
/ renders the editor with no preview chrome (the `index` control)

3. ValidationPreview.tsx reverted → ValidationPreview.test.tsx: 1 red, 2 partners green — a deliberately partial direction

Only the render assertion flips. The two schema-probe assertions stay green on the reverted file by design: they measure ValidationRuleSchema, not this repo's file, so restoring the pill cannot move them. Reporting them as "should have gone red" would misdescribe what they pin.

x the preview paints no object pill even when a draft carries the key
/ the schema rejects `object` by name - this is why the read is gone
/ non-vacuity: the same draft WITHOUT `object` is not rejected for its keys

Two test-harness notes worth the next reader's time

Both cost a lap here and neither is a product defect:

• The pin cannot go through MetadataDetailDrawer. The drawer wraps the editor in a Radix Sheet, which never settles under the light DOM setup — the identical assertions through < MetadataDetailDrawer > ran past 540s with no output, while EmbeddedItemEditor alone renders in ~6s. EmbeddedItemEditoris the entirety of the drawer's embedded branch, so the pin mounts it directly and the drawer's half (that it forwards editAs) is asserted off source text in the sibling pin. Both halves of the path are covered, neither by a hanging render.
• The pin's form schema must not declare a condition property.SchemaForm's CONDITION_FIELD_NAMES routes that name to the CEL ConditionWidget, whose formula loader is a dynamic import — the unbounded-module-load trap AGENTS.md §测试纪律 describes. Bisected: schemas with name / label render in ~44ms, the same schema plus condition never settles. The rule's condition is asserted on the preview instead, where it is read straight off the draft.

Gates

• pnpm exec vitest run packages/app-shell/ — 337 files / 3195 passed, 1 skipped
• pnpm --filter @object-ui/app-shell type-check — clean (tsc --noEmit + typetests)
• pnpm --filter @object-ui/app-shell lint — 0 errors (2262 pre-existing warnings repo-wide; none on the changed lines)
• node scripts/check-control-bytes.mjs — OK, 3948 files
• node scripts/check-changeset-no-major.mjs — OK
• Changeset: .changeset/retire-standalone-validation-resource-4132.md, @object-ui/app-shell: patch, matching DatasourcePreview renders three key groups DatasourceSchema (strict) now rejects — retryPolicy, healthCheck, capabilities #4131's precedent for a preview-surface removal. Notskip-changeset (.github/WORKFLOWS.md documents 5 workflows that do not exist and omits 9 that do — including a changeset gate and a skip-changeset label neither of which is real #3724).

Orphaned artifacts — swept, nothing stranded

• ValidationPreview.tsx / .test.tsx: not orphaned under shape B — the renderer moved to the embedded path, so both stay (with the object case replaced).
• i18n: no key was used only by the standalone route, so none went dead. TYPE_LABELS_EN/ZH.validation ('Validation Rule' / 校验规则) stays live — the kind still exists as an embedded sub-type via editAs: 'validation'. No i18n change, so no i18n gate applies.
• Docs: swept content/docs/** for the standalone validation resource (metadata/validation, Validations, registerMetadataResource). No page documents it; the hits for "validation" are all form-field validation. Nothing to correct, and content/docs/releases/ untouched.
• No other in-repo consumer references the retired registration (createConformance.test.ts reads the registry live, so it simply stops seeing the type).

---

Generated by Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
objectui	Ignored		Aug 11, 2026 7:37am

[github-actions]

✅ Console Performance Budget

Metric	Value	Budget
Main entry (gzip)	28.3 KB	350 KB
Entry file	index-BMyfcbic.js	—
Status	PASS	—

---

📦 Bundle Size Report

Package	Size	Gzipped
app-shell (index.js)	8.88KB	3.25KB
app-shell (runtime-config.js)	7.42KB	2.32KB
app-shell (types.js)	0.01KB	0.04KB
app-shell (urlParams.js)	7.57KB	2.97KB
auth (AuthContext.js)	0.31KB	0.24KB
auth (AuthGuard.js)	1.17KB	0.53KB
auth (AuthProvider.js)	22.10KB	4.37KB
auth (AuthShell.js)	3.49KB	1.40KB
auth (ForgotPasswordForm.js)	12.21KB	3.45KB
auth (LoginForm.js)	18.13KB	5.39KB
auth (PreviewBanner.js)	0.90KB	0.50KB
auth (RegisterForm.js)	6.64KB	2.21KB
auth (SocialSignInButtons.js)	9.60KB	3.89KB
auth (UserMenu.js)	3.40KB	1.22KB
auth (auth-gate-events.js)	1.29KB	0.66KB
auth (authStyles.js)	5.04KB	1.72KB
auth (createAuthClient.js)	35.76KB	9.11KB
auth (createAuthenticatedFetch.js)	4.37KB	1.69KB
auth (index.js)	2.35KB	1.07KB
auth (org-roles.js)	6.66KB	2.78KB
auth (phone-identifier.js)	1.11KB	0.66KB
auth (types.js)	0.59KB	0.35KB
auth (useAuth.js)	4.91KB	0.87KB
auth (useIsWorkspaceAdmin.js)	1.61KB	0.85KB
collaboration (CommentThread.js)	26.07KB	7.56KB
collaboration (LiveCursors.js)	3.17KB	1.27KB
collaboration (PresenceAvatars.js)	6.49KB	2.64KB
collaboration (PresenceProvider.js)	2.79KB	1.13KB
collaboration (index.js)	1.65KB	0.73KB
collaboration (useCollaborationTranslation.js)	6.05KB	2.52KB
collaboration (useCommentSearch.js)	1.98KB	0.88KB
collaboration (useConflictResolution.js)	7.75KB	1.86KB
collaboration (useMentionNotifications.js)	1.81KB	0.68KB
collaboration (usePresence.js)	6.33KB	1.84KB
collaboration (useRealtimeSubscription.js)	7.91KB	2.01KB
components (index.js)	488.60KB	108.25KB
core (index.js)	3.04KB	1.15KB
create-plugin (index.js)	10.08KB	3.26KB
data-objectstack (index.js)	144.34KB	37.61KB
fields (index.js)	228.43KB	56.61KB
i18n (LocalizationContext.js)	1.76KB	0.96KB
i18n (currency.js)	1.22KB	0.64KB
i18n (i18n.js)	4.32KB	1.77KB
i18n (index.js)	2.65KB	1.06KB
i18n (pickLocalized.js)	1.70KB	0.83KB
i18n (provider.js)	9.48KB	3.27KB
i18n (useObjectLabel.js)	27.59KB	6.63KB
i18n (useSafeTranslation.js)	4.52KB	1.96KB
layout (index.js)	38.98KB	10.85KB
mobile (MobileProvider.js)	0.92KB	0.49KB
mobile (ResponsiveContainer.js)	0.94KB	0.38KB
mobile (breakpoints.js)	1.51KB	0.70KB
mobile (createOfflineDataSource.js)	5.61KB	1.74KB
mobile (index.js)	1.50KB	0.62KB
mobile (offlineQueue.js)	3.91KB	1.35KB
mobile (pwa.js)	0.97KB	0.49KB
mobile (serviceWorker.js)	1.48KB	0.62KB
mobile (serviceWorkerSource.js)	3.41KB	1.48KB
mobile (useBreakpoint.js)	1.54KB	0.65KB
mobile (useGesture.js)	6.96KB	1.98KB
mobile (useOfflineSync.js)	1.99KB	0.72KB
mobile (usePullToRefresh.js)	2.53KB	0.85KB
mobile (useResponsive.js)	0.71KB	0.42KB
mobile (useResponsiveConfig.js)	1.36KB	0.63KB
mobile (useSpecGesture.js)	4.32KB	1.64KB
mobile (useTouchTarget.js)	1.01KB	0.54KB
permissions (MePermissionsProvider.js)	8.75KB	3.06KB
permissions (PermissionContext.js)	0.31KB	0.25KB
permissions (PermissionGuard.js)	0.89KB	0.45KB
permissions (PermissionProvider.js)	3.67KB	1.12KB
permissions (evaluator.js)	4.41KB	1.44KB
permissions (index.js)	0.91KB	0.41KB
permissions (store.js)	0.91KB	0.42KB
permissions (useFieldPermissions.js)	1.28KB	0.52KB
permissions (usePermissions.js)	1.55KB	0.71KB
plugin-ai (index.js)	15.71KB	3.79KB
plugin-calendar (index.js)	45.23KB	12.45KB
plugin-charts (index.js)	61.52KB	17.49KB
plugin-chatbot (index.js)	180.33KB	42.79KB
plugin-dashboard (index.js)	118.58KB	30.71KB
plugin-designer (index.js)	210.91KB	42.67KB
plugin-detail (index.js)	238.86KB	59.70KB
plugin-editor (index.js)	2.46KB	1.10KB
plugin-form (index.js)	114.58KB	27.68KB
plugin-gantt (index.js)	164.14KB	39.98KB
plugin-grid (index.js)	187.97KB	49.90KB
plugin-kanban (index.js)	48.60KB	13.41KB
plugin-list (index.js)	110.31KB	26.76KB
plugin-map (index.js)	17.00KB	5.32KB
plugin-markdown (index.js)	13.72KB	4.69KB
plugin-report (index.js)	40.58KB	10.58KB
plugin-timeline (index.js)	26.21KB	7.52KB
plugin-tree (index.js)	8.50KB	2.88KB
plugin-view (index.js)	84.03KB	20.55KB
providers (DataSourceProvider.js)	0.75KB	0.39KB
providers (MetadataProvider.js)	1.37KB	0.59KB
providers (ThemeProvider.js)	1.90KB	0.85KB
providers (UploadProvider.js)	11.71KB	3.53KB
providers (index.js)	0.44KB	0.22KB
providers (types.js)	0.01KB	0.04KB
react-runtime (index.js)	5.67KB	2.37KB
react (LazyPluginLoader.js)	3.77KB	1.33KB
react (SchemaRenderer.js)	23.71KB	7.96KB
react (data-invalidation.js)	5.05KB	2.08KB
react (index.js)	1.23KB	0.66KB
react (spec-input.js)	0.20KB	0.18KB
sdui-parser (codegen.js)	4.09KB	1.74KB
sdui-parser (index.js)	4.47KB	2.03KB
sdui-parser (parse.js)	10.04KB	2.82KB
sdui-parser (types.js)	0.29KB	0.24KB
sdui-parser (validate.js)	4.69KB	1.48KB
types (ai.js)	0.20KB	0.17KB
types (api-types.js)	0.20KB	0.18KB
types (app.js)	2.87KB	0.99KB
types (base.js)	0.20KB	0.18KB
types (blocks.js)	0.20KB	0.18KB
types (complex.js)	0.20KB	0.18KB
types (crud.js)	0.20KB	0.18KB
types (dashboard-filter-alias.js)	6.23KB	2.74KB
types (data-display.js)	0.20KB	0.18KB
types (data-protocol.js)	0.20KB	0.19KB
types (data.js)	0.20KB	0.18KB
types (designer.js)	1.87KB	0.85KB
types (disclosure.js)	0.20KB	0.18KB
types (error-code.js)	1.54KB	0.88KB
types (feedback.js)	0.20KB	0.18KB
types (field-types.js)	0.20KB	0.18KB
types (form.js)	0.20KB	0.18KB
types (http-retry.js)	4.32KB	2.02KB
types (index.js)	3.05KB	1.52KB
types (layout.js)	0.20KB	0.18KB
types (managed-by.js)	0.19KB	0.18KB
types (mobile.js)	2.59KB	1.31KB
types (navigation.js)	0.20KB	0.18KB
types (objectql.js)	0.20KB	0.18KB
types (overlay.js)	0.20KB	0.18KB
types (permissions.js)	0.20KB	0.18KB
types (plugin-scope.js)	0.20KB	0.18KB
types (record-components.js)	0.20KB	0.19KB
types (record-semantics.js)	1.28KB	0.67KB
types (registry.js)	0.20KB	0.18KB
types (reports.js)	0.20KB	0.18KB
types (spec-report.js)	5.05KB	1.93KB
types (system-fields.js)	3.33KB	1.54KB
types (theme.js)	0.20KB	0.18KB
types (ui-action.js)	3.40KB	1.71KB
types (views.js)	0.20KB	0.18KB
types (widget.js)	0.20KB	0.18KB

Size Limits

• ✅ Core packages should be < 50KB gzipped
• ✅ Component packages should be < 100KB gzipped
• ⚠️ Plugin packages should be < 150KB gzipped