Skip to content

fix(ci): weigh the console eager closure, not one entry chunk - #5466

Merged
os-support-ai merged 2 commits into
mainfrom
claude/issue-5324-perf-budget-eager-closure
Aug 21, 2026
Merged

fix(ci): weigh the console eager closure, not one entry chunk#5466
os-support-ai merged 2 commits into
mainfrom
claude/issue-5324-perf-budget-eager-closure

Conversation

@os-support-ai

Copy link
Copy Markdown
Collaborator

Fixes#5324

#5325 is NOT fixed here and remains open — the concrete half stops at a public-surface
breach, measured and explained below. Dispatch folded the two cards into one lane slot and
asked for both closing lines; the standing rule against closing a card that is still a
decision wins, so #5325 keeps its own. (#5325's claim comment named branch
claude/issue-5325-fields-lazy-imports-defeated; the folded dispatch put both on this one.)

Re-measured on current main (77f846a8b), not on 3fbbea1f3

gzipped bytes
index-*.js alone — what the budget weighed25,910
the eager closure — 58 of 507 chunks3,881,609

So the gate passed on 0.67% of the payload it claims to govern. The card said ~110 KB
and 2.8%; the entry chunk is smaller than that today (the renderer's own fixture has used
28.1 KB since objectui#3152), so the defect is worse than filed, not overstated. Chunk
count (58) and the total (3,881,609 vs 3,957,301) both reproduce the card's method — main
has shed 75,692 bytes since 3fbbea1f3.

Two independent walks agree on 3,881,609: rolldown's chunk.imports inside the build, and
a throwaway regex BFS over index.html in dist.

What lands

  • emitEagerClosureReport (apps/console/vite.config.ts) walks the entry chunks over
    static edges only — the dynamic edge is the lazy boundary — gzips the bytes actually
    written to disk, and writes dist/eager-closure.json.
  • scripts/check-eager-closure-budget.mjs applies the ceiling. Exit 1 = over budget
    (a verdict about the bundle), exit 2 = no trustworthy measurement (a verdict about the
    gauge). Collapsing those would let a broken gauge read as a size regression and a size
    regression read as a broken gauge.
  • The budget step now measures both before either may fail it, and the PR comment leads
    with the closure. An absent closure figure renders as an explicit warning, never as a
    quiet one-row table — a table showing only the entry chunk is the old gauge.
  • The 350 KB entry-chunk budget stays exactly as it was. Nothing is raised, skipped or
    softened.

The measurement and the verdict are split on purpose: a size ceiling enforced inside
vite build would fail every Vercel preview and every local build, which is how a budget
gets switched off rather than fixed.

The ceiling: 3,960,000 gzipped bytes, and why that number

Today's measurement plus 78,391 bytes (2.02%) of headroom. Two constraints pin it:

Both constraints are expect()s in scripts/__tests__/check-eager-closure-budget.test.ts,
not prose — an edit that widens the ceiling past the regression size fails a test.

This is a truthful current-state ceiling, not a target. 3.79 MB gzipped before first
render is a bad payload and the honest long-term line is far below it. Per dispatch I did
not lower it unilaterally; the gap is reported for a separate decision.

Counter-probes, because this gate fails silently

A walk that finds too little, a stale report, an absent field read as zero — each produces a
small number, and a budget reads small as good news. So:

  • the build refuses to publish a figure unless react-dom is inside the closure and at
    least one chunk is outside it;
  • the checker refuses a report whose totals disagree with its own chunk list, whose version
    it does not recognise, or that has collapsed to its entry chunk — that last one being
    precisely the gauge this replaces.

#5325 — measured, and it stops at a public-surface breach

Warnings in one console build: 46, not "13+" (43 from packages/fields, 3 from
apps/console/src/pages/*). The card blamed index.tsx alone;
packages/fields/src/FieldEditWidget.tsx is a second static importer for 26 of them.

Removing the barrel's export * edges (keeping only what in-repo code imports by name):

beforeafter
INEFFECTIVE_DYNAMIC_IMPORT4635
eager closure, gzipped bytes3,881,6093,881,938
eager chunks5858

Zero bytes leave the eager closure — it grew by 329. Predicted before running, and the
mechanism is #5266's own: the advancedChunks group named ui-components, whose test
matches packages/(components|fields), claims every packages/fields module and folds it
into a chunk the entry imports statically, which overrides async-only reachability.

Control that proves it independently: widgets/MarkdownContent.tsx has a working lazy
import() and no static importer anywhere — and it still lands in the eager
ui-components-*.js. Counter-probed: the same method reports lazy for the maplibre and
plugin-map chunks, so it is not an oracle stuck on one answer.

And the fix is a public-surface change, in-repo as well as published: 14 widget classes are
imported by name from @object-ui/fields by production code in plugin-detail,
plugin-form, app-shell and apps/console (16 MISSING_EXPORT build errors on the first
attempt). Per dispatch, that is a stop-and-report, so packages/fields is untouched here.
The warnings are real, but silencing them buys 0 bytes until the chunk grouping is
decided too. Evidence is on #5325.

Reverse verification (predicted before running, both legs rebuilt)

vite.config.ts is read directly by Vite, so no package dist sits between the mutation
and the run; each leg is a full console build.

ablationpredictedobserved
closure walk follows no static edgesbuild fails on the counter-probe, refuses a numberbuild exit 1, eager: 1/507, "a walk that finds too little produces a SMALL number"
restore leg58/507, 3,881,609, 46 warningsidentical
report plus 89 KiB (a #5266 repeat)checker exit 1, closure_status=failexit 1, 12.4 KB over
report absentchecker exit 2, no number publishedexit 2, closure_gzip_kb empty

Working tree proven byte-identical to HEAD after each restore.

Verification on 7515fa295

vitest run scripts/__tests__/ apps/console/ — 117 files, 2288 tests, 0 failures (27 new
for the checker, 21 for the renderer). check:control-bytes, lint:coverage,
type-check:coverage, changeset:check, check-changeset-presence, type-check:scripts,
console type-check, lint:root and console lint all exit 0. Changeset has empty
frontmatter: CI and build tooling only, no package src/ touched.


Generated by Claude Code

The Bundle Analysis workflow gzipped `index-*.js` and called the result
"the console performance budget". On 77f846a that chunk is 25,910 bytes
gzipped against a 350 KB line, while the closure it statically pulls in —
what the browser must fetch and parse before the app renders — is
3,881,609 bytes across 58 of 507 chunks. The gate passed on 0.67% of the
payload it claimed to govern, which is why the 89 KiB regression of #5266
landed in `vendor-objectstack-*.js` unseen.
- `emitEagerClosureReport` in apps/console/vite.config.ts walks rolldown's
own `chunk.imports` from the entry chunks (static edges only) and writes
dist/eager-closure.json. Two counter-probes refuse a verdict rather than
publish a number: react-dom must be IN the closure, and not every chunk
may be.
- scripts/check-eager-closure-budget.mjs applies the ceiling. Exit 1 =
over budget, exit 2 = no trustworthy measurement, so a broken gauge is
never reported as a clean bundle.
- The entry-chunk budget and its 350 KB line stay exactly as they were.
The ceiling is today's measurement plus ~2% (78,391 bytes) — it passes on
current main, and the headroom is deliberately narrower than the 89 KiB
regression the gate exists to catch. Both constraints are asserted in
scripts/__tests__/check-eager-closure-budget.test.ts rather than argued
in a comment.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RV6yuVCxymHYE16PL9vQkE
…ng (#5324)
CI and build tooling only. Empty frontmatter is the explicit "no release"
declaration; no package src/ is touched.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RV6yuVCxymHYE16PL9vQkE
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Eager closure (gzip, 58 chunks)3790.6 KB3867.2 KB
Main entry chunk (gzip)25.3 KB350 KB
Entry fileindex-WY6gyyO9.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)7.42KB2.32KB
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)507.00KB113.63KB
core (index.js)4.11KB1.62KB
create-plugin (index.js)10.08KB3.26KB
data-objectstack (index.js)159.80KB44.34KB
fields (index.js)237.21KB59.50KB
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)30.51KB7.57KB
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.75KB18.37KB
plugin-chatbot (index.js)181.21KB43.14KB
plugin-dashboard (index.js)128.37KB32.91KB
plugin-designer (index.js)212.39KB42.83KB
plugin-detail (index.js)242.04KB60.86KB
plugin-editor (index.js)2.46KB1.10KB
plugin-form (index.js)124.40KB30.26KB
plugin-gantt (index.js)164.10KB39.87KB
plugin-grid (index.js)200.75KB54.24KB
plugin-kanban (index.js)52.93KB14.60KB
plugin-list (index.js)111.64KB27.13KB
plugin-map (index.js)20.08KB6.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.52KB20.67KB
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)36.10KB12.26KB
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

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

2 participants

@os-support-ai@claude