cleudocode-core 1.0.0

package/bin/cleudocode.js

@@ -0,0 +1,581 @@
+#!/usr/bin/env node
+
+/**
+ * Cleudocode Core CLI
+ * 
+ * Framework de orquestração de agentes AI para desenvolvimento
+ * Instalação rápida, configuração automática e integração com múltiplos LLMs
+ * 
+ * @author Cleudocode Team
+ * @version 1.0.0
+ */
+
+import { fileURLToPath } from 'node:url'
+import { dirname, join } from 'node:path'
+import { Command } from 'commander'
+import chalk from 'chalk'
+import ora from 'ora'
+import { execa } from 'execa'
+import fs from 'fs-extra'
+import yaml from 'js-yaml'
+import semver from 'semver'
+import * as p from '@clack/prompts'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+const PROJECT_ROOT = process.cwd()
+
+// Versão atual
+const pkg = JSON.parse(
+  fs.readFileSync(join(__dirname, '../package.json'), 'utf-8')
+)
+const VERSION = pkg.version
+
+// Programa principal
+const program = new Command()
+
+program
+  .name('cleudocode-core')
+  .description('Cleudocode Core - AI Orchestration Framework')
+  .version(VERSION)
+
+// =============================================================================
+// COMANDO: init
+// =============================================================================
+program
+  .command('init')
+  .description('Inicializa Cleudocode Core no projeto atual')
+  .option('-f, --force', 'Forçar inicialização mesmo se já existir')
+  .option('-t, --template <tipo>', 'Template a usar (fullstack|frontend|backend|cli)', 'fullstack')
+  .action(async (options) => {
+    p.intro(chalk.bgGreen.black(' Cleudocode Core - Inicialização '))
+
+    const configPath = join(PROJECT_ROOT, '.cleudocode-core')
+    
+    if (fs.existsSync(configPath) && !options.force) {
+      p.log.warn('Arquivo .cleudocode-core já existe!')
+      const shouldContinue = await p.confirm({
+        message: 'Deseja sobrescrever?',
+        initialValue: false
+      })
+      
+      if (p.isCancel(shouldContinue) || !shouldContinue) {
+        p.cancel('Operação cancelada.')
+        return
+      }
+    }
+
+    const spinner = ora('Criando configuração...').start()
+
+    try {
+      // Copiar template de configuração
+      const templatePath = join(__dirname, '../templates/.cleudocode-core')
+      let configContent
+      
+      if (fs.existsSync(templatePath)) {
+        configContent = fs.readFileSync(templatePath, 'utf-8')
+      } else {
+        // Configuração padrão inline
+        configContent = getDefaultConfig(options.template)
+      }
+
+      fs.writeFileSync(configPath, configContent)
+      spinner.succeed('Configuração criada com sucesso!')
+
+      // Criar estrutura de diretórios
+      const dirs = [
+        '.agents/agents',
+        '.agents/rules',
+        '.agents/tasks',
+        '.agents/templates',
+        '.agents/outputs',
+        '.agents/logs',
+        '.agents/storage'
+      ]
+
+      for (const dir of dirs) {
+        const fullPath = join(PROJECT_ROOT, dir)
+        if (!fs.existsSync(fullPath)) {
+          fs.ensureDirSync(fullPath)
+        }
+      }
+
+      p.log.success('Estrutura de diretórios criada!')
+
+      // Criar AGENTS.md
+      const agentsPath = join(PROJECT_ROOT, 'AGENTS.md')
+      if (!fs.existsSync(agentsPath)) {
+        fs.writeFileSync(agentsPath, getDefaultAgentsMd())
+        p.log.success('AGENTS.md criado!')
+      }
+
+      // Criar .env.example
+      const envExamplePath = join(PROJECT_ROOT, '.env.example')
+      if (!fs.existsSync(envExamplePath)) {
+        fs.writeFileSync(envExamplePath, getDefaultEnvExample())
+        p.log.success('.env.example criado!')
+      }
+
+      p.outro(chalk.green('✨ Cleudocode Core inicializado com sucesso!'))
+      
+      console.log(`
+${chalk.bold('Próximos passos:')}
+
+1. Copie o arquivo de exemplo:
+   ${chalk.cyan('cp .env.example .env')}
+
+2. Edite .env e configure suas chaves de API
+
+3. Inicie o Ollama (se usar modelos locais):
+   ${chalk.cyan('ollama serve')}
+
+4. Execute seu primeiro comando:
+   ${chalk.cyan('npx cleudocode-core help')}
+
+${chalk.dim('Documentação: https://github.com/cleudocode/cleudocode-core')}
+`)
+
+    } catch (error) {
+      spinner.fail('Erro ao inicializar')
+      p.log.error(error.message)
+      process.exit(1)
+    }
+  })
+
+// =============================================================================
+// COMANDO: install
+// =============================================================================
+program
+  .command('install')
+  .description('Instala Cleudocode Core globalmente')
+  .action(async () => {
+    p.intro(chalk.bgGreen.black(' Cleudocode Core - Instalação '))
+
+    const spinner = ora('Instalando cleudocode-core...').start()
+
+    try {
+      await execa('npm', ['install', '-g', 'cleudocode-core'], {
+        stdio: 'pipe'
+      })
+
+      spinner.succeed('cleudocode-core instalado globalmente!')
+
+      p.outro(chalk.green(`
+✨ Instalação concluída!
+
+Use em qualquer projeto:
+  ${chalk.cyan('cleudocode-core init')}
+
+Ou use sem instalar:
+  ${chalk.cyan('npx cleudocode-core init')}
+`))
+
+    } catch (error) {
+      spinner.fail('Erro na instalação')
+      p.log.error(error.message)
+      process.exit(1)
+    }
+  })
+
+// =============================================================================
+// COMANDO: config
+// =============================================================================
+program
+  .command('config')
+  .description('Mostra ou edita configuração')
+  .argument('[chave]', 'Chave de configuração')
+  .option('-e, --edit', 'Editar configuração')
+  .option('-v, --value <valor>', 'Definir valor')
+  .action(async (key, options) => {
+    const configPath = join(PROJECT_ROOT, '.cleudocode-core')
+    
+    if (!fs.existsSync(configPath)) {
+      p.log.error('Configuração não encontrada. Execute: cleudocode-core init')
+      process.exit(1)
+    }
+
+    const config = yaml.load(fs.readFileSync(configPath, 'utf-8'))
+
+    if (options.edit) {
+      const editor = process.env.EDITOR || 'nano'
+      await execa(editor, [configPath], { stdio: 'inherit' })
+      p.log.success('Configuração atualizada!')
+      return
+    }
+
+    if (key) {
+      const keys = key.split('.')
+      let value = config
+      for (const k of keys) {
+        value = value?.[k]
+      }
+      
+      if (value !== undefined) {
+        console.log(JSON.stringify(value, null, 2))
+      } else {
+        p.log.error(`Chave "${key}" não encontrada`)
+      }
+    } else {
+      console.log(yaml.dump(config))
+    }
+  })
+
+// =============================================================================
+// COMANDO: agents
+// =============================================================================
+program
+  .command('agents')
+  .description('Lista ou gerencia agentes')
+  .option('-l, --list', 'Listar agentes disponíveis')
+  .option('-a, --add <nome>', 'Adicionar novo agente')
+  .option('-r, --remove <nome>', 'Remover agente')
+  .action(async (options) => {
+    const agentsDir = join(PROJECT_ROOT, '.agents/agents')
+
+    if (options.list || !options.add && !options.remove) {
+      if (!fs.existsSync(agentsDir)) {
+        p.log.warn('Diretório de agentes não encontrado. Execute: cleudocode-core init')
+        return
+      }
+
+      const files = fs.readdirSync(agentsDir)
+      const agents = files
+        .filter(f => f.endsWith('.md'))
+        .map(f => f.replace('.md', ''))
+
+      if (agents.length === 0) {
+        p.log.info('Nenhum agente encontrado')
+        return
+      }
+
+      console.log(chalk.bold('\nAgentes disponíveis:\n'))
+      agents.forEach(agent => {
+        console.log(`  ${chalk.cyan('•')} ${agent}`)
+      })
+      console.log()
+    }
+
+    if (options.add) {
+      const agentPath = join(agentsDir, `${options.add}.md`)
+      if (fs.existsSync(agentPath)) {
+        p.log.error(`Agente "${options.add}" já existe`)
+        return
+      }
+
+      const template = getAgentTemplate(options.add)
+      fs.writeFileSync(agentPath, template)
+      p.log.success(`Agente "${options.add}" criado em ${agentPath}`)
+    }
+
+    if (options.remove) {
+      const agentPath = join(agentsDir, `${options.remove}.md`)
+      if (!fs.existsSync(agentPath)) {
+        p.log.error(`Agente "${options.remove}" não encontrado`)
+        return
+      }
+
+      fs.unlinkSync(agentPath)
+      p.log.success(`Agente "${options.remove}" removido`)
+    }
+  })
+
+// =============================================================================
+// COMANDO: doctor
+// =============================================================================
+program
+  .command('doctor')
+  .description('Verifica saúde da instalação')
+  .action(async () => {
+    p.intro(chalk.bgGreen.black(' Cleudocode Core - Doctor '))
+
+    const checks = []
+
+    // Verificar Node.js
+    const nodeVersion = process.version
+    const minVersion = 'v18.0.0'
+    checks.push({
+      name: 'Node.js',
+      status: semver.gte(nodeVersion, minVersion) ? 'ok' : 'error',
+      message: `${nodeVersion} (mínimo: ${minVersion})`
+    })
+
+    // Verificar .cleudocode-core
+    const configPath = join(PROJECT_ROOT, '.cleudocode-core')
+    checks.push({
+      name: '.cleudocode-core',
+      status: fs.existsSync(configPath) ? 'ok' : 'warn',
+      message: fs.existsSync(configPath) ? 'Encontrado' : 'Não encontrado (execute: cleudocode-core init)'
+    })
+
+    // Verificar AGENTS.md
+    const agentsPath = join(PROJECT_ROOT, 'AGENTS.md')
+    checks.push({
+      name: 'AGENTS.md',
+      status: fs.existsSync(agentsPath) ? 'ok' : 'warn',
+      message: fs.existsSync(agentsPath) ? 'Encontrado' : 'Não encontrado'
+    })
+
+    // Verificar .env
+    const envPath = join(PROJECT_ROOT, '.env')
+    checks.push({
+      name: '.env',
+      status: fs.existsSync(envPath) ? 'ok' : 'info',
+      message: fs.existsSync(envPath) ? 'Encontrado' : 'Opcional (copie de .env.example)'
+    })
+
+    // Verificar Ollama
+    try {
+      await execa('ollama', ['--version'])
+      checks.push({
+        name: 'Ollama',
+        status: 'ok',
+        message: 'Instalado'
+      })
+    } catch {
+      checks.push({
+        name: 'Ollama',
+        status: 'info',
+        message: 'Não instalado (opcional para modelos locais)'
+      })
+    }
+
+    // Exibir resultados
+    console.log()
+    for (const check of checks) {
+      const icon = {
+        ok: chalk.green('✓'),
+        warn: chalk.yellow('⚠'),
+        error: chalk.red('✗'),
+        info: chalk.blue('ℹ')
+      }[check.status]
+
+      console.log(`${icon} ${chalk.bold(check.name)}: ${check.message}`)
+    }
+    console.log()
+
+    const hasError = checks.some(c => c.status === 'error')
+    const hasWarn = checks.some(c => c.status === 'warn')
+
+    if (hasError) {
+      p.outro(chalk.red('Foram encontrados erros que precisam de atenção'))
+    } else if (hasWarn) {
+      p.outro(chalk.yellow('Tudo ok, mas há avisos para melhorar a experiência'))
+    } else {
+      p.outro(chalk.green('Tudo certo! Configuração está saudável'))
+    }
+  })
+
+// =============================================================================
+// COMANDO: run
+// =============================================================================
+program
+  .command('run <agente>')
+  .description('Executa um agente')
+  .option('-t, --task <tarefa>', 'Tarefa a executar')
+  .option('-v, --verbose', 'Modo verbose')
+  .action(async (agent, options) => {
+    p.intro(chalk.bgGreen.black(` Cleudocode Core - ${agent} `))
+
+    const agentPath = join(PROJECT_ROOT, '.agents/agents', `${agent}.md`)
+    
+    if (!fs.existsSync(agentPath)) {
+      p.log.error(`Agente "${agent}" não encontrado`)
+      p.log.info('Use "cleudocode-core agents --list" para ver agentes disponíveis')
+      process.exit(1)
+    }
+
+    const agentContent = fs.readFileSync(agentPath, 'utf-8')
+    
+    if (options.task) {
+      p.log.info(`Executando tarefa: ${options.task}`)
+      // Implementar execução de tarefa
+      console.log(chalk.dim('(Funcionalidade em desenvolvimento)'))
+    } else {
+      console.log(agentContent)
+    }
+  })
+
+// =============================================================================
+// COMANDO: update
+// =============================================================================
+program
+  .command('update')
+  .description('Atualiza cleudocode-core para última versão')
+  .option('-g, --global', 'Atualizar instalação global')
+  .action(async (options) => {
+    const spinner = ora('Verificando atualizações...').start()
+
+    try {
+      const { stdout } = await execa('npm', ['view', 'cleudocode-core', 'version'])
+      const latestVersion = stdout.trim()
+
+      if (semver.gt(latestVersion, VERSION)) {
+        spinner.info(`Nova versão disponível: ${latestVersion} (atual: ${VERSION})`)
+        
+        if (options.global) {
+          const updateSpinner = ora('Atualizando instalação global...').start()
+          await execa('npm', ['update', '-g', 'cleudocode-core'])
+          updateSpinner.succeed('Atualizado com sucesso!')
+        } else {
+          console.log(`
+Para atualizar:
+
+${chalk.cyan('Global:')}
+  npm update -g cleudocode-core
+
+${chalk.cyan('Local (projeto):')}
+  npm update cleudocode-core
+
+${chalk.cyan('Usando npx (sempre mais recente):')}
+  npx cleudocode-core@latest
+`)
+        }
+      } else {
+        spinner.succeed('Você já está na versão mais recente!')
+      }
+    } catch (error) {
+      spinner.fail('Erro ao verificar atualizações')
+      p.log.error(error.message)
+    }
+  })
+
+// =============================================================================
+// COMANDO: templates
+// =============================================================================
+program
+  .command('templates')
+  .description('Lista templates disponíveis')
+  .action(async () => {
+    const templatesDir = join(__dirname, '../templates')
+    
+    if (!fs.existsSync(templatesDir)) {
+      p.log.warn('Nenhum template encontrado')
+      return
+    }
+
+    const templates = fs.readdirSync(templatesDir)
+    
+    console.log(chalk.bold('\nTemplates disponíveis:\n'))
+    templates.forEach(t => {
+      console.log(`  ${chalk.cyan('•')} ${t}`)
+    })
+    console.log()
+  })
+
+// =============================================================================
+// HELP PERSONALIZADO
+// =============================================================================
+program.addHelpText('after', `
+${chalk.bold('Exemplos:')}
+  ${chalk.cyan('npx cleudocode-core init')}              Inicializa no projeto atual
+  ${chalk.cyan('cleudocode-core install')}               Instala globalmente
+  ${chalk.cyan('cleudocode-core agents --list')}         Lista agentes
+  ${chalk.cyan('cleudocode-core doctor')}                Verifica saúde da instalação
+  ${chalk.cyan('cleudocode-core config settings')}       Mostra configurações
+  ${chalk.cyan('cleudocode-core run dev -t "criar API"')} Executa agente
+
+${chalk.bold('Links:')}
+  Documentação: https://github.com/cleudocode/cleudocode-core
+  Issues: https://github.com/cleudocode/cleudocode-core/issues
+  NPM: https://www.npmjs.com/package/cleudocode-core
+`)
+
+// =============================================================================
+// EXECUÇÃO
+// =============================================================================
+program.parse()
+
+// =============================================================================
+// FUNÇÕES AUXILIARES
+// =============================================================================
+
+function getDefaultConfig(template) {
+  return `# Cleudocode Core Configuration
+# Template: ${template}
+# Gerado em: ${new Date().toISOString()}
+
+version: "1.0.0"
+
+settings:
+  language: "pt-BR"
+  default_agent: "general-purpose"
+  verbose: false
+  log_mode: "console"
+
+llms:
+  models:
+    - name: "qwen3:4b"
+      backend: "ollama"
+      hostname: "http://localhost:11434"
+      enabled: true
+
+agents:
+  enabled:
+    - "general-purpose"
+    - "code-review"
+    - "testing"
+  default: "general-purpose"
+
+paths:
+  rules: ".agents/rules"
+  agents: ".agents/agents"
+  tasks: ".agents/tasks"
+  templates: ".agents/templates"
+`
+}
+
+function getDefaultAgentsMd() {
+  return `# AGENTS.md - Cleudocode Hub
+
+## Agentes Disponíveis
+
+| Agente | Descrição |
+|--------|-----------|
+| @general-purpose | Agente de uso geral |
+| @code-review | Revisão de código |
+| @testing | Criação de testes |
+
+## Uso
+
+\`\`\`bash
+# Listar agentes
+cleudocode-core agents --list
+
+# Executar agente
+cleudocode-core run general-purpose -t "minha tarefa"
+\`\`\`
+`
+}
+
+function getDefaultEnvExample() {
+  return `# Cleudocode Hub - Environment Variables
+# Copie para .env e preencha com suas credenciais
+
+# API Keys
+OPENAI_API_KEY=sk-...
+ANTHROPIC_API_KEY=sk-ant-...
+GEMINI_API_KEY=...
+
+# Ollama (Local)
+OLLAMA_HOST=http://localhost:11434
+OLLAMA_MODEL=qwen3:4b
+`
+}
+
+function getAgentTemplate(name) {
+  return `# ${name.toUpperCase()}
+
+## Descrição
+Agente especializado em ${name}.
+
+## Comandos
+- *help - Mostrar ajuda
+- *status - Status atual
+- *exit - Sair do modo agente
+
+## Exemplo de Uso
+\`\`\`bash
+cleudocode-core run ${name} -t "descrição da tarefa"
+\`\`\`
+`
+}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "cleudocode-core",
+  "version": "1.0.0",
+  "description": "Cleudocode Core - AI Orchestration Framework para desenvolvimento com agentes AI",
+  "author": "Cleudocode Team",
+  "license": "MIT",
+  "keywords": [
+    "ai",
+    "agents",
+    "orchestrator",
+    "cleudocode",
+    "cli",
+    "automation",
+    "development",
+    "llm"
+  ],
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "cleudocode": "./bin/cleudocode.js",
+    "cleudocode-core": "./bin/cleudocode.js",
+    "ccore": "./bin/cleudocode.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "templates/",
+    ".cleudocode-core",
+    "AGENTS.md",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node bin/cleudocode.js",
+    "dev": "node --watch bin/cleudocode.js",
+    "test": "node --test tests/**/*.test.js",
+    "lint": "eslint .",
+    "format": "prettier --write ."
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "execa": "^9.5.2",
+    "fs-extra": "^11.3.0",
+    "js-yaml": "^4.1.0",
+    "ora": "^8.2.0",
+    "picocolors": "^1.1.1",
+    "semver": "^7.7.1"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=9.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cleudocode/cleudocode-core.git"
+  },
+  "bugs": {
+    "url": "https://github.com/cleudocode/cleudocode-core/issues"
+  },
+  "homepage": "https://github.com/cleudocode/cleudocode-core#readme",
+  "lint-staged": {
+    "*.js": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{md,json,yaml,yml}": [
+      "prettier --write"
+    ]
+  }
+}

package/src/index.js

@@ -0,0 +1,24 @@
+/**
+ * Cleudocode Core - Main Entry Point
+ * 
+ * AI Orchestration Framework para desenvolvimento com agentes AI
+ * 
+ * @module cleudocode-core
+ * @version 1.0.0
+ */
+
+export { version } from '../package.json'
+
+/**
+ * Inicializa o Cleudocode Core
+ * @returns {Object} Configuração inicializada
+ */
+export function init() {
+  console.log('Cleudocode Core initialized')
+  return {
+    version: '1.0.0',
+    name: 'cleudocode-core'
+  }
+}
+
+export default { init }