nex-app 0.1.0

package/generator/template-engine.js

@@ -0,0 +1,18 @@
+/**
+ * Engine de templates - Substituição de placeholders
+ */
+
+export function renderTemplate(content, variables) {
+  let rendered = content
+  
+  // Substituir placeholders {{variable}}
+  for (const [key, value] of Object.entries(variables)) {
+    const regex = new RegExp(`\\{\\{${key}\\}\\}`, 'g')
+    rendered = rendered.replace(regex, String(value || ''))
+  }
+  
+  // Remover placeholders não substituídos (opcional)
+  rendered = rendered.replace(/\{\{[\w]+\}\}/g, '')
+  
+  return rendered
+}

package/lib/marketplace-client.js

@@ -0,0 +1,75 @@
+/**
+ * Cliente para Marketplace API
+ * Por enquanto retorna lista mock, depois integrar com NEXMarketplace
+ */
+
+export async function searchAgents({ q = '', category }) {
+  // TODO: Integrar com NEXMarketplace.js real
+  // Por enquanto, retornar lista mock
+  
+  const mockAgents = [
+    {
+      agent_id: 'anx',
+      name: 'ANX - Analysis Expert',
+      tagline: 'Requirements Analysis & Strategic Insights',
+      category: 'planning',
+      icon: '🎯',
+      total_installs: 2200,
+      average_rating: 4.8
+    },
+    {
+      agent_id: 'arx',
+      name: 'ARX - Architecture Expert',
+      tagline: 'System Architecture & Technical Design',
+      category: 'planning',
+      icon: '🏗️',
+      total_installs: 1800,
+      average_rating: 4.9
+    },
+    {
+      agent_id: 'pmx',
+      name: 'PMX - Product Management Expert',
+      tagline: 'Strategic Product Planning & PRD Generation',
+      category: 'planning',
+      icon: '📊',
+      total_installs: 1600,
+      average_rating: 4.7
+    },
+    {
+      agent_id: 'dvx',
+      name: 'DVX - Developer Expert',
+      tagline: 'Code Generation & Implementation',
+      category: 'execution',
+      icon: '💻',
+      total_installs: 2500,
+      average_rating: 4.9
+    },
+    {
+      agent_id: 'vex',
+      name: 'VEX - Conversion Hypnotist',
+      tagline: 'Persuasive Copy & Conversion Optimization',
+      category: 'bmad',
+      icon: '🎪',
+      total_installs: 720,
+      average_rating: 4.7
+    }
+  ]
+
+  // Filtrar por busca
+  let filtered = mockAgents
+  if (q) {
+    const query = q.toLowerCase()
+    filtered = filtered.filter(agent => 
+      agent.name.toLowerCase().includes(query) ||
+      agent.tagline.toLowerCase().includes(query) ||
+      agent.agent_id.toLowerCase().includes(query)
+    )
+  }
+
+  // Filtrar por categoria
+  if (category) {
+    filtered = filtered.filter(agent => agent.category === category)
+  }
+
+  return filtered
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "nex-app",
+  "version": "0.1.0",
+  "description": "Create NEX projects with interactive installer (CLI + Web UI)",
+  "type": "module",
+  "main": "cli/create.js",
+  "bin": {
+    "nex-app": "./cli/create.js"
+  },
+  "files": [
+    "cli/",
+    "server/",
+    "ui/",
+    "generator/",
+    "templates/",
+    "utils/",
+    "lib/",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node cli/create.js --version",
+    "test:cli": "node cli/create.js --no-browser",
+    "test:web": "node cli/create.js --web",
+    "prepublishOnly": "npm run test",
+    "publish": "node scripts/publish.js",
+    "publish:patch": "npm version patch && npm run publish",
+    "publish:minor": "npm version minor && npm run publish",
+    "publish:major": "npm version major && npm run publish"
+  },
+  "keywords": [
+    "nex",
+    "nex-app",
+    "scaffold",
+    "generator",
+    "cli",
+    "web-installer"
+  ],
+  "author": "INOSX (https://inosx.com)",
+  "license": "PROPRIETARY",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/INOSX/nex-store.git"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "express": "^4.18.2",
+    "inquirer": "^9.2.15",
+    "chalk": "^5.3.0",
+    "open": "^8.4.2",
+    "fs-extra": "^11.2.0",
+    "yaml": "^2.3.4"
+  }
+}

package/server/index.js

@@ -0,0 +1,53 @@
+/**
+ * Servidor Express para Web UI
+ */
+
+import express from 'express'
+import { fileURLToPath } from 'url'
+import { dirname, join } from 'path'
+import { findFreePort } from '../utils/port-finder.js'
+import routes from './routes.js'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+export async function startServer(initialCwd) {
+  const app = express()
+  
+  // Middleware
+  app.use(express.json())
+  
+  // Servir UI estática
+  app.use(express.static(join(__dirname, '../ui')))
+  
+  // CORS apenas para localhost
+  app.use((req, res, next) => {
+    const origin = req.headers.origin
+    if (origin?.startsWith('http://localhost') || origin?.startsWith('http://127.0.0.1')) {
+      res.setHeader('Access-Control-Allow-Origin', origin)
+      res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS')
+      res.setHeader('Access-Control-Allow-Headers', 'Content-Type')
+    }
+    if (req.method === 'OPTIONS') {
+      return res.sendStatus(200)
+    }
+    next()
+  })
+
+  // Passar initialCwd para as rotas via app.locals
+  app.locals.initialCwd = initialCwd
+
+  // Rotas API
+  app.use('/api', routes)
+
+  // Encontrar porta livre
+  const port = await findFreePort(3000)
+  
+  return new Promise((resolve, reject) => {
+    const server = app.listen(port, '127.0.0.1', () => {
+      resolve({ port, server })
+    })
+    
+    server.on('error', reject)
+  })
+}

package/server/routes.js

@@ -0,0 +1,89 @@
+/**
+ * Rotas API do servidor
+ */
+
+import express from 'express'
+import path from 'path'
+import { generateProject } from '../generator/index.js'
+import { searchAgents } from '../lib/marketplace-client.js'
+import { validateTemplate, validatePackageManager } from '../utils/validation.js'
+
+const router = express.Router()
+
+// Health check
+router.get('/health', (req, res) => {
+  res.json({ 
+    status: 'ok', 
+    timestamp: Date.now(),
+    version: '0.1.0'
+  })
+})
+
+// Buscar agentes (integração com Marketplace)
+router.get('/agents/search', async (req, res) => {
+  try {
+    const { q = '', category } = req.query
+    
+    const agents = await searchAgents({ q, category })
+    
+    res.json({ agents })
+  } catch (error) {
+    console.error('Erro ao buscar agentes:', error)
+    res.status(500).json({ 
+      error: error.message,
+      agents: [] // Fallback: retornar vazio
+    })
+  }
+})
+
+// Gerar projeto
+router.post('/generate', async (req, res) => {
+  try {
+    const {
+      template,
+      agents = [],
+      packageManager = 'npm',
+      cursorIntegration = false,
+      options = {}
+    } = req.body
+
+    // No padrão BMAD/NEX, não pedimos nome do projeto
+    // Usamos o nome da pasta atual ou package.json existente
+
+    const templateValidation = validateTemplate(template)
+    if (!templateValidation.valid) {
+      return res.status(400).json({ error: templateValidation.error })
+    }
+
+    const pmValidation = validatePackageManager(packageManager)
+    if (!pmValidation.valid) {
+      return res.status(400).json({ error: pmValidation.error })
+    }
+
+    // Obter diretório de trabalho inicial do app.locals
+    const initialCwd = req.app.locals.initialCwd || process.cwd()
+
+    // Gerar projeto no diretório atual (padrão BMAD/NEX - não cria nova pasta)
+    const projectPath = await generateProject({
+      template,
+      agents,
+      packageManager,
+      cursorIntegration,
+      options,
+      targetDir: initialCwd
+    })
+
+    res.json({
+      success: true,
+      path: projectPath,
+      message: `NEX inicializado com sucesso no diretório atual!`
+    })
+  } catch (error) {
+    console.error('Erro ao gerar projeto:', error)
+    res.status(500).json({ 
+      error: error.message 
+    })
+  }
+})
+
+export default router

package/templates/api-only/README.md.tpl

@@ -0,0 +1,30 @@
+# {{projectName}}
+
+Projeto NEX API criado com create-nex-app.
+
+## Getting Started
+
+```bash
+# Instalar dependências
+{{packageManager}} install
+
+# Iniciar API
+{{packageManager}} start
+
+# Modo desenvolvimento
+{{packageManager}} run dev
+```
+
+## Estrutura
+
+```
+{{projectName}}/
+├── src/
+│   └── index.js          # API Entry point
+├── .nex-core/            # Configurações NEX
+└── package.json
+```
+
+## Documentação
+
+- [NEX Framework](https://github.com/INOSX/nex-store)

package/templates/api-only/package.json.tpl

@@ -0,0 +1,20 @@
+{
+  "name": "{{projectName}}",
+  "version": "1.0.0",
+  "description": "NEX API project created with create-nex-app",
+  "type": "module",
+  "main": "src/index.js",
+  "scripts": {
+    "start": "node src/index.js",
+    "dev": "node --watch src/index.js"
+  },
+  "keywords": [
+    "nex",
+    "api",
+    "backend",
+    "ai",
+    "agents"
+  ],
+  "author": "",
+  "license": "PROPRIETARY"
+}

package/templates/api-only/src/index.js.tpl

@@ -0,0 +1,9 @@
+/**
+ * {{projectName}} - API Entry Point
+ * NEX API project
+ */
+
+console.log('🚀 {{projectName}} API iniciada!')
+console.log('📦 NEX Framework carregado')
+
+// Sua API aqui

package/templates/blank/.nex-core/config.yaml.tpl

@@ -0,0 +1,14 @@
+# NEX Core Configuration
+# Este arquivo é mantido para compatibilidade
+# A configuração principal está em nex/core/config.yaml (se Cursor integration estiver habilitada)
+name: {{projectName}}
+version: 1.0.0
+created_at: ${new Date().toISOString()}
+
+# Agents
+agents: []
+
+# Settings
+settings:
+  language: pt-BR
+  output_folder: .nex-core/documents

package/templates/blank/README.md.tpl

@@ -0,0 +1,48 @@
+# {{projectName}}
+
+Projeto NEX criado com create-nex-app.
+
+## Getting Started
+
+```bash
+# Instalar dependências
+{{packageManager}} install
+
+# Iniciar projeto
+{{packageManager}} start
+
+# Modo desenvolvimento (watch)
+{{packageManager}} run dev
+```
+
+## Estrutura
+
+```
+{{projectName}}/
+├── src/
+│   └── index.js          # Entry point
+├── .nex-core/            # Configurações NEX
+│   ├── agents/           # Agentes instalados
+│   └── data/             # Dados dos agentes
+└── package.json
+```
+
+## NEX CLI
+
+Para gerenciar agentes e configurações:
+
+```bash
+# Instalar agente
+nex agent install <agent-id>
+
+# Listar agentes
+nex agent list
+
+# Ver configuração
+nex config show
+```
+
+## Documentação
+
+- [NEX Framework](https://github.com/INOSX/nex-store)
+- [NEX Marketplace](https://github.com/INOSX/nex-store)

package/templates/blank/package.json.tpl

@@ -0,0 +1,18 @@
+{
+  "name": "{{projectName}}",
+  "version": "1.0.0",
+  "description": "NEX project created with create-nex-app",
+  "type": "module",
+  "main": "src/index.js",
+  "scripts": {
+    "start": "node src/index.js",
+    "dev": "node --watch src/index.js"
+  },
+  "keywords": [
+    "nex",
+    "ai",
+    "agents"
+  ],
+  "author": "",
+  "license": "PROPRIETARY"
+}

package/templates/blank/src/index.js.tpl

@@ -0,0 +1,9 @@
+/**
+ * {{projectName}} - Entry Point
+ * Projeto NEX criado com create-nex-app
+ */
+
+console.log('🚀 {{projectName}} iniciado!')
+console.log('📦 NEX Framework carregado')
+
+// Seu código aqui

package/templates/full-stack/README.md.tpl

@@ -0,0 +1,33 @@
+# {{projectName}}
+
+Projeto NEX Full Stack criado com create-nex-app.
+
+## Getting Started
+
+```bash
+# Instalar dependências
+{{packageManager}} install
+
+# Iniciar servidor
+{{packageManager}} start
+
+# Modo desenvolvimento
+{{packageManager}} run dev
+```
+
+## Estrutura
+
+```
+{{projectName}}/
+├── src/
+│   ├── server/           # Backend
+│   │   └── index.js
+│   └── client/           # Frontend
+│       └── index.html
+├── .nex-core/            # Configurações NEX
+└── package.json
+```
+
+## Documentação
+
+- [NEX Framework](https://github.com/INOSX/nex-store)

package/templates/full-stack/package.json.tpl

@@ -0,0 +1,20 @@
+{
+  "name": "{{projectName}}",
+  "version": "1.0.0",
+  "description": "NEX Full Stack project created with create-nex-app",
+  "type": "module",
+  "main": "src/server/index.js",
+  "scripts": {
+    "start": "node src/server/index.js",
+    "dev": "node --watch src/server/index.js",
+    "build": "echo 'Build script - configure conforme necessário'"
+  },
+  "keywords": [
+    "nex",
+    "full-stack",
+    "ai",
+    "agents"
+  ],
+  "author": "",
+  "license": "PROPRIETARY"
+}

package/templates/full-stack/src/client/index.html.tpl

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="pt-BR">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>{{projectName}}</title>
+</head>
+<body>
+  <h1>{{projectName}}</h1>
+  <p>Frontend do projeto NEX</p>
+</body>
+</html>

package/templates/full-stack/src/server/index.js.tpl

@@ -0,0 +1,9 @@
+/**
+ * {{projectName}} - Server Entry Point
+ * Full Stack NEX project
+ */
+
+console.log('🚀 {{projectName}} Server iniciado!')
+console.log('📦 NEX Framework carregado')
+
+// Seu servidor aqui