Universal Reverse-Twin Framework: Autonomous full-stack reverse engineering
- PHP 55.1%
- TypeScript 33.9%
- HTML 4.5%
- JavaScript 3.7%
- Python 2.5%
- Other 0.2%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| .agents | ||
| .github/workflows | ||
| agents | ||
| core/orchestrator | ||
| docs | ||
| packages/object-cache-pro | ||
| projects/objectcache-pro | ||
| sql | ||
| tasks | ||
| test | ||
| tests | ||
| tools | ||
| types | ||
| .env.example | ||
| .gitignore | ||
| AGENTS.md | ||
| antigravity.config.json | ||
| benchmark_suite.py | ||
| cli.ts | ||
| compare_bench.py | ||
| hypercache_benchmark.py | ||
| l1_vs_l2_bench.php | ||
| LICENSE | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| remediation-plan.md | ||
| tsconfig.json | ||
Universal Reverse-Twin Framework (twin-turbo-reverse)
Autonomous full-stack reverse engineering, AST decompilation, API behavioral probing, and isomorphic codebase synthesis.
⚡ Overview
The Universal Reverse-Twin Framework is an autonomous multi-agent micro-kernel designed to decompile, reconstruct, probe, and synthesize a production-grade 1:1 isomorphic replica of any target web application.
It generates:
- Fastify Backend: Type-safe REST server with CORS, healthchecks, SSE streams, and Prisma ORM client integration.
- React Frontend: Modern React + Vite + Tailwind CSS SPA with declarative
react-router-domnavigation and API wrappers. - Relational Database DDL & Seeders: Dual-dialect (PostgreSQL & SQLite) SQL schemas with typed column definitions and foreign keys.
- Docker Orchestration: Multi-container
docker-compose.yml(PostgreSQL, backend, frontend) with healthchecks. - Dual-Run Parity Verifier: Differential API assertions and Pixelmatch visual regression tests.
🚀 Quick Start
1. Installation
git clone https://github.com/your-org/twin-turbo-reverse.git
cd twin-turbo-reverse
npm install
npm run build
2. Configuration
Copy the example environment file:
cp .env.example .env
3. Execution
Execute the full 5-phase DAG pipeline against any target URL:
node dist/cli.js run https://example.com -o ./workspace
🏗 Pipeline Architecture (5-Phase DAG)
- RECON: Stealth anti-fingerprinting crawler harvesting HTML documents, JS bundles, stylesheets, and sourcemap links into HAR 1.2 recordings.
- DECOMPILE: Sourcemap v3 reconstructor restoring original directories and Babel AST static analyzer discovering routes, validation schemas, and queries.
- PROBE: Active behavioral mutation fuzzer discovering boundary conditions, fused with dynamic traces to synthesize OpenAPI 3.1 & Prisma schemas.
- SYNTHESIZE: Compiles modular Fastify TypeScript server, React + Vite + Tailwind SPA, and database migrations.
- VERIFY: Dual-run differential API tester and Pixelmatch visual engine calculating an objective Parity Verification Score (0-100%).
🧪 Testing
# Run unit & integration test suites
npm test
# Run strict TypeScript compilation check
npm run build
📄 License
Licensed under the Apache License, Version 2.0 (the "License"). See the LICENSE file for details.