nex-framework-cli 1.0.4 → 1.0.7

package/cli/nex-cli.js

@@ -15,17 +15,51 @@ const __dirname = path.dirname(__filename)
 
 const program = new Command()
 
+// Custom help formatting
+program.configureHelp({
+  helpWidth: 100,
+  sortSubcommands: true,
+  subcommandTerm: (cmd) => {
+    const aliases = cmd.aliases().length > 0 ? `|${cmd.aliases().join('|')}` : ''
+    return chalk.cyan(`${cmd.name()}${aliases}`)
+  }
+})
+
 program
   .name('nex')
   .description('NEX Framework - Framework completo de agentes AI')
-  .version('1.0.0')
+  .version('1.0.6', '-v, --version', 'Mostra a versão')
+  .addHelpText('before', chalk.bold.cyan(`
+╔════════════════════════════════════════════════════════════════╗
+║              NEX Framework - CLI v1.0.6                        ║
+║         Framework completo de agentes AI                        ║
+╚════════════════════════════════════════════════════════════════╝
+`))
+  .addHelpText('after', chalk.gray(`
+📚 Exemplos rápidos:
+  ${chalk.cyan('nex agent list --all')}              Lista todos os agentes disponíveis
+  ${chalk.cyan('nex agent search planning')}        Busca agentes por termo
+  ${chalk.cyan('nex agent install anx')}             Instala um agente
+  ${chalk.cyan('nex agent info anx')}               Mostra informações de um agente
+
+📖 Para mais informações sobre um comando:
+  ${chalk.cyan('nex <comando> --help')}             Ex: nex agent --help
+
+🔗 Documentação: https://github.com/INOSX/nex-store
+`))
 
 // 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')
+  .option('-t, --template <template>', 'Template a usar (blank, full-stack, api-only, mobile)')
+  .addHelpText('after', chalk.gray(`
+Exemplos:
+  ${chalk.cyan('nex init')}                         Inicializa projeto interativamente
+  ${chalk.cyan('nex init -n meu-projeto')}          Inicializa com nome específico
+  ${chalk.cyan('nex init -t full-stack')}           Usa template full-stack
+`))
   .action(async (options) => {
     console.log(chalk.blue('🚀 Inicializando projeto NEX...'))
     
@@ -60,6 +94,14 @@ program
 program
   .command('plan')
   .description('Gera plano completo do projeto (PRD, arquitetura, etc.)')
+  .option('-r, --requirements <file>', 'Arquivo de requisitos JSON')
+  .option('-o, --output <dir>', 'Diretório de saída')
+  .addHelpText('after', chalk.gray(`
+Exemplos:
+  ${chalk.cyan('nex plan')}                         Gera plano interativamente
+  ${chalk.cyan('nex plan -r requirements.json')}    Usa arquivo de requisitos
+  ${chalk.cyan('nex plan -o ./docs')}              Salva em diretório específico
+`))
   .option('-r, --requirements <file>', 'Arquivo de requisitos')
   .option('-o, --output <dir>', 'Diretório de saída')
   .action(async (options) => {
@@ -104,14 +146,24 @@ program
 const agentCmd = program
   .command('agent')
   .description('Gerencia agentes do NEX Marketplace')
+  .addHelpText('before', chalk.bold('\n📦 Marketplace de Agentes\n'))
+  .addHelpText('after', chalk.gray(`
+💡 Dica: Use ${chalk.cyan('nex agent list --all')} para ver todos os agentes disponíveis
+`))
 
 // agent search
 agentCmd
   .command('search <query>')
-  .description('Busca agentes no marketplace')
-  .option('-c, --category <category>', 'Filtrar por categoria')
+  .description('Busca agentes no marketplace por termo')
+  .option('-c, --category <category>', 'Filtrar por categoria (planning, execution, community)')
   .option('--official', 'Apenas agentes oficiais')
   .option('-l, --limit <number>', 'Limitar resultados', '50')
+  .addHelpText('after', chalk.gray(`
+Exemplos:
+  ${chalk.cyan('nex agent search planning')}              Busca por "planning"
+  ${chalk.cyan('nex agent search "análise" --official')}  Busca apenas oficiais
+  ${chalk.cyan('nex agent search "" --category planning')} Lista todos de planejamento
+`))
   .action(async (query, options) => {
     const { default: NEXMarketplace } = await import('../src/services/nex-marketplace/NEXMarketplace.js')
     const marketplace = new NEXMarketplace()
@@ -121,9 +173,15 @@ agentCmd
 // agent install
 agentCmd
   .command('install <agentId>')
-  .description('Instala um agente')
+  .description('Instala um agente no projeto atual')
   .option('-v, --version <version>', 'Versão específica')
   .option('-m, --method <method>', 'Método de instalação (symlink|copy)')
+  .addHelpText('after', chalk.gray(`
+Exemplos:
+  ${chalk.cyan('nex agent install anx')}                    Instala o agente ANX
+  ${chalk.cyan('nex agent install anx -v 1.0.0')}          Instala versão específica
+  ${chalk.cyan('nex agent install anx -m copy')}           Instala usando cópia
+`))
   .action(async (agentId, options) => {
     const { default: NEXMarketplace } = await import('../src/services/nex-marketplace/NEXMarketplace.js')
     const marketplace = new NEXMarketplace()
@@ -134,18 +192,39 @@ agentCmd
 agentCmd
   .command('list')
   .alias('ls')
-  .description('Lista agentes instalados')
-  .option('-a, --all', 'Mostrar todos os agentes')
+  .description('Lista agentes instalados ou todos os agentes disponíveis no marketplace')
+  .option('-a, --all', 'Listar todos os agentes disponíveis no marketplace')
+  .option('-c, --category <category>', 'Filtrar por categoria (planning, execution, community)')
+  .option('--official', 'Apenas agentes oficiais')
+  .addHelpText('after', chalk.gray(`
+Exemplos:
+  ${chalk.cyan('nex agent list --all')}                          Lista todos os agentes disponíveis
+  ${chalk.cyan('nex agent list')}                                Lista apenas agentes instalados
+  ${chalk.cyan('nex agent list --all --category planning')}      Lista agentes de planejamento
+  ${chalk.cyan('nex agent list --all --official')}               Lista apenas agentes oficiais
+`))
   .action(async (options) => {
     const { default: NEXMarketplace } = await import('../src/services/nex-marketplace/NEXMarketplace.js')
     const marketplace = new NEXMarketplace()
-    await marketplace.list(options)
+    
+    if (options.all) {
+      // Listar todos os agentes disponíveis no marketplace
+      await marketplace.listAll(options)
+    } else {
+      // Listar apenas agentes instalados
+      await marketplace.list(options)
+    }
   })
 
 // agent info
 agentCmd
   .command('info <agentId>')
   .description('Mostra informações detalhadas do agente')
+  .addHelpText('after', chalk.gray(`
+Exemplos:
+  ${chalk.cyan('nex agent info anx')}              Informações do agente ANX
+  ${chalk.cyan('nex agent info pmx')}              Informações do agente PMX
+`))
   .action(async (agentId) => {
     const { default: NEXMarketplace } = await import('../src/services/nex-marketplace/NEXMarketplace.js')
     const marketplace = new NEXMarketplace()
@@ -156,7 +235,12 @@ agentCmd
 agentCmd
   .command('uninstall <agentId>')
   .alias('remove')
-  .description('Remove um agente instalado')
+  .description('Remove um agente instalado do projeto')
+  .addHelpText('after', chalk.gray(`
+Exemplos:
+  ${chalk.cyan('nex agent uninstall anx')}          Remove o agente ANX
+  ${chalk.cyan('nex agent remove anx')}             Alias para uninstall
+`))
   .action(async (agentId) => {
     const { default: NEXMarketplace } = await import('../src/services/nex-marketplace/NEXMarketplace.js')
     const marketplace = new NEXMarketplace()
@@ -166,8 +250,13 @@ agentCmd
 // agent update
 agentCmd
   .command('update [agentId]')
-  .description('Atualiza agente(s)')
-  .option('-a, --all', 'Atualizar todos os agentes')
+  .description('Atualiza agente(s) para a versão mais recente')
+  .option('-a, --all', 'Atualizar todos os agentes instalados')
+  .addHelpText('after', chalk.gray(`
+Exemplos:
+  ${chalk.cyan('nex agent update anx')}              Atualiza o agente ANX
+  ${chalk.cyan('nex agent update --all')}           Atualiza todos os agentes
+`))
   .action(async (agentId, options) => {
     const { default: NEXMarketplace } = await import('../src/services/nex-marketplace/NEXMarketplace.js')
     const marketplace = new NEXMarketplace()
@@ -188,6 +277,10 @@ agentCmd
 agentCmd
   .command('register <agentId>')
   .description('Registra um agente no NEX Hub para uso')
+  .addHelpText('after', chalk.gray(`
+Exemplos:
+  ${chalk.cyan('nex agent register anx')}           Registra o agente ANX no Hub
+`))
   .action(async (agentId) => {
     const { default: NEXMarketplace } = await import('../src/services/nex-marketplace/NEXMarketplace.js')
     const marketplace = new NEXMarketplace()
@@ -199,6 +292,11 @@ agentCmd
   .command('my-agents')
   .alias('registered')
   .description('Lista agentes registrados no NEX Hub')
+  .addHelpText('after', chalk.gray(`
+Exemplos:
+  ${chalk.cyan('nex agent my-agents')}              Lista seus agentes registrados
+  ${chalk.cyan('nex agent registered')}             Alias para my-agents
+`))
   .action(async () => {
     const { default: NEXMarketplace } = await import('../src/services/nex-marketplace/NEXMarketplace.js')
     const marketplace = new NEXMarketplace()

package/package.json

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

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

@@ -165,6 +165,84 @@ export default class NEXMarketplace {
     return agents || []
   }
 
+  /**
+   * List all available agents (browse marketplace)
+   */
+  async listAll(options = {}) {
+    const spinner = ora('Loading available agents...').start()
+    
+    try {
+      let results = []
+      
+      // List from API/Remote if available
+      if (this.apiUrl) {
+        results = await this.listAllViaAPI(options)
+      } else if (this.supabase) {
+        results = await this.listAllViaClient(options)
+      }
+      
+      // Also include local registry
+      const localResults = await this.searchLocal('', options)
+      
+      // Merge results
+      const merged = this.mergeResults(results, localResults)
+      
+      spinner.succeed(`Found ${merged.length} available agents`)
+      
+      // Display results
+      this.displaySearchResults(merged)
+      
+      return merged
+      
+    } catch (error) {
+      spinner.fail('Failed to load agents')
+      console.error(chalk.red(`Error: ${error.message}`))
+      throw error
+    }
+  }
+
+  /**
+   * List all agents via Edge Function API
+   */
+  async listAllViaAPI(options = {}) {
+    const response = await fetch(`${this.apiUrl}/list`)
+    
+    if (!response.ok) {
+      throw new Error(`API error: ${response.statusText}`)
+    }
+    
+    const { agents } = await response.json()
+    return agents || []
+  }
+
+  /**
+   * List all agents via Supabase client (fallback)
+   */
+  async listAllViaClient(options = {}) {
+    let query = this.supabase
+      .from('nex_marketplace_agents')
+      .select('*')
+      .eq('is_active', true)
+      .order('total_installs', { ascending: false })
+    
+    if (options.category) {
+      query = query.eq('category', options.category)
+    }
+    
+    if (options.official) {
+      query = query.eq('is_official', true)
+    }
+    
+    const limit = options.limit || 100
+    query = query.limit(limit)
+    
+    const { data, error } = await query
+    
+    if (error) throw error
+    
+    return data || []
+  }
+
   /**
    * Search via Supabase client (fallback - requer anon key)
    */