morluto/rea

Fork

You've already forked rea

mirror of https://github.com/morluto/rea.git synced 2026-11-05 06:45:22 +00:00

Code Issues 1.3k Projects Packages Wiki Activity

[PR #3113] docs(readme): sync Simplified Chinese README with current English prerequisites #5628

New issue

Open

opened 2026-10-31 01:08:06 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-31 01:08:06 +00:00

Owner

Copy link

📋 Pull Request Information

Original PR: https://github.com/morluto/rea/pull/3113
Author: @MbappeWU
Created: 10/14/2026
Status: 🔄 Open

Base: main ← Head: docs/zh-readme-linux-procps

📝 Commits (9)

5cb6e56 docs(readme): sync Simplified Chinese README with current English prerequisites
01260bc Merge upstream/main into docs/zh-readme-linux-procps
6dd8447 Merge upstream/main into docs/zh-readme-linux-procps
132cabc Merge upstream/main into docs/zh-readme-linux-procps
5d2baaf Merge upstream/main into docs/zh-readme-linux-procps
7d2a62f Merge upstream/main into docs/zh-readme-linux-procps
259f2fa Merge upstream/main into docs/zh-readme-linux-procps
cdd5e8b Merge upstream/main into docs/zh-readme-linux-procps
53aeed0 docs(readme): narrow zh README to remaining gaps vs main

📊 Changes

1 file changed (+16 additions, -14 deletions)

View changed files

📝 docs/readme/README_zh.md (+16 -14)

📄 Description

Summary

The Simplified Chinese README (docs/readme/README_zh.md) had fallen behind README.md on several user-facing facts. Most importantly, it did not mention that Linux needs a procps-compatible ps on REA's PATH (added to the English README in "docs(installation): document Linux procps prerequisite"), so Chinese readers on Linux could hit the owned-process check failure without any hint. This PR syncs only substantive content; no cosmetic rewording.

Problem and expected behavior

A reader following README_zh.md on Linux was missing a required prerequisite and several capability/requirement rows present in README.md. Expected: the translation states the same prerequisites, rows, and provider notes as the English README.

Change and scope

Each change mirrors a line in README.md:

Quick start: Linux procps-compatible ps requirement for Ghidra, JADX, firmware tools, and static JavaScript/Electron analysis (README.md lines 67–70).
"What you can analyze" table: JavaScript/Electron row gains the Linux ps requirement; Rust row translated (was left in English) and reordered after Go; new SQLite row; Fiddler Everywhere SAZ in saved network captures; packet-summaries row renamed and marked Linux-verified, placed after packet captures; .NET requirement reads "none (static inspection only)".
Paragraph on caller-provided GNU objdump and Rizin after the table; the duplicate top-nav link to that guide is removed, matching the English nav line.
Provider paragraph: optional native IDA MCP bridge and REA_GHIDRA_STARTUP_TIMEOUT_MS / REA_HOPPER_STARTUP_TIMEOUT_MS.
Hopper FAQ: finish the macOS first-run prompt in the same user session before the first CLI/MCP operation or unattended task.
Troubleshooting FAQ: rea update applies to CLIs installed with npm install --global or bun add --global.

Commands blocks and version numbers are unchanged. Not included: other translations.

Follow the contribution scope. Ordinary documentation fix within existing boundaries; scope decision not applicable.

Contract and boundary impact

Semantic owner and earliest changed stage: documentation (docs/readme/README_zh.md) only.
Contribution scope fit and linked maintainer decision: documentation correction; not applicable.
CLI and MCP/tool-catalog contract: none.
Provider, bridge, target-format, or platform compatibility: none.
Evidence, artifact, provenance, or reconstruction contract: none.
Target selection, authority, upstream behavior, and cleanup details (if applicable): not applicable.
Generated metadata (docs/public/product-catalog.json), package, or installation impact: none; no generated files committed.
Read existing files or captured data.
Launch or attach to a process.
Inject instrumentation or run scripts/code.
Change process memory, registers, files, or configuration.
Contact network services.
Recover protected code or work around protections.
Documentation or usability only; no target interaction.
Not sure yet; investigation or maintainer guidance needed.

Evidence and regression coverage

Executed locally on Linux x64, Node.js 22.20.0, base f353474, after npm ci --ignore-scripts, npm run build, and npm run docs:generate:

npx vitest run tests/conformance/readmeConsistency.test.ts tests/boundary/filesystem/productCatalog.test.ts: 15 passed, 1 failed. The failing case, canonical product catalog drift > keeps translated readmes linked to canonical setup and tool details (expects https://rea.tools/zh-CN/guides/native/), fails identically on the unmodified base checkout, so it is pre-existing and not caused by this change.
Link check using the docs-facts.mjs normalization: 90 links in each README, 0 link-target differences, all 60 relative file targets exist; bash blocks identical to README.md.
npx prettier --check docs/readme/README_zh.md: passes.
Tests added or updated: none (documentation-only).
Unavailable coverage: full npm run docs:check / CI suite not run locally.

Author readiness

Human owner: @MbappeWU

I reviewed the final diff and relevant existing code, understand the change and its edge cases, and take responsibility for the complete PR, including AI-assisted work.
I checked the evidence above, confirmed it supports the current change, and recorded meaningful validation gaps.
I declare this PR ready for initial maintainer review.

_{🔄 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/3113 **Author:** [@MbappeWU](https://github.com/MbappeWU) **Created:** 10/14/2026 **Status:** 🔄 Open **Base:** `main` ← **Head:** `docs/zh-readme-linux-procps` --- ### 📝 Commits (9) - [`5cb6e56`](https://github.com/morluto/rea/commit/5cb6e569965392358c47ccfcf7f344e7b01dfd22) docs(readme): sync Simplified Chinese README with current English prerequisites - [`01260bc`](https://github.com/morluto/rea/commit/01260bc8617241f22a05e6f0ed2b50fd545f24e7) Merge upstream/main into docs/zh-readme-linux-procps - [`6dd8447`](https://github.com/morluto/rea/commit/6dd8447524d2ad140ed5ddc4345b175af2ab4cbf) Merge upstream/main into docs/zh-readme-linux-procps - [`132cabc`](https://github.com/morluto/rea/commit/132cabc46ab91b6d2b321e292f3d5a6e344ea7eb) Merge upstream/main into docs/zh-readme-linux-procps - [`5d2baaf`](https://github.com/morluto/rea/commit/5d2baaf1f14f5f242ed21e4f773c3d69700e54eb) Merge upstream/main into docs/zh-readme-linux-procps - [`7d2a62f`](https://github.com/morluto/rea/commit/7d2a62fcb7e3c6912a1f8b52105b4bf4dca86c2d) Merge upstream/main into docs/zh-readme-linux-procps - [`259f2fa`](https://github.com/morluto/rea/commit/259f2faf747f03199b78c335396a0ca35e2db131) Merge upstream/main into docs/zh-readme-linux-procps - [`cdd5e8b`](https://github.com/morluto/rea/commit/cdd5e8bee5433df80065ef72d29bf83bf8a7d372) Merge upstream/main into docs/zh-readme-linux-procps - [`53aeed0`](https://github.com/morluto/rea/commit/53aeed0521d090aa1233a727e121412f01f300de) docs(readme): narrow zh README to remaining gaps vs main ### 📊 Changes **1 file changed** (+16 additions, -14 deletions) <details> <summary>View changed files</summary> 📝 `docs/readme/README_zh.md` (+16 -14) </details> ### 📄 Description ## Summary The Simplified Chinese README (`docs/readme/README_zh.md`) had fallen behind `README.md` on several user-facing facts. Most importantly, it did not mention that Linux needs a procps-compatible `ps` on REA's `PATH` (added to the English README in "docs(installation): document Linux procps prerequisite"), so Chinese readers on Linux could hit the owned-process check failure without any hint. This PR syncs only substantive content; no cosmetic rewording. ## Problem and expected behavior A reader following `README_zh.md` on Linux was missing a required prerequisite and several capability/requirement rows present in `README.md`. Expected: the translation states the same prerequisites, rows, and provider notes as the English README. ## Change and scope Each change mirrors a line in `README.md`: - Quick start: Linux procps-compatible `ps` requirement for Ghidra, JADX, firmware tools, and static JavaScript/Electron analysis (README.md lines 67–70). - "What you can analyze" table: JavaScript/Electron row gains the Linux `ps` requirement; Rust row translated (was left in English) and reordered after Go; new SQLite row; Fiddler Everywhere SAZ in saved network captures; packet-summaries row renamed and marked Linux-verified, placed after packet captures; .NET requirement reads "none (static inspection only)". - Paragraph on caller-provided GNU objdump and Rizin after the table; the duplicate top-nav link to that guide is removed, matching the English nav line. - Provider paragraph: optional native IDA MCP bridge and `REA_GHIDRA_STARTUP_TIMEOUT_MS` / `REA_HOPPER_STARTUP_TIMEOUT_MS`. - Hopper FAQ: finish the macOS first-run prompt in the same user session before the first CLI/MCP operation or unattended task. - Troubleshooting FAQ: `rea update` applies to CLIs installed with `npm install --global` or `bun add --global`. Commands blocks and version numbers are unchanged. Not included: other translations. Follow the [contribution scope](https://github.com/morluto/rea/blob/main/CONTRIBUTING.md#contribution-scope). Ordinary documentation fix within existing boundaries; scope decision not applicable. ## Contract and boundary impact - Semantic owner and earliest changed stage: documentation (`docs/readme/README_zh.md`) only. - Contribution scope fit and linked maintainer decision: documentation correction; not applicable. - CLI and MCP/tool-catalog contract: none. - Provider, bridge, target-format, or platform compatibility: none. - Evidence, artifact, provenance, or reconstruction contract: none. - Target selection, authority, upstream behavior, and cleanup details (if applicable): not applicable. - Generated metadata (`docs/public/product-catalog.json`), package, or installation impact: none; no generated files committed. - [ ] Read existing files or captured data. - [ ] Launch or attach to a process. - [ ] Inject instrumentation or run scripts/code. - [ ] Change process memory, registers, files, or configuration. - [ ] Contact network services. - [ ] Recover protected code or work around protections. - [x] Documentation or usability only; no target interaction. - [ ] Not sure yet; investigation or maintainer guidance needed. ## Evidence and regression coverage Executed locally on Linux x64, Node.js 22.20.0, base `f353474`, after `npm ci --ignore-scripts`, `npm run build`, and `npm run docs:generate`: - `npx vitest run tests/conformance/readmeConsistency.test.ts tests/boundary/filesystem/productCatalog.test.ts`: 15 passed, 1 failed. The failing case, `canonical product catalog drift > keeps translated readmes linked to canonical setup and tool details` (expects `https://rea.tools/zh-CN/guides/native/`), fails identically on the unmodified base checkout, so it is pre-existing and not caused by this change. - Link check using the `docs-facts.mjs` normalization: 90 links in each README, 0 link-target differences, all 60 relative file targets exist; `bash` blocks identical to `README.md`. - `npx prettier --check docs/readme/README_zh.md`: passes. - Tests added or updated: none (documentation-only). - Unavailable coverage: full `npm run docs:check` / CI suite not run locally. ## Author readiness  Human owner: @MbappeWU - [x] I reviewed the final diff and relevant existing code, understand the change and its edge cases, and take responsibility for the complete PR, including AI-assisted work. - [x] I checked the evidence above, confirmed it supports the current change, and recorded meaningful validation gaps. - [x] I declare this PR ready for initial maintainer review. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi added the

pull-request

label

2026-10-31 01:08:06 +00:00

bsakaguchi referenced this issue

2026-11-01 21:44:39 +00:00

[PR #5633] [MERGED] fix(errors): name fixed allowances in resource-constraint recovery #7007

No Branch/Tag specified

main

codex/procedure-reference-stacked

release-please--branches--main--components--rea-agents

release-please--branches--main--components--rea-agents--release-notes

codex/kuna-independent-retry

codex/byte-search-overlay-coverage

codex/open-failure-target-receipt

codex/kuna-xref-evidence

codex/ghidra-ambiguous-procedure-recovery

codex/function-source-bundle

codex/trace-function-integration-prototype

codex/snapshot-source-closure

codex/recorded-evidence-array-pages

codex/evidence-recovery-redesign

codex/trace-feature-address-scope

codex/call-discovery-scope

codex/ghidra-literal-candidate-evidence

codex/decompile-directory-independent-retry

codex/retry-provenance-base

codex/value-flow-capability-experiment

codex/ghidra-containing-instruction

cursor/readme-discord-button-ef9f

dependabot/github_actions/actions/setup-node-7.1.0

dependabot/github_actions/actions/upload-artifact-7.0.2

dependabot/npm_and_yarn/npm-minor-and-patch-d8d97ce6df

codex/kuna-1989

fix/8559-native-ui-fixture-ownership

fix/8555-go-verifier-mcp-ownership

codex/provider-capability-recovery

fix/8642-rizin-target-stdin

codex/ghidra-memory-effect-scope

codex/ghidra-annotation-entry-selector

codex/ghidra-readonly-recovery

codex/ghidra-regex-verifier-recovery

codex/evidence-discovery-view-guidance

fix/8545-bulk-append-overflow

fix/8428-navigation-refusal-alternatives

codex/address-context-recovery

codex/matching-member-limitations

codex/unknown-scope-contract

codex/evidence-view-guidance

feat/8373-native-trace-views

codex/ghidra-snapshot-verifier-binding

codex/elf-export-visibility

codex/evidence-view-recovery

codex/native-reference-cli-help

codex/provider-candidate-observation-scope

codex/kuna-session-verification

codex/ghidra-switch-lifetime-guidance

codex/pseudocode-paging-discovery

codex/clarify-evidence-view-support

codex/kuna-xrefs-selector-recovery

codex/context-capacity-recovery

codex/evidence-closure-large-links

codex/same-function-evidence-identity

codex/ghidra-verifier-inspected-jdk

codex/audit-guided-workflows

codex/crash-prompt-retained-dossiers

codex/analysis-view-error-recovery

codex/kuna-verifier-target-selection

codex/ghidra-selected-project-call-coverage

codex/docs-native-analysis-scope

codex/ghidra-java-socket-boundary

codex/ghidra-retained-snapshot-verifier

codex/ghidra-search-inventory-facts

fix/8284-zero-argument-parameter-bindings

fix/8198-ui-action-handler-offset

fix/8257-elf-entry-label-identity

fix/8304-deferred-output-schema-projection

fix/8277-call-path-computed-target-uncertainty

fix/pr-8089-conflicts

fix/ci-static-duplicate-export

dependabot/npm_and_yarn/lint-staged-17.6.0

dependabot/github_actions/actions/download-artifact-8.0.2

dependabot/npm_and_yarn/write-file-atomic-8.0.0

dependabot/npm_and_yarn/canonicalize-5.1.0

dependabot/github_actions/actions/cache/restore-6.1.0

dependabot/npm_and_yarn/toon-format/toon-4.4.0

dependabot/github_actions/actions/deploy-pages-5.0.1

codex/review-fixes-pr-2403

codex/review-fixes-pr-2400

codex/process-terminal-width

codex/test-brittleness-cleanup

verify/7167-browser-connect-macos

fix/7167-browser-connect

feat/native-matching-allowance-setting

feat/browser-scenario-dry-run

test/managed-caller-parameters-20261024

codex/parser-fortythird-boundaries

fix/6926-pinvoke-platform-decorations-20261023

fix/6889-har-body-encoding-20261023

fix/6888-sqlite-schema-budget-20261023

fix/dependency-security-gates-6708

cursor/evidence-overwrite-rebase-b4ac

feat/4057-verify-native-exports

fix/windows-acl-observer-overhead-20261022

cursor/erlang-beam-restack-4476

cursor/pe-certificate-review-bf32

fix/6116-javascript-application-fs-errors

fix/6061-unmapped-runtime-script-unknown

feat/browser-scenario-summary

fix/pe-certificates

codex/verify-3407

cursor/rebase-5699

cursor/rebase-5352

cursor/rebase-5600

cursor/fix-cli-schema-omission-10a8

codex/audit-hopper-shutdown-reasons-20261021

fix/demangle-swift-omitted-record

fix/nib-boolean-value-types

cursor/cancellation-partial-observation-a5ac

fix/ib-object-limit-reasons

fix/electron-fuse-limit-advice

fix/kuna-doctor-dangling-cache

fix/fixed-budget-refusal-advice

fix/js-ipc-listener-dedup

fix/js-return-member-provenance

fix/dmg-integrity-retry-advice

fix/ida-doctor-readiness

fix/kuna-version-probe-output-drain

fix/legacy-swift-runtime-name-matching

fix/dylib-lazy-load-commands

fix/browser-scenario-startup-cancel

fix/swift-nested-punycode-classification

fix/compare-unselected-scopes

fix/objc-method-budget-coverage

fix/dmg-mounted-root-observations

audit/ci-tests-20261019-round2

release/6.7.0

fix/wabt-cleanup-retry-resolution

fix/electron-fuse-elf-pe-architecture

fix/native-plist-descriptor-ownership

fix/kuna-caller-cleanup-ownership

experiment/atomic-codemode-20261016

review/first-contributor-3776

fix/call-resolution-full-read-cycles

fix/member-mutation-selection-repeat

experiment/atomic-re-tools-20261015

perf/member-mutation-lazy-origins

perf/static-network-mutation-index

fix/hopper-startup-lifecycle

audit/3050-windows-proof-20261015

feat/windows-window-capture-2183

audit/3049-windows-proof-20261015

audit/3735-macos-fixtures-20261015

fix/batch-decompile-null-pseudocode

fix/kuna-inventory-honors-jobs

experiment/browser-codemode-tool-design-20261015

fix/hopper-clean-runtime-argv

codex/review-2049-27f1b367

review-fixes/pr-2787-routing

fix/3360-scoped-this-emitters

fix/3367-replaced-global-effects

fix/3838-compact-any-value-items

test/hopper-download-probe-20261015

codex/windows-runtime-creation-red-green-20261015

codex/windows-readonly-root-red-green-20261015

codex/windows-root-share-red-green-20261015

codex/exp-1685-win-mcp-startup

codex/bug-sweep-20261015

investigate/2190-windows-package-phases

investigate/3543-macos-cli-deadline

perf/3281-reverse-tools-feedback-quality

fix/3406-hopper-doctor-fixture

fix/3341-wrapper-require-test-context

fix/3301-owned-uninstall-fixtures

fix/3164-compiler-input-ownership

fix/pcap-cleanup-stdout-newline-20261014

perf/interface-builder-summary

codex/review-fixes-pr-1977

fix/ghidra-effective-jvm-platform

fix/docs-turkish-rust-link-20261013

fix/main-maintenance-ci-20261010

fix/recover-binary-session-process-effects

codex/review-fixes-pr-2457

codex/ci-required-cancellation-gate

fix/main-format-baseline-20261013

fix/setup-preserve-entry-fields

cursor/restore-main-checks-1ffc

fix/ghidra-bridge-hashmap-import

codex/shared-ci-jadx-json-default-20261013

codex/shared-ci-ghidra-test-groups-20261013

codex/shared-ci-java-fixture-format-20261013

codex/fix-intrinsic-invocation-boundaries

test/release-preflight-reusable-jobs

test/js-parameter-provenance-expectation

fix/linux-hopper-verification-current

test/2419-ghidra-elf-probe-size

followup/pr-1544-native-ida

codex/fold-pr-2230-contribution

docs/readme-responsible-use

fix/issue-2064

fix/issue-2050

fix/issue-2053

fix/issue-1968

fix/issue-1945

experiment/codemode-bridge-20261011

fix/tool-effects-negative-wording-1904-20261012

fix/1842-electron-interop-provenance

feat/recover-javascript-multi-input

refactor/website-i18n-prep

fix/nativeaot-pe-virtual-extent

fix/browser-verifier-ci-hang

fix/pe-resources-input-selection

docs/beginner-friendly-guides

docs/beginner-setup-guide

fix/javascript-analysis-worker-1563

fix/1649-ghidra-duplicate-names

fix/javascript-export-keys-integration-1369

test/maintenance-boundary-contracts-20261011

review/javascript-export-keys-1369

review/process-live-progress-1483

test/javascript-1495-growth-ratio

fix/ci-escape-timing

docs/normalized-terminal-geometry-1450

release/6.3.0

archive/release-6.3.0-pr1381

release/6.2.0

fix/electron-preload-dynamic-override

fix/javascript-self-referential-bundler-edges

release/6.1.0

cursor/grok-client-cherry-pick-0b56

feat/signature-posture

feat/dyld-shared-cache

feat/artifact-integrity-policy

feat/pkg-inventory

release/6.0.0

chore/sync-release-5.0.0

release/5.0.0

cursor/cloud-agent-node-787e

fix/javascript-xhr-open-endpoints

review/pr-711-realpath-fallback-wording

cleanup/replay-confinement

codex/test-suite-performance

codex/issue-foundations

codex/address-open-issues-2026-07-20

agent/javascript-vite-rollup-esbuild-adapters

agent/process-cleanup

agent/triage-integration

agent/unknown-commands-registry

feat/mcp-identity-metadata

morlvps/issue_cleanup

codex/installer-redesign

morl/roadmap-investigation-core

morl/roadmap-investigation-docs

release-please--branches--main--components--rea

rea-agents-6.8.0

rea-agents-6.7.0

rea-agents-6.6.0

experiment/atomic-codemode-wait-runtime-20261016

rea-agents-6.5.0

rea-agents-6.4.0

rea-agents-6.3.0

rea-agents-6.2.0

rea-agents-6.1.0

rea-agents-6.0.0

rea-agents-5.0.0

rea-agents-4.1.0

rea-agents-4.0.1

rea-agents-4.0.0

rea-agents-3.2.1

rea-agents-3.2.0

rea-agents-3.1.0

rea-agents-3.0.0

rea-agents-2.7.0

rea-agents-2.6.0

rea-agents-2.5.1

rea-agents-2.5.0

rea-agents-2.4.0

rea-agents-2.3.0

rea-agents-2.2.0

rea-agents-2.1.0

rea-agents-2.0.0

rea-agents-1.7.0

rea-agents-1.6.0

rea-agents-1.5.0

rea-agents-1.4.0

rea-agents-1.3.0

rea-agents-1.2.0

rea-agents-1.1.0

rea-agents-1.0.0

rea-agents-0.5.0

rea-agents-0.4.0

rea-agents-0.3.0

rea-0.2.1

rea-0.2.0

Labels

Clear labels

Mirrored from GitHub Pull Request

No labels

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

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#5628

Reference in a new issue

Repository

morluto/rea

Title

Body

No description provided.

Delete branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?

Rows
Columns