Skip to content

docs: Explain V2 and V3 project coexistence - #1803

Merged
hatayama merged 1 commit into
feature/v2-cli-delegation-integrationfrom
docs/v2-v3-coexistence
Jul 16, 2026
Merged

docs: Explain V2 and V3 project coexistence#1803
hatayama merged 1 commit into
feature/v2-cli-delegation-integrationfrom
docs/v2-v3-coexistence

Conversation

@hatayama

@hatayama hatayama commented Jul 16, 2026

Copy link
Copy Markdown
Owner

Summary

  • explain automatic delegation from the native v3 dispatcher to matching v2 CLIs
  • document the Node.js 22+ and initial npm cache requirements
  • clarify dispatcher-owned commands and warn against v2 Setup UI update or downgrade actions
  • replace global v2 switching instructions in both English and Japanese documentation

Validation

  • git diff --check
  • confirmed the removed global v2 installation command no longer appears in either README
  • compared the documented detection, cache, routing, stderr, and version behavior with the merged dispatcher implementation

Review in cubic

Document automatic legacy CLI delegation so users can keep the native dispatcher installed across project generations. Replace global V2 switching instructions with cache, Node.js, command ownership, and Setup UI guidance.
@coderabbitai

coderabbitai Bot commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 0b563ad2-021d-404d-a285-b33a62dd8deb

📥 Commits

Reviewing files that changed from the base of the PR and between e0bc7f7 and d2cc542.

📒 Files selected for processing (2)
  • README.md
  • README_ja.md

📝 Walkthrough

Walkthrough

The README files now document v3 dispatcher retention, automatic v2 delegation requirements, stderr behavior, and revised recovery steps for terminals resolving to a legacy npm CLI.

Changes

CLI dispatcher documentation

Layer / File(s) Summary
Dispatcher behavior and v2 delegation
README.md, README_ja.md
Documents v3 dispatcher retention, automatic v2 delegation, Node.js 22+ requirements, stdout/stderr behavior, and restrictions on changing CLI versions through project Settings.
Native installer recovery instructions
README.md, README_ja.md
Replaces global v2 CLI installation steps with removal of the legacy npm package followed by verified native dispatcher installation, including PowerShell guidance.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related PRs

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly summarizes the documentation update about V2 and V3 project coexistence.
Description check ✅ Passed The description matches the README changes and validation steps described in the pull request.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
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.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/v2-v3-coexistence

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.

@hatayama
hatayama merged commit a026ed7 into feature/v2-cli-delegation-integration Jul 16, 2026
2 checks passed
@hatayama
hatayama deleted the docs/v2-v3-coexistence branch July 16, 2026 07:50
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.

1 participant