Skip to content

test(app-shell): pin the console sys_user_preference request budget per mount - #5593

Merged
os-sales merged 1 commit into
mainfrom
claude/issue-5544-console-request-dedup
Aug 21, 2026
Merged

test(app-shell): pin the console sys_user_preference request budget per mount#5593
os-sales merged 1 commit into
mainfrom
claude/issue-5544-console-request-dedup

Conversation

@os-sales

Copy link
Copy Markdown
Collaborator

Part of #5544

Deviation from dispatch, flagged deliberately. The dispatch said to use a closing keyword for this card. This PR does not fix the reported defect — it establishes that the headline duplicate is not a duplicate, and pins the correct budget. Closing the card on merge would bury the residual items listed at the bottom, which need triage. Retitle to a closing keyword if you disagree.

What was measured, before any fix was chosen

The card's prod/staging numbers are the card's measurement, taken in a browser against a deployed build. They are not reproduced here and are not claimed as mine. Everything below was measured against origin/main (cad512fe1) with a stubbed transport.

Caller census — sys_user_preference

ConsoleShell's UserStateBridge creates three adapters on a console boot, one per slot:

slotkeyconsumer
favoritesui.favoritesFavoritesProvider
recentui.recentRecentItemsProvider
flowPaletteRecentsui.flow.palette.recentsFlowPaletteRecentsProvider

createObjectStackUserStateAdapter binds one adapter to one (user, key) pair, and load() issues find('sys_user_preference', { $filter: { user_id, key }, $top: 1 }). Three different rows, differing only in the key predicate — which rides in the query string.

The classification

The card's reproduce snippet groups by new URL(r.name).pathname, which discards the query string. So three distinct KV reads collapse into one pathname and read as "×3 duplicates". The prod ×3 is the expected budget, not a defect.

Measured on main, one mount: 3 calls, 3 distinct keys, zero repeats. Under a StrictMode double-mount: still 3ObjectStackAdapter.find() already coalesces in-flight reads on resource + serialized params, so the second wave never reaches the transport.

The other endpoints on the card

  • meta/object ×2 / meta/view ×2 — already fixed on main under objectui#4042 (MetadataProvider's preview-mode effect skips its mount run) and already pinned by MetadataProvider.requestBudget.test.tsx, which is green. Nothing left to do here.
  • auth/get-session ×2 — two call sites by design: preflightAuth probes with the Bearer only (credentials: 'omit') to detect a stale token, then AuthProvider asks who the user is. Deduping them would break stale-Bearer detection. Not a duplicate to remove.
  • runtime/config ×2 / auth/me/localization ×2 — one boot call site each in this repo (initRuntimeConfig, languageSeed) plus the React provider for localization. The measured host is a cloud deployment, so a second runtime/config caller is not visible from this repo.
  • staging ×6 (= 3 keys × 2) — needs a second wave that escapes the coalescer. A StrictMode double-mount does not (measured). The MetadataProvider key={language} remount would, but the language is deliberately committed before React mounts and never flips late (languageSeed.ts documents exactly this). Not reproducible from this repo's main.

Why this PR ships a test and no source change

There is no measured duplicate on main to remove. The narrowest useful change is therefore a regression pin — and it guards against a specific, live hazard: the remedy the card proposes.

The card suggests "dedup at the request layer (in-flight requests sharing a Promise per key)". Read as endpoint-level dedup, that collapses the three distinct reads into one and starves two of the three consumers — while making a pathname-level count look perfect. So the test pins both directions together:

  1. exactly one read per distinct preference key across one mount, and
  2. every consumer still receives its own row.

Reverse-verification (ablation)

Mutated ObjectStackAdapter.find()'s coalescing key from resource + params to resource alone — the card's proposed remedy read literally.

  • mutation proven on disk: original anchor 1 -> 0, mutant anchor 0 -> 1, git diff --stat = 1 file changed, 1 insertion(+), 1 deletion(-)
  • no rebuild needed: vitest.config.mts aliases @object-ui/data-objectstack to packages/data-objectstack/src, so the test loads the mutated source directly
  • result: 2 of 3 tests RED. Budget test: expected [] to have a length of 1 but got +0 for ui.recent and ui.flow.palette.recents — three reads collapsed to one. Consumer test: expected [] to deeply equal [ 'object:contact' ] — consumers starved. The identical-reads case stayed green, correctly.
  • restored via trap ... EXIT INT TERM; git status --porcelain empty, original anchor back at count 1, all 3 green again.

Gates — all at a615125e5, exit codes captured before any pipe

gateverdict line
vitest (new file)Tests 3 passed (3)
vitest console + context + providersTest Files 73 passed (73) / Tests 516 passed (516)
vitestpackages/data-objectstack/Test Files 41 passed (41) / Tests 558 passed (558)
@object-ui/app-shelltype-checkexit 0, after building the ^... closure
@object-ui/app-shelllint2510 problems (0 errors, 2510 warnings) — all pre-existing; eslint on the new file alone emits nothing
check-control-bytescheck-control-bytes: OK (scanned 4647 tracked text file(s); skipped 85 binary).
check-changeset-presenceempty frontmatter accepted as the explicit "releases nothing" exemption
check-changeset-no-majorNo changeset declares a major bump.
check-changeset-fixedAll workspace packages are in the changeset fixed group.

Declared narrowing: the full packages/app-shell/ suite (482 test files) exceeds this container's foreground limit, so it was run as console/ + context/ + providers/ — the directories this test imports from. This cannot hide a failure: the diff is 2 files, 0 runtime source (one new test, one changeset), so no existing test's subject changed; and the dom project runs isolate: true, so a new file cannot leak module state into another. CI runs the whole farm regardless.

Residual items for triage (not addressed here)

  • Whether the deployed build the card measured predates objectui#4042; if so the prod meta ×2 is already gone and the card's remaining numbers should be re-taken.
  • The staging ×6 has no reproduction on this repo's main; it likely needs a measurement from the cloud deployment (cloud#1521).
  • runtime/config ×2 may have a second caller in the cloud repo, outside this repo's reach.

Generated by Claude Code

…er mount
objectui#5544 reported `/api/v1/data/sys_user_preference` ×3 on prod and ×6 on
staging in one cold load, grouped by URL pathname. Grouping by pathname is the
trap: `ConsoleShell`'s `UserStateBridge` attaches three adapters — `ui.favorites`,
`ui.recent`, `ui.flow.palette.recents` — which are three distinct rows that
differ only in the `key` predicate riding in the query string. Three reads is
the correct budget, not a duplicate.
The card proposes dedup at the request layer. That already exists:
`ObjectStackAdapter.find()` coalesces on `resource + serialized params`. The
hazard is a future fix widening that key to the ENDPOINT, which would collapse
the three reads into one, starve two of the three consumers, and still look
perfect to a pathname-level count.
So this pins both directions across one mount: exactly one read per distinct
preference key, and every consumer still receives its own row. Tests only — no
runtime code changes.
Co-Authored-By: Claude <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012u2pRjcqAYtoEjgr3wwhnK
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Eager closure (gzip, 52 chunks)3785.0 KB3867.2 KB
Main entry chunk (gzip)151.2 KB350 KB
Entry fileindex-CDxss6tw.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 (index.js)10.04KB3.72KB
app-shell (runtime-config.js)8.91KB2.99KB
app-shell (types.js)0.01KB0.04KB
app-shell (urlParams.js)10.06KB3.86KB
auth (AuthContext.js)0.31KB0.24KB
auth (AuthGuard.js)1.17KB0.53KB
auth (AuthProvider.js)29.34KB7.05KB
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)6.35KB2.43KB
auth (index.js)2.77KB1.22KB
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.02KB0.89KB
auth (useIsWorkspaceAdmin.js)3.04KB1.45KB
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)506.99KB113.73KB
core (index.js)4.51KB1.80KB
create-plugin (index.js)10.08KB3.26KB
data-objectstack (index.js)159.80KB44.33KB
fields (index.js)237.61KB59.63KB
i18n (LocalizationContext.js)1.76KB0.96KB
i18n (currency.js)1.22KB0.64KB
i18n (i18n.js)4.28KB1.75KB
i18n (index.js)3.44KB1.39KB
i18n (pickLocalized.js)7.22KB3.08KB
i18n (provider.js)23.13KB7.63KB
i18n (useDisplayLocale.js)2.85KB1.45KB
i18n (useObjectLabel.js)33.40KB8.71KB
i18n (useSafeTranslation.js)7.77KB3.13KB
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.35KB3.31KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)4.42KB1.42KB
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.81KB0.83KB
plugin-ai (index.js)15.75KB3.80KB
plugin-calendar (index.js)46.62KB12.83KB
plugin-charts (index.js)64.72KB18.35KB
plugin-chatbot (index.js)181.21KB43.14KB
plugin-dashboard (index.js)128.53KB32.97KB
plugin-designer (index.js)212.30KB42.80KB
plugin-detail (index.js)242.15KB60.89KB
plugin-editor (index.js)2.46KB1.10KB
plugin-form (index.js)125.07KB30.43KB
plugin-gantt (index.js)164.10KB39.87KB
plugin-grid (index.js)200.79KB54.26KB
plugin-kanban (index.js)52.93KB14.60KB
plugin-list (index.js)111.70KB27.17KB
plugin-map (index.js)20.06KB6.62KB
plugin-markdown (index.js)13.72KB4.69KB
plugin-report (index.js)43.49KB11.93KB
plugin-timeline (index.js)26.68KB7.66KB
plugin-tree (index.js)8.50KB2.88KB
plugin-view (index.js)84.50KB20.68KB
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)3.77KB1.33KB
react (SchemaRenderer.js)43.66KB14.77KB
react (data-invalidation.js)5.05KB2.08KB
react (index.js)1.33KB0.69KB
react (schema-input.js)1.45KB0.83KB
react (spec-input.js)0.20KB0.18KB
sdui-parser (codegen.js)5.41KB2.34KB
sdui-parser (index.js)4.77KB2.16KB
sdui-parser (input-type.js)2.84KB1.40KB
sdui-parser (parse.js)10.76KB3.17KB
sdui-parser (provenance.js)3.66KB1.82KB
sdui-parser (types.js)0.29KB0.24KB
sdui-parser (validate.js)6.92KB2.40KB
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)0.20KB0.18KB
types (crud.js)0.20KB0.18KB
types (dashboard-filter-alias.js)6.23KB2.74KB
types (data-display.js)0.20KB0.18KB
types (data-protocol.js)0.20KB0.19KB
types (data.js)0.20KB0.18KB
types (designer.js)1.87KB0.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-retry.js)4.32KB2.02KB
types (index.js)3.08KB1.53KB
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 (system-fields.js)3.33KB1.54KB
types (theme.js)0.20KB0.18KB
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-sales
os-sales marked this pull request as ready for review August 21, 2026 16:38
@os-sales
os-sales added this pull request to the merge queueAug 21, 2026
Merged via the queue into main with commit 648f06bAug 21, 2026
23 checks passed
@os-sales
os-sales deleted the claude/issue-5544-console-request-dedup branch August 21, 2026 16:39
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@os-sales@claude