From 6e6ff7bd2eabb668602258ad5e31eb758b31f823 Mon Sep 17 00:00:00 2001
From: morluto <76467478+morluto@users.noreply.github.com>
Date: Thu, 8 Oct 2026 22:54:57 +0800
Subject: [PATCH 1/3] docs: move star milestone into history sections across
readmes
---
README.md | 8 ++++----
README_ar.md | 18 ++++++++++++++----
README_ja.md | 18 ++++++++++++++----
README_ko.md | 18 ++++++++++++++----
README_zh.md | 18 ++++++++++++++----
5 files changed, 60 insertions(+), 20 deletions(-)
diff --git a/README.md b/README.md
index 94800af9c3..f15c21f623 100644
--- a/README.md
+++ b/README.md
@@ -16,10 +16,6 @@
[](LICENSE)
[](https://discord.gg/GkcryMnJDM)
-🎉 **20,000 GitHub stars — thank you!**
-
-Thanks to everyone using REA, reporting bugs, testing builds, and contributing fixes.
-
**[Website](https://morluto.github.io/rea/) · [Guides](https://morluto.github.io/rea/guides/) · [Showcases](https://morluto.github.io/rea/showcase/)**
@@ -325,6 +321,10 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and checks,
## Star history
+🎉 **20,000 GitHub stars — thank you!**
+
+Thanks to everyone using REA, reporting bugs, testing builds, and contributing fixes.
+
diff --git a/README_ar.md b/README_ar.md
index 0e8e70fc87..8323ddd53c 100644
--- a/README_ar.md
+++ b/README_ar.md
@@ -15,10 +15,6 @@
[](LICENSE)
[](https://discord.gg/GkcryMnJDM)
-🎉 **وصلنا إلى 20,000 نجمة على GitHub، شكرًا لكم!**
-
-شكرًا لكل من يستخدم REA ويبلّغ عن الأخطاء ويختبر الإصدارات ويساهم في إصلاحها.
-
**[الموقع (بالإنجليزية)](https://morluto.github.io/rea/) · [أدلة الاستخدام](https://morluto.github.io/rea/guides/) · [دراسة حالة DX-Ball](https://morluto.github.io/rea/showcase/dx-ball/)**
@@ -343,3 +339,17 @@ npx -y rea-agents@latest compare /absolute/path/to/left-evidence.json /absolute/
## الترخيص
[MIT](LICENSE)
+
+## تاريخ النجوم
+
+🎉 **وصلنا إلى 20,000 نجمة على GitHub، شكرًا لكم!**
+
+شكرًا لكل من يستخدم REA ويبلّغ عن الأخطاء ويختبر الإصدارات ويساهم في إصلاحها.
+
+
+
+
+
+
+
+
diff --git a/README_ja.md b/README_ja.md
index f89f9d4432..8a8875856b 100644
--- a/README_ja.md
+++ b/README_ja.md
@@ -15,10 +15,6 @@
[](LICENSE)
[](https://discord.gg/GkcryMnJDM)
-🎉 **GitHub スターが 20,000 を突破しました。ありがとうございます!**
-
-REA を使い、問題を報告し、ビルドをテストし、修正を届けてくださる皆さんに感謝します。
-
**[ウェブサイト(英語)](https://morluto.github.io/rea/) · [ガイド](https://morluto.github.io/rea/guides/) · [DX-Ball の事例](https://morluto.github.io/rea/showcase/dx-ball/)**
@@ -373,3 +369,17 @@ REA にホスト型の解析サービスはありません。現在のプロバ
## ライセンス
[MIT](LICENSE)
+
+## スター履歴
+
+🎉 **GitHub スターが 20,000 を突破しました。ありがとうございます!**
+
+REA を使い、問題を報告し、ビルドをテストし、修正を届けてくださる皆さんに感謝します。
+
+
+
+
+
+
+
+
diff --git a/README_ko.md b/README_ko.md
index 7aa2b334ef..ee0b2d4220 100644
--- a/README_ko.md
+++ b/README_ko.md
@@ -15,10 +15,6 @@
[](LICENSE)
[](https://discord.gg/GkcryMnJDM)
-🎉 **GitHub 스타 20,000개, 감사합니다!**
-
-REA를 사용하고, 버그를 제보하고, 빌드를 테스트하고, 수정에 기여해 주신 모든 분께 감사드립니다.
-
**[웹사이트(영문)](https://morluto.github.io/rea/) · [가이드](https://morluto.github.io/rea/guides/) · [DX-Ball 사례](https://morluto.github.io/rea/showcase/dx-ball/)**
@@ -322,3 +318,17 @@ REA에는 호스팅 분석 서비스가 없습니다. 로컬 Unix 소켓을 통
## 라이선스
[MIT](LICENSE)
+
+## 스타 기록
+
+🎉 **GitHub 스타 20,000개, 감사합니다!**
+
+REA를 사용하고, 버그를 제보하고, 빌드를 테스트하고, 수정에 기여해 주신 모든 분께 감사드립니다.
+
+
+
+
+
+
+
+
diff --git a/README_zh.md b/README_zh.md
index dea70c179f..270c5e334c 100644
--- a/README_zh.md
+++ b/README_zh.md
@@ -15,10 +15,6 @@
[](LICENSE)
[](https://discord.gg/GkcryMnJDM)
-🎉 **GitHub Star 突破 20,000,感谢大家!**
-
-感谢每一位使用 REA、反馈问题、测试构建和贡献修复的朋友。
-
**[网站(英文)](https://morluto.github.io/rea/) · [使用指南](https://morluto.github.io/rea/guides/) · [DX-Ball 案例](https://morluto.github.io/rea/showcase/dx-ball/)**
@@ -323,3 +319,17 @@ REA 不提供托管分析服务,而是通过本地 Unix 套接字把操作交
## 许可证
[MIT](LICENSE)
+
+## Star 历史
+
+🎉 **GitHub Star 突破 20,000,感谢大家!**
+
+感谢每一位使用 REA、反馈问题、测试构建和贡献修复的朋友。
+
+
+
+
+
+
+
+
From 9833c94656e1d54e7711dc483bf8091ced14234f Mon Sep 17 00:00:00 2001
From: morluto <76467478+morluto@users.noreply.github.com>
Date: Thu, 8 Oct 2026 22:56:00 +0800
Subject: [PATCH 2/3] docs: require surrounding boundary checks for review
fixes
---
AGENTS.md | 2 ++
1 file changed, 2 insertions(+)
diff --git a/AGENTS.md b/AGENTS.md
index f7f8d9ea16..b079dd7ef2 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -54,6 +54,8 @@ Use ESM TypeScript, two-space indentation, and the committed Oxfmt configuration
Treat a boundary as a contract between the producer's actual representation and the consumer's required meaning. When implementing or auditing a boundary, trace the value through parsing, normalization, authorization, serialization, and the CLI/MCP result. Establish affected callers from their code paths; similar tool names or workflows do not prove that they share a schema or failure mode.
+When fixing a review finding, correct the failed assumption and inspect adjacent input representations, failure paths, and callers at the same boundary. Add regressions for the failure class, including how evidence and diagnostics reach affected CLI/MCP results, rather than only the reported example.
+
Keep portable evidence and scenario validation distinct from host-native execution checks. Absolute filesystem paths, file URLs, and HTTP paths have different semantics; do not substitute one platform's syntax for the domain concept. Interpret provider metadata according to its documented or observed producer behavior. When a transformation loses information, preserve the reported value and an explicit unknown rather than guessing a canonical identity.
Preserve meaningful failure reasons through application and adapter layers. Malformed input is distinct from an unsupported target, unavailable provider, or host operating-system permission denial. Diagnostics should identify the failed constraint and the target or lifecycle request it applies to. Recovery advice must address that reason and point to an available workflow; generic catches must not erase actionable validation details.
From 46d195e8a48b710fc355e84cb6b79461b9c39005 Mon Sep 17 00:00:00 2001
From: morluto <76467478+morluto@users.noreply.github.com>
Date: Thu, 8 Oct 2026 22:56:58 +0800
Subject: [PATCH 3/3] docs: check surrounding cases when changing boundaries
---
AGENTS.md | 2 +-
README.md | 8 ++++----
README_ar.md | 8 ++++----
README_ja.md | 8 ++++----
README_ko.md | 8 ++++----
README_zh.md | 8 ++++----
6 files changed, 21 insertions(+), 21 deletions(-)
diff --git a/AGENTS.md b/AGENTS.md
index b079dd7ef2..5585ecadd8 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -54,7 +54,7 @@ Use ESM TypeScript, two-space indentation, and the committed Oxfmt configuration
Treat a boundary as a contract between the producer's actual representation and the consumer's required meaning. When implementing or auditing a boundary, trace the value through parsing, normalization, authorization, serialization, and the CLI/MCP result. Establish affected callers from their code paths; similar tool names or workflows do not prove that they share a schema or failure mode.
-When fixing a review finding, correct the failed assumption and inspect adjacent input representations, failure paths, and callers at the same boundary. Add regressions for the failure class, including how evidence and diagnostics reach affected CLI/MCP results, rather than only the reported example.
+When changing boundary behavior, inspect adjacent input representations, failure paths, and affected callers, and correct the underlying assumption across those cases.
Keep portable evidence and scenario validation distinct from host-native execution checks. Absolute filesystem paths, file URLs, and HTTP paths have different semantics; do not substitute one platform's syntax for the domain concept. Interpret provider metadata according to its documented or observed producer behavior. When a transformation loses information, preserve the reported value and an explicit unknown rather than guessing a canonical identity.
diff --git a/README.md b/README.md
index f15c21f623..3ac6a90da2 100644
--- a/README.md
+++ b/README.md
@@ -315,10 +315,6 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and checks,
[Website](https://morluto.github.io/rea/) · [npm](https://www.npmjs.com/package/rea-agents) · [skills.sh](https://skills.sh/morluto/rea/reverse-engineer-anything) · [Issues](https://github.com/morluto/rea/issues) · [Security](SECURITY.md)
-## License
-
-[MIT](LICENSE)
-
## Star history
🎉 **20,000 GitHub stars — thank you!**
@@ -336,3 +332,7 @@ Thanks to everyone using REA, reporting bugs, testing builds, and contributing f
## Disclaimer
REA provides tools for lawful reverse-engineering research, analysis, and reconstruction. You are responsible for obtaining any required authorization and complying with applicable laws. The project does not endorse illegal or unauthorized use.
+
+## License
+
+[MIT](LICENSE)
diff --git a/README_ar.md b/README_ar.md
index 8323ddd53c..2cfccff05e 100644
--- a/README_ar.md
+++ b/README_ar.md
@@ -336,10 +336,6 @@ npx -y rea-agents@latest compare /absolute/path/to/left-evidence.json /absolute/
- [Hopper Disassembler](https://www.hopperapp.com/)
- [سياسة الأمان](SECURITY.md)
-## الترخيص
-
-[MIT](LICENSE)
-
## تاريخ النجوم
🎉 **وصلنا إلى 20,000 نجمة على GitHub، شكرًا لكم!**
@@ -353,3 +349,7 @@ npx -y rea-agents@latest compare /absolute/path/to/left-evidence.json /absolute/
+
+## الترخيص
+
+[MIT](LICENSE)
diff --git a/README_ja.md b/README_ja.md
index 8a8875856b..213ceeb3a6 100644
--- a/README_ja.md
+++ b/README_ja.md
@@ -366,10 +366,6 @@ REA にホスト型の解析サービスはありません。現在のプロバ
開発環境、アーキテクチャ、テスト、リリース手順は [CONTRIBUTING.md](CONTRIBUTING.md) を参照してください。
-## ライセンス
-
-[MIT](LICENSE)
-
## スター履歴
🎉 **GitHub スターが 20,000 を突破しました。ありがとうございます!**
@@ -383,3 +379,7 @@ REA を使い、問題を報告し、ビルドをテストし、修正を届け
+
+## ライセンス
+
+[MIT](LICENSE)
diff --git a/README_ko.md b/README_ko.md
index ee0b2d4220..f8a13d3e41 100644
--- a/README_ko.md
+++ b/README_ko.md
@@ -315,10 +315,6 @@ REA에는 호스팅 분석 서비스가 없습니다. 로컬 Unix 소켓을 통
개발 환경, 아키텍처, 테스트, 릴리스 지침은 [CONTRIBUTING.md](CONTRIBUTING.md)를 참고하세요.
-## 라이선스
-
-[MIT](LICENSE)
-
## 스타 기록
🎉 **GitHub 스타 20,000개, 감사합니다!**
@@ -332,3 +328,7 @@ REA를 사용하고, 버그를 제보하고, 빌드를 테스트하고, 수정
+
+## 라이선스
+
+[MIT](LICENSE)
diff --git a/README_zh.md b/README_zh.md
index 270c5e334c..bc3cd5e545 100644
--- a/README_zh.md
+++ b/README_zh.md
@@ -316,10 +316,6 @@ REA 不提供托管分析服务,而是通过本地 Unix 套接字把操作交
开发环境、架构、测试和发布说明请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。
-## 许可证
-
-[MIT](LICENSE)
-
## Star 历史
🎉 **GitHub Star 突破 20,000,感谢大家!**
@@ -333,3 +329,7 @@ REA 不提供托管分析服务,而是通过本地 Unix 套接字把操作交
+
+## 许可证
+
+[MIT](LICENSE)