From aaf81c650e10ad1e5a25dc904d6a1f56c485ebbc Mon Sep 17 00:00:00 2001 From: Roel <314876474+laaielichter@users.noreply.github.com> Date: Mon, 2 Nov 2026 14:25:56 +0100 Subject: [PATCH] docs: refresh README, site and listing metadata for 1.12 (#83) --- .claude-plugin/marketplace.json | 13 +- .claude-plugin/plugin.json | 10 +- .github/ISSUE_TEMPLATE/bug_report.yml | 8 +- .github/ISSUE_TEMPLATE/design_discussion.yml | 4 +- .github/ISSUE_TEMPLATE/documentation.yml | 2 +- .github/ISSUE_TEMPLATE/feature_request.yml | 4 +- .../ISSUE_TEMPLATE/new_format_or_engine.yml | 67 ++++++ .github/ISSUE_TEMPLATE/porting_problem.yml | 75 +++++++ .github/pull_request_template.md | 3 + CITATION.cff | 23 ++ README.md | 204 ++++++++++++------ docs/README.nl.md | 20 ++ package.json | 21 +- port/test/plugin.test.mjs | 21 ++ release-please-config.json | 4 + scripts/verify-mcp-registry-metadata.mjs | 9 + server.json | 4 +- site/README.md | 7 + site/index.html | 100 +++++++-- site/sitemap.xml | 6 + .../conformance/releaseConfiguration.test.ts | 14 ++ 21 files changed, 526 insertions(+), 93 deletions(-) create mode 100644 .github/ISSUE_TEMPLATE/new_format_or_engine.yml create mode 100644 .github/ISSUE_TEMPLATE/porting_problem.yml create mode 100644 CITATION.cff create mode 100644 site/sitemap.xml diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index bd4bf34..b2799bb 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -8,7 +8,18 @@ { "name": "reverseport", "source": "./", - "description": "Reverse engineer anything. Port it anywhere. Recon, decompile and trace apps, games, binaries and websites; rebuild and port them between Godot, Unity, Unreal, three.js and languages." + "description": "Reverse engineer anything. Port it anywhere. Recon, decompile and trace apps, games, binaries and websites; read Godot packs and Unity IL2CPP; compare builds; keep proof cases; and port between Godot, Unity, Unreal, three.js and languages.", + "homepage": "https://laaielichter.github.io/Reverseport/", + "license": "MIT", + "keywords": [ + "reverse-engineering", + "porting", + "godot", + "unity", + "il2cpp", + "ghidra", + "mcp" + ] }, { "name": "stashpad", diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 5da704a..9c9197a 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "reverseport", "version": "1.12.0", - "description": "Reverse engineer anything. Port it anywhere. One MCP server for agents: recon any project, exported game, binary or website (even without files), decompile and trace native, .NET, Android, Electron and web targets with evidence, write clean-room rebuild specs, and port games and code between Godot, Unity, Unreal, three.js and languages with verified parity.", + "description": "Reverse engineer anything. Port it anywhere. One MCP server for agents: recon any project, exported game, binary or website (even without files), read Godot packs and Unity IL2CPP, decompile and trace native, .NET, Android, Electron and web targets with evidence, compare builds, keep proof cases with guard hooks, write clean-room rebuild specs, and port games and code between Godot, Unity, Unreal, three.js and languages with verified parity.", "author": { "name": "ReversePort contributors" }, @@ -11,14 +11,22 @@ "reverse-engineering", "porting", "decompiler", + "binary-analysis", "mcp", "godot", + "gdscript", "unity", + "il2cpp", "unreal", "threejs", + "ghidra", + "ida-pro", "android", "electron", "game-dev", + "game-porting", + "build-diff", + "proof-case", "clean-room" ], "license": "MIT", diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml index f93e9f7..cc22168 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yml +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -1,5 +1,5 @@ name: Bug report -description: Report a reproducible problem in REA +description: Report a reproducible problem in ReversePort title: "[Bug] " labels: - bug @@ -77,9 +77,9 @@ body: - type: input id: rea-version attributes: - label: REA version - description: Use `rea --version` or provide the source revision. - placeholder: 3.1.0 or git revision + label: ReversePort version + description: Use `reverseport --version` or provide the source revision. + placeholder: 1.12.0 or git revision validations: required: true diff --git a/.github/ISSUE_TEMPLATE/design_discussion.yml b/.github/ISSUE_TEMPLATE/design_discussion.yml index 912e18c..05b7b32 100644 --- a/.github/ISSUE_TEMPLATE/design_discussion.yml +++ b/.github/ISSUE_TEMPLATE/design_discussion.yml @@ -1,5 +1,5 @@ name: Design discussion -description: Resolve an REA architecture, provider, or contract question before implementation +description: Resolve a ReversePort architecture, provider, or contract question before implementation title: "[Design] " labels: - enhancement @@ -26,7 +26,7 @@ body: attributes: label: Decision needed description: State the exact question maintainers need to resolve. - placeholder: Should REA ... or ...? + placeholder: Should ReversePort ... or ...? validations: required: true diff --git a/.github/ISSUE_TEMPLATE/documentation.yml b/.github/ISSUE_TEMPLATE/documentation.yml index fa2bc02..9ad3f6c 100644 --- a/.github/ISSUE_TEMPLATE/documentation.yml +++ b/.github/ISSUE_TEMPLATE/documentation.yml @@ -1,5 +1,5 @@ name: Documentation -description: Report unclear, missing, or incorrect REA documentation +description: Report unclear, missing, or incorrect ReversePort documentation title: "[Docs] " labels: - documentation diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml index 7b0767b..a357714 100644 --- a/.github/ISSUE_TEMPLATE/feature_request.yml +++ b/.github/ISSUE_TEMPLATE/feature_request.yml @@ -1,5 +1,5 @@ name: Feature request -description: Propose a focused improvement to REA +description: Propose a focused improvement to ReversePort title: "[Feature] " labels: - enhancement @@ -73,7 +73,7 @@ body: id: alternatives attributes: label: Alternatives considered - description: Describe existing REA operations, upstream tools, or workarounds considered and why they do not meet the need. + description: Describe existing ReversePort tools, upstream tools, or workarounds considered and why they do not meet the need. - type: textarea id: possible-direction diff --git a/.github/ISSUE_TEMPLATE/new_format_or_engine.yml b/.github/ISSUE_TEMPLATE/new_format_or_engine.yml new file mode 100644 index 0000000..beb5a09 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/new_format_or_engine.yml @@ -0,0 +1,67 @@ +name: New format, engine or game library +description: Ask ReversePort to recognise or read a file format, game engine or library it does not know yet +title: "[Format] " +labels: + - enhancement + - format + - triage +body: + - type: markdown + attributes: + value: | + New formats, engines and game libraries are the easiest pull requests to make yourself: + a detector, a fixture and a test. Say if you would like to try, and we will point you to the files. + + - type: checkboxes + id: allowed + attributes: + label: Before submitting + options: + - label: I own the files I describe here, or I am allowed to analyse them. + required: true + - label: This is not about decrypting, cracking or bypassing DRM, anti-cheat or licence checks. + required: true + - label: I searched the open and closed issues for the same format or engine. + required: true + + - type: input + id: name + attributes: + label: Format, engine or library + description: Its name, and the version if it matters. + placeholder: "FMOD sound bank (.fsb), Defold 1.9 build, Bevy 0.15 game, ..." + validations: + required: true + + - type: textarea + id: how-to-recognise + attributes: + label: How to recognise it + description: File names or extensions, magic bytes, a package name in package.json, Cargo.toml or similar, a public spec. + placeholder: | + Starts with the bytes "FSB5". Files end in .fsb. Spec: https://... + validations: + required: true + + - type: textarea + id: example + attributes: + label: An example you may share + description: A link to a small public sample, an open-source game that uses it, or how to make one yourself. Do not attach files you may not share. + + - type: textarea + id: expected + attributes: + label: What ReversePort should report + description: For example the engine and its version in re_scan, or the file list in re_archive. + + - type: dropdown + id: contribute + attributes: + label: Would you like to build it? + options: + - Yes, I would like to make the pull request + - Maybe, with some help + - No, I am only asking + validations: + required: true diff --git a/.github/ISSUE_TEMPLATE/porting_problem.yml b/.github/ISSUE_TEMPLATE/porting_problem.yml new file mode 100644 index 0000000..a81d7fb --- /dev/null +++ b/.github/ISSUE_TEMPLATE/porting_problem.yml @@ -0,0 +1,75 @@ +name: Porting problem +description: A port between engines or languages that behaves differently, misses something or will not finish +title: "[Port] " +labels: + - porting + - triage +body: + - type: markdown + attributes: + value: | + Ports go wrong in small, specific ways: a jump that is lower, a signal that never fires, a scene that loads empty. + The more exact the difference, the faster it can be fixed. Remove private paths and data you may not share. + + - type: checkboxes + id: allowed + attributes: + label: Before submitting + options: + - label: I am porting a project I own or am allowed to port. + required: true + - label: I ran `reverseport doctor` and checked the version with `reverseport --version`. + required: true + + - type: dropdown + id: route + attributes: + label: Route + options: + - Godot → Unity + - Godot → Unreal + - Godot → three.js + - GDScript → Godot C# + - Godot 3 → Godot 4 + - Unity → Godot + - Unity → Unreal + - RPG Maker → Godot + - Language to language + - Other + validations: + required: true + + - type: textarea + id: difference + attributes: + label: What is different + description: What the original does, and what the port does instead. + placeholder: | + Original: the player jumps 3 tiles high. Port: about 2 tiles. + validations: + required: true + + - type: textarea + id: commands + attributes: + label: Commands and output + description: The ReversePort commands or tool calls you ran, with the JSON they returned. Include the `next` line or the error's next step. + render: shell + validations: + required: true + + - type: textarea + id: verify + attributes: + label: port_verify or port_trace result + description: The result of `reverseport verify `, or of port_trace when the port runs but behaves differently. + render: json + + - type: input + id: versions + attributes: + label: Versions + description: ReversePort, Node.js, both engines, and the agent and model that wrote the code. + placeholder: "ReversePort 1.12.0, Node 24.22.1, Godot 4.4 → Unity 6000.0, Claude Code" + validations: + required: true diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index e33ce01..c443478 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -77,3 +77,6 @@ limits, security/privacy/containment implications, and meaningful proof gaps. -- - [ ] Owning docs, contracts, and generated metadata are updated where needed. - [ ] User-visible CLI/MCP changes include representative output. - [ ] I checked the final diff for secrets, unrelated cleanup, and unsupported claims. +- [ ] Commits, this description and the changed files contain no chat or session links. +- [ ] Gift or donation details stay in the READMEs only (not in skills, `llms.txt`, `AGENTS.md`, tool output or the website). +- [ ] The change only helps analyse or port software the user owns or may analyse; nothing decrypts, cracks or bypasses DRM, anti-cheat or licensing. diff --git a/CITATION.cff b/CITATION.cff new file mode 100644 index 0000000..b946e74 --- /dev/null +++ b/CITATION.cff @@ -0,0 +1,23 @@ +cff-version: 1.2.0 +message: "If you use ReversePort in research or teaching, please cite it like this." +type: software +title: "ReversePort" +abstract: >- + Reverse engineering and porting toolkit for AI coding agents: an MCP server, CLI, skills and Claude Code plugin + that read Godot packs, Unity IL2CPP, .NET and native binaries, compare builds, keep proof cases, and port games + between Godot, Unity, Unreal, three.js and languages with parity checks. +authors: + - name: "ReversePort contributors" +version: 1.12.0 # x-release-please-version +license: MIT +repository-code: "https://github.com/laaielichter/reverseport" +url: "https://laaielichter.github.io/Reverseport/" +keywords: + - reverse engineering + - porting + - model context protocol + - AI agents + - Godot + - Unity + - IL2CPP + - decompiler diff --git a/README.md b/README.md index bc3b43f..6865589 100644 --- a/README.md +++ b/README.md @@ -4,14 +4,17 @@ ### Reverse engineer anything. Port it anywhere. -**One CLI and one MCP server that let your coding agent take apart apps, games, binaries and websites — and rebuild them.** +**The reverse-engineering and porting toolkit for AI coding agents.**
+Read Godot packs, Unity IL2CPP, .NET and native binaries, compare builds, keep proof for every claim — and port games +between Godot, Unity, Unreal and three.js with parity checks. [![npm](https://img.shields.io/npm/v/reverseport?style=flat-square&color=1e4f91)](https://www.npmjs.com/package/reverseport) [![npm downloads](https://img.shields.io/npm/dm/reverseport?style=flat-square&color=1e4f91)](https://www.npmjs.com/package/reverseport) [![MCP Registry](https://img.shields.io/badge/MCP_Registry-io.github.laaielichter%2Freverseport-5c4ee5?style=flat-square)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.laaielichter/reverseport) +[![Claude Code plugin](https://img.shields.io/badge/Claude_Code-plugin-d97757?style=flat-square)](#claude-code-plugin) [![MCP tool catalog](https://img.shields.io/badge/MCP-tool_catalog-5c4ee5?style=flat-square)](docs/mcp-contracts.md#generated-catalog) -[![License: MIT](https://img.shields.io/badge/license-MIT-22c55e?style=flat-square)](LICENSE) [![Node.js](https://img.shields.io/badge/Node.js-22.23.4%2B-339933?style=flat-square&logo=nodedotjs&logoColor=white)](docs/installation.md) +[![License: MIT](https://img.shields.io/badge/license-MIT-22c55e?style=flat-square)](LICENSE) ```bash npx reverseport setup @@ -19,9 +22,11 @@ npx reverseport setup Terminal: ReversePort scans Godot's 2D platformer demo, plans a port to Unity with 68 units, copies 38 assets, converts a scene and verifies progress -A real run on Godot's 2D platformer demo, JSON trimmed to the key fields. +A real run on Godot's 2D platformer demo, JSON trimmed to the key fields. Watch the MP4. -[Website](https://laaielichter.github.io/Reverseport/) · [Quick start](#quick-start) · [Every agent](#works-with-every-agent) · [Skills](#skills) · [What it does](#what-it-does) · [How it compares](#how-it-compares) · [FAQ](#faq) · [Changelog](CHANGELOG.md) · [Docs](#documentation) +[Website](https://laaielichter.github.io/Reverseport/) · [Quick start](#quick-start) · [What's new](#whats-new) · [Every agent](#works-with-every-agent) · [Prompts](#prompts-to-try) · [How it compares](#how-it-compares) · [FAQ](#faq) · [Contributing](#contributing) · [Docs](#documentation) + +**English** · [Nederlands](docs/README.nl.md) @@ -33,21 +38,26 @@ unit, verified. No files at all? Give it a name or a store page. ReversePort gives agents one consistent way to do all of that: -- 🔍 **Understand anything** — engine and version of any project or exported game, dependency graphs, scenes, - symbols in 30+ languages, executables, packs and unknown data. JS/TS monorepos (pnpm, Turborepo, Nx, Lerna, Rush, - tsconfig paths, `#imports`, Deno import maps) and Rust workspaces resolve too. No build step, no dependencies. +- 🎮 **Game formats built in** — Godot `.pck` (also inside the `.exe`) and `.gdc`/`.scn`/`.res` back to an editable + project, Unity IL2CPP `global-metadata.dat`, `.unitypackage`, GameMaker, Ren'Py, RPG Maker, Unreal `.pak`, FMOD and + Wwise banks; it also recognises Quake PAK, Doom WAD, XNB and VPK. No engine install needed. +- 🔍 **Understand anything** — engine and version of any project or exported game, dependency graphs, scenes, symbols + in 30+ languages, executables, packs and unknown data. JS/TS monorepos (pnpm, Turborepo, Nx, Lerna, Rush, tsconfig + paths, `#imports`, Deno import maps) and Rust workspaces resolve too. No build step, no dependencies. - 🧠 **Go deep** — decompile, cross-reference and trace native, managed (.NET), Android, Electron/JavaScript, WebAssembly, firmware and browser targets through Ghidra, Hopper, IDA, JADX and more. ReversePort connects to the tools you have installed, drives them and shows the evidence behind every conclusion. -- 🌐 **No files? Still recon** — a name, a store page, a website or a public repo is enough to learn the engine, - stack, file layout and open-source remakes from public sources. -- 🧩 **Rebuild precisely** — turn what you learned into a clean-room rebuild spec: every system, the parameters to - measure on the original, a parity table and a project skeleton with every value as a tunable. -- 🚚 **Port for real** — Godot ⇄ Unity, Godot → Unreal, Godot → three.js, GDScript → C#, or language to language. - Scenes and transforms convert automatically; code is ported by your agent with API maps; `port_verify` proves - nothing was left behind. +- 🔀 **Compare builds** — what changed between build 43 and 44: files, packs and .NET types and methods, biggest + changes first. +- 🧾 **Proof, not guesses** — a proof case ties every claim to saved evidence and keeps unknowns visible. In Claude + Code, guard hooks stop a "done" while a proof case fails its check. +- 🧩 **Rebuild precisely** — no files? A name, a store page or a website is enough for a clean-room rebuild spec: + every system, the parameters to measure, a parity table and a project skeleton. +- 🚚 **Port for real** — Godot ⇄ Unity, Godot → Unreal, Godot → three.js, GDScript → C#, Godot 3 → 4, RPG Maker → + Godot, or language to language. Scenes and transforms convert automatically; code is ported by your agent with API + maps; `port_verify` and `port_trace` prove nothing was left behind and behaviour matches. - 🔒 **Local** — runs on your machine. Targets are only read; output goes to new folders. Nothing is uploaded to an - analysis service and there is no extra API bill. + analysis service, there is no telemetry and no extra API bill. ## Quick start @@ -64,18 +74,21 @@ with backups of existing configuration. Restart your agent afterwards. Setup sup Gemini CLI, GitHub Copilot, OpenCode and [more agents](docs/installation.md#supported-agents); other clients can use [manual MCP registration](docs/installation.md#mcp-registry). -**Claude Code plugin** (instead of setup for Claude Code — includes the server, the porting skills and the -`port-architect` agent; do not use both): +### Claude Code plugin + +Instead of setup for Claude Code — includes the server, the porting skills, the `port-architect` agent and the guard +hooks; do not use both: ```text /plugin marketplace add laaielichter/reverseport /plugin install reverseport@reverseport ``` -The same marketplace also offers the [sister plugins](#sister-tools) `stashpad@reverseport` and +The plugin asks for its settings once (deep-analysis engine on or off, tool list size, workspace folder, your Ghidra +folder). The same marketplace also offers the [sister plugins](#sister-tools) `stashpad@reverseport` and `agentdisk@reverseport`. -**From source:** +### From source ```bash git clone https://github.com/laaielichter/reverseport && cd reverseport @@ -89,21 +102,46 @@ install at all: `node bin/reverseport.mjs scan ./MyGame`. ### 2. Ask your agent ```text -Understand how search works in the Notes app, show me the evidence, and build a similar feature for my project. +What is ./MyGame made with? Show me the evidence, then plan a port to Unity. ``` That's it. The agent picks the tools; you get answers with the evidence behind them. +## What's new + +**1.12** — more formats and game libraries, sturdier big results: + +- More formats recognised: Doom WAD, Quake and Half-Life WAD2/WAD3, XNB (XNA/MonoGame) and Valve VPK, next to Quake + PAK from 1.10. +- `re_scan` recognises melonJS, Kontra, Matter.js, Rapier, cannon-es, Planck.js, Howler.js, Tone.js and React Three + Fiber. +- Monorepos: `pnpm-workspace.yaml` globs, `package.json` `#imports` and Deno import maps. +- Big results always fit the output budget now, also with emoji, file-name keys and very deep results. +- A [Godot → three.js walkthrough](docs/walkthrough-godot-to-threejs.md) where every command was run and the result + builds. + +**1.11** — a new engine and a new protocol: + +- The deep-analysis engine is now [REA](https://github.com/morluto/rea) 6.8. +- MCP 2026-07-28 next to the classic handshake: long calls (a cold Ghidra import, a big port plan) come back as a task + with progress instead of timing out. +- `run_batch` runs up to 20 calls in one, and big results are saved to disk with a resource link. +- `re_compare` shows which .NET types and methods changed between two builds, and the next step. +- The Claude Code plugin has settings instead of environment variables, and an icon. + +Every release is in the [changelog](CHANGELOG.md). + ## Works with every agent Any vendor, any framework, any model size — the same tools through the door that fits: -- **MCP**: `npx -y reverseport@latest setup` configures installed agents; `reverseport connect ` prints the - snippet for any other MCP client (Windsurf, Cline, Continue, Zed, Goose, LM Studio, VS Code…). -- **MCP over HTTP**: `reverseport serve` → `http://127.0.0.1:32147/mcp`. -- **Function calling**: `/api/agent/tools?format=openai-strict|responses|anthropic|gemini`, plus OpenAPI 3.1 at - `/api/openapi.json` for GPT Actions, LangChain, LlamaIndex, Semantic Kernel, CrewAI, AutoGen and n8n. -- **Shell-only agents**: JSON on stdout, errors as JSON on stderr, `reverseport describe `. +| Door | How | +| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| MCP, set up for you | `npx -y reverseport@latest setup` for Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and more | +| MCP, any other client | `reverseport connect ` prints the snippet (Windsurf, Cline, Continue, Zed, Goose, LM Studio, VS Code…) | +| MCP over HTTP | `reverseport serve` → `http://127.0.0.1:32147/mcp` | +| Function calling | `/api/agent/tools?format=openai-strict\|responses\|anthropic\|gemini`, plus OpenAPI 3.1 at `/api/openapi.json` for GPT Actions, LangChain, LlamaIndex, Semantic Kernel, CrewAI, AutoGen, n8n | +| Shell only | JSON on stdout, errors as JSON on stderr, `reverseport describe ` | Built for the agent's circumstances too: @@ -112,14 +150,16 @@ Built for the agent's circumstances too: - **The list fits the agent.** Small or older models use `compact`, large-context agents use `full`, and an agent can switch itself with `set_tool_profile`. - **One error shape everywhere**, with a code, whether retrying helps, and the exact next step. -- **A `next` field wherever there is an obvious next step** (graphs, truncated results, every porting step), with the exact call. +- **A `next` field wherever there is an obvious next step** (graphs, truncated results, every porting step), with the + exact call. - **Big results do not flood the context.** Lists are short by default. Answers over 256 KB are saved to - `~/.reverseport/tool-output/`; the agent gets a short version with the path and an MCP resource link. Slightly wrong input from smaller models is repaired where it is safe. + `~/.reverseport/tool-output/`; the agent gets a short version with the path and an MCP resource link. Slightly + wrong input from smaller models is repaired where it is safe. - **Several steps, one call.** `run_batch` runs up to 20 calls and `select` keeps only the fields the agent needs. The same failing call twice gets a plain "do not repeat it" instead of the same error again. -- **Long work does not time out.** On MCP 2026-07-28 a call still running after a few seconds (a cold Ghidra - import, a big port plan) comes back as a task the client polls, with progress in its status; quick calls answer - directly. Older clients keep the classic handshake on the same server. +- **Long work does not time out.** On MCP 2026-07-28 a call still running after a few seconds comes back as a task + the client polls, with progress in its status; quick calls answer directly. Older clients keep the classic + handshake on the same server. - **Agents are heard.** `share_feedback` leaves a note for the maintainers; it stays on the user's machine until they share it. @@ -154,19 +194,20 @@ the version you have and `reverseport skills get ` prints the matching gui | You ask | ReversePort does | | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | _What is this game made with, and how is it built?_ | `re_scan` → engine + version, languages, entry points, how it starts | +| _I only have the exported Godot game, not the project._ | `re_archive` extracts the .pck, `re_decode` turns .gdc/.scn/.res/project.binary back into an editable project | +| _A Unity IL2CPP game without its C# source._ | `re_il2cpp`: classes, methods and literals from global-metadata.dat, plus a C# skeleton | +| _What changed between build 43 and 44?_ | `re_compare` folder-to-folder, pack-to-pack and .NET types and methods, biggest changes first | +| _Keep this investigation honest — I need to show why._ | `re_case`: evidence → claims that cite it → unknowns → decision → tests → report | | _Map this codebase and write ARCHITECTURE.md._ | `re_graph`, `re_symbols`, `re_report` | | _How do the packages in this Turborepo/pnpm monorepo depend on each other?_ | `re_scan` finds the workspace and its packages; `re_graph` resolves workspace names and tsconfig paths and shows who uses whom | | _Show me how this button on the website is built._ | `capture_web_screenshot` with a `selector`: a cropped image of the element, its HTML and its computed CSS | | _All I have is data.win / an .rpa / a .pak / a .swf / a sound bank / a web build._ | `re_archive`: names, assets and facts out of GameMaker, Ren'Py, Unreal, Flash, FMOD, Wwise, Unity WebGL and Emscripten containers | -| _I only have the exported Godot game, not the project._ | `re_archive` extracts the .pck, `re_decode` turns .gdc/.scn/.res/project.binary back into an editable project | -| _A Unity IL2CPP game without its C# source._ | `re_il2cpp`: classes, methods and literals from global-metadata.dat, plus a C# skeleton | -| _What changed between build 43 and 44?_ | `re_compare` folder-to-folder and pack-to-pack, biggest changes first | | _Why are my Unity materials pink and scripts "missing" after a move?_ | `re_refs`: dangling, duplicate and missing GUIDs, with remap suggestions | | _Get every player-facing string out of this game so we can translate it._ | `re_strings`: .pot/.csv with ids and placeholders; `apply` writes a translated copy | | _Is this GDScript valid for Godot 4.3, or did the model mix in Godot 3?_ | `re_apicheck`: renamed names with replacements, invented members, too-new classes | | _What is in this save file, is it checksummed, and which field is the gold?_ | `re_save`: layers, fields with roles, verified checksums, diff of two saves, schema + SaveData classes | | _Upgrade my Godot 3 game to Godot 4._ | `port_upgrade`: converted copy (renames, @annotations, await, signals, scenes, project.godot) + what needs a human | -| _Decompile the function that saves settings in this app and explain it._ | opens the binary, finds it, decompiles it, shows the evidence | +| _Decompile the function that saves settings in this app and explain it._ | opens the binary in your Ghidra, Hopper or IDA, finds it, decompiles it, shows the evidence | | _How does this Electron app talk to its native side?_ | maps modules, IPC and Electron boundaries | | _What is `` made with? I don't have the files._ | `re_lookup` from public sources: engine with confidence, stack, layout, remakes | | _Rebuild the movement of `` as precisely as possible in Godot._ | `re_blueprint`: systems, parameters to measure, parity table, skeleton | @@ -193,9 +234,10 @@ Agent: re_scan → Godot 4.3, 6 scripts, 5 scenes, main scene main.tscn, autolo | Target | What you get | Needs | | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | | Source projects and exported games | Engine + version (Godot, Unity, Unreal, GameMaker, RPG Maker, Ren'Py, LÖVE, Defold, Bevy, MonoGame, web, Electron, Flutter, .NET, Go, Rust…), dependencies, cycles, scenes, symbols | Nothing | -| Packs and archives | Godot `.pck` (also embedded in the `.exe`), zip/apk/jar, `.unitypackage`, tar.gz, asar — list and extract | Nothing | +| Packs and archives | Godot `.pck` (also embedded in the `.exe`), zip/apk/jar, `.unitypackage`, tar.gz, asar — list and extract; Quake PAK, Doom WAD, XNB, VPK and more recognised | Nothing | +| Unity IL2CPP | Classes, methods and literals from `global-metadata.dat`, plus a C# skeleton | Nothing | | Native binaries | Mach-O, ELF, PE, wasm: functions, pseudocode, strings, xrefs, call paths, layout | Ghidra, Hopper or IDA for decompilation ([setup](docs/installation.md#hopper)) | -| .NET assemblies | Metadata, CIL, native boundaries, build comparisons | Nothing | +| .NET assemblies | Metadata, CIL, native boundaries, type- and method-level build comparisons | Nothing | | Android | Manifest, classes, decompiled methods, references, resources, devices | JADX / Apktool / adb ([guide](docs/android-analysis.md)) | | JavaScript and Electron | Modules, imports, source maps, Electron boundaries, runtime observation | Nothing; a browser for runtime | | Websites | Page, network and runtime evidence; one element by CSS selector (cropped image, HTML, computed CSS); stack fingerprint without files | A browser for runtime | @@ -203,15 +245,17 @@ Agent: re_scan → Godot 4.3, 6 scripts, 5 scenes, main scene main.tscn, autolo ### Rebuild and port -| From → to | Code | Scenes / prefabs | Transforms | Project skeleton | -| -------------------- | -------------------------------- | -------------------------------------------- | ----------- | --------------------------- | -| Godot → **Unity** | agent, with API map | automatic → specs + one-click editor builder | Z-mirror | scene builder script | -| Godot → **Unreal** | agent (.h/.cpp), with API map | automatic → specs (cm, Z-up) | axes + ×100 | .uproject, module, targets | -| Godot → **three.js** | agent (TypeScript), with API map | automatic → TypeScript builder modules | unchanged | Vite + TS + fixed-step loop | -| Godot → **Godot C#** | agent, with API map | automatic (script paths swapped) | unchanged | .csproj, project.godot | -| Unity → **Godot** | agent (GDScript), with API map | automatic → `.tscn` | Z-mirror | project.godot | -| Unity → **Unreal** | agent, with API map | — | axes + ×100 | .uproject, module | -| any → **language** | agent | — | — | — | +| From → to | Code | Scenes / prefabs | Transforms | Project skeleton | +| --------------------- | -------------------------------- | -------------------------------------------- | ----------- | ---------------------------------- | +| Godot → **Unity** | agent, with API map | automatic → specs + one-click editor builder | Z-mirror | scene builder script | +| Godot → **Unreal** | agent (.h/.cpp), with API map | automatic → specs (cm, Z-up) | axes + ×100 | .uproject, module, targets | +| Godot → **three.js** | agent (TypeScript), with API map | automatic → TypeScript builder modules | unchanged | Vite + TS + fixed-step loop | +| Godot → **Godot C#** | agent, with API map | automatic (script paths swapped) | unchanged | .csproj, project.godot | +| Godot 3 → **4** | converted copy | converted | unchanged | project.godot | +| Unity → **Godot** | agent (GDScript), with API map | automatic → `.tscn` | Z-mirror | project.godot | +| Unity → **Unreal** | agent, with API map | — | axes + ×100 | .uproject, module | +| RPG Maker → **Godot** | events run by an interpreter | maps drawn from the tilesets | — | Godot 4 project, database autoload | +| any → **language** | agent | — | — | — | ## CLI @@ -249,22 +293,29 @@ One MCP server (`reverseport mcp`) serves every tool: | `port_upgrade` `port_shader` `port_trace` `port_rpgmaker` | Godot 3 → 4 as a converted copy plus the manual list; shader first drafts; per-tick behaviour traces compared | | `re_case` | proof case: evidence, claims, unknowns, decisions, tests | -Next to these come the deep-analysis tools — `open_binary`, `procedure_pseudo_code`, `xrefs`, `search_strings`, `analyze_javascript_application`, -`inspect_android_package`, `inspect_managed_artifact`, `observe_web_session` and many more. `engine_tools` lists them from the running server, and -`npm run docs:generate` writes the [generated tool catalog](docs/mcp-contracts.md#generated-catalog) with every -contract. The HTTP API +Next to these come the deep-analysis tools — `open_binary`, `procedure_pseudo_code`, `xrefs`, `search_strings`, +`analyze_javascript_application`, `inspect_android_package`, `inspect_managed_artifact`, `observe_web_session` and +many more. `engine_tools` lists them from the running server, and `npm run docs:generate` writes the +[generated tool catalog](docs/mcp-contracts.md#generated-catalog) with every contract. The HTTP API (`reverseport serve`) exposes the same tools in every vendor's format; see [Connect any agent](docs/connect-any-agent.md). ## How it compares -| | ReversePort | A single decompiler MCP server | By hand | -| -------------------------- | ---------------------------------------------------------------- | ------------------------------ | --------------------------- | -| Setup | `npx reverseport setup` for all your agents | One server per tool, per agent | Install and learn each tool | -| Source projects and builds | Engine, version, scenes, packs, diffs, no build needed | Binaries only | Read files yourself | -| Native binaries | Through Ghidra, Hopper or IDA that you have installed | One backend | The tool's own UI | -| Porting | Plan, API maps, scene and asset conversion, `port_verify` | Not part of the job | Rewrite and check by hand | -| Runs | Locally, target read-only | Usually locally | Locally | -| Does not | Crack DRM or anti-cheat, or write ported code without your agent | Port or compare builds | Scale | +| | ReversePort | Disassembler MCP servers (IDA, Ghidra, …) | By hand | +| -------------------------- | ----------------------------------------------------------------- | ----------------------------------------- | --------------------------- | +| Focus | Games, builds and porting, with evidence | One disassembler for one model | Whatever you know | +| Setup | `npx reverseport setup` for all your agents | One server per tool, per agent | Install and learn each tool | +| Source projects and builds | Engine, version, scenes, packs, diffs, no build needed | Binaries only | Read files yourself | +| Game formats | Godot packs, Unity IL2CPP, GameMaker, Ren'Py, Unreal, sound banks | Not part of the job | One tool per format | +| Native binaries | Through the Ghidra, Hopper or IDA that you have installed | Deepest inside their own tool | The tool's own UI | +| Porting | Plan, API maps, scene and asset conversion, `port_verify` | Not part of the job | Rewrite and check by hand | +| Proof | Proof cases and guard hooks | Up to the agent | Your notes | +| Runs | Locally, target read-only | Usually locally | Locally | +| Does not | Crack DRM or anti-cheat, or write ported code without your agent | Port or compare builds | Scale | + +If you live inside IDA or Ghidra all day, a dedicated server for that tool goes deepest there. ReversePort's +deep-analysis engine is [REA](https://github.com/morluto/rea); if you want broad reverse engineering without the game +formats, porting and proof cases, REA itself is a good choice too. ## FAQ @@ -282,14 +333,31 @@ agent, one unit at a time, with an API map for the engine pair; `port_verify` th functions and dormant logic (stub bodies, functions nothing calls, silenced warnings), so a port that "compiles" but does nothing is not reported as done. -**Do I need Ghidra?** Only for decompiling native binaries. Scanning, packs, lookup, blueprints and porting need -nothing extra. +**Do I need Ghidra?** Only for decompiling native binaries. ReversePort finds Ghidra, Hopper or IDA but never installs +them. Scanning, packs, IL2CPP metadata, build diffs, lookup, blueprints and porting need nothing extra. + +**How is this different from REA?** REA is the deep-analysis engine inside ReversePort. ReversePort adds its own +tools on top: game engines and formats, build diffs, proof cases, clean-room blueprints and verified ports between +engines, plus setup for every agent and a Claude Code plugin. **How do I update or remove it?** `reverseport update` updates a global install, and `reverseport uninstall` removes the agent registrations and skill files it added. See [Diagnose, update, and remove](docs/installation.md#diagnose-update-and-remove). **Something broke or is missing.** Open an [issue](https://github.com/laaielichter/reverseport/issues) with the -command and its JSON error. Every error names the next step, so include that line too. +command and its JSON error. Every error names the next step, so include that line too. Questions are welcome in +[Discussions](https://github.com/laaielichter/reverseport/discussions). + +## Contributing + +New formats, engines and game libraries are the easiest first pull requests: a detector, a fixture and a test. Pick a +[good first issue](https://github.com/laaielichter/reverseport/labels/good%20first%20issue) — each one names the +files to touch and says when it is done. Ideas and questions go to +[Discussions](https://github.com/laaielichter/reverseport/discussions). + +Read [CONTRIBUTING.md](CONTRIBUTING.md) and [AGENTS.md](AGENTS.md) for the layout and the checks +(`npm run test:port` for ReversePort's own tools), and the [Code of Conduct](CODE_OF_CONDUCT.md). + +Contributors to ReversePort ## Sister tools @@ -306,8 +374,10 @@ README. ## Responsible use -Only analyse or port software you own or are allowed to analyse. ReversePort does not decrypt, crack or bypass DRM, -anti-cheat or licensing. Read [RESPONSIBLE-USE.md](RESPONSIBLE-USE.md) and the [disclaimer](DISCLAIMER.md). +Only analyse or port software you own or are allowed to analyse. ReversePort is for interoperability, preservation, +learning and moving your own work between engines. It does not decrypt, crack or bypass DRM, anti-cheat or licensing, +and it never sends your targets anywhere. Commercial tools such as IDA and Hopper need your own valid licence. Read +[RESPONSIBLE-USE.md](RESPONSIBLE-USE.md) and the [disclaimer](DISCLAIMER.md). ## Documentation @@ -316,18 +386,24 @@ anti-cheat or licensing. Read [RESPONSIBLE-USE.md](RESPONSIBLE-USE.md) and the [ - [CLI and Evidence](docs/cli.md): commands, provider selection, snapshots, import/export. - [MCP contracts](docs/mcp-contracts.md) and [agent prompts](docs/mcp-prompts.md): tool results, sessions, guided investigations. - [Porting and rebuilds](.agents/skills/reverse-engineer-anything/references/porting-and-rebuilds.md): the recon, rebuild and port workflows. +- [Walkthrough: Godot → three.js](docs/walkthrough-godot-to-threejs.md): a small port, every command run and its output pasted. - [Proof cases, guard hooks and memory](docs/proof-and-memory.md): `re_case`, the Claude Code hooks, the optional Stashpad link and context cost. - [Challenge self-check](bench/README.md): programs with known answers (from rea-lab) and what `re_binary` reveals. - [Rated by agents](AGENT-RATINGS.md): independent agent reviews, round by round, and what is still open. - [Nederlands](docs/README.nl.md) · [AGENTS.md](AGENTS.md) for contributors · [CONTRIBUTING.md](CONTRIBUTING.md) +## Star history + +Star history of ReversePort + ## Credits The deep-analysis engine is based on [REA: Reverse Engineer Anything](https://github.com/morluto/rea) 6.8.0 (MIT). Proof cases are ported from [Digfox](https://github.com/Devaretanmay/digfox) (MIT) and the guard hooks follow [rea-jev](https://github.com/juan-viox/rea-jev) (MIT); the challenge self-check uses [rea-lab](https://github.com/pablodiazjorge/rea-lab)'s generator and oracle (MIT). Third-party components are listed in -[THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md). +[THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md). Thanks to everyone who sent a pull request, such as +[@chinmayee5599](https://github.com/chinmayee5599) for Quake PAK support. ## Support diff --git a/docs/README.nl.md b/docs/README.nl.md index 73b45a7..54a93d6 100644 --- a/docs/README.nl.md +++ b/docs/README.nl.md @@ -46,6 +46,19 @@ Haal het alleen van npm (`reverseport`), uit de MCP Registry (`io.github.laaieli kopieën onder andere namen zijn niet van ons. Er is geen telemetrie: [PRIVACY.md](https://github.com/laaielichter/reverseport/blob/main/PRIVACY.md) noemt de paar keer dat het het netwerk gebruikt. +## Nieuw + +**1.12** — meer formaten en sterkere resultaten: Doom WAD, Quake- en Half-Life-WAD2/WAD3, XNB (XNA/MonoGame) en Valve +VPK worden herkend, naast Quake PAK. `re_scan` kent nu ook melonJS, Kontra, Matter.js, Rapier, cannon-es, Planck.js, +Howler.js, Tone.js en React Three Fiber. Grote resultaten passen altijd binnen het budget. Nieuw is een +[walkthrough van Godot naar three.js](walkthrough-godot-to-threejs.md) waarin elk commando echt is uitgevoerd. + +**1.11** — een nieuwe motor en een nieuw protocol: de diepe analyse draait op REA 6.8. Op MCP 2026-07-28 worden lange +klussen (een koude Ghidra-import, een groot port-plan) een taak met voortgang in plaats van een time-out. `run_batch` +doet tot 20 aanroepen in één keer, en `re_compare` laat zien welke .NET-typen en -methodes veranderd zijn. + +Alles staat in de [changelog](https://github.com/laaielichter/reverseport/blob/main/CHANGELOG.md). + ## Wat het kan - **Verkennen** — `re_scan` herkent engine en versie (Godot, Unity, Unreal, GameMaker, RPG Maker, Ren'Py, LÖVE, @@ -88,6 +101,13 @@ functie die de instellingen opslaat en leg uit wat ze doet.", "Port mijn Godot-g Werkmap: `~/.reverseport` (verplaatsen met `REVERSEPORT_HOME`). Alleen voor eigen software of software die je mag analyseren; ReversePort kraakt, ontsleutelt of omzeilt niets. Licentie: MIT. +## Meehelpen + +Nieuwe formaten, engines en game-bibliotheken zijn de makkelijkste eerste pull request: een detector, een voorbeeld en +een test. Kies een [good first issue](https://github.com/laaielichter/reverseport/labels/good%20first%20issue); elk +issue noemt de bestanden en zegt wanneer het klaar is. Vragen en ideeën kunnen in +[Discussions](https://github.com/laaielichter/reverseport/discussions). + ## Steunen ReversePort is gratis en open source. Bespaart het jou of je agent tijd, dan is een gift welkom, maar nooit verplicht. diff --git a/package.json b/package.json index 69ce69a..364784b 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "reverseport", "mcpName": "io.github.laaielichter/reverseport", "version": "1.12.0", - "description": "Reverse engineer anything. Port it anywhere. One CLI and MCP server that lets coding agents take apart apps, games, binaries and websites — decompile, trace, compare builds, recon without files — and rebuild or port them to Godot, Unity, Unreal, three.js or any language.", + "description": "Reverse engineer anything. Port it anywhere. MCP server, CLI and skills for AI coding agents: read Godot .pck, Unity IL2CPP, .NET and native binaries (through your own Ghidra, IDA or Hopper), compare builds, keep proof for every claim, and port games between Godot, Unity, Unreal, three.js and languages with parity checks.", "license": "MIT", "repository": { "type": "git", @@ -19,10 +19,14 @@ "mcp-server", "model-context-protocol", "agents", + "ai-agents", "agent-skills", "claude-code", + "claude-code-plugin", "codex", "cursor", + "gemini-cli", + "github-copilot", "decompiler", "disassembler", "binary-analysis", @@ -30,15 +34,30 @@ "ghidra", "hopper", "ida", + "ida-pro", + "jadx", "android", "electron", + "dotnet", + "webassembly", "godot", + "godot-engine", + "gdscript", + "godot-pck", "unity", + "unity3d", + "il2cpp", "unreal", + "unreal-engine", "threejs", "game-dev", + "game-development", + "game-engine", + "game-porting", "migration", + "build-diff", "clean-room", + "proof-case", "cli" ], "publishConfig": { diff --git a/port/test/plugin.test.mjs b/port/test/plugin.test.mjs index 9686b08..466137f 100644 --- a/port/test/plugin.test.mjs +++ b/port/test/plugin.test.mjs @@ -42,6 +42,27 @@ test('Claude Code plugin and marketplace manifests', async () => { } }); +test('listing metadata: registry limits, tags, and gift details only in the READMEs', async () => { + // The MCP Registry rejects a whole publish when the description is over 100 characters; catch it before a release. + const server = JSON.parse(await read('server.json')); + assert.ok(server.description.length > 0 && server.description.length <= 100, `server.json description is ${server.description.length} characters`); + const pkg = JSON.parse(await read('package.json')); + const plugin = JSON.parse(await read('.claude-plugin/plugin.json')); + for (const [where, list] of [['package.json', pkg.keywords], ['plugin.json', plugin.keywords]]) { + assert.equal(new Set(list).size, list.length, `${where}: duplicate keywords`); + for (const k of list) assert.match(k, /^[a-z0-9][a-z0-9-]{0,49}$/, `${where}: keyword ${k}`); + } + // Gifts are mentioned in the READMEs only: never in agent-facing files, tool output, skills or the website. + const address = 'BDRA7dHGBYtPsZPNzVQccDYZ8BqstJGCsWx3kopPSCDK'; + const agentFacing = ['llms.txt', 'llms-install.md', 'AGENTS.md', 'site/index.html', '.claude-plugin/plugin.json', '.claude-plugin/marketplace.json', 'server.json', 'CITATION.cff']; + for (const dir of await fs.readdir(path.join(REPO, 'skills'))) agentFacing.push(`skills/${dir}/SKILL.md`); + for (const f of agentFacing) { + const text = await read(f).catch(() => ''); + assert.ok(!text.includes(address) && !/\b(?:donat(?:e|ion)|solana)\b/i.test(text), `${f}: gift details belong in the READMEs only`); + } + for (const f of ['README.md', 'docs/README.nl.md']) assert.ok((await read(f)).includes(address), `${f}: support section`); +}); + test('plugin settings: empty or unsubstituted values are unset; the engine setting fetches the engine', async () => { const { applyPluginSettings } = await import('../plugin/mcp-launch.mjs'); const env = applyPluginSettings({ REVERSEPORT_PLUGIN_ENGINE: 'true', REVERSEPORT_PROFILE: 'compact', REVERSEPORT_HOME: '', GHIDRA_INSTALL_DIR: '${user_config.ghidra_install_dir}' }); diff --git a/release-please-config.json b/release-please-config.json index 024135c..82f9943 100644 --- a/release-please-config.json +++ b/release-please-config.json @@ -75,6 +75,10 @@ "type": "json", "path": ".claude-plugin/plugin.json", "jsonpath": "$.version" + }, + { + "type": "generic", + "path": "CITATION.cff" } ] } diff --git a/scripts/verify-mcp-registry-metadata.mjs b/scripts/verify-mcp-registry-metadata.mjs index 31a88cf..94ba34e 100644 --- a/scripts/verify-mcp-registry-metadata.mjs +++ b/scripts/verify-mcp-registry-metadata.mjs @@ -22,6 +22,15 @@ if (packageJson.mcpName !== "io.github.laaielichter/reverseport") ); if (serverJson.name !== packageJson.mcpName) fail("server.json name does not match package.json mcpName"); +// The registry schema (2025-12-11) caps the description at 100 characters and rejects the whole publish above it. +if ( + typeof serverJson.description !== "string" || + serverJson.description.length === 0 || + serverJson.description.length > 100 +) + fail( + `server.json description must be 1 to 100 characters (is ${serverJson.description?.length ?? 0})`, + ); if (serverJson.version !== packageJson.version) fail("server.json version does not match package.json version"); if (!Array.isArray(serverJson.packages) || serverJson.packages.length !== 1) diff --git a/server.json b/server.json index 93509de..d657a01 100644 --- a/server.json +++ b/server.json @@ -2,8 +2,8 @@ "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json", "name": "io.github.laaielichter/reverseport", "title": "ReversePort", - "description": "Reverse engineer anything. Port it anywhere. One MCP server for coding agents.", - "websiteUrl": "https://github.com/laaielichter/reverseport", + "description": "Reverse engineer and port apps and games: Godot, Unity IL2CPP, .NET, binaries, with parity checks.", + "websiteUrl": "https://laaielichter.github.io/Reverseport/", "repository": { "url": "https://github.com/laaielichter/reverseport", "source": "github" diff --git a/site/README.md b/site/README.md index 0ff01eb..f9b8c6c 100644 --- a/site/README.md +++ b/site/README.md @@ -32,3 +32,10 @@ convert it with ffmpeg. - `og.png` (1280×640) is the sharing image. The same file is `docs/assets/social-preview.png`, for Settings > General > Social preview on GitHub. - `favicon.svg` is the logo mark. + +## Search engines + +`sitemap.xml` lists the page for Google Search Console and Bing Webmaster Tools. The title, description, Open Graph and +Twitter tags and the JSON-LD block in `index.html` are what search results and link previews show; keep them in step +with the README when a release changes what ReversePort does. Gift details stay out of the site (see the README). + diff --git a/site/index.html b/site/index.html index b943782..23e8fd9 100644 --- a/site/index.html +++ b/site/index.html @@ -3,18 +3,30 @@ -ReversePort: reverse engineer anything, port it anywhere - +ReversePort: reverse engineer and port games and apps with your AI agent + + + - - + + + + + + + + + + + + @@ -94,7 +106,7 @@ h1 .second { color: var(--cyan); } } .install button:hover { background: var(--cyan); } .after-install { font-size: 0.95rem; color: var(--muted); margin: 14px 0 0; max-width: 30em; } -.links { display: flex; gap: 22px; margin-top: 28px; font-weight: 600; } +.links { display: flex; flex-wrap: wrap; gap: 10px 22px; margin-top: 28px; font-weight: 600; } /* Terminal (the one loud element) */ .term { @@ -186,6 +198,14 @@ h2 { font-size: clamp(1.8rem, 3.2vw, 2.5rem); line-height: 1.08; letter-spacing: .cards p q { color: var(--ink); quotes: "“" "”"; } .note { color: var(--muted); font-size: 0.97rem; max-width: 44rem; margin: 28px 0 0; } .note code { color: var(--ink); } +/* What's new: two releases side by side */ +.news { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 48px; } +.news h3 { font-size: 1.15rem; margin: 0 0 4px; } +.news .tag { font: 500 0.85rem var(--mono); color: var(--muted); margin: 0 0 14px; } +.news ul { margin: 0; padding-left: 1.1em; } +.news li { margin: 0 0 10px; color: var(--muted); } +.news li strong { color: var(--ink); font-weight: 600; } +.news code { color: var(--ink); } /* Start */ .start ol { margin: 0; padding: 0; list-style: none; counter-reset: s; max-width: 44rem; } .start li { counter-increment: s; display: grid; grid-template-columns: 2.2rem minmax(0, 1fr); gap: 10px; padding: 0 0 26px; } @@ -206,7 +226,7 @@ body.demo-only .demo-stage .term { border-radius: 0; box-shadow: none; font-size body.demo-only .demo-stage .term-body { min-height: 0; height: 676px; } @media (max-width: 900px) { - .hero, .split, .honest, .bytes-grid { grid-template-columns: minmax(0, 1fr); gap: 36px; } + .hero, .split, .honest, .news, .bytes-grid { grid-template-columns: minmax(0, 1fr); gap: 36px; } .hx { grid-template-columns: 3.4em repeat(8, minmax(0, 1fr)); font-size: 12px; } .hx .hx-mid { display: block; } .hero { padding-top: 28px; padding-bottom: 64px; } @@ -234,6 +254,7 @@ body.demo-only .demo-stage .term-body { min-height: 0; height: 676px; } ReversePort