Skip to content

docs: fix stale commands and references - #7205

Open
Ivorisnoob wants to merge 3 commits into
pingdotgg:mainfrom
Ivorisnoob:docs/fix-stale-commands-and-references
Open

docs: fix stale commands and references#7205
Ivorisnoob wants to merge 3 commits into
pingdotgg:mainfrom
Ivorisnoob:docs/fix-stale-commands-and-references

Conversation

@Ivorisnoob

@Ivorisnoob Ivorisnoob commented Aug 16, 2026

Copy link
Copy Markdown
Contributor

The docs had drifted from the code:

  • RPC_REQUIRED_SCOPE was renamed to RPC_REQUIRED_SCOPES in apps/server/src/auth/RpcAuthorization.ts.
  • The Ghostty upstream pin was attributed to mobile's VERSION file; it lives at native/libghostty-vt/VERSION and is shared by Android and web.
  • Several pages still used pnpm invocations from before the vp migration, so the commands fail when pasted.
  • The mobile test skill pointed at scripts/pair-client.sh, which does not resolve from the repository root.
  • docs/user/composer.md and docs/architecture/terminal-renderers.md existed but were not linked from the docs index.
  • terminal-renderers.md was missing the "For maintainers" banner that the other internals and operations pages carry.

Docs only; no source or behavior changes.

What Changed

Why

UI Changes

Checklist

  • This PR is small and focused
  • I explained what changed and why
  • I included before/after screenshots for any UI changes
  • I included a video for animation/interaction changes

Note

Low Risk
Markdown and agent-skill documentation only; no runtime, API, or build logic changes.

Overview
Docs-only alignment so pasted commands and cross-references match the repo today—no application or server behavior changes.

Command and path fixes: Maintainer docs that still showed pnpm for screenshot capture, Ghostty WASM builds, desktop dev web, and Expo now use vp run / vp exec. The mobile test skill’s troubleshooting line points at .agents/skills/test-t3-mobile/scripts/pair-client.sh instead of a root-relative scripts/ path that does not exist.

Accuracy: Architecture overview renames RPC_REQUIRED_SCOPE to RPC_REQUIRED_SCOPES. Ghostty docs and the web ghostty README attribute the upstream pin to native/libghostty-vt/VERSION (shared by Android and web), not mobile’s VERSION file.

Navigation and polish: docs/README.md adds links to Message composer and Terminal renderers; terminal-renderers.md gets the standard maintainer banner. updating.md gets a small grammar tweak on post-update wording; the screenshot runbook backticks --skip-build.

Reviewed by Cursor Bugbot for commit 958c498. Bugbot is set up for automated code reviews on this repo. Configure here.

Note

Fix stale commands and references across docs

Macroscope summarized 958c498.

The docs had drifted from the code:

- `RPC_REQUIRED_SCOPE` was renamed to `RPC_REQUIRED_SCOPES` in
  apps/server/src/auth/RpcAuthorization.ts.
- The Ghostty upstream pin was attributed to mobile's VERSION file; it
  lives at native/libghostty-vt/VERSION and is shared by Android and web.
- Several pages still used `pnpm` invocations from before the `vp`
  migration, so the commands fail when pasted.
- The mobile test skill pointed at `scripts/pair-client.sh`, which does
  not resolve from the repository root.
- docs/user/composer.md and docs/architecture/terminal-renderers.md
  existed but were not linked from the docs index.
- terminal-renderers.md was missing the "For maintainers" banner that the
  other internals and operations pages carry.

Docs only; no source or behavior changes.
@coderabbitai

coderabbitai Bot commented Aug 16, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 26c0ffc0-cba2-401b-a4a2-2961347b8b02

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

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.

@github-actions github-actions Bot added vouch:unvouched PR author is not yet trusted in the VOUCHED list. size:M 30-99 changed lines (additions + deletions). labels Aug 16, 2026
@macroscopeapp

macroscopeapp Bot commented Aug 16, 2026

Copy link
Copy Markdown
Contributor

Approvability

Verdict: Approved 6b81280

Documentation-only changes updating stale CLI commands (pnpmvp run), correcting path references, and adding doc links. No runtime code affected.

You can customize Macroscope's approvability policy. Learn more.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:M 30-99 changed lines (additions + deletions). vouch:unvouched PR author is not yet trusted in the VOUCHED list.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant