Skip to content

test(app-shell): pin the list-view calendar cross-field refusal at the client gate - #8311

Merged
os-justin merged 1 commit into
mainfrom
claude/issue-7122-listview-crossfield-calendar-parity
Sep 7, 2026
Merged

test(app-shell): pin the list-view calendar cross-field refusal at the client gate#8311
os-justin merged 1 commit into
mainfrom
claude/issue-7122-listview-crossfield-calendar-parity

Conversation

@os-justin

Copy link
Copy Markdown
Collaborator

Fixes #7122

Pins @objectstack/spec 17.3.0's list-view cross-field refusal — a view whose
appearance.allowedVisualizations offers 'calendar' must declare
calendar: { startDateField } — through metadata-admin's real client-validation
gate
, on both doors. Test-only; the changeset declares no release.

Where, and why not in packages/types

Ruled Q1 = B by the PM on the card. The decisive fact was measured, not argued:
objectui's packages/types mirrors cannot carry a spec refinement, ever.
ListViewSchema there is built from specFieldsExcept(SpecListViewSchema.shape, …),
and specFieldsExcept is z.object(kept).partial() over the spec shape's entries
a brand-new object schema. The spec's .superRefine chain is not omitted, it is
structurally unreachable, and the mirror was measured accepting the refused body
clean. A pin there would have asserted a property of the spec's schema while sitting
in a suite whose documented remit is objectui-vs-spec key drift.

clientValidation.ts's view entry imports the refined doors themselves —
ViewMetadataSchema on edit, ViewItemSchema / ViewSchema on create — so what is
pinned here is a refusal a Console author actually meets, and the suite already pins
exact path + message through that gate (its cases are named CANARY: …). No remit
change was needed.

What the pin asserts

Both doors carry a body. That is not redundancy: create and edit are judged by
different schemas, so a green on one says nothing about the other. Measured, the
refusal's path follows the body's own nesting rather than the door.

body path, both doors
ViewItem draft (config: { … }) config.calendar
aggregated container (list: { … }) list.calendar
flattened list-view overlay bare calendar (edit only — the authoring gate refuses that shape outright, for reasons unrelated to this rule, so create is deliberately not asserted for it)

Four control legs are pinned clean on both doors, so the refusal is a reading and
not an artefact — empty appearance; a grid-only allowedVisualizations; a
calendar: block with no allowedVisualizations at all; and 'calendar' offered
with the block declared. That last one also discharges the card's item 1 at this
door: the block carries startDateField and no titleField, which 17.3.0 made
optional (title falls back to the ADR-0079 record display name).

A fifth canary pins the neighbouring, distinct refusal: an empty calendar: {} answers
config.calendar.startDateField / expected string, one level deeper. It is what makes
the path assertions above mean something.

Deliberate message coupling, with a named owner

These assertions couple to the spec's message text, as every CANARY in this file
already does deliberately. Only the message's first clause is asserted — the part
that names the rule — never the whole string, so the spec stays free to reword its
guidance prose.

Owner of the coupling: @objectstack/spec's list-view refinement, objectstack#14075
(the PR addressing objectstack#13817). If that message is reworded, this pin is what tells
objectui. The fix is then to re-measure the clause — never to drop the assertion. This
is written into the suite's docblock so the next reader inherits it.

Accepted cost, recorded rather than waved off (the PM's ruling says the same): this
is a domain:ui-owned suite, so a spec-contract fact now lives outside the spec lane,
where a UI refactor could delete it without a spec seat noticing.

One thing the docblock states that a reader would otherwise get wrong

This refusal does not travel through the union-expansion machinery the rest of this
file exists to pin. Measured: it arrives as one issue already addressed to the right
path — the spec addresses it itself and the mapping leaves it alone. A green here is
therefore not evidence about that expansion, and the docblock says so.

Verification

Every exit code captured before any pipe; verdicts read from each tool's own printed
line. Heavy runs went through the container's shared verify lock.

  • pnpm exec vitest run …/clientValidation.viewDiagnostics.test.ts80 passed (80),
    9 of them new. Run from the repo root, never --filter … exec (objectui#3378).
  • Dependency closure built first: pnpm --filter '@object-ui/app-shell^...' build — exit 0.
  • pnpm --filter @object-ui/app-shell type-check — exit 0 (it runs tsc --noEmit and
    tsc -p tsconfig.test.json). The test file is proven inside that program by
    tsc -p tsconfig.test.json --listFiles: 1 hit for this file, 0 for a control file that
    must not be there, out of 4454 listed.
  • pnpm exec vitest run --project unit packages/app-shell/ — 204 files, 2586 passed, 1 skipped.
  • pnpm exec vitest run --project dom --project dom-heavy packages/app-shell/src/views/metadata-admin/
    — 160 files, 1360 passed.
  • eslint . in packages/app-shell — exit 0, 1101 files, 0 errors.
  • Gates: check-changeset-presence exit 0 (its own line: "Every one of them has an EMPTY
    frontmatter — declared as releasing nothing, which is the explicit exemption and a
    complete answer to this gate"
    ), check-changeset-no-major 0, check-control-bytes 0,
    check-comment-mask-corpus 0, check-vi-mock-specifiers 0, check-vi-mock-inherit 0,
    check-governed-queue-guard --test on both changed paths: NOT GOVERNED.

Ablation — the pin is proven able to fail

Run from the committed state, mutation proven on disk before the run, restore proven
by state and never by an exit code. The mutation removed the trigger from the shared
fixture (allowedVisualizations dropped 'calendar'), which is the condition the rule
gates on.

old-text hits before/after : 1 -> 0      new-text hits before/after : 0 -> 1
on-disk hash after mutation: 2bb7df94…   HEAD blob: 5c8a75c7…      (differ, so it landed)

Tests  4 failed | 76 passed (80)
  x CANARY: a ViewItem offering calendar with no `calendar:` block is refused AT `config.calendar` on the EDIT door
  x CANARY: the same body is refused AT `config.calendar` on the CREATE door - a different schema, the same answer
  x CANARY: an aggregated container is refused AT `list.calendar` on BOTH doors
  x CANARY: a flattened list-view overlay is refused AT a bare `calendar` - the third door, edit only
  AssertionError: expected true to be false

Restore, by state: git diff HEAD empty, git status --porcelain empty, and
git hash-object == git rev-parse HEAD:PATH (5c8a75c7… both). Re-run after restore:
80 passed (80).

The calendar: {} canary stayed green under that ablation, which is the informative
result rather than a gap: it pins the block's own required key, a different rule.

Notes for the lander


🤖 Generated with Claude Code

https://claude.ai/code/session_01YBWFb5YgMU5dw8p2VKj16S


Generated by Claude Code

…e client gate

@objectstack/spec 17.3.0 refuses a list view whose
`appearance.allowedVisualizations` offers 'calendar' without a
`calendar: { startDateField }` block, and made `calendar.titleField`
optional in the same release. metadata-admin's client validation opens
the refined doors directly (`ViewMetadataSchema` on edit,
`ViewItemSchema`/`ViewSchema` on create), so both facts are now pinned
there, with exact paths and the message's rule-naming first clause.

Pinned here rather than in `packages/types`' spec-parity suites: those
mirrors are `z.object(kept).partial()` rebuilds of the spec shape's
entries, so a spec refinement is structurally unreachable in them and
the mirror accepts the refused body cleanly.

Four control legs are pinned clean on both doors so the refusal is a
reading: empty `appearance`, a grid-only `allowedVisualizations`, a
`calendar:` block with no `allowedVisualizations`, and the declared
pair. An empty `calendar: {}` is pinned as the neighbouring, distinct
refusal one level deeper.

Test-only; the changeset declares no release.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YBWFb5YgMU5dw8p2VKj16S
@github-actions

github-actions Bot commented Sep 7, 2026

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 50 chunks) 3472.2 KB 3512.7 KB
Main entry chunk (gzip) 143.9 KB 350 KB
Entry file index-rjCZWbsD.js
Status PASS

The eager closure is every chunk the entry reaches through static imports — what the browser fetches and parses before the app renders. The entry chunk on its own is a small fraction of it.


📦 Bundle Size Report

Package Size Gzipped
app-shell (consoleActionDispatch.js) 0.20KB 0.19KB
app-shell (index.js) 15.67KB 5.75KB
app-shell (runtime-config.js) 20.68KB 7.36KB
app-shell (types.js) 0.01KB 0.04KB
app-shell (urlParams.js) 10.06KB 3.86KB
auth (ActiveOrganizationStorage.js) 25.05KB 9.16KB
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 2.07KB 1.00KB
auth (AuthProvider.js) 40.18KB 10.59KB
auth (AuthShell.js) 3.49KB 1.40KB
auth (ForgotPasswordForm.js) 12.21KB 3.45KB
auth (LoginForm.js) 18.15KB 5.39KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.65KB 2.22KB
auth (SocialSignInButtons.js) 9.61KB 3.89KB
auth (UserMenu.js) 3.41KB 1.23KB
auth (auth-gate-events.js) 1.29KB 0.66KB
auth (authStyles.js) 5.04KB 1.72KB
auth (createAuthClient.js) 40.21KB 10.80KB
auth (createAuthenticatedFetch.js) 8.46KB 3.43KB
auth (index.js) 3.19KB 1.44KB
auth (invitation-status.js) 1.22KB 0.70KB
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) 5.30KB 1.02KB
auth (useWorkspaceAdminStatus.js) 5.13KB 2.35KB
collaboration (CommentThread.js) 26.08KB 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.68KB 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) 497.99KB 113.90KB
core (index.js) 7.48KB 2.96KB
create-plugin (index.js) 10.08KB 3.26KB
data-objectstack (index.js) 189.15KB 52.56KB
fields (index.js) 243.15KB 61.40KB
i18n (LocalizationContext.js) 1.76KB 0.96KB
i18n (builtinAggregateLabels.js) 0.86KB 0.49KB
i18n (currency.js) 1.22KB 0.64KB
i18n (fallbackInterpolation.js) 6.25KB 2.77KB
i18n (i18n.js) 6.57KB 2.76KB
i18n (index.js) 3.65KB 1.47KB
i18n (pickLocalized.js) 7.62KB 3.26KB
i18n (provider.js) 26.89KB 9.04KB
i18n (useDisplayLocale.js) 2.85KB 1.45KB
i18n (useObjectLabel.js) 34.34KB 9.17KB
i18n (useSafeTranslation.js) 5.60KB 2.33KB
layout (index.js) 38.84KB 10.94KB
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.75KB
mobile (index.js) 1.99KB 0.87KB
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.72KB 0.42KB
mobile (useSpecGesture.js) 4.39KB 1.66KB
mobile (useTouchTarget.js) 1.01KB 0.54KB
permissions (MePermissionsProvider.js) 11.71KB 4.29KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 6.24KB 2.16KB
permissions (discardProofCache.js) 1.04KB 0.55KB
permissions (evaluator.js) 5.12KB 1.74KB
permissions (index.js) 0.93KB 0.41KB
permissions (store.js) 0.91KB 0.42KB
permissions (useFieldPermissions.js) 1.28KB 0.53KB
permissions (usePermissions.js) 4.83KB 2.27KB
plugin-ai (index.js) 15.16KB 3.68KB
plugin-calendar (index.js) 48.03KB 13.29KB
plugin-charts (index.js) 71.39KB 19.92KB
plugin-chatbot (index.js) 193.54KB 46.04KB
plugin-dashboard (index.js) 131.48KB 34.45KB
plugin-designer (index.js) 213.21KB 43.63KB
plugin-detail (index.js) 248.56KB 63.89KB
plugin-editor (index.js) 2.23KB 1.05KB
plugin-form (index.js) 131.01KB 32.32KB
plugin-gantt (index.js) 167.16KB 40.99KB
plugin-grid (index.js) 208.58KB 56.63KB
plugin-kanban (index.js) 52.83KB 14.63KB
plugin-list (index.js) 113.38KB 27.73KB
plugin-map (index.js) 20.49KB 6.83KB
plugin-markdown (index.js) 13.88KB 4.80KB
plugin-report (index.js) 43.42KB 11.92KB
plugin-timeline (index.js) 30.10KB 8.74KB
plugin-tree (index.js) 9.33KB 3.25KB
plugin-view (index.js) 84.46KB 20.80KB
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.66KB 3.50KB
providers (index.js) 0.45KB 0.23KB
providers (types.js) 0.01KB 0.04KB
react-runtime (index.js) 5.62KB 2.34KB
react (LazyPluginLoader.js) 4.47KB 1.63KB
react (SchemaRenderer.js) 81.07KB 26.86KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 4.63KB 2.18KB
react (schema-input.js) 2.32KB 1.24KB
react (spec-input.js) 0.20KB 0.18KB
sdui-parser (codegen.js) 6.58KB 2.74KB
sdui-parser (dashboard-widget-options.js) 3.08KB 1.30KB
sdui-parser (index.js) 5.55KB 2.45KB
sdui-parser (input-type.js) 2.84KB 1.40KB
sdui-parser (parse.js) 20.57KB 5.88KB
sdui-parser (provenance.js) 3.66KB 1.82KB
sdui-parser (types.js) 0.28KB 0.23KB
sdui-parser (validate.js) 13.64KB 4.59KB
types (ai.js) 0.20KB 0.17KB
types (api-types.js) 0.20KB 0.18KB
types (app.js) 2.87KB 1.00KB
types (base.js) 0.20KB 0.18KB
types (blocks.js) 0.20KB 0.18KB
types (complex.js) 2.74KB 1.41KB
types (crud.js) 0.20KB 0.18KB
types (dashboard-filter-alias.js) 6.23KB 2.74KB
types (data-display.js) 3.75KB 1.85KB
types (data-protocol.js) 0.20KB 0.19KB
types (data.js) 0.20KB 0.18KB
types (designer.js) 1.85KB 0.85KB
types (disclosure.js) 0.20KB 0.18KB
types (error-code.js) 1.54KB 0.88KB
types (expression.js) 0.20KB 0.18KB
types (feedback.js) 0.20KB 0.18KB
types (field-types.js) 0.20KB 0.18KB
types (form.js) 0.20KB 0.18KB
types (http-inflight.js) 8.87KB 3.73KB
types (http-retry.js) 4.32KB 2.02KB
types (icon-key-migration.js) 4.26KB 1.63KB
types (index.js) 4.74KB 2.25KB
types (layout.js) 0.20KB 0.18KB
types (managed-by.js) 0.19KB 0.18KB
types (mobile.js) 4.73KB 2.28KB
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 (select-option.js) 0.20KB 0.19KB
types (spec-report.js) 5.05KB 1.93KB
types (spec-ui-namespace.js) 0.20KB 0.19KB
types (system-fields.js) 3.33KB 1.54KB
types (theme.js) 6.28KB 2.87KB
types (ui-action.js) 8.11KB 3.32KB
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

@os-justin
os-justin marked this pull request as ready for review September 7, 2026 10:26
@os-justin
os-justin enabled auto-merge September 7, 2026 10:26
@os-justin
os-justin added this pull request to the merge queue Sep 7, 2026
Merged via the queue into main with commit ee6d00d Sep 7, 2026
34 checks passed
@os-justin
os-justin deleted the claude/issue-7122-listview-crossfield-calendar-parity branch September 7, 2026 11:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

When bumping @objectstack/spec past objectstack#14075: list-view spec-parity pins need the CalendarConfig titleField-optional update

2 participants