Skip to content

docs(app-shell): grid-columns pin measures identity churn, not a column change - #6835

Merged
os-sam merged 1 commit into
mainfrom
claude/issue-6729-grid-pin-docstring
Aug 30, 2026
Merged

docs(app-shell): grid-columns pin measures identity churn, not a column change#6835
os-sam merged 1 commit into
mainfrom
claude/issue-6729-grid-pin-docstring

Conversation

@os-sales

Copy link
Copy Markdown
Collaborator

Fixes#6729

What moved

Comment and test title only, in packages/app-shell/src/views/studio-design/StudioDesignSurface.gridColumns.test.tsx. The assertion, the button it clicks, the field it drives and the coverage are all untouched — visible in the diff as unchanged context lines.

The second case was documented as "a REAL column change still refetches — the dependency stays live". Since cloud#1652 added the publishedFieldNames filter to gridColumns, that is no longer what it drives:

  • addField appends an unpublishedfield_N to objDraft.fields (StudioDesignSurface.tsx:2455-2463) — a draft edit; nothing is published, and setPublishedFieldNames is not called.
  • gridColumns recomputes (its dep is objDraft.fields), then ends with .filter((n) => publishedFieldNames.has(n)) (:2407), and publishedFieldNames is populated from the server baseline alone (:2349, the layered() response) — never from the draft.
  • So field_N is filtered back out, and what reaches the grid is an array of equal content carrying a fresh identity. There is no remount to explain the refetch either: the grid's key is current.name plus gridVer (:2900), and gridVer does not move.

The case therefore pins identity-churn liveness, and its prose asserted the opposite. The new docstring states that, names cloud#1652 as the cause so the next reader does not re-derive it, and points at where the genuine content-change case actually lives.

Triage order — which branch this took

The card made dispatch conditional on two preconditions. Both verified against origin/main, not a branch and not the card:

  1. objectui#6697 has landed.git log origin/main --grep='#6725' gives 06b8c42f6 fix(plugin-detail,components,plugin-list): re-key three fetch effects onto the primitives they read (#6697) (#6725).
  2. The sibling coverage holds.packages/plugin-list/src/__tests__/ListView.discardedExpandFieldsMemo.test.tsx is present on origin/main — added by that same commit, a positive control that ties the two together — and carries the case still DOES re-fetch when the columns change WITHOUT changing what must be expanded: the column content moves (['name','account'] to ['name','account','status']), $expand stays byte-identical at ['account'], a refetch is asserted, and $select is where the change is read. That is verbatim the case the card quoted as the one census(finding): three more renderer fetch effects key on a memoised object identity, outside objectui#6592's dataConfig family #6697's repair had to add.

branch 2: correct the prose and change nothing else. Not branch 3, so nothing here needs a ruling, and option B is not opened.

Measurement behind the new docstring

Rather than deriving the drift from source alone, I drove the real pillar with a throwaway probe (an untracked copy of the suite, deleted before the commit — the tree is clean) and recorded what the grid actually asks for across the click:

PROBE6729 findCalls=2
PROBE6729 select_before=["id","name","status"]
PROBE6729 select_after =["id","name","status"]

with expect(select_after).not.toContain('field_') green. So the click does refetch (1 to 2), the projection is unchanged, and the new field never reaches it. Identity churn is the entire trigger — which is what the docstring now says.

Verification

All at 3e4dfa200. git diff HEAD and git status --short are both empty, so the tree every gate below ran against is exactly this commit.

Run from the repo root with repo-root-relative paths — never pnpm --filter PKG exec vitest, which re-roots at the package and cheerfully reports another package's files as passing. The reporter confirms the root and the executed file names:

RUN v4.1.10 /home/user/objectui-6729
✓ |dom| packages/plugin-list/src/__tests__/ListView.discardedExpandFieldsMemo.test.tsx > ... > provesTheProxyDiscriminates: the proxy reaches the same React binding the component uses
✓ |dom| packages/plugin-list/src/__tests__/ListView.discardedExpandFieldsMemo.test.tsx > ... > does not re-fetch when `expandFields` is discarded under an UNCHANGED column set
✓ |dom| packages/plugin-list/src/__tests__/ListView.discardedExpandFieldsMemo.test.tsx > ... > still DOES re-fetch when the columns change WITHOUT changing what must be expanded
✓ |dom| packages/plugin-list/src/__tests__/ListView.discardedExpandFieldsMemo.test.tsx > ... > still DOES re-fetch when the column set genuinely changes what must be expanded
✓ |dom| packages/app-shell/src/views/studio-design/StudioDesignSurface.gridColumns.test.tsx > ... > three no-op re-renders issue NO extra find()
✓ |dom| packages/app-shell/src/views/studio-design/StudioDesignSurface.gridColumns.test.tsx > ... > a fresh columns array of EQUAL content still refetches — identity-churn liveness
Test Files 2 passed (2)
Tests 6 passed (6)
  • Lint — full repo, not narrowed: turbo run lint --concurrency=2Tasks: 47 successful, 47 total, every package reporting 0 errors (the standing warnings are pre-existing and untouched). The edited file produces no output at all, not even a warning.
  • Type-check: turbo run type-check --filter @object-ui/app-shellTasks: 30 successful, 30 total, running tsc --noEmit && tsc -p tsconfig.test.json. The second project is the one that matters here: its include is src/**/*.test.ts(x), so the edited file is genuinely in the program rather than excluded from it.
  • Control bytes: grep -naP '[\x00-\x08\x0b\x0c\x0e-\x1f\x7f]' on the edited file — no hits.

Changeset

Owed, and declared as releasing nothing. The gate's own verdict decided it rather than my reading: with the edit alone it printed

❌ 1 source file(s) of 1 released package(s) changed, and this change adds no changeset

because check-changeset-presence.mjs deliberately has no carve-out for test files under src/ — its header says such a change "is answered by the empty-frontmatter exemption, in one line". Added .changeset/olive-donkeys-smoke.md with empty frontmatter; the gate now prints

✅ 1 source file(s) of 1 released package(s) changed, and this change declares 1 changeset(s)
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.mjs is green as well. No files under content/docs/releases/ were touched.

Out of fence

Nothing filed — no unrelated defect surfaced. The one non-green thing in this run was a second case in my own throwaway probe, which looked for the new field's machine name in the DOM; the inspector renders its label, not field_N. That was a probe-authoring miss in a file that no longer exists, not a product finding.


Generated by Claude Code

…mn change
`StudioDesignSurface.gridColumns.test.tsx`'s second case was documented as
"a REAL column change still refetches — the dependency stays live". Since
cloud#1652 added the `publishedFieldNames` filter to `gridColumns`, that is
no longer what it drives: "+ Add field" appends an unpublished `field_N` to
the draft, `publishedFieldNames` is read from the server baseline alone and
so filters it back out, and what reaches the grid is an array of EQUAL
CONTENT carrying a FRESH IDENTITY. The case pins identity-churn liveness,
and its prose asserted the opposite.
Measured on origin/main: across the click `find()` goes 1 -> 2 while
`$select` stays `["id","name","status"]`, and no `field_` ever reaches the
projection.
Comment and test title only — the assertion, the path it drives and the
coverage are untouched. The genuine content-change case is pinned in
plugin-list's `ListView.discardedExpandFieldsMemo.test.tsx` (objectui#6697),
which moves `$select` while holding `$expand` byte-identical.
Refs objectui#6729.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CRJge11jso9TpXRWFt1Z49
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Eager closure (gzip, 45 chunks)3174.0 KB3222.7 KB
Main entry chunk (gzip)148.1 KB350 KB
Entry fileindex-BFe99tIZ.js
StatusPASS

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

PackageSizeGzipped
app-shell (consoleActionDispatch.js)0.20KB0.19KB
app-shell (index.js)11.89KB4.50KB
app-shell (runtime-config.js)20.61KB7.35KB
app-shell (types.js)0.01KB0.04KB
app-shell (urlParams.js)10.06KB3.86KB
auth (ActiveOrganizationStorage.js)25.05KB9.16KB
auth (AuthContext.js)0.31KB0.24KB
auth (AuthGuard.js)2.07KB1.00KB
auth (AuthProvider.js)40.18KB10.59KB
auth (AuthShell.js)3.49KB1.40KB
auth (ForgotPasswordForm.js)12.21KB3.45KB
auth (LoginForm.js)18.15KB5.39KB
auth (PreviewBanner.js)0.90KB0.50KB
auth (RegisterForm.js)6.65KB2.22KB
auth (SocialSignInButtons.js)9.61KB3.89KB
auth (UserMenu.js)3.41KB1.23KB
auth (auth-gate-events.js)1.29KB0.66KB
auth (authStyles.js)5.04KB1.72KB
auth (createAuthClient.js)40.21KB10.80KB
auth (createAuthenticatedFetch.js)8.46KB3.43KB
auth (index.js)3.19KB1.44KB
auth (invitation-status.js)1.22KB0.70KB
auth (org-roles.js)6.66KB2.78KB
auth (phone-identifier.js)1.11KB0.66KB
auth (types.js)0.59KB0.35KB
auth (useAuth.js)5.30KB1.02KB
auth (useWorkspaceAdminStatus.js)5.13KB2.35KB
collaboration (CommentThread.js)26.08KB7.56KB
collaboration (LiveCursors.js)3.17KB1.27KB
collaboration (PresenceAvatars.js)6.49KB2.64KB
collaboration (PresenceProvider.js)2.79KB1.13KB
collaboration (index.js)1.68KB0.73KB
collaboration (useCollaborationTranslation.js)6.05KB2.52KB
collaboration (useCommentSearch.js)1.98KB0.88KB
collaboration (useConflictResolution.js)7.75KB1.86KB
collaboration (useMentionNotifications.js)1.81KB0.68KB
collaboration (usePresence.js)6.33KB1.84KB
collaboration (useRealtimeSubscription.js)7.91KB2.01KB
components (index.js)511.50KB116.32KB
core (index.js)5.30KB2.13KB
create-plugin (index.js)10.08KB3.26KB
data-objectstack (index.js)173.10KB47.96KB
fields (index.js)240.93KB60.76KB
i18n (LocalizationContext.js)1.76KB0.96KB
i18n (currency.js)1.22KB0.64KB
i18n (fallbackInterpolation.js)6.25KB2.77KB
i18n (i18n.js)4.28KB1.75KB
i18n (index.js)3.44KB1.39KB
i18n (pickLocalized.js)7.62KB3.26KB
i18n (provider.js)26.89KB9.04KB
i18n (useDisplayLocale.js)2.85KB1.45KB
i18n (useObjectLabel.js)33.40KB8.71KB
i18n (useSafeTranslation.js)5.60KB2.33KB
layout (index.js)38.95KB10.97KB
mobile (MobileProvider.js)0.92KB0.49KB
mobile (ResponsiveContainer.js)0.94KB0.38KB
mobile (breakpoints.js)1.51KB0.70KB
mobile (createOfflineDataSource.js)5.61KB1.75KB
mobile (index.js)1.55KB0.62KB
mobile (offlineQueue.js)3.91KB1.35KB
mobile (pwa.js)0.97KB0.49KB
mobile (serviceWorker.js)1.48KB0.62KB
mobile (serviceWorkerSource.js)3.41KB1.48KB
mobile (useBreakpoint.js)1.54KB0.65KB
mobile (useGesture.js)6.96KB1.98KB
mobile (useOfflineSync.js)1.99KB0.72KB
mobile (usePullToRefresh.js)2.53KB0.85KB
mobile (useResponsive.js)0.72KB0.42KB
mobile (useResponsiveConfig.js)1.37KB0.63KB
mobile (useSpecGesture.js)4.32KB1.64KB
mobile (useTouchTarget.js)1.01KB0.54KB
permissions (MePermissionsProvider.js)9.53KB3.38KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)4.64KB1.50KB
permissions (evaluator.js)5.12KB1.74KB
permissions (index.js)0.93KB0.41KB
permissions (store.js)0.91KB0.42KB
permissions (useFieldPermissions.js)1.28KB0.53KB
permissions (usePermissions.js)1.93KB0.88KB
plugin-ai (index.js)15.75KB3.80KB
plugin-calendar (index.js)46.92KB12.93KB
plugin-charts (index.js)64.68KB18.35KB
plugin-chatbot (index.js)190.33KB45.10KB
plugin-dashboard (index.js)133.48KB34.51KB
plugin-designer (index.js)212.87KB43.19KB
plugin-detail (index.js)245.46KB62.46KB
plugin-editor (index.js)2.46KB1.10KB
plugin-form (index.js)133.03KB32.64KB
plugin-gantt (index.js)165.23KB40.37KB
plugin-grid (index.js)201.57KB54.55KB
plugin-kanban (index.js)53.14KB14.64KB
plugin-list (index.js)113.15KB27.59KB
plugin-map (index.js)20.20KB6.66KB
plugin-markdown (index.js)13.72KB4.69KB
plugin-report (index.js)43.51KB11.94KB
plugin-timeline (index.js)28.95KB8.33KB
plugin-tree (index.js)9.00KB3.08KB
plugin-view (index.js)85.87KB21.12KB
providers (DataSourceProvider.js)0.75KB0.39KB
providers (MetadataProvider.js)1.37KB0.59KB
providers (ThemeProvider.js)1.90KB0.85KB
providers (UploadProvider.js)11.66KB3.50KB
providers (index.js)0.45KB0.23KB
providers (types.js)0.01KB0.04KB
react-runtime (index.js)5.62KB2.34KB
react (LazyPluginLoader.js)4.47KB1.63KB
react (SchemaRenderer.js)76.75KB25.49KB
react (data-invalidation.js)5.05KB2.08KB
react (index.js)3.11KB1.48KB
react (schema-input.js)2.32KB1.24KB
react (spec-input.js)0.20KB0.18KB
sdui-parser (codegen.js)5.41KB2.34KB
sdui-parser (dashboard-widget-options.js)3.08KB1.30KB
sdui-parser (index.js)4.93KB2.24KB
sdui-parser (input-type.js)2.84KB1.40KB
sdui-parser (parse.js)20.57KB5.88KB
sdui-parser (provenance.js)3.66KB1.82KB
sdui-parser (types.js)0.28KB0.23KB
sdui-parser (validate.js)10.35KB3.60KB
types (ai.js)0.20KB0.17KB
types (api-types.js)0.20KB0.18KB
types (app.js)2.87KB0.99KB
types (base.js)0.20KB0.18KB
types (blocks.js)0.20KB0.18KB
types (complex.js)2.74KB1.41KB
types (crud.js)0.20KB0.18KB
types (dashboard-filter-alias.js)6.23KB2.74KB
types (data-display.js)3.75KB1.85KB
types (data-protocol.js)0.20KB0.19KB
types (data.js)0.20KB0.18KB
types (designer.js)1.85KB0.85KB
types (disclosure.js)0.20KB0.18KB
types (error-code.js)1.54KB0.88KB
types (feedback.js)0.20KB0.18KB
types (field-types.js)0.20KB0.18KB
types (form.js)0.20KB0.18KB
types (http-inflight.js)8.87KB3.73KB
types (http-retry.js)4.32KB2.02KB
types (icon-key-migration.js)4.26KB1.63KB
types (index.js)4.72KB2.24KB
types (layout.js)0.20KB0.18KB
types (managed-by.js)0.19KB0.18KB
types (mobile.js)2.59KB1.31KB
types (navigation.js)0.20KB0.18KB
types (objectql.js)0.20KB0.18KB
types (overlay.js)0.20KB0.18KB
types (permissions.js)0.20KB0.18KB
types (plugin-scope.js)0.20KB0.18KB
types (record-components.js)0.20KB0.19KB
types (record-semantics.js)1.28KB0.67KB
types (registry.js)0.20KB0.18KB
types (reports.js)0.20KB0.18KB
types (spec-report.js)5.05KB1.93KB
types (spec-ui-namespace.js)0.20KB0.19KB
types (system-fields.js)3.33KB1.54KB
types (theme.js)6.28KB2.87KB
types (ui-action.js)3.40KB1.71KB
types (views.js)0.20KB0.18KB
types (widget.js)0.20KB0.18KB

Size Limits

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

@os-sam
os-sam marked this pull request as ready for review August 30, 2026 03:35
@os-sam
os-sam added this pull request to the merge queueAug 30, 2026
Merged via the queue into main with commit 41e9fe7Aug 30, 2026
32 checks passed
@os-sam
os-sam deleted the claude/issue-6729-grid-pin-docstring branch August 30, 2026 03:49
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

3 participants

@os-sales@os-sam@claude