nex-framework-cli 1.0.16 → 1.0.18

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.15', '-v, --version', 'Mostra a versão')
+      .version('1.0.18', '-v, --version', 'Mostra a versão')
   .addHelpText('before', chalk.bold.cyan(`
 ╔════════════════════════════════════════════════════════════════╗
 ║              NEX Framework - CLI v1.0.9                        ║
@@ -62,6 +62,7 @@ Exemplos:
 `))
   .action(async (options) => {
     console.log(chalk.blue('🚀 Inicializando projeto NEX...'))
+    console.log()
     
     const answers = await inquirer.prompt([
       {
@@ -84,10 +85,11 @@ Exemplos:
     const projectName = options.name || answers.projectName
     const template = options.template || answers.template
 
-    // Criar estrutura do projeto
+    // Criar estrutura do projeto (sem config, usa global)
     await createProjectStructure(projectName, template)
     
-    console.log(chalk.green(`✅ Projeto ${projectName} criado com sucesso!`))
+    console.log(chalk.green(`\n✅ Projeto ${projectName} criado com sucesso!`))
+    console.log()
   })
 
 // Comando: plan
@@ -391,6 +393,11 @@ Projeto criado com NEX Framework.
 npm install
 npm start
 \`\`\`
+
+## NEX Configuration
+
+As configurações do NEX (idioma, integração com Cursor) são gerenciadas globalmente.
+Para ver ou alterar: \`nex config\`
 `
   await fs.writeFile(path.join(projectDir, 'README.md'), readme)
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nex-framework-cli",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "description": "NEX CLI - Command-line interface for NEX Framework and Agent Marketplace",
   "type": "module",
   "main": "cli/nex-cli.js",
@@ -11,12 +11,14 @@
     "cli/",
     "src/services/nex-marketplace/",
     "src/services/nex-installer/",
+    "scripts/postinstall.js",
     "registry/",
     "README.md",
     "LICENSE"
   ],
   "scripts": {
     "prepublishOnly": "npm run test",
+    "postinstall": "node scripts/postinstall.js",
     "test": "node cli/nex-cli.js --version",
     "test:api": "node scripts/test-marketplace-api.js",
     "publish:cli": "node scripts/publish-cli.js",

package/scripts/README.md

@@ -0,0 +1,196 @@
+# 📦 Scripts do NEX Framework
+
+Scripts utilitários para gerenciar o projeto NEX.
+
+---
+
+## 🗄️ Scripts de Banco de Dados
+
+### `check-database.js`
+
+**Descrição:** Verifica o estado atual do banco de dados Supabase
+
+**Uso:**
+```bash
+npm run db:check
+```
+
+**O que faz:**
+- ✅ Conecta ao Supabase
+- ✅ Verifica se as 7 tabelas do NEX Marketplace existem
+- ✅ Mostra status de cada tabela (✅ OK, ❌ Faltando, ⚠️ Erro)
+- ✅ Conta quantos agentes estão cadastrados
+- ✅ Lista os agentes existentes
+
+**Pré-requisitos:**
+```powershell
+$env:NEXT_PUBLIC_SUPABASE_URL="https://seu-projeto.supabase.co"
+$env:NEXT_PUBLIC_SUPABASE_ANON_KEY="sua-anon-key"
+```
+
+**Exemplo de saída:**
+```
+🔗 Connecting to Supabase...
+📍 URL: https://auqfubbpxjzuzzqfazdp.supabase.co
+
+🔍 Checking for NEX Marketplace tables...
+
+📊 Database Status:
+
+✅ nex_marketplace_agents              OK
+✅ nex_marketplace_versions            OK
+✅ nex_marketplace_installs            OK
+✅ nex_marketplace_reviews             OK
+✅ nex_marketplace_bundles             OK
+✅ nex_marketplace_analytics           OK
+✅ nex_marketplace_stars               OK
+
+🎉 All tables exist! Database is ready.
+
+📊 Checking data...
+✅ Found 3 agents:
+   - anx: ANX - Analysis Expert (v1.0.0)
+   - pmx: PMX - Product Management Expert (v1.0.0)
+   - arx: ARX - Architecture Expert (v1.0.0)
+```
+
+---
+
+### `run-migration.js`
+
+**Descrição:** Helper para executar migrations do Supabase
+
+**Uso:**
+```bash
+npm run db:migrate
+```
+
+**O que faz:**
+- ✅ Lê o arquivo `supabase/migrations/002_nex_agent_marketplace.sql`
+- ✅ Tenta executar via API do Supabase
+- ✅ Se falhar, fornece instruções para execução manual
+
+**Pré-requisitos:**
+```powershell
+$env:NEXT_PUBLIC_SUPABASE_URL="https://seu-projeto.supabase.co"
+$env:SUPABASE_SERVICE_ROLE_KEY="sua-service-role-key"
+```
+
+**Nota:** Na maioria dos casos, é melhor executar a migration **manualmente** via SQL Editor do Supabase. Este script é um helper que orienta o processo.
+
+---
+
+## ⚙️ Script de Setup do Supabase
+
+### `supabase-setup.ps1`
+
+**Descrição:** Script PowerShell para configurar o Supabase localmente (Docker)
+
+**Uso:**
+```powershell
+.\scripts\supabase-setup.ps1
+```
+
+**O que faz:**
+- ✅ Verifica se Docker está instalado
+- ✅ Inicializa projeto Supabase local
+- ✅ Inicia containers Docker
+- ✅ Aplica migrations
+- ✅ Configura ambiente local
+
+**Quando usar:** Para desenvolvimento local com Supabase rodando em Docker.
+
+---
+
+## 🔧 Variáveis de Ambiente
+
+Todos os scripts de banco de dados precisam de:
+
+### Para Verificação (read-only):
+```powershell
+$env:NEXT_PUBLIC_SUPABASE_URL="https://seu-projeto.supabase.co"
+$env:NEXT_PUBLIC_SUPABASE_ANON_KEY="sua-anon-key"
+```
+
+### Para Migrations (write):
+```powershell
+$env:NEXT_PUBLIC_SUPABASE_URL="https://seu-projeto.supabase.co"
+$env:SUPABASE_SERVICE_ROLE_KEY="sua-service-role-key"
+```
+
+**Onde encontrar:**
+👉 https://app.supabase.com/project/SEU_PROJECT_ID/settings/api
+
+---
+
+## 📝 Comandos NPM
+
+Adicionados em `package.json`:
+
+```json
+{
+  "scripts": {
+    "db:check": "node scripts/check-database.js",
+    "db:migrate": "node scripts/run-migration.js"
+  }
+}
+```
+
+---
+
+## 🚀 Fluxo Recomendado
+
+### Primeira vez (setup inicial):
+
+1. **Configurar variáveis:**
+   ```powershell
+   $env:NEXT_PUBLIC_SUPABASE_URL="https://auqfubbpxjzuzzqfazdp.supabase.co"
+   $env:NEXT_PUBLIC_SUPABASE_ANON_KEY="sua-key"
+   ```
+
+2. **Verificar estado:**
+   ```bash
+   npm run db:check
+   ```
+
+3. **Executar migration (manualmente):**
+   - Abrir: https://app.supabase.com/project/auqfubbpxjzuzzqfazdp/sql
+   - Copiar: `supabase/migrations/002_nex_agent_marketplace.sql`
+   - Colar e executar (Ctrl+Enter)
+
+4. **Verificar novamente:**
+   ```bash
+   npm run db:check
+   ```
+
+5. **Popular com dados de teste:**
+   - Ver: `EXECUTAR_SUPABASE.md` (seção "Popular com dados")
+
+---
+
+## 📚 Documentação Relacionada
+
+- **`EXECUTAR_SUPABASE.md`** - Guia completo de setup do banco
+- **`RODAR_MIGRATION_SUPABASE.md`** - Guia rápido de migrations
+- **`SUPABASE_DATABASE_SETUP_SUMMARY.md`** - Resumo executivo
+- **`SUPABASE_SETUP_INSTRUCTIONS.md`** - Instruções gerais do Supabase
+
+---
+
+## ⚠️ Troubleshooting
+
+### Erro: "Missing environment variables"
+**Solução:** Configure as variáveis de ambiente (ver acima)
+
+### Erro: "404 Not Found" na API
+**Solução:** As tabelas não existem. Execute a migration primeiro.
+
+### Erro: "Unauthorized"
+**Solução:** Use a `SUPABASE_SERVICE_ROLE_KEY` (não a anon key)
+
+### Erro: "function does not exist"
+**Solução:** A função RPC não está disponível. Use execução manual via SQL Editor.
+
+---
+
+**Precisa de ajuda?** Veja os guias completos nos arquivos `.md` na raiz do projeto! 🚀

package/scripts/postinstall.js

@@ -0,0 +1,155 @@
+#!/usr/bin/env node
+/**
+ * NEX CLI Post-Install Script
+ * Runs after npm install to configure the CLI
+ */
+
+import inquirer from 'inquirer'
+import fs from 'fs-extra'
+import path from 'path'
+import os from 'os'
+import chalk from 'chalk'
+import { fileURLToPath } from 'url'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+// Get global config path
+function getGlobalConfigPath() {
+  const homeDir = os.homedir()
+  
+  if (process.platform === 'win32') {
+    // Windows: %APPDATA%\nex\config.json
+    return path.join(process.env.APPDATA || path.join(homeDir, 'AppData', 'Roaming'), 'nex', 'config.json')
+  } else {
+    // Unix-like: ~/.nex/config.json
+    return path.join(homeDir, '.nex', 'config.json')
+  }
+}
+
+async function runSetup() {
+  // Check if config already exists
+  const configPath = getGlobalConfigPath()
+  const configDir = path.dirname(configPath)
+  
+  if (await fs.pathExists(configPath)) {
+    try {
+      const existingConfig = await fs.readJSON(configPath)
+      // If config exists and is valid, skip setup
+      if (existingConfig.user && existingConfig.user.name) {
+        console.log(chalk.green('\n✅ NEX CLI já está configurado!'))
+        console.log(chalk.gray(`   Config: ${configPath}`))
+        console.log(chalk.gray(`   Para reconfigurar, delete o arquivo ou execute: nex config reset\n`))
+        return
+      }
+    } catch (error) {
+      // Config file exists but is invalid, continue with setup
+    }
+  }
+  
+  console.log(chalk.blue('\n╔══════════════════════════════════════════════════════════╗'))
+  console.log(chalk.blue('║          🚀 Configuração do NEX CLI                        ║'))
+  console.log(chalk.blue('╚══════════════════════════════════════════════════════════╝\n'))
+  
+  const answers = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'userName',
+      message: 'Seu nome:',
+      default: process.env.USER || process.env.USERNAME || 'Developer',
+      validate: (input) => {
+        if (input.trim().length === 0) {
+          return 'Por favor, informe seu nome'
+        }
+        return true
+      }
+    },
+    {
+      type: 'list',
+      name: 'conversationLanguage',
+      message: 'Idioma de conversação:',
+      choices: [
+        { name: 'Português (PT-BR)', value: 'pt-BR' },
+        { name: 'English (EN-US)', value: 'en-US' },
+        { name: 'Español (ES)', value: 'es' },
+        { name: 'Français (FR)', value: 'fr' }
+      ],
+      default: 'pt-BR'
+    },
+    {
+      type: 'list',
+      name: 'documentLanguage',
+      message: 'Idioma para criação de documentos:',
+      choices: [
+        { name: 'Português (PT-BR)', value: 'pt-BR' },
+        { name: 'English (EN-US)', value: 'en-US' },
+        { name: 'Español (ES)', value: 'es' },
+        { name: 'Français (FR)', value: 'fr' }
+      ],
+      default: 'pt-BR'
+    },
+    {
+      type: 'confirm',
+      name: 'cursorIntegration',
+      message: 'Deseja habilitar integração com Cursor IDE?',
+      default: true
+    }
+  ])
+  
+  const config = {
+    user: {
+      name: answers.userName.trim(),
+      conversationLanguage: answers.conversationLanguage,
+      documentLanguage: answers.documentLanguage
+    },
+    cursor: {
+      enabled: answers.cursorIntegration
+    },
+    installedAt: new Date().toISOString(),
+    version: '1.0.18'
+  }
+  
+  // Save config
+  await fs.ensureDir(configDir)
+  await fs.writeJSON(configPath, config, { spaces: 2 })
+  
+  console.log(chalk.green('\n✅ NEX CLI configurado com sucesso!'))
+  console.log(chalk.gray(`   Config salvo em: ${configPath}`))
+  console.log(chalk.gray(`   Nome: ${config.user.name}`))
+  console.log(chalk.gray(`   Idioma de conversação: ${config.user.conversationLanguage}`))
+  console.log(chalk.gray(`   Idioma de documentos: ${config.user.documentLanguage}`))
+  console.log(chalk.gray(`   Integração Cursor: ${config.cursor.enabled ? 'Habilitada' : 'Desabilitada'}`))
+  console.log(chalk.cyan('\n💡 Dica: Para reconfigurar, execute: nex config reset\n'))
+}
+
+// Only run if not in CI/CD or if explicitly requested
+if (process.env.CI !== 'true' && process.env.NEX_SKIP_SETUP !== 'true') {
+  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 {
+  // In CI/CD, create default config silently
+  const configPath = getGlobalConfigPath()
+  const configDir = path.dirname(configPath)
+  const defaultConfig = {
+    user: {
+      name: 'Developer',
+      conversationLanguage: 'pt-BR',
+      documentLanguage: 'pt-BR'
+    },
+    cursor: {
+      enabled: false
+    },
+    installedAt: new Date().toISOString(),
+    version: '1.0.18'
+  }
+  
+  fs.ensureDir(configDir)
+    .then(() => fs.writeJSON(configPath, defaultConfig, { spaces: 2 }))
+    .catch(() => {
+      // Silently fail in CI
+    })
+}

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

@@ -6,10 +6,12 @@
 import fs from 'fs-extra'
 import { existsSync } from 'fs'
 import path from 'path'
+import os from 'os'
 import yaml from 'yaml'
 import chalk from 'chalk'
 import ora from 'ora'
 import semver from 'semver'
+import inquirer from 'inquirer'
 import { createClient } from '@supabase/supabase-js'
 import { fileURLToPath } from 'url'
 
@@ -26,8 +28,18 @@ export default class NEXMarketplace {
     } else {
       // Tentar encontrar o registry dentro do pacote npm instalado
       try {
-        const currentFile = new URL(import.meta.url).pathname
-        const packageRoot = path.resolve(path.dirname(currentFile), '..', '..', '..')
+        // Obter o caminho do arquivo atual
+        const currentFileUrl = new URL(import.meta.url)
+        // No Windows, file:/// pode ter 3 barras, precisamos normalizar
+        let currentFilePath = currentFileUrl.pathname
+        // Remover barra inicial no Windows (file:///C:/...)
+        if (process.platform === 'win32' && currentFilePath.startsWith('/')) {
+          currentFilePath = currentFilePath.substring(1)
+        }
+        
+        // Resolver caminho relativo: de src/services/nex-marketplace/NEXMarketplace.js para raiz do pacote
+        const currentDir = path.dirname(currentFilePath)
+        const packageRoot = path.resolve(currentDir, '..', '..', '..')
         const npmRegistryPath = path.join(packageRoot, 'registry')
         
         // Verificar se existe (quando instalado via npm)
@@ -37,7 +49,7 @@ export default class NEXMarketplace {
           // Fallback para registry no projeto
           this.registryPath = path.join(this.projectRoot, 'registry')
         }
-      } catch {
+      } catch (error) {
         // Fallback para registry no projeto
         this.registryPath = path.join(this.projectRoot, 'registry')
       }
@@ -47,11 +59,16 @@ export default class NEXMarketplace {
     
     // Supabase client
     this.supabase = null
+    this.apiUrl = null
+    this.anonKey = null
     this.initializeSupabase()
     
     // Config
     this.config = null
+    this.globalConfig = null
+    this.projectConfig = null
     this.loadConfig()
+    this.loadGlobalConfig()
   }
 
   /**
@@ -118,6 +135,103 @@ export default class NEXMarketplace {
     return this.config
   }
 
+  /**
+   * Get global config path (user's home directory)
+   */
+  getGlobalConfigPath() {
+    const homeDir = os.homedir()
+    
+    if (process.platform === 'win32') {
+      // Windows: %APPDATA%\nex\config.json
+      return path.join(process.env.APPDATA || path.join(homeDir, 'AppData', 'Roaming'), 'nex', 'config.json')
+    } else {
+      // Unix-like: ~/.nex/config.json
+      return path.join(homeDir, '.nex', 'config.json')
+    }
+  }
+
+  /**
+   * Load global configuration from user's home directory
+   */
+  async loadGlobalConfig() {
+    try {
+      const configPath = this.getGlobalConfigPath()
+      
+      if (await fs.pathExists(configPath)) {
+        this.globalConfig = await fs.readJSON(configPath)
+        return this.globalConfig
+      }
+    } catch (error) {
+      // Config file doesn't exist or is invalid
+    }
+    
+    this.globalConfig = null
+    return null
+  }
+
+  /**
+   * Get global configuration with defaults
+   */
+  getGlobalConfig() {
+    if (!this.globalConfig) {
+      return {
+        user: {
+          name: process.env.USER || process.env.USERNAME || 'Developer',
+          conversationLanguage: 'pt-BR',
+          documentLanguage: 'pt-BR'
+        },
+        cursor: {
+          enabled: false
+        }
+      }
+    }
+    return this.globalConfig
+  }
+
+  /**
+   * Load project configuration (.nex-core/config.json)
+   * @deprecated Use getGlobalConfig() instead - project config is now optional
+   */
+  async loadProjectConfig() {
+    const configPath = path.join(this.projectRoot, '.nex-core', 'config.json')
+    
+    if (await fs.pathExists(configPath)) {
+      try {
+        this.projectConfig = await fs.readJSON(configPath)
+      } catch (error) {
+        this.projectConfig = null
+      }
+    } else {
+      this.projectConfig = null
+    }
+    
+    return this.projectConfig
+  }
+
+  /**
+   * Get project configuration with defaults
+   * @deprecated Use getGlobalConfig() instead
+   */
+  getProjectConfig() {
+    // Prefer global config, fallback to project config
+    const global = this.getGlobalConfig()
+    if (this.projectConfig) {
+      return {
+        ...global,
+        ...this.projectConfig,
+        user: {
+          ...global.user,
+          ...(this.projectConfig.user || {})
+        },
+        cursor: {
+          ...global.cursor,
+          ...(this.projectConfig.cursor || {})
+        }
+      }
+    }
+    return global
+  }
+
   /**
    * Default configuration
    */
@@ -834,12 +948,32 @@ export default class NEXMarketplace {
       // 7. Track installation
       await this.trackInstallation(agentId, version, method)
       
+      // 8. Integrate with Cursor if BMAD agent
+      if (manifest.bmad?.cursor_integration === true) {
+        // Use global config (set during CLI installation)
+        const globalConfig = this.getGlobalConfig()
+        const shouldIntegrate = globalConfig.cursor?.enabled === true
+        
+        if (shouldIntegrate) {
+          await this.integrateWithCursor(agentId, manifest, sourcePath)
+        } else {
+          console.log(chalk.gray(`\n💡 Integração com Cursor desabilitada. Para habilitar, execute: nex config reset\n`))
+        }
+      }
+      
       spinner.succeed(chalk.green(`✅ ${manifest.icon} ${manifest.name} v${version} installed!`))
       
-      // 8. Show quick start
+      // 9. Show quick start
       console.log(chalk.cyan('\n📖 Quick Start:'))
-      console.log(chalk.gray(`   @${agentId}`))
-      console.log(chalk.gray(`   nex agent run ${agentId} <command>\n`))
+      if (manifest.bmad?.cursor_integration === true) {
+        const trigger = manifest.bmad?.activation_trigger || `@${agentId}`
+        console.log(chalk.gray(`   ${trigger} <command>`))
+        console.log(chalk.gray(`   (No Cursor, use: nex agent run ${agentId} <command>)`))
+      } else {
+        console.log(chalk.gray(`   @${agentId}`))
+        console.log(chalk.gray(`   nex agent run ${agentId} <command>`))
+      }
+      console.log()
       
       return true
       
@@ -856,9 +990,13 @@ export default class NEXMarketplace {
   async getAgentSourcePath(agentId, version) {
     const categories = ['planning', 'execution', 'community', 'bmad']
     
+    // Debug: log registry path being searched
+    const searchedPaths = []
+    
     for (const category of categories) {
       // Try versioned path first
       let sourcePath = path.join(this.registryPath, category, agentId, 'versions', version)
+      searchedPaths.push(sourcePath)
       
       if (await fs.pathExists(sourcePath)) {
         return sourcePath
@@ -866,13 +1004,121 @@ export default class NEXMarketplace {
       
       // Fallback to non-versioned
       sourcePath = path.join(this.registryPath, category, agentId)
+      searchedPaths.push(sourcePath)
       
       if (await fs.pathExists(sourcePath)) {
         return sourcePath
       }
     }
     
-    throw new Error(`Agent source not found: ${agentId}@${version}`)
+    // Better error message with debugging info
+    const errorMsg = `Agent source not found: ${agentId}@${version}\n` +
+      `Registry path: ${this.registryPath}\n` +
+      `Searched paths:\n${searchedPaths.map(p => `  - ${p}`).join('\n')}\n` +
+      `\n💡 Tip: Make sure the agent exists in the registry. Try: nex agent search ${agentId}`
+    
+    throw new Error(errorMsg)
+  }
+
+  /**
+   * Integrate BMAD agent with Cursor
+   */
+  async integrateWithCursor(agentId, manifest, sourcePath) {
+    try {
+      const rulesFile = manifest.bmad?.rules_file
+      if (!rulesFile) {
+        return // No rules file specified
+      }
+      
+      // 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
+          }
+        }
+        
+        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)}
+
+# Activation: ${trigger}
+
+# ${manifest.name} - ${manifest.description || 'BMAD Expert Agent'}
+
+# Usage in Cursor:
+# ${trigger} <command>
+
+# Example:
+# ${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 trigger = manifest.bmad?.activation_trigger || `@${agentId}`
+      const agentComment = `# Use: ${trigger} <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
+      }
+      
+      // Add import to .cursorrules
+      const newContent = cursorRulesContent + 
+        (cursorRulesContent ? '\n\n' : '') +
+        commentLine + '\n' +
+        agentComment + '\n' +
+        importLine + '\n'
+      
+      await fs.writeFile(mainCursorRulesPath, newContent, 'utf8')
+      
+      console.log(chalk.green(`\n✅ Cursor integration complete!`))
+      console.log(chalk.gray(`   Added ${rulesFile} to .cursorrules`))
+      const trigger = manifest.bmad?.activation_trigger || `@${agentId}`
+      console.log(chalk.gray(`   Use: ${trigger} <command> in Cursor\n`))
+      
+    } catch (error) {
+      console.log(chalk.yellow(`\n⚠️  Cursor integration failed: ${error.message}`))
+      console.log(chalk.gray(`   Agent installed but Cursor integration skipped.\n`))
+    }
   }
 
   /**