rea-mcp 0.1.1__tar.gz

rea_mcp-0.1.1/DISCLAIMER.md

@@ -0,0 +1,58 @@
+# Disclaimer
+
+rea-python is an **unofficial, independent Python port** of [morluto/rea](https://github.com/morluto/rea). It is not affiliated with, sponsored by, or endorsed by the original authors. The original REA project is a TypeScript implementation. This document explains intended use, user responsibilities, and support boundaries; it is modeled on REA's responsible-use guidance.
+
+## Responsible use
+
+rea-python is built for lawful analysis: security research, malware and incident analysis, vulnerability research and coordinated disclosure, CTFs and education, interoperability, software preservation, and debugging or auditing software you own or are authorized to examine.
+
+The project does not support, and will not help with:
+
+- circumventing DRM, license checks, anti-cheat systems or other technical protection measures;
+- developing game cheats or tampering with online services;
+- bypassing authentication, bot protection or access controls on systems you are not authorized to test;
+- copying proprietary software or reproducing its protected code and assets;
+- evading the usage policies or safety measures of AI model providers;
+- reselling or sharing AI accounts or API access.
+
+You are responsible for obtaining any required authorization and for complying with applicable laws, license agreements and terms of service. Reverse engineering may be restricted in your jurisdiction or by the license of the software you analyze.
+
+## User responsibility
+
+Do not use rea-python for unauthorized access or exploitation, credential theft, malicious deployment of malware, unlawful collection or disclosure of data, unauthorized service disruption, or unlawful circumvention of access controls or licensing restrictions. Legitimate security research and malware analysis must remain within the rights and permissions applicable to the work.
+
+You are responsible for your use of rea-python, including commands, configurations, scripts, and actions you direct an AI agent to perform. Establish the legal authority and scope required for the targets, accounts, devices, software, data, and operations involved. Comply with applicable laws, contracts, intellectual-property rights, privacy obligations, and tool licenses.
+
+## Runtime, network, and device operations
+
+Some workflows execute or observe programs, attach to runtime or browser endpoints, capture network traffic, interact with applications, or operate on connected devices. These actions can affect application state, files, accounts, devices, and services. Authorization to inspect an artifact does not necessarily authorize execution, interception, device changes, or interaction with another party's system.
+
+Review the operations you request, including agent-generated plans and scripts, and use an appropriate environment for untrusted targets. You are responsible for protecting credentials, personal data, captured traffic, and investigation artifacts.
+
+## Analysis results and generated output
+
+Decompilation, reconstruction, heuristics, and AI-assisted analysis may be incomplete or incorrect. Results do not guarantee accuracy, completeness, security, compatibility, or legal compliance. Review the underlying evidence and verify consequential conclusions before relying on them. Obtaining source-like output or an analysis report does not grant rights to the original program, its data, or the generated output.
+
+## Third-party tools and licenses
+
+Third-party components and external analysis tools retain their own licenses, copyright notices, and usage conditions. rea-python does not bundle or install these engines; you must legally obtain and be authorized to use them. This includes (non-exhaustively) Ghidra, Hopper, IDA Pro / Hex-Rays, JEB, Rizin/radare2, objdump/binutils, WABT, mitmproxy, Wireshark/tshark, Binwalk, Frida, playwright, pwntools/pwndbg, and adb. rea-python grants no commercial-tool license, key, or activation entitlement. Cracked copies, stolen keys, unauthorized key sharing, and bypassing license restrictions are not authorized. See [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
+
+## Disclaimer of warranty
+
+rea-python is provided **AS IS**, without express or implied warranties, including merchantability, fitness for a particular purpose, and noninfringement, as set out in the [MIT License](LICENSE). You assume the risks of using the software and deciding whether it is suitable for your task.
+
+## Limitation of liability
+
+The warranty and liability provisions of the [MIT License](LICENSE) govern rea-python's authors and copyright holders, subject to applicable law. That license disclaims liability for claims, damages, and other liability arising from or in connection with the software or its use.
+
+## Disclaimer of endorsement
+
+References to third-party projects, products, services, and trademarks (including REA and morluto/rea) identify their work and rea-python's integrations. Credits do not imply affiliation, sponsorship, approval, or endorsement by the named parties. Redistribution, bundling, or hosting by a third party does not by itself imply affiliation with or endorsement by the rea-python project.
+
+## Relationship to software licenses
+
+This document explains intended use, user responsibilities, and community support boundaries. It does not amend the MIT license, impose additional copyright-license conditions, replace upstream licenses, or grant rights to third-party software or targets.
+
+## Versions and distribution channels
+
+The project's position on lawful use and non-endorsement covers all rea-python versions, distribution forms, and platforms, including Git commits, PyPI releases, source checkouts, archives, and redistributed copies. Each copy remains subject to the licenses accompanying that copy.

rea_mcp-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PyREA contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

rea_mcp-0.1.1/MANIFEST.in

@@ -0,0 +1,8 @@
+include README.md
+include LICENSE
+include DISCLAIMER.md
+include THIRD_PARTY_NOTICES.md
+include pyproject.toml
+recursive-include rea_mcp py.typed
+recursive-include skills *
+global-exclude __pycache__ *.py[cod]

rea_mcp-0.1.1/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: rea-mcp
+Version: 0.1.1
+Summary: rea-mcp - reverse engineer anything from your terminal or agent, with one CLI and MCP server.
+Author: rea-mcp contributors
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/kandada/rea-python
+Project-URL: Repository, https://github.com/kandada/rea-python.git
+Project-URL: Issues, https://github.com/kandada/rea-python/issues
+Keywords: reverse-engineering,binary-analysis,agents,cli,mcp-server,model-context-protocol,static-analysis,rea-python,rea_mcp
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Security
+Classifier: Topic :: Software Development :: Disassemblers
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.6
+Requires-Dist: pydantic-settings>=2.2
+Requires-Dist: typer>=0.12
+Requires-Dist: mcp<2,>=1.26
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: hypothesis>=6.100; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Dynamic: license-file
+
+# rea-mcp
+
+**Reverse engineer anything from your terminal or agent — one CLI and one MCP server.**
+
+## Attribution and disclaimer
+
+> This is an unofficial Python port of morluto/rea. The original project is a TypeScript implementation. This port exists because our Python-based AI agent products (aacode, fastclaw) need a native Python integration. Not affiliated with or endorsed by the original authors. Licensed under MIT.
+
+See [DISCLAIMER.md](DISCLAIMER.md) for responsible-use guidance and [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) for dependency and tool notices.
+
+rea-mcp is a provider-neutral reverse-engineering engine that returns traceable, evidence-carrying, reusable results, exposed through a shared CLI and MCP (Model Context Protocol) server. Its design follows the ideas behind [morluto/rea](https://github.com/morluto/rea), including the Evidence model: every result carries its identity, confidence, authority, limitations, and unresolved unknowns, so an AI agent (or a person) can reason honestly instead of trusting a bare answer.
+
+> Status: **alpha (0.1.1)** — static-analysis MVP with built-in static providers, the Evidence model, snapshot caching, and the shared CLI/MCP surface.
+
+## What you can analyze
+
+| Target | What rea-mcp returns | Requires |
+|---|---|---|
+| ELF / PE / Mach-O | Sections, segments, entrypoint, symbols, exports/imports, mitigations | built-in |
+| Go binaries | Embedded compiler version, modules, replacements, build settings | built-in |
+| Rust binaries | cargo-auditable dependency inventory and edges | built-in |
+| .NET assemblies | PE/CLI metadata, member names, per-method IL disassembly | built-in |
+| SQLite databases | Tables, columns, indexes, views, triggers | built-in |
+| Zip / tar / ASAR packages | File inventory and digests | built-in |
+| Android APK | Zip inventory, DEX headers, manifest package facts | built-in |
+| Flutter apps | Dart AOT snapshot fingerprint and URI counts per ABI | built-in |
+| WASM modules | Validation, sections, decoded WAT | built-in (WAT needs WABT) |
+| Property lists | XML/binary plist and NSKeyedArchiver inventory | built-in |
+| HarmonyOS HAP | Package facts and entry hashes | built-in |
+| JavaScript / Electron | Module graph and IPC boundaries (directory or ASAR) | built-in |
+| PE resources | Resource types and counts | built-in |
+| Reference source | Source-tree inventory: files, sizes, digests, languages | built-in |
+| EVM bytecode | Dispatch selectors, arguments, mutability | evmole |
+| Network captures | HAR/SAZ requests, hosts, status | built-in |
+| Live traffic | Capture through a proxy | mitmproxy |
+| Saved captures (pcap) | Protocol hierarchy and endpoints | tshark |
+| Firmware images | Region/signature scan | binwalk |
+| Native disassembly | File/section headers | objdump |
+| Deep native analysis | Overview, functions, pseudocode, xrefs, search | Rizin (rzpipe) |
+| Ghidra | Functions and pseudocode | pyhidra + Ghidra + JDK |
+| Hopper | Overview, functions, pseudocode, xrefs | Hopper + bridge/hopper_bridge.py |
+| IDA / JEB | Endpoint probe | REA_IDA_MCP_URL / REA_JEB_MCP_URL |
+| Frida | Device inventory | frida |
+| Browser | Page observation | playwright + REA_BROWSER_EXECUTABLE |
+| Recorded crashes | Register/signal extraction | REA_PWNTOOLS_PYTHON + pwntools |
+
+External-tool providers are caller-supplied: rea-mcp never installs them and reports an actionable reason when one is missing (`rea-mcp doctor`). Cross-cutting tools: `compare` (Evidence diff), `capture-process` (bounded runtime capture), `doctor` (readiness), `setup`, `update`, and `evidence-export` / `evidence-import` / `inspect-analysis-view` (portable Evidence).
+
+All analysis runs locally. rea-mcp never uploads your target.
+
+## Quick start
+
+```bash
+pip install rea-mcp             # PyPI distribution name is "rea-mcp"
+rea-mcp --help                  # "rea" and "rea-python" are installed as alias commands too
+rea-mcp inspect-binary-layout /path/to/program --json
+```
+
+As an MCP server (stdio) — `rea-mcp`, `rea`, and `rea-python` are interchangeable, as are `python -m rea_mcp`, `python -m rea`, and `python -m rea_python`:
+
+```bash
+rea-mcp mcp     # or: rea mcp   |   rea-python mcp
+rea mcp
+```
+
+## Import names
+
+The implementation package is `rea_mcp`. Compatibility aliases make `import rea` and `import rea_python` resolve to the same module objects, so all three import paths are interchangeable:
+
+```python
+import rea_mcp      # implementation
+import rea          # alias, same objects
+import rea_python   # alias, same objects
+```
+
+## Design principles
+
+1. **Dependencies flow inward**: domain → contracts → providers → application → cli/mcp.
+2. **Evidence first**: observations, derivations, inferences, and unknowns are distinguished.
+3. **Ownership and cleanup**: resources are only cleaned by their owner; failures stay explicit.
+4. **Token-first performance**: summaries, paging, and retained evidence keep agent context small.
+
+## Development
+
+```bash
+python -m venv .venv && . .venv/bin/activate
+pip install -e ".[dev]"
+pytest
+ruff check .
+mypy
+```
+
+## License
+
+MIT. rea-mcp is an independent, unofficial Python port; it is not affiliated with or endorsed by the authors of REA. See [LICENSE](LICENSE) and [DISCLAIMER.md](DISCLAIMER.md).

rea_mcp-0.1.1/README.md

@@ -0,0 +1,95 @@
+# rea-mcp
+
+**Reverse engineer anything from your terminal or agent — one CLI and one MCP server.**
+
+## Attribution and disclaimer
+
+> This is an unofficial Python port of morluto/rea. The original project is a TypeScript implementation. This port exists because our Python-based AI agent products (aacode, fastclaw) need a native Python integration. Not affiliated with or endorsed by the original authors. Licensed under MIT.
+
+See [DISCLAIMER.md](DISCLAIMER.md) for responsible-use guidance and [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) for dependency and tool notices.
+
+rea-mcp is a provider-neutral reverse-engineering engine that returns traceable, evidence-carrying, reusable results, exposed through a shared CLI and MCP (Model Context Protocol) server. Its design follows the ideas behind [morluto/rea](https://github.com/morluto/rea), including the Evidence model: every result carries its identity, confidence, authority, limitations, and unresolved unknowns, so an AI agent (or a person) can reason honestly instead of trusting a bare answer.
+
+> Status: **alpha (0.1.1)** — static-analysis MVP with built-in static providers, the Evidence model, snapshot caching, and the shared CLI/MCP surface.
+
+## What you can analyze
+
+| Target | What rea-mcp returns | Requires |
+|---|---|---|
+| ELF / PE / Mach-O | Sections, segments, entrypoint, symbols, exports/imports, mitigations | built-in |
+| Go binaries | Embedded compiler version, modules, replacements, build settings | built-in |
+| Rust binaries | cargo-auditable dependency inventory and edges | built-in |
+| .NET assemblies | PE/CLI metadata, member names, per-method IL disassembly | built-in |
+| SQLite databases | Tables, columns, indexes, views, triggers | built-in |
+| Zip / tar / ASAR packages | File inventory and digests | built-in |
+| Android APK | Zip inventory, DEX headers, manifest package facts | built-in |
+| Flutter apps | Dart AOT snapshot fingerprint and URI counts per ABI | built-in |
+| WASM modules | Validation, sections, decoded WAT | built-in (WAT needs WABT) |
+| Property lists | XML/binary plist and NSKeyedArchiver inventory | built-in |
+| HarmonyOS HAP | Package facts and entry hashes | built-in |
+| JavaScript / Electron | Module graph and IPC boundaries (directory or ASAR) | built-in |
+| PE resources | Resource types and counts | built-in |
+| Reference source | Source-tree inventory: files, sizes, digests, languages | built-in |
+| EVM bytecode | Dispatch selectors, arguments, mutability | evmole |
+| Network captures | HAR/SAZ requests, hosts, status | built-in |
+| Live traffic | Capture through a proxy | mitmproxy |
+| Saved captures (pcap) | Protocol hierarchy and endpoints | tshark |
+| Firmware images | Region/signature scan | binwalk |
+| Native disassembly | File/section headers | objdump |
+| Deep native analysis | Overview, functions, pseudocode, xrefs, search | Rizin (rzpipe) |
+| Ghidra | Functions and pseudocode | pyhidra + Ghidra + JDK |
+| Hopper | Overview, functions, pseudocode, xrefs | Hopper + bridge/hopper_bridge.py |
+| IDA / JEB | Endpoint probe | REA_IDA_MCP_URL / REA_JEB_MCP_URL |
+| Frida | Device inventory | frida |
+| Browser | Page observation | playwright + REA_BROWSER_EXECUTABLE |
+| Recorded crashes | Register/signal extraction | REA_PWNTOOLS_PYTHON + pwntools |
+
+External-tool providers are caller-supplied: rea-mcp never installs them and reports an actionable reason when one is missing (`rea-mcp doctor`). Cross-cutting tools: `compare` (Evidence diff), `capture-process` (bounded runtime capture), `doctor` (readiness), `setup`, `update`, and `evidence-export` / `evidence-import` / `inspect-analysis-view` (portable Evidence).
+
+All analysis runs locally. rea-mcp never uploads your target.
+
+## Quick start
+
+```bash
+pip install rea-mcp             # PyPI distribution name is "rea-mcp"
+rea-mcp --help                  # "rea" and "rea-python" are installed as alias commands too
+rea-mcp inspect-binary-layout /path/to/program --json
+```
+
+As an MCP server (stdio) — `rea-mcp`, `rea`, and `rea-python` are interchangeable, as are `python -m rea_mcp`, `python -m rea`, and `python -m rea_python`:
+
+```bash
+rea-mcp mcp     # or: rea mcp   |   rea-python mcp
+rea mcp
+```
+
+## Import names
+
+The implementation package is `rea_mcp`. Compatibility aliases make `import rea` and `import rea_python` resolve to the same module objects, so all three import paths are interchangeable:
+
+```python
+import rea_mcp      # implementation
+import rea          # alias, same objects
+import rea_python   # alias, same objects
+```
+
+## Design principles
+
+1. **Dependencies flow inward**: domain → contracts → providers → application → cli/mcp.
+2. **Evidence first**: observations, derivations, inferences, and unknowns are distinguished.
+3. **Ownership and cleanup**: resources are only cleaned by their owner; failures stay explicit.
+4. **Token-first performance**: summaries, paging, and retained evidence keep agent context small.
+
+## Development
+
+```bash
+python -m venv .venv && . .venv/bin/activate
+pip install -e ".[dev]"
+pytest
+ruff check .
+mypy
+```
+
+## License
+
+MIT. rea-mcp is an independent, unofficial Python port; it is not affiliated with or endorsed by the authors of REA. See [LICENSE](LICENSE) and [DISCLAIMER.md](DISCLAIMER.md).

rea_mcp-0.1.1/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,55 @@
+# Third-party notices
+
+rea-python is an independent, unofficial Python port. It is **not affiliated with or endorsed by** the original REA project or any tool vendor. This document lists material third-party components, external tools, and reference projects, and the licenses they are commonly distributed under. It is informational and not exhaustive; the upstream license text and the terms of the copy you hold always govern.
+
+## Reference project
+
+- **morluto/rea** — https://github.com/morluto/rea — original TypeScript implementation whose architecture and concepts rea-python follows (MIT). No REA source code is bundled here; only independently written Python reimplements the same ideas.
+
+## Python runtime dependencies
+
+| Package | License | Role |
+|---|---|---|
+| pydantic | MIT | Schema validation |
+| pydantic-settings | MIT | Environment configuration |
+| typer | MIT | CLI framework |
+| mcp | MIT | Model Context Protocol SDK (server/client) |
+
+## Python development dependencies
+
+| Package | License |
+|---|---|
+| pytest | MIT |
+| pytest-asyncio | Apache-2.0 |
+| pytest-cov | MIT |
+| hypothesis | MPL-2.0 |
+| mypy | MIT |
+| ruff | MIT |
+
+## External engines (caller-supplied; not bundled or installed)
+
+rea-python only launches these when you provide them. Licenses below are the ones commonly reported by their upstream projects; confirm with the version you use.
+
+| Tool | License (typical) | Used for |
+|---|---|---|
+| Ghidra | Apache-2.0 | Deep native analysis (via pyhidra) |
+| Rizin / radare2 | LGPL-3.0 | Native analysis (via rzpipe) |
+| GNU binutils objdump | GPL-3.0 | Native headers/disassembly |
+| WABT | Apache-2.0 | WASM validation / WAT |
+| evmole | MIT | EVM interface inference |
+| mitmproxy | MIT | Live HTTP(S) capture |
+| Wireshark tshark/capinfos | GPL-2.0 | pcap analysis |
+| Binwalk | MIT | Firmware regions |
+| Frida | wxWindows / LGPL-2.1 | Instrumentation |
+| playwright | Apache-2.0 | Browser observation |
+| pwntools / pwndbg | MIT | ELF / recorded crashes |
+| adb (Android platform-tools) | Apache-2.0 | Android devices |
+| Hopper | Proprietary | Native analysis (bring your own) |
+| IDA Pro / Hex-Rays | Proprietary | Native analysis (bring your own) |
+| JEB | Proprietary | Mobile / native analysis (bring your own) |
+
+You must legally obtain and be authorized to use commercial tools under their own licenses. rea-python grants no tool license, key, or activation entitlement. See [DISCLAIMER.md](DISCLAIMER.md) for responsible-use guidance.
+
+## Projects rea-python was built with
+
+Developed for the authors' Python-based AI agent products **aacode** and **fastclaw**.

rea_mcp-0.1.1/pyproject.toml

@@ -0,0 +1,137 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "rea-mcp"
+version = "0.1.1"
+description = "rea-mcp - reverse engineer anything from your terminal or agent, with one CLI and MCP server."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.10"
+authors = [{ name = "rea-mcp contributors" }]
+keywords = [
+    "reverse-engineering",
+    "binary-analysis",
+    "agents",
+    "cli",
+    "mcp-server",
+    "model-context-protocol",
+    "static-analysis",
+    "rea-python",
+    "rea_mcp",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Security",
+    "Topic :: Software Development :: Disassemblers",
+]
+
+dependencies = [
+    "pydantic>=2.6",
+    "pydantic-settings>=2.2",
+    "typer>=0.12",
+    "mcp>=1.26,<2",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "pytest-cov>=5.0",
+    "hypothesis>=6.100",
+    "mypy>=1.10",
+    "ruff>=0.6",
+    "build>=1.2",
+    "twine>=5.0",
+]
+
+[project.scripts]
+rea-mcp = "rea_mcp.main.entry:cli_main"
+rea-python = "rea_mcp.main.entry:cli_main"
+rea = "rea_mcp.main.entry:cli_main"
+
+[project.urls]
+Homepage = "https://github.com/kandada/rea-python"
+Repository = "https://github.com/kandada/rea-python.git"
+Issues = "https://github.com/kandada/rea-python/issues"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["rea*"]
+exclude = ["rea_mcp.tests*", "tests*"]
+
+[tool.setuptools.package-data]
+rea_mcp = ["py.typed"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+asyncio_mode = "auto"
+addopts = "-q"
+pythonpath = ["."]
+markers = [
+    "domain: pure domain unit tests",
+    "contracts: schema contract tests",
+    "providers: provider adapter tests",
+    "application: application workflow tests",
+    "boundary: single production boundary tests",
+    "mcp: MCP transport and tool contract tests",
+    "acceptance: compiled CLI/MCP journey tests",
+    "slow: slow or toolchain-dependent tests",
+    "real_engine: requires a real external engine (named skip when absent)",
+]
+
+[tool.coverage.run]
+branch = true
+source = ["rea_mcp"]
+
+[tool.coverage.report]
+show_missing = true
+exclude_lines = [
+    "pragma: no cover",
+    "raise NotImplementedError",
+    "if TYPE_CHECKING:",
+]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+warn_unused_ignores = true
+disallow_untyped_defs = true
+no_implicit_optional = true
+files = ["rea_mcp"]
+
+# Optional engines are imported lazily and are not hard dependencies. Their
+# absence must not fail type-checking on any host.
+[[tool.mypy.overrides]]
+module = [
+    "playwright",
+    "playwright.*",
+    "frida",
+    "rzpipe",
+    "evmole",
+    "pyhidra",
+    "ghidra.*",
+    "mitmproxy",
+    "mitmproxy.*",
+]
+ignore_missing_imports = true
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+extend-exclude = ["vendor", ".venv", "build", "dist"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM", "C4", "RUF"]
+ignore = ["E501", "B008"]

rea_mcp-0.1.1/rea/__init__.py

@@ -0,0 +1,30 @@
+"""Compatibility alias package for :mod:`rea_mcp`.
+
+``import rea`` exposes the same API as ``import rea_mcp``: every submodule of
+``rea_mcp`` is registered under ``rea.*`` in ``sys.modules`` and the
+first-level packages are attached as attributes. ``rea`` stays a real package so
+``python -m rea`` also works. The implementation lives in ``rea_mcp``.
+"""
+
+from __future__ import annotations
+
+import importlib
+import pkgutil
+import sys
+
+import rea_mcp as _impl
+
+__version__ = _impl.__version__
+__all__ = list(getattr(_impl, "__all__", []))
+
+for _info in pkgutil.walk_packages(_impl.__path__, prefix="rea_mcp."):
+    if _info.name.endswith(".__main__"):
+        continue
+    try:
+        _module = importlib.import_module(_info.name)
+    except Exception:  # pragma: no cover - optional-dependency surface
+        continue
+    _suffix = _info.name[len("rea_mcp.") :]
+    sys.modules.setdefault("rea." + _suffix, _module)
+    if "." not in _suffix:
+        sys.modules[__name__].__dict__[_suffix] = _module

rea_mcp-0.1.1/rea/__main__.py

@@ -0,0 +1,8 @@
+"""``python -m rea`` entry point (alias of ``python -m rea_mcp``)."""
+
+from __future__ import annotations
+
+from rea_mcp.main.entry import cli_main
+
+if __name__ == "__main__":
+    cli_main()

rea_mcp-0.1.1/rea_mcp/__init__.py

@@ -0,0 +1,10 @@
+"""REA-Python - reverse engineer anything from your terminal or agent.
+
+Public package entry point. Import name is ``rea_mcp``; the PyPI distribution is ``rea_mcp``.
+"""
+
+from __future__ import annotations
+
+__all__ = ["__version__"]
+
+__version__ = "0.1.1"

rea_mcp-0.1.1/rea_mcp/__main__.py

@@ -0,0 +1,8 @@
+"""``python -m rea_mcp`` entry point."""
+
+from __future__ import annotations
+
+from .main.entry import cli_main
+
+if __name__ == "__main__":
+    cli_main()

rea_mcp-0.1.1/rea_mcp/application/__init__.py

@@ -0,0 +1 @@
+"""application layer."""