reverseport 0.0.0-stage → 1.2.0

package/package.json

@@ -1,6 +1,373 @@
 {
   "name": "reverseport",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "mcpName": "io.github.laaielichter/reverseport",
+  "version": "1.2.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.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/laaielichter/reverseport.git"
+  },
+  "homepage": "https://github.com/laaielichter/reverseport#readme",
+  "bugs": {
+    "url": "https://github.com/laaielichter/reverseport/issues"
+  },
+  "keywords": [
+    "reverse-engineering",
+    "porting",
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "agents",
+    "agent-skills",
+    "claude-code",
+    "codex",
+    "cursor",
+    "decompiler",
+    "disassembler",
+    "binary-analysis",
+    "static-analysis",
+    "ghidra",
+    "hopper",
+    "ida",
+    "android",
+    "electron",
+    "godot",
+    "unity",
+    "unreal",
+    "threejs",
+    "game-dev",
+    "migration",
+    "clean-room",
+    "cli"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "imports": {
+    "#javascript-analysis-worker": "./dist/composition/javascriptAnalysisWorkerProcess.js"
+  },
+  "bin": {
+    "reverseport": "bin/reverseport.mjs",
+    "rea": "scripts/rea.mjs"
+  },
+  "engines": {
+    "node": "^22.19.0 || ^24.11.0 || >=26.0.0"
+  },
+  "packageManager": "npm@11.16.0",
+  "files": [
+    "dist",
+    "install.sh",
+    "bridge/hopper_bridge.py",
+    "bridge/native/NativeUIChildren.swift",
+    "bridge/native/ReaNativeUI.swift",
+    "bridge/native/rea_lldb_tracer.py",
+    "bridge/process/ProcessRunTokenReader.swift",
+    "bridge/process/ProcessRunTokenReaderMain.swift",
+    "bridge/ghidra/ReaGhidraBridge.java",
+    "bridge/ghidra/ReaGhidraBundleActivator.java",
+    "bridge/ghidra/ReaGhidraExtensions.java",
+    "bridge/ghidra/ReaGhidraPrepareCom.java",
+    "bridge/ghidra/ReaGhidraApplySeeds.java",
+    "bridge/ghidra/ReaGhidraAnalysisOptions.java",
+    "bridge/ghidra/ReaGhidraNoReturnFix.java",
+    "bridge/ghidra/ReaGhidraMipsSoftFloat.java",
+    "bridge/ghidra/ReaGhidraPrepareRaw.java",
+    "bridge/android/ReaJadxBridge.java",
+    "bridge/mitmproxy/capture.py",
+    "bin",
+    "port/cli.mjs",
+    "port/mcp.mjs",
+    "port/server.mjs",
+    "port/src",
+    "port/knowledge",
+    "port/templates",
+    "port/plugin",
+    "port/hooks",
+    "hooks",
+    "RESPONSIBLE-USE.md",
+    "scripts/rea.mjs",
+    "scripts/electron-active-hook.cjs",
+    "scripts/electron-active-hook-boundaries.cjs",
+    "scripts/hopper-demo-x11.py",
+    "scripts/prepack.mjs",
+    "scripts/prepare.mjs",
+    "skills",
+    "README.md",
+    "DISCLAIMER.md",
+    "THIRD_PARTY_NOTICES.md",
+    "LICENSE",
+    "native/windows/build/manifest.json",
+    "native/windows/build/rea-windows-x64.node",
+    "scripts/verify-windows-native-artifact.mjs",
+    "bridge/pwntools/layout.py",
+    "bridge/pwntools/layout_impl.py",
+    "third_party/pwntools/README.md",
+    "third_party/wabt/README.md",
+    "third_party/evmole/README.md",
+    "third_party/evmole/LICENSE",
+    "bridge/pwntools/decoder_runtime.py",
+    "bridge/pwntools/recorded_crash.py",
+    "bridge/pwntools/recorded_crash_impl.py",
+    "bridge/pwndbg/launch.py",
+    "bridge/pwndbg/launch_impl.py",
+    "bridge/pwndbg/core_context.py",
+    "third_party/pwndbg/README.md",
+    "third_party/pwndbg/LICENSE.md",
+    "licenses"
+  ],
+  "scripts": {
+    "release:notes": "node scripts/release-notes.mjs",
+    "deps:check": "node scripts/check-dependency-install.mjs",
+    "metadata:generate": "node scripts/run-exclusive.mjs artifacts node scripts/generate-package-metadata.mjs",
+    "metadata:check": "node scripts/generate-package-metadata.mjs --check",
+    "mcp-registry:check": "node scripts/verify-mcp-registry-metadata.mjs",
+    "mcp-catalog:generate": "node scripts/check-dependency-install.mjs && node scripts/run-exclusive.mjs artifacts turbo run artifacts:mcp-catalog",
+    "mcp-catalog:check": "node scripts/check-dependency-install.mjs && node scripts/run-exclusive.mjs artifacts turbo run mcp-catalog:check:built",
+    "prebuild": "npm run deps:check",
+    "build": "node scripts/run-exclusive.mjs artifacts turbo run artifacts:skills --force",
+    "precheck": "npm run deps:check",
+    "check": "node scripts/run-exclusive.mjs artifacts turbo run typecheck lint:built format:check knip metadata:check && npm run verify:architecture-guards",
+    "precheck:fast": "npm run deps:check",
+    "check:fast": "turbo run typecheck lint --output-logs=errors-only",
+    "precheck:changed": "npm run deps:check",
+    "check:changed": "npm run check:fast && npm run test:changed",
+    "precheck:test": "npm run deps:check",
+    "check:test": "node scripts/run-exclusive.mjs artifacts turbo run typecheck lint:built format:check knip metadata:check test:run",
+    "precheck:pr": "npm run deps:check",
+    "check:pr": "node scripts/run-exclusive.mjs artifacts turbo run typecheck lint:built format:check knip metadata:check test:run && npm run docs:check && npm run jscpd && npm run scan:todos",
+    "precheck:ci": "npm run deps:check",
+    "check:ci": "node scripts/run-exclusive.mjs artifacts turbo run typecheck lint:built format:check knip metadata:check jscpd scan:todos && npm run verify:architecture-guards",
+    "build:cached": "node scripts/check-dependency-install.mjs && node scripts/run-exclusive.mjs artifacts turbo run artifacts:skills",
+    "build:termux": "node scripts/run-exclusive.mjs artifacts npm run build:termux:run",
+    "build:termux:run": "npm run compile:termux && npm run artifacts:skills",
+    "format": "oxfmt .",
+    "format:check": "oxfmt --check .",
+    "lint": "oxlint && npm run verify:module-boundaries",
+    "lint:built": "npm run lint",
+    "lint:fix": "oxlint --fix && npm run verify:module-boundaries",
+    "knip": "knip",
+    "jscpd": "jscpd src/ tests/",
+    "scan:todos": "node scripts/scan-todos.mjs",
+    "start": "node bin/reverseport.mjs mcp",
+    "test": "npm run test:with-build",
+    "test:with-build": "npm run test:prepare && vitest run",
+    "test:run": "vitest run",
+    "test:local": "node scripts/run-development-tests.mjs local",
+    "test:fast": "vitest run --project domain --project services --project adapters --project composition --project conformance --project evaluation",
+    "pretest:boundary": "npm run test:prepare",
+    "test:boundary": "vitest run --project boundary --project cli-boundary --project process-boundary --project mcp-boundary --project process-global",
+    "pretest:mcp": "node scripts/check-dependency-install.mjs && node scripts/run-exclusive.mjs artifacts turbo run artifacts:skills artifacts:mcp-catalog",
+    "test:mcp": "vitest run --project mcp-boundary",
+    "pretest:acceptance": "npm run build:cached",
+    "test:acceptance": "vitest run --project acceptance",
+    "test:changed": "node scripts/run-development-tests.mjs changed",
+    "pretest:integration": "npm run test:prepare",
+    "test:integration": "vitest run --project boundary --project cli-boundary --project process-boundary --project mcp-boundary --project process-global --project acceptance",
+    "pretest:coverage": "npm run test:prepare",
+    "test:coverage": "vitest run --coverage.enabled --coverage.provider=v8",
+    "test:ci": "npm run test:coverage -- --reporter=default --reporter=junit --outputFile.junit=test-results.xml",
+    "pretest:ci:shard": "npm run test:prepare",
+    "test:ci:shard": "npm run test:ci:shard:run",
+    "test:ci:shard:run": "vitest run --coverage.enabled --coverage.provider=v8 --coverage.thresholds.lines=0 --coverage.thresholds.functions=0 --coverage.thresholds.branches=0 --coverage.thresholds.statements=0 --reporter=default --reporter=blob",
+    "test:ci:merge": "vitest --merge-reports --coverage.enabled --coverage.provider=v8",
+    "pretest:verbose": "npm run test:prepare",
+    "test:verbose": "vitest run --reporter=verbose",
+    "test:watch": "vitest --project domain --project services --project adapters --project composition --project conformance --project evaluation --changed",
+    "pretest:watch:all": "npm run test:prepare",
+    "test:watch:all": "vitest --changed",
+    "typecheck": "tsc --noEmit",
+    "verify:test-temp-hygiene": "npm run test:prepare && node scripts/verify-test-temp-hygiene.mjs",
+    "verify:hopper": "npm run verify:fixtures && npm run build:cached && node scripts/verify-real-hopper.mjs",
+    "verify:hopper:deadlines": "npm run verify:fixtures && npm run build:cached && node scripts/verify-real-hopper-deadlines.mjs",
+    "verify:hopper:fat": "npm run build:cached && node scripts/verify-real-hopper-fat.mjs",
+    "verify:hopper:fat64": "npm run build:cached && node scripts/verify-real-hopper-fat.mjs --fat64",
+    "verify:apple-dispatch": "npm run build:cached && node scripts/verify/apple/dispatch.mjs",
+    "verify:native-ui": "npm run build:cached && node scripts/verify-native-ui.mjs",
+    "verify:keyed-archive": "npm run build:cached && node scripts/verify/apple/keyed-archive.mjs",
+    "verify:macos-bundle": "npm run build:cached && node scripts/verify/apple/macos-bundle.mjs",
+    "verify:legacy-simulator": "npm run build:cached && node scripts/verify/apple/legacy-simulator.mjs",
+    "verify:architecture-guards": "node scripts/verify/architecture-guards.mjs",
+    "verify:apktool": "npm run build:cached && node scripts/verify-apktool.mjs",
+    "verify:adb": "npm run build:cached && node scripts/verify-adb.mjs",
+    "verify:ghidra": "npm run build:cached && node scripts/verify-real-ghidra.mjs",
+    "verify:ghidra:seeds": "npm run build:cached && node scripts/verify/ghidra/seeds.mjs",
+    "verify:ghidra:mips": "npm run build:cached && node scripts/verify-real-ghidra-mips.mjs",
+    "verify:ghidra:mips-shared": "npm run build:cached && node scripts/verify-real-ghidra-mips-shared.mjs",
+    "verify:ghidra:mips-relocatable": "npm run build:cached && node scripts/verify-real-ghidra-mips-relocatable.mjs",
+    "verify:ghidra:swift": "npm run build:cached && node scripts/verify-real-ghidra-swift.mjs",
+    "verify:ida": "npm run build:cached && node scripts/verify-real-ida.mjs",
+    "verify:ghidra:switch": "npm run build:cached && node scripts/verify-real-ghidra-switch.mjs",
+    "verify:ghidra:dos": "npm run build:cached && node scripts/verify-real-ghidra-dos.mjs",
+    "verify:ghidra:com": "npm run build:cached && node scripts/verify-real-ghidra-com.mjs",
+    "verify:ghidra:raw": "npm run build:cached && node scripts/verify-real-ghidra-raw.mjs",
+    "verify:ghidra:aarch64-jump-table": "npm run build:cached && node scripts/verify-real-ghidra.mjs --aarch64-jump-table",
+    "verify:interface-builder": "npm run build:cached && node scripts/verify/apple/interface-builder.mjs",
+    "verify:ghidra:cross-format": "npm run build:cached && node scripts/verify-real-ghidra.mjs --cross-format",
+    "verify:ghidra:windows": "npm run build:cached && npm run build:ghidra-windows-fixture && node scripts/verify-real-ghidra-windows.mjs",
+    "verify:browser": "npm run build:cached && node scripts/verify-real-browser.mjs",
+    "verify:browser:dom": "node scripts/verify-browser-dom-destinations.mjs",
+    "verify:browser:network": "npm run build:cached && node scripts/verify-browser-network.mjs",
+    "verify:electron": "npm run build:cached && node scripts/verify-real-electron.mjs",
+    "verify:inspector": "npm run build:cached && node scripts/verify/inspector/runtime-observation.mjs",
+    "verify:javascript-runtime": "npm run build:cached && node scripts/verify/javascript/runtime-observation.mjs",
+    "verify:javascript:digests": "npm run build:cached && node scripts/verify/javascript/digests.mjs",
+    "verify:javascript:output": "npm run build:cached && node scripts/verify/javascript/output.mjs",
+    "verify:application-workflows": "npm run build:cached && node scripts/verify/javascript/application-workflows.mjs",
+    "verify:managed": "npm run build:cached && node scripts/verify/managed/conformance.mjs",
+    "verify:firmware": "npm run build:cached && node scripts/verify/firmware/analysis.mjs",
+    "fixtures:firmware": "node scripts/fixtures/firmware/generate.mjs",
+    "verify:android": "npm run build:cached && node scripts/verify/android/analysis.mjs",
+    "verify:jeb": "npm run build:cached && node scripts/verify-jeb.mjs",
+    "fixtures:android": "node scripts/fixtures/android/fetch.mjs",
+    "verify:harmony": "npm run build:cached && node scripts/verify/harmony/analysis.mjs",
+    "fixtures:harmony": "node scripts/fixtures/harmony/fetch.mjs",
+    "verify:agent": "npm run build:cached && node scripts/verify-agent-experience.mjs",
+    "verify:hopper:linux": "npm run verify:fixtures && npm run build:cached && node scripts/verify-real-hopper-linux.mjs",
+    "verify:setup:linux": "npm run build:cached && node scripts/verify-linux-setup-e2e.mjs",
+    "build:fixtures": "node scripts/build-conformance-fixtures.mjs",
+    "build:ghidra-windows-fixture": "node scripts/create-ghidra-windows-fixture.mjs",
+    "verify:fixtures": "npm run build:fixtures && node scripts/verify-conformance-fixtures.mjs",
+    "verify:readiness": "npm run build:cached && npm run verify:fixtures && node scripts/verify-reconstruction-readiness.mjs",
+    "verify:package": "npm run build:cached && node scripts/verify-package.mjs",
+    "verify:package:windows": "npm run build:cached && node scripts/verify-windows-package.mjs",
+    "verify:qwen-client": "npm run build:cached && node scripts/verify-qwen-client.mjs",
+    "verify:gemini-client": "npm run build:cached && node scripts/verify-gemini-client.mjs",
+    "verify:opencode-client": "npm run build:cached && node scripts/verify-opencode-client.mjs",
+    "verify:grok-client": "npm run build:cached && node scripts/verify-grok-client.mjs",
+    "verify:commandcode-client": "npm run build:cached && node scripts/verify-commandcode-client.mjs",
+    "verify:omp-client": "npm run build:cached && node scripts/verify-omp-client.mjs",
+    "verify:copilot-client": "npm run build:cached && node scripts/verify-copilot-client.mjs",
+    "verify:claude-client": "npm run build:cached && node scripts/verify-claude-client.mjs",
+    "verify:pi-client": "npm run build:cached && node scripts/verify-native-agent-client.mjs pi",
+    "verify:hermes-client": "npm run build:cached && node scripts/verify-native-agent-client.mjs hermes",
+    "verify:deepseek-client": "npm run build:cached && node scripts/verify-deepseek-client.mjs",
+    "probe:windows-capabilities": "npm run build:cached && node scripts/windows-capabilities.mjs",
+    "verify:published": "node scripts/verify-published-package.mjs",
+    "config:print": "node scripts/print-mcp-config.mjs",
+    "evidence:generate": "node scripts/check-dependency-install.mjs && node scripts/run-exclusive.mjs artifacts turbo run artifacts:managed-evidence",
+    "evidence:check": "node scripts/check-dependency-install.mjs && node scripts/run-exclusive.mjs artifacts turbo run evidence:check:built",
+    "predocs:dev": "npm run docs:generate",
+    "docs:dev": "vitepress dev docs",
+    "predocs:build": "npm run docs:generate",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs",
+    "docs:generate": "node scripts/check-dependency-install.mjs && node scripts/run-exclusive.mjs artifacts npm run docs:prepare",
+    "docs:check": "node scripts/check-dependency-install.mjs && node scripts/run-exclusive.mjs artifacts turbo run docs:check:built",
+    "docs:check:built": "node scripts/generate-package-metadata.mjs --check && node scripts/generate-skill-metadata.mjs --check && node scripts/generate-product-catalog.mjs --check && node scripts/generate-completion-ledger.mjs --check && node scripts/check-doc-facts.mjs && node scripts/generate-error-schema.mjs --check",
+    "docs:error-schema": "node scripts/check-dependency-install.mjs && node scripts/run-exclusive.mjs artifacts turbo run artifacts:error-schema",
+    "prepack": "node scripts/prepack.mjs",
+    "prepare": "node scripts/prepare.mjs",
+    "verify:asset-catalog": "npm run build:cached && node scripts/verify/apple/asset-catalog.mjs",
+    "verify:native-calls": "npm run build:cached && node scripts/verify-native-calls.mjs",
+    "verify:native-ui:permissions": "npm run build:cached && node scripts/verify-native-ui.mjs --allow-permission-denial",
+    "test:focused": "node scripts/run-development-tests.mjs focused",
+    "build:windows-native": "node scripts/build-windows-native.mjs",
+    "verify:windows-native:artifact": "node scripts/verify-windows-native-artifact.mjs",
+    "prepublishOnly": "npm run verify:windows-native:artifact",
+    "verify:windows-native": "node scripts/verify-windows-native.mjs",
+    "verify:ghidra:windows:package": "node scripts/verify-packaged-ghidra-windows.mjs",
+    "build:ghidra:nativeaot": "node scripts/build-ghidra-nativeaot.mjs",
+    "build:fixtures:nativeaot": "node scripts/generate-nativeaot-fixtures.mjs",
+    "verify:ghidra:nativeaot": "npm run build:cached && node scripts/verify-real-ghidra-nativeaot.mjs",
+    "verify:browser:scripts": "npm run build:cached && node scripts/verify-browser-scripts.mjs",
+    "verify:browser:modules": "npm run build:cached && node scripts/verify-browser-modules.mjs",
+    "verify:test-discovery": "node scripts/verify-test-discovery.mjs",
+    "verify:javascript:recovery": "node scripts/verify/javascript/recovery.mjs",
+    "verify:module-boundaries": "node scripts/verify-module-boundaries.mjs",
+    "verify:browser:source-maps": "npm run build:cached && node scripts/verify-browser-source-maps.mjs",
+    "verify:browser:runtime": "npm run build:cached && node scripts/verify-browser-runtime.mjs",
+    "verify:web:network-captures": "npm run build:cached && node scripts/verify-web-network-captures.mjs",
+    "verify:binary:layout": "npm run build:cached && node scripts/verify-binary-layout.mjs",
+    "verify:go:binary": "npm run build:cached && node scripts/verify-go-binary.mjs",
+    "verify:wasm:package": "npm run build:cached && node scripts/verify-packaged-wasm-artifact.mjs",
+    "verify:wasm:artifact": "npm run build:cached && node scripts/verify-wasm-artifact.mjs",
+    "verify:evm:interface": "npm run build:cached && node scripts/verify-evm-interface.mjs",
+    "verify:recorded:crash": "npm run build:cached && node scripts/verify-recorded-crash.mjs",
+    "mcp-catalog:check:built": "node scripts/generate-mcp-tool-catalog.mjs --check",
+    "compile": "node scripts/clean-build-output.mjs && tsc -p tsconfig.build.json && node scripts/bundle-runtime.mjs",
+    "compile:termux": "node scripts/clean-build-output.mjs && node --max-old-space-size=3072 node_modules/typescript-termux/lib/tsc.js -p tsconfig.build.json && node scripts/bundle-runtime.mjs",
+    "artifacts:mcp-catalog": "node scripts/generate-mcp-tool-catalog.mjs",
+    "artifacts:skills": "node scripts/generate-skill-metadata.mjs",
+    "artifacts:product-catalog": "node scripts/generate-product-catalog.mjs",
+    "artifacts:managed-evidence": "node scripts/generate-completion-ledger.mjs",
+    "artifacts:error-schema": "node scripts/generate-error-schema.mjs",
+    "test:prepare": "node scripts/check-dependency-install.mjs && node scripts/run-exclusive.mjs artifacts turbo run artifacts:mcp-catalog artifacts:product-catalog artifacts:managed-evidence",
+    "evidence:check:built": "node scripts/generate-completion-ledger.mjs --check",
+    "docs:prepare": "node scripts/generate-package-metadata.mjs && turbo run artifacts:product-catalog artifacts:managed-evidence artifacts:error-schema",
+    "test:port": "node --test \"port/test/*.test.mjs\"",
+    "bench:challenges": "node bench/selfcheck.mjs"
+  },
+  "lint-staged": {
+    "*.{cjs,cts,js,jsx,mjs,mts,ts,tsx}": [
+      "oxfmt",
+      "oxlint --fix"
+    ],
+    "*.{json,md,yml,yaml}": "oxfmt --no-error-on-unmatched-pattern"
+  },
+  "dependencies": {
+    "@babel/parser": "8.0.4",
+    "@babel/types": "8.0.4",
+    "@clack/prompts": "1.7.0",
+    "@electron/asar": "4.2.0",
+    "@jridgewell/trace-mapping": "0.3.31",
+    "@lydell/node-pty": "1.1.0",
+    "@modelcontextprotocol/client": "2.3.1",
+    "@modelcontextprotocol/server": "2.3.1",
+    "@xmldom/xmldom": "0.9.12",
+    "@xterm/addon-serialize": "0.14.0",
+    "@xterm/headless": "6.0.0",
+    "@zip.js/zip.js": "2.15.0",
+    "ajv": "8.20.0",
+    "ajv-formats": "3.0.1",
+    "canonicalize": "3.0.0",
+    "cross-spawn": "7.0.6",
+    "diff": "9.0.0",
+    "evmole": "0.9.3",
+    "har-schema": "2.0.0",
+    "ignore": "7.0.6",
+    "incur": "0.6.1",
+    "isomorphic-git": "1.38.7",
+    "jsonc-parser": "3.3.1",
+    "lossless-json": "4.3.1",
+    "parse5": "8.0.1",
+    "pino": "10.4.0",
+    "playwright-core": "1.58.2",
+    "plist": "5.0.0",
+    "semver": "7.8.5",
+    "smol-toml": "1.9.0",
+    "stream-chain": "4.2.6",
+    "stream-json": "3.7.0",
+    "write-file-atomic": "7.0.0",
+    "ws": "8.21.0",
+    "yaml": "2.9.0",
+    "zod": "4.4.3"
+  },
+  "overrides": {
+    "vitepress": {
+      "vite": "6.4.4"
+    }
+  },
+  "devDependencies": {
+    "@fast-check/vitest": "0.5.0",
+    "@types/cross-spawn": "6.0.6",
+    "@types/node": "26.6.4",
+    "@types/semver": "7.7.1",
+    "@types/write-file-atomic": "4.0.3",
+    "@types/ws": "8.18.1",
+    "@vitest/coverage-v8": "5.0.3",
+    "husky": "9.1.7",
+    "jscpd": "5.0.12",
+    "knip": "6.39.0",
+    "lint-staged": "16.4.0",
+    "oxfmt": "0.72.0",
+    "oxlint": "1.87.0",
+    "rolldown": "1.2.12",
+    "turbo": "2.11.7",
+    "typescript": "7.0.2",
+    "typescript-termux": "npm:typescript@5.9.3",
+    "vitepress": "1.6.4",
+    "vitest": "5.0.3"
+  }
+}

package/port/cli.mjs

@@ -0,0 +1,210 @@
+#!/usr/bin/env node
+// ReversePort's own commands (recon, builds, lookups, blueprints, porting). Reached through `reverseport <command>`
+// (bin/reverseport.mjs), which also routes the deep-analysis engine's commands.
+//   reverseport scan ./MyGame
+//   reverseport binary Game.exe --strings.match "*.dll"
+//   reverseport archive Game.pck --action extract --match "*.gd"
+//   reverseport plan ./MyGame --to unity
+//   reverseport re_scene main.tscn            (tool names work too)
+//   reverseport port_write --request write.json
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { tools, callTool, VERSION } from './src/tools.mjs';
+import { workspaceRoot } from './src/workspace.mjs';
+import { isMainModule } from './src/main-module.mjs';
+import { errorPayload, formatTools, FORMATS, closest, readFeedback } from './src/agent.mjs';
+import { RPError } from './src/util.mjs';
+
+const ALIASES = {
+  scan: 're_scan', graph: 're_graph', symbols: 're_symbols', scene: 're_scene', binary: 're_binary', bin: 're_binary', archive: 're_archive', pck: 're_archive',
+  probe: 're_probe', extract: 're_extract', carve: 're_extract', compare: 're_compare', diff: 're_compare', 'compare-builds': 're_compare', report: 're_report',
+  lookup: 're_lookup', recon: 're_lookup', web: 're_lookup', blueprint: 're_blueprint', rebuild: 're_blueprint',
+  map: 'port_map', convert: 'port_convert', plan: 'port_plan', unit: 'port_unit', write: 'port_write', 'port-scene': 'port_scene', 'copy-assets': 'port_copy_assets', status: 'port_status', verify: 'port_verify', case: 're_case', proof: 're_case',
+};
+const POSITIONAL = { re_scan: ['path'], re_graph: ['path'], re_symbols: ['path'], re_scene: ['file'], re_binary: ['file'], re_archive: ['file'], re_probe: ['file'], re_extract: ['file'], re_compare: ['a', 'b'], re_report: ['path'], re_lookup: ['query'], re_blueprint: ['name'], port_map: ['from', 'to'], port_convert: ['from', 'to'], port_plan: ['source'], port_unit: ['planId', 'unit'], port_write: ['planId', 'unit'], port_scene: ['planId', 'unit'], port_copy_assets: ['planId'], port_status: ['planId'], port_verify: ['planId'], re_case: ['action', 'caseId'] };
+
+/** List arguments whose items can contain commas, so a plain value stays one item. */
+const KEEP_COMMAS = new Set(['insteadOf']);
+
+export function parseArgs(name, argv) {
+  const tool = tools.find(t => t.name === name);
+  const props = tool.inputSchema.properties ?? {};
+  const args = {};
+  const pos = [];
+  const coerce = (key, raw) => {
+    const top = key.split('.')[0];
+    const schema = key.includes('.') ? props[top]?.properties?.[key.split('.')[1]] : props[top];
+    if (raw === undefined) return true;
+    if (schema?.type === 'string') return raw;
+    if (schema?.type === 'array') {
+      // JSON keeps working; a plain value becomes a list. Items of some lists may contain commas, so those are not split.
+      try { const parsed = JSON.parse(raw); if (Array.isArray(parsed)) return parsed; } catch { /* plain value */ }
+      if (KEEP_COMMAS.has(top)) return [raw];
+      return raw.split(',').map(s => s.trim()).filter(Boolean);
+    }
+    try { return JSON.parse(raw); } catch { return raw; }
+  };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a.startsWith('--')) {
+      let [key, val] = a.slice(2).split(/=(.*)/s, 2);
+      if (val === undefined && argv[i + 1] !== undefined && !argv[i + 1].startsWith('--')) val = argv[++i];
+      if (key === 'json' || key === 'args') {
+        if (val === undefined || !/^\s*\{/.test(val)) { if (val !== undefined) pos.push(val); continue; } // bare --json: output is JSON anyway
+        try { Object.assign(args, JSON.parse(val)); } catch { throw new RPError('INVALID_ARGUMENT', `--${key} expects a JSON object, e.g. --args '{"path":"./Game"}'.`); }
+        continue;
+      }
+      if (key === 'pretty' || key === 'compact') { if (val !== undefined) pos.push(val); continue; }
+      const camel = key.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+      const v = coerce(camel, val);
+      if (camel.includes('.')) { const [k, sub] = camel.split('.'); args[k] = { ...(args[k] ?? {}), [sub]: v }; }
+      else args[camel] = Array.isArray(v) && Array.isArray(args[camel]) ? [...args[camel], ...v] : v; // a repeated list flag adds to the list
+    } else pos.push(a);
+  }
+  (POSITIONAL[name] ?? []).forEach((k, i) => { if (pos[i] !== undefined && args[k] === undefined) args[k] = pos[i]; });
+  if (name === 'port_convert' && pos.length > 2) for (const p of pos.slice(2)) { const [k, v] = p.split('='); if (v) { try { args[k] = JSON.parse(v); } catch { throw new RPError('INVALID_ARGUMENT', `${k}= expects JSON, e.g. position=[1,2,3].`); } } }
+  return args;
+}
+
+export async function doctor() {
+  const major = Number(process.versions.node.split('.')[0]);
+  const ws = workspaceRoot();
+  let writable = true;
+  try { await fs.mkdir(ws, { recursive: true }); await fs.writeFile(path.join(ws, '.doctor'), 'ok'); await fs.rm(path.join(ws, '.doctor')); } catch { writable = false; }
+  const [maj, min] = process.versions.node.split('.').map(Number);
+  const nodeOk = (maj === 22 && min >= 19) || (maj === 24 && min >= 11) || maj >= 26 || maj === 25 || maj === 23;
+  return { ok: nodeOk && writable, version: VERSION, node: process.versions.node, nodeOk, nodeRequired: '>=22.19 (22.x), >=24.11 (24.x) or newer', workspace: ws, workspaceWritable: writable, tools: tools.length, platform: `${os.platform()} ${os.arch()}` };
+}
+
+function help() {
+  return `ReversePort ${VERSION} — reverse engineer anything, port it anywhere.
+
+Usage: reverseport <command> [positional] [--key value] [--json '{…}'] [--request args.json]
+
+Reverse engineering
+  scan <folder>              engine, languages, entry points (projects and game builds)
+  graph <folder>             dependency graph, cycles, port order   (--format mermaid)
+  symbols <file|folder>      classes, functions, signals            (--match player)
+  scene <file>               Godot .tscn/.tres/project.godot, Unity .unity/.prefab
+  binary <file>              PE/.NET/ELF/Mach-O/wasm/class/dex      (--strings.match "*.dll")
+  archive <file>             .pck (also inside .exe), zip/apk/jar, tar.gz, asar  (--action extract --match "*.gd")
+  probe <file>               hex, entropy map, embedded files, record strides (--offset 4096)
+  extract <file> --offset N  carve bytes out (--length N)
+  diff <a> <b>               diff two folders, packs, binaries or files (builds)
+  report <folder>            write ARCHITECTURE.md
+
+Recon without files and rebuilds
+  lookup "<name>"            public dossier: engine, stack, structure, where files live, remakes  (--url, --steam-app-id, --github owner/repo --mirror)
+  blueprint --lookup-id <id> precise clean-room rebuild spec + parity table + project skeleton (--target godot)
+
+Porting
+  map [from] [to]            conventions + API map (godot→unity, unity→godot, godot→unreal, godot→threejs…)
+  convert <from> <to> position=[1,2,3] rotation=[0,0,0,1]   coordinates between engines
+  plan <source> --to unity   plan a port and scaffold the output project
+  unit <planId>              next unit with source, API hints, conventions
+  write <planId> <unit> --content "…" | --copy | --request write.json
+  port-scene <planId> <unit> convert a scene/prefab
+  copy-assets <planId>       copy all asset units
+  status [planId]            progress (no id: all plans)
+  verify <planId>            parity, leftovers, markers
+
+Proof (evidence ledger)
+  case init --question "…" --target <what>       open a case (returns caseId)
+  case evidence <caseId> --file f | --content "…" --locator L --note N
+  case claim <caseId> --statement S --evidence E001 [--confidence observed --alternative A --falsifier F]
+  case decision|test|limit|phase|check|report|show <caseId> …   (case list: all cases)
+
+Other
+  tools [--all] [--format f] list the tools (--all adds the engine's when built); formats: ${FORMATS.join(', ')}
+  describe <tool>            one tool's description and input schema (engine tools too, when built)
+  feedback                   notes agents left with share_feedback (stays on this computer)
+  connect [client]           config snippet for any agent: MCP clients, HTTP/OpenAPI, OpenAI, Anthropic, Gemini, shell
+  serve                      HTTP API on http://127.0.0.1:32147 (REVERSEPORT_PORT)
+  mcp                        MCP server on stdio (these tools + the deep-analysis engine)
+  port doctor                check Node and the workspace (${workspaceRoot()})
+`;
+}
+
+export async function main(argv = process.argv.slice(2)) {
+  const [cmd, ...rest] = argv;
+  const compact = argv.includes('--compact');
+  const print = v => process.stdout.write(`${compact ? JSON.stringify(v) : JSON.stringify(v, null, 2)}\n`);
+  const printError = e => { process.stderr.write(`${JSON.stringify({ error: errorPayload(e) }, null, compact ? 0 : 2)}\n`); return e.code === 'INVALID_ARGUMENT' || e.code === 'UNKNOWN_TOOL' ? 2 : 1; };
+  if (!cmd || cmd === 'help' || cmd === '--help' || cmd === '-h') { process.stdout.write(help()); return 0; }
+  if (cmd === '--version' || cmd === 'version') { process.stdout.write(`${VERSION}\n`); return 0; }
+  if (cmd === 'tools') {
+    const fi = rest.indexOf('--format');
+    const all = await withEngineTools(rest.includes('--all'));
+    try {
+      if (fi < 0) print(all.map(t => ({ name: t.name, title: t.title, description: t.description })));
+      else print(formatTools(all, rest[fi + 1]));
+      return 0;
+    } catch (e) { return printError(e); }
+  }
+  if (cmd === 'describe') {
+    const all = await withEngineTools(true);
+    const t = all.find(x => x.name === (ALIASES[rest[0]] ?? rest[0]));
+    if (!t) {
+      const { knownEngineToolNames } = await import('./src/relay.mjs');
+      if (knownEngineToolNames().has(rest[0])) return printError(new RPError('ENGINE_UNAVAILABLE', `${rest[0]} is a deep-analysis engine tool; its schema comes from the built engine, which is not built in this copy.`));
+    }
+    if (!t) return printError(new RPError('UNKNOWN_TOOL', `Unknown tool "${rest[0] ?? ''}". ${closest(rest[0] ?? '', all.map(x => x.name), 3) ? `Did you mean "${closest(rest[0], all.map(x => x.name), 3)}"? ` : ''}reverseport tools --all lists them.`));
+    print({ name: t.name, title: t.title, description: t.description, inputSchema: t.inputSchema, annotations: t.annotations, cli: `reverseport ${t.name} ${(POSITIONAL[t.name] ?? []).map(p => `<${p}>`).join(' ')} [--key value] [--args '{…}']`.replace(/\s+/g, ' ').trim() });
+    return 0;
+  }
+  if (cmd === 'feedback') { print(await readFeedback()); return 0; }
+  if (cmd === 'connect') {
+    const { connect } = await import('./src/connect.mjs');
+    const mi = rest.indexOf('--mode');
+    try {
+      const r = connect({ client: rest.find((x, i) => !x.startsWith('--') && !(mi >= 0 && i === mi + 1)), mode: mi >= 0 ? rest[mi + 1] : undefined });
+      if (r.snippet && !argv.includes('--json')) { process.stdout.write(`# ${r.where}\n${r.snippet}\n`); return 0; }
+      print(r); return 0;
+    } catch (e) { return printError(e); }
+  }
+  if (cmd === 'doctor') { const r = await doctor(); print(r); return r.ok ? 0 : 1; }
+  if (cmd === 'serve') { const { start } = await import('./server.mjs'); const s = await start(); console.log(`ReversePort ${VERSION} — http://127.0.0.1:${s.address().port}/api/agent/tools`); return null; }
+  if (cmd === 'mcp') { await import('./mcp.mjs'); return null; }
+  const name = ALIASES[cmd] ?? cmd;
+  if (!tools.some(t => t.name === name)) {
+    const near = closest(cmd, [...Object.keys(ALIASES), ...tools.map(t => t.name)], 2);
+    return printError(new RPError('UNKNOWN_TOOL', `Unknown command "${cmd}".${near ? ` Did you mean "${near}"?` : ''} Run: reverseport help`));
+  }
+  try {
+    let args = {};
+    const reqIdx = rest.indexOf('--request');
+    if (reqIdx >= 0) {
+      const src = rest[reqIdx + 1];
+      if (!src) throw new RPError('INVALID_ARGUMENT', '--request needs a JSON file path, or - for stdin.');
+      let text;
+      try { text = src === '-' ? await readStdin() : await fs.readFile(src, 'utf8'); } catch (e) { throw new RPError(e.code === 'ENOENT' ? 'NOT_FOUND' : 'INVALID_ARGUMENT', `--request: cannot read ${src} (${e.code ?? e.message}).`); }
+      try { args = JSON.parse(text); } catch { throw new RPError('INVALID_ARGUMENT', `--request: ${src} is not a JSON object.`); }
+      rest.splice(reqIdx, 2);
+    }
+    Object.assign(args, parseArgs(name, rest));
+    print(await callTool(name, args));
+    return 0;
+  } catch (e) { return printError(e); }
+}
+
+/** ReversePort's tools, plus the engine's when it is built and `include` is set. */
+async function withEngineTools(include) {
+  if (!include) return tools;
+  const { createRelay, engineCommand } = await import('./src/relay.mjs');
+  if (!engineCommand().command) return tools;
+  const relay = createRelay({}, { tools: 'all' });
+  try { await relay.ensureStarted({ name: 'reverseport-cli', version: VERSION }); return [...tools, ...relay.allEngineTools()]; }
+  finally { relay.close(); }
+}
+
+async function readStdin() {
+  let text = '';
+  for await (const chunk of process.stdin) text += chunk;
+  return text;
+}
+
+if (isMainModule(import.meta.url)) {
+  const code = await main();
+  if (code !== null) process.exitCode = code;
+}