mirror of
https://github.com/morluto/rea.git
synced 2026-11-18 20:53:00 +00:00
* fix(cutter): explain empty discovery when Cutter 2.5.0 rejects the plugin Official Cutter 2.5.0 builds have been observed to reject Python plugins at startup, including Cutter's own sample plugin and REA's bridge (rizinorg/cutter#3659). No session is published, and list_cutter_sessions returns no_live_bridge_found with nothing pointing at the Cutter release. The list_cutter_sessions contract now says what no_live_bridge_found means and names the observed 2.5.0 rejection. The Cutter bridge docs describe installing the plugin, the startup log lines Cutter prints when it rejects it, and that 2.4.1 loaded the bridge in the reported check. A minimal independent plugin fails the same way, so the bridge itself is unchanged. Refs #10299 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * fix(cutter): report empty-discovery causes in the shared result The guidance lived only in the MCP tool description, which `rea list-cutter-sessions` never shows. The docs also assumed a known package folder, which npx installations do not have. The discovery result now carries limitations, owned by cutterDiscoveryLimitations in the domain. For no_live_bridge_found they list the causes discovery cannot tell apart, including the observed Cutter 2.5.0 Python-plugin rejection (rizinorg/cutter#3659). CLI and MCP project the same text, and the tool description returns to its previous wording. The docs now take the plugin from the published package of the matching version with npm pack. Refs #10299 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * fix(cutter): name failed status probes among no-live causes no_live_bridge_found also covers a published session whose status probe fails: a stale descriptor after Cutter exited, an unresponsive bridge, or an incompatible bridge version. The limitation named only process, plugin-loading and directory causes. It now lists these too, and the dead-status-endpoint test asserts that such a discovery carries it. Refs #10299 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * test(cutter): give the finalization discovery fixture its limitations commandFinalizationCancellation builds a Cutter discovery through the list_cutter_sessions output schema, which now requires limitations. CI shard 4 failed all five final-close cases with a ZodError. The fixture now takes the owner's empty limitations for sessions_found. Refs #10299 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * fix(cutter): count unanswered sessions beside found ones When one session answered and another published session failed its status probe, discovery returned sessions_found with no limitation. The partial result looked complete. The client already throws for live ceiling mismatches, so every other descriptor without a session is a failed probe. It now passes that count to cutterDiscoveryLimitations, which reports the unlisted sessions for sessions_found. The stale-descriptor case in cutterBridgeRequestLimit asserts it. Refs #10299 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * fix(cutter): name unpublished bridge sessions among no-live causes When Cutter loads the plugin but the bridge cannot write its session descriptor, for example in an unwritable or full bridge directory, _BridgeServer.run closes the socket without logging. Cutter's log then shows the plugin as loaded, yet discovery finds nothing. The no-live limitation now names that cause and says the bridge does not log it. The Cutter docs say to check the bridge directory when the plugin is loaded but no session appears. Refs #10299 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * fix(cutter): count unreadable descriptors among unlisted sessions The descriptor loader dropped filename-matching candidates it could not read before listSessions counted unanswered sessions, so a found session beside a malformed, oversized, non-private or misnamed descriptor reported no limitation. The loader now returns its unreadable count, and the discovery limitation owner reports it beside failed status probes for both sessions_found and no_live_bridge_found. The no-live text keeps only the causes that leave nothing published; published sessions are now counted. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * fix(cutter): leave session existence unknown for unreadable descriptors A filename-matching candidate the loader could not read does not establish that any session exists: it may be malformed, misnamed or removed while reading. The limitation now counts unreadable descriptor candidates and says whether they describe Cutter sessions is unknown, instead of saying their sessions are not listed. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * chore(mcp): record the list_cutter_sessions limitations in the advertised summary Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Documentation directory
REA documentation is organized by reader task and document owner. This directory
links every authored guide; the site also serves separate
product pages. The VitePress documentation source is this docs/ tree.
Getting started
- Installation and setup
- Client configuration and troubleshooting
- CLI and Evidence
- Guided MCP prompts and completion
Native binaries
- Native binary investigation
- Go binary build metadata
- DWARF compile units
- Offline binary diagnostics
- ELF separate debug files
- ELF and Mach-O initializer functions
- ELF unwind function ranges
- Linux kernel build config
- Recorded crash evidence
- CycloneDX dependencies
- Windows Shell Link shortcuts
- Acquired NTFS metadata and change journals
JavaScript and Electron
- JavaScript Application Graph
- Cross-layer JavaScript application workflows
- JavaScript artifact reconstruction
- JavaScript source recovery
- Passive Node and Electron runtime observation
- JavaScript static/runtime reconciliation
- Electron file-page observation
- V8 code cache inspection
Browser and captured websites
- Website observation with CDP
- Browser scenario contract
- Website runtime source attribution
- Historical web network captures
- HTTP/3 capture lab
- Captured website source locations
- Captured website module relationships
- Captured website scripts and static JavaScript analysis
Android applications
- Static Android APK analysis
- Apktool resource decoding
- ADB device inspection and acquisition
- Flutter build identification
Apple applications
.NET assemblies
Firmware
HarmonyOS packages
WebAssembly
EVM contracts
Databases and recorded packets
Process capture and instrumentation
Signal recordings
Provider setup and formats
- Ghidra provider semantics
- DOS MZ and COM analysis with Ghidra
- Optional NativeAOT metadata recovery
- MIPS ELF analysis through Ghidra
- PSP static ELF analysis through Ghidra
- RISC-V ELF analysis through Ghidra
- Windows Ghidra P0
- Headerless raw-binary analysis with Ghidra
- IDA provider
- JEB instrumentation and analysis
Contracts and evidence
Development and verification
- Settings and recovery
- REA limit inventory
- MCP tool design
- Testing REA
- Client and agent verification
- Reconstruction readiness conformance
- Releasing REA
- REA roadmap
Release migrations
Architecture and authoring
- Architecture map
- Documentation ownership and contribution model
- Feature specifications
- Architectural decision records
Machine-owned documentation
| Path | Owner and update command |
|---|---|
public/product-catalog.json |
Ignored contract projection; npm run docs:generate |
verification/managed-conformance-*.json |
Ignored managed conformance projections; npm run evidence:generate |
error-contract.schema.json |
Tracked schema from contracts; npm run docs:error-schema |
user-visible-errors.csv |
Generated error code and category per domain and provider-owned error case; npm run docs:error-schema |
releases/<version>.contributions.json |
Durable release contribution record; follow the release guide |
assets/ |
Shared authored images referenced by guides |
Do not edit generated catalogs or evidence to change product facts. Change their canonical contracts or producer and regenerate. Historical release records retain the exact commit messages and references from the release they describe.
Additional guides
- Offline API contract inventory
- Bun standalone executables
- Deno compile executables
- Capability composition and ownership
- .NET single-file bundles
- ESP flash images
- U-Boot FIT images
- Measure MCP catalog costs in Codex
- Offline Playwright traces
- Testing lanes and provider verification
- UF2 and DfuSe images
- WeChat mini-program wxapkg archives
- Binary hardening
- Desktop application capture
- Desktop application export
- Desktop application state
- Desktop application tasks
- Desktop build computer
- Desktop build witness
- iNES containers
- Build RL environments with REA
- Agent environments from recorded captures
- Android boot and vendor_boot images
- APK signature schemes
- Android OTA update payloads
- Apple IPS crash reports
- Static analysis in GitHub Actions
- Desktop installation directories
- Flattened devicetree inspection
- Electron fuse state
- ELF note tables
- ELF dependency tables
- Erlang BEAM files
- ESP images
- GameCube DOL analysis through Ghidra
- PowerPC ELF analysis through Ghidra
- Godot PCK archives
- Static CUDA and HIP code objects
- Intel HEX and S-record images
- IL2CPP metadata
- Static JavaScript route inventory
- Linux kernel modules
- Kuna provider
- Maven POM and Gradle module metadata
- Model file declarations
- Match native functions across builds
- Node.js single executable applications
- NuGet packages
- PE Authenticode certificate tables
- PE import and delay-load tables
- PE TLS callbacks and load configuration
- Python packaged applications
- CPython pyc inspection
- Reconstruction coverage
- Release exposure
- Reverse-engineering tool integrations
- Rust binary dependency metadata
- U-Boot legacy uImage containers
- UnityFS AssetBundle archives