@nimbuslab/cli 0.16.4 → 0.16.5

package/docs/package.md

@@ -1,229 +0,0 @@
-# nimbus create --package
-
-Cria um pacote npm pronto para publicar.
-
----
-
-## Uso
-
-```bash
-nimbus create meu-pacote --package
-```
-
----
-
-## Estrutura gerada
-
-```
-meu-pacote/
-├── src/
-│   └── index.ts          # Entry point
-├── dist/                  # Build output (gitignored)
-├── package.json           # Configurado para npm
-├── tsconfig.json          # TypeScript config
-├── tsup.config.ts         # Build config
-├── README.md              # Documentacao
-├── CHANGELOG.md           # Historico de versoes
-├── LICENSE                # MIT
-└── .github/
-    └── workflows/
-        └── publish.yml    # CI/CD para npm
-```
-
----
-
-## package.json
-
-```json
-{
-  "name": "@nimbuslab/meu-pacote",
-  "version": "0.1.0",
-  "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "files": ["dist"],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "prepublishOnly": "bun run build"
-  }
-}
-```
-
----
-
-## Build com tsup
-
-O template usa [tsup](https://tsup.egoist.dev/) para build:
-
-```typescript
-// tsup.config.ts
-import { defineConfig } from "tsup"
-
-export default defineConfig({
-  entry: ["src/index.ts"],
-  format: ["cjs", "esm"],
-  dts: true,
-  clean: true,
-  minify: true,
-})
-```
-
-**Por que tsup?**
-- Zero config
-- ESM + CJS em um comando
-- TypeScript declarations automaticas
-- Rapido (usa esbuild)
-
----
-
-## Workflow de desenvolvimento
-
-### 1. Desenvolver
-
-```bash
-cd meu-pacote
-bun run dev     # Watch mode
-```
-
-### 2. Testar localmente
-
-```bash
-# Em outro projeto
-bun add ../meu-pacote
-
-# Ou com link
-cd meu-pacote && bun link
-cd outro-projeto && bun link @nimbuslab/meu-pacote
-```
-
-### 3. Build
-
-```bash
-bun run build
-```
-
-### 4. Publicar
-
-```bash
-# Bump version
-npm version patch   # 0.1.0 -> 0.1.1
-npm version minor   # 0.1.0 -> 0.2.0
-npm version major   # 0.1.0 -> 1.0.0
-
-# Publicar
-npm publish --access public
-```
-
----
-
-## CI/CD automatico
-
-O template inclui GitHub Action para publicar automaticamente:
-
-```yaml
-# .github/workflows/publish.yml
-name: Publish
-
-on:
-  push:
-    tags:
-      - "v*"
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: oven-sh/setup-bun@v1
-      - run: bun install
-      - run: bun run build
-      - run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-```
-
-**Para usar:**
-1. Criar token em npmjs.com
-2. Adicionar `NPM_TOKEN` nos secrets do repo
-3. Criar tag: `git tag v0.1.0 && git push --tags`
-
----
-
-## Escopo @nimbuslab
-
-Para publicar no escopo `@nimbuslab`:
-
-```bash
-# Primeira vez: logar no npm
-npm login
-
-# Verificar organizacao
-npm org ls nimbuslab
-```
-
-**Nota:** Pacotes com escopo precisam de `--access public` para serem publicos.
-
----
-
-## Boas praticas
-
-### Versionamento (SemVer)
-
-| Tipo | Quando usar | Exemplo |
-|------|-------------|---------|
-| `patch` | Bug fixes | 0.1.0 -> 0.1.1 |
-| `minor` | Novas features (retrocompativeis) | 0.1.0 -> 0.2.0 |
-| `major` | Breaking changes | 0.1.0 -> 1.0.0 |
-
-### CHANGELOG
-
-Manter atualizado com cada release:
-
-```markdown
-# Changelog
-
-## [0.2.0] - 2026-01-28
-
-### Added
-- Nova funcionalidade X
-
-### Fixed
-- Bug Y corrigido
-
-## [0.1.0] - 2026-01-27
-
-- Release inicial
-```
-
-### README
-
-Incluir:
-- O que o pacote faz
-- Como instalar
-- Como usar (exemplos)
-- API reference
-- License
-
----
-
-## Exemplos de pacotes
-
-| Pacote | Descricao |
-|--------|-----------|
-| `@nimbuslab/cli` | CLI oficial |
-| `@nimbuslab/utils` | Utilitarios compartilhados |
-| `@nimbuslab/ui` | Design system |
-| `@nimbuslab/config` | Configs compartilhadas |
-
----
-
-[Voltar ao README](../README.md) | [create](./create.md) | [analyze](./analyze.md)

package/docs/upgrade.md

@@ -1,152 +0,0 @@
-# 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/src/commands/analyze.ts

@@ -1,210 +0,0 @@
-import * as p from "@clack/prompts"
-import pc from "picocolors"
-import { existsSync, readFileSync } from "node:fs"
-import { join } from "node:path"
-
-interface AnalysisResult {
-  name: string
-  version: string
-  framework: string | null
-  frameworkVersion: string | null
-  styling: string[]
-  packageManager: string
-  monorepo: string | null
-  auth: string | null
-  database: string | null
-  typescript: boolean
-  dependencies: Record<string, string>
-  devDependencies: Record<string, string>
-  recommendations: string[]
-}
-
-function detectPackageManager(dir: string): string {
-  if (existsSync(join(dir, "bun.lockb"))) return "bun"
-  if (existsSync(join(dir, "pnpm-lock.yaml"))) return "pnpm"
-  if (existsSync(join(dir, "yarn.lock"))) return "yarn"
-  if (existsSync(join(dir, "package-lock.json"))) return "npm"
-  return "unknown"
-}
-
-function detectMonorepo(dir: string, pkg: any): string | null {
-  if (existsSync(join(dir, "turbo.json"))) return "turborepo"
-  if (existsSync(join(dir, "nx.json"))) return "nx"
-  if (existsSync(join(dir, "lerna.json"))) return "lerna"
-  if (pkg.workspaces) return "workspaces"
-  return null
-}
-
-function detectFramework(deps: Record<string, string>): { name: string | null; version: string | null } {
-  if (deps["next"]) return { name: "nextjs", version: deps["next"] }
-  if (deps["@angular/core"]) return { name: "angular", version: deps["@angular/core"] }
-  if (deps["vue"]) return { name: "vue", version: deps["vue"] }
-  if (deps["svelte"]) return { name: "svelte", version: deps["svelte"] }
-  if (deps["react"] && !deps["next"]) return { name: "react", version: deps["react"] }
-  return { name: null, version: null }
-}
-
-function detectStyling(deps: Record<string, string>, devDeps: Record<string, string>): string[] {
-  const styling: string[] = []
-  const allDeps = { ...deps, ...devDeps }
-
-  if (allDeps["tailwindcss"]) styling.push(`tailwind@${allDeps["tailwindcss"]}`)
-  if (allDeps["styled-components"]) styling.push("styled-components")
-  if (allDeps["@emotion/react"]) styling.push("emotion")
-  if (allDeps["sass"]) styling.push("sass")
-  if (allDeps["less"]) styling.push("less")
-
-  return styling.length > 0 ? styling : ["css"]
-}
-
-function detectAuth(deps: Record<string, string>): string | null {
-  if (deps["better-auth"]) return "better-auth"
-  if (deps["next-auth"]) return "next-auth"
-  if (deps["@clerk/nextjs"]) return "clerk"
-  if (deps["@auth0/nextjs-auth0"]) return "auth0"
-  if (deps["@supabase/supabase-js"]) return "supabase"
-  return null
-}
-
-function detectDatabase(deps: Record<string, string>): string | null {
-  if (deps["drizzle-orm"]) return "drizzle"
-  if (deps["@prisma/client"]) return "prisma"
-  if (deps["typeorm"]) return "typeorm"
-  if (deps["mongoose"]) return "mongoose"
-  if (deps["pg"]) return "pg"
-  if (deps["mysql2"]) return "mysql"
-  return null
-}
-
-function generateRecommendations(result: AnalysisResult): string[] {
-  const recs: string[] = []
-
-  // Package manager
-  if (result.packageManager !== "bun") {
-    recs.push(`Migrar ${result.packageManager} -> bun (nimbus codemod bun)`)
-  }
-
-  // Framework version
-  if (result.framework === "nextjs" && result.frameworkVersion) {
-    const majorVersion = parseInt(result.frameworkVersion.replace(/[^0-9]/g, "").slice(0, 2))
-    if (majorVersion < 16) {
-      recs.push(`Atualizar Next.js ${result.frameworkVersion} -> 16 (nimbus upgrade next)`)
-    }
-  }
-
-  // Tailwind
-  const tailwind = result.styling.find(s => s.startsWith("tailwind"))
-  if (tailwind) {
-    const version = tailwind.split("@")[1] || ""
-    if (version.startsWith("3")) {
-      recs.push(`Atualizar Tailwind 3 -> 4 (nimbus upgrade tailwind)`)
-    }
-  } else if (!result.styling.includes("tailwind")) {
-    recs.push(`Considerar adicionar Tailwind CSS (nimbus add tailwind)`)
-  }
-
-  // React version
-  if (result.dependencies["react"]) {
-    const reactVersion = result.dependencies["react"]
-    if (reactVersion.startsWith("18") || reactVersion.startsWith("^18")) {
-      recs.push(`Atualizar React 18 -> 19 (nimbus upgrade react)`)
-    }
-  }
-
-  // Database
-  if (result.database === "prisma") {
-    recs.push(`Considerar migrar Prisma -> Drizzle (nimbus codemod drizzle)`)
-  } else if (!result.database && result.framework === "nextjs") {
-    recs.push(`Considerar adicionar banco de dados (nimbus add db)`)
-  }
-
-  // Auth
-  if (!result.auth && result.framework === "nextjs") {
-    recs.push(`Considerar adicionar autenticacao (nimbus add auth)`)
-  } else if (result.auth === "next-auth") {
-    recs.push(`Considerar migrar NextAuth -> Better Auth`)
-  }
-
-  // Monorepo
-  if (result.monorepo === "workspaces" && !result.monorepo) {
-    recs.push(`Considerar usar Turborepo para monorepo (nimbus add monorepo)`)
-  }
-
-  return recs
-}
-
-export async function analyze(args: string[]) {
-  const targetDir = args[0] || "."
-  const absoluteDir = targetDir.startsWith("/") ? targetDir : join(process.cwd(), targetDir)
-
-  console.log()
-  console.log(pc.cyan("  Analisando projeto..."))
-  console.log()
-
-  // Check if package.json exists
-  const pkgPath = join(absoluteDir, "package.json")
-  if (!existsSync(pkgPath)) {
-    console.log(pc.red("  Erro: package.json nao encontrado"))
-    console.log(pc.dim(`  Diretorio: ${absoluteDir}`))
-    process.exit(1)
-  }
-
-  // Read package.json
-  const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"))
-  const deps = pkg.dependencies || {}
-  const devDeps = pkg.devDependencies || {}
-
-  // Detect everything
-  const framework = detectFramework(deps)
-  const result: AnalysisResult = {
-    name: pkg.name || "unknown",
-    version: pkg.version || "0.0.0",
-    framework: framework.name,
-    frameworkVersion: framework.version,
-    styling: detectStyling(deps, devDeps),
-    packageManager: detectPackageManager(absoluteDir),
-    monorepo: detectMonorepo(absoluteDir, pkg),
-    auth: detectAuth(deps),
-    database: detectDatabase(deps),
-    typescript: existsSync(join(absoluteDir, "tsconfig.json")),
-    dependencies: deps,
-    devDependencies: devDeps,
-    recommendations: [],
-  }
-
-  // Generate recommendations
-  result.recommendations = generateRecommendations(result)
-
-  // Display results
-  console.log(pc.bold("  Projeto: ") + pc.cyan(result.name) + pc.dim(` v${result.version}`))
-  console.log()
-
-  console.log(pc.bold("  Stack Detectada:"))
-  console.log(`    Framework:       ${result.framework ? pc.green(result.framework + "@" + result.frameworkVersion) : pc.dim("nenhum")}`)
-  console.log(`    Styling:         ${result.styling.map(s => pc.green(s)).join(", ")}`)
-  console.log(`    Package Manager: ${result.packageManager === "bun" ? pc.green(result.packageManager) : pc.yellow(result.packageManager)}`)
-  console.log(`    TypeScript:      ${result.typescript ? pc.green("sim") : pc.dim("nao")}`)
-  console.log(`    Monorepo:        ${result.monorepo ? pc.green(result.monorepo) : pc.dim("nao")}`)
-  console.log(`    Auth:            ${result.auth ? pc.green(result.auth) : pc.dim("nenhum")}`)
-  console.log(`    Database:        ${result.database ? pc.green(result.database) : pc.dim("nenhum")}`)
-  console.log()
-
-  if (result.recommendations.length > 0) {
-    console.log(pc.bold("  Recomendacoes:"))
-    result.recommendations.forEach((rec, i) => {
-      console.log(pc.yellow(`    ${i + 1}. ${rec}`))
-    })
-    console.log()
-  } else {
-    console.log(pc.green("  Projeto ja esta na stack recomendada!"))
-    console.log()
-  }
-
-  // JSON output option
-  if (args.includes("--json")) {
-    console.log(pc.dim("  JSON:"))
-    console.log(JSON.stringify(result, null, 2))
-  }
-
-  return result
-}