@nimbuslab/cli 0.16.3 → 0.16.5

package/MIGRATION-ROADMAP.md

@@ -1,201 +0,0 @@
-# Roadmap - Sistema de Migracao nimbuslab
-
-> Lola Migration Assistant - Facilitar migracoes de projetos para o ecossistema nimbuslab
-
----
-
-## Visao Geral
-
-O sistema de migracao permite:
-1. **Analisar** projetos existentes (detectar stack)
-2. **Planejar** caminho de migracao
-3. **Executar** transformacoes automaticas (codemods)
-4. **Verificar** resultado final
-
----
-
-## Fase 1: Fundacao (v0.9.0)
-
-### M80: Estrutura base do sistema de migracao
-- [ ] Criar `src/commands/migrate.ts`
-- [ ] Criar `src/commands/analyze.ts`
-- [ ] Criar `src/commands/upgrade.ts`
-- [ ] Estrutura de pastas para codemods
-
-### M81: Comando `nimbus analyze`
-- [ ] Detectar package.json (name, version, dependencies)
-- [ ] Detectar framework (Next.js, React, Angular, Vue, etc)
-- [ ] Detectar styling (Tailwind, CSS Modules, styled-components)
-- [ ] Detectar package manager (bun, pnpm, npm, yarn)
-- [ ] Detectar monorepo (Turborepo, Nx, Lerna)
-- [ ] Detectar auth (Better Auth, NextAuth, Clerk, etc)
-- [ ] Detectar DB (Drizzle, Prisma, TypeORM, etc)
-- [ ] Output: JSON com analise completa
-
-### M82: Comando `nimbus upgrade --plan`
-- [ ] Comparar versoes atuais com recomendadas
-- [ ] Listar breaking changes conhecidos
-- [ ] Gerar plano de upgrade
-- [ ] Estimar complexidade (low/medium/high)
-
----
-
-## Fase 2: Codemods (v0.10.0)
-
-### M83: Infraestrutura de codemods
-- [ ] Criar `src/codemods/` estrutura
-- [ ] Runner de codemods (jscodeshift ou ts-morph)
-- [ ] Sistema de dry-run (preview)
-- [ ] Rollback automatico em caso de erro
-
-### M84: Codemod Tailwind 3 -> 4
-- [ ] Migrar classes depreciadas
-- [ ] Atualizar config (tailwind.config.js -> CSS)
-- [ ] Converter @apply para novo formato
-- [ ] Atualizar imports
-
-### M85: Codemod React 18 -> 19
-- [ ] Remover forwardRef (nao mais necessario)
-- [ ] Atualizar tipos (ref como prop)
-- [ ] Ajustar Suspense boundaries
-- [ ] Atualizar async components
-
-### M86: Codemod pnpm -> bun
-- [ ] Converter pnpm-lock.yaml para bun.lockb
-- [ ] Atualizar scripts no package.json
-- [ ] Remover .npmrc especifico pnpm
-- [ ] Atualizar CI/CD configs
-
-### M87: Codemod Prisma -> Drizzle
-- [ ] Converter schema.prisma para drizzle schema
-- [ ] Gerar migrations Drizzle
-- [ ] Atualizar queries (findMany -> select, etc)
-- [ ] Atualizar auth config
-
----
-
-## Fase 3: Templates Modulares (v0.11.0)
-
-### M88: Refatorar templates em camadas
-- [ ] Extrair `layers/base` (tsconfig, eslint, prettier)
-- [ ] Extrair `layers/nextjs` (next.config, app structure)
-- [ ] Extrair `layers/tailwind` (tailwind config, globals.css)
-- [ ] Extrair `layers/shadcn` (components.json, ui/)
-- [ ] Extrair `layers/auth` (Better Auth setup)
-- [ ] Extrair `layers/db` (Drizzle setup)
-- [ ] Extrair `layers/monorepo` (Turborepo config)
-
-### M89: Comando `nimbus add <layer>`
-- [ ] `nimbus add auth` - Adiciona Better Auth
-- [ ] `nimbus add db` - Adiciona Drizzle
-- [ ] `nimbus add shadcn` - Adiciona shadcn/ui
-- [ ] `nimbus add monorepo` - Converte para Turborepo
-- [ ] Detectar conflitos antes de aplicar
-- [ ] Merge inteligente de configs
-
----
-
-## Fase 4: Migracao Assistida (v0.12.0)
-
-### M90: Lola Migration Assistant
-- [ ] Criar `.claude/agents/lola-migrate.md`
-- [ ] Criar `.gemini/lola-migrate.md`
-- [ ] Prompts especializados para migracao
-- [ ] Checklist interativo
-- [ ] Documentacao de decisoes
-
-### M91: Comando `nimbus migrate`
-- [ ] `nimbus migrate --from=angular` - Plano Angular -> Next.js
-- [ ] `nimbus migrate --from=php` - Plano PHP -> Next.js
-- [ ] `nimbus migrate --from=vue` - Plano Vue -> React
-- [ ] Gerar plano detalhado (markdown)
-- [ ] Estimar esforco (horas/dias)
-
-### M92: Migration Guides
-- [ ] `knowledge/migrations/nextjs-15-to-16.md`
-- [ ] `knowledge/migrations/tailwind-3-to-4.md`
-- [ ] `knowledge/migrations/prisma-to-drizzle.md`
-- [ ] `knowledge/migrations/pnpm-to-bun.md`
-- [ ] `knowledge/migrations/angular-to-nextjs.md`
-- [ ] `knowledge/migrations/php-laravel-to-nextjs.md`
-
----
-
-## Fase 5: Automacao Completa (v1.0.0)
-
-### M93: Pipeline de migracao
-- [ ] `nimbus migrate --execute` (aplica codemods)
-- [ ] `nimbus migrate --verify` (roda build + lint + tests)
-- [ ] Relatorio de migracao (o que mudou, o que revisar)
-- [ ] Integracao com CI/CD
-
-### M94: Atualizacao automatica
-- [ ] `nimbus upgrade` detecta atualizacoes disponiveis
-- [ ] `nimbus upgrade --all` aplica todas seguras
-- [ ] Notificacao de breaking changes
-- [ ] Changelog automatico
-
----
-
-## Prioridade de Implementacao
-
-| Milestone | Prioridade | Dependencia |
-|-----------|------------|-------------|
-| M80 | Alta | - |
-| M81 | Alta | M80 |
-| M82 | Alta | M81 |
-| M83 | Alta | M80 |
-| M84 | Media | M83 |
-| M85 | Media | M83 |
-| M86 | Media | M83 |
-| M87 | Media | M83 |
-| M88 | Media | M80 |
-| M89 | Media | M88 |
-| M90 | Alta | M80 |
-| M91 | Media | M81, M83 |
-| M92 | Media | - |
-| M93 | Baixa | M91 |
-| M94 | Baixa | M93 |
-
----
-
-## Stack dos Codemods
-
-- **Parser:** ts-morph (TypeScript AST)
-- **Runner:** Custom (baseado em jscodeshift patterns)
-- **Configs:** JSON transforms
-- **CSS:** PostCSS para Tailwind
-
----
-
-## Exemplo de Uso Final
-
-```bash
-# Analisar projeto
-nimbus analyze ./meu-projeto
-# Output: Next.js 15, React 18, Tailwind 3, pnpm, Prisma
-
-# Ver plano de upgrade
-nimbus upgrade --plan
-# Output: Recomendado: Next 16, React 19, Tailwind 4, bun, Drizzle
-
-# Upgrade especifico
-nimbus upgrade tailwind
-# Executa codemod Tailwind 3 -> 4
-
-# Adicionar camada
-nimbus add auth
-# Adiciona Better Auth ao projeto
-
-# Migracao completa
-nimbus migrate --from=angular --plan
-# Gera plano de migracao Angular -> Next.js
-
-# Usar Lola para assistir
-claude --agent lola-migrate
-# Lola especializada em migracoes
-```
-
----
-
-*Ultima atualizacao: Janeiro 2026*

package/bun.lock

@@ -1,36 +0,0 @@
-{
-  "lockfileVersion": 1,
-  "configVersion": 1,
-  "workspaces": {
-    "": {
-      "name": "nimbus-cli",
-      "dependencies": {
-        "@clack/prompts": "^0.11.0",
-        "picocolors": "^1.1.1",
-      },
-      "devDependencies": {
-        "@types/bun": "latest",
-        "typescript": "^5",
-      },
-    },
-  },
-  "packages": {
-    "@clack/core": ["@clack/core@0.5.0", "", { "dependencies": { "picocolors": "^1.0.0", "sisteransi": "^1.0.5" } }, "sha512-p3y0FIOwaYRUPRcMO7+dlmLh8PSRcrjuTndsiA0WAFbWES0mLZlrjVoBRZ9DzkPFJZG6KGkJmoEAY0ZcVWTkow=="],
-
-    "@clack/prompts": ["@clack/prompts@0.11.0", "", { "dependencies": { "@clack/core": "0.5.0", "picocolors": "^1.0.0", "sisteransi": "^1.0.5" } }, "sha512-pMN5FcrEw9hUkZA4f+zLlzivQSeQf5dRGJjSUbvVYDLvpKCdQx5OaknvKzgbtXOizhP+SJJJjqEbOe55uKKfAw=="],
-
-    "@types/bun": ["@types/bun@1.3.6", "", { "dependencies": { "bun-types": "1.3.6" } }, "sha512-uWCv6FO/8LcpREhenN1d1b6fcspAB+cefwD7uti8C8VffIv0Um08TKMn98FynpTiU38+y2dUO55T11NgDt8VAA=="],
-
-    "@types/node": ["@types/node@25.0.10", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-zWW5KPngR/yvakJgGOmZ5vTBemDoSqF3AcV/LrO5u5wTWyEAVVh+IT39G4gtyAkh3CtTZs8aX/yRM82OfzHJRg=="],
-
-    "bun-types": ["bun-types@1.3.6", "", { "dependencies": { "@types/node": "*" } }, "sha512-OlFwHcnNV99r//9v5IIOgQ9Uk37gZqrNMCcqEaExdkVq3Avwqok1bJFmvGMCkCE0FqzdY8VMOZpfpR3lwI+CsQ=="],
-
-    "picocolors": ["picocolors@1.1.1", "", {}, "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA=="],
-
-    "sisteransi": ["sisteransi@1.0.5", "", {}, "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg=="],
-
-    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
-
-    "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
-  }
-}

package/docs/CI-CD.md

@@ -1,181 +0,0 @@
-# CI/CD - Publicacao no npm
-
-Documentacao do pipeline de publicacao automatica no npm.
-
-## Como Funciona
-
-Ao fazer merge na branch `main`, o GitHub Actions publica automaticamente no npm.
-
-```
-develop → main → GitHub Actions → npm publish
-```
-
-## Workflow
-
-Arquivo: `.github/workflows/publish.yml`
-
-```yaml
-name: Publish to npm
-
-on:
-  push:
-    branches:
-      - main
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      id-token: write  # Necessario para OIDC
-
-    steps:
-      - uses: actions/checkout@v4
-      - uses: oven-sh/setup-bun@v2
-      - uses: actions/setup-node@v4
-        with:
-          node-version: "24"
-          registry-url: "https://registry.npmjs.org"
-
-      - run: bun install
-      - run: bun run typecheck
-      - run: bun run build
-
-      - name: Publish to npm
-        run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-```
-
-## Requisitos
-
-### 1. Secret NPM_TOKEN
-
-Configurar no GitHub:
-1. Acesse: `Settings > Secrets and variables > Actions`
-2. Criar secret `NPM_TOKEN` com um Granular Access Token do npm
-
-Para criar o token no npm:
-1. Acesse: https://www.npmjs.com/settings/tokens
-2. Clique em "Generate New Token" > "Granular Access Token"
-3. Selecione permissao de publish para `@nimbuslab/cli`
-4. Copie o token e adicione como secret no GitHub
-
-### 2. Permissoes do Workflow
-
-O workflow precisa de:
-- `contents: read` - para checkout
-- `id-token: write` - para OIDC (opcional, mas recomendado)
-
-## Fluxo de Release
-
-1. Desenvolva na branch `develop`
-2. Atualize a versao no `package.json` e `src/index.ts`
-3. Commit e push: `git push origin develop`
-4. Merge para main:
-   ```bash
-   git checkout main
-   git merge develop
-   git push origin main
-   git checkout develop
-   ```
-5. GitHub Actions publica automaticamente
-
-## Versionamento
-
-Seguimos [Semantic Versioning](https://semver.org/):
-
-| Tipo | Quando usar | Exemplo |
-|------|-------------|---------|
-| Patch | Bug fixes | 0.6.3 → 0.6.4 |
-| Minor | Novas features | 0.6.3 → 0.7.0 |
-| Major | Breaking changes | 0.6.3 → 1.0.0 |
-
-**IMPORTANTE:** Atualizar a versao em DOIS lugares:
-- `package.json` → campo `version`
-- `src/index.ts` → constante `CURRENT_VERSION`
-
-## Troubleshooting
-
-### Erro: "You cannot publish over the previously published versions"
-
-A versao ja foi publicada. Bump a versao e tente novamente.
-
-### Erro: "E401 Unauthorized"
-
-O token NPM_TOKEN esta invalido ou expirado.
-1. Gere um novo token no npmjs.com
-2. Atualize a secret no GitHub
-
-### Erro: "E403 Forbidden"
-
-O token nao tem permissao de publish.
-1. Verifique se o token tem permissao para `@nimbuslab/cli`
-2. Verifique se voce e maintainer do pacote
-
-### CI passa mas versao nao aparece no npm
-
-Isso pode acontecer quando:
-1. **OIDC sem NODE_AUTH_TOKEN**: O OIDC pode falhar silenciosamente
-2. **Trusted Publisher mal configurado**: Verificar no npmjs.com
-
-**Solucao**: Sempre usar `NODE_AUTH_TOKEN` como fallback:
-```yaml
-- name: Publish to npm
-  run: npm publish --access public
-  env:
-    NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-```
-
-### Verificar se publicou
-
-```bash
-# Ver ultimas versoes
-curl -s "https://registry.npmjs.org/@nimbuslab/cli" | jq '.versions | keys | .[-5:]'
-
-# Ver versao latest
-curl -s "https://registry.npmjs.org/@nimbuslab/cli" | jq -r '.["dist-tags"].latest'
-```
-
-## OIDC Trusted Publishing (Opcional)
-
-O npm suporta autenticacao via OIDC, eliminando necessidade de tokens.
-
-### Configuracao no npmjs.com
-
-1. Acesse: https://www.npmjs.com/package/@nimbuslab/cli/access
-2. Em "Trusted Publisher", configure:
-   - Organization: `nimbuslab`
-   - Repository: `cli`
-   - Workflow: `publish.yml`
-
-### Limitacoes do OIDC
-
-- Nao funciona para publicar a versao inicial do pacote
-- Pode falhar silenciosamente em alguns casos
-- Requer `id-token: write` no workflow
-
-**Recomendacao**: Mesmo usando OIDC, manter `NODE_AUTH_TOKEN` como fallback.
-
-## Historico de Problemas
-
-### 2026-01-26: Publicacao falhando silenciosamente
-
-**Problema**: CI mostrava sucesso (`+ @nimbuslab/cli@0.6.x`) mas versao nao aparecia no npm. Tarball retornava 404 com mensagem "Access token expired or revoked".
-
-**Causa**: OIDC Trusted Publishing falhando silenciosamente. Os tarballs eram criados mas ficavam inacessiveis.
-
-**Solucao**: Adicionar `NODE_AUTH_TOKEN` como fallback junto com OIDC.
-
-```yaml
-- name: Publish to npm
-  run: npm publish --access public
-  env:
-    NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-```
-
-**Importante**: Mesmo com OIDC configurado, SEMPRE manter o `NODE_AUTH_TOKEN` como fallback. O token deve ser do tipo "Granular Access Token" (nao "Classic", que foi deprecado em dez/2025).
-
----
-
-*Ultima atualizacao: 2026-01-26*

package/docs/analyze.md

@@ -1,148 +0,0 @@
-# nimbus analyze
-
-Analisa a stack de um projeto existente e sugere melhorias baseadas na stack nimbuslab.
-
-## Uso
-
-```bash
-# Analisar diretorio atual
-nimbus analyze
-
-# Analisar diretorio especifico
-nimbus analyze ./meu-projeto
-nimbus analyze ~/www/nimbuslab/projeto
-
-# Output em JSON (para automacao)
-nimbus analyze --json
-```
-
-## O que Detecta
-
-### Framework
-- Next.js (com versao)
-- React (standalone)
-- Angular
-- Vue
-- Svelte
-
-### Styling
-- Tailwind CSS (com versao)
-- styled-components
-- Emotion
-- Sass/SCSS
-- Less
-- CSS puro
-
-### Package Manager
-- bun (recomendado)
-- pnpm
-- npm
-- yarn
-
-### Monorepo
-- Turborepo
-- Nx
-- Lerna
-- Workspaces nativo
-
-### Autenticacao
-- Better Auth (recomendado)
-- NextAuth / Auth.js
-- Clerk
-- Auth0
-- Supabase Auth
-
-### Banco de Dados
-- Drizzle ORM (recomendado)
-- Prisma
-- TypeORM
-- Mongoose
-- pg / mysql2 direto
-
-### Outros
-- TypeScript (tsconfig.json)
-- ESLint
-- Prettier
-
-## Recomendacoes Automaticas
-
-O comando gera recomendacoes baseadas na stack nimbuslab:
-
-| Detectado | Recomendacao |
-|-----------|--------------|
-| pnpm/npm/yarn | Migrar para bun |
-| Next.js < 16 | Atualizar para Next.js 16 |
-| React < 19 | Atualizar para React 19 |
-| Tailwind < 4 | Atualizar para Tailwind 4 |
-| Prisma | Considerar Drizzle ORM |
-| NextAuth | Considerar Better Auth |
-| Sem auth | Adicionar autenticacao |
-| Sem DB | Adicionar banco de dados |
-
-## Exemplo de Output
-
-```
-  Analisando projeto...
-
-  Projeto: meu-app v1.0.0
-
-  Stack Detectada:
-    Framework:       nextjs@15.0.2
-    Styling:         tailwind@3.4.1
-    Package Manager: pnpm
-    TypeScript:      sim
-    Monorepo:        turborepo
-    Auth:            next-auth
-    Database:        prisma
-
-  Recomendacoes:
-    1. Migrar pnpm -> bun (nimbus codemod bun)
-    2. Atualizar Next.js 15 -> 16 (nimbus upgrade next)
-    3. Atualizar React 18 -> 19 (nimbus upgrade react)
-    4. Atualizar Tailwind 3 -> 4 (nimbus upgrade tailwind)
-    5. Considerar migrar Prisma -> Drizzle (nimbus codemod drizzle)
-```
-
-## Output JSON
-
-Com `--json`, retorna estrutura para automacao:
-
-```json
-{
-  "name": "meu-app",
-  "version": "1.0.0",
-  "framework": "nextjs",
-  "frameworkVersion": "15.0.2",
-  "styling": ["tailwind@3.4.1"],
-  "packageManager": "pnpm",
-  "monorepo": "turborepo",
-  "auth": "next-auth",
-  "database": "prisma",
-  "typescript": true,
-  "recommendations": [
-    "Migrar pnpm -> bun",
-    "Atualizar Next.js 15 -> 16"
-  ]
-}
-```
-
-## Integracao com Outros Comandos
-
-```bash
-# Analisar e depois ver plano de upgrade
-nimbus analyze
-nimbus upgrade --plan
-
-# Pipeline completo
-nimbus analyze ./projeto && nimbus upgrade --plan
-```
-
-## Limitacoes
-
-- Analisa apenas `package.json` e arquivos de config
-- Nao analisa codigo-fonte
-- Requer projeto Node.js (package.json)
-
----
-
-[Voltar ao README](../README.md) | [create](./create.md) | [upgrade](./upgrade.md) | [migrate](./migrate.md)