@nimbuslab/cli 0.9.0 → 0.10.0

package/docs/upgrade.md

@@ -0,0 +1,152 @@
+# nimbus upgrade
+
+Planeja e executa upgrades de dependencias para a stack nimbuslab.
+
+## Uso
+
+```bash
+# Ver plano completo de upgrades
+nimbus upgrade --plan
+
+# Upgrade especifico (em desenvolvimento)
+nimbus upgrade next
+nimbus upgrade react
+nimbus upgrade tailwind
+nimbus upgrade bun
+```
+
+## Upgrades Suportados
+
+### Next.js 14/15 -> 16
+
+| Aspecto | Detalhes |
+|---------|----------|
+| Complexidade | Media |
+| Breaking Changes | next/image API, middleware, turbopack |
+| Tempo Estimado | 1-2 horas |
+
+**Passos:**
+1. Atualizar next para ^16.0.0
+2. Atualizar react para ^19.0.0
+3. Atualizar react-dom para ^19.0.0
+4. Revisar next.config.ts
+5. Testar build e dev
+
+### React 18 -> 19
+
+| Aspecto | Detalhes |
+|---------|----------|
+| Complexidade | Media |
+| Breaking Changes | forwardRef, Suspense, async components |
+| Tempo Estimado | 1-2 horas |
+
+**Passos:**
+1. Atualizar react e react-dom para ^19.0.0
+2. Remover forwardRef (ref agora e prop regular)
+3. Atualizar @types/react
+4. Revisar Suspense boundaries
+
+### Tailwind 3 -> 4
+
+| Aspecto | Detalhes |
+|---------|----------|
+| Complexidade | Media |
+| Breaking Changes | Config em CSS, @apply syntax |
+| Tempo Estimado | 2-4 horas |
+
+**Passos:**
+1. Atualizar tailwindcss para ^4.0.0
+2. Converter tailwind.config.js para CSS
+3. Atualizar globals.css com @import 'tailwindcss'
+4. Revisar @apply usages
+5. Atualizar plugins
+
+### pnpm/npm/yarn -> bun
+
+| Aspecto | Detalhes |
+|---------|----------|
+| Complexidade | Baixa |
+| Breaking Changes | Lockfile, alguns scripts |
+| Tempo Estimado | 30 min |
+
+**Passos:**
+1. Remover node_modules
+2. Remover lockfile antigo
+3. Executar bun install
+4. Atualizar scripts (npx -> bunx)
+5. Atualizar CI/CD
+
+### Prisma -> Drizzle
+
+| Aspecto | Detalhes |
+|---------|----------|
+| Complexidade | Alta |
+| Breaking Changes | Schema, queries, migrations |
+| Tempo Estimado | 4-8 horas |
+
+**Passos:**
+1. Instalar drizzle-orm e drizzle-kit
+2. Converter schema.prisma para drizzle
+3. Configurar drizzle.config.ts
+4. Gerar migrations
+5. Atualizar todas as queries
+6. Atualizar auth config
+
+## Exemplo de Output
+
+```
+  Upgrades Disponiveis:
+
+  Next.js
+    Atual: 15.0.2 -> 16.x
+    Complexidade: media
+
+    Breaking Changes:
+      ! next/image: Mudancas na API de otimizacao
+      ! Middleware: Novo formato de config
+      ! Turbopack: Agora e o bundler padrao
+
+    Passos:
+      1. Atualizar next para ^16.0.0
+      2. Atualizar react para ^19.0.0
+      3. Revisar next.config.ts
+      4. Testar build: bun run build
+
+  React
+    Atual: 18.2.0 -> 19.x
+    Complexidade: media
+
+    Breaking Changes:
+      ! forwardRef: Nao mais necessario
+      ! Suspense: Mudancas em fallback
+      ! Async components: Novo suporte
+
+    Passos:
+      1. Atualizar react para ^19.0.0
+      2. Remover forwardRef
+      3. Revisar Suspense boundaries
+```
+
+## Codemods (Em Desenvolvimento)
+
+Codemods sao transformacoes automaticas de codigo usando AST:
+
+```bash
+# Futuros comandos
+nimbus codemod tailwind-v4    # Transforma Tailwind 3 -> 4
+nimbus codemod react-19       # Transforma React 18 -> 19
+nimbus codemod drizzle        # Transforma Prisma -> Drizzle
+nimbus codemod bun            # Transforma para Bun
+```
+
+## Estrategia de Upgrade
+
+1. **Sempre** fazer backup/branch antes
+2. **Sempre** rodar `nimbus analyze` primeiro
+3. **Sempre** testar apos cada upgrade
+4. **Nunca** fazer todos os upgrades de uma vez
+5. **Preferir** ordem: bun -> tailwind -> react -> next
+
+---
+
+[Voltar ao README](../README.md) | [create](./create.md) | [analyze](./analyze.md) | [migrate](./migrate.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nimbuslab/cli",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "CLI para criar projetos nimbuslab",
   "type": "module",
   "bin": {

package/src/commands/lola.ts

@@ -0,0 +1,201 @@
+import * as p from "@clack/prompts"
+import pc from "picocolors"
+import { existsSync } from "node:fs"
+import { join } from "node:path"
+
+const LOLA_DIR = join(process.env.HOME || "~", ".lola")
+const LOLA_REPO = "git@github.com:nimbuslab/lola.git"
+const USER_MEMORY = join(process.env.HOME || "~", ".claude", "USER_MEMORY.md")
+
+async function installLola(): Promise<void> {
+  console.log()
+  console.log(pc.cyan("  Lola - Code Agent da nimbuslab"))
+  console.log(pc.dim("  ==============================="))
+  console.log()
+
+  const isUpdate = existsSync(LOLA_DIR)
+
+  if (isUpdate) {
+    console.log(pc.dim(`  Lola ja instalada em ${LOLA_DIR}`))
+    console.log(pc.cyan("  Atualizando..."))
+
+    const result = Bun.spawnSync(["git", "pull", "--quiet"], {
+      cwd: LOLA_DIR,
+      stdout: "inherit",
+      stderr: "inherit",
+    })
+
+    if (result.exitCode !== 0) {
+      console.log(pc.red("  Erro ao atualizar Lola"))
+      process.exit(1)
+    }
+
+    console.log(pc.green("  Atualizado!"))
+  } else {
+    console.log(pc.cyan(`  Instalando Lola em ${LOLA_DIR}...`))
+
+    const result = Bun.spawnSync(["git", "clone", "--quiet", LOLA_REPO, LOLA_DIR], {
+      stdout: "inherit",
+      stderr: "inherit",
+    })
+
+    if (result.exitCode !== 0) {
+      console.log(pc.red("  Erro ao clonar repositorio"))
+      console.log(pc.dim("  Verifique se tem acesso ao repo nimbuslab/lola"))
+      process.exit(1)
+    }
+
+    console.log(pc.green("  Instalado!"))
+  }
+
+  // Verificar USER_MEMORY.md
+  const claudeDir = join(process.env.HOME || "~", ".claude")
+  if (!existsSync(USER_MEMORY)) {
+    console.log()
+    console.log(pc.cyan("  Criando USER_MEMORY.md..."))
+
+    await Bun.$`mkdir -p ${claudeDir}`
+
+    const content = `# User Memory
+
+Memoria persistente para sessoes Claude Code
+
+---
+
+## Configuracoes da Lola
+
+\`\`\`
+lola_profile: millennial
+\`\`\`
+
+---
+
+## Ultima Sessao
+
+(sera preenchido automaticamente)
+
+---
+`
+    await Bun.write(USER_MEMORY, content)
+    console.log(pc.green("  USER_MEMORY.md criado!"))
+  }
+
+  console.log()
+  console.log(pc.green("  Instalacao concluida!"))
+  console.log()
+  console.log(pc.bold("  Para usar a Lola:"))
+  console.log(pc.dim("    lola              ") + pc.white("# Iniciar sessao"))
+  console.log(pc.dim("    lola suggest \"x\"  ") + pc.white("# Sugerir melhoria"))
+  console.log()
+  console.log(pc.bold("  Para mudar perfil, edite ~/.claude/USER_MEMORY.md:"))
+  console.log(pc.dim("    lola_profile: millennial|genz|profissional|nerd|chill"))
+  console.log()
+}
+
+async function suggestImprovement(message: string): Promise<void> {
+  if (!message) {
+    console.log(pc.red("  Erro: forneça uma mensagem"))
+    console.log(pc.dim("  Uso: nimbus lola suggest \"sua sugestao aqui\""))
+    process.exit(1)
+  }
+
+  // Verificar gh cli
+  const ghCheck = Bun.spawnSync(["which", "gh"])
+  if (ghCheck.exitCode !== 0) {
+    console.log(pc.red("  Erro: GitHub CLI (gh) nao encontrado"))
+    console.log(pc.dim("  Instale: https://cli.github.com"))
+    process.exit(1)
+  }
+
+  // Verificar autenticacao
+  const authCheck = Bun.spawnSync(["gh", "auth", "status"], {
+    stdout: "pipe",
+    stderr: "pipe",
+  })
+  if (authCheck.exitCode !== 0) {
+    console.log(pc.red("  Erro: GitHub CLI nao autenticado"))
+    console.log(pc.dim("  Execute: gh auth login"))
+    process.exit(1)
+  }
+
+  // Pegar info do usuario
+  const gitUser = Bun.spawnSync(["git", "config", "user.name"], { stdout: "pipe" })
+  const gitEmail = Bun.spawnSync(["git", "config", "user.email"], { stdout: "pipe" })
+
+  const userName = gitUser.stdout.toString().trim() || "Dev"
+  const userEmail = gitEmail.stdout.toString().trim() || ""
+
+  console.log()
+  console.log(pc.cyan("  Criando sugestao..."))
+
+  const date = new Date().toISOString().split("T")[0]
+  const body = `## Sugestao
+
+${message}
+
+---
+
+**Enviado por:** ${userName}
+**Email:** ${userEmail}
+**Data:** ${date}
+
+---
+*Criado via \`nimbus lola suggest\`*`
+
+  const title = `Sugestao: ${message.slice(0, 50)}${message.length > 50 ? "..." : ""}`
+
+  const result = Bun.spawnSync([
+    "gh", "issue", "create",
+    "--repo", "nimbuslab/lola",
+    "--title", title,
+    "--body", body,
+    "--label", "sugestao",
+  ], {
+    stdout: "inherit",
+    stderr: "inherit",
+  })
+
+  if (result.exitCode !== 0) {
+    console.log(pc.red("  Erro ao criar issue"))
+    process.exit(1)
+  }
+
+  console.log()
+  console.log(pc.green("  Sugestao enviada! Hugo vai revisar."))
+  console.log()
+}
+
+export async function lola(args: string[]) {
+  const subcommand = args[0]
+
+  if (!subcommand || subcommand === "install" || subcommand === "sync") {
+    await installLola()
+  } else if (subcommand === "suggest") {
+    const message = args.slice(1).join(" ")
+    await suggestImprovement(message)
+  } else if (subcommand === "help" || subcommand === "--help" || subcommand === "-h") {
+    showLolaHelp()
+  } else {
+    console.log(pc.red(`  Subcomando desconhecido: ${subcommand}`))
+    showLolaHelp()
+    process.exit(1)
+  }
+}
+
+function showLolaHelp() {
+  console.log()
+  console.log(pc.bold("  Lola - Code Agent da nimbuslab"))
+  console.log()
+  console.log(pc.bold("  Uso:") + " nimbus lola [subcomando]")
+  console.log()
+  console.log(pc.bold("  Subcomandos:"))
+  console.log(pc.dim("    install        ") + pc.white("Instalar/atualizar Lola"))
+  console.log(pc.dim("    sync           ") + pc.white("Alias para install"))
+  console.log(pc.dim("    suggest \"msg\"  ") + pc.white("Sugerir melhoria (cria issue)"))
+  console.log(pc.dim("    help           ") + pc.white("Mostrar esta ajuda"))
+  console.log()
+  console.log(pc.bold("  Exemplos:"))
+  console.log(pc.dim("    $ nimbus lola install"))
+  console.log(pc.dim("    $ nimbus lola suggest \"adicionar suporte a X\""))
+  console.log()
+}

package/src/index.ts

@@ -5,6 +5,7 @@ import pc from "picocolors"
 import { create } from "./commands/create"
 import { analyze } from "./commands/analyze"
 import { upgrade } from "./commands/upgrade"
+import { lola } from "./commands/lola"
 
 const PACKAGE_NAME = "@nimbuslab/cli"
 const CURRENT_VERSION = "0.9.0"
@@ -80,6 +81,8 @@ async function main() {
     await analyze(args.slice(1))
   } else if (command === "upgrade") {
     await upgrade(args.slice(1))
+  } else if (command === "lola") {
+    await lola(args.slice(1))
   } else if (command === "help" || command === "--help" || command === "-h") {
     showHelp()
   } else if (command === "version" || command === "--version" || command === "-v") {
@@ -99,6 +102,7 @@ ${pc.bold("Commands:")}
   create [name]    Create a new project
   analyze [dir]    Analyze project stack
   upgrade [target] Upgrade dependencies
+  lola [action]    Lola - Code Agent
   help             Show this help
   version          Show version
 
@@ -120,11 +124,17 @@ ${pc.bold("Options:")}
   --no-install     Don't install dependencies
   --template <url> Use custom template
 
+${pc.bold("Lola (Code Agent):")}
+  lola install     Install/update Lola
+  lola suggest     Suggest improvement (creates issue)
+
 ${pc.bold("Examples:")}
   ${pc.dim("$")} nimbus create my-landing --landing
   ${pc.dim("$")} nimbus create my-app --app
   ${pc.dim("$")} nimbus analyze ./my-project
   ${pc.dim("$")} nimbus upgrade --plan
+  ${pc.dim("$")} nimbus lola install
+  ${pc.dim("$")} nimbus lola suggest "add support for X"
 `)
 }