nex-framework-cli 1.0.20 → 1.0.22

package/cli/nex-cli.js

@@ -28,7 +28,7 @@ program.configureHelp({
 program
   .name('nex')
   .description('NEX Framework - Framework completo de agentes AI')
-      .version('1.0.19', '-v, --version', 'Mostra a versão')
+      .version('1.0.21', '-v, --version', 'Mostra a versão')
   .addHelpText('before', chalk.bold.cyan(`
 ╔════════════════════════════════════════════════════════════════╗
 ║              NEX Framework - CLI v1.0.9                        ║

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nex-framework-cli",
-  "version": "1.0.20",
+  "version": "1.0.22",
   "description": "NEX CLI - Command-line interface for NEX Framework and Agent Marketplace",
   "type": "module",
   "main": "cli/nex-cli.js",

package/scripts/postinstall.js

@@ -116,7 +116,7 @@ export async function runSetup(force = false) {
       enabled: answers.cursorIntegration
     },
     installedAt: new Date().toISOString(),
-    version: '1.0.19'
+    version: '1.0.21'
   }
   
   // Save config
@@ -132,48 +132,39 @@ export async function runSetup(force = false) {
   console.log(chalk.cyan('\n💡 Dica: Para reconfigurar, execute: nex config reset\n'))
 }
 
-// Check if running in interactive mode (TTY available)
-const isInteractive = process.stdin.isTTY && process.stdout.isTTY && process.stderr.isTTY
-const isCI = process.env.CI === 'true'
-const skipSetup = process.env.NEX_SKIP_SETUP === 'true'
-
-// Only run interactive setup if:
-// 1. Not in CI
-// 2. Not explicitly skipped
-// 3. Running in interactive mode (TTY)
-if (!isCI && !skipSetup && isInteractive) {
-  runSetup().catch((error) => {
-    console.error(chalk.red('\n❌ Erro ao configurar NEX CLI:'))
-    console.error(chalk.red(error.message))
-    console.log(chalk.yellow('\n💡 Você pode configurar manualmente depois executando: nex config reset\n'))
-    process.exit(0) // Don't fail the install
-  })
-} else {
-  // Non-interactive mode: create default config silently
-  const configPath = getGlobalConfigPath()
-  const configDir = path.dirname(configPath)
-  const defaultConfig = {
-    user: {
-      name: process.env.USER || process.env.USERNAME || 'Developer',
-      conversationLanguage: 'pt-BR',
-      documentLanguage: 'pt-BR'
-    },
+// Always create default config silently (fast, non-blocking)
+// User can configure later with: nex config reset
+const configPath = getGlobalConfigPath()
+const configDir = path.dirname(configPath)
+const defaultConfig = {
+  user: {
+    name: process.env.USER || process.env.USERNAME || 'Developer',
+    conversationLanguage: 'pt-BR',
+    documentLanguage: 'pt-BR'
+  },
     cursor: {
       enabled: false
     },
     installedAt: new Date().toISOString(),
-    version: '1.0.19'
+    version: '1.0.21'
   }
-  
-  fs.ensureDir(configDir)
-    .then(() => fs.writeJSON(configPath, defaultConfig, { spaces: 2 }))
-    .then(() => {
-      if (!isCI && isInteractive) {
-        console.log(chalk.green('\n✅ NEX CLI instalado com configuração padrão'))
-        console.log(chalk.gray('   Para configurar: nex config reset\n'))
-      }
-    })
-    .catch(() => {
-      // Silently fail in non-interactive mode
-    })
-}
+
+// Create config asynchronously without blocking
+fs.ensureDir(configDir)
+  .then(() => fs.writeJSON(configPath, defaultConfig, { spaces: 2 }))
+  .then(() => {
+    // Only show message if in interactive mode and not CI
+    const isInteractive = process.stdin.isTTY && process.stdout.isTTY && process.stderr.isTTY
+    const isCI = process.env.CI === 'true'
+    if (!isCI && isInteractive) {
+      console.log(chalk.green('\n✅ NEX CLI instalado com configuração padrão'))
+      console.log(chalk.gray('   Para configurar: nex config reset\n'))
+    }
+  })
+  .catch(() => {
+    // Silently fail - don't block installation
+  })
+  .finally(() => {
+    // Always exit successfully to not block npm install
+    process.exit(0)
+  })

package/src/services/nex-marketplace/NEXMarketplace.js

@@ -1021,98 +1021,103 @@ export default class NEXMarketplace {
   }
 
   /**
-   * Integrate BMAD agent with Cursor
+   * Integrate BMAD agent with Cursor (following BMAD pattern)
+   * Creates .mdc files in .cursor/rules/nex/ similar to BMAD
    */
   async integrateWithCursor(agentId, manifest, sourcePath) {
     try {
-      const rulesFile = manifest.bmad?.rules_file
-      if (!rulesFile) {
-        return // No rules file specified
+      // Get global config for user info
+      const globalConfig = this.getGlobalConfig()
+      const userConfig = globalConfig.user || {}
+      
+      // Create NEX core config directory (similar to BMAD)
+      const nexCoreDir = path.join(this.projectRoot, 'nex', 'core')
+      await fs.ensureDir(nexCoreDir)
+      
+      // Create config.yaml (similar to BMAD)
+      const configYaml = {
+        user_name: userConfig.name || 'Developer',
+        communication_language: userConfig.conversationLanguage || 'pt-br',
+        document_output_language: userConfig.documentLanguage || 'pt-br',
+        output_folder: '{project-root}/docs'
       }
       
-      // Path to .cursorrules file in agent directory
-      let agentRulesPath = path.join(sourcePath, rulesFile)
-      
-      // Check if rules file exists
-      if (!await fs.pathExists(agentRulesPath)) {
-        // Try alternative locations
-        const alternativePaths = [
-          path.join(sourcePath, '..', rulesFile), // Parent directory
-          path.join(this.registryPath, manifest.category || 'bmad', agentId, rulesFile), // Registry root
-          path.join(this.registryPath, 'bmad', agentId, rulesFile) // BMAD category
-        ]
-        
-        let foundPath = null
-        for (const altPath of alternativePaths) {
-          if (await fs.pathExists(altPath)) {
-            foundPath = altPath
-            break
-          }
+      const configPath = path.join(nexCoreDir, 'config.yaml')
+      if (!await fs.pathExists(configPath)) {
+        const configYamlContent = yaml.stringify(configYaml)
+        await fs.writeFile(configPath, configYamlContent, 'utf8')
+      }
+      
+      // Create .cursor/rules/nex directory structure (following BMAD pattern)
+      const cursorRulesDir = path.join(this.projectRoot, '.cursor', 'rules', 'nex')
+      const agentCategory = manifest.category || 'bmad'
+      const agentRulesDir = path.join(cursorRulesDir, agentCategory, 'agents')
+      await fs.ensureDir(agentRulesDir)
+      
+      // Check if agent has a README.md or similar file to convert to .mdc
+      let agentContent = ''
+      const possibleAgentFiles = [
+        path.join(sourcePath, 'README.md'),
+        path.join(sourcePath, `${agentId}.md`),
+        path.join(sourcePath, 'agent.md')
+      ]
+      
+      let agentFile = null
+      for (const filePath of possibleAgentFiles) {
+        if (await fs.pathExists(filePath)) {
+          agentFile = filePath
+          agentContent = await fs.readFile(filePath, 'utf8')
+          break
         }
-        
-        if (!foundPath) {
-          // Create a basic .cursorrules file from manifest
-          const trigger = manifest.bmad?.activation_trigger || `@${agentId}`
-          const basicRules = `# ${manifest.name}
-# ${manifest.tagline || manifest.description?.substring(0, 100)}
+      }
+      
+      // If no agent file found, create one from manifest
+      if (!agentFile) {
+        const trigger = manifest.bmad?.activation_trigger || `@${agentId}`
+        agentContent = `# ${manifest.name}
+
+${manifest.tagline || manifest.description || ''}
+
+## Activation
+
+Use \`${trigger}\` in Cursor to activate this agent.
+
+## Description
+
+${manifest.long_description || manifest.description || 'NEX Agent'}
 
-# Activation: ${trigger}
+## Usage
 
-# ${manifest.name} - ${manifest.description || 'BMAD Expert Agent'}
+\`\`\`
+${trigger} <command>
+\`\`\`
 
-# Usage in Cursor:
-# ${trigger} <command>
+## Examples
 
-# Example:
-# ${trigger} analyze-page https://example.com
+${trigger} analyze-page https://example.com
 `
-          
-          // Write basic rules file to agent directory
-          await fs.writeFile(agentRulesPath, basicRules, 'utf8')
-          console.log(chalk.cyan(`\n📝 Created basic Cursor rules file: ${rulesFile}`))
-        } else {
-          agentRulesPath = foundPath
-        }
       }
       
-      // Create .cursorrules directory in project (for storing individual agent rules)
-      const cursorRulesDir = path.join(this.projectRoot, '.cursorrules')
-      await fs.ensureDir(cursorRulesDir)
-      
-      // Copy rules file to .cursorrules directory
-      const targetRulesPath = path.join(cursorRulesDir, rulesFile)
-      await fs.copy(agentRulesPath, targetRulesPath)
-      
-      // Update main .cursorrules file (in project root)
-      const mainCursorRulesPath = path.join(this.projectRoot, '.cursorrules')
-      const importLine = `import .cursorrules/${rulesFile}`
-      const commentLine = `# ${manifest.name} - ${manifest.tagline || manifest.description?.substring(0, 50)}`
-      const agentTrigger = manifest.bmad?.activation_trigger || `@${agentId}`
-      const agentComment = `# Use: ${agentTrigger} <command>`
-      
-      let cursorRulesContent = ''
-      if (await fs.pathExists(mainCursorRulesPath)) {
-        cursorRulesContent = await fs.readFile(mainCursorRulesPath, 'utf8')
-      }
-      
-      // Check if already imported
-      if (cursorRulesContent.includes(importLine) || cursorRulesContent.includes(rulesFile)) {
-        // Already integrated, skip
-        return
-      }
+      // Convert to .mdc format (similar to BMAD)
+      const mdcContent = `---
+description: ${manifest.name} - ${manifest.tagline || manifest.description?.substring(0, 100) || 'NEX Agent'}
+globs: 
+alwaysApply: false
+---
+
+${agentContent}`
       
-      // Add import to .cursorrules
-      const newContent = cursorRulesContent + 
-        (cursorRulesContent ? '\n\n' : '') +
-        commentLine + '\n' +
-        agentComment + '\n' +
-        importLine + '\n'
+      // Write .mdc file
+      const mdcPath = path.join(agentRulesDir, `${agentId}.mdc`)
+      await fs.writeFile(mdcPath, mdcContent, 'utf8')
       
-      await fs.writeFile(mainCursorRulesPath, newContent, 'utf8')
+      // Update index.mdc (similar to BMAD index)
+      await this.updateNexIndex(agentId, manifest, agentCategory)
       
+      const agentTrigger = manifest.bmad?.activation_trigger || `@${agentId}`
       console.log(chalk.green(`\n✅ Cursor integration complete!`))
-      console.log(chalk.gray(`   Added ${rulesFile} to .cursorrules`))
-      console.log(chalk.gray(`   Use: ${agentTrigger} <command> in Cursor\n`))
+      console.log(chalk.gray(`   Agent installed in: .cursor/rules/nex/${agentCategory}/agents/${agentId}.mdc`))
+      console.log(chalk.gray(`   Use: ${agentTrigger} or @nex/${agentCategory}/agents/${agentId} in Cursor\n`))
       
     } catch (error) {
       console.log(chalk.yellow(`\n⚠️  Cursor integration failed: ${error.message}`))
@@ -1120,6 +1125,76 @@ export default class NEXMarketplace {
     }
   }
 
+  /**
+   * Update NEX index.mdc file (similar to BMAD index)
+   */
+  async updateNexIndex(agentId, manifest, category) {
+    const indexPath = path.join(this.projectRoot, '.cursor', 'rules', 'nex', 'index.mdc')
+    const indexDir = path.dirname(indexPath)
+    await fs.ensureDir(indexDir)
+    
+    let indexContent = ''
+    if (await fs.pathExists(indexPath)) {
+      indexContent = await fs.readFile(indexPath, 'utf8')
+    } else {
+      // Create initial index
+      indexContent = `---
+description: NEX Framework - Master Index
+globs:
+alwaysApply: true
+---
+
+# NEX Framework - Cursor Rules Index
+
+This is the master index for all NEX agents available in your project.
+
+## Installation Complete!
+
+NEX rules have been installed to: \`.cursor/rules/nex/\`
+
+**Note:** NEX does not modify your \`.cursorrules\` file. You manage that separately.
+
+## How to Use
+
+- Reference specific agents: @nex/{category}/agents/{agent-name}
+- Reference this index: @nex/index
+
+## Available Agents
+
+`
+    }
+    
+    // Check if agent is already listed
+    const agentRef = `@nex/${category}/agents/${agentId}`
+    if (indexContent.includes(agentRef)) {
+      return // Already listed
+    }
+    
+    // Add agent to index
+    const categorySection = `### ${category.toUpperCase()}\n\n**Agents:**\n`
+    if (!indexContent.includes(categorySection)) {
+      indexContent += categorySection
+    }
+    
+    const agentEntry = `- ${agentRef} - ${manifest.name}\n`
+    if (!indexContent.includes(agentEntry)) {
+      // Find the category section and add agent
+      const categoryIndex = indexContent.indexOf(`### ${category.toUpperCase()}`)
+      if (categoryIndex !== -1) {
+        const agentsIndex = indexContent.indexOf('**Agents:**', categoryIndex)
+        if (agentsIndex !== -1) {
+          const insertIndex = indexContent.indexOf('\n', agentsIndex) + 1
+          indexContent = indexContent.slice(0, insertIndex) + agentEntry + indexContent.slice(insertIndex)
+        }
+      } else {
+        // Category doesn't exist, add it
+        indexContent += `### ${category.toUpperCase()}\n\n**Agents:**\n${agentEntry}\n\n`
+      }
+    }
+    
+    await fs.writeFile(indexPath, indexContent, 'utf8')
+  }
+
   /**
    * Get latest version of agent
    */