[PR #2429] [MERGED] docs: identify official REA installation sources #5223

Closed
opened 2026-10-31 01:04:56 +00:00 by bsakaguchi · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/morluto/rea/pull/2429
Author: @Aurantium-47
Created: 10/13/2026
Status: ✅ Merged
Merged: 10/13/2026
Merged by: @morluto

Base: main ← Head: docs/verify-official-downloads


📝 Commits (2)

  • f980366 docs: identify official REA installation sources
  • 144a97f docs: show official sources before setup shortcut

📊 Changes

19 files changed (+78 additions, -0 deletions)

View changed files

📝 README.md (+6 -0)
📝 docs/readme/README_ar.md (+4 -0)
📝 docs/readme/README_de.md (+4 -0)
📝 docs/readme/README_es.md (+4 -0)
📝 docs/readme/README_fa.md (+4 -0)
📝 docs/readme/README_fr.md (+4 -0)
📝 docs/readme/README_id.md (+4 -0)
📝 docs/readme/README_it.md (+4 -0)
📝 docs/readme/README_ja.md (+4 -0)
📝 docs/readme/README_ko.md (+4 -0)
📝 docs/readme/README_pl.md (+4 -0)
📝 docs/readme/README_pt-BR.md (+4 -0)
📝 docs/readme/README_ru.md (+4 -0)
📝 docs/readme/README_th.md (+4 -0)
📝 docs/readme/README_tr.md (+4 -0)
📝 docs/readme/README_uk.md (+4 -0)
📝 docs/readme/README_vi.md (+4 -0)
📝 docs/readme/README_zh-TW.md (+4 -0)
📝 docs/readme/README_zh.md (+4 -0)

📄 Description

Summary

Fixes #2424.

Add an official-source notice before the README's first installation command, including each translated edition, so readers can check which repository, website and npm package to use.

Problem and expected behavior

The report describes a copied README advertising an unofficial executable. The quick start already supplies the correct npm command, but does not explicitly identify the official distribution sources or warn that a similar repository name is insufficient verification.

Change and scope

Link morluto/rea, rea.tools and the rea-agents npm package, and ask readers to follow installation and release links from those sources. Keep the same notice and link targets across all 19 README editions, above the top-of-page npx rea-agents setup shortcut. The notice avoids repeating the reported download URL or asserting a malware verdict. It remains useful if the supported release formats change.

Contract and boundary impact

  • Semantic owner and earliest changed stage: README introduction, before the first setup shortcut.
  • Contribution scope: documentation correction; separate capability approval is not applicable.
  • CLI/MCP, provider, Evidence and target-authority contracts: unchanged.
  • Generated metadata and installation commands: unchanged.
  • Documentation or usability only; no target interaction.

Evidence and regression coverage

The repository's package metadata identifies morluto/rea and rea-agents; its existing website link and the live site's setup instructions identify the same project. Existing onboarding consistency tests check that installation examples remain aligned across the README translations. No new test was added for static wording.

Validation performed

After syncing upstream main ebaaa79 into the PR branch, using pinned Node 24.18.0 / npm 11.16.0 on Windows x64:

  • npm run docs:check — passed, including all 6 generated-documentation tasks and 5 README conformance tests.
  • npm run check:fast — passed (typecheck and lint).
  • git diff --check — passed. The diff against main remains 19 README files; all official-source notices are unchanged and precede the first setup shortcut.
  • npm run check / npm run format:check — blocked by formatting already present on upstream ebaaa79 in docs/readme/README_tr.md and scripts/lib/clean-linux-hopper-runtime.mjs. The same formatter edits are required on the pristine upstream files; the earlier static-check failures fixed by #2895 are resolved.

Compatibility, safety, and release

No migration, runtime, package metadata, or provider change. This is installation guidance, not a verification or containment guarantee.

Before merge

  • This addresses the concrete documentation request in #2424.
  • Scope and authority are resolved for a documentation-only change.
  • One focused outcome and a Conventional Commit title.
  • Existing installation examples remain unchanged.
  • No generated metadata or user-visible CLI/MCP change.
  • The diff contains no secrets, unrelated cleanup, or unsupported malware claims.

AI-assisted implementation and review using OpenAI GPT-6; the validation listed above was executed locally.


🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/morluto/rea/pull/2429 **Author:** [@Aurantium-47](https://github.com/Aurantium-47) **Created:** 10/13/2026 **Status:** ✅ Merged **Merged:** 10/13/2026 **Merged by:** [@morluto](https://github.com/morluto) **Base:** `main` ← **Head:** `docs/verify-official-downloads` --- ### 📝 Commits (2) - [`f980366`](https://github.com/morluto/rea/commit/f980366c5e85cf5bafe5f5fe97f37d8ff3df9ad6) docs: identify official REA installation sources - [`144a97f`](https://github.com/morluto/rea/commit/144a97f5ef6de619d8bab5360f08ceff7682ae44) docs: show official sources before setup shortcut ### 📊 Changes **19 files changed** (+78 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `README.md` (+6 -0) 📝 `docs/readme/README_ar.md` (+4 -0) 📝 `docs/readme/README_de.md` (+4 -0) 📝 `docs/readme/README_es.md` (+4 -0) 📝 `docs/readme/README_fa.md` (+4 -0) 📝 `docs/readme/README_fr.md` (+4 -0) 📝 `docs/readme/README_id.md` (+4 -0) 📝 `docs/readme/README_it.md` (+4 -0) 📝 `docs/readme/README_ja.md` (+4 -0) 📝 `docs/readme/README_ko.md` (+4 -0) 📝 `docs/readme/README_pl.md` (+4 -0) 📝 `docs/readme/README_pt-BR.md` (+4 -0) 📝 `docs/readme/README_ru.md` (+4 -0) 📝 `docs/readme/README_th.md` (+4 -0) 📝 `docs/readme/README_tr.md` (+4 -0) 📝 `docs/readme/README_uk.md` (+4 -0) 📝 `docs/readme/README_vi.md` (+4 -0) 📝 `docs/readme/README_zh-TW.md` (+4 -0) 📝 `docs/readme/README_zh.md` (+4 -0) </details> ### 📄 Description ## Summary Fixes #2424. Add an official-source notice before the README's first installation command, including each translated edition, so readers can check which repository, website and npm package to use. ## Problem and expected behavior The report describes a copied README advertising an unofficial executable. The quick start already supplies the correct npm command, but does not explicitly identify the official distribution sources or warn that a similar repository name is insufficient verification. ## Change and scope Link `morluto/rea`, `rea.tools` and the `rea-agents` npm package, and ask readers to follow installation and release links from those sources. Keep the same notice and link targets across all 19 README editions, above the top-of-page `npx rea-agents setup` shortcut. The notice avoids repeating the reported download URL or asserting a malware verdict. It remains useful if the supported release formats change. ## Contract and boundary impact - Semantic owner and earliest changed stage: README introduction, before the first setup shortcut. - Contribution scope: documentation correction; separate capability approval is not applicable. - CLI/MCP, provider, Evidence and target-authority contracts: unchanged. - Generated metadata and installation commands: unchanged. - [x] Documentation or usability only; no target interaction. ## Evidence and regression coverage The repository's package metadata identifies `morluto/rea` and `rea-agents`; its existing website link and the live site's setup instructions identify the same project. Existing onboarding consistency tests check that installation examples remain aligned across the README translations. No new test was added for static wording. ## Validation performed After syncing upstream main `ebaaa79` into the PR branch, using pinned Node 24.18.0 / npm 11.16.0 on Windows x64: - `npm run docs:check` — passed, including all 6 generated-documentation tasks and 5 README conformance tests. - `npm run check:fast` — passed (typecheck and lint). - `git diff --check` — passed. The diff against main remains 19 README files; all official-source notices are unchanged and precede the first setup shortcut. - `npm run check` / `npm run format:check` — blocked by formatting already present on upstream `ebaaa79` in `docs/readme/README_tr.md` and `scripts/lib/clean-linux-hopper-runtime.mjs`. The same formatter edits are required on the pristine upstream files; the earlier static-check failures fixed by #2895 are resolved. ## Compatibility, safety, and release No migration, runtime, package metadata, or provider change. This is installation guidance, not a verification or containment guarantee. ## Before merge - [x] This addresses the concrete documentation request in #2424. - [x] Scope and authority are resolved for a documentation-only change. - [x] One focused outcome and a Conventional Commit title. - [x] Existing installation examples remain unchanged. - [x] No generated metadata or user-visible CLI/MCP change. - [x] The diff contains no secrets, unrelated cleanup, or unsupported malware claims. AI-assisted implementation and review using OpenAI GPT-6; the validation listed above was executed locally. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
bsakaguchi 2026-10-31 01:04:56 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
morluto/rea#5223
No description provided.