nex-app 0.2.7 → 2.0.0

package/LICENSE

@@ -0,0 +1,51 @@
+PROPRIETARY LICENSE - INOSX
+
+Copyright (c) 2025 INOSX (https://inosx.com)
+All Rights Reserved
+
+NOTICE: All information contained herein is, and remains the property of INOSX
+and its suppliers, if any. The intellectual and technical concepts contained
+herein are proprietary to INOSX and its suppliers and may be covered by patents,
+patents in process, and are protected by trade secret or copyright law.
+
+Dissemination of this information or reproduction of this material is strictly
+forbidden unless prior written permission is obtained from INOSX.
+
+TERMS AND CONDITIONS:
+
+1. PROPRIETARY RIGHTS
+   This software and associated documentation files (the "Software") are the
+   proprietary and confidential information of INOSX. The Software is protected
+   by copyright laws and international copyright treaties, as well as other
+   intellectual property laws and treaties.
+
+2. RESTRICTIONS
+   You may NOT:
+   - Copy, modify, adapt, alter, translate, or create derivative works of the Software
+   - Reverse engineer, disassemble, decompile, or otherwise attempt to derive the
+     source code of the Software
+   - Remove, alter, or obscure any proprietary notices, labels, or marks on the Software
+   - Use the Software for any commercial purpose without explicit written permission
+   - Distribute, sublicense, rent, lease, or lend the Software to any third party
+   - Use the Software in any way that violates any applicable law or regulation
+
+3. NO WARRANTY
+   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+   IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+   FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL INOSX
+   BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
+   CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+   SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+4. TERMINATION
+   This license is effective until terminated. Your rights under this license will
+   terminate automatically without notice from INOSX if you fail to comply with any
+   term(s) of this license.
+
+5. CONTACT
+   For licensing inquiries, please contact:
+   Website: https://inosx.com
+   Email: [contact information]
+
+INOSX reserves all rights not expressly granted to you in this license.
+

package/README.md

@@ -1,74 +1,557 @@
-# nex-app
+# 🚀 NEX Framework 2.0
 
-Crie projetos NEX com interface interativa (CLI + Web UI).
+> **Multi-LLM AI Framework with Cursor Rules Integration**  
+> Framework completo de Agentes AI para desenvolvimento de software inteligente
 
-## 🚀 Uso
+[![Version](https://img.shields.io/badge/version-2.0.0-blue.svg)](CHANGELOG.md)
+[![License: Proprietary](https://img.shields.io/badge/License-Proprietary-red.svg)](https://inosx.com)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org/)
+[![Multi-LLM](https://img.shields.io/badge/Multi--LLM-Ready-purple.svg)](docs/NEX-2.0-MULTI-LLM-SPEC.md)
+[![JavaScript](https://img.shields.io/badge/JavaScript-97.9%25-yellow)](https://www.javascript.com/)
+
+---
+
+## 🎉 What's New in NEX 2.0
+
+### ✨ Major Features
+- 🤖 **Multi-LLM Support**: Claude Sonnet, GPT-4, Haiku, GPT-4o-mini, and more
+- ⚡ **Cursor Integration**: One-command install to `.cursor/rules/nex/`
+- 🚀 **Ultra-Fast**: Installation in < 1 second (214 files)
+- ✅ **Auto-Validation**: Built-in verification and health checks
+- 💾 **Smart Backup**: Automatic backup system before updates
+- 📦 **Complete**: All agents, workflows, tasks, and tools included
 
 ```bash
-# Uso básico (detecção automática)
-npx nex-app
+# Execute o setup wizard interativo
+npx nex-app@latest
 
-# Forçar Web UI
-npx nex-app --web
+# O wizard irá:
+# ✓ Perguntar sobre instalação de Cursor Rules
+# ✓ Perguntar sobre abrir NEX Hub no browser
+# ✓ Instalar e configurar tudo automaticamente
 
-# Forçar CLI
-npx nex-app --no-browser
+# Depois, use no Cursor:
+# @nex/core/agents/nex-master
 ```
 
+[📖 Full Changelog](CHANGELOG.md) | [📋 Technical Spec](docs/NEX-2.0-MULTI-LLM-SPEC.md) | [🧪 Test Report](docs/NEX-2.0-TEST-REPORT.md)
+
+---
+
+NEX é um framework avançado de agentes AI que permite criar, gerenciar e orquestrar múltiplos agentes especializados para desenvolvimento de software, planejamento de projetos, análise de requisitos e muito mais.
+
+## 📋 Índice
+
+- [Características](#-características)
+- [Instalação](#-instalação)
+- [Início Rápido](#-início-rápido)
+- [Arquitetura](#-arquitetura)
+- [Documentação](#-documentação)
+- [Estrutura do Projeto](#-estrutura-do-projeto)
+- [Agentes](#-agentes)
+- [CLI](#-cli)
+- [NEX Store](#-nex-store)
+- [Contribuindo](#-contribuindo)
+- [Licença](#-licença)
+
 ## ✨ Características
 
-- **Modo Híbrido**: CLI rápido ou Web UI visual
-- **Detecção Automática**: Escolhe o melhor modo automaticamente
-- **Templates**: Blank, Full Stack, API Only
-- **Integração Cursor**: Configuração automática
-- **Marketplace**: Seleção de agentes durante criação
+### 🎯 Agentes de Planejamento
+- **ANX** - Análise de requisitos e geração de insights
+- **PMX** - Gestão de produto e criação de PRDs
+- **ARX** - Arquitetura de sistemas e infraestrutura
+- **DVX** - Desenvolvimento e geração de código
+- **DOCX** - Documentação técnica
+- **QAX** - Garantia de qualidade e testes
+- **DEPX** - Deploy e CI/CD
+- **MONX** - Monitoramento e observabilidade
+
+### 🤖 Agentes de Execução
+- **18 agentes especializados** para execução de comandos
+- Sistema de orquestração multi-agente
+- Validação multi-camada
+- Busca semântica com vetorização
 
-## 📋 Requisitos
+### 🛠️ Ferramentas
+- **CLI completo** para gerenciamento de projetos
+- **Sistema de workflows** pré-definidos e customizáveis
+- **Templates** para PRDs, user stories e arquitetura
+- **Sistema de preferências** técnicas configuráveis
+- **Sharding inteligente** para otimização de tokens
+- **Web UI** para gerenciamento visual
+
+### 🏪 NEX Agent Marketplace
+- **Registry completo** de agents (planning + execution + community)
+- **CLI poderoso** para instalação e gerenciamento
+- **Sistema de versionamento** semântico
+- **Dependency management** automático
+- **Supabase integration** para sync e analytics
+- **Reviews & ratings** (database ready)
+- **Search & discovery** inteligente
+- **Official & community** agents
+
+### 🧠 Inteligência Artificial
+- Suporte a múltiplos providers (OpenAI, Claude, Gemini, Mistral)
+- Configuração flexível de modelos
+- Integração de IA em todos os agentes
+- Sistema de aprendizado contínuo
+
+## 📦 Instalação
+
+### Instalação Rápida via NPX (Recomendado)
+
+```bash
+# Execute o setup wizard interativo
+npx nex-app@latest
+
+# O wizard perguntará:
+# 1. Install NEX agents in Cursor (.cursor/rules/nex/)? [Y/n]
+# 2. Open NEX Hub in browser after installation? [Y/n]
+
+# Depois, no Cursor, use:
+@nex/core/agents/nex-master
+
+# Ou instale agentes adicionais do marketplace:
+nex agent install anx
+```
+
+### Pré-requisitos
 
 - Node.js >= 18.0.0
-- npm, pnpm ou yarn
+- npm ou yarn
+- Git
+- Conta no Supabase (para backend e banco de dados)
+- Conta no Vercel (para deploy do frontend)
+
+### Instalação Local (Para Desenvolvimento)
+
+```bash
+# Clone o repositório
+git clone https://github.com/INOSX/nex-store.git
+cd nex-store
+
+# Instale as dependências
+npm install
+
+# Configure as variáveis de ambiente
+cp .env.example .env
+# Edite o .env com suas configurações do Supabase:
+# VITE_SUPABASE_URL=your_supabase_project_url
+# VITE_SUPABASE_ANON_KEY=your_supabase_anon_key
+```
+
+### Configuração do Supabase
+
+1. Crie um projeto no [Supabase](https://supabase.com)
+2. Execute as migrations:
+   ```bash
+   # Instale o Supabase CLI
+   npm install -g supabase
+
+   # Faça login
+   supabase login
+
+   # Link seu projeto
+   supabase link --project-ref your-project-ref
+
+   # Execute as migrations
+   supabase db push
+   ```
+3. Configure as Edge Functions:
+   ```bash
+   supabase functions deploy nex-store-auth
+   supabase functions deploy nex-store-agents
+   supabase functions deploy nex-manager-api
+   ```
+
+### Instalação via NPM
+
+O NEX Framework é instalado automaticamente via NPX. Para usuários que precisam instalar globalmente:
+
+```bash
+# Instalar NEX CLI globalmente (opcional)
+npm install -g nex-app@latest
+```
+
+## 🚀 Início Rápido
+
+### Novo Usuário - Instale o NEX
+
+```bash
+# 1. Instale o NEX Framework (GRATUITO)
+npx nex-app@latest
+
+# 2. Acesse o NEX Hub no browser
+# O instalador abrirá automaticamente: http://localhost:3000/hub
+
+# 3. Browse e instale agentes
+nex agent search "planning"
+nex agent install anx
+
+# 4. Use os agentes no Cursor
+# No chat do Cursor, digite: @anx analise este projeto
+```
+
+### Desenvolvimento Local
+
+```bash
+# Iniciar servidor de desenvolvimento (Vite)
+npm run dev
+
+# O frontend estará disponível em http://localhost:3000
+```
+
+### Deploy no Vercel
+
+1. Conecte seu repositório ao Vercel
+2. Configure as variáveis de ambiente no Vercel:
+   - `VITE_SUPABASE_URL`
+   - `VITE_SUPABASE_ANON_KEY`
+3. O Vercel detectará automaticamente o Vite e fará o deploy
+
+### Usando o CLI
+
+```bash
+# Instalar o NEX (se ainda não instalou)
+npx nex-app@latest
+
+# Gerenciar agentes
+nex agent search "analysis"    # Buscar agentes
+nex agent install anx          # Instalar ANX - Analysis Expert
+nex agent list                 # Listar instalados
+nex agent info anx             # Ver detalhes
+nex agent update anx           # Atualizar
+nex agent uninstall anx        # Remover
+
+# Executar workflows (com agentes instalados)
+nex workflow full-stack-app
+
+# Configurar IA
+nex config ai --provider openai
+```
+
+### Uso Programático
+
+```javascript
+import { NEXOrchestrator } from '@nex/framework'
+
+const orchestrator = new NEXOrchestrator()
+
+// Processar comando
+const result = await orchestrator.processCommand(
+  "Liste todas as empresas",
+  user,
+  context
+)
+
+// Executar workflow de planejamento
+const plan = await orchestrator.executePlanningWorkflow(
+  requirements,
+  context
+)
+```
 
 ## 🏗️ Arquitetura
 
-Este pacote implementa a **Opção 3 (Híbrida)**:
-- CLI como padrão (rápido, confiável)
-- Web installer como opção (`--web`)
-- Detecção automática de ambiente
+### Stack Tecnológica
+
+- **Frontend**: Vite + React (deploy no Vercel)
+- **Backend**: Supabase Edge Functions (Deno)
+- **Banco de Dados**: Supabase PostgreSQL
+- **Autenticação**: Supabase Auth
+- **Storage**: Supabase Storage
+
+### Padrão de Agentes
+
+NEX segue o padrão de categorização de agentes:
+
+- **🔷 NEX (Nexus)** - Orquestração central
+- **📐 ORDX (Ordo)** - Ordem, validação e estruturação
+- **🌊 FLX (Fluxus)** - Fluxo contínuo e planejamento
+- **⚡ AGX (Agens)** - Execução de ações de domínio
+- **🔧 OPX (Opus)** - Execução técnica especializada
+
+Para mais detalhes, consulte: [PADRAO_NEX_FLX_AGX_OPX_ORDX.md](./PADRAO_NEX_FLX_AGX_OPX_ORDX.md)
 
-## 📖 Documentação
+## 📚 Documentação
 
-- [Arquitetura Completa](../docs/ARQUITETURA_NPX_WEB_INSTALLER_NEX.md)
-- [Implementação Detalhada](../docs/IMPLEMENTACAO_HIBRIDA_NPX.md)
-- [Brainstorm](../docs/BRAINSTORM_NPX_WEB_INSTALLER.md)
+### Documentação Principal
 
-## 🔧 Desenvolvimento
+- **[Padrão NEX/FLX/AGX/OPX/ORDX](./PADRAO_NEX_FLX_AGX_OPX_ORDX.md)** - Explicação completa do padrão de nomenclatura e arquitetura
+- **[Documentação de Agentes](./DOCUMENTACAO_AGENTES_NEX.md)** - Documentação detalhada de todos os 18 agentes
+- **[Diagramas de Agentes](./DIAGRAMAS_AGENTES_NEX.md)** - Diagramas Mermaid de cada agente
+- **[Fluxo do Sistema](./FLUXO_ESPECIALISTA_NEX.md)** - Fluxo completo de processamento
+- **[Resumo de Implementação](./IMPLEMENTACAO_NEX_RESUMO.md)** - Visão geral das implementações
+
+### Documentação Técnica
+
+- **[Configuração Vite + Supabase](./docs/VITE_SUPABASE_SETUP.md)** - Guia completo de configuração do frontend e backend
+- **[Guia de Deploy](./DEPLOYMENT.md)** - Como fazer deploy no Vercel e Supabase
+- **[Módulo Especialista IA](./docs/MODULO_ESPECIALISTA_IA.md)** - Documentação do módulo de especialista
+- **[Integração de IA](./docs/AGENTES_IA_INTEGRATION.md)** - Estratégia de integração de IA nos agentes
+- **[Guia de Testes](./GUIA_TESTES_NEX_ESPECIALISTA.md)** - Guia completo de testes
+- **[Testes Rápidos](./TESTES_RAPIDOS_NEX.md)** - Testes rápidos e exemplos
+
+## 📁 Estrutura do Projeto
+
+```
+nex-agents/
+├── cli/                          # CLI do framework
+│   └── nex-cli.js
+├── src/
+│   ├── services/
+│   │   ├── nex-execution/        # Agentes de execução
+│   │   │   ├── nexOrchestrator.js
+│   │   │   ├── agents/           # 18 agentes especializados
+│   │   │   ├── services/         # Serviços de vetorização
+│   │   │   └── utils/            # Utilitários
+│   │   ├── nex/                  # Sistema NEX Framework
+│   │   │   ├── agents/planning/  # Agentes de planejamento
+│   │   │   ├── core/             # Core do framework
+│   │   │   ├── api/              # APIs
+│   │   │   └── installer/        # Sistema de instalação
+│   │   ├── nex-store/            # NEX Store (marketplace)
+│   │   └── nex-installer/        # Instalador de agentes
+│   ├── components/               # Componentes React
+│   │   ├── specialist/          # Módulo especialista
+│   │   ├── nex-manager/         # Gerenciador web
+│   │   └── store/               # Loja virtual
+│   ├── pages/                   # Páginas React
+│   │   ├── admin/               # Painel admin
+│   │   └── store/                # Páginas da loja
+│   └── config/                   # Configurações
+│       ├── nexConfig.js
+│       └── aiConfig.js
+├── templates/                    # Templates de documentos
+│   ├── prd-template.md
+│   ├── user-story-template.md
+│   └── architecture-template.md
+├── workflows/                    # Workflows pré-definidos
+│   ├── greenfield/
+│   └── brownfield/
+├── docs/                         # Documentação adicional
+├── sql/                          # Scripts SQL
+└── package.json
+```
+
+## 🤖 Agentes
+
+### Agentes de Planejamento (Novos)
+
+| Agente | Categoria | Função |
+|--------|-----------|--------|
+| **ANX** | FLX | Análise de requisitos e insights |
+| **PMX** | FLX | Gestão de produto e PRDs |
+| **ARX** | OPX | Arquitetura e design de sistemas |
+| **DVX** | AGX | Desenvolvimento e código |
+| **DOCX** | OPX | Documentação técnica |
+| **QAX** | ORDX | Qualidade e testes |
+| **DEPX** | AGX | Deploy e CI/CD |
+| **MONX** | ORDX | Monitoramento e observabilidade |
+
+### Agentes de Execução (Existentes)
+
+| Categoria | Agentes |
+|-----------|---------|
+| **ORDX** | SupervisorAgent, PermissionAgent, ContextAgent, MemoryResourceAgent |
+| **FLX** | VoiceIntentAgent, QueryPlanningAgent, SuggestionAgent |
+| **AGX** | CompanyActionAgent, EmployeeActionAgent, CampaignActionAgent, ProspectingActionAgent, BenefitActionAgent, ProductActionAgent, IntegrationActionAgent |
+| **OPX** | DatabaseQueryAgent, DatabaseKnowledgeAgent, DataVisualizationAgent, FeedbackAgent |
+
+Para documentação completa, veja: [DOCUMENTACAO_AGENTES_NEX.md](./DOCUMENTACAO_AGENTES_NEX.md)
+
+## 💻 CLI
+
+O NEX Framework inclui uma CLI completa para gerenciamento:
+
+```bash
+# Instalação (primeira vez)
+npx nex-app@latest
+
+# Comandos do Marketplace
+nex agent search <query>        # Buscar agents
+nex agent install <agent-id>    # Instalar agent  
+nex agent list                  # Listar instalados
+nex agent info <agent-id>       # Ver detalhes
+nex agent update <agent-id>     # Atualizar agent
+nex agent uninstall <agent-id>  # Remover agent
+
+# Comandos de configuração
+nex config                      # Ver configuração atual
+nex config ai --provider openai # Configurar provider de IA
+```
+
+Para mais detalhes sobre o Marketplace: [NEX_MARKETPLACE_SETUP.md](./NEX_MARKETPLACE_SETUP.md)
+
+## 🏪 NEX Agent Marketplace
+
+O NEX Agent Marketplace é um sistema completo de distribuição de agents:
+
+**Features:**
+- 📦 **Registry Universal** - Local + Git + Supabase
+- 🔍 **Search & Discovery** - Busca por texto, tags, categoria
+- ⚡ **Instalação Rápida** - `nex agent install anx`
+- 🔗 **Dependency Management** - Auto-instalação de dependências
+- 📊 **Stats & Analytics** - Tracking de instalações e uso
+- ⭐ **Reviews & Ratings** - Sistema de feedback da comunidade
+- 🎯 **Official & Community** - Agents oficiais INOSX + comunidade
+
+**Quick Start:**
+```bash
+# 1. Instale o NEX (GRATUITO)
+npx nex-app@latest
+
+# 2. Buscar agents
+nex agent search "planning"
+
+# 3. Instalar agents
+nex agent install anx
+
+# 4. Ver instalados
+nex agent list
+```
+
+Documentação completa: [NEX_MARKETPLACE_SETUP.md](./NEX_MARKETPLACE_SETUP.md)
+
+## 🔧 Configuração
+
+### Configuração de IA
+
+Edite `src/config/aiConfig.js` para configurar seus providers:
+
+```javascript
+export default {
+  currentProvider: 'openai',
+  providers: {
+    openai: {
+      apiKey: process.env.OPENAI_API_KEY,
+      model: 'gpt-4o-mini'
+    },
+    claude: {
+      apiKey: process.env.CLAUDE_API_KEY,
+      model: 'claude-3-sonnet'
+    }
+    // ... outros providers
+  }
+}
+```
+
+### Configuração de Agentes
+
+Edite `src/config/nexConfig.js` para personalizar os agentes:
+
+```javascript
+export const nexConfig = {
+  supervisor: {
+    minQualityScore: 70,
+    maxRetries: 3
+  },
+  // ... outras configurações
+}
+```
+
+## 🧪 Testes
+
+```bash
+# Executar testes
+npm test
+
+# Testes com cobertura
+npm run test:coverage
+
+# Testes rápidos
+npm run test:quick
+```
+
+Consulte: [GUIA_TESTES_NEX_ESPECIALISTA.md](./GUIA_TESTES_NEX_ESPECIALISTA.md)
+
+## 🚧 Desenvolvimento
+
+### Requisitos
+
+- Node.js >= 18.0.0
+- npm ou yarn
+- Git
+
+### Setup de Desenvolvimento
 
 ```bash
-# Instalar dependências
+# Clone o repositório
+git clone https://github.com/INOSX/nex-store.git
+cd nex-store
+
+# Instale dependências
 npm install
 
-# Testar localmente
-node cli/create.js
+# Configure variáveis de ambiente
+cp .env.example .env
+# Edite .env com suas credenciais do Supabase
+
+# Configure Supabase (se ainda não fez)
+supabase login
+supabase link --project-ref your-project-ref
+supabase db push
 
-# Testar modo web
-node cli/create.js --web
+# Execute em modo desenvolvimento
+npm run dev
+# Frontend estará em http://localhost:3000
 ```
 
-## 📝 Status
+Para mais detalhes, consulte: [docs/VITE_SUPABASE_SETUP.md](./docs/VITE_SUPABASE_SETUP.md)
 
-🟡 **Em Desenvolvimento** - MVP funcional
+### Estrutura de Branches
 
-- [x] Estrutura base
-- [x] CLI entrypoint
-- [x] Servidor web
-- [x] UI básica
-- [x] Generator
-- [x] Templates básicos
-- [ ] Integração completa com Marketplace
-- [ ] Integração completa com Cursor
-- [ ] Testes
-- [ ] Publicação no npm
+- `main` - Branch de produção
+- `develop` - Branch de desenvolvimento
+
+## 🤝 Contribuindo
+
+Contribuições são bem-vindas! Por favor:
+
+1. Fork o projeto
+2. Crie uma branch para sua feature (`git checkout -b feature/AmazingFeature`)
+3. Commit suas mudanças (`git commit -m 'Add some AmazingFeature'`)
+4. Push para a branch (`git push origin feature/AmazingFeature`)
+5. Abra um Pull Request
+
+### Guia de Contribuição
+
+- Siga o padrão de código existente
+- Adicione testes para novas funcionalidades
+- Atualize a documentação conforme necessário
+- Use commits descritivos
 
 ## 📄 Licença
 
-PROPRIETARY - INOSX
+Este projeto é proprietário da **INOSX** (https://inosx.com). Todos os direitos reservados.
+
+Este software e sua documentação são propriedade da INOSX e são fornecidos sob licença proprietária. É proibida a reprodução, distribuição, modificação ou uso comercial sem autorização expressa da INOSX.
+
+Para mais informações sobre licenciamento, entre em contato através do site [inosx.com](https://inosx.com).
+
+## 👥 Autores
+
+- **INOSX** - *Desenvolvimento inicial* - [INOSX](https://github.com/INOSX)
+
+## 🙏 Agradecimentos
+
+- OpenAI pela API de IA
+- Supabase pelo banco de dados
+- Comunidade open source
+
+## 📞 Suporte
+
+- **Issues**: [GitHub Issues](https://github.com/INOSX/nex-store/issues)
+- **Documentação**: Veja a seção [Documentação](#-documentação)
+- **Email**: suporte@inosx.com
+
+## 🔗 Links Úteis
+
+- [Documentação Completa](./DOCUMENTACAO_AGENTES_NEX.md)
+- [Padrão de Arquitetura](./PADRAO_NEX_FLX_AGX_OPX_ORDX.md)
+- [Diagramas](./DIAGRAMAS_AGENTES_NEX.md)
+- [Fluxo do Sistema](./FLUXO_ESPECIALISTA_NEX.md)
+
+---
+
+⭐ Se este projeto foi útil para você, considere dar uma estrela!