Skip to content

feat(ui): publish document navigation mockups and review packets - #1278

Merged
BigSimmo merged 6 commits into
mainfrom
codex/publish-document-nav-20260727
Jul 27, 2026
Merged

feat(ui): publish document navigation mockups and review packets#1278
BigSimmo merged 6 commits into
mainfrom
codex/publish-document-nav-20260727

Conversation

@BigSimmo

@BigSimmoBigSimmo commented Jul 27, 2026

Copy link
Copy Markdown
Owner

Summary

  • publish six reusable, provider-safe ultra review prompt packets with tracked artifact directories
  • add three responsive document top-navigation mockup concepts and focused Playwright coverage
  • preserve the audited branch/worktree cleanup records

Verification

  • npm run workflow:flightplan -- --write-evidence — PASS
  • Prettier on all changed files — PASS
  • npm run check:branch-review-ledger — PASS
  • npm run sitemap:check — PASS
  • npm run docs:check-index — PASS
  • npm run docs:check-scripts — PASS
  • npm run docs:check-links — PASS after adding the six tracked packet directories
  • git diff --check — PASS
  • npm run verify:cheap, npm run ensure, focused mockup Playwright, npm run verify:ui, and npm run verify:pr-local — pending the repository's legitimate shared heavy-test owner

Risk and rollback

Risk is limited to design-scratch mockups and documentation. Mockups remain production-excluded by the existing mockup route contract. Roll back by reverting the three commits.

No live OpenAI, Supabase, Railway, ingestion, answer-generation, or clinical provider workflow was run.

RAG impact: no retrieval behaviour change — documentation and design-scratch mockups only.

Summary by CodeRabbit

  • New Features

    • Added a document top-navigation design showcase with three responsive concepts for desktop, tablet, and mobile.
    • Added interactive section navigation, document actions, and accessible navigation states.
    • Added a dedicated route for viewing the navigation mockups.
  • Documentation

    • Added review guidance and artifact locations for architecture, data safety, ownership, correctness, performance, and quality gates.
    • Documented branch cleanup activities and updated the site map.
  • Tests

    • Added responsive UI coverage for navigation behavior, active sections, accessibility states, and horizontal overflow.

@supabase

supabaseBot commented Jul 27, 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 ↗︎.

@coderabbitai

coderabbitaiBot commented Jul 27, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

@BigSimmo, you've reached your PR review limit, so we couldn't start this review.

Next review available in:27 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: c8802074-3bf7-4655-bb56-1f48921c137f

📥 Commits

Reviewing files that changed from the base of the PR and between 543e4bb and 36402e2.

📒 Files selected for processing (7)
  • docs/branch-review-ledger.md
  • docs/prompts/codex-architecture-maintainability-ultra-review.md
  • docs/prompts/codex-data-database-safety-ultra-review.md
  • docs/prompts/codex-documentation-ownership-ultra-review.md
  • playwright.config.ts
  • src/components/document-top-navigation-mockups.tsx
  • tests/ui-document-top-navigation-mockup.spec.ts
📝 Walkthrough

Walkthrough

The change adds six Codex review orchestrator prompts, durable-artifact documentation locations, and branch-cleanup ledger records. It also adds a responsive document navigation mockup route with three concepts, route-aware layout behavior, sitemap registration, and Playwright coverage.

Changes

Review documentation

Layer / File(s)Summary
Ledger and artifact locations
docs/branch-review-ledger.md, docs/codex/*/README.md
Branch-cleanup outcomes and durable review-packet storage locations are documented.
Prompt orchestration and safety workflow
docs/prompts/codex-*-ultra-review.md
Six prompts define evidence-first specialist agents, read-only boundaries, phased review workflows, local proof strategies, and optional durable artifacts.
Verification and reporting controls
docs/prompts/codex-*-ultra-review.md
The prompts specify independent verification waves, PASS classifications, final report structures, stopping rules, and narrow-scope inputs.

Document navigation mockup

Layer / File(s)Summary
Responsive navigation concepts
src/components/document-top-navigation-mockups.tsx
Three navigation concepts render across desktop, tablet, and phone previews with section selection, document actions, and accessibility attributes.
Mockup route integration
src/app/mockups/document-top-navigation/page.tsx, src/app/mockups/mockups-layout-client.tsx, docs/site-map.md
The new route renders the mockup, selects document mode, hides the search composer, and is added to the sitemap.
Responsive UI validation
tests/ui-document-top-navigation-mockup.spec.ts
Playwright tests cover preview counts, navigation state changes, action controls, and horizontal overflow across viewports.

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

Sequence Diagram(s)

sequenceDiagram
participant Browser
participant MockupsLayoutClient
participant DocumentTopNavigationMockupPage
participant DocumentTopNavigationMockups
Browser->>MockupsLayoutClient: Open /mockups/document-top-navigation
MockupsLayoutClient->>DocumentTopNavigationMockupPage: Select documents mode and hide composer
DocumentTopNavigationMockupPage->>DocumentTopNavigationMockups: Render navigation study
Browser->>DocumentTopNavigationMockups: Select Evidence section
DocumentTopNavigationMockups-->>Browser: Update active state and section content
Loading

Possibly related PRs

Suggested labels:codex

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% 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 nameStatusExplanation
Title check✅ PassedThe title matches the main changes: document top-navigation mockups and review packet docs.
Description check✅ PassedThe description covers Summary, Verification, and Risk/Rollback well, with only minor template omissions like Notes.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/publish-document-nav-20260727

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.

@chatgpt-codex-connectorchatgpt-codex-connectorBot 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:543e4bbbae

ℹ️ 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 threadtests/ui-document-top-navigation-mockup.spec.ts
@BigSimmo

Copy link
Copy Markdown
OwnerAuthor

@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

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. 🚀

Reviewed commit:543e4bbbae

ℹ️ 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".

@coderabbitaicoderabbitaiBot 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: 1

🤖 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 `@docs/prompts/codex-architecture-maintainability-ultra-review.md`:
- Around line 498-500: Update the second-agent verification waves in
docs/prompts/codex-architecture-maintainability-ultra-review.md:498-500,
docs/prompts/codex-data-database-safety-ultra-review.md:484-486, and
docs/prompts/codex-documentation-ownership-ultra-review.md:474-476 to provide
equivalent sequential fallback guidance when parallel subagents are unavailable.
Require each workflow to report that limitation so final classifications do not
imply independent verification that was not performed.
🪄 Autofix (Beta)

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: 370ca2b0-a143-44f2-a3f9-becaf1bc4b3e

📥 Commits

Reviewing files that changed from the base of the PR and between b21aecb and 543e4bb.

📒 Files selected for processing (18)
  • docs/branch-review-ledger.md
  • docs/codex/architecture-maintainability/README.md
  • docs/codex/data-database-safety/README.md
  • docs/codex/documentation-ownership/README.md
  • docs/codex/functional-correctness/README.md
  • docs/codex/performance-reliability/README.md
  • docs/codex/tests-quality-gates/README.md
  • docs/prompts/codex-architecture-maintainability-ultra-review.md
  • docs/prompts/codex-data-database-safety-ultra-review.md
  • docs/prompts/codex-documentation-ownership-ultra-review.md
  • docs/prompts/codex-functional-correctness-ultra-review.md
  • docs/prompts/codex-performance-reliability-ultra-review.md
  • docs/prompts/codex-tests-quality-gates-ultra-review.md
  • docs/site-map.md
  • src/app/mockups/document-top-navigation/page.tsx
  • src/app/mockups/mockups-layout-client.tsx
  • src/components/document-top-navigation-mockups.tsx
  • tests/ui-document-top-navigation-mockup.spec.ts

@chatgpt-codex-connectorchatgpt-codex-connectorBot 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:71d442e792

ℹ️ 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 threadtests/ui-document-top-navigation-mockup.spec.ts Outdated
@BigSimmo
BigSimmo merged commit b2b5268 into mainJul 27, 2026
50 checks passed
@BigSimmo
BigSimmo deleted the codex/publish-document-nav-20260727 branch July 27, 2026 13:27
Sign up for freeto 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.

1 participant

@BigSimmo