fix(plugin-gantt): guard reload()'s finally so a superseded run cannot clear the loading state - #7236

Merged
os-litant merged 1 commit into
mainfrom
claude/issue-7231-gantt-reload-stale-finally
Sep 2, 2026
Merged

fix(plugin-gantt): guard reload()'s finally so a superseded run cannot clear the loading state#7236
os-litant merged 1 commit into
mainfrom
claude/issue-7231-gantt-reload-stale-finally

Conversation

@os-litant

Copy link
Copy Markdown
Collaborator

Fixes#7231

The defect

ObjectGantt's reload() sequences concurrent runs with reloadSeqRef and guards every result write with isCurrent()setData on all three branches, setError on the error branch. Its finally carried no guard, so a superseded reload still flipped loading / refreshing off.

Note which ordering produces the symptom: not an exotic out-of-order response, but the plain one. The stale run only has to finish first, which is the ordinary case whenever a second reload is issued while the first is still in flight. The placeholder was released before any rows arrived and the chart painted empty until the fresh response landed. (The out-of-order case — fresh finishes first — is what the pre-existing setData guard already covered; it is kept below as a control.)

The caller measurement the card asked for

The card's "Not measured" paragraph was the first task. Enumerating reload()'s call sites in packages/plugin-gantt/src/ObjectGantt.tsx (line numbers on this branch):

Call siteModeWhat triggers it
:712useEffect(() => { reload(); }, [reload])non-silentmount; and any change of reload's identity — its deps at :707 are effectiveDataSource, resource, hasInlineData, dataProvider, dataItems, schema.filter, schema.sort, objectSchema. So this one site is the card's initial load, schema-resolution refire and view/filter change callers.
:1440silentwrite-readback after a drag / resize / progress update
:1484silentwrite-readback after a dependency-link write
:1585silentwrite-readback after a delete
:1753silenttoolbar refresh button (onRefresh on GanttView)
:1820silentwrite-readback after an inline edit in the record drawer

Which pairs can actually overlap:

  • non-silent + non-silent — reachable, and the visible one.:712 re-fires against itself: objectSchema resolving mid-flight re-keys reload, and so does a host changing schema.filter / schema.sort / the bound object. loading is the flag that gates the placeholder at :1596, so this is the pair that blanks the chart. Reproduced in the harness (case 1 below). It is not confined to the two-queries regime: the filter/sort/object route re-keys reload with no schema read involved.
  • silent + silent — reachable. Nothing serializes the write-readbacks and the toolbar refresh. Two quick inline edits, or a drag followed by a refresh click, overlap. No blanking here (they never touch loading), but the stale run used to drop refreshing while the fresh read was still outstanding, so the toolbar's disabled / aria-busy (GanttView.tsx:3449, :3451) went honest-to-lying mid-flight and the button accepted another click.
  • silent superseded by non-silent — reachable, and it decides the guard shape. Every silent caller runs with the chart mounted (loading === false), and a filter/sort change or a late objectSchema can re-key reload at any moment.
  • non-silent superseded by silent — not reachable from this component. Every silent caller sits behind the if (loading) return placeholder early return at :1596, so while a non-silent reload holds loading true there is no toolbar and no row handler mounted to fire one. Worth recording that the unguarded finally was itself the thing that opened this window: it released loading early and re-mounted the toolbar while the fresh query was still running.

So the defect is live on three distinct pairs, only one of which passes through schema resolution — which is the card's scoping fence, measured rather than assumed.

The fix, and why it clears both flags

}finally{if(isCurrent()){setRefreshing(false);setLoading(false);}}

The obvious form — clear only the flag this run's own silent mode set — is wrong on the third pair above. The superseded silent run correctly skips its clear; the current non-silent run clears only loading; nobody ever clears refreshing, and the refresh button stays busy for the life of the component. Clearing both is the honest form because reaching this point as the current run means nothing is in flight any more: a newer reload would have made this one stale, and an older one has no claim on the flags. Case 3 pins that shape.

Checked, per the card's warning, that the fresh run always reaches its own finally:

  • error pathcatch then finally, both modes, always.
  • early return inside try (host data prop at :658, inline value items at :663) — finally still runs.
  • abort — no AbortSignal is passed to effectiveDataSource.find() anywhere in this file, so there is no cancel path whose promise never settles. A find() that never settles would strand loading, identically before and after this change.
  • unmount — a setState after unmount is a no-op on this repo's React; unchanged here.

No path relied on the stale finally doing the clearing: reload increments reloadSeqRef as its first statement, so a newer sequence number always implies a newer run already inside its own try.

Tests

New file packages/plugin-gantt/src/ObjectGantt.staleReloadFinally-7231.test.tsx. A data source hands back deferred find() promises so two reloads can be held in flight and completed in either order; getObjectSchema resolves immediately, which is what issues the second reload while the first is pending.

  1. the defect — stale run finishes first: the placeholder must stay and no chart may render.
  2. control — fresh run finishes first: its rows paint, and the late stale answer neither clobbers the data nor puts the placeholder back. Green on the unmodified tree, so case 1's failure is a measurement rather than a broken harness.
  3. guard shape — a silent toolbar refresh superseded by a filter-change reload must not strand refreshing.

Ablation (run on the committed tree, guard reverted then restored):

  • resolution path: the test reaches the subject through a relative import (import { ObjectGantt } from './ObjectGantt'), so the subject is the source module and no dist/ is in the path — no rebuild leg applies.
  • mutation proven on disk before measuring: anchor if (isCurrent()) { 2 occurrences to 1, injected if (silent) setRefreshing(false); 0 to 1, blob c063fb2 to cb81262.
  • ablated run: Tests 1 failed | 2 passed (3) — exactly case 1 red, both controls green.
  • restore proven: blob back to c063fb2 (byte-identical to the HEAD blob), git diff HEAD empty, anchor counts back to 2 / 0.

Gates

All run on 529d546, the final commit, with the worktree clean:

GateVerdict line
pnpm exec vitest run packages/plugin-gantt/Test Files 57 passed (57) · Tests 451 passed (451)
pnpm --filter @object-ui/plugin-gantt run type-checkexit 0 (tsc --noEmit && tsc -p tsconfig.test.json — the second leg is what type-checks the new test file)
check:control-bytescheck-control-bytes: OK (scanned 5998 tracked text file(s); skipped 85 binary).
check:vi-mock-specifierscheck-vi-mock-specifiers: OK (4128 tracked source file(s), 2398 test-named; 533 carry a mock; 782 relative specifier(s) resolved...)
check:vi-mock-inheritcheck-vi-mock-inherit: OK (... 118 call site(s) on @object-ui/react judged (118 inherit, 0 auto-mocked) ...)
check:self-importNo package names itself inside its own src/.
check:phantom-depsEvery in-scope import is declared by the package that publishes it.
check-changeset-presence.mjs2 source file(s) of 1 released package(s) changed, and this change declares 1 changeset(s): .changeset/7231-gantt-stale-reload-finally.md.
check-changeset-no-major.mjsNo changeset declares a major bump.

Declared narrowing — eslint. The repo-wide pnpm lint (turbo run lint over the 42 packages that define a lint script) is CI's run. Locally eslint ran over the touched package only — eslint . inside packages/plugin-gantt, which is exactly the unit turbo invokes for it. Three readings, so the narrowing is a measurement and not a skip:

  1. population read from eslint's own resolution of eslint.config.js (its own walk and its own ignores), not from a guess about which files count;
  2. count read from --format json: 87 files, 0 errors, 333 warnings (the new test file contributes 10 warnings, in line with its siblings — .github/workflows/lint.yml deliberately sets no --max-warnings, so this gate is about errors);
  3. invariance for untouched files: eslint.config.js declares no parserOptions, no project and no projectService anywhere, so no rule reads type information across files — every verdict is single-file. Every config block matches **/*.{ts,tsx} only, so the added .changeset/*.md is outside the linted set entirely. This diff therefore cannot move the verdict on any file it does not contain.

Scope

Reload guard only. packages/plugin-gantt/src/ObjectGantt.tsx (the finally in the reload() closure), one new test beside it, one changeset. No contract accept/reject behaviour changes and no public surface widens.

Deliberately untouched, each queued or owned elsewhere: the buildExpandFields(objectSchema?.fields) projection site in this same file (that is #7230, which remains open and is queued behind this card); the paging / $top shape of the gantt fetch (#7210 remains open — its half 2 is a maintainer decision); and the schema-gating regime (#7225 and #6482 both remain open). Per the card, this is deliberately not folded into that gating work: a gate would hide the schema-resolution instance and leave the guard broken on the toolbar-refresh and write-readback pairs measured above.

🤖 Generated with Claude Code

https://claude.ai/code/session_01NRRumy89BYdW9ogbcdHTho

Generated by Claude Code


Generated by Claude Code

…annot clear the loading state
`reload()` sequences concurrent runs with `reloadSeqRef` and guards every result
write with `isCurrent()`, but its `finally` carried no guard. A superseded reload
therefore still flipped `loading` / `refreshing` off: the stale run only had to
finish first — the ordinary case whenever a second reload is issued while the
first is still in flight — and the placeholder was released before any rows had
arrived, painting an empty chart until the fresh response landed.
The `finally` now clears the flags only when the run reaching it is still current,
and clears BOTH of them rather than only the one its own `silent` mode set: being
current at that point means nothing is in flight any more, so clearing only its own
mode would strand the other flag whenever the superseded run used the other mode (a
silent toolbar refresh overtaken by a filter-change reload would have left
`refreshing` on for the life of the component).
New test file pins three orderings: the stale run finishing first (the defect —
red on the unguarded tree), the fresh run finishing first (control — green either
way, covering the pre-existing `setData` guard), and a silent run superseded by a
non-silent one (pins the clear-both shape).
Reload-guard only: which queries are issued, how they are projected and how they
page are all untouched.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NRRumy89BYdW9ogbcdHTho
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Eager closure (gzip, 48 chunks)3160.1 KB3191.4 KB
Main entry chunk (gzip)142.6 KB350 KB
Entry fileindex-9TBh-pag.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)15.33KB5.59KB
app-shell (runtime-config.js)20.68KB7.36KB
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)514.13KB117.19KB
core (index.js)5.55KB2.23KB
create-plugin (index.js)10.08KB3.26KB
data-objectstack (index.js)178.20KB49.60KB
fields (index.js)244.25KB61.73KB
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.98KB10.98KB
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)11.71KB4.29KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)6.24KB2.16KB
permissions (discardProofCache.js)1.04KB0.55KB
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)4.83KB2.27KB
plugin-ai (index.js)15.75KB3.80KB
plugin-calendar (index.js)46.92KB12.93KB
plugin-charts (index.js)70.02KB19.44KB
plugin-chatbot (index.js)190.53KB45.18KB
plugin-dashboard (index.js)132.63KB34.56KB
plugin-designer (index.js)212.87KB43.19KB
plugin-detail (index.js)250.65KB63.91KB
plugin-editor (index.js)2.46KB1.10KB
plugin-form (index.js)132.78KB32.58KB
plugin-gantt (index.js)166.77KB40.76KB
plugin-grid (index.js)208.87KB56.58KB
plugin-kanban (index.js)53.21KB14.66KB
plugin-list (index.js)113.55KB27.68KB
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)29.34KB8.47KB
plugin-tree (index.js)8.98KB3.08KB
plugin-view (index.js)85.90KB21.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)81.07KB26.86KB
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-litant
os-litant marked this pull request as ready for review September 2, 2026 01:46
@os-litant
os-litant added this pull request to the merge queueSep 2, 2026
Merged via the queue into main with commit 92c65aaSep 2, 2026
32 checks passed
@os-litant
os-litant deleted the claude/issue-7231-gantt-reload-stale-finally branch September 2, 2026 02:01
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

2 participants

@os-litant@claude
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

fix(plugin-gantt): guard reload()'s finally so a superseded run cannot clear the loading state - #7236

Merged
os-litant merged 1 commit into
mainfrom
claude/issue-7231-gantt-reload-stale-finally
Sep 2, 2026
Merged

fix(plugin-gantt): guard reload()'s finally so a superseded run cannot clear the loading state#7236
os-litant merged 1 commit into
mainfrom
claude/issue-7231-gantt-reload-stale-finally

Conversation

@os-litant

Copy link
Copy Markdown
Collaborator

Fixes#7231

The defect

ObjectGantt's reload() sequences concurrent runs with reloadSeqRef and guards every result write with isCurrent()setData on all three branches, setError on the error branch. Its finally carried no guard, so a superseded reload still flipped loading / refreshing off.

Note which ordering produces the symptom: not an exotic out-of-order response, but the plain one. The stale run only has to finish first, which is the ordinary case whenever a second reload is issued while the first is still in flight. The placeholder was released before any rows arrived and the chart painted empty until the fresh response landed. (The out-of-order case — fresh finishes first — is what the pre-existing setData guard already covered; it is kept below as a control.)

The caller measurement the card asked for

The card's "Not measured" paragraph was the first task. Enumerating reload()'s call sites in packages/plugin-gantt/src/ObjectGantt.tsx (line numbers on this branch):

Call siteModeWhat triggers it
:712useEffect(() => { reload(); }, [reload])non-silentmount; and any change of reload's identity — its deps at :707 are effectiveDataSource, resource, hasInlineData, dataProvider, dataItems, schema.filter, schema.sort, objectSchema. So this one site is the card's initial load, schema-resolution refire and view/filter change callers.
:1440silentwrite-readback after a drag / resize / progress update
:1484silentwrite-readback after a dependency-link write
:1585silentwrite-readback after a delete
:1753silenttoolbar refresh button (onRefresh on GanttView)
:1820silentwrite-readback after an inline edit in the record drawer

Which pairs can actually overlap:

  • non-silent + non-silent — reachable, and the visible one.:712 re-fires against itself: objectSchema resolving mid-flight re-keys reload, and so does a host changing schema.filter / schema.sort / the bound object. loading is the flag that gates the placeholder at :1596, so this is the pair that blanks the chart. Reproduced in the harness (case 1 below). It is not confined to the two-queries regime: the filter/sort/object route re-keys reload with no schema read involved.
  • silent + silent — reachable. Nothing serializes the write-readbacks and the toolbar refresh. Two quick inline edits, or a drag followed by a refresh click, overlap. No blanking here (they never touch loading), but the stale run used to drop refreshing while the fresh read was still outstanding, so the toolbar's disabled / aria-busy (GanttView.tsx:3449, :3451) went honest-to-lying mid-flight and the button accepted another click.
  • silent superseded by non-silent — reachable, and it decides the guard shape. Every silent caller runs with the chart mounted (loading === false), and a filter/sort change or a late objectSchema can re-key reload at any moment.
  • non-silent superseded by silent — not reachable from this component. Every silent caller sits behind the if (loading) return placeholder early return at :1596, so while a non-silent reload holds loading true there is no toolbar and no row handler mounted to fire one. Worth recording that the unguarded finally was itself the thing that opened this window: it released loading early and re-mounted the toolbar while the fresh query was still running.

So the defect is live on three distinct pairs, only one of which passes through schema resolution — which is the card's scoping fence, measured rather than assumed.

The fix, and why it clears both flags

}finally{if(isCurrent()){setRefreshing(false);setLoading(false);}}

The obvious form — clear only the flag this run's own silent mode set — is wrong on the third pair above. The superseded silent run correctly skips its clear; the current non-silent run clears only loading; nobody ever clears refreshing, and the refresh button stays busy for the life of the component. Clearing both is the honest form because reaching this point as the current run means nothing is in flight any more: a newer reload would have made this one stale, and an older one has no claim on the flags. Case 3 pins that shape.

Checked, per the card's warning, that the fresh run always reaches its own finally:

  • error pathcatch then finally, both modes, always.
  • early return inside try (host data prop at :658, inline value items at :663) — finally still runs.
  • abort — no AbortSignal is passed to effectiveDataSource.find() anywhere in this file, so there is no cancel path whose promise never settles. A find() that never settles would strand loading, identically before and after this change.
  • unmount — a setState after unmount is a no-op on this repo's React; unchanged here.

No path relied on the stale finally doing the clearing: reload increments reloadSeqRef as its first statement, so a newer sequence number always implies a newer run already inside its own try.

Tests

New file packages/plugin-gantt/src/ObjectGantt.staleReloadFinally-7231.test.tsx. A data source hands back deferred find() promises so two reloads can be held in flight and completed in either order; getObjectSchema resolves immediately, which is what issues the second reload while the first is pending.

  1. the defect — stale run finishes first: the placeholder must stay and no chart may render.
  2. control — fresh run finishes first: its rows paint, and the late stale answer neither clobbers the data nor puts the placeholder back. Green on the unmodified tree, so case 1's failure is a measurement rather than a broken harness.
  3. guard shape — a silent toolbar refresh superseded by a filter-change reload must not strand refreshing.

Ablation (run on the committed tree, guard reverted then restored):

  • resolution path: the test reaches the subject through a relative import (import { ObjectGantt } from './ObjectGantt'), so the subject is the source module and no dist/ is in the path — no rebuild leg applies.
  • mutation proven on disk before measuring: anchor if (isCurrent()) { 2 occurrences to 1, injected if (silent) setRefreshing(false); 0 to 1, blob c063fb2 to cb81262.
  • ablated run: Tests 1 failed | 2 passed (3) — exactly case 1 red, both controls green.
  • restore proven: blob back to c063fb2 (byte-identical to the HEAD blob), git diff HEAD empty, anchor counts back to 2 / 0.

Gates

All run on 529d546, the final commit, with the worktree clean:

GateVerdict line
pnpm exec vitest run packages/plugin-gantt/Test Files 57 passed (57) · Tests 451 passed (451)
pnpm --filter @object-ui/plugin-gantt run type-checkexit 0 (tsc --noEmit && tsc -p tsconfig.test.json — the second leg is what type-checks the new test file)
check:control-bytescheck-control-bytes: OK (scanned 5998 tracked text file(s); skipped 85 binary).
check:vi-mock-specifierscheck-vi-mock-specifiers: OK (4128 tracked source file(s), 2398 test-named; 533 carry a mock; 782 relative specifier(s) resolved...)
check:vi-mock-inheritcheck-vi-mock-inherit: OK (... 118 call site(s) on @object-ui/react judged (118 inherit, 0 auto-mocked) ...)
check:self-importNo package names itself inside its own src/.
check:phantom-depsEvery in-scope import is declared by the package that publishes it.
check-changeset-presence.mjs2 source file(s) of 1 released package(s) changed, and this change declares 1 changeset(s): .changeset/7231-gantt-stale-reload-finally.md.
check-changeset-no-major.mjsNo changeset declares a major bump.

Declared narrowing — eslint. The repo-wide pnpm lint (turbo run lint over the 42 packages that define a lint script) is CI's run. Locally eslint ran over the touched package only — eslint . inside packages/plugin-gantt, which is exactly the unit turbo invokes for it. Three readings, so the narrowing is a measurement and not a skip:

  1. population read from eslint's own resolution of eslint.config.js (its own walk and its own ignores), not from a guess about which files count;
  2. count read from --format json: 87 files, 0 errors, 333 warnings (the new test file contributes 10 warnings, in line with its siblings — .github/workflows/lint.yml deliberately sets no --max-warnings, so this gate is about errors);
  3. invariance for untouched files: eslint.config.js declares no parserOptions, no project and no projectService anywhere, so no rule reads type information across files — every verdict is single-file. Every config block matches **/*.{ts,tsx} only, so the added .changeset/*.md is outside the linted set entirely. This diff therefore cannot move the verdict on any file it does not contain.

Scope

Reload guard only. packages/plugin-gantt/src/ObjectGantt.tsx (the finally in the reload() closure), one new test beside it, one changeset. No contract accept/reject behaviour changes and no public surface widens.

Deliberately untouched, each queued or owned elsewhere: the buildExpandFields(objectSchema?.fields) projection site in this same file (that is #7230, which remains open and is queued behind this card); the paging / $top shape of the gantt fetch (#7210 remains open — its half 2 is a maintainer decision); and the schema-gating regime (#7225 and #6482 both remain open). Per the card, this is deliberately not folded into that gating work: a gate would hide the schema-resolution instance and leave the guard broken on the toolbar-refresh and write-readback pairs measured above.

🤖 Generated with Claude Code

https://claude.ai/code/session_01NRRumy89BYdW9ogbcdHTho

Generated by Claude Code


Generated by Claude Code

…annot clear the loading state
`reload()` sequences concurrent runs with `reloadSeqRef` and guards every result
write with `isCurrent()`, but its `finally` carried no guard. A superseded reload
therefore still flipped `loading` / `refreshing` off: the stale run only had to
finish first — the ordinary case whenever a second reload is issued while the
first is still in flight — and the placeholder was released before any rows had
arrived, painting an empty chart until the fresh response landed.
The `finally` now clears the flags only when the run reaching it is still current,
and clears BOTH of them rather than only the one its own `silent` mode set: being
current at that point means nothing is in flight any more, so clearing only its own
mode would strand the other flag whenever the superseded run used the other mode (a
silent toolbar refresh overtaken by a filter-change reload would have left
`refreshing` on for the life of the component).
New test file pins three orderings: the stale run finishing first (the defect —
red on the unguarded tree), the fresh run finishing first (control — green either
way, covering the pre-existing `setData` guard), and a silent run superseded by a
non-silent one (pins the clear-both shape).
Reload-guard only: which queries are issued, how they are projected and how they
page are all untouched.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NRRumy89BYdW9ogbcdHTho
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Eager closure (gzip, 48 chunks)3160.1 KB3191.4 KB
Main entry chunk (gzip)142.6 KB350 KB
Entry fileindex-9TBh-pag.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)15.33KB5.59KB
app-shell (runtime-config.js)20.68KB7.36KB
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)514.13KB117.19KB
core (index.js)5.55KB2.23KB
create-plugin (index.js)10.08KB3.26KB
data-objectstack (index.js)178.20KB49.60KB
fields (index.js)244.25KB61.73KB
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.98KB10.98KB
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)11.71KB4.29KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)6.24KB2.16KB
permissions (discardProofCache.js)1.04KB0.55KB
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)4.83KB2.27KB
plugin-ai (index.js)15.75KB3.80KB
plugin-calendar (index.js)46.92KB12.93KB
plugin-charts (index.js)70.02KB19.44KB
plugin-chatbot (index.js)190.53KB45.18KB
plugin-dashboard (index.js)132.63KB34.56KB
plugin-designer (index.js)212.87KB43.19KB
plugin-detail (index.js)250.65KB63.91KB
plugin-editor (index.js)2.46KB1.10KB
plugin-form (index.js)132.78KB32.58KB
plugin-gantt (index.js)166.77KB40.76KB
plugin-grid (index.js)208.87KB56.58KB
plugin-kanban (index.js)53.21KB14.66KB
plugin-list (index.js)113.55KB27.68KB
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)29.34KB8.47KB
plugin-tree (index.js)8.98KB3.08KB
plugin-view (index.js)85.90KB21.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)81.07KB26.86KB
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-litant
os-litant marked this pull request as ready for review September 2, 2026 01:46
@os-litant
os-litant added this pull request to the merge queueSep 2, 2026
Merged via the queue into main with commit 92c65aaSep 2, 2026
32 checks passed
@os-litant
os-litant deleted the claude/issue-7231-gantt-reload-stale-finally branch September 2, 2026 02:01
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

2 participants

@os-litant@claude
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(plugin-gantt): guard reload()'s finally so a superseded run cannot clear the loading state - #7236

Merged
os-litant merged 1 commit into
mainfrom
claude/issue-7231-gantt-reload-stale-finally
Sep 2, 2026
Merged

fix(plugin-gantt): guard reload()'s finally so a superseded run cannot clear the loading state#7236
os-litant merged 1 commit into
mainfrom
claude/issue-7231-gantt-reload-stale-finally

Conversation

@os-litant

Copy link
Copy Markdown
Collaborator

Fixes#7231

The defect

ObjectGantt's reload() sequences concurrent runs with reloadSeqRef and guards every result write with isCurrent()setData on all three branches, setError on the error branch. Its finally carried no guard, so a superseded reload still flipped loading / refreshing off.

Note which ordering produces the symptom: not an exotic out-of-order response, but the plain one. The stale run only has to finish first, which is the ordinary case whenever a second reload is issued while the first is still in flight. The placeholder was released before any rows arrived and the chart painted empty until the fresh response landed. (The out-of-order case — fresh finishes first — is what the pre-existing setData guard already covered; it is kept below as a control.)

The caller measurement the card asked for

The card's "Not measured" paragraph was the first task. Enumerating reload()'s call sites in packages/plugin-gantt/src/ObjectGantt.tsx (line numbers on this branch):

Call siteModeWhat triggers it
:712useEffect(() => { reload(); }, [reload])non-silentmount; and any change of reload's identity — its deps at :707 are effectiveDataSource, resource, hasInlineData, dataProvider, dataItems, schema.filter, schema.sort, objectSchema. So this one site is the card's initial load, schema-resolution refire and view/filter change callers.
:1440silentwrite-readback after a drag / resize / progress update
:1484silentwrite-readback after a dependency-link write
:1585silentwrite-readback after a delete
:1753silenttoolbar refresh button (onRefresh on GanttView)
:1820silentwrite-readback after an inline edit in the record drawer

Which pairs can actually overlap:

  • non-silent + non-silent — reachable, and the visible one.:712 re-fires against itself: objectSchema resolving mid-flight re-keys reload, and so does a host changing schema.filter / schema.sort / the bound object. loading is the flag that gates the placeholder at :1596, so this is the pair that blanks the chart. Reproduced in the harness (case 1 below). It is not confined to the two-queries regime: the filter/sort/object route re-keys reload with no schema read involved.
  • silent + silent — reachable. Nothing serializes the write-readbacks and the toolbar refresh. Two quick inline edits, or a drag followed by a refresh click, overlap. No blanking here (they never touch loading), but the stale run used to drop refreshing while the fresh read was still outstanding, so the toolbar's disabled / aria-busy (GanttView.tsx:3449, :3451) went honest-to-lying mid-flight and the button accepted another click.
  • silent superseded by non-silent — reachable, and it decides the guard shape. Every silent caller runs with the chart mounted (loading === false), and a filter/sort change or a late objectSchema can re-key reload at any moment.
  • non-silent superseded by silent — not reachable from this component. Every silent caller sits behind the if (loading) return placeholder early return at :1596, so while a non-silent reload holds loading true there is no toolbar and no row handler mounted to fire one. Worth recording that the unguarded finally was itself the thing that opened this window: it released loading early and re-mounted the toolbar while the fresh query was still running.

So the defect is live on three distinct pairs, only one of which passes through schema resolution — which is the card's scoping fence, measured rather than assumed.

The fix, and why it clears both flags

}finally{if(isCurrent()){setRefreshing(false);setLoading(false);}}

The obvious form — clear only the flag this run's own silent mode set — is wrong on the third pair above. The superseded silent run correctly skips its clear; the current non-silent run clears only loading; nobody ever clears refreshing, and the refresh button stays busy for the life of the component. Clearing both is the honest form because reaching this point as the current run means nothing is in flight any more: a newer reload would have made this one stale, and an older one has no claim on the flags. Case 3 pins that shape.

Checked, per the card's warning, that the fresh run always reaches its own finally:

  • error pathcatch then finally, both modes, always.
  • early return inside try (host data prop at :658, inline value items at :663) — finally still runs.
  • abort — no AbortSignal is passed to effectiveDataSource.find() anywhere in this file, so there is no cancel path whose promise never settles. A find() that never settles would strand loading, identically before and after this change.
  • unmount — a setState after unmount is a no-op on this repo's React; unchanged here.

No path relied on the stale finally doing the clearing: reload increments reloadSeqRef as its first statement, so a newer sequence number always implies a newer run already inside its own try.

Tests

New file packages/plugin-gantt/src/ObjectGantt.staleReloadFinally-7231.test.tsx. A data source hands back deferred find() promises so two reloads can be held in flight and completed in either order; getObjectSchema resolves immediately, which is what issues the second reload while the first is pending.

  1. the defect — stale run finishes first: the placeholder must stay and no chart may render.
  2. control — fresh run finishes first: its rows paint, and the late stale answer neither clobbers the data nor puts the placeholder back. Green on the unmodified tree, so case 1's failure is a measurement rather than a broken harness.
  3. guard shape — a silent toolbar refresh superseded by a filter-change reload must not strand refreshing.

Ablation (run on the committed tree, guard reverted then restored):

  • resolution path: the test reaches the subject through a relative import (import { ObjectGantt } from './ObjectGantt'), so the subject is the source module and no dist/ is in the path — no rebuild leg applies.
  • mutation proven on disk before measuring: anchor if (isCurrent()) { 2 occurrences to 1, injected if (silent) setRefreshing(false); 0 to 1, blob c063fb2 to cb81262.
  • ablated run: Tests 1 failed | 2 passed (3) — exactly case 1 red, both controls green.
  • restore proven: blob back to c063fb2 (byte-identical to the HEAD blob), git diff HEAD empty, anchor counts back to 2 / 0.

Gates

All run on 529d546, the final commit, with the worktree clean:

GateVerdict line
pnpm exec vitest run packages/plugin-gantt/Test Files 57 passed (57) · Tests 451 passed (451)
pnpm --filter @object-ui/plugin-gantt run type-checkexit 0 (tsc --noEmit && tsc -p tsconfig.test.json — the second leg is what type-checks the new test file)
check:control-bytescheck-control-bytes: OK (scanned 5998 tracked text file(s); skipped 85 binary).
check:vi-mock-specifierscheck-vi-mock-specifiers: OK (4128 tracked source file(s), 2398 test-named; 533 carry a mock; 782 relative specifier(s) resolved...)
check:vi-mock-inheritcheck-vi-mock-inherit: OK (... 118 call site(s) on @object-ui/react judged (118 inherit, 0 auto-mocked) ...)
check:self-importNo package names itself inside its own src/.
check:phantom-depsEvery in-scope import is declared by the package that publishes it.
check-changeset-presence.mjs2 source file(s) of 1 released package(s) changed, and this change declares 1 changeset(s): .changeset/7231-gantt-stale-reload-finally.md.
check-changeset-no-major.mjsNo changeset declares a major bump.

Declared narrowing — eslint. The repo-wide pnpm lint (turbo run lint over the 42 packages that define a lint script) is CI's run. Locally eslint ran over the touched package only — eslint . inside packages/plugin-gantt, which is exactly the unit turbo invokes for it. Three readings, so the narrowing is a measurement and not a skip:

  1. population read from eslint's own resolution of eslint.config.js (its own walk and its own ignores), not from a guess about which files count;
  2. count read from --format json: 87 files, 0 errors, 333 warnings (the new test file contributes 10 warnings, in line with its siblings — .github/workflows/lint.yml deliberately sets no --max-warnings, so this gate is about errors);
  3. invariance for untouched files: eslint.config.js declares no parserOptions, no project and no projectService anywhere, so no rule reads type information across files — every verdict is single-file. Every config block matches **/*.{ts,tsx} only, so the added .changeset/*.md is outside the linted set entirely. This diff therefore cannot move the verdict on any file it does not contain.

Scope

Reload guard only. packages/plugin-gantt/src/ObjectGantt.tsx (the finally in the reload() closure), one new test beside it, one changeset. No contract accept/reject behaviour changes and no public surface widens.

Deliberately untouched, each queued or owned elsewhere: the buildExpandFields(objectSchema?.fields) projection site in this same file (that is #7230, which remains open and is queued behind this card); the paging / $top shape of the gantt fetch (#7210 remains open — its half 2 is a maintainer decision); and the schema-gating regime (#7225 and #6482 both remain open). Per the card, this is deliberately not folded into that gating work: a gate would hide the schema-resolution instance and leave the guard broken on the toolbar-refresh and write-readback pairs measured above.

🤖 Generated with Claude Code

https://claude.ai/code/session_01NRRumy89BYdW9ogbcdHTho

Generated by Claude Code


Generated by Claude Code

…annot clear the loading state
`reload()` sequences concurrent runs with `reloadSeqRef` and guards every result
write with `isCurrent()`, but its `finally` carried no guard. A superseded reload
therefore still flipped `loading` / `refreshing` off: the stale run only had to
finish first — the ordinary case whenever a second reload is issued while the
first is still in flight — and the placeholder was released before any rows had
arrived, painting an empty chart until the fresh response landed.
The `finally` now clears the flags only when the run reaching it is still current,
and clears BOTH of them rather than only the one its own `silent` mode set: being
current at that point means nothing is in flight any more, so clearing only its own
mode would strand the other flag whenever the superseded run used the other mode (a
silent toolbar refresh overtaken by a filter-change reload would have left
`refreshing` on for the life of the component).
New test file pins three orderings: the stale run finishing first (the defect —
red on the unguarded tree), the fresh run finishing first (control — green either
way, covering the pre-existing `setData` guard), and a silent run superseded by a
non-silent one (pins the clear-both shape).
Reload-guard only: which queries are issued, how they are projected and how they
page are all untouched.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NRRumy89BYdW9ogbcdHTho
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Eager closure (gzip, 48 chunks)3160.1 KB3191.4 KB
Main entry chunk (gzip)142.6 KB350 KB
Entry fileindex-9TBh-pag.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)15.33KB5.59KB
app-shell (runtime-config.js)20.68KB7.36KB
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)514.13KB117.19KB
core (index.js)5.55KB2.23KB
create-plugin (index.js)10.08KB3.26KB
data-objectstack (index.js)178.20KB49.60KB
fields (index.js)244.25KB61.73KB
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.98KB10.98KB
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)11.71KB4.29KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)6.24KB2.16KB
permissions (discardProofCache.js)1.04KB0.55KB
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)4.83KB2.27KB
plugin-ai (index.js)15.75KB3.80KB
plugin-calendar (index.js)46.92KB12.93KB
plugin-charts (index.js)70.02KB19.44KB
plugin-chatbot (index.js)190.53KB45.18KB
plugin-dashboard (index.js)132.63KB34.56KB
plugin-designer (index.js)212.87KB43.19KB
plugin-detail (index.js)250.65KB63.91KB
plugin-editor (index.js)2.46KB1.10KB
plugin-form (index.js)132.78KB32.58KB
plugin-gantt (index.js)166.77KB40.76KB
plugin-grid (index.js)208.87KB56.58KB
plugin-kanban (index.js)53.21KB14.66KB
plugin-list (index.js)113.55KB27.68KB
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)29.34KB8.47KB
plugin-tree (index.js)8.98KB3.08KB
plugin-view (index.js)85.90KB21.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)81.07KB26.86KB
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-litant
os-litant marked this pull request as ready for review September 2, 2026 01:46
@os-litant
os-litant added this pull request to the merge queueSep 2, 2026
Merged via the queue into main with commit 92c65aaSep 2, 2026
32 checks passed
@os-litant
os-litant deleted the claude/issue-7231-gantt-reload-stale-finally branch September 2, 2026 02:01
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

2 participants

@os-litant@claude
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(plugin-gantt): guard reload()'s finally so a superseded run cannot clear the loading state - #7236

Merged
os-litant merged 1 commit into
mainfrom
claude/issue-7231-gantt-reload-stale-finally
Sep 2, 2026
Merged

fix(plugin-gantt): guard reload()'s finally so a superseded run cannot clear the loading state#7236
os-litant merged 1 commit into
mainfrom
claude/issue-7231-gantt-reload-stale-finally

Conversation

@os-litant

Copy link
Copy Markdown
Collaborator

Fixes#7231

The defect

ObjectGantt's reload() sequences concurrent runs with reloadSeqRef and guards every result write with isCurrent()setData on all three branches, setError on the error branch. Its finally carried no guard, so a superseded reload still flipped loading / refreshing off.

Note which ordering produces the symptom: not an exotic out-of-order response, but the plain one. The stale run only has to finish first, which is the ordinary case whenever a second reload is issued while the first is still in flight. The placeholder was released before any rows arrived and the chart painted empty until the fresh response landed. (The out-of-order case — fresh finishes first — is what the pre-existing setData guard already covered; it is kept below as a control.)

The caller measurement the card asked for

The card's "Not measured" paragraph was the first task. Enumerating reload()'s call sites in packages/plugin-gantt/src/ObjectGantt.tsx (line numbers on this branch):

Call siteModeWhat triggers it
:712useEffect(() => { reload(); }, [reload])non-silentmount; and any change of reload's identity — its deps at :707 are effectiveDataSource, resource, hasInlineData, dataProvider, dataItems, schema.filter, schema.sort, objectSchema. So this one site is the card's initial load, schema-resolution refire and view/filter change callers.
:1440silentwrite-readback after a drag / resize / progress update
:1484silentwrite-readback after a dependency-link write
:1585silentwrite-readback after a delete
:1753silenttoolbar refresh button (onRefresh on GanttView)
:1820silentwrite-readback after an inline edit in the record drawer

Which pairs can actually overlap:

  • non-silent + non-silent — reachable, and the visible one.:712 re-fires against itself: objectSchema resolving mid-flight re-keys reload, and so does a host changing schema.filter / schema.sort / the bound object. loading is the flag that gates the placeholder at :1596, so this is the pair that blanks the chart. Reproduced in the harness (case 1 below). It is not confined to the two-queries regime: the filter/sort/object route re-keys reload with no schema read involved.
  • silent + silent — reachable. Nothing serializes the write-readbacks and the toolbar refresh. Two quick inline edits, or a drag followed by a refresh click, overlap. No blanking here (they never touch loading), but the stale run used to drop refreshing while the fresh read was still outstanding, so the toolbar's disabled / aria-busy (GanttView.tsx:3449, :3451) went honest-to-lying mid-flight and the button accepted another click.
  • silent superseded by non-silent — reachable, and it decides the guard shape. Every silent caller runs with the chart mounted (loading === false), and a filter/sort change or a late objectSchema can re-key reload at any moment.
  • non-silent superseded by silent — not reachable from this component. Every silent caller sits behind the if (loading) return placeholder early return at :1596, so while a non-silent reload holds loading true there is no toolbar and no row handler mounted to fire one. Worth recording that the unguarded finally was itself the thing that opened this window: it released loading early and re-mounted the toolbar while the fresh query was still running.

So the defect is live on three distinct pairs, only one of which passes through schema resolution — which is the card's scoping fence, measured rather than assumed.

The fix, and why it clears both flags

}finally{if(isCurrent()){setRefreshing(false);setLoading(false);}}

The obvious form — clear only the flag this run's own silent mode set — is wrong on the third pair above. The superseded silent run correctly skips its clear; the current non-silent run clears only loading; nobody ever clears refreshing, and the refresh button stays busy for the life of the component. Clearing both is the honest form because reaching this point as the current run means nothing is in flight any more: a newer reload would have made this one stale, and an older one has no claim on the flags. Case 3 pins that shape.

Checked, per the card's warning, that the fresh run always reaches its own finally:

  • error pathcatch then finally, both modes, always.
  • early return inside try (host data prop at :658, inline value items at :663) — finally still runs.
  • abort — no AbortSignal is passed to effectiveDataSource.find() anywhere in this file, so there is no cancel path whose promise never settles. A find() that never settles would strand loading, identically before and after this change.
  • unmount — a setState after unmount is a no-op on this repo's React; unchanged here.

No path relied on the stale finally doing the clearing: reload increments reloadSeqRef as its first statement, so a newer sequence number always implies a newer run already inside its own try.

Tests

New file packages/plugin-gantt/src/ObjectGantt.staleReloadFinally-7231.test.tsx. A data source hands back deferred find() promises so two reloads can be held in flight and completed in either order; getObjectSchema resolves immediately, which is what issues the second reload while the first is pending.

  1. the defect — stale run finishes first: the placeholder must stay and no chart may render.
  2. control — fresh run finishes first: its rows paint, and the late stale answer neither clobbers the data nor puts the placeholder back. Green on the unmodified tree, so case 1's failure is a measurement rather than a broken harness.
  3. guard shape — a silent toolbar refresh superseded by a filter-change reload must not strand refreshing.

Ablation (run on the committed tree, guard reverted then restored):

  • resolution path: the test reaches the subject through a relative import (import { ObjectGantt } from './ObjectGantt'), so the subject is the source module and no dist/ is in the path — no rebuild leg applies.
  • mutation proven on disk before measuring: anchor if (isCurrent()) { 2 occurrences to 1, injected if (silent) setRefreshing(false); 0 to 1, blob c063fb2 to cb81262.
  • ablated run: Tests 1 failed | 2 passed (3) — exactly case 1 red, both controls green.
  • restore proven: blob back to c063fb2 (byte-identical to the HEAD blob), git diff HEAD empty, anchor counts back to 2 / 0.

Gates

All run on 529d546, the final commit, with the worktree clean:

GateVerdict line
pnpm exec vitest run packages/plugin-gantt/Test Files 57 passed (57) · Tests 451 passed (451)
pnpm --filter @object-ui/plugin-gantt run type-checkexit 0 (tsc --noEmit && tsc -p tsconfig.test.json — the second leg is what type-checks the new test file)
check:control-bytescheck-control-bytes: OK (scanned 5998 tracked text file(s); skipped 85 binary).
check:vi-mock-specifierscheck-vi-mock-specifiers: OK (4128 tracked source file(s), 2398 test-named; 533 carry a mock; 782 relative specifier(s) resolved...)
check:vi-mock-inheritcheck-vi-mock-inherit: OK (... 118 call site(s) on @object-ui/react judged (118 inherit, 0 auto-mocked) ...)
check:self-importNo package names itself inside its own src/.
check:phantom-depsEvery in-scope import is declared by the package that publishes it.
check-changeset-presence.mjs2 source file(s) of 1 released package(s) changed, and this change declares 1 changeset(s): .changeset/7231-gantt-stale-reload-finally.md.
check-changeset-no-major.mjsNo changeset declares a major bump.

Declared narrowing — eslint. The repo-wide pnpm lint (turbo run lint over the 42 packages that define a lint script) is CI's run. Locally eslint ran over the touched package only — eslint . inside packages/plugin-gantt, which is exactly the unit turbo invokes for it. Three readings, so the narrowing is a measurement and not a skip:

  1. population read from eslint's own resolution of eslint.config.js (its own walk and its own ignores), not from a guess about which files count;
  2. count read from --format json: 87 files, 0 errors, 333 warnings (the new test file contributes 10 warnings, in line with its siblings — .github/workflows/lint.yml deliberately sets no --max-warnings, so this gate is about errors);
  3. invariance for untouched files: eslint.config.js declares no parserOptions, no project and no projectService anywhere, so no rule reads type information across files — every verdict is single-file. Every config block matches **/*.{ts,tsx} only, so the added .changeset/*.md is outside the linted set entirely. This diff therefore cannot move the verdict on any file it does not contain.

Scope

Reload guard only. packages/plugin-gantt/src/ObjectGantt.tsx (the finally in the reload() closure), one new test beside it, one changeset. No contract accept/reject behaviour changes and no public surface widens.

Deliberately untouched, each queued or owned elsewhere: the buildExpandFields(objectSchema?.fields) projection site in this same file (that is #7230, which remains open and is queued behind this card); the paging / $top shape of the gantt fetch (#7210 remains open — its half 2 is a maintainer decision); and the schema-gating regime (#7225 and #6482 both remain open). Per the card, this is deliberately not folded into that gating work: a gate would hide the schema-resolution instance and leave the guard broken on the toolbar-refresh and write-readback pairs measured above.

🤖 Generated with Claude Code

https://claude.ai/code/session_01NRRumy89BYdW9ogbcdHTho

Generated by Claude Code


Generated by Claude Code

…annot clear the loading state
`reload()` sequences concurrent runs with `reloadSeqRef` and guards every result
write with `isCurrent()`, but its `finally` carried no guard. A superseded reload
therefore still flipped `loading` / `refreshing` off: the stale run only had to
finish first — the ordinary case whenever a second reload is issued while the
first is still in flight — and the placeholder was released before any rows had
arrived, painting an empty chart until the fresh response landed.
The `finally` now clears the flags only when the run reaching it is still current,
and clears BOTH of them rather than only the one its own `silent` mode set: being
current at that point means nothing is in flight any more, so clearing only its own
mode would strand the other flag whenever the superseded run used the other mode (a
silent toolbar refresh overtaken by a filter-change reload would have left
`refreshing` on for the life of the component).
New test file pins three orderings: the stale run finishing first (the defect —
red on the unguarded tree), the fresh run finishing first (control — green either
way, covering the pre-existing `setData` guard), and a silent run superseded by a
non-silent one (pins the clear-both shape).
Reload-guard only: which queries are issued, how they are projected and how they
page are all untouched.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NRRumy89BYdW9ogbcdHTho
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Eager closure (gzip, 48 chunks)3160.1 KB3191.4 KB
Main entry chunk (gzip)142.6 KB350 KB
Entry fileindex-9TBh-pag.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)15.33KB5.59KB
app-shell (runtime-config.js)20.68KB7.36KB
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)514.13KB117.19KB
core (index.js)5.55KB2.23KB
create-plugin (index.js)10.08KB3.26KB
data-objectstack (index.js)178.20KB49.60KB
fields (index.js)244.25KB61.73KB
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.98KB10.98KB
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)11.71KB4.29KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)6.24KB2.16KB
permissions (discardProofCache.js)1.04KB0.55KB
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)4.83KB2.27KB
plugin-ai (index.js)15.75KB3.80KB
plugin-calendar (index.js)46.92KB12.93KB
plugin-charts (index.js)70.02KB19.44KB
plugin-chatbot (index.js)190.53KB45.18KB
plugin-dashboard (index.js)132.63KB34.56KB
plugin-designer (index.js)212.87KB43.19KB
plugin-detail (index.js)250.65KB63.91KB
plugin-editor (index.js)2.46KB1.10KB
plugin-form (index.js)132.78KB32.58KB
plugin-gantt (index.js)166.77KB40.76KB
plugin-grid (index.js)208.87KB56.58KB
plugin-kanban (index.js)53.21KB14.66KB
plugin-list (index.js)113.55KB27.68KB
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)29.34KB8.47KB
plugin-tree (index.js)8.98KB3.08KB
plugin-view (index.js)85.90KB21.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)81.07KB26.86KB
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-litant
os-litant marked this pull request as ready for review September 2, 2026 01:46
@os-litant
os-litant added this pull request to the merge queueSep 2, 2026
Merged via the queue into main with commit 92c65aaSep 2, 2026
32 checks passed
@os-litant
os-litant deleted the claude/issue-7231-gantt-reload-stale-finally branch September 2, 2026 02:01
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

2 participants

@os-litant@claude
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

fix(plugin-gantt): guard reload()'s finally so a superseded run cannot clear the loading state - #7236

Merged
os-litant merged 1 commit into
mainfrom
claude/issue-7231-gantt-reload-stale-finally
Sep 2, 2026
Merged

fix(plugin-gantt): guard reload()'s finally so a superseded run cannot clear the loading state#7236
os-litant merged 1 commit into
mainfrom
claude/issue-7231-gantt-reload-stale-finally

Conversation

@os-litant

Copy link
Copy Markdown
Collaborator

Fixes#7231

The defect

ObjectGantt's reload() sequences concurrent runs with reloadSeqRef and guards every result write with isCurrent()setData on all three branches, setError on the error branch. Its finally carried no guard, so a superseded reload still flipped loading / refreshing off.

Note which ordering produces the symptom: not an exotic out-of-order response, but the plain one. The stale run only has to finish first, which is the ordinary case whenever a second reload is issued while the first is still in flight. The placeholder was released before any rows arrived and the chart painted empty until the fresh response landed. (The out-of-order case — fresh finishes first — is what the pre-existing setData guard already covered; it is kept below as a control.)

The caller measurement the card asked for

The card's "Not measured" paragraph was the first task. Enumerating reload()'s call sites in packages/plugin-gantt/src/ObjectGantt.tsx (line numbers on this branch):

Call siteModeWhat triggers it
:712useEffect(() => { reload(); }, [reload])non-silentmount; and any change of reload's identity — its deps at :707 are effectiveDataSource, resource, hasInlineData, dataProvider, dataItems, schema.filter, schema.sort, objectSchema. So this one site is the card's initial load, schema-resolution refire and view/filter change callers.
:1440silentwrite-readback after a drag / resize / progress update
:1484silentwrite-readback after a dependency-link write
:1585silentwrite-readback after a delete
:1753silenttoolbar refresh button (onRefresh on GanttView)
:1820silentwrite-readback after an inline edit in the record drawer

Which pairs can actually overlap:

  • non-silent + non-silent — reachable, and the visible one.:712 re-fires against itself: objectSchema resolving mid-flight re-keys reload, and so does a host changing schema.filter / schema.sort / the bound object. loading is the flag that gates the placeholder at :1596, so this is the pair that blanks the chart. Reproduced in the harness (case 1 below). It is not confined to the two-queries regime: the filter/sort/object route re-keys reload with no schema read involved.
  • silent + silent — reachable. Nothing serializes the write-readbacks and the toolbar refresh. Two quick inline edits, or a drag followed by a refresh click, overlap. No blanking here (they never touch loading), but the stale run used to drop refreshing while the fresh read was still outstanding, so the toolbar's disabled / aria-busy (GanttView.tsx:3449, :3451) went honest-to-lying mid-flight and the button accepted another click.
  • silent superseded by non-silent — reachable, and it decides the guard shape. Every silent caller runs with the chart mounted (loading === false), and a filter/sort change or a late objectSchema can re-key reload at any moment.
  • non-silent superseded by silent — not reachable from this component. Every silent caller sits behind the if (loading) return placeholder early return at :1596, so while a non-silent reload holds loading true there is no toolbar and no row handler mounted to fire one. Worth recording that the unguarded finally was itself the thing that opened this window: it released loading early and re-mounted the toolbar while the fresh query was still running.

So the defect is live on three distinct pairs, only one of which passes through schema resolution — which is the card's scoping fence, measured rather than assumed.

The fix, and why it clears both flags

}finally{if(isCurrent()){setRefreshing(false);setLoading(false);}}

The obvious form — clear only the flag this run's own silent mode set — is wrong on the third pair above. The superseded silent run correctly skips its clear; the current non-silent run clears only loading; nobody ever clears refreshing, and the refresh button stays busy for the life of the component. Clearing both is the honest form because reaching this point as the current run means nothing is in flight any more: a newer reload would have made this one stale, and an older one has no claim on the flags. Case 3 pins that shape.

Checked, per the card's warning, that the fresh run always reaches its own finally:

  • error pathcatch then finally, both modes, always.
  • early return inside try (host data prop at :658, inline value items at :663) — finally still runs.
  • abort — no AbortSignal is passed to effectiveDataSource.find() anywhere in this file, so there is no cancel path whose promise never settles. A find() that never settles would strand loading, identically before and after this change.
  • unmount — a setState after unmount is a no-op on this repo's React; unchanged here.

No path relied on the stale finally doing the clearing: reload increments reloadSeqRef as its first statement, so a newer sequence number always implies a newer run already inside its own try.

Tests

New file packages/plugin-gantt/src/ObjectGantt.staleReloadFinally-7231.test.tsx. A data source hands back deferred find() promises so two reloads can be held in flight and completed in either order; getObjectSchema resolves immediately, which is what issues the second reload while the first is pending.

  1. the defect — stale run finishes first: the placeholder must stay and no chart may render.
  2. control — fresh run finishes first: its rows paint, and the late stale answer neither clobbers the data nor puts the placeholder back. Green on the unmodified tree, so case 1's failure is a measurement rather than a broken harness.
  3. guard shape — a silent toolbar refresh superseded by a filter-change reload must not strand refreshing.

Ablation (run on the committed tree, guard reverted then restored):

  • resolution path: the test reaches the subject through a relative import (import { ObjectGantt } from './ObjectGantt'), so the subject is the source module and no dist/ is in the path — no rebuild leg applies.
  • mutation proven on disk before measuring: anchor if (isCurrent()) { 2 occurrences to 1, injected if (silent) setRefreshing(false); 0 to 1, blob c063fb2 to cb81262.
  • ablated run: Tests 1 failed | 2 passed (3) — exactly case 1 red, both controls green.
  • restore proven: blob back to c063fb2 (byte-identical to the HEAD blob), git diff HEAD empty, anchor counts back to 2 / 0.

Gates

All run on 529d546, the final commit, with the worktree clean:

GateVerdict line
pnpm exec vitest run packages/plugin-gantt/Test Files 57 passed (57) · Tests 451 passed (451)
pnpm --filter @object-ui/plugin-gantt run type-checkexit 0 (tsc --noEmit && tsc -p tsconfig.test.json — the second leg is what type-checks the new test file)
check:control-bytescheck-control-bytes: OK (scanned 5998 tracked text file(s); skipped 85 binary).
check:vi-mock-specifierscheck-vi-mock-specifiers: OK (4128 tracked source file(s), 2398 test-named; 533 carry a mock; 782 relative specifier(s) resolved...)
check:vi-mock-inheritcheck-vi-mock-inherit: OK (... 118 call site(s) on @object-ui/react judged (118 inherit, 0 auto-mocked) ...)
check:self-importNo package names itself inside its own src/.
check:phantom-depsEvery in-scope import is declared by the package that publishes it.
check-changeset-presence.mjs2 source file(s) of 1 released package(s) changed, and this change declares 1 changeset(s): .changeset/7231-gantt-stale-reload-finally.md.
check-changeset-no-major.mjsNo changeset declares a major bump.

Declared narrowing — eslint. The repo-wide pnpm lint (turbo run lint over the 42 packages that define a lint script) is CI's run. Locally eslint ran over the touched package only — eslint . inside packages/plugin-gantt, which is exactly the unit turbo invokes for it. Three readings, so the narrowing is a measurement and not a skip:

  1. population read from eslint's own resolution of eslint.config.js (its own walk and its own ignores), not from a guess about which files count;
  2. count read from --format json: 87 files, 0 errors, 333 warnings (the new test file contributes 10 warnings, in line with its siblings — .github/workflows/lint.yml deliberately sets no --max-warnings, so this gate is about errors);
  3. invariance for untouched files: eslint.config.js declares no parserOptions, no project and no projectService anywhere, so no rule reads type information across files — every verdict is single-file. Every config block matches **/*.{ts,tsx} only, so the added .changeset/*.md is outside the linted set entirely. This diff therefore cannot move the verdict on any file it does not contain.

Scope

Reload guard only. packages/plugin-gantt/src/ObjectGantt.tsx (the finally in the reload() closure), one new test beside it, one changeset. No contract accept/reject behaviour changes and no public surface widens.

Deliberately untouched, each queued or owned elsewhere: the buildExpandFields(objectSchema?.fields) projection site in this same file (that is #7230, which remains open and is queued behind this card); the paging / $top shape of the gantt fetch (#7210 remains open — its half 2 is a maintainer decision); and the schema-gating regime (#7225 and #6482 both remain open). Per the card, this is deliberately not folded into that gating work: a gate would hide the schema-resolution instance and leave the guard broken on the toolbar-refresh and write-readback pairs measured above.

🤖 Generated with Claude Code

https://claude.ai/code/session_01NRRumy89BYdW9ogbcdHTho

Generated by Claude Code


Generated by Claude Code

…annot clear the loading state
`reload()` sequences concurrent runs with `reloadSeqRef` and guards every result
write with `isCurrent()`, but its `finally` carried no guard. A superseded reload
therefore still flipped `loading` / `refreshing` off: the stale run only had to
finish first — the ordinary case whenever a second reload is issued while the
first is still in flight — and the placeholder was released before any rows had
arrived, painting an empty chart until the fresh response landed.
The `finally` now clears the flags only when the run reaching it is still current,
and clears BOTH of them rather than only the one its own `silent` mode set: being
current at that point means nothing is in flight any more, so clearing only its own
mode would strand the other flag whenever the superseded run used the other mode (a
silent toolbar refresh overtaken by a filter-change reload would have left
`refreshing` on for the life of the component).
New test file pins three orderings: the stale run finishing first (the defect —
red on the unguarded tree), the fresh run finishing first (control — green either
way, covering the pre-existing `setData` guard), and a silent run superseded by a
non-silent one (pins the clear-both shape).
Reload-guard only: which queries are issued, how they are projected and how they
page are all untouched.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NRRumy89BYdW9ogbcdHTho
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Eager closure (gzip, 48 chunks)3160.1 KB3191.4 KB
Main entry chunk (gzip)142.6 KB350 KB
Entry fileindex-9TBh-pag.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)15.33KB5.59KB
app-shell (runtime-config.js)20.68KB7.36KB
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)514.13KB117.19KB
core (index.js)5.55KB2.23KB
create-plugin (index.js)10.08KB3.26KB
data-objectstack (index.js)178.20KB49.60KB
fields (index.js)244.25KB61.73KB
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.98KB10.98KB
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)11.71KB4.29KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)6.24KB2.16KB
permissions (discardProofCache.js)1.04KB0.55KB
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)4.83KB2.27KB
plugin-ai (index.js)15.75KB3.80KB
plugin-calendar (index.js)46.92KB12.93KB
plugin-charts (index.js)70.02KB19.44KB
plugin-chatbot (index.js)190.53KB45.18KB
plugin-dashboard (index.js)132.63KB34.56KB
plugin-designer (index.js)212.87KB43.19KB
plugin-detail (index.js)250.65KB63.91KB
plugin-editor (index.js)2.46KB1.10KB
plugin-form (index.js)132.78KB32.58KB
plugin-gantt (index.js)166.77KB40.76KB
plugin-grid (index.js)208.87KB56.58KB
plugin-kanban (index.js)53.21KB14.66KB
plugin-list (index.js)113.55KB27.68KB
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)29.34KB8.47KB
plugin-tree (index.js)8.98KB3.08KB
plugin-view (index.js)85.90KB21.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)81.07KB26.86KB
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-litant
os-litant marked this pull request as ready for review September 2, 2026 01:46
@os-litant
os-litant added this pull request to the merge queueSep 2, 2026
Merged via the queue into main with commit 92c65aaSep 2, 2026
32 checks passed
@os-litant
os-litant deleted the claude/issue-7231-gantt-reload-stale-finally branch September 2, 2026 02:01
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

2 participants

@os-litant@claude
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(plugin-gantt): guard reload()'s finally so a superseded run cannot clear the loading state - #7236

Merged
os-litant merged 1 commit into
mainfrom
claude/issue-7231-gantt-reload-stale-finally
Sep 2, 2026
Merged

fix(plugin-gantt): guard reload()'s finally so a superseded run cannot clear the loading state#7236
os-litant merged 1 commit into
mainfrom
claude/issue-7231-gantt-reload-stale-finally

Conversation

@os-litant

Copy link
Copy Markdown
Collaborator

Fixes#7231

The defect

ObjectGantt's reload() sequences concurrent runs with reloadSeqRef and guards every result write with isCurrent()setData on all three branches, setError on the error branch. Its finally carried no guard, so a superseded reload still flipped loading / refreshing off.

Note which ordering produces the symptom: not an exotic out-of-order response, but the plain one. The stale run only has to finish first, which is the ordinary case whenever a second reload is issued while the first is still in flight. The placeholder was released before any rows arrived and the chart painted empty until the fresh response landed. (The out-of-order case — fresh finishes first — is what the pre-existing setData guard already covered; it is kept below as a control.)

The caller measurement the card asked for

The card's "Not measured" paragraph was the first task. Enumerating reload()'s call sites in packages/plugin-gantt/src/ObjectGantt.tsx (line numbers on this branch):

Call siteModeWhat triggers it
:712useEffect(() => { reload(); }, [reload])non-silentmount; and any change of reload's identity — its deps at :707 are effectiveDataSource, resource, hasInlineData, dataProvider, dataItems, schema.filter, schema.sort, objectSchema. So this one site is the card's initial load, schema-resolution refire and view/filter change callers.
:1440silentwrite-readback after a drag / resize / progress update
:1484silentwrite-readback after a dependency-link write
:1585silentwrite-readback after a delete
:1753silenttoolbar refresh button (onRefresh on GanttView)
:1820silentwrite-readback after an inline edit in the record drawer

Which pairs can actually overlap:

  • non-silent + non-silent — reachable, and the visible one.:712 re-fires against itself: objectSchema resolving mid-flight re-keys reload, and so does a host changing schema.filter / schema.sort / the bound object. loading is the flag that gates the placeholder at :1596, so this is the pair that blanks the chart. Reproduced in the harness (case 1 below). It is not confined to the two-queries regime: the filter/sort/object route re-keys reload with no schema read involved.
  • silent + silent — reachable. Nothing serializes the write-readbacks and the toolbar refresh. Two quick inline edits, or a drag followed by a refresh click, overlap. No blanking here (they never touch loading), but the stale run used to drop refreshing while the fresh read was still outstanding, so the toolbar's disabled / aria-busy (GanttView.tsx:3449, :3451) went honest-to-lying mid-flight and the button accepted another click.
  • silent superseded by non-silent — reachable, and it decides the guard shape. Every silent caller runs with the chart mounted (loading === false), and a filter/sort change or a late objectSchema can re-key reload at any moment.
  • non-silent superseded by silent — not reachable from this component. Every silent caller sits behind the if (loading) return placeholder early return at :1596, so while a non-silent reload holds loading true there is no toolbar and no row handler mounted to fire one. Worth recording that the unguarded finally was itself the thing that opened this window: it released loading early and re-mounted the toolbar while the fresh query was still running.

So the defect is live on three distinct pairs, only one of which passes through schema resolution — which is the card's scoping fence, measured rather than assumed.

The fix, and why it clears both flags

}finally{if(isCurrent()){setRefreshing(false);setLoading(false);}}

The obvious form — clear only the flag this run's own silent mode set — is wrong on the third pair above. The superseded silent run correctly skips its clear; the current non-silent run clears only loading; nobody ever clears refreshing, and the refresh button stays busy for the life of the component. Clearing both is the honest form because reaching this point as the current run means nothing is in flight any more: a newer reload would have made this one stale, and an older one has no claim on the flags. Case 3 pins that shape.

Checked, per the card's warning, that the fresh run always reaches its own finally:

  • error pathcatch then finally, both modes, always.
  • early return inside try (host data prop at :658, inline value items at :663) — finally still runs.
  • abort — no AbortSignal is passed to effectiveDataSource.find() anywhere in this file, so there is no cancel path whose promise never settles. A find() that never settles would strand loading, identically before and after this change.
  • unmount — a setState after unmount is a no-op on this repo's React; unchanged here.

No path relied on the stale finally doing the clearing: reload increments reloadSeqRef as its first statement, so a newer sequence number always implies a newer run already inside its own try.

Tests

New file packages/plugin-gantt/src/ObjectGantt.staleReloadFinally-7231.test.tsx. A data source hands back deferred find() promises so two reloads can be held in flight and completed in either order; getObjectSchema resolves immediately, which is what issues the second reload while the first is pending.

  1. the defect — stale run finishes first: the placeholder must stay and no chart may render.
  2. control — fresh run finishes first: its rows paint, and the late stale answer neither clobbers the data nor puts the placeholder back. Green on the unmodified tree, so case 1's failure is a measurement rather than a broken harness.
  3. guard shape — a silent toolbar refresh superseded by a filter-change reload must not strand refreshing.

Ablation (run on the committed tree, guard reverted then restored):

  • resolution path: the test reaches the subject through a relative import (import { ObjectGantt } from './ObjectGantt'), so the subject is the source module and no dist/ is in the path — no rebuild leg applies.
  • mutation proven on disk before measuring: anchor if (isCurrent()) { 2 occurrences to 1, injected if (silent) setRefreshing(false); 0 to 1, blob c063fb2 to cb81262.
  • ablated run: Tests 1 failed | 2 passed (3) — exactly case 1 red, both controls green.
  • restore proven: blob back to c063fb2 (byte-identical to the HEAD blob), git diff HEAD empty, anchor counts back to 2 / 0.

Gates

All run on 529d546, the final commit, with the worktree clean:

GateVerdict line
pnpm exec vitest run packages/plugin-gantt/Test Files 57 passed (57) · Tests 451 passed (451)
pnpm --filter @object-ui/plugin-gantt run type-checkexit 0 (tsc --noEmit && tsc -p tsconfig.test.json — the second leg is what type-checks the new test file)
check:control-bytescheck-control-bytes: OK (scanned 5998 tracked text file(s); skipped 85 binary).
check:vi-mock-specifierscheck-vi-mock-specifiers: OK (4128 tracked source file(s), 2398 test-named; 533 carry a mock; 782 relative specifier(s) resolved...)
check:vi-mock-inheritcheck-vi-mock-inherit: OK (... 118 call site(s) on @object-ui/react judged (118 inherit, 0 auto-mocked) ...)
check:self-importNo package names itself inside its own src/.
check:phantom-depsEvery in-scope import is declared by the package that publishes it.
check-changeset-presence.mjs2 source file(s) of 1 released package(s) changed, and this change declares 1 changeset(s): .changeset/7231-gantt-stale-reload-finally.md.
check-changeset-no-major.mjsNo changeset declares a major bump.

Declared narrowing — eslint. The repo-wide pnpm lint (turbo run lint over the 42 packages that define a lint script) is CI's run. Locally eslint ran over the touched package only — eslint . inside packages/plugin-gantt, which is exactly the unit turbo invokes for it. Three readings, so the narrowing is a measurement and not a skip:

  1. population read from eslint's own resolution of eslint.config.js (its own walk and its own ignores), not from a guess about which files count;
  2. count read from --format json: 87 files, 0 errors, 333 warnings (the new test file contributes 10 warnings, in line with its siblings — .github/workflows/lint.yml deliberately sets no --max-warnings, so this gate is about errors);
  3. invariance for untouched files: eslint.config.js declares no parserOptions, no project and no projectService anywhere, so no rule reads type information across files — every verdict is single-file. Every config block matches **/*.{ts,tsx} only, so the added .changeset/*.md is outside the linted set entirely. This diff therefore cannot move the verdict on any file it does not contain.

Scope

Reload guard only. packages/plugin-gantt/src/ObjectGantt.tsx (the finally in the reload() closure), one new test beside it, one changeset. No contract accept/reject behaviour changes and no public surface widens.

Deliberately untouched, each queued or owned elsewhere: the buildExpandFields(objectSchema?.fields) projection site in this same file (that is #7230, which remains open and is queued behind this card); the paging / $top shape of the gantt fetch (#7210 remains open — its half 2 is a maintainer decision); and the schema-gating regime (#7225 and #6482 both remain open). Per the card, this is deliberately not folded into that gating work: a gate would hide the schema-resolution instance and leave the guard broken on the toolbar-refresh and write-readback pairs measured above.

🤖 Generated with Claude Code

https://claude.ai/code/session_01NRRumy89BYdW9ogbcdHTho

Generated by Claude Code


Generated by Claude Code

…annot clear the loading state
`reload()` sequences concurrent runs with `reloadSeqRef` and guards every result
write with `isCurrent()`, but its `finally` carried no guard. A superseded reload
therefore still flipped `loading` / `refreshing` off: the stale run only had to
finish first — the ordinary case whenever a second reload is issued while the
first is still in flight — and the placeholder was released before any rows had
arrived, painting an empty chart until the fresh response landed.
The `finally` now clears the flags only when the run reaching it is still current,
and clears BOTH of them rather than only the one its own `silent` mode set: being
current at that point means nothing is in flight any more, so clearing only its own
mode would strand the other flag whenever the superseded run used the other mode (a
silent toolbar refresh overtaken by a filter-change reload would have left
`refreshing` on for the life of the component).
New test file pins three orderings: the stale run finishing first (the defect —
red on the unguarded tree), the fresh run finishing first (control — green either
way, covering the pre-existing `setData` guard), and a silent run superseded by a
non-silent one (pins the clear-both shape).
Reload-guard only: which queries are issued, how they are projected and how they
page are all untouched.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NRRumy89BYdW9ogbcdHTho
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Eager closure (gzip, 48 chunks)3160.1 KB3191.4 KB
Main entry chunk (gzip)142.6 KB350 KB
Entry fileindex-9TBh-pag.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)15.33KB5.59KB
app-shell (runtime-config.js)20.68KB7.36KB
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)514.13KB117.19KB
core (index.js)5.55KB2.23KB
create-plugin (index.js)10.08KB3.26KB
data-objectstack (index.js)178.20KB49.60KB
fields (index.js)244.25KB61.73KB
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.98KB10.98KB
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)11.71KB4.29KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)6.24KB2.16KB
permissions (discardProofCache.js)1.04KB0.55KB
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)4.83KB2.27KB
plugin-ai (index.js)15.75KB3.80KB
plugin-calendar (index.js)46.92KB12.93KB
plugin-charts (index.js)70.02KB19.44KB
plugin-chatbot (index.js)190.53KB45.18KB
plugin-dashboard (index.js)132.63KB34.56KB
plugin-designer (index.js)212.87KB43.19KB
plugin-detail (index.js)250.65KB63.91KB
plugin-editor (index.js)2.46KB1.10KB
plugin-form (index.js)132.78KB32.58KB
plugin-gantt (index.js)166.77KB40.76KB
plugin-grid (index.js)208.87KB56.58KB
plugin-kanban (index.js)53.21KB14.66KB
plugin-list (index.js)113.55KB27.68KB
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)29.34KB8.47KB
plugin-tree (index.js)8.98KB3.08KB
plugin-view (index.js)85.90KB21.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)81.07KB26.86KB
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-litant
os-litant marked this pull request as ready for review September 2, 2026 01:46
@os-litant
os-litant added this pull request to the merge queueSep 2, 2026
Merged via the queue into main with commit 92c65aaSep 2, 2026
32 checks passed
@os-litant
os-litant deleted the claude/issue-7231-gantt-reload-stale-finally branch September 2, 2026 02:01
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

2 participants

@os-litant@claude
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(plugin-gantt): guard reload()'s finally so a superseded run cannot clear the loading state - #7236

Merged
os-litant merged 1 commit into
mainfrom
claude/issue-7231-gantt-reload-stale-finally
Sep 2, 2026
Merged

fix(plugin-gantt): guard reload()'s finally so a superseded run cannot clear the loading state#7236
os-litant merged 1 commit into
mainfrom
claude/issue-7231-gantt-reload-stale-finally

Conversation

@os-litant

Copy link
Copy Markdown
Collaborator

Fixes#7231

The defect

ObjectGantt's reload() sequences concurrent runs with reloadSeqRef and guards every result write with isCurrent()setData on all three branches, setError on the error branch. Its finally carried no guard, so a superseded reload still flipped loading / refreshing off.

Note which ordering produces the symptom: not an exotic out-of-order response, but the plain one. The stale run only has to finish first, which is the ordinary case whenever a second reload is issued while the first is still in flight. The placeholder was released before any rows arrived and the chart painted empty until the fresh response landed. (The out-of-order case — fresh finishes first — is what the pre-existing setData guard already covered; it is kept below as a control.)

The caller measurement the card asked for

The card's "Not measured" paragraph was the first task. Enumerating reload()'s call sites in packages/plugin-gantt/src/ObjectGantt.tsx (line numbers on this branch):

Call siteModeWhat triggers it
:712useEffect(() => { reload(); }, [reload])non-silentmount; and any change of reload's identity — its deps at :707 are effectiveDataSource, resource, hasInlineData, dataProvider, dataItems, schema.filter, schema.sort, objectSchema. So this one site is the card's initial load, schema-resolution refire and view/filter change callers.
:1440silentwrite-readback after a drag / resize / progress update
:1484silentwrite-readback after a dependency-link write
:1585silentwrite-readback after a delete
:1753silenttoolbar refresh button (onRefresh on GanttView)
:1820silentwrite-readback after an inline edit in the record drawer

Which pairs can actually overlap:

  • non-silent + non-silent — reachable, and the visible one.:712 re-fires against itself: objectSchema resolving mid-flight re-keys reload, and so does a host changing schema.filter / schema.sort / the bound object. loading is the flag that gates the placeholder at :1596, so this is the pair that blanks the chart. Reproduced in the harness (case 1 below). It is not confined to the two-queries regime: the filter/sort/object route re-keys reload with no schema read involved.
  • silent + silent — reachable. Nothing serializes the write-readbacks and the toolbar refresh. Two quick inline edits, or a drag followed by a refresh click, overlap. No blanking here (they never touch loading), but the stale run used to drop refreshing while the fresh read was still outstanding, so the toolbar's disabled / aria-busy (GanttView.tsx:3449, :3451) went honest-to-lying mid-flight and the button accepted another click.
  • silent superseded by non-silent — reachable, and it decides the guard shape. Every silent caller runs with the chart mounted (loading === false), and a filter/sort change or a late objectSchema can re-key reload at any moment.
  • non-silent superseded by silent — not reachable from this component. Every silent caller sits behind the if (loading) return placeholder early return at :1596, so while a non-silent reload holds loading true there is no toolbar and no row handler mounted to fire one. Worth recording that the unguarded finally was itself the thing that opened this window: it released loading early and re-mounted the toolbar while the fresh query was still running.

So the defect is live on three distinct pairs, only one of which passes through schema resolution — which is the card's scoping fence, measured rather than assumed.

The fix, and why it clears both flags

}finally{if(isCurrent()){setRefreshing(false);setLoading(false);}}

The obvious form — clear only the flag this run's own silent mode set — is wrong on the third pair above. The superseded silent run correctly skips its clear; the current non-silent run clears only loading; nobody ever clears refreshing, and the refresh button stays busy for the life of the component. Clearing both is the honest form because reaching this point as the current run means nothing is in flight any more: a newer reload would have made this one stale, and an older one has no claim on the flags. Case 3 pins that shape.

Checked, per the card's warning, that the fresh run always reaches its own finally:

  • error pathcatch then finally, both modes, always.
  • early return inside try (host data prop at :658, inline value items at :663) — finally still runs.
  • abort — no AbortSignal is passed to effectiveDataSource.find() anywhere in this file, so there is no cancel path whose promise never settles. A find() that never settles would strand loading, identically before and after this change.
  • unmount — a setState after unmount is a no-op on this repo's React; unchanged here.

No path relied on the stale finally doing the clearing: reload increments reloadSeqRef as its first statement, so a newer sequence number always implies a newer run already inside its own try.

Tests

New file packages/plugin-gantt/src/ObjectGantt.staleReloadFinally-7231.test.tsx. A data source hands back deferred find() promises so two reloads can be held in flight and completed in either order; getObjectSchema resolves immediately, which is what issues the second reload while the first is pending.

  1. the defect — stale run finishes first: the placeholder must stay and no chart may render.
  2. control — fresh run finishes first: its rows paint, and the late stale answer neither clobbers the data nor puts the placeholder back. Green on the unmodified tree, so case 1's failure is a measurement rather than a broken harness.
  3. guard shape — a silent toolbar refresh superseded by a filter-change reload must not strand refreshing.

Ablation (run on the committed tree, guard reverted then restored):

  • resolution path: the test reaches the subject through a relative import (import { ObjectGantt } from './ObjectGantt'), so the subject is the source module and no dist/ is in the path — no rebuild leg applies.
  • mutation proven on disk before measuring: anchor if (isCurrent()) { 2 occurrences to 1, injected if (silent) setRefreshing(false); 0 to 1, blob c063fb2 to cb81262.
  • ablated run: Tests 1 failed | 2 passed (3) — exactly case 1 red, both controls green.
  • restore proven: blob back to c063fb2 (byte-identical to the HEAD blob), git diff HEAD empty, anchor counts back to 2 / 0.

Gates

All run on 529d546, the final commit, with the worktree clean:

GateVerdict line
pnpm exec vitest run packages/plugin-gantt/Test Files 57 passed (57) · Tests 451 passed (451)
pnpm --filter @object-ui/plugin-gantt run type-checkexit 0 (tsc --noEmit && tsc -p tsconfig.test.json — the second leg is what type-checks the new test file)
check:control-bytescheck-control-bytes: OK (scanned 5998 tracked text file(s); skipped 85 binary).
check:vi-mock-specifierscheck-vi-mock-specifiers: OK (4128 tracked source file(s), 2398 test-named; 533 carry a mock; 782 relative specifier(s) resolved...)
check:vi-mock-inheritcheck-vi-mock-inherit: OK (... 118 call site(s) on @object-ui/react judged (118 inherit, 0 auto-mocked) ...)
check:self-importNo package names itself inside its own src/.
check:phantom-depsEvery in-scope import is declared by the package that publishes it.
check-changeset-presence.mjs2 source file(s) of 1 released package(s) changed, and this change declares 1 changeset(s): .changeset/7231-gantt-stale-reload-finally.md.
check-changeset-no-major.mjsNo changeset declares a major bump.

Declared narrowing — eslint. The repo-wide pnpm lint (turbo run lint over the 42 packages that define a lint script) is CI's run. Locally eslint ran over the touched package only — eslint . inside packages/plugin-gantt, which is exactly the unit turbo invokes for it. Three readings, so the narrowing is a measurement and not a skip:

  1. population read from eslint's own resolution of eslint.config.js (its own walk and its own ignores), not from a guess about which files count;
  2. count read from --format json: 87 files, 0 errors, 333 warnings (the new test file contributes 10 warnings, in line with its siblings — .github/workflows/lint.yml deliberately sets no --max-warnings, so this gate is about errors);
  3. invariance for untouched files: eslint.config.js declares no parserOptions, no project and no projectService anywhere, so no rule reads type information across files — every verdict is single-file. Every config block matches **/*.{ts,tsx} only, so the added .changeset/*.md is outside the linted set entirely. This diff therefore cannot move the verdict on any file it does not contain.

Scope

Reload guard only. packages/plugin-gantt/src/ObjectGantt.tsx (the finally in the reload() closure), one new test beside it, one changeset. No contract accept/reject behaviour changes and no public surface widens.

Deliberately untouched, each queued or owned elsewhere: the buildExpandFields(objectSchema?.fields) projection site in this same file (that is #7230, which remains open and is queued behind this card); the paging / $top shape of the gantt fetch (#7210 remains open — its half 2 is a maintainer decision); and the schema-gating regime (#7225 and #6482 both remain open). Per the card, this is deliberately not folded into that gating work: a gate would hide the schema-resolution instance and leave the guard broken on the toolbar-refresh and write-readback pairs measured above.

🤖 Generated with Claude Code

https://claude.ai/code/session_01NRRumy89BYdW9ogbcdHTho

Generated by Claude Code


Generated by Claude Code

…annot clear the loading state
`reload()` sequences concurrent runs with `reloadSeqRef` and guards every result
write with `isCurrent()`, but its `finally` carried no guard. A superseded reload
therefore still flipped `loading` / `refreshing` off: the stale run only had to
finish first — the ordinary case whenever a second reload is issued while the
first is still in flight — and the placeholder was released before any rows had
arrived, painting an empty chart until the fresh response landed.
The `finally` now clears the flags only when the run reaching it is still current,
and clears BOTH of them rather than only the one its own `silent` mode set: being
current at that point means nothing is in flight any more, so clearing only its own
mode would strand the other flag whenever the superseded run used the other mode (a
silent toolbar refresh overtaken by a filter-change reload would have left
`refreshing` on for the life of the component).
New test file pins three orderings: the stale run finishing first (the defect —
red on the unguarded tree), the fresh run finishing first (control — green either
way, covering the pre-existing `setData` guard), and a silent run superseded by a
non-silent one (pins the clear-both shape).
Reload-guard only: which queries are issued, how they are projected and how they
page are all untouched.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NRRumy89BYdW9ogbcdHTho
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Eager closure (gzip, 48 chunks)3160.1 KB3191.4 KB
Main entry chunk (gzip)142.6 KB350 KB
Entry fileindex-9TBh-pag.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)15.33KB5.59KB
app-shell (runtime-config.js)20.68KB7.36KB
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)514.13KB117.19KB
core (index.js)5.55KB2.23KB
create-plugin (index.js)10.08KB3.26KB
data-objectstack (index.js)178.20KB49.60KB
fields (index.js)244.25KB61.73KB
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.98KB10.98KB
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)11.71KB4.29KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)6.24KB2.16KB
permissions (discardProofCache.js)1.04KB0.55KB
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)4.83KB2.27KB
plugin-ai (index.js)15.75KB3.80KB
plugin-calendar (index.js)46.92KB12.93KB
plugin-charts (index.js)70.02KB19.44KB
plugin-chatbot (index.js)190.53KB45.18KB
plugin-dashboard (index.js)132.63KB34.56KB
plugin-designer (index.js)212.87KB43.19KB
plugin-detail (index.js)250.65KB63.91KB
plugin-editor (index.js)2.46KB1.10KB
plugin-form (index.js)132.78KB32.58KB
plugin-gantt (index.js)166.77KB40.76KB
plugin-grid (index.js)208.87KB56.58KB
plugin-kanban (index.js)53.21KB14.66KB
plugin-list (index.js)113.55KB27.68KB
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)29.34KB8.47KB
plugin-tree (index.js)8.98KB3.08KB
plugin-view (index.js)85.90KB21.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)81.07KB26.86KB
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-litant
os-litant marked this pull request as ready for review September 2, 2026 01:46
@os-litant
os-litant added this pull request to the merge queueSep 2, 2026
Merged via the queue into main with commit 92c65aaSep 2, 2026
32 checks passed
@os-litant
os-litant deleted the claude/issue-7231-gantt-reload-stale-finally branch September 2, 2026 02:01
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

2 participants

@os-litant@claude
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

fix(plugin-gantt): guard reload()'s finally so a superseded run cannot clear the loading state - #7236

Merged
os-litant merged 1 commit into
mainfrom
claude/issue-7231-gantt-reload-stale-finally
Sep 2, 2026
Merged

fix(plugin-gantt): guard reload()'s finally so a superseded run cannot clear the loading state#7236
os-litant merged 1 commit into
mainfrom
claude/issue-7231-gantt-reload-stale-finally

Conversation

@os-litant

Copy link
Copy Markdown
Collaborator

Fixes#7231

The defect

ObjectGantt's reload() sequences concurrent runs with reloadSeqRef and guards every result write with isCurrent()setData on all three branches, setError on the error branch. Its finally carried no guard, so a superseded reload still flipped loading / refreshing off.

Note which ordering produces the symptom: not an exotic out-of-order response, but the plain one. The stale run only has to finish first, which is the ordinary case whenever a second reload is issued while the first is still in flight. The placeholder was released before any rows arrived and the chart painted empty until the fresh response landed. (The out-of-order case — fresh finishes first — is what the pre-existing setData guard already covered; it is kept below as a control.)

The caller measurement the card asked for

The card's "Not measured" paragraph was the first task. Enumerating reload()'s call sites in packages/plugin-gantt/src/ObjectGantt.tsx (line numbers on this branch):

Call siteModeWhat triggers it
:712useEffect(() => { reload(); }, [reload])non-silentmount; and any change of reload's identity — its deps at :707 are effectiveDataSource, resource, hasInlineData, dataProvider, dataItems, schema.filter, schema.sort, objectSchema. So this one site is the card's initial load, schema-resolution refire and view/filter change callers.
:1440silentwrite-readback after a drag / resize / progress update
:1484silentwrite-readback after a dependency-link write
:1585silentwrite-readback after a delete
:1753silenttoolbar refresh button (onRefresh on GanttView)
:1820silentwrite-readback after an inline edit in the record drawer

Which pairs can actually overlap:

  • non-silent + non-silent — reachable, and the visible one.:712 re-fires against itself: objectSchema resolving mid-flight re-keys reload, and so does a host changing schema.filter / schema.sort / the bound object. loading is the flag that gates the placeholder at :1596, so this is the pair that blanks the chart. Reproduced in the harness (case 1 below). It is not confined to the two-queries regime: the filter/sort/object route re-keys reload with no schema read involved.
  • silent + silent — reachable. Nothing serializes the write-readbacks and the toolbar refresh. Two quick inline edits, or a drag followed by a refresh click, overlap. No blanking here (they never touch loading), but the stale run used to drop refreshing while the fresh read was still outstanding, so the toolbar's disabled / aria-busy (GanttView.tsx:3449, :3451) went honest-to-lying mid-flight and the button accepted another click.
  • silent superseded by non-silent — reachable, and it decides the guard shape. Every silent caller runs with the chart mounted (loading === false), and a filter/sort change or a late objectSchema can re-key reload at any moment.
  • non-silent superseded by silent — not reachable from this component. Every silent caller sits behind the if (loading) return placeholder early return at :1596, so while a non-silent reload holds loading true there is no toolbar and no row handler mounted to fire one. Worth recording that the unguarded finally was itself the thing that opened this window: it released loading early and re-mounted the toolbar while the fresh query was still running.

So the defect is live on three distinct pairs, only one of which passes through schema resolution — which is the card's scoping fence, measured rather than assumed.

The fix, and why it clears both flags

}finally{if(isCurrent()){setRefreshing(false);setLoading(false);}}

The obvious form — clear only the flag this run's own silent mode set — is wrong on the third pair above. The superseded silent run correctly skips its clear; the current non-silent run clears only loading; nobody ever clears refreshing, and the refresh button stays busy for the life of the component. Clearing both is the honest form because reaching this point as the current run means nothing is in flight any more: a newer reload would have made this one stale, and an older one has no claim on the flags. Case 3 pins that shape.

Checked, per the card's warning, that the fresh run always reaches its own finally:

  • error pathcatch then finally, both modes, always.
  • early return inside try (host data prop at :658, inline value items at :663) — finally still runs.
  • abort — no AbortSignal is passed to effectiveDataSource.find() anywhere in this file, so there is no cancel path whose promise never settles. A find() that never settles would strand loading, identically before and after this change.
  • unmount — a setState after unmount is a no-op on this repo's React; unchanged here.

No path relied on the stale finally doing the clearing: reload increments reloadSeqRef as its first statement, so a newer sequence number always implies a newer run already inside its own try.

Tests

New file packages/plugin-gantt/src/ObjectGantt.staleReloadFinally-7231.test.tsx. A data source hands back deferred find() promises so two reloads can be held in flight and completed in either order; getObjectSchema resolves immediately, which is what issues the second reload while the first is pending.

  1. the defect — stale run finishes first: the placeholder must stay and no chart may render.
  2. control — fresh run finishes first: its rows paint, and the late stale answer neither clobbers the data nor puts the placeholder back. Green on the unmodified tree, so case 1's failure is a measurement rather than a broken harness.
  3. guard shape — a silent toolbar refresh superseded by a filter-change reload must not strand refreshing.

Ablation (run on the committed tree, guard reverted then restored):

  • resolution path: the test reaches the subject through a relative import (import { ObjectGantt } from './ObjectGantt'), so the subject is the source module and no dist/ is in the path — no rebuild leg applies.
  • mutation proven on disk before measuring: anchor if (isCurrent()) { 2 occurrences to 1, injected if (silent) setRefreshing(false); 0 to 1, blob c063fb2 to cb81262.
  • ablated run: Tests 1 failed | 2 passed (3) — exactly case 1 red, both controls green.
  • restore proven: blob back to c063fb2 (byte-identical to the HEAD blob), git diff HEAD empty, anchor counts back to 2 / 0.

Gates

All run on 529d546, the final commit, with the worktree clean:

GateVerdict line
pnpm exec vitest run packages/plugin-gantt/Test Files 57 passed (57) · Tests 451 passed (451)
pnpm --filter @object-ui/plugin-gantt run type-checkexit 0 (tsc --noEmit && tsc -p tsconfig.test.json — the second leg is what type-checks the new test file)
check:control-bytescheck-control-bytes: OK (scanned 5998 tracked text file(s); skipped 85 binary).
check:vi-mock-specifierscheck-vi-mock-specifiers: OK (4128 tracked source file(s), 2398 test-named; 533 carry a mock; 782 relative specifier(s) resolved...)
check:vi-mock-inheritcheck-vi-mock-inherit: OK (... 118 call site(s) on @object-ui/react judged (118 inherit, 0 auto-mocked) ...)
check:self-importNo package names itself inside its own src/.
check:phantom-depsEvery in-scope import is declared by the package that publishes it.
check-changeset-presence.mjs2 source file(s) of 1 released package(s) changed, and this change declares 1 changeset(s): .changeset/7231-gantt-stale-reload-finally.md.
check-changeset-no-major.mjsNo changeset declares a major bump.

Declared narrowing — eslint. The repo-wide pnpm lint (turbo run lint over the 42 packages that define a lint script) is CI's run. Locally eslint ran over the touched package only — eslint . inside packages/plugin-gantt, which is exactly the unit turbo invokes for it. Three readings, so the narrowing is a measurement and not a skip:

  1. population read from eslint's own resolution of eslint.config.js (its own walk and its own ignores), not from a guess about which files count;
  2. count read from --format json: 87 files, 0 errors, 333 warnings (the new test file contributes 10 warnings, in line with its siblings — .github/workflows/lint.yml deliberately sets no --max-warnings, so this gate is about errors);
  3. invariance for untouched files: eslint.config.js declares no parserOptions, no project and no projectService anywhere, so no rule reads type information across files — every verdict is single-file. Every config block matches **/*.{ts,tsx} only, so the added .changeset/*.md is outside the linted set entirely. This diff therefore cannot move the verdict on any file it does not contain.

Scope

Reload guard only. packages/plugin-gantt/src/ObjectGantt.tsx (the finally in the reload() closure), one new test beside it, one changeset. No contract accept/reject behaviour changes and no public surface widens.

Deliberately untouched, each queued or owned elsewhere: the buildExpandFields(objectSchema?.fields) projection site in this same file (that is #7230, which remains open and is queued behind this card); the paging / $top shape of the gantt fetch (#7210 remains open — its half 2 is a maintainer decision); and the schema-gating regime (#7225 and #6482 both remain open). Per the card, this is deliberately not folded into that gating work: a gate would hide the schema-resolution instance and leave the guard broken on the toolbar-refresh and write-readback pairs measured above.

🤖 Generated with Claude Code

https://claude.ai/code/session_01NRRumy89BYdW9ogbcdHTho

Generated by Claude Code


Generated by Claude Code

…annot clear the loading state
`reload()` sequences concurrent runs with `reloadSeqRef` and guards every result
write with `isCurrent()`, but its `finally` carried no guard. A superseded reload
therefore still flipped `loading` / `refreshing` off: the stale run only had to
finish first — the ordinary case whenever a second reload is issued while the
first is still in flight — and the placeholder was released before any rows had
arrived, painting an empty chart until the fresh response landed.
The `finally` now clears the flags only when the run reaching it is still current,
and clears BOTH of them rather than only the one its own `silent` mode set: being
current at that point means nothing is in flight any more, so clearing only its own
mode would strand the other flag whenever the superseded run used the other mode (a
silent toolbar refresh overtaken by a filter-change reload would have left
`refreshing` on for the life of the component).
New test file pins three orderings: the stale run finishing first (the defect —
red on the unguarded tree), the fresh run finishing first (control — green either
way, covering the pre-existing `setData` guard), and a silent run superseded by a
non-silent one (pins the clear-both shape).
Reload-guard only: which queries are issued, how they are projected and how they
page are all untouched.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NRRumy89BYdW9ogbcdHTho
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Eager closure (gzip, 48 chunks)3160.1 KB3191.4 KB
Main entry chunk (gzip)142.6 KB350 KB
Entry fileindex-9TBh-pag.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)15.33KB5.59KB
app-shell (runtime-config.js)20.68KB7.36KB
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)514.13KB117.19KB
core (index.js)5.55KB2.23KB
create-plugin (index.js)10.08KB3.26KB
data-objectstack (index.js)178.20KB49.60KB
fields (index.js)244.25KB61.73KB
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.98KB10.98KB
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)11.71KB4.29KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)6.24KB2.16KB
permissions (discardProofCache.js)1.04KB0.55KB
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)4.83KB2.27KB
plugin-ai (index.js)15.75KB3.80KB
plugin-calendar (index.js)46.92KB12.93KB
plugin-charts (index.js)70.02KB19.44KB
plugin-chatbot (index.js)190.53KB45.18KB
plugin-dashboard (index.js)132.63KB34.56KB
plugin-designer (index.js)212.87KB43.19KB
plugin-detail (index.js)250.65KB63.91KB
plugin-editor (index.js)2.46KB1.10KB
plugin-form (index.js)132.78KB32.58KB
plugin-gantt (index.js)166.77KB40.76KB
plugin-grid (index.js)208.87KB56.58KB
plugin-kanban (index.js)53.21KB14.66KB
plugin-list (index.js)113.55KB27.68KB
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)29.34KB8.47KB
plugin-tree (index.js)8.98KB3.08KB
plugin-view (index.js)85.90KB21.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)81.07KB26.86KB
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-litant
os-litant marked this pull request as ready for review September 2, 2026 01:46
@os-litant
os-litant added this pull request to the merge queueSep 2, 2026
Merged via the queue into main with commit 92c65aaSep 2, 2026
32 checks passed
@os-litant
os-litant deleted the claude/issue-7231-gantt-reload-stale-finally branch September 2, 2026 02:01
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

2 participants

@os-litant@claude