nex-framework-cli 1.0.1

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

@@ -0,0 +1,484 @@
+# 🚀 NEX Framework
+
+> Framework completo de Agentes AI para desenvolvimento de software inteligente
+
+[![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/)
+[![JavaScript](https://img.shields.io/badge/JavaScript-97.9%25-yellow)](https://www.javascript.com/)
+
+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
+
+### 🎯 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
+
+### 🛠️ 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
+
+### Pré-requisitos
+
+- Node.js >= 18.0.0
+- npm ou yarn
+- Git
+- Conta no Supabase (para backend e banco de dados)
+- Conta no Vercel (para deploy do frontend)
+
+### Instalação Local
+
+```bash
+# Clone o repositório
+git clone https://github.com/INOSX/nex.git
+cd nex
+
+# 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 (em breve)
+
+```bash
+npm install -g @nex/framework
+```
+
+## 🚀 Início Rápido
+
+### 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
+# Inicializar um novo projeto
+nex init meu-projeto
+
+# Criar um plano completo
+nex plan --requirements "Sistema de e-commerce"
+
+# Executar um workflow
+nex workflow full-stack-app
+
+# Gerenciar agentes
+nex agent list
+nex agent install agent-id
+
+# 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
+
+### 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 Principal
+
+- **[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
+# Comandos principais
+nex init          # Inicializar projeto
+nex plan          # Criar plano de projeto
+nex workflow      # Executar workflows
+nex store         # Acessar NEX Store
+nex config        # Configurar framework
+
+# 🆕 Agent Marketplace Commands
+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
+```
+
+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
+# Buscar agents
+nex agent search "planning"
+
+# Instalar
+nex agent install anx
+
+# 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
+# Clone o repositório
+git clone https://github.com/INOSX/nex.git
+cd nex
+
+# Instale dependências
+npm install
+
+# 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
+
+# Execute em modo desenvolvimento
+npm run dev
+# Frontend estará em http://localhost:3000
+```
+
+Para mais detalhes, consulte: [docs/VITE_SUPABASE_SETUP.md](./docs/VITE_SUPABASE_SETUP.md)
+
+### Estrutura de Branches
+
+- `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
+
+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/issues)
+- **Documentação**: Veja a seção [Documentação](#-documentação)
+- **Email**: [Adicione seu email de suporte]
+
+## 🔗 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!