🚀 NEXUS ANALYZER v0.3.0

Advanced Reverse Engineering for Local & Online Projects

Tipo REVERSA, mas muito mais poderoso! Analisa projetos locais E sites online com Playwright.

🎯 O que é NEXUS?

NEXUS é uma ferramenta que:

1. ✅ Analisa projetos locais (código, APIs, DB)
2. ✅ Scrape sites online (HTML, CSS, JS, APIs)
3. ✅ Documenta tudo em JSON estruturado
4. ✅ Exporta em Markdown, Mermaid, JSON
5. ✅ Prepara dados para qualquer IA trabalhar

Filosofia: Análise primeiro, ação depois. A IA decide o que fazer!

📦 Instalação

npm install -g nexus-analyzer

🚀 Quick Start

1️⃣ Setup (uma vez)

nexus-analyzer install

? Nome do projeto: meu-projeto
? Idioma: pt-br
? Pasta de saída: .nexus

✅ Estrutura criada em .nexus/

2️⃣ Analisar Projeto Local

nexus-analyzer analyze ./src
# ou
nexus-analyzer analyze .

Resultado: Tudo documentado em .nexus/analysis/

3️⃣ Analisar Site Online ⚡

nexus-analyzer analyze https://figma.com

O que faz:

• ✅ Carrega site com Playwright
• ✅ Captura HTML/CSS/JS completo
• ✅ Intercepta requisições HTTP
• ✅ Detecta framework (React, Vue, etc)
• ✅ Encontra APIs chamadas
• ✅ Mapeia componentes visuais
• ✅ Infer database schema

4️⃣ Exportar Análise

# Documentação (Markdown)
nexus-analyzer export docs

# Diagramas (Mermaid SVG)
nexus-analyzer export diagrams

# Dados estruturados (JSON)
nexus-analyzer export json

5️⃣ Escolher IA

nexus-analyzer use-ai claude
# ou: codex, antigravity, cursor

Agora a IA tem tudo pronto em .nexus/ para trabalhar!

📋 Estrutura Criada

seu-projeto/
├── .nexus/
│   ├── state.json              ← Configuração
│   ├── analysis/               ← Dados das análises
│   │   ├── projeto-local/
│   │   │   └── result.json
│   │   └── figma.com/
│   │       └── result.json
│   └── context/                ← Documentação gerada
│       ├── README.md
│       ├── ARCHITECTURE.md
│       ├── API_ENDPOINTS.md
│       └── diagrams/
│           ├── architecture.svg
│           ├── database-er.svg
│           └── data-flows.svg

💡 Casos de Uso

1. Clonar um SaaS

# Analisar
nexus-analyzer analyze https://figma.com

# Exportar dados
nexus-analyzer export docs

# IA (Claude) gera código
# → Clone completo do Figma!

2. Refatorar Projeto

# Analisar código local
nexus-analyzer analyze ./src

# IA identifica padrões e sugere melhorias
# → Refactor automático!

3. Documentar Projeto

# Analisar
nexus-analyzer analyze ./api

# Exportar docs
nexus-analyzer export docs

# Tudo documentado automaticamente!

🔑 Diferenças: REVERSA vs NEXUS

| Feature | REVERSA | NEXUS | |---------|---------|-------| | Projetos locais | ✅ | ✅ | | Sites online | ❌ | ✅ | | Scrape web | ❌ | ✅ (Playwright) | | Network inspection | ❌ | ✅ | | Gera código | ❌ | ❌ | | Exporta Markdown | ✅ | ✅ | | Exporta Diagrams | ✅ | ✅ | | Escolhe IA | ✅ | ✅ |

🤖 IAs Suportadas

• 🧠 Claude (Recomendado)
• ⚡ Codex (OpenAI)
• 🪄 Antigravity
• 🎯 Cursor
• 🚀 E mais...

📊 O que NEXUS Analisa

Local Projects

• ✅ Linguagem (JS, Python, Go, Rust, etc)
• ✅ Framework (Next.js, Django, Express, etc)
• ✅ Estrutura de arquivos
• ✅ Rotas e endpoints
• ✅ Database schema
• ✅ Componentes/Controllers
• ✅ Autenticação

Online Sites

• ✅ Framework frontend (React, Vue, Angular, etc)
• ✅ CSS framework (Tailwind, Bootstrap, etc)
• ✅ APIs descobertas (via network inspection)
• ✅ Componentes UI detectados
• ✅ Tech stack (hosting, CDN, analytics, etc)
• ✅ Database inferred (da estrutura de APIs)
• ✅ Authentication method

📖 Documentação Gerada

nexus-analyzer export docs cria:

• README.md — Overview do projeto
• ARCHITECTURE.md — Visão arquitetural
• API_ENDPOINTS.md — Todas as rotas
• DATABASE_SCHEMA.md — Schema completo
• COMPONENTS_INVENTORY.md — Controllers/Components
• TECH_STACK.md — Stack completo

📊 Diagramas Gerados

nexus-analyzer export diagrams cria:

• architecture.svg — Diagrama da arquitetura
• database-er.svg — Diagrama ER do DB
• data-flows.svg — Como dados fluem
• api-graph.svg — Grafo de APIs

(Mermaid → SVG automático)

🎯 Fluxo Completo

1. nexus-analyzer install
   ↓
2. nexus-analyzer analyze <path|url>
   ↓
3. nexus-analyzer export docs
   ↓
4. nexus-analyzer use-ai claude
   ↓
5. IA (Claude/Codex/etc) trabalha!
   → Gera clone? Refatora? Documenta?
   → Ela decide!

🚀 Próximas Features

• [ ] Vision AI para análise de componentes
• [ ] Incremental analysis (só analisa o que mudou)
• [ ] API testing (testa endpoints encontrados)
• [ ] Multi-project comparison
• [ ] HTML report generator
• [ ] GraphQL detection
• [ ] gRPC support
• [ ] Kubernetes detection

📞 Suporte

GitHub: https://github.com/caiquecontarini/nexus-engine NPM: https://www.npmjs.com/package/nexus-analyzer

📝 Licença

MIT

NEXUS ANALYZER — Análise antes de ação. IA decide o resto! 🧠✨