Skip to content

fix(app-shell): the interface page relays its source view's tree and chart blocks, and its own allowPrinting; a census pins every member ListView reads (objectui#11572) - #11575

Merged
objectstack-fleet[bot] merged 2 commits into
mainfrom
claude/issue-11572-interface-relay-census
Oct 3, 2026
Merged

objectstack-fleet[bot] merged 2 commits into
mainfrom
claude/issue-11572-interface-relay-census

Conversation

@objectstack-fleet

Copy link
Copy Markdown
Contributor

Fixes #11572

Clause-②: no

What changed

InterfaceListPage builds the list schema it hands ListView itself, key by key, from its page config and the view its deprecated sourceView resolves to. Measured on origin/main 0685646 before any edit: a stored row { type: 'tree', tree: { parentField: 'parent_id' } } on a page whitelisting ['tree'] reached ListView with viewType: 'tree' and tree undefined, so the tree branch had no parentField. A spec-valid chart row (chart: { dataset, dimensions, values }, whitelisted ['chart']) lost its block the same way. The object page relays both, so one stored view drew two ways.

  1. tree and chart are relayed whole (a pointer, not a projection of their keys, as the object page forwards the chart block), as conditional spreads beside the map block. Both are written only when the view declares them, so a view without them hands down the same key set as before.
  2. derives(kind): no page-derived default exists for either kind (nothing on this page can guess a parent pointer or a measure), so the rule has nothing to gate. The declared block alone is relayed, and a whitelisted kind with no declared block still reaches ListView with none. A control case pins that nothing is invented.
  3. The page config's own allowPrinting (declared on InterfacePageConfigSchema as "Allow users to print the page") was never written, so the toggle drew no print button. The census below found it, and it is now relayed from the page config only, beside showRecordCount; the source view's copy does not stand in for it. This is the honest disposition the dispatch asked for instead of a ledger entry: a page-declared key the renderer reads and this page dropped. It uses the bounded in-place rule (same defect class, mechanical one-line fix, same file under this claim, covered by the same pin).

The census (the card's acceptance)

InterfaceListPage.relayCensus-11572.test.ts, beside the 10638 pin. Its population is derived, never listed:

  • Population: every top-level member ListView.tsx reads off its list schema, found with the TypeScript parser, so comments never count. The scan follows every read shape (schema.X, schema?.X, (schema as any).X, schema['X'], destructuring) and accounts for every place the schema escapes whole: a call into a helper declared in ListView.tsx whose parameter is itself named schema (its reads join the scan), the one fold normalizeListViewSchema(propSchema), and hook dependency lists. Any other escape (a child handed schema={schema}, an alias, a helper with a differently named parameter) fails by name, because reads behind it would be invisible. A fixture control runs the same scan on an inline source and checks it answers both ways (sees code, not prose; flags an unfollowable escape). At 23030ff the population is 56 members; the pin asserts no count.
  • Relayed: the schema memo's literal writes the member and the written value reads viewDef or a local derived from it, to any depth (view, appearance, allowed, kanban, ...).
  • Answered: every other member has a ledger entry with a kind and a one-line reason, and each kind carries mechanical evidence checked on every run:
kind evidence the pin re-checks members at 23030ff
page-owned still written from the page config key it names; that key is on InterfacePageConfigSchema addRecord, showRecordCount, allowPrinting, userActions, inlineEdit
page-prop the page reads cfg.recordAction and the ListView element carries onRowClick navigation
page-binding the page binds through cfg.source objectName, data
page-text the page renders page.label / page.description itself label, description
page-constant / closed-surface allowExport is still the literal false allowExport, exportOptions
not-inherited a key of the spec's stored-view shape, NOT a page config key, not written aria, compactToolbar, conditionalFormatting, filterableFields, resizable, rowHeight, selection, rowActions, bulkActions, bulkActionDefs, sharing
off-spec / host-runtime NOT a key of the spec's (closed) stored-view shape, not written groupBy, groupBy2, columnState, wrapHeaders, operations, rowActionDefs, id, onDensityChange, onNavigate, refreshTrigger

Plus: no ledger entry may name a member that is relayed or no longer read, every reason must have content, the tree/chart (11572) and hiddenFields/fieldOrder (10638) relays are named checks, and a write-direction check refuses a key the literal writes that ListView does not read (the node discriminator type is the one named exception), which also keeps a legacy spelling out of the literal.

Where the line sits, and why. The spec describes sourceView as "@deprecated Back-compat only. Pre-revision pages inherited columns/filter/sort from a named object view". So the census treats as relayable the inherited data (column composition, filter, sort) and the visualization bindings the page whitelists and has no slot for (kanban ... tree, chart). Spec view keys outside both, with no page slot, are answered not-inherited, each with a page-layer reason as well. This is the spec's own line, not a way to make the pin green; the one member that failed that test (allowPrinting) was relayed instead. The open question in the report asks whether the maintainer wants that line moved.

Ablations (each committed first, mutated through ablation-replace.mjs, restored and proven against HEAD)

Both pins resolve their subject from source on disk (a relative import and readFileSync), not through a package exports / dist, so no build leg applies.

  1. Remove the tree relay in InterfaceListPage.tsx: anchor 1 to 0, blob aebbafa to 10e1955. The census went red naming tree ("expected [ 'tree' ] to deeply equal []") plus its named check; the three tree behavioral cases went red; chart and all controls stayed green. Restored: blob equals HEAD (aebbafa), git diff HEAD empty.
  2. Plant an unlisted schema.newKey read in ListView.tsx: the first attempt was a no-op, refused by the tool because my replacement re-contained the anchor (anchor 1 to 1); vitest never ran and that reading is void. Re-anchored so the anchor is consumed: anchor 1 to 0, blob 5295667 to ac7671a; the census went red naming exactly newKey (1 failed, 17 passed). Restored: blob equals HEAD, git diff HEAD empty.

Verification (union run after the final commit, 23030ff)

  • Red on the base first: the new behavioral pin at 0685646 had 5 failed / 4 passed (the three tree/chart fix cases, the precedence case and the allowPrinting fix case red; the four controls green).
  • pnpm exec turbo run build --filter='@object-ui/app-shell^...' --concurrency=2: 28 of 28 tasks successful.
  • pnpm --filter @object-ui/app-shell type-check (tsc --noEmit && tsc -p tsconfig.test.json): exit 0; --listFilesOnly on the test project lists both new test files.
  • Narrowed tests, declared: pnpm exec vitest run over every InterfaceListPage* / ObjectView* / PageView* test in app-shell (55 files) plus every other test file that names InterfaceListPage (15 files, across app-shell, components, core, data-objectstack, i18n, plugin-calendar, plugin-list, types): 70 files, 864 tests passed. The full pnpm test is CI's.
  • Gates, all exit 0: check:control-bytes, check:new-line-citations (0 new), check:changeset-claims, check:pending-changeset-literals, check-changeset-presence, -no-major, -fixed, -overwrite, check:test-path-roots, check:vi-mock-specifiers, -inherit, -override-shape, check:phantom-deps, check:spec-symbols, check:unreferenced-sources, check:handler-key-reads, check-hand-rolled-comment-mask, check:self-import, check-type-check-coverage.
  • check:changeset-claims asked for one re-read: .changeset/7218-rowcolor-host-relay.md names InterfaceListPage.tsx ("has shipped rowColor: view.rowColor next to grouping and pagination"). Re-read against this diff: still true, those rungs are untouched.
  • Narrowed lint, a measurement: eslint --format json from packages/app-shell (as turbo run lint runs it) over the 3 changed source files: 3 files in the output, 0 errors (warnings are no-explicit-any on pre-existing lines and in the test mocks, as in the 10638 sibling; --max-warnings is deliberately unset in lint.yml). Population read from the config: the root eslint.config.js is the only config. Invariance: it enables no type-aware linting (no projectService / parserOptions.project), so this diff cannot move a verdict on an untouched file. Repo-wide pnpm lint is CI's.

Acceptance notes (observations, not filed)

  • The literal relays some view members outside the spec's columns/filter/sort line: grouping, rowColor, pagination, searchableFields, emptyState, and the view's appearance as the page's fallback. They predate this change; the census counts them as relayed and neither retires nor extends them. Carrier: none.
  • The page config declares levels ("Number of hierarchy levels to display"), and nothing in this tree reads it. Dormant, outside this population (ListView does not read it). Carrier: none.
  • No guide page under content/docs documents what an interface page takes from its sourceView, so there is no doc to bring in line; the census is the instrument that says it.
  • ObjectView.tsx and ListView.tsx are untouched (the latter only mutated temporarily, and restored, for ablation 2).

Out of scope and reported for the seat to file (not filed here): CreateViewDialog writes a chart view's block as { chartType, xAxisField, yAxisFields }, and buildSaveAsViewSpec spreads that payload into the persisted spec, while @objectstack/spec 17.6.0's ListViewSchema refuses xAxisField / yAxisFields on chart by name and requires dataset and values (measured with safeParse; the save door itself was not exercised).

Implemented by session session_01FjqrwXPfSMkSfkKYDSRkN2 (domain:ui seat 1, os-dev dispatch).


Generated by Claude Code

claude added 2 commits October 3, 2026 19:49
…chart blocks, and its own allowPrinting; a census pins every member ListView reads

InterfaceListPage hand-projects the list schema it hands ListView. The
projection carried the kanban/calendar/gallery/timeline/gantt/map blocks
but not tree or chart, so a page whitelisting either kind reached the
renderer with viewType tree/chart and no block. Both are now relayed whole
(no page-derived default exists for either kind, so derives() has nothing
to gate). The page config's own allowPrinting was never written either;
it is now relayed from the page config, like showRecordCount.

The new relay census derives, with the TypeScript parser, every top-level
member ListView.tsx reads off its schema (accounting for every whole-schema
escape), and requires each to be relayed from the view or answered in a
ledger whose kinds carry mechanical evidence (page config keys, spec view
keys, the ListView element's props).

Claude-Session: https://claude.ai/code/session_01FjqrwXPfSMkSfkKYDSRkN2
Co-authored-by: Claude <noreply@anthropic.com>
…, and keep the census header from stating a count

Claude-Session: https://claude.ai/code/session_01FjqrwXPfSMkSfkKYDSRkN2
Co-authored-by: Claude <noreply@anthropic.com>
@github-actions

github-actions Bot commented Oct 3, 2026

Copy link
Copy Markdown
Contributor

changeset-claim-re-read

⚠️ 1 pending changeset(s) describe a file this change touches

Their bodies publish verbatim into the CHANGELOG at the next release, so this is a request to re-read them against your diff — addressed here because you are the one seat that can answer it without re-deriving anything.

⛔ Nothing here blocks, and nothing here is a verdict on your change. This gate exits 0, is not a required context, and judges name resolution, never meaning: it asked whether a pending body names a file you touched. "Is this sentence still true?" is the one question it will not answer, and the one you are being asked to answer.

.changeset/7218-rowcolor-host-relay.md

  • names InterfaceListPage.tsx → packages/app-shell/src/views/InterfaceListPage.tsx — edited by this change

    This is a relay, not a new surface. The interface route (InterfaceListPage.tsx) has shipped rowColor: view.rowColor next to grouping and pagination since ADR-0047, into a schema typed ListViewSchema, with no fence of any kind — so the key was already author-reachable and already had a delivery path; two of three hosts simply did not use it. The legacy shorthand for the same feature (bare color) already had a rung in both literals; only the spec-canonical spelling was missing.

Read the paragraph, not the line: both false halves of the objectui#8617 claim sat in one paragraph, and correcting either alone would have left it asserting the same wrong thing.

If a claim did go false, correct the body. That is precedented and prose-only, frontmatter untouched; check-changeset-overwrite.mjs will report the correction as its own case 2 ("correcting a declaration on purpose … legitimate"), which is the intended shape — one gate asks for the read, the other records the write.

Not covered, stated so nobody reads this as more: a born-false claim that spells no line address at all (objectui#9495 coordinated one by ORDINAL — "a grep finds that member first" — and deciding that means reading what the sentence means), a claim spelled as a symbol or a package rather than a backticked file name, and a file named ambiguously.

Compared the checked-out tree with 8d0ca9183 (merge-base with origin/main): 3 file(s) changed outside .changeset/, read against 2094 pending declaration(s) that publish a body (2729 pending in total). · run

@github-actions

github-actions Bot commented Oct 3, 2026

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 330 chunks) 3310.8 KB 3330.4 KB
Main entry chunk (gzip) 151.3 KB 350 KB
Entry file index-CllcMKFv.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) 17.22KB 6.37KB
app-shell (runtime-config.js) 20.68KB 7.36KB
app-shell (types.js) 0.01KB 0.04KB
app-shell (urlParams.js) 10.11KB 3.87KB
auth (ActiveOrganizationStorage.js) 27.95KB 10.04KB
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 2.07KB 1.00KB
auth (AuthProvider.js) 40.22KB 10.61KB
auth (AuthShell.js) 3.49KB 1.40KB
auth (ForgotPasswordForm.js) 12.21KB 3.45KB
auth (LoginForm.js) 18.17KB 5.40KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.72KB 2.24KB
auth (SocialSignInButtons.js) 9.70KB 3.93KB
auth (UserMenu.js) 3.39KB 1.21KB
auth (auth-gate-events.js) 1.29KB 0.66KB
auth (authStyles.js) 5.04KB 1.72KB
auth (createAuthClient.js) 40.70KB 10.94KB
auth (createAuthenticatedFetch.js) 8.54KB 3.46KB
auth (index.js) 3.63KB 1.64KB
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) 11.08KB 4.58KB
collaboration (CommentThread.js) 27.11KB 7.97KB
collaboration (LiveCursors.js) 3.17KB 1.27KB
collaboration (PresenceAvatars.js) 6.28KB 2.60KB
collaboration (PresenceProvider.js) 2.79KB 1.13KB
collaboration (index.js) 1.68KB 0.73KB
collaboration (useCollaborationTranslation.js) 6.50KB 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) 572.97KB 137.34KB
core (index.js) 10.00KB 3.96KB
create-plugin (index.js) 27.94KB 9.51KB
data-objectstack (index.js) 232.57KB 64.51KB
fields (index.js) 261.62KB 66.20KB
i18n (LocalizationContext.js) 1.76KB 0.96KB
i18n (builtinAggregateLabels.js) 0.86KB 0.49KB
i18n (currency.js) 2.59KB 1.22KB
i18n (fallbackInterpolation.js) 6.25KB 2.77KB
i18n (i18n.js) 8.87KB 3.64KB
i18n (index.js) 5.24KB 2.27KB
i18n (pickLocalized.js) 9.86KB 3.95KB
i18n (provider.js) 39.35KB 12.88KB
i18n (translateFn.js) 0.20KB 0.18KB
i18n (useDisplayLocale.js) 3.52KB 1.76KB
i18n (useObjectLabel.js) 35.66KB 9.49KB
i18n (useSafeTranslation.js) 7.14KB 2.92KB
layout (index.js) 39.47KB 11.25KB
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) 6.62KB 2.45KB
mobile (useResponsive.js) 0.72KB 0.42KB
mobile (useSpecGesture.js) 5.52KB 2.10KB
mobile (useTouchTarget.js) 1.01KB 0.54KB
permissions (MePermissionsProvider.js) 13.86KB 5.00KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 6.52KB 2.26KB
permissions (discardProofCache.js) 1.04KB 0.55KB
permissions (evaluator.js) 8.33KB 3.07KB
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) 16.04KB 3.92KB
plugin-calendar (index.js) 53.17KB 15.46KB
plugin-charts (index.js) 83.60KB 22.89KB
plugin-chatbot (index.js) 198.22KB 46.97KB
plugin-dashboard (index.js) 142.26KB 38.44KB
plugin-designer (index.js) 231.28KB 48.76KB
plugin-detail (index.js) 245.60KB 64.57KB
plugin-editor (index.js) 2.23KB 1.05KB
plugin-form (index.js) 175.44KB 45.28KB
plugin-gantt (index.js) 179.16KB 45.06KB
plugin-grid (index.js) 235.02KB 64.63KB
plugin-kanban (index.js) 49.59KB 15.58KB
plugin-list (index.js) 116.46KB 28.93KB
plugin-map (index.js) 25.60KB 8.62KB
plugin-markdown (index.js) 13.88KB 4.80KB
plugin-report (index.js) 44.12KB 12.29KB
plugin-timeline (index.js) 38.80KB 11.71KB
plugin-tree (index.js) 14.51KB 5.15KB
plugin-view (index.js) 90.23KB 22.73KB
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.81KB 3.58KB
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) 120.63KB 39.56KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 4.50KB 2.06KB
react (schema-input.js) 4.25KB 2.04KB
react (spec-input.js) 0.20KB 0.18KB
sdui-parser (body-dialect.js) 4.50KB 1.99KB
sdui-parser (codegen.js) 9.45KB 3.76KB
sdui-parser (dashboard-widget-options.js) 3.08KB 1.30KB
sdui-parser (index.js) 6.06KB 2.68KB
sdui-parser (input-type.js) 2.84KB 1.40KB
sdui-parser (parse.js) 25.28KB 7.80KB
sdui-parser (provenance.js) 3.84KB 1.90KB
sdui-parser (types.js) 0.28KB 0.23KB
sdui-parser (validate.js) 21.42KB 7.05KB
types (ai.js) 4.39KB 2.17KB
types (api-types.js) 0.20KB 0.18KB
types (app.js) 4.12KB 1.61KB
types (authoring-nodes.js) 0.20KB 0.19KB
types (base.js) 0.20KB 0.18KB
types (blocks.js) 0.20KB 0.18KB
types (cloud.js) 0.20KB 0.18KB
types (complex.js) 4.16KB 1.96KB
types (crud.js) 0.20KB 0.18KB
types (dashboard-filter-alias.js) 6.23KB 2.74KB
types (dashboard-widget-layout.js) 2.06KB 0.96KB
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) 5.07KB 2.39KB
types (layout.js) 0.20KB 0.18KB
types (managed-by.js) 0.19KB 0.18KB
types (mobile.js) 5.00KB 2.39KB
types (navigation.js) 0.20KB 0.18KB
types (objectql.js) 0.20KB 0.18KB
types (overlay.js) 0.20KB 0.18KB
types (permissions.js) 2.52KB 1.31KB
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) 4.99KB 1.96KB
types (spec-ui-namespace.js) 0.20KB 0.19KB
types (strict-authoring-face.js) 19.93KB 7.25KB
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

@objectstack-fleet
objectstack-fleet Bot marked this pull request as ready for review October 3, 2026 20:29
@objectstack-fleet
objectstack-fleet Bot enabled auto-merge October 3, 2026 20:29
@objectstack-fleet
objectstack-fleet Bot added this pull request to the merge queue Oct 3, 2026
Merged via the queue into main with commit 0903617 Oct 3, 2026
45 checks passed
@objectstack-fleet
objectstack-fleet Bot deleted the claude/issue-11572-interface-relay-census branch October 3, 2026 20:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

2 participants