# morluto/rea architecture

> Architecture diagram of the GitHub repository morluto/rea, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/morluto/rea
- Repository: https://github.com/morluto/rea
- Video tour (about a minute): https://gitdiagram.com/morluto/rea/video

## Overview

REA is a local reverse-engineering toolkit exposed through an MCP server and terminal commands. An agent or engineer submits an analysis request; the application routes work to analysis capabilities and returns evidence-backed results. Documented capabilities span static JavaScript/Electron analysis, browser/runtime inspection, and native binary analysis through optional engines. The graph connects only relationships supported by the README or shown source/index references; several capability implementations are unsampled, so those connections are omitted rather than inferred.

Main entry points: [`src/application/reverse/ReverseEngineeringService.ts`](https://github.com/morluto/rea/blob/main/src/application/reverse/ReverseEngineeringService.ts) (Reverse service), [`src/main.ts`](https://github.com/morluto/rea/blob/main/src/main.ts) (MCP server), [`src/cli/reverseEngineeringCommands.ts`](https://github.com/morluto/rea/blob/main/src/cli/reverseEngineeringCommands.ts) (Analysis CLI), [`src/server/serviceToolBindings.ts`](https://github.com/morluto/rea/blob/main/src/server/serviceToolBindings.ts) (Tool bindings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User entry points"]
  node_mcp["MCP server<br/>[main.ts]"]
  node_cli["Analysis CLI"]
end

subgraph group_orchestration["Request orchestration"]
  node_tool_bindings["Tool bindings"]
  node_reverse_service["Reverse service"]
  node_composition["Provider composition"]
  node_tool_contracts["Tool contracts"]
end

subgraph group_analysis["Analysis capabilities"]
  node_javascript["JavaScript analysis"]
  node_browser["Browser scenarios"]
  node_browser_capture["Capture fingerprints"]
  node_ghidra["Ghidra integration"]
  node_hopper["Hopper integration"]
  node_ida["IDA integration"]
  node_kuna["Kuna integration"]
  node_cutter["Cutter integration"]
end

subgraph group_evidence["Results and evidence"]
  node_evidence["Evidence records<br/>[evidence.ts]"]
  node_errors["Analysis errors"]
  node_json["JSON validation<br/>[jsonValue.ts]"]
  node_result["Result type<br/>[result.ts]"]
end

node_agent(("Agent"))
node_engineer(("Terminal user"))

node_agent -->|"requests analysis"| node_mcp
node_engineer -->|"runs commands"| node_cli
node_mcp -.->|"serves tools"| node_tool_bindings
node_cli -->|"uses composition"| node_composition
node_composition -->|"constructs service"| node_reverse_service
node_reverse_service -->|"reports failures"| node_errors
node_reverse_service -.->|"returns evidence"| node_evidence
node_tool_bindings -.->|"binds contracts"| node_tool_contracts
node_agent -.->|"requests inspection"| node_javascript
node_agent -.->|"requests inspection"| node_browser
node_browser -->|"stores capture data"| node_browser_capture
node_agent -.->|"requests analysis"| node_ghidra
node_agent -.->|"requests analysis"| node_hopper
node_agent -.->|"requests analysis"| node_ida
node_agent -.->|"requests analysis"| node_kuna
node_agent -.->|"requests analysis"| node_cutter
node_evidence -->|"validates payloads"| node_json
node_reverse_service -.->|"returns outcomes"| node_result

click node_mcp "https://github.com/morluto/rea/blob/main/src/main.ts"
click node_cli "https://github.com/morluto/rea/blob/main/src/cli/reverseEngineeringCommands.ts"
click node_tool_bindings "https://github.com/morluto/rea/blob/main/src/server/serviceToolBindings.ts"
click node_reverse_service "https://github.com/morluto/rea/blob/main/src/application/reverse/ReverseEngineeringService.ts"
click node_composition "https://github.com/morluto/rea/blob/main/src/composition/reverseEngineering.ts"
click node_tool_contracts "https://github.com/morluto/rea/blob/main/src/contracts/reverseEngineeringToolContracts.ts"
click node_javascript "https://github.com/morluto/rea/blob/main/src/domain/javascript/javascriptRouteScan.ts"
click node_browser "https://github.com/morluto/rea/blob/main/src/browser/PlaywrightScenarioStorage.ts"
click node_browser_capture "https://github.com/morluto/rea/blob/main/src/browser/CdpCaptureStorageFingerprints.ts"
click node_ghidra "https://github.com/morluto/rea/tree/main/src/ghidra"
click node_hopper "https://github.com/morluto/rea/tree/main/src/hopper"
click node_ida "https://github.com/morluto/rea/blob/main/src/ida/IdaSessionClient.ts"
click node_kuna "https://github.com/morluto/rea/blob/main/src/kuna/KunaSessionClient.ts"
click node_cutter "https://github.com/morluto/rea/tree/main/src/cutter"
click node_evidence "https://github.com/morluto/rea/blob/main/src/domain/evidence.ts"
click node_errors "https://github.com/morluto/rea/blob/main/src/domain/analysisErrorBase.ts"
click node_json "https://github.com/morluto/rea/blob/main/src/domain/jsonValue.ts"
click node_result "https://github.com/morluto/rea/blob/main/src/domain/result.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_mcp,node_cli,node_engineer toneBlue
class node_tool_bindings,node_reverse_service,node_composition,node_tool_contracts toneAmber
class node_javascript,node_browser,node_browser_capture,node_ghidra,node_hopper,node_ida,node_kuna,node_cutter toneMint
class node_evidence,node_errors,node_json,node_result toneRose
class node_agent toneIndigo
```

## Components

### User entry points

- [MCP server](https://github.com/morluto/rea/blob/main/src/main.ts): `src/main.ts`
- [Analysis CLI](https://github.com/morluto/rea/blob/main/src/cli/reverseEngineeringCommands.ts): `src/cli/reverseEngineeringCommands.ts`

### Request orchestration

- [Tool bindings](https://github.com/morluto/rea/blob/main/src/server/serviceToolBindings.ts): `src/server/serviceToolBindings.ts`
- [Reverse service](https://github.com/morluto/rea/blob/main/src/application/reverse/ReverseEngineeringService.ts): `src/application/reverse/ReverseEngineeringService.ts`
- [Provider composition](https://github.com/morluto/rea/blob/main/src/composition/reverseEngineering.ts): `src/composition/reverseEngineering.ts`
- [Tool contracts](https://github.com/morluto/rea/blob/main/src/contracts/reverseEngineeringToolContracts.ts): `src/contracts/reverseEngineeringToolContracts.ts`

### Analysis capabilities

- [JavaScript analysis](https://github.com/morluto/rea/blob/main/src/domain/javascript/javascriptRouteScan.ts): `src/domain/javascript/javascriptRouteScan.ts`
- [Browser scenarios](https://github.com/morluto/rea/blob/main/src/browser/PlaywrightScenarioStorage.ts): `src/browser/PlaywrightScenarioStorage.ts`
- [Capture fingerprints](https://github.com/morluto/rea/blob/main/src/browser/CdpCaptureStorageFingerprints.ts): `src/browser/CdpCaptureStorageFingerprints.ts`
- [Ghidra integration](https://github.com/morluto/rea/tree/main/src/ghidra): `src/ghidra`
- [Hopper integration](https://github.com/morluto/rea/tree/main/src/hopper): `src/hopper`
- [IDA integration](https://github.com/morluto/rea/blob/main/src/ida/IdaSessionClient.ts): `src/ida/IdaSessionClient.ts`
- [Kuna integration](https://github.com/morluto/rea/blob/main/src/kuna/KunaSessionClient.ts): `src/kuna/KunaSessionClient.ts`
- [Cutter integration](https://github.com/morluto/rea/tree/main/src/cutter): `src/cutter`

### Results and evidence

- [Evidence records](https://github.com/morluto/rea/blob/main/src/domain/evidence.ts): `src/domain/evidence.ts`
- [Analysis errors](https://github.com/morluto/rea/blob/main/src/domain/analysisErrorBase.ts): `src/domain/analysisErrorBase.ts`
- [JSON validation](https://github.com/morluto/rea/blob/main/src/domain/jsonValue.ts): `src/domain/jsonValue.ts`
- [Result type](https://github.com/morluto/rea/blob/main/src/domain/result.ts): `src/domain/result.ts`

### Other components

- **Agent**
- **Terminal user**

## Connections

- Agent → MCP server: requests analysis (evidence: `README.md`)
- Terminal user → Analysis CLI: runs commands (evidence: `README.md`)
- MCP server → Tool bindings: serves tools
- Analysis CLI → Provider composition: uses composition (evidence: `src/cli/reverseEngineeringCommands.ts`)
- Provider composition → Reverse service: constructs service (evidence: `src/composition/reverseEngineering.ts`)
- Reverse service → Analysis errors: reports failures (evidence: `src/application/reverse/ReverseEngineeringService.ts`)
- Reverse service → Evidence records: returns evidence (evidence: `src/application/reverse/ReverseEngineeringService.ts`)
- Tool bindings → Tool contracts: binds contracts
- Agent → JavaScript analysis: requests inspection
- Agent → Browser scenarios: requests inspection
- Browser scenarios → Capture fingerprints: stores capture data (evidence: `src/browser/CdpCaptureStorageFingerprints.ts`)
- Agent → Ghidra integration: requests analysis
- Agent → Hopper integration: requests analysis
- Agent → IDA integration: requests analysis
- Agent → Kuna integration: requests analysis
- Agent → Cutter integration: requests analysis
- Evidence records → JSON validation: validates payloads (evidence: `src/domain/evidence.ts`)
- Reverse service → Result type: returns outcomes (evidence: `src/application/reverse/ReverseEngineeringService.ts`)
