Skip to content

sync: port upstream docs fixes and legal docs (#3990–#3992, #3972, #4000)#155

Merged
aaditagrawal merged 8 commits into
mainfrom
sync/20260716-docs-legal
Jul 16, 2026
Merged

sync: port upstream docs fixes and legal docs (#3990–#3992, #3972, #4000)#155
aaditagrawal merged 8 commits into
mainfrom
sync/20260716-docs-legal

Conversation

@aaditagrawal

@aaditagrawal aaditagrawal commented Jul 16, 2026

Copy link
Copy Markdown
Owner

What changed

  • Ports upstream docs CI/architecture/path-link fixes (#3990, #3991, #3992).
  • Ports T3 Code legal docs for marketing + mobile settings (#3972) and the legal modal header crash fix (#4000).
  • Review follow-ups: keep marketing nav on /legal index (legal-index-page), wsNativeApi wording, CI command list clarity, remove empty code fence.
  • Preserves fork: multi-provider wording in architecture overview; Android APK release notes in ci.md.

Validation

  • vp check / vp run typecheck — pass
  • CI: green on prior revision; rechecking after review fixes

Stack: 1 of 4; base main.

@coderabbitai

coderabbitai Bot commented Jul 16, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

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

Next review available in: 29 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: defaults

Review profile: CHILL

Plan: Pro

Run ID: 0bb9fef7-0fce-4a11-be50-2057106e7258

📥 Commits

Reviewing files that changed from the base of the PR and between ccd10e8 and d1ad35e.

📒 Files selected for processing (6)
  • apps/marketing/src/pages/legal.astro
  • apps/mobile/src/Stack.tsx
  • apps/mobile/src/features/settings/components/SettingsLegalDocumentRouteScreen.tsx
  • docs/architecture/overview.md
  • docs/operations/ci.md
  • docs/operations/effect-fn-checklist.md
📝 Walkthrough

Walkthrough

The marketing site adds legal document pages and navigation. The mobile app adds a Legal settings route with validated WebView access. Documentation updates reflect current workflows and repository links, while Expo development networking switches to LAN mode.

Changes

Marketing legal documents

Layer / File(s) Summary
Legal document shell and layout
apps/marketing/src/components/LegalPage.astro, apps/marketing/src/layouts/Layout.astro
Adds shared legal metadata, section navigation, active-section tracking, responsive styling, and legal footer links.
Legal document index
apps/marketing/src/pages/legal.astro
Adds responsive cards linking to the privacy, terms, and security documents.
Policy document content
apps/marketing/src/pages/privacy-policy.astro, apps/marketing/src/pages/security-policy.astro, apps/marketing/src/pages/terms-of-service.astro
Adds structured static content for the three legal documents.

Mobile legal document access

Layer / File(s) Summary
Legal URL resolution and validation
apps/mobile/src/features/settings/lib/legal-document-url.ts, apps/mobile/src/features/settings/lib/legal-document-url.test.ts
Builds legal-document URLs, validates normalized allowlisted URLs, and tests accepted and rejected inputs.
Settings route and navigation wiring
apps/mobile/src/features/settings/SettingsRouteScreen.tsx, apps/mobile/src/features/settings/SettingsLegalRouteScreen.tsx, apps/mobile/src/features/settings/components/SettingsRow.tsx, apps/mobile/src/features/settings/components/settings-sheet-targets.ts, apps/mobile/src/Stack.tsx
Connects the Legal settings row to a full-screen stack route with custom header actions.
Embedded legal document viewer
apps/mobile/src/features/settings/components/SettingsLegalDocumentRouteScreen.tsx
Displays legal pages in a controlled WebView with progress, reload, error, and external-browser handling.

Mobile development workflow

Layer / File(s) Summary
Expo development connection
apps/mobile/package.json
Changes the client development script from localhost to LAN mode.

Documentation updates

Layer / File(s) Summary
Architecture and CI references
docs/architecture/overview.md, docs/operations/ci.md
Updates architecture references and documents current CI commands.
Effect.fn checklist links
docs/operations/effect-fn-checklist.md
Rewrites checklist links using repository-relative paths.

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

Sequence Diagram(s)

sequenceDiagram
  participant Settings
  participant LegalRoute
  participant WebView
  participant Browser
  Settings->>LegalRoute: open Legal
  LegalRoute->>WebView: load validated document URL
  WebView->>LegalRoute: report loading or navigation state
  LegalRoute->>Browser: open non-legal URL externally
Loading

Suggested reviewers: juliusmarminge

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (2 warnings)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring 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.
Description check ⚠️ Warning It describes what changed and validation, but omits the required Why section, UI change evidence, and checklist completion. Add a Why section, include UI screenshots or note why they are unnecessary, and complete the checklist items.
✅ Passed checks (3 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 matches the main changeset: upstream docs fixes plus new legal documentation work.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch sync/20260716-docs-legal

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.

@aaditagrawal aaditagrawal changed the title fix(docs): correct CI task-runner commands in ci.md (#3990) sync: port upstream docs fixes and legal docs (#3990–#3992, #3972, #4000) Jul 16, 2026
@aaditagrawal

Copy link
Copy Markdown
Owner Author

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Jul 16, 2026

Copy link
Copy Markdown
✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@coderabbitai coderabbitai 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.

Actionable comments posted: 4

🤖 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 `@apps/marketing/src/layouts/Layout.astro`:
- Around line 432-434: Update the mobile `.legal-document-page .nav` styling in
`Layout.astro` so the Legal index retains a navigable Home link: remove the
global hide, scope it only to individual legal document pages using their
distinguishing class, or add an equivalent prominent Home link for the index and
preserve existing document-page navigation.

In `@docs/architecture/overview.md`:
- Around line 94-95: Update the architecture overview’s browser API reference
from the undefined nativeApi shorthand to wsNativeApi, matching the startup flow
and supplied source context. Keep the surrounding WsTransport and wsServer
descriptions unchanged.

In `@docs/operations/ci.md`:
- Line 3: Update the CI description in docs/operations/ci.md to list vp check
and vpr typecheck as separate commands, removing the inaccurate “lint +
typecheck” parenthetical while preserving the existing pull request, main push,
and test command details.

In `@docs/operations/effect-fn-checklist.md`:
- Around line 196-198: Remove the empty unlabeled code fence in the
documentation section around the referenced checklist content, or add an
appropriate language tag only if the code block is intentional. Ensure the
Markdown remains formatter-clean and run vp check --fix before committing.
🪄 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: defaults

Review profile: CHILL

Plan: Pro

Run ID: 0c1d24b1-57be-43ad-ad8b-99690ff4d942

📥 Commits

Reviewing files that changed from the base of the PR and between 017ae05 and ccd10e8.

📒 Files selected for processing (18)
  • apps/marketing/src/components/LegalPage.astro
  • apps/marketing/src/layouts/Layout.astro
  • apps/marketing/src/pages/legal.astro
  • apps/marketing/src/pages/privacy-policy.astro
  • apps/marketing/src/pages/security-policy.astro
  • apps/marketing/src/pages/terms-of-service.astro
  • apps/mobile/package.json
  • apps/mobile/src/Stack.tsx
  • apps/mobile/src/features/settings/SettingsLegalRouteScreen.tsx
  • apps/mobile/src/features/settings/SettingsRouteScreen.tsx
  • apps/mobile/src/features/settings/components/SettingsLegalDocumentRouteScreen.tsx
  • apps/mobile/src/features/settings/components/SettingsRow.tsx
  • apps/mobile/src/features/settings/components/settings-sheet-targets.ts
  • apps/mobile/src/features/settings/lib/legal-document-url.test.ts
  • apps/mobile/src/features/settings/lib/legal-document-url.ts
  • docs/architecture/overview.md
  • docs/operations/ci.md
  • docs/operations/effect-fn-checklist.md

Comment thread apps/marketing/src/layouts/Layout.astro
Comment thread docs/architecture/overview.md Outdated
Comment thread docs/operations/ci.md Outdated
Comment thread docs/operations/effect-fn-checklist.md 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: ccd10e8755

ℹ️ 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 apps/mobile/src/Stack.tsx Outdated
Comment thread apps/mobile/src/features/settings/components/SettingsLegalDocumentRouteScreen.tsx Outdated

aaditagrawal commented Jul 16, 2026

Copy link
Copy Markdown
Owner Author

Merge activity

  • Jul 16, 10:01 AM UTC: A user started a stack merge that includes this pull request via Graphite.
  • Jul 16, 10:02 AM UTC: @aaditagrawal merged this pull request with Graphite.

@aaditagrawal
aaditagrawal merged commit d43905a into main Jul 16, 2026
12 checks passed
aaditagrawal added a commit that referenced this pull request Jul 16, 2026
…pingdotgg#3978, pingdotgg#4001, pingdotgg#4020) (#156)

## What changed

- Ports duty-cycle status animations and removes fixed noise overlay (`pingdotgg#3978`).
- Ports onboarding/cloud connection status presentation fix (`pingdotgg#4001`).
- Ports markdown over-indent list normalization (`pingdotgg#4020`).
- Follow-up: allow Connect/Retry for saved cloud environments in idle/error tones (upstream left those buttons permanently disabled).
- Preserves fork: keeps `sidebar-translucent` alongside upstream `surface-grain`.

## Validation

- `vp check` / `vp run typecheck` — pass on stack tip
- CI: pending

Stack: 2 of 4; depends on #155.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:XXL 1,000+ effective changed lines (test files excluded in mixed PRs). vouch:trusted PR author is trusted by repo permissions or the VOUCHED list.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants