Skip to content

Fix React hydration mismatches and add Playwright safeguards#1131

Merged
cursor[bot] merged 42 commits into
mainfrom
codex/hydration-fixes
Jul 24, 2026
Merged

Fix React hydration mismatches and add Playwright safeguards#1131
cursor[bot] merged 42 commits into
mainfrom
codex/hydration-fixes

Conversation

@BigSimmo

@BigSimmo BigSimmo commented Jul 24, 2026

Copy link
Copy Markdown
Owner

Summary

  • Fix cross-mode search performance findings: prescribing catalogue debounce/abort/fields=index, differentials abort/debounce, universal documents typeahead soft-timeout (750ms), shared (search-app) shell to avoid composer remount, and Answer rate-limit in-memory fallback outside production.
  • Fix Bugbot regressions: shared-shell pathname navigation (/services/dsm) syncs searchMode during render (no stale-mode paint) even when the query string is unchanged; extracted ClinicalDashboard lazy imports to stay under the maintainability budget.

RAG impact: no retrieval behaviour change — typeahead documents domain timeout and shell URL sync only; ranking formulas and full /api/search retrieval path unchanged.

Verification

  • npm run verify:pr-local — focused Vitest on touched sources (362) plus api-rate-limit / search-shell / universal / route / site-map suites green; docs:check-index OK
  • UI verification not run: full verify:ui not required for this pass; mode-home smoke via npm run ensure returned HTTP 200 for /, /services, /dsm, /documents/search, /therapy-compass, /?mode=prescribing, and /api/answer/stream returned 200 after the rate-limit fallback fix
  • Verification not run: eval:retrieval:latency / soak / live OpenAI canary — approval-gated provider work; not needed for timeout-only typeahead change

Risk and rollout

  • Risk: medium — shared layout remount change and rate-limit fallback behaviour in non-production; production Answer/upload still fail closed when the durable limiter is unavailable
  • Rollback: revert this PR; mode routes return to per-segment GlobalSearchShell layouts and prior timeout/fallback behaviour
  • Provider or production effects: None

Clinical Governance Preflight

  • Source-backed claims still require linked source verification before clinical use
  • No patient-identifiable document workflow was introduced or expanded without explicit governance approval
  • Supabase target remains [REDACTED] ([REDACTED])
  • Service-role keys and private document access remain server-only
  • Demo/synthetic content remains clearly separated from real clinical sources
  • Source metadata, review status, and outdated/unknown-source behavior remain conservative
  • Deployment classification/TGA SaMD impact was checked when clinical decision-support behavior changed

Notes

  • Prescribing list rows keep the full catalogue payload so Safety/Monitoring filters and patient alerts still see section-derived signals; keystroke storms are controlled by debounce + abort. fields=index remains for identity-only consumers (cross-mode links).
  • Live hybrid RPC cold tails remain a separate approval-gated follow-up.

@coderabbitai

coderabbitai Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

@cursor[bot], you've reached your PR review limit, so we couldn't start this review.

Next review available in: 19 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 2c81c594-3a36-4ddd-988a-5132d19d6ccb

📥 Commits

Reviewing files that changed from the base of the PR and between 979a91b and 66289fd.

📒 Files selected for processing (8)
  • docs/branch-review-ledger.md
  • src/app/layout.tsx
  • src/components/DocumentViewer.tsx
  • src/components/clinical-dashboard/answer-status.tsx
  • src/components/clinical-dashboard/use-theme.ts
  • src/lib/theme.ts
  • tests/theme.test.ts
  • tests/ui-hydration.spec.ts
📝 Walkthrough

Walkthrough

Adds hydration-safety linting and Playwright coverage, introduces browser-store and client-time utilities, migrates several external stores, and updates theming, loading states, PDF initialization, and answer progress timing.

Changes

Hydration safety

Layer / File(s) Summary
Browser-safe state primitives
src/lib/client-store-factory.ts, src/lib/use-client-time.ts
Adds SSR-compatible browser-store creation and hydration-safe client time updates.
External-store migrations
src/components/clinical-dashboard/use-hide-on-scroll.ts, src/components/clinical-dashboard/use-sidebar-collapsed.ts, src/components/differentials/diagnosis-map-panel.tsx, src/components/pwa-lifecycle.tsx
Replaces direct useSyncExternalStore usage with browser-store hooks for media, storage, and connectivity state.
Hydration-sensitive UI initialization
src/app/layout.tsx, src/components/ClinicalDashboard.tsx, src/components/DocumentViewer.tsx, src/components/clinical-dashboard/answer-status.tsx
Adds cookie-driven theme classes, explicit dynamic loading panels, deferred PDF viewer initialization, and shared client-time updates.
Hydration lint and browser validation
eslint-rules/restrict-suppress-hydration-warning.mjs, eslint.config.mjs, playwright.config.ts, tests/ui-hydration.spec.ts
Restricts suppressHydrationWarning to allowed elements and adds Playwright detection for hydration warnings and errors.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Sequence Diagram(s)

sequenceDiagram
  participant Server
  participant Browser
  participant React
  participant Playwright
  Server->>Browser: Render HTML with server snapshots and theme class
  Browser->>React: Hydrate page
  React->>Browser: Read browser stores and client time
  Browser->>React: Update subscriptions and deferred state
  Playwright->>Browser: Navigate to root and wait for network idle
  Browser-->>Playwright: Console and page errors
Loading

Possibly related PRs

Suggested labels: codex

Suggested reviewers: claude

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 31.25% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Title check ✅ Passed The title is concise and accurately reflects the main change: fixing hydration mismatches with Playwright safeguards.
Description check ✅ Passed The description matches the template with Summary, Verification, Risk and rollout, Clinical Governance Preflight, and Notes sections filled in.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/hydration-fixes

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@supabase

supabase Bot commented Jul 24, 2026

Copy link
Copy Markdown

This pull request has been ignored for the connected project sjrfecxgysukkwxsowpy because there are no changes detected in supabase directory. You can change this behaviour in Project Integrations Settings ↗︎.


Preview Branches by Supabase.
Learn more about Supabase Branching ↗︎.

@BigSimmo
BigSimmo enabled auto-merge July 24, 2026 04:37
@github-actions

github-actions Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

CI triage

CI failed on this PR. Automated classification of the 2 failed job(s):

  • Static PR checksneeds investigation: inspect the failing step and uploaded diagnostics; rerun only after classifying the cause.
  • PR requiredneeds investigation: inspect the failing step and uploaded diagnostics; rerun only after classifying the cause.

Compared with main CI run #4960 (success).

Classification is evidence routing, not permission to ignore a failure. Exact quarantined Playwright identities remain governed by the flake ledger.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d1043f067e

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread src/components/clinical-dashboard/answer-status.tsx
Comment thread tests/ui-hydration.spec.ts Outdated
@BigSimmo

Copy link
Copy Markdown
Owner Author

@codex resolve actionable Codex review findings for this pull request and current head using the repository instructions. This is the pull request's single automatic repair pass: do not perform a fresh review, create new standalone findings, or request another review. Work only the existing unresolved Codex threads on the current head. Always fix P0 and P1 findings. For P2 and lower findings, fix only clear, scoped, low-risk issues; otherwise disposition them with a concise reason. After fixing or dispositioning a thread, reply in that thread with as the first line, followed by a concise summary; that marker authorizes the workflow to close that exact thread. If human input or new authorization is required, do not use the marker and leave the thread open with the blocker. Finish only after every actionable thread is fixed or dispositioned and closed, or explicitly left open for a human decision. Do not update the branch from main, address unrelated reviews, broaden scope, or create more than one scoped fix commit. Do not use external APIs, paid services, credentials, dependency changes, or broad refactors unless explicitly authorized. Add targeted tests where behavior changes and run the narrowest relevant validation.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a1437b8522

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread src/components/clinical-dashboard/answer-status.tsx
Comment thread tests/ui-hydration.spec.ts Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d52eb2d022

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread tests/ui-hydration.spec.ts Outdated
BigSimmo and others added 6 commits July 24, 2026 13:00
Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
@BigSimmo
BigSimmo disabled auto-merge July 24, 2026 06:50

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 979a91b6cd

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread tests/ui-hydration.spec.ts Outdated

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🧹 Nitpick comments (1)
tests/ui-hydration.spec.ts (1)

29-30: 🩺 Stability & Availability | 🔵 Trivial | ⚡ Quick win

Avoid networkidle as the test readiness gate.

Playwright explicitly discourages networkidle for tests; persistent analytics, SSE, or WebSocket traffic can make this safeguard time out. Use a stable dashboard-ready locator or hydration marker instead. (playwright.dev)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@tests/ui-hydration.spec.ts` around lines 29 - 30, Replace the networkidle
readiness gate in the hydration test with a stable dashboard-ready locator or
explicit hydration marker, and wait for that condition before continuing.
Preserve the test’s requirement that both hydration and initial dashboard
loading have completed.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@tests/ui-hydration.spec.ts`:
- Around line 26-27: Update the navigation setup around page.goto("/") to
capture its returned response and assert that it is successful before continuing
with hydration assertions. Preserve the existing server-loaded dashboard
navigation while ensuring HTTP 4xx/5xx responses fail the test.
- Around line 7-13: Update the isHydrationError matcher in
tests/ui-hydration.spec.ts to recognize React 19’s attribute-only hydration
warning, including the “A tree hydrated but some attributes of the server
rendered HTML didn't match the client properties” message, while preserving all
existing mismatch patterns.

---

Nitpick comments:
In `@tests/ui-hydration.spec.ts`:
- Around line 29-30: Replace the networkidle readiness gate in the hydration
test with a stable dashboard-ready locator or explicit hydration marker, and
wait for that condition before continuing. Preserve the test’s requirement that
both hydration and initial dashboard loading have completed.
🪄 Autofix (Beta)

❌ Autofix failed (check again to retry)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 104f6f9d-56b5-449c-9963-2dfed1d61914

📥 Commits

Reviewing files that changed from the base of the PR and between e1fcd4c and 979a91b.

📒 Files selected for processing (14)
  • eslint-rules/restrict-suppress-hydration-warning.mjs
  • eslint.config.mjs
  • playwright.config.ts
  • src/app/layout.tsx
  • src/components/ClinicalDashboard.tsx
  • src/components/DocumentViewer.tsx
  • src/components/clinical-dashboard/answer-status.tsx
  • src/components/clinical-dashboard/use-hide-on-scroll.ts
  • src/components/clinical-dashboard/use-sidebar-collapsed.ts
  • src/components/differentials/diagnosis-map-panel.tsx
  • src/components/pwa-lifecycle.tsx
  • src/lib/client-store-factory.ts
  • src/lib/use-client-time.ts
  • tests/ui-hydration.spec.ts

Comment thread tests/ui-hydration.spec.ts Outdated
Comment thread tests/ui-hydration.spec.ts Outdated
cursoragent and others added 5 commits July 24, 2026 07:04
Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
@BigSimmo
BigSimmo enabled auto-merge July 24, 2026 11:06
@coderabbitai

coderabbitai Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Note

Autofix is a beta feature. Expect some limitations and changes as we gather feedback and continue to improve it.

Autofix skipped. No unresolved CodeRabbit review comments with fix instructions found.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e9d7093251

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread src/app/layout.tsx Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: b4b5f21b9f

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread eslint.config.mjs
BigSimmo added 3 commits July 24, 2026 19:51
The lint rule only allows suppressHydrationWarning on html/body/script.
Remove it from the skip-to-content anchor so Static PR checks pass.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 5fbda07e34

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/branch-review-ledger.md Outdated
cursoragent and others added 2 commits July 24, 2026 17:02
Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 9fef7aa0e5

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread tests/ui-hydration.spec.ts Outdated
cursoragent and others added 12 commits July 24, 2026 17:15
Resolve ClinicalDashboard lazy-import conflict by keeping main's
clinical-dashboard-lazy extraction (same ssr:false dynamics).

Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
cursor Bot pushed a commit that referenced this pull request Jul 24, 2026
* docs(ledger): record babysit sweep for PRs #1124 #1131 #1146 #1157 #1162 #1167 #1169 #1170

Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>

* docs(ledger): record open-PR conflict-resolution sweep and #1162 Bugbot

Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>

* docs(ledger): record #1162 conflict resolution and Bugbot outcome

Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>

* docs(ledger): record open-PR conflict sync (all mergeable)

Merged origin/main into remaining behind/dirty PR heads so every open PR is MERGEABLE with behind=0.

Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>

* docs(ledger): drop exact duplicate #1170 review row

Remove the second identical PR #1170 ledger record so check:branch-review-ledger passes.

Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>

* docs(ledger): record open-PR conflict sync for 22 PRs

Merged origin/main into every open PR head so all are current with main.

Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>

* docs(ledger): drop exact duplicate review rows

Remove duplicate ledger records so check:branch-review-ledger passes after the conflict sync.

Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>

* fix: auto-sync open PR branches and clear postcss audit

Add a main-push workflow and local helper that update behind PR heads so
GitHub stops falsely marking the queue CONFLICTING/DIRTY after each land.
Bump postcss to a non-vulnerable release so Safety npm audit stays green.

---------

Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
@cursor
cursor Bot disabled auto-merge July 24, 2026 19:51
@cursor
cursor Bot enabled auto-merge (squash) July 24, 2026 19:51
@cursor
cursor Bot merged commit 5eab279 into main Jul 24, 2026
18 checks passed
@cursor
cursor Bot deleted the codex/hydration-fixes branch July 24, 2026 19:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants