diff --git a/README.md b/README.md index 02be36eb5c..b55d65bab3 100644 --- a/README.md +++ b/README.md @@ -89,7 +89,7 @@ REA shows how it reached its conclusions. It does not claim to recover original ### Run setup — recommended ```bash -npx --yes --prefer-online rea-agents@latest setup +npx --yes rea-agents@latest setup ``` The npm package-runner prompt, when shown, approves downloading REA for this @@ -103,10 +103,10 @@ detected agents, then asks which capabilities to set up: agent integration Nothing is preselected. Choosing agent integration opens a second empty checklist for the specific detected agents that should receive a registration. -`@latest` makes the requested release explicit, and `--prefer-online` asks npm -to refresh package metadata instead of relying on a cached resolution. REA does -not silently replace the package version npm selected. Intentional rollbacks -therefore remain available through an exact package request. +`@latest` makes the requested release explicit and asks npm for the release +currently published under that tag. REA does not silently replace the package +version npm selected. Intentional rollbacks therefore remain available through +an exact package request. REA keeps the journey inline so its history remains in the terminal. Selecting a capability does not select every detected target or authorize a change. @@ -137,7 +137,7 @@ Pass installer options after `bash -s --`, for example `--dry-run`, `--no-setup` ### With an agent — recommended ```bash -npx --yes --prefer-online rea-agents@latest setup +npx --yes rea-agents@latest setup ``` Choose Agent Integration in the reviewed setup plan. REA installs the pinned MCP @@ -149,7 +149,7 @@ Review the setup plan, approve it if appropriate, then describe the app or featu ### From Terminal — no installation ```bash -npx --yes --prefer-online rea-agents@latest setup +npx --yes rea-agents@latest setup npx -y rea-agents@latest doctor npx -y rea-agents@latest analyze /Applications/Notes.app ``` diff --git a/README_ar.md b/README_ar.md index ec3159f483..87b39021ed 100644 --- a/README_ar.md +++ b/README_ar.md @@ -65,7 +65,7 @@ npx rea-agents setup ### باستخدام وكيل برمجة — موصى به ```bash -npx --yes --prefer-online rea-agents@latest setup +npx --yes rea-agents@latest setup ``` اطلب من الوكيل إعداد REA. سيفحص جهاز Mac ويشرح ما يحتاج إلى تثبيته ويطلب الموافقة ويرشدك خلال رسائل النظام. أعد تشغيل الوكيل بعد الإعداد إذا طلب ذلك لتحميل مجموعة الأدوات الكاملة. @@ -90,7 +90,7 @@ npx --yes --prefer-online rea-agents@latest setup ```bash curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash -npx --yes --prefer-online rea-agents@latest setup +npx --yes rea-agents@latest setup ``` إذا طلب macOS أو برنامج التثبيت تأكيدًا، فأكمل الخطوة ثم شغّل الأمر نفسه مرة أخرى. diff --git a/README_ja.md b/README_ja.md index f1c512d7ac..a1b61bb6d9 100644 --- a/README_ja.md +++ b/README_ja.md @@ -67,7 +67,7 @@ REA は調査をバイナリ上の根拠に結び付けます。元のソース ### コーディングエージェントから（推奨） ```bash -npx --yes --prefer-online rea-agents@latest setup +npx --yes rea-agents@latest setup ``` エージェントに REA のセットアップを依頼してください。Mac を確認し、必要なインストールを説明して承認を求め、システムプロンプトを案内します。完全なツールを読み込むため再起動を求められた場合は、セットアップ後に再起動してください。 @@ -91,7 +91,7 @@ Ubuntu 24.04+、Fedora 41+、64 ビット Arch Linux では、REA が公式の D ```bash # 1. REA をセットアップ curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash -npx --yes --prefer-online rea-agents@latest setup +npx --yes rea-agents@latest setup ``` macOS やインストーラーから確認を求められた場合は、その操作を完了してから同じコマンドをもう一度実行してください。 diff --git a/README_ko.md b/README_ko.md index 29d41a1b35..5a33c22125 100644 --- a/README_ko.md +++ b/README_ko.md @@ -67,7 +67,7 @@ REA는 분석을 바이너리 증거에 근거하게 합니다. 원본 소스 ### 코딩 에이전트에서 시작하기(권장) ```bash -npx --yes --prefer-online rea-agents@latest setup +npx --yes rea-agents@latest setup ``` 에이전트에게 REA 설정을 요청하세요. Mac을 확인하고 필요한 설치 내용을 설명한 뒤 승인을 요청하며 시스템 프롬프트를 안내합니다. 전체 도구를 불러오기 위해 재시작하라고 하면 설정 후 에이전트를 재시작하세요. @@ -91,7 +91,7 @@ Ubuntu 24.04+, Fedora 41+, 64비트 Arch Linux에서 REA는 공식 DEB, RPM 또 ```bash # 1. REA 설정 curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash -npx --yes --prefer-online rea-agents@latest setup +npx --yes rea-agents@latest setup ``` macOS나 설치 프로그램이 확인을 요청하면 해당 절차를 완료하고 같은 명령을 다시 실행하세요. diff --git a/README_zh.md b/README_zh.md index 6064bcc2a4..00ff4715da 100644 --- a/README_zh.md +++ b/README_zh.md @@ -67,7 +67,7 @@ REA 让调查始终以二进制证据为依据。它不会声称能恢复原始 ### 使用编程智能体（推荐） ```bash -npx --yes --prefer-online rea-agents@latest setup +npx --yes rea-agents@latest setup ``` 让智能体设置 REA。它会检查你的 Mac，说明需要安装的内容，先征得同意，并引导你处理系统提示。如果智能体要求重启以加载完整工具，请在设置后重启。 @@ -91,7 +91,7 @@ npx --yes --prefer-online rea-agents@latest setup ```bash # 1. 安装和配置 REA curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash -npx --yes --prefer-online rea-agents@latest setup +npx --yes rea-agents@latest setup ``` 如果 macOS 或安装程序要求确认，请完成提示，然后再次运行同一命令。 diff --git a/docs/installation.md b/docs/installation.md index 2d3cd28875..b0a07d4f81 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -7,7 +7,7 @@ REA separates installing its CLI from configuring external software and agents. The recommended setup entrypoint is: ```bash -npx --yes --prefer-online rea-agents@latest setup +npx --yes rea-agents@latest setup ``` If npm asks to download and run the package, that approval applies only to the @@ -15,8 +15,8 @@ current package-runner invocation. REA still prints its own setup plan and asks for separate approval before changing agent configuration or installing a product-owned component. -The explicit `@latest` request and `--prefer-online` metadata policy prevent a -project dependency or stale npx cache entry from choosing the setup version. +The explicit `@latest` request prevents a project dependency or stale npx cache +entry from choosing the setup version. REA runs the version npm selected and never silently replaces an intentional version request after launch. To repair registrations written by an older release, rerun the command above and review the resulting setup plan. diff --git a/tests/conformance/readmeConsistency.test.ts b/tests/conformance/readmeConsistency.test.ts index 32c26fb765..18b15c11fc 100644 --- a/tests/conformance/readmeConsistency.test.ts +++ b/tests/conformance/readmeConsistency.test.ts @@ -67,9 +67,7 @@ describe("localized README product facts", () => { "curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash", ); expect(content).toContain("npx rea-agents setup"); - expect(content).toContain( - "npx --yes --prefer-online rea-agents@latest setup", - ); + expect(content).toContain("npx --yes rea-agents@latest setup"); expect(content).toContain("npx -y rea-agents@latest doctor"); expect(content).toContain("rea uninstall"); expect(content).toContain( @@ -98,17 +96,13 @@ describe("localized README product facts", () => { expect(content).toContain("--install-hopper"); expect(content).toContain("docs/installation.md"); expect(content).toContain("You do not need both"); - expect(content).toContain( - "npx --yes --prefer-online rea-agents@latest setup", - ); + expect(content).toContain("npx --yes rea-agents@latest setup"); }); it("documents explicit setup freshness and rollback", async () => { const content = await readFile(resolve("docs/installation.md"), "utf8"); const prose = normalizedProse(content); - expect(prose).toContain( - "explicit `@latest` request and `--prefer-online` metadata policy", - ); + expect(prose).toContain("explicit `@latest` request"); expect(prose).toContain( "npm exec --yes --package=rea-agents@2.4.0 -- rea setup", );