Skip to content

test(app-shell): stub useRecordPresence as the array the hook returns - #8902

Merged
os-zhuang merged 2 commits into
mainfrom
claude/issue-8083-record-presence-stub-shape
Sep 9, 2026
Merged

os-zhuang merged 2 commits into
mainfrom
claude/issue-8083-record-presence-stub-shape

Conversation

@claude

@claude claude Bot commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

Fixes #8083

13 RecordDetailView test files stubbed useRecordPresence as
{ viewers: [], others: [] }. The hook returns PresenceUser[]
(packages/collaboration/src/PresenceProvider.tsx, anchor
export function useRecordPresence) and its only consumer reads
recordPresence.length > 0 (packages/app-shell/src/views/RecordDetailView.tsx,
anchor recordPresence.length). An object has no length, so the presence row
was structurally unrenderable in those files. All 13 now stub [], matching
the 9 files that already did.

Diff: 13 files, one line each, plus one changeset. Nothing else.

Why "all 13 are still green" is not the evidence

Swapping { viewers: [], others: [] } for [] leaves recordPresence.length > 0
false either way, so the row still does not render and the 13 stay green. A
correct fix and a no-op produce byte-identical green.
The reading that
discriminates is can it now go red — feed the stub a non-empty array and the
row must render.

Measured with a mutation probe: the stub is filled with one PresenceUser, and
PresenceAvatars is replaced by a stand-in that throws OS8083_PROBE_ROW_RENDERED
on render. A file goes red exactly when the row reaches the DOM. Every leg
proves its edit landed on disk (injected-marker count, removed-marker count and
git hash-object before/after) before anything is run, and restores by
git checkout HEAD -- path verified with git diff HEAD empty. All runs went
through the shared heavy-verify lock; the verdict quoted is the runner's own
line, never a bare $?.

leg corpus stub fed result
probe validation (positive control) the 9 already-correct files [user] 9/9 files red, 46 cases, all OS8083_PROBE_ROW_RENDERED
before the fix the 13 { viewers: [user], others: [user] } 13/13 green, 99/99 cases, zero probe fires
after the fix the 13 [user] 12/13 files red, 86 cases
the tree as shipped all 22 [] 22 files, 157/157 green

Row 2 is the card's thesis turned into a number: the object stub was fed users
in both of its fields and the row still could not render. Row 3 is the class
judgement — the branch is now pinnable.

The 13th file, RecordDetailView.expandFls-7230.test.tsx, does not fire, and
that is a property of the file, not of the stub.
Its 6 cases resolve as soon as
a findOne is recorded, which happens while RecordDetailView is still in the
isLoading skeleton — an early return that sits above the presence chrome. Not
argued: with the same corrected stub and a one-shot case appended that awaits
the loaded tree, the presence element is found (7/7 green). So the stub is
capable there too; the file simply never observes the loaded tree.

The second half — what broke when the row actually rendered

Nothing. No assertion in any of the 13 was relying on the row being
unrenderable, and no existing assertion was touched.

That negative was made in the strongest available form and then checked for
vacuity. The PresenceAvatars override line was deleted rather than
restubbed, so the real component came through the factory's
...(await importOriginal()) and rendered its actual DOM, with the stub fed a
real PresenceUser. All 22 files: 157/157 green.

A green from a probe that renders nothing would be the very defect this card is
about, so the probe carries its own two-legged control on
RecordDetailView.headerRefresh.test.tsx:

  • with the mutation, an appended case asserting the real component's
    role="group" stack is in the document passes (6/6);
  • without the mutation, that same case fails:
    AssertionError: real PresenceAvatars renders a role=group stack: expected 0 to be greater than 0.

So the element counted is exclusively the real PresenceAvatars, and the 157/157
above is a measurement rather than an absence.

Ablation

Prediction written before the run: from the committed tree, ablate exactly one
file (headerRefresh) back to the object stub, give the other 21 the array
stub, throwing stand-in everywhere; 20 of 22 red, with headerRefresh green
(ablated) and expandFls-7230 green (never reaches the loaded tree), and
nothing else moving.

Observed: Test Files 20 failed | 2 passed (22) / Tests 128 failed | 29 passed (157).
The two green files are exactly headerRefresh and expandFls-7230. Restore
verified both ways: git diff HEAD empty over all 22 and the ablated file's
blob hash back to c44714e63278.

验收备注

1. The two vi.mock gates cannot see this class — measured, not inferred, and
deliberately not extended here.

  • check:vi-mock-specifiers judges whether a relative specifier resolves to a
    file
    . These stubs mock the bare specifier @object-ui/collaboration, which
    the gate's own summary counts as 935 bare (out of scope).
  • check:vi-mock-inherit judges whether a factory obtains the real module.
    All 13 already spread ...(await importOriginal()) and always did — they were
    compliant while carrying the drift. The gate judges the factory's inheritance,
    never an override's value.

Empirically: with all 13 object-shaped stubs put back on disk, both gates print
the same verdict line and the same exit code as on the repaired tree —
✅ check-vi-mock-specifiers: OK / ✅ check-vi-mock-inherit: OK, exit 0 both.
This class has no automated guard today; 13 drifted stubs were found only by a
hand census.
Extending a gate is a separate card and is not attempted here.

2. Position axis, both carriers.

  • (i) prose file:line citations. scripts/cross-file-line-citation-census.mjs
    run three times — at the branch point, on this branch, and on the tree
    produced by a real git merge --no-ff of this branch into origin/main in a
    throwaway detached worktree. All three outputs are 634 lines and byte-identical
    except the header's HEAD sha
    . Zero citations moved.
  • (ii) machine-checked ledger keys that embed a line number, which the census
    cannot see.
    The confirmed carrier UNGATED_EXAMPLES in
    scripts/check-doc-example-types.mjs holds 90 rows; 0 address app-shell or
    any .test.tsx
    . Swept for the class, not just that instance: the only other
    literal path:NUMBER entries in the tree are skills/objectui/guides/*
    fixtures inside scripts/__tests__/, untouched. And there is no line-addressed
    citation into any of the 13 anywhere in the tree.
  • The axis is safe for a structural reason as well: the diff replaces one line
    with one line in each file, and every touched file kept its exact line
    count
    , so nothing downstream of the edit shifted.

3. Clause-②: no — judged from the diff, not from convenience. 13
*.test.tsx lines plus one changeset: no new exported symbol, no new key on a
published payload, no schema key, closed-set member or registry entry. Measured
rather than asserted: every package's files[] ships dist, and no built dist
in the tree contains a single *.test.* artefact (positive control: the
published useRecordPresence symbol is present in packages/collaboration/dist).
Hence the empty-frontmatter changeset.

4. { viewers, others } exists nowhere in this repo as a real shape — a
tree-wide sweep finds it only in the 13 stubs this PR removes, confirming the
card's reading that it was borrowed from a different presence surface.

Verification

Run through os-verify-lock.sh, verdict lines quoted from the runner:

  • the 22 affected files, before and after: Test Files 22 passed (22) / Tests 157 passed (157), VERDICT command-exit 0
  • pnpm --filter @object-ui/app-shell run type-check (tsc --noEmit && tsc -p tsconfig.test.json, so the test files are covered): VERDICT command-exit 0. First attempt returned exit 2 with Cannot find module '@object-ui/fields' — a workspace not yet built, read as NOT MEASURED; re-run after pnpm --filter '@object-ui/app-shell^...' build.
  • pnpm --filter @object-ui/app-shell run lint: ✖ 2943 problems (0 errors, 2943 warnings), exit 0 — all warnings pre-existing, none on the touched lines.
  • pnpm check:vi-mock-specifiers, pnpm check:vi-mock-inherit, pnpm changeset:check, pnpm check:control-bytes: all exit 0, verdict lines green.
  • node scripts/check-governed-queue-guard.mjs --test over all 14 paths: NOT GOVERNED.

Declared narrowing. Vitest's own config collects 669 test files for
packages/app-shell/; this branch ran 22 of them (count from vitest's own
Test Files line) plus the whole package's type-check and lint. The narrowing
excludes nothing that could move: a vi.mock factory is scoped to the file that
declares it, each of the 13 is an import leaf (nothing in the tree imports any of
them), and no touched file changed its line count. A 37-file presence-consumer
radius was queued for the lock twice and returned exit 99 / queue-timeout
both times behind an 18-minute sibling holder — NOT MEASURED, not green and
not red. CI runs the full farm.

🤖 Generated with Claude Code

https://claude.ai/code/session_01611D6ZaRaMmwTNQmSbk8MH


Generated by Claude Code

13 RecordDetailView test files stubbed `useRecordPresence` as
`{ viewers: [], others: [] }`. The hook returns `PresenceUser[]` and its
only consumer reads `recordPresence.length > 0`, so an object stub made
`.length` `undefined` and the presence row structurally unrenderable —
those files exercised the no-presence branch through a shape mismatch
rather than through the empty array the branch is about.

Align all 13 with the 9 that already stub `[]`. Value-identical today
(both render nothing); the change is that the row can now render at all
when a stub is given users, which is what makes the branch pinnable.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01611D6ZaRaMmwTNQmSbk8MH
Empty frontmatter: no published package moves. Measured rather than
asserted — every package's `files[]` ships `dist`, and no built `dist` in
the tree contains a single `*.test.*` artefact (positive control: the
published `useRecordPresence` symbol IS in `packages/collaboration/dist`).

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

github-actions Bot commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 50 chunks) 3487.4 KB 3512.7 KB
Main entry chunk (gzip) 144.1 KB 350 KB
Entry file index-U2QDoaCV.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) 16.69KB 6.21KB
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) 500.23KB 114.67KB
core (index.js) 7.48KB 2.96KB
create-plugin (index.js) 26.68KB 8.94KB
data-objectstack (index.js) 200.01KB 55.77KB
fields (index.js) 246.97KB 62.30KB
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) 14.81KB 3.63KB
plugin-calendar (index.js) 49.03KB 13.93KB
plugin-charts (index.js) 71.39KB 19.92KB
plugin-chatbot (index.js) 194.54KB 46.34KB
plugin-dashboard (index.js) 131.71KB 34.50KB
plugin-designer (index.js) 215.51KB 44.29KB
plugin-detail (index.js) 252.45KB 65.33KB
plugin-editor (index.js) 2.23KB 1.05KB
plugin-form (index.js) 136.26KB 34.13KB
plugin-gantt (index.js) 166.96KB 40.93KB
plugin-grid (index.js) 210.86KB 57.28KB
plugin-kanban (index.js) 57.53KB 16.46KB
plugin-list (index.js) 112.54KB 27.65KB
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.55KB 3.32KB
plugin-view (index.js) 84.42KB 20.80KB
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-zhuang
os-zhuang marked this pull request as ready for review September 9, 2026 22:25
@os-zhuang
os-zhuang added this pull request to the merge queue Sep 9, 2026
Merged via the queue into main with commit 348725a Sep 9, 2026
35 checks passed
@os-zhuang
os-zhuang deleted the claude/issue-8083-record-presence-stub-shape branch September 9, 2026 22:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

2 participants