nex-app 2.0.0 → 2.0.2

package/cli/nex-cli.js

@@ -22,7 +22,15 @@ const program = new Command()
 program
   .name('nex')
   .description('NEX Framework - Framework completo de agentes AI')
-  .version('2.0.0')
+  .version('2.0.2')
+
+function getInstallerCommand() {
+  const node = process.execPath
+  const installerScript = path.join(__dirname, '..', 'scripts', 'install-cursor-rules.js')
+  const target = process.cwd()
+  // Importante: aspas para caminhos com espaços (Windows)
+  return `"${node}" "${installerScript}" --target "${target}"`
+}
 
 // Setup Wizard (executa quando sem comandos)
 async function runSetupWizard() {
@@ -49,20 +57,19 @@ async function runSetupWizard() {
     console.log(chalk.yellow('\n📦 Installing NEX Cursor Rules...\n'))
     
     try {
-      // Executar script de instalação
-      const { stdout } = await execAsync('npm run nex:install', { 
-        cwd: process.cwd(),
-        shell: true 
-      })
+      // Executar instalador do PRÓPRIO pacote (não depende do package.json do projeto)
+      const cmd = getInstallerCommand()
+      const { stdout } = await execAsync(cmd, { cwd: process.cwd(), shell: true })
       console.log(stdout)
       
       console.log(chalk.green('\n✅ NEX Cursor Rules installed successfully!\n'))
       console.log(chalk.cyan('Usage:'))
+      console.log(chalk.white('  • Validation agent: @vex'))
       console.log(chalk.white('  • In Cursor: @nex/core/agents/nex-master'))
       console.log(chalk.white('  • List all: @nex/index\n'))
     } catch (error) {
       console.log(chalk.yellow('⚠️  Could not auto-install. Run manually:'))
-      console.log(chalk.white('  npm run nex:install\n'))
+      console.log(chalk.white('  npx nex-app@latest install\n'))
     }
   }
   
@@ -72,7 +79,7 @@ async function runSetupWizard() {
     
     try {
       // Tentar abrir o browser
-      const url = 'https://nex.inosx.com/hub'
+      const url = 'https://nex-store.inosx.com/hub'
       const command = process.platform === 'win32' ? 'start' : 
                       process.platform === 'darwin' ? 'open' : 'xdg-open'
       
@@ -80,7 +87,7 @@ async function runSetupWizard() {
       console.log(chalk.green(`✅ NEX Hub opened at ${url}\n`))
     } catch (error) {
       console.log(chalk.yellow(`⚠️  Could not auto-open browser. Visit manually:`))
-      console.log(chalk.white(`  https://nex.inosx.com/hub\n`))
+      console.log(chalk.white(`  https://nex-store.inosx.com/hub\n`))
     }
   }
   
@@ -100,6 +107,29 @@ program
     await runSetupWizard()
   })
 
+// Instala as regras do Cursor no projeto atual (útil fora do wizard)
+program
+  .command('install')
+  .description('Instala regras do NEX no Cursor (.cursor/rules/nex/) no projeto atual')
+  .action(async () => {
+    const cmd = getInstallerCommand()
+    const { stdout } = await execAsync(cmd, { cwd: process.cwd(), shell: true })
+    console.log(stdout)
+  })
+
+// Valida as regras do Cursor no projeto atual
+program
+  .command('validate')
+  .description('Valida se as regras do NEX estão instaladas no projeto atual')
+  .action(async () => {
+    const node = process.execPath
+    const installerScript = path.join(__dirname, '..', 'scripts', 'install-cursor-rules.js')
+    const target = process.cwd()
+    const cmd = `"${node}" "${installerScript}" --validate --target "${target}"`
+    const { stdout } = await execAsync(cmd, { cwd: process.cwd(), shell: true })
+    console.log(stdout)
+  })
+
 // Comando: init
 program
   .command('init')

package/nex/vex.md

@@ -0,0 +1,23 @@
+# Vex - NEX Agent
+
+O **Vex** é um agente do NEX focado em **validação, consistência e rigor**.
+
+## Quando usar o Vex
+
+- **Antes de publicar** (npm / releases): checklist, riscos, “o que pode dar errado”
+- **Depois de mudar regras/agents**: valida se a estrutura e os handles do Cursor estão coerentes
+- **Quando algo “não ativa” no Cursor**: diagnóstico rápido e passos objetivos
+
+## Como falar comigo
+
+Diga em 1 frase:
+
+- **Objetivo** (o que você quer validar/garantir)
+- **Contexto** (onde está rodando, qual comando, qual erro)
+- **Resultado esperado** (o que deve acontecer)
+
+Exemplos:
+
+- “Valide se `npx nex-app@latest` instala corretamente no meu projeto e se o Cursor reconhece `@nex/index`.”
+- “Meu `@nex/core/agents/nex-master` não aparece no Cursor; me diga o checklist mínimo para corrigir.”
+

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "nex-app",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "NEX 2.0 - Multi-LLM AI Framework with Cursor Rules Integration | The easiest way to use AI agents in your development workflow",
   "type": "module",
   "main": "cli/nex-cli.js",
   "bin": {
-    "nex": "./cli/nex-cli.js"
+    "nex-app": "cli/nex-cli.js",
+    "nex": "cli/nex-cli.js"
   },
   "files": [
     "cli/",
@@ -56,7 +57,7 @@
   "license": "PROPRIETARY",
   "repository": {
     "type": "git",
-    "url": "https://github.com/INOSX/nex-store.git"
+    "url": "git+https://github.com/INOSX/nex-store.git"
   },
   "bugs": {
     "url": "https://github.com/INOSX/nex-store/issues"

package/scripts/install-cursor-rules.js

@@ -5,11 +5,13 @@
  * 
  * Instala apenas o essencial:
  * - nex-master (agente principal)
+ * - vex (agente de validação)
  * - workflows básicos do core
  * 
  * Uso:
  *   node scripts/install-cursor-rules.js
  *   node scripts/install-cursor-rules.js --validate
+ *   node scripts/install-cursor-rules.js --target <caminho-do-projeto>
  */
 
 import fs from 'fs-extra'
@@ -20,12 +22,13 @@ import chalk from 'chalk'
 const __filename = fileURLToPath(import.meta.url)
 const __dirname = path.dirname(__filename)
 
-const PROJECT_ROOT = path.resolve(__dirname, '..')
-const NEX_SOURCE = path.join(PROJECT_ROOT, 'nex')
-const CURSOR_RULES = path.join(PROJECT_ROOT, '.cursor', 'rules', 'nex')
+// O pacote (fonte) fica relativo a este arquivo.
+const PACKAGE_ROOT = path.resolve(__dirname, '..')
+const NEX_SOURCE = path.join(PACKAGE_ROOT, 'nex')
 
 // Arquivos essenciais para instalar
 const ESSENTIAL_FILES = [
+  'nex/vex.md',
   'nex/core/agents/nex-master.md',
   'nex/core/workflows/brainstorming/instructions.md',
   'nex/core/workflows/party-mode/instructions.md'
@@ -37,6 +40,26 @@ const CONFIG = {
   verbose: true
 }
 
+function parseArgs(argv) {
+  const args = argv.slice(2)
+  const result = {
+    validate: args.includes('--validate'),
+    target: undefined
+  }
+
+  const targetIdx = args.findIndex(a => a === '--target')
+  if (targetIdx !== -1 && args[targetIdx + 1]) {
+    result.target = args[targetIdx + 1]
+  }
+
+  return result
+}
+
+function resolveTargetRoot(targetArg) {
+  // Por padrão: instala no projeto atual (onde o usuário rodou o comando)
+  return path.resolve(targetArg || process.cwd())
+}
+
 // ============================================================================
 // Log Functions
 // ============================================================================
@@ -117,7 +140,7 @@ function convertToMDC(sourceFile, targetFile) {
     // Escrever arquivo .mdc
     fs.writeFileSync(targetFile, mdcContent, 'utf-8')
     
-    log(`Created: ${path.relative(PROJECT_ROOT, targetFile)}`, 'success')
+    log(`Created: ${targetFile}`, 'success')
     return true
   } catch (error) {
     log(`Error converting ${sourceFile}: ${error.message}`, 'error')
@@ -129,8 +152,8 @@ function convertToMDC(sourceFile, targetFile) {
 // Create Index
 // ============================================================================
 
-function createIndex() {
-  const indexPath = path.join(CURSOR_RULES, 'index.mdc')
+function createIndex(cursorRulesDir) {
+  const indexPath = path.join(cursorRulesDir, 'index.mdc')
   
   const indexContent = `---
 description: NEX Framework - Cursor Rules Index
@@ -150,12 +173,16 @@ NEX rules have been installed to: \`.cursor/rules/nex/\`
 
 ## How to Use
 
+- Reference Vex (validation agent): **@vex** (or **@nex/vex**)
 - Reference the master agent: **@nex/core/agents/nex-master**
 - Reference workflows: **@nex/core/workflows/brainstorming** or **@nex/core/workflows/party-mode**
 - Reference this index: **@nex/index**
 
 ## Installed Components
 
+### Core Agent (Validation)
+- @vex - Vex (validation, consistency, troubleshooting)
+
 ### Core Agent
 - @nex/core/agents/nex-master - NEX Master Agent (your main AI assistant)
 
@@ -176,8 +203,7 @@ Reference them explicitly when you need specific functionality.
 
 ---
 
-**Project:** nex-agents
-**Version:** 2.0.0
+**Project:** NEX (installed via nex-app)
 **Created:** ${new Date().toISOString()}
 `
 
@@ -195,7 +221,7 @@ Reference them explicitly when you need specific functionality.
 // Main Install Function
 // ============================================================================
 
-async function install() {
+async function install(targetRoot) {
   console.log(chalk.bold.blue('\n🚀 NEX Cursor Rules Installer (Simplified)\n'))
   
   let successCount = 0
@@ -203,13 +229,14 @@ async function install() {
 
   // Criar diretório .cursor/rules/nex
   log('Creating directory structure...', 'info')
-  fs.ensureDirSync(CURSOR_RULES)
+  const cursorRulesDir = path.join(targetRoot, '.cursor', 'rules', 'nex')
+  fs.ensureDirSync(cursorRulesDir)
 
   // Processar arquivos essenciais
   log('\nInstalling essential NEX components...', 'info')
   
   for (const relativePath of ESSENTIAL_FILES) {
-    const sourceFile = path.join(PROJECT_ROOT, relativePath)
+    const sourceFile = path.join(PACKAGE_ROOT, relativePath)
     
     if (!fs.existsSync(sourceFile)) {
       log(`File not found: ${relativePath}`, 'warning')
@@ -218,7 +245,7 @@ async function install() {
 
     // Determinar caminho de destino
     const relativeToNex = path.relative(NEX_SOURCE, sourceFile)
-    const targetFile = path.join(CURSOR_RULES, relativeToNex.replace('.md', '.mdc'))
+    const targetFile = path.join(cursorRulesDir, relativeToNex.replace('.md', '.mdc'))
 
     // Converter
     if (convertToMDC(sourceFile, targetFile)) {
@@ -230,7 +257,7 @@ async function install() {
 
   // Criar index.mdc
   log('\nCreating index file...', 'info')
-  if (createIndex()) {
+  if (createIndex(cursorRulesDir)) {
     successCount++
   } else {
     errorCount++
@@ -244,10 +271,11 @@ async function install() {
   }
   
   console.log(chalk.cyan('\n📖 Usage:'))
+  console.log(chalk.white('   Validation agent: @vex'))
   console.log(chalk.white('   In Cursor, type: @nex/core/agents/nex-master'))
   console.log(chalk.white('   Or reference: @nex/index\n'))
   
-  console.log(chalk.gray('   Files installed in: .cursor/rules/nex/\n'))
+  console.log(chalk.gray(`   Files installed in: ${cursorRulesDir}\n`))
 
   return errorCount === 0
 }
@@ -256,14 +284,16 @@ async function install() {
 // Validate Function
 // ============================================================================
 
-async function validate() {
+async function validate(targetRoot) {
   console.log(chalk.bold.blue('\n🔍 NEX Installation Validator\n'))
   
   let validCount = 0
   let invalidCount = 0
 
+  const cursorRulesDir = path.join(targetRoot, '.cursor', 'rules', 'nex')
+
   // Verificar diretório
-  if (!fs.existsSync(CURSOR_RULES)) {
+  if (!fs.existsSync(cursorRulesDir)) {
     log('NEX not installed (.cursor/rules/nex/ not found)', 'error')
     return false
   }
@@ -272,6 +302,7 @@ async function validate() {
 
   // Verificar arquivos essenciais
   const expectedFiles = [
+    'vex.mdc',
     'core/agents/nex-master.mdc',
     'core/workflows/brainstorming/instructions.mdc',
     'core/workflows/party-mode/instructions.mdc',
@@ -279,7 +310,7 @@ async function validate() {
   ]
 
   for (const file of expectedFiles) {
-    const filePath = path.join(CURSOR_RULES, file)
+    const filePath = path.join(cursorRulesDir, file)
     if (fs.existsSync(filePath)) {
       log(`✓ ${file}`, 'success')
       validCount++
@@ -293,7 +324,7 @@ async function validate() {
   console.log(chalk.white(`Valid: ${validCount}`))
   if (invalidCount > 0) {
     console.log(chalk.yellow(`Invalid: ${invalidCount}`))
-    console.log(chalk.cyan('\nRun: npm run nex:install\n'))
+    console.log(chalk.cyan('\nRun: npx nex-app@latest install\n'))
   }
 
   return invalidCount === 0
@@ -303,17 +334,18 @@ async function validate() {
 // Main
 // ============================================================================
 
-const args = process.argv.slice(2)
+const parsed = parseArgs(process.argv)
+const targetRoot = resolveTargetRoot(parsed.target)
 
-if (args.includes('--validate')) {
-  validate()
+if (parsed.validate) {
+  validate(targetRoot)
     .then(success => process.exit(success ? 0 : 1))
     .catch(error => {
       console.error(chalk.red(`\n✗ Validation failed: ${error.message}\n`))
       process.exit(1)
     })
 } else {
-  install()
+  install(targetRoot)
     .then(success => process.exit(success ? 0 : 1))
     .catch(error => {
       console.error(chalk.red(`\n✗ Installation failed: ${error.message}\n`))