Skip to content

docs: identify official REA installation sources - #2429

Merged
morluto merged 2 commits into
morluto:mainfrom
Aurantium-47:docs/verify-official-downloads
Oct 13, 2026
Merged

morluto merged 2 commits into
morluto:mainfrom
Aurantium-47:docs/verify-official-downloads

Conversation

@Aurantium-47

@Aurantium-47 Aurantium-47 commented Oct 13, 2026 •

Copy link
Copy Markdown
Contributor

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 fix: repair the static-check failures on the default branch #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

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

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex usage limits have been reached for code reviews. Please check with the admins of this repo to increase the limits by adding credits.
Repo admins can enable using credits for code reviews in their settings.

@morluto

morluto commented Oct 13, 2026

Copy link
Copy Markdown
Owner

@greptileai review

@greptile-apps

greptile-apps Bot commented Oct 13, 2026 •

Copy link
Copy Markdown
Contributor

RetriggerConfidence Score: 5/5 Tier: plus

[Low impact] This documentation-only PR appears safe to merge.

Summary

Adds official installation sources before the first setup shortcut in all 19 README editions.

  • Readmes point readers to REA’s official download sources.

Reviews (6) · Last reviewed commit: "docs: show official sources before setup..." · Reviewed by Greptile

Comment thread README.md Resolved
@morluto morluto added documentation Improvements or additions to documentation i18n Translations and localization workflow P3: low Low priority, nice to have labels Oct 13, 2026
Assisted-by: OpenAI GPT-6 <noreply@openai.com>
Move the unchanged official-source notice before the first setup command in all 19 README editions.

Assisted-by: OpenAI GPT-6 <noreply@openai.com>
@morluto
morluto force-pushed the docs/verify-official-downloads branch from 80d6530 to 144a97f Compare October 13, 2026 18:32
@morluto
morluto merged commit 4c83846 into morluto:main Oct 13, 2026
26 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation i18n Translations and localization workflow P3: low Low priority, nice to have

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Warning: fake repo rea-tools/rea distributes a trojan "Windows exe". Please add a README note

2 participants