Files
Neutron/docs/rea.md
T

3.6 KiB

Local REA and Ghidra

User requirement: use REA for future original-binary investigations, including subagent work. Retain Evidence, addresses and byte cross-checks; document provider limitations explicitly. Supplementary disassembly and runtime probes remain useful when a REA result is incomplete. Ordinary source maintenance needs no REA call.

REA is an analysis dependency, absent from the packaged game's runtime. The installed MCP tools connected successfully and opened a generated EXE copy with the authoritative hash. Native decompilation initially lacked an engine. The project-local CLI setup now works without changing the client's MCP registration.

  • REA6.8.0: existing public scripts/rea.mjs launcher in the user's npm cache.
  • Existing Node24.22.1: configured through ignored .tools/rea.env; the login shell's Node20 cannot load this CLI's zstd imports.
  • Ghidra12.1.4: .tools/ghidra_12.1.4_PUBLIC, from the official pinned release. Download ZIP SHA256 ddac49f903da9d5bac833e5cc79395098b9c33cfd3279be5f31bd00387d2d4db verified before extraction. Its pinned README requires a full JDK21.
  • Full OpenJDK21.0.12.1+1-1~24.04.4: matching Ubuntu JDK/JRE headless packages downloaded with apt and extracted under .tools/java; no system installation. JAVA_HOME is .tools/java/usr/lib/jvm/java-21-openjdk-amd64. The pre-existing system Java21 was runtime-only. Adoptium metadata endpoint returned403; no archive from that endpoint was installed.

scripts/rea.sh reads local launcher settings from ignored .tools/rea.env, sets local GHIDRA_INSTALL_DIR/JAVA_HOME and invokes the public launcher. For another machine set NEUTRON_REA_NODE and NEUTRON_REA_LAUNCHER there, or provide rea on PATH. This environment does not alter the already-running MCP server; native MCP tools need those environment paths when that server next starts. CLI use is already verified. No registration/setup rewrite was performed.

mkdir -p artifacts/rea-copy
cp ../Original/Neutron.exe artifacts/rea-copy/Neutron.exe
scripts/rea.sh decompile "$PWD/artifacts/rea-copy/Neutron.exe" 0x475ca0 \
  --provider ghidra --snapshot "$PWD/artifacts/rea-copy/snapshot.json" \
  --format json --full-output > artifacts/rea-copy/gate.json

Use generated copies and keep complete Evidence with binary/profile identities. For several functions, one local stdio session avoids re-importing the EXE for each query:

python3 tools/binary/rea_decompile_batch.py artifacts/rea-copy/Neutron.exe \
  artifacts/rea-batch-NEW 0x40e050 0x437940 0x479bc0

The output directory must be new. The helper saves each complete reply, exports successful Evidence and closes/snapshots its owned session. A per-function error is retained separately; inspect it before claiming complete coverage. REA's Ghidra bridge needs a local Unix socket, which the default Codex sandbox blocked; the approved local execution allowance worked. This was a host IPC restriction, not an analysis-timeout or engine-install failure. Target executable code is not run by these static operations. Retained primitive queries are not a complete Ghidra database or proof every function is recognized.

Five selected routines were decompiled and cross-checked against existing byte evidence. Fire421FB0 was not recognized as a procedure even with the correct file-offset selector; keep that limitation explicit. Actual Evidence IDs and gameplay interpretation are in checkpoint/control-phase-implementation.md. Logs, readiness errors, complete replies, export bundles and snapshots are under artifacts/uncontrolled-phases/rea/. Temporary native sessions were closed.