nex-framework-cli 1.0.6 → 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,10 +192,17 @@ agentCmd
 agentCmd
   .command('list')
   .alias('ls')
-  .description('Lista agentes instalados')
-  .option('-a, --all', 'Mostrar todos os agentes disponíveis no marketplace')
-  .option('-c, --category <category>', 'Filtrar por categoria')
+  .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()
@@ -155,6 +220,11 @@ agentCmd
 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()
@@ -165,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()
@@ -175,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()
@@ -197,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()
@@ -208,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.6",
+  "version": "1.0.7",
   "description": "NEX CLI - Command-line interface for NEX Framework and Agent Marketplace",
   "type": "module",
   "main": "cli/nex-cli.js",