nex-framework-cli 1.0.1

package/cli/nex-cli.js

@@ -0,0 +1,321 @@
+#!/usr/bin/env node
+
+/**
+ * NEX CLI - Interface de linha de comando do NEX Framework
+ */
+import { Command } from 'commander'
+import chalk from 'chalk'
+import inquirer from 'inquirer'
+import fs from 'fs-extra'
+import path from 'path'
+import { fileURLToPath } from 'url'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+const program = new Command()
+
+program
+  .name('nex')
+  .description('NEX Framework - Framework completo de agentes AI')
+  .version('1.0.0')
+
+// Comando: init
+program
+  .command('init')
+  .description('Inicializa um novo projeto NEX')
+  .option('-n, --name <name>', 'Nome do projeto')
+  .option('-t, --template <template>', 'Template a usar')
+  .action(async (options) => {
+    console.log(chalk.blue('🚀 Inicializando projeto NEX...'))
+    
+    const answers = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'projectName',
+        message: 'Nome do projeto:',
+        default: options.name || 'nex-project',
+        when: !options.name
+      },
+      {
+        type: 'list',
+        name: 'template',
+        message: 'Escolha um template:',
+        choices: ['blank', 'full-stack', 'api-only', 'mobile'],
+        default: options.template || 'blank',
+        when: !options.template
+      }
+    ])
+
+    const projectName = options.name || answers.projectName
+    const template = options.template || answers.template
+
+    // Criar estrutura do projeto
+    await createProjectStructure(projectName, template)
+    
+    console.log(chalk.green(`✅ Projeto ${projectName} criado com sucesso!`))
+  })
+
+// Comando: plan
+program
+  .command('plan')
+  .description('Gera plano completo do projeto (PRD, arquitetura, etc.)')
+  .option('-r, --requirements <file>', 'Arquivo de requisitos')
+  .option('-o, --output <dir>', 'Diretório de saída')
+  .action(async (options) => {
+    console.log(chalk.blue('📋 Gerando plano do projeto...'))
+    
+    // Importar agentes de planejamento
+    const { default: ANX } = await import('../src/services/nex/agents/planning/ANX.js')
+    const { default: PMX } = await import('../src/services/nex/agents/planning/PMX.js')
+    const { default: ARX } = await import('../src/services/nex/agents/planning/ARX.js')
+    const { default: DocumentGenerator } = await import('../src/services/nex/core/documentGenerator.js')
+
+    const anx = new ANX()
+    const pmx = new PMX()
+    const arx = new ARX()
+    const docGen = new DocumentGenerator()
+
+    // Ler requisitos
+    const requirements = options.requirements 
+      ? await fs.readJSON(options.requirements)
+      : await promptRequirements()
+
+    // Análise
+    console.log(chalk.yellow('🔍 Analisando requisitos...'))
+    const analysis = await anx.analyzeRequirements(requirements)
+
+    // PRD
+    console.log(chalk.yellow('📝 Criando PRD...'))
+    const prdResult = await pmx.createPRD(analysis, requirements)
+    const prdPath = await docGen.generatePRD(prdResult.prd)
+
+    // Arquitetura
+    console.log(chalk.yellow('🏗️ Projetando arquitetura...'))
+    const archResult = await arx.designArchitecture(prdResult.prd, analysis)
+    const archPath = await docGen.generateArchitectureDoc(archResult.architecture)
+
+    console.log(chalk.green('✅ Plano gerado com sucesso!'))
+    console.log(chalk.cyan(`📄 PRD: ${prdPath}`))
+    console.log(chalk.cyan(`🏗️ Arquitetura: ${archPath}`))
+  })
+
+// Comando: agent (Marketplace Integration)
+const agentCmd = program
+  .command('agent')
+  .description('Gerencia agentes do NEX Marketplace')
+
+// agent search
+agentCmd
+  .command('search <query>')
+  .description('Busca agentes no marketplace')
+  .option('-c, --category <category>', 'Filtrar por categoria')
+  .option('--official', 'Apenas agentes oficiais')
+  .option('-l, --limit <number>', 'Limitar resultados', '50')
+  .action(async (query, options) => {
+    const { default: NEXMarketplace } = await import('../src/services/nex-marketplace/NEXMarketplace.js')
+    const marketplace = new NEXMarketplace()
+    await marketplace.search(query, options)
+  })
+
+// agent install
+agentCmd
+  .command('install <agentId>')
+  .description('Instala um agente')
+  .option('-v, --version <version>', 'Versão específica')
+  .option('-m, --method <method>', 'Método de instalação (symlink|copy)')
+  .action(async (agentId, options) => {
+    const { default: NEXMarketplace } = await import('../src/services/nex-marketplace/NEXMarketplace.js')
+    const marketplace = new NEXMarketplace()
+    await marketplace.install(agentId, options)
+  })
+
+// agent list
+agentCmd
+  .command('list')
+  .alias('ls')
+  .description('Lista agentes instalados')
+  .option('-a, --all', 'Mostrar todos os agentes')
+  .action(async (options) => {
+    const { default: NEXMarketplace } = await import('../src/services/nex-marketplace/NEXMarketplace.js')
+    const marketplace = new NEXMarketplace()
+    await marketplace.list(options)
+  })
+
+// agent info
+agentCmd
+  .command('info <agentId>')
+  .description('Mostra informações detalhadas do agente')
+  .action(async (agentId) => {
+    const { default: NEXMarketplace } = await import('../src/services/nex-marketplace/NEXMarketplace.js')
+    const marketplace = new NEXMarketplace()
+    await marketplace.info(agentId)
+  })
+
+// agent uninstall
+agentCmd
+  .command('uninstall <agentId>')
+  .alias('remove')
+  .description('Remove um agente instalado')
+  .action(async (agentId) => {
+    const { default: NEXMarketplace } = await import('../src/services/nex-marketplace/NEXMarketplace.js')
+    const marketplace = new NEXMarketplace()
+    await marketplace.uninstall(agentId)
+  })
+
+// agent update
+agentCmd
+  .command('update [agentId]')
+  .description('Atualiza agente(s)')
+  .option('-a, --all', 'Atualizar todos os agentes')
+  .action(async (agentId, options) => {
+    const { default: NEXMarketplace } = await import('../src/services/nex-marketplace/NEXMarketplace.js')
+    const marketplace = new NEXMarketplace()
+    
+    if (options.all) {
+      const installed = await marketplace.list({ silent: true })
+      for (const agent of installed) {
+        await marketplace.update(agent.id)
+      }
+    } else if (agentId) {
+      await marketplace.update(agentId)
+    } else {
+      console.log(chalk.yellow('Especifique um agente ou use --all'))
+    }
+  })
+
+// agent register
+agentCmd
+  .command('register <agentId>')
+  .description('Registra um agente no NEX Hub para uso')
+  .action(async (agentId) => {
+    const { default: NEXMarketplace } = await import('../src/services/nex-marketplace/NEXMarketplace.js')
+    const marketplace = new NEXMarketplace()
+    await marketplace.register(agentId)
+  })
+
+// agent my-agents
+agentCmd
+  .command('my-agents')
+  .alias('registered')
+  .description('Lista agentes registrados no NEX Hub')
+  .action(async () => {
+    const { default: NEXMarketplace } = await import('../src/services/nex-marketplace/NEXMarketplace.js')
+    const marketplace = new NEXMarketplace()
+    await marketplace.listRegisteredAgents()
+  })
+
+// Comando: store
+program
+  .command('store')
+  .description('Interage com a NEX Store')
+  .option('browse', 'Abre a NEX Store no navegador')
+  .option('search <query>', 'Busca agentes na store')
+  .option('publish', 'Publica um agente na store')
+  .action(async (options) => {
+    if (options.browse) {
+      console.log(chalk.blue('🌐 Abrindo NEX Store...'))
+      // Abrir store
+    } else if (options.search) {
+      console.log(chalk.blue(`🔍 Buscando: ${options.search}`))
+      // Buscar agentes
+    } else if (options.publish) {
+      console.log(chalk.blue('📤 Publicando agente...'))
+      // Publicar agente
+    }
+  })
+
+// Comando: workflow
+program
+  .command('workflow')
+  .description('Executa workflows')
+  .option('list', 'Lista workflows disponíveis')
+  .option('run <workflow>', 'Executa um workflow')
+  .action(async (options) => {
+    if (options.list) {
+      console.log(chalk.blue('📋 Workflows disponíveis:'))
+      // Listar workflows
+    } else if (options.run) {
+      console.log(chalk.blue(`▶️ Executando workflow: ${options.run}`))
+      // Executar workflow
+    }
+  })
+
+// Comando: config
+program
+  .command('config')
+  .description('Gerencia configurações')
+  .option('get <key>', 'Obtém valor de configuração')
+  .option('set <key> <value>', 'Define valor de configuração')
+  .option('list', 'Lista todas as configurações')
+  .action(async (options) => {
+    if (options.get) {
+      // Obter configuração
+    } else if (options.set) {
+      // Definir configuração
+    } else if (options.list) {
+      // Listar configurações
+    }
+  })
+
+// Funções auxiliares
+async function createProjectStructure(projectName, template) {
+  const projectDir = path.join(process.cwd(), projectName)
+  await fs.ensureDir(projectDir)
+
+  // Criar estrutura básica
+  await fs.ensureDir(path.join(projectDir, 'src'))
+  await fs.ensureDir(path.join(projectDir, '.nex-core'))
+  await fs.ensureDir(path.join(projectDir, '.nex-core', 'agents'))
+  await fs.ensureDir(path.join(projectDir, '.nex-core', 'data'))
+  await fs.ensureDir(path.join(projectDir, '.nex-core', 'documents'))
+
+  // Criar package.json
+  const packageJson = {
+    name: projectName,
+    version: '1.0.0',
+    type: 'module',
+    scripts: {
+      start: 'node src/index.js',
+      dev: 'node --watch src/index.js'
+    }
+  }
+  await fs.writeJSON(path.join(projectDir, 'package.json'), packageJson, { spaces: 2 })
+
+  // Criar README
+  const readme = `# ${projectName}
+
+Projeto criado com NEX Framework.
+
+## Getting Started
+
+\`\`\`bash
+npm install
+npm start
+\`\`\`
+`
+  await fs.writeFile(path.join(projectDir, 'README.md'), readme)
+}
+
+async function promptRequirements() {
+  const answers = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'description',
+      message: 'Descreva o projeto:'
+    },
+    {
+      type: 'input',
+      name: 'features',
+      message: 'Liste as principais funcionalidades (separadas por vírgula):'
+    }
+  ])
+
+  return {
+    description: answers.description,
+    features: answers.features.split(',').map(f => f.trim())
+  }
+}
+
+program.parse(process.argv)
+

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "nex-framework-cli",
+  "version": "1.0.1",
+  "description": "NEX CLI - Command-line interface for NEX Framework and Agent Marketplace",
+  "type": "module",
+  "main": "cli/nex-cli.js",
+  "bin": {
+    "nex": "./cli/nex-cli.js"
+  },
+  "files": [
+    "cli/",
+    "src/services/nex-marketplace/",
+    "src/services/nex-installer/",
+    "registry/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "prepublishOnly": "npm run test",
+    "test": "node cli/nex-cli.js --version"
+  },
+  "keywords": [
+    "nex",
+    "nex-cli",
+    "ai",
+    "agents",
+    "framework",
+    "marketplace",
+    "cli",
+    "command-line"
+  ],
+  "author": "INOSX (https://inosx.com)",
+  "license": "PROPRIETARY",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/INOSX/nex-store.git"
+  },
+  "bugs": {
+    "url": "https://github.com/INOSX/nex-store/issues"
+  },
+  "homepage": "https://github.com/INOSX/nex-store#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@supabase/supabase-js": "^2.39.0",
+    "chalk": "^5.3.0",
+    "commander": "^11.1.0",
+    "fs-extra": "^11.2.0",
+    "glob": "^10.3.10",
+    "inquirer": "^9.2.15",
+    "ora": "^8.0.1",
+    "semver": "^7.5.4",
+    "yaml": "^2.3.4"
+  }
+}

package/registry/.meta/registry.yaml

@@ -0,0 +1,72 @@
+# NEX Agent Registry Configuration
+registry:
+  name: "NEX Expert Agent Marketplace"
+  version: "1.0.0"
+  type: hybrid  # local + git + supabase
+  description: "Universal marketplace for NEX Framework agents"
+
+# Paths
+paths:
+  planning: ./planning
+  execution: ./execution
+  community: ./community
+  templates: ../templates/agent-template
+
+# Remote sync
+remote:
+  enabled: true
+  type: supabase
+  sync_on_install: true
+  auto_update_check: true
+
+# Local configuration
+local:
+  cache_enabled: true
+  cache_ttl_hours: 24
+  auto_compile: true
+  
+# Installation defaults
+defaults:
+  install_location: .nex-core/agents
+  method: symlink  # symlink, copy
+  backup_before_update: true
+  auto_dependency_install: true
+
+# Security
+security:
+  verify_manifests: true
+  allow_unsigned: false  # Only for development
+  trusted_authors:
+    - INOSX
+    - nex-official
+  scan_code: true
+
+# Analytics
+analytics:
+  enabled: true
+  level: minimal  # minimal, standard, detailed
+  anonymous: true
+
+# Categories
+categories:
+  planning:
+    - ANX  # Analysis
+    - PMX  # Product Management
+    - ARX  # Architecture
+    - DVX  # Development
+    - DOCX  # Documentation
+    - QAX  # Quality Assurance
+    - DEPX  # Deployment
+    - MONX  # Monitoring
+    
+  execution:
+    - ORDX  # Order/Validation
+    - FLX   # Flow/Planning
+    - AGX   # Action/Domain
+    - OPX   # Technical/Specialized
+
+# Store integration
+store:
+  enabled: true
+  url: http://localhost:3000/store
+  api_url: http://localhost:3000/api/store

package/registry/README.md

@@ -0,0 +1,181 @@
+# 🏪 NEX Agent Registry
+
+> Official & Community Agent Repository
+
+Este é o registry oficial de agents do NEX Framework. Aqui você encontra agents oficiais da INOSX e agents da comunidade.
+
+## 📁 Estrutura
+
+```
+registry/
+├── .meta/
+│   └── registry.yaml       # Configuração do registry
+│
+├── planning/               # Agents de planejamento
+│   ├── anx/               # Analysis Expert
+│   ├── pmx/               # Product Management Expert
+│   ├── arx/               # Architecture Expert
+│   ├── dvx/               # Development Expert
+│   ├── docx/              # Documentation Expert
+│   ├── qax/               # Quality Assurance Expert
+│   ├── depx/              # Deployment Expert
+│   └── monx/              # Monitoring Expert
+│
+├── execution/             # Agents de execução
+│   ├── supervisor/        # Supervisor Agent
+│   ├── voice-intent/      # Voice Intent Agent
+│   └── ...                # Outros 18 agents
+│
+├── community/             # Agents da comunidade
+│   └── ...                # Submit via PR
+│
+└── .templates/            # Templates para novos agents
+    └── agent-template/
+```
+
+## 🎯 Agents Oficiais
+
+### 🔷 NEX Planning Agents (8)
+
+| ID | Name | Category | Status |
+|----|------|----------|--------|
+| **anx** | Analysis Expert | FLX | ✅ Stable |
+| **pmx** | Product Management Expert | FLX | ✅ Stable |
+| **arx** | Architecture Expert | OPX | ✅ Stable |
+| **dvx** | Development Expert | AGX | 🚧 Beta |
+| **docx** | Documentation Expert | OPX | 🚧 Beta |
+| **qax** | Quality Assurance Expert | ORDX | 🚧 Beta |
+| **depx** | Deployment Expert | AGX | 🚧 Beta |
+| **monx** | Monitoring Expert | ORDX | 🚧 Beta |
+
+### ⚡ NEX Execution Agents (18)
+
+Ver [documentação completa](../DOCUMENTACAO_AGENTES_NEX.md) para lista de agents de execução.
+
+### 💎 BMAD Expert Agents (3) ⭐ NEW!
+
+| ID | Name | Specialty | Status |
+|----|------|-----------|--------|
+| **vex** | The Conversion Hypnotist | CRO & Psychology | ✅ Stable |
+| **ada** | The Analytics Oracle | Data & Insights | ✅ Stable |
+| **rex** | The SEO Master | SEO & Growth | ✅ Stable |
+
+**BMAD = Better Model for AI Development**
+
+Agents especializados que funcionam em **Cursor + NEX**:
+- 🎭 **VEX** - Conversion optimization (Cialdini + AIDA)
+- 📊 **ADA** - Analytics intelligence (AARRR + NSM)
+- 🔍 **REX** - SEO strategy (E-E-A-T + Topic Clusters)
+
+[Ver documentação BMAD →](./bmad/README.md)
+
+## 🚀 Como Usar
+
+### Instalar NEX Agent
+
+```bash
+nex agent install anx      # Planning agent
+nex agent install pmx      # Product manager
+```
+
+### Instalar BMAD Agent
+
+```bash
+nex agent install vex      # Conversion expert
+nex agent install ada      # Analytics expert
+nex agent install rex      # SEO expert
+```
+
+### Buscar Agents
+
+```bash
+nex agent search "planning"       # NEX agents
+nex agent search "" --category bmad  # BMAD agents
+```
+
+### Ver Detalhes
+
+```bash
+nex agent info anx         # NEX agent
+nex agent info vex         # BMAD agent
+```
+
+## 📤 Submeter Agent
+
+### 1. Crie seu Agent
+
+Use o template:
+
+```bash
+cp -r .templates/agent-template community/my-agent
+cd community/my-agent
+```
+
+### 2. Edite Manifest
+
+Edite `manifest.yaml` com informações do seu agent.
+
+### 3. Adicione README
+
+Documente seu agent em `README.md`.
+
+### 4. Teste Localmente
+
+```bash
+nex agent install my-agent
+nex agent info my-agent
+```
+
+### 5. Submit Pull Request
+
+```bash
+git checkout -b add-my-agent
+git add registry/community/my-agent/
+git commit -m "Add: My Agent - Does X Y Z"
+git push origin add-my-agent
+```
+
+Abra PR no GitHub!
+
+## 📋 Requisitos para Aprovação
+
+✅ **Obrigatório:**
+- [ ] `manifest.yaml` completo e válido
+- [ ] `README.md` com documentação clara
+- [ ] Código sem vulnerabilidades
+- [ ] Testes passando (se aplicável)
+- [ ] Licença especificada
+
+🌟 **Recomendado:**
+- [ ] `CHANGELOG.md` com histórico
+- [ ] Screenshots ou demos
+- [ ] Exemplos de uso
+- [ ] Testes unitários
+
+## 🔐 Segurança
+
+Todos os agents passam por:
+- ✅ Code scanning automático
+- ✅ Dependency vulnerability check
+- ✅ Manual review (agents comunitários)
+- ✅ Sandbox testing
+
+## 📊 Stats
+
+- **Total Agents**: 26+
+- **Official**: 26
+- **Community**: 0+ (aceita contribuições!)
+- **Total Installs**: Tracking via Supabase
+
+## 🤝 Contribua
+
+Veja nosso [guia de contribuição](../docs/NEX_AGENT_MARKETPLACE.md#contribuindo).
+
+## 📄 Licença
+
+- **Agents Oficiais**: Proprietary (INOSX)
+- **Agents Comunitários**: Conforme licença de cada agent
+
+---
+
+**Registry mantido por [INOSX](https://inosx.com)**