Skip to content

test(permissions): wait on the array the assertion reads (objectui#8688) - #8689

Merged
os-justin merged 1 commit into
mainfrom
claude/issue-8688-provider-ctx-wait-alignment
Sep 9, 2026
Merged

test(permissions): wait on the array the assertion reads (objectui#8688)#8689
os-justin merged 1 commit into
mainfrom
claude/issue-8688-provider-ctx-wait-alignment

Conversation

@os-justin

Copy link
Copy Markdown
Collaborator

Fixes #8688

providerCtxIdentity.discarded.test.tsx had two waits keyed on the request log followed by a read of ctxSeen — a different recorder. log is pushed when a request is issued; ctxSeen only fills once the response has landed, because MePermissionsProvider renders loadingFallback (not children) while loading && !data. So the wait did not gate the read, and on an unfavourable ordering the read ran against an empty array.

Both sites are repaired by folding the assertion into the wait, so the wait and the read cannot drift apart again. The ! goes with them: it converted "this can be empty" — the fact the test needed to encode — into a compile-time promise that it cannot be, which is why nothing at authoring time could flag the gap.

Not a flake — the defect was forced and observed

The file is green on most runs, so a green run proves nothing. The unfavourable ordering was forced: the fetch double still pushes to log when the request is issued, but its Response is deferred 50ms, past RTL's one-macrotask asyncWrapper drain. (A setTimeout(..., 0) sits inside that drain window and does not reproduce the race — measured on objectui#8664, and the reason its first repro leg landed on disk without reddening.)

Every leg below is classified per test from vitest's JSON reporter (--reporter=json --outputFile), never the text reporter, with the death strings (Element type is invalid, Failed Suites, No test suite found in file, Tests no tests, Transform failed) counted separately. All five legs: 0 death strings — every red below is a failing assertion, not a suite death.

leg test tree production tree result (13 tests in file)
baseline pre-fix unmutated, ordinary ordering 13 passed
1 — old wait, forced ordering pre-fix unmutated 11 passed / 2 FAILED
2 — new wait, forced ordering fixed unmutated 13 passed
3 — new wait, ordinary ordering fixed unmutated 13 passed

Leg 1's two reds, verbatim:

[FAILED] ... > still refetches exactly once when the fetcher itself is swapped
         TypeError: Cannot read properties of undefined (reading 'userId')
         at providerCtxIdentity.discarded.test.tsx:620:41
[FAILED] ... > costs no redundant round trip when a discard rebuilds the driver
         AssertionError: expected [] to have a length of 1 but got +0
         at providerCtxIdentity.discarded.test.tsx:574:24

Line 620 of the mutated file is line 619 of the unmutated one, column 41 — the CI failure on PR #8656's Test (shard 2/4), reproduced character for character.

The second site is the worse one

The sweep found a second instance nobody had observed, in costs no redundant round trip ...: the same log wait, then loaded = ctxSeen[ctxSeen.length - 1]!. Its failure mode is quieter: loaded becomes undefined, and the identity pin below it, expect(ctxSeen[ctxSeen.length - 1]).toBe(loaded), then compares undefined to undefined and passes. Under leg 1 that test failed only on effectRuns, with the identity pin passing vacuously.

Asked of that pin — would an implementation strictly worse than the bug pass this? — the answer was yes, and it is measured rather than argued (ablation control, below).

Ablations — read sites only, never the pin

Each mutates production code (MePermissionsProvider.tsx) from a committed tree, under a trap ... EXIT INT TERM with absolute paths, proving the mutation on disk in both directions (anchor counts and git hash-object against the HEAD blob) plus a line-total gate, and restoring by state (git checkout HEAD -- ABSOLUTE_PATH, then git diff HEAD proven empty).

ablation read site mutated repaired pins
ABL-1 fetcher dropped from the fetch effect's dependency list REDstill refetches exactly once when the fetcher itself is swapped: expected 'A' to be 'B'
ABL-2 userId: data?.userId ?? null frozen to a constant — the provider never publishes the fetched id RED — both new waits: expected 'ablated-8688' to be 'A'
ABL-2 control, pre-fix pin same mutation, old test file restored from HEAD~1 costs no redundant round trip ... PASSED

The control is the point: under a provider that never publishes the fetched payload, the old pin at the second site went green and the new one goes red. The repair there is a strengthening, not a relocation. And with ?. in place, the failure is a clean assertion diff instead of a TypeError that reads like a broken component.

The sweep

Population: all 9 test files under packages/permissions/src/__tests__/ (the card's file plus every sibling in the package), 22 await waitFor sites across the three files that have any.

node sweep-wait-read-drift.mjs packages/permissions/src/__tests__/*.tsx packages/permissions/src/__tests__/*.ts

The detector discovers recorders mechanically per file (every X.push( target), reads the identifiers named inside each await waitFor(...), then scans forward to the next await and flags any recorder read that the wait did not name.

Lit control: run against the pre-fix tree it flags 2 sites — line 619 (the one CI observed) and line 546 (the one nobody had) — while leaving the other 8 waitFor sites in that file unflagged, including the two that legitimately wait on ctxSeen and read ctxSeen. So the sweep discriminates, and it did find a second instance rather than merely confirming the reported one. Against the fixed tree: 0 flags.

Empirically lit as well: the leg-1 forced ordering reddened both flagged sites and none of the other 11 tests.

Out of the detector's reach, audited by hand instead: MePermissionsProvider.test.tsx (5 waits) and MePermissionsProvider.retry.test.tsx (7 waits) have no push-style recorders at all — they gate on a DOM node (loaded / err test ids) and then read other test ids from the same render commit, plus mock call counts that are causally upstream of that commit. The family cannot occur in that shape. usePermissions.discardedIdentity.test.tsx has recorders but no waitFor (it is entirely synchronous).

Scope

  • MePermissionsProvider itself is unchanged. The sweep found the test at fault, not the component; the provider was mutated only inside the ablation legs, and restored by state each time.
  • objectui#8645's subject — the superseded /me/permissions request being setState-suppressed rather than aborted — is untouched. Nothing in this diff reaches the fetch or its cancellation token.
  • Index form (ctxSeen[ctxSeen.length - 1]?.userId) rather than the card's suggested ctxSeen.at(-1)?.userId: this package's tests inherit the root lib: ["ES2020"], under which .at is TS2550. The suggested shape runs green under vitest and fails tsc -p tsconfig.test.json, which is exactly the vitest/tsc divergence class. (packages/app-shell/tsconfig.test.json sets lib: ["ES2022", ...], which is why .at(-1) is fine in 75 other test files and not here.)

Verification

  • pnpm exec vitest run packages/permissions/9 files, 123 tests, 123 passed, 0 death strings.
  • pnpm exec tsc --noEmit and pnpm exec tsc -p tsconfig.test.json in packages/permissions — both exit 0, run after pnpm --filter '@object-ui/permissions^...' build (on an unbuilt tree these report TS2307 for every workspace import, which is a precondition failure and not a measurement).
  • pnpm exec eslint . in packages/permissions — 0 errors (27 pre-existing no-explicit-any warnings, none introduced here).
  • node scripts/check-changeset-presence.mjs — red before the changeset, green after; node scripts/check-changeset-no-major.mjs green. The changeset has empty frontmatter: test-only, releases nothing. (skip-changeset is a phantom label in this repo and was not applied.)
  • node scripts/check-governed-queue-guard.mjs --test ...NOT GOVERNED; both paths checked against all 5 governed surfaces, none matched.
  • Control-character scan of both changed files: no hits.

🤖 Generated with Claude Code

https://claude.ai/code/session_01YBWFb5YgMU5dw8p2VKj16S


Generated by Claude Code

`providerCtxIdentity.discarded.test.tsx` had two waits keyed on the request
`log` followed by a read of `ctxSeen`, a different recorder. `log` is pushed
when a request is ISSUED; `ctxSeen` only fills once the response has landed,
because `MePermissionsProvider` renders `loadingFallback` — not `children` —
while `loading && !data`. So the wait did not gate the read, and on an
unfavourable ordering the read ran against an empty array.

Both sites are repaired by folding the assertion into the wait, so the two
cannot drift apart again. The `!` is gone with them: it converted "this can be
empty" into a compile-time promise that it cannot be, which is why nothing at
authoring time could flag the gap (objectui#8688).

Measured under a forced unfavourable ordering (the fetch double's Response
deferred 50ms past RTL's one-macrotask asyncWrapper drain):

  old waits: 2 failed / 11 passed / 0 suite deaths
             - `still refetches exactly once when the fetcher itself is
               swapped`: TypeError: Cannot read properties of undefined
               (reading 'userId') — the CI failure, reproduced verbatim
             - `costs no redundant round trip …`: expected [] to have a
               length of 1 — and its identity pin passed VACUOUSLY,
               comparing undefined to undefined
  new waits: 13 passed / 0 failed / 0 suite deaths, same ordering
             13 passed under the ordinary ordering

Index form rather than `.at(-1)`: this package's tests inherit the root
`lib: ["ES2020"]`, under which `.at` is TS2550.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YBWFb5YgMU5dw8p2VKj16S
@github-actions

github-actions Bot commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 50 chunks) 3477.6 KB 3512.7 KB
Main entry chunk (gzip) 143.9 KB 350 KB
Entry file index-BkOatu4S.js
Status PASS

The eager closure is every chunk the entry reaches through static imports — what the browser fetches and parses before the app renders. The entry chunk on its own is a small fraction of it.


📦 Bundle Size Report

Package Size Gzipped
app-shell (consoleActionDispatch.js) 0.20KB 0.19KB
app-shell (index.js) 15.67KB 5.75KB
app-shell (runtime-config.js) 20.68KB 7.36KB
app-shell (types.js) 0.01KB 0.04KB
app-shell (urlParams.js) 10.06KB 3.86KB
auth (ActiveOrganizationStorage.js) 25.05KB 9.16KB
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 2.07KB 1.00KB
auth (AuthProvider.js) 40.18KB 10.59KB
auth (AuthShell.js) 3.49KB 1.40KB
auth (ForgotPasswordForm.js) 12.21KB 3.45KB
auth (LoginForm.js) 18.15KB 5.39KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.65KB 2.22KB
auth (SocialSignInButtons.js) 9.61KB 3.89KB
auth (UserMenu.js) 3.41KB 1.23KB
auth (auth-gate-events.js) 1.29KB 0.66KB
auth (authStyles.js) 5.04KB 1.72KB
auth (createAuthClient.js) 40.21KB 10.80KB
auth (createAuthenticatedFetch.js) 8.46KB 3.43KB
auth (index.js) 3.19KB 1.44KB
auth (invitation-status.js) 1.22KB 0.70KB
auth (org-roles.js) 6.66KB 2.78KB
auth (phone-identifier.js) 1.11KB 0.66KB
auth (types.js) 0.59KB 0.35KB
auth (useAuth.js) 5.30KB 1.02KB
auth (useWorkspaceAdminStatus.js) 11.08KB 4.58KB
collaboration (CommentThread.js) 26.08KB 7.56KB
collaboration (LiveCursors.js) 3.17KB 1.27KB
collaboration (PresenceAvatars.js) 6.49KB 2.64KB
collaboration (PresenceProvider.js) 2.79KB 1.13KB
collaboration (index.js) 1.68KB 0.73KB
collaboration (useCollaborationTranslation.js) 6.05KB 2.52KB
collaboration (useCommentSearch.js) 1.98KB 0.88KB
collaboration (useConflictResolution.js) 7.75KB 1.86KB
collaboration (useMentionNotifications.js) 1.81KB 0.68KB
collaboration (usePresence.js) 6.33KB 1.84KB
collaboration (useRealtimeSubscription.js) 7.91KB 2.01KB
components (index.js) 499.42KB 114.32KB
core (index.js) 7.48KB 2.96KB
create-plugin (index.js) 10.12KB 3.28KB
data-objectstack (index.js) 198.39KB 55.29KB
fields (index.js) 244.36KB 61.61KB
i18n (LocalizationContext.js) 1.76KB 0.96KB
i18n (builtinAggregateLabels.js) 0.86KB 0.49KB
i18n (currency.js) 1.22KB 0.64KB
i18n (fallbackInterpolation.js) 6.25KB 2.77KB
i18n (i18n.js) 6.57KB 2.76KB
i18n (index.js) 3.65KB 1.47KB
i18n (pickLocalized.js) 7.62KB 3.26KB
i18n (provider.js) 26.89KB 9.04KB
i18n (useDisplayLocale.js) 2.85KB 1.45KB
i18n (useObjectLabel.js) 34.34KB 9.17KB
i18n (useSafeTranslation.js) 5.60KB 2.33KB
layout (index.js) 38.84KB 10.94KB
mobile (MobileProvider.js) 0.92KB 0.49KB
mobile (ResponsiveContainer.js) 0.94KB 0.38KB
mobile (breakpoints.js) 1.51KB 0.70KB
mobile (createOfflineDataSource.js) 5.61KB 1.75KB
mobile (index.js) 1.99KB 0.87KB
mobile (offlineQueue.js) 3.91KB 1.35KB
mobile (pwa.js) 0.97KB 0.49KB
mobile (serviceWorker.js) 1.48KB 0.62KB
mobile (serviceWorkerSource.js) 3.41KB 1.48KB
mobile (useBreakpoint.js) 1.54KB 0.65KB
mobile (useGesture.js) 6.96KB 1.98KB
mobile (useOfflineSync.js) 1.99KB 0.72KB
mobile (usePullToRefresh.js) 2.53KB 0.85KB
mobile (useResponsive.js) 0.72KB 0.42KB
mobile (useSpecGesture.js) 4.39KB 1.66KB
mobile (useTouchTarget.js) 1.01KB 0.54KB
permissions (MePermissionsProvider.js) 13.52KB 4.88KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 6.24KB 2.16KB
permissions (discardProofCache.js) 1.04KB 0.55KB
permissions (evaluator.js) 8.39KB 3.10KB
permissions (index.js) 0.93KB 0.41KB
permissions (store.js) 0.91KB 0.42KB
permissions (useFieldPermissions.js) 1.28KB 0.53KB
permissions (usePermissions.js) 4.83KB 2.27KB
plugin-ai (index.js) 15.16KB 3.68KB
plugin-calendar (index.js) 49.00KB 13.91KB
plugin-charts (index.js) 71.39KB 19.92KB
plugin-chatbot (index.js) 194.53KB 46.34KB
plugin-dashboard (index.js) 131.43KB 34.44KB
plugin-designer (index.js) 215.51KB 44.29KB
plugin-detail (index.js) 251.25KB 65.00KB
plugin-editor (index.js) 2.23KB 1.05KB
plugin-form (index.js) 131.01KB 32.32KB
plugin-gantt (index.js) 167.16KB 40.99KB
plugin-grid (index.js) 208.18KB 56.62KB
plugin-kanban (index.js) 55.44KB 15.73KB
plugin-list (index.js) 112.73KB 27.69KB
plugin-map (index.js) 20.49KB 6.83KB
plugin-markdown (index.js) 13.88KB 4.80KB
plugin-report (index.js) 43.42KB 11.92KB
plugin-timeline (index.js) 30.10KB 8.74KB
plugin-tree (index.js) 9.33KB 3.25KB
plugin-view (index.js) 84.54KB 20.84KB
providers (DataSourceProvider.js) 0.75KB 0.39KB
providers (MetadataProvider.js) 1.37KB 0.59KB
providers (ThemeProvider.js) 1.90KB 0.85KB
providers (UploadProvider.js) 11.66KB 3.50KB
providers (index.js) 0.45KB 0.23KB
providers (types.js) 0.01KB 0.04KB
react-runtime (index.js) 5.62KB 2.34KB
react (LazyPluginLoader.js) 4.47KB 1.63KB
react (SchemaRenderer.js) 81.07KB 26.86KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 4.63KB 2.18KB
react (schema-input.js) 2.32KB 1.24KB
react (spec-input.js) 0.20KB 0.18KB
sdui-parser (codegen.js) 6.58KB 2.74KB
sdui-parser (dashboard-widget-options.js) 3.08KB 1.30KB
sdui-parser (index.js) 5.55KB 2.45KB
sdui-parser (input-type.js) 2.84KB 1.40KB
sdui-parser (parse.js) 20.57KB 5.88KB
sdui-parser (provenance.js) 3.66KB 1.82KB
sdui-parser (types.js) 0.28KB 0.23KB
sdui-parser (validate.js) 13.64KB 4.59KB
types (ai.js) 0.20KB 0.17KB
types (api-types.js) 0.20KB 0.18KB
types (app.js) 2.87KB 1.00KB
types (base.js) 0.20KB 0.18KB
types (blocks.js) 0.20KB 0.18KB
types (complex.js) 2.93KB 1.49KB
types (crud.js) 0.20KB 0.18KB
types (dashboard-filter-alias.js) 6.23KB 2.74KB
types (data-display.js) 3.75KB 1.85KB
types (data-protocol.js) 0.20KB 0.19KB
types (data.js) 0.20KB 0.18KB
types (designer.js) 1.85KB 0.85KB
types (disclosure.js) 0.20KB 0.18KB
types (error-code.js) 1.54KB 0.88KB
types (expression.js) 0.20KB 0.18KB
types (feedback.js) 0.20KB 0.18KB
types (field-types.js) 0.20KB 0.18KB
types (form.js) 0.20KB 0.18KB
types (http-inflight.js) 8.87KB 3.73KB
types (http-retry.js) 4.32KB 2.02KB
types (icon-key-migration.js) 4.26KB 1.63KB
types (index.js) 4.74KB 2.25KB
types (layout.js) 0.20KB 0.18KB
types (managed-by.js) 0.19KB 0.18KB
types (mobile.js) 4.73KB 2.28KB
types (navigation.js) 0.20KB 0.18KB
types (objectql.js) 0.20KB 0.18KB
types (overlay.js) 0.20KB 0.18KB
types (permissions.js) 0.20KB 0.18KB
types (plugin-scope.js) 0.20KB 0.18KB
types (record-components.js) 0.20KB 0.19KB
types (record-semantics.js) 1.28KB 0.67KB
types (registry.js) 0.20KB 0.18KB
types (reports.js) 0.20KB 0.18KB
types (select-option.js) 0.20KB 0.19KB
types (spec-report.js) 5.05KB 1.93KB
types (spec-ui-namespace.js) 0.20KB 0.19KB
types (strict-authoring-face.js) 14.27KB 5.47KB
types (system-fields.js) 3.33KB 1.54KB
types (theme.js) 6.28KB 2.87KB
types (ui-action.js) 8.11KB 3.32KB
types (views.js) 0.20KB 0.18KB
types (widget.js) 0.20KB 0.18KB

Size Limits

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

@os-justin
os-justin marked this pull request as ready for review September 8, 2026 22:50
@os-justin
os-justin enabled auto-merge September 8, 2026 22:50
@os-justin
os-justin added this pull request to the merge queue Sep 8, 2026
@claude

claude Bot commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

⚠️ This fix is deadlocked behind the flake it fixes — reading from the domain:devx seat, 2026-09-09T00:38Z

Posting as an accelerator only; the record is objectui#8715, filed against the queue itself. No action requested of this PR's diff — it is correct and it is the thing everyone is waiting for.

this PR is at queue position 6, behind the very entries its fix would turn green. It was added at 23:01Z and has not reached the head. Control: of all 14 enqueued PRs, this is the only one whose diff touches packages/permissions/ at all — so no other entry can be asked to carry the fix inside its own scope.

⛔ Not a request to re-run anything: objectui#8688's own diagnosis is that the ordering is wrong every time, so a re-run buys one coin flip and ~50 minutes of shared queue time. The unblocking moves (land this ahead of the blockage, dequeue the three flaking entries, or revisit ALLGREEN) are each above an execution seat's authority; they are laid out as A/B/C on objectui#8715 for whoever holds it.


Generated by Claude Code

Merged via the queue into main with commit 3fed306 Sep 9, 2026
35 checks passed
@os-justin
os-justin deleted the claude/issue-8688-provider-ctx-wait-alignment branch September 9, 2026 00:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

2 participants