graph TD subgraph "Entry Points" CLI["src/cli.ts
One-shot CLI adapter
setup, diagnostics, analysis, decompilation"] MAIN["src/main.ts
MCP stdio server adapter
config, session, process lifetime"] DISPATCH["scripts/rea.mjs
Executable dispatcher
routes mcp / one-shot"] end subgraph "Adapters" SERVER["src/server/
MCP request translation
createServer, tool registration, toolResult"] HOPPER_BRIDGE["bridge/hopper_bridge.py
Runs inside Hopper
adapts operations to Hopper Python API"] GHIDRA_BRIDGE["bridge/ghidra/ReaGhidraBridge.java
Packaged HeadlessScript
inventory, decompiler, references, CFG"] INSTALL["Host installation adapters
macOS: verified vendor DMG to ~/Applications
Linux: verified vendor package + apt/dnf/pacman"] end subgraph "Application Layer" APP["src/application/
Shared CLI/MCP workflows
enhanced analysis and investigations"] SESSION["SessionProviderRouter + BinarySession
one immutable deep binding per target
disjoint auxiliary routing"] REGISTRY["AnalysisProviderRegistry
sorted deep candidates
deterministic selection, no fallback"] JS_RECON["JavaScript artifact reconstruction
directory/ASAR reads
AST-only bundle projection"] end subgraph "Provider Layers" HOPPER["src/hopper/
Hopper launch & Unix-socket protocol
BridgeLauncher, HopperClient, protocol"] GHIDRA["src/ghidra/
Ghidra discovery, profile & function analysis
snapshot, Unix/Windows transport, bounded lifecycle"] AUX["src/artifacts/ + src/native/
disjoint artifact and native capabilities"] BROWSER["src/browser/
Loopback CDP transport
exact-origin passive observation"] DOTNET["src/dotnet/
Managed static metadata provider
PE/CLI metadata inventory, members, IL"] REFERENCE["src/reference/
Filesystem reference-source reader
bounded traversal, validation, errors"] end subgraph "Provider Process Foundation" PROCESS["src/process/
owned process groups, private roots
deadlines, bounded file reads and diagnostics, cleanup"] end subgraph "Contracts Layer" CONTRACTS["src/contracts/
Caller-visible schemas for analysis, managed, browser, Electron, application, and session tools"] ERRORS["src/contracts/errorSchemas.ts
Shared analysis error schemas
CLI diagnostics, generated error catalog"] end subgraph "Domain Layer" DOMAIN["src/domain/
Pure side-effect-free modules
evidence, comparisons, application graphs"] end subgraph "Configuration" CONFIG["src/config.ts
Zod-validated env parsing
provider settings and origins"] end subgraph "Tests" TESTS["tests/
Vitest suite
fixtures/ holds fake launcher, bridge, and CDP seams"] end subgraph "Evaluation" EVALUATION["src/evaluation/
Agent release evaluation
session transcript scoring"] end DISPATCH --> CLI DISPATCH --> MAIN MAIN --> CONFIG MAIN --> SERVER MAIN --> APP CLI --> APP CLI --> ERRORS APP --> SESSION SESSION --> REGISTRY REGISTRY --> HOPPER REGISTRY --> GHIDRA SESSION --> AUX APP --> JS_RECON APP --> INSTALL SERVER --> CONTRACTS SERVER --> APP APP --> BROWSER APP --> DOTNET DOTNET --> DOMAIN HOPPER --> HOPPER_BRIDGE GHIDRA --> GHIDRA_BRIDGE HOPPER --> PROCESS GHIDRA --> PROCESS APP --> PROCESS APP --> DOMAIN JS_RECON --> AUX JS_RECON --> DOMAIN APP --> REFERENCE REFERENCE --> DOMAIN CONTRACTS --> DOMAIN HOPPER --> DOMAIN GHIDRA --> DOMAIN AUX --> DOMAIN BROWSER --> DOMAIN PROCESS --> DOMAIN TESTS -.-> MAIN TESTS -.-> HOPPER TESTS -.-> GHIDRA TESTS -.-> PROCESS TESTS -.-> BROWSER TESTS -.-> EVALUATION TESTS -.-> ERRORS