@nimbuslab/cli 0.16.4 → 0.16.7

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)

package/docs/create.md

@@ -1,219 +0,0 @@
-# nimbus create
-
-Cria novo projeto com a stack nimbuslab.
-
----
-
-## Uso
-
-```bash
-nimbus create                           # Interativo
-nimbus create meu-projeto               # Com nome
-nimbus create meu-projeto --landing     # Landing page
-nimbus create meu-projeto --app         # Web app completo
-nimbus create meu-projeto --turborepo   # Monorepo
-nimbus create meu-pacote --package      # Pacote npm
-```
-
----
-
-## Templates
-
-### Landing Page (`--landing`)
-
-Stack minima para landing pages de alta conversao.
-
-| Tecnologia | Versao |
-|------------|--------|
-| Next.js | 16+ |
-| React | 19+ |
-| Tailwind CSS | 4+ |
-| shadcn/ui | latest |
-| TypeScript | 5.7+ |
-
-**Estrutura:**
-```
-app/
-├── page.tsx          # Home
-├── layout.tsx        # Layout root
-└── globals.css       # Estilos globais
-components/
-├── ui/               # shadcn/ui
-├── hero.tsx
-├── features.tsx
-├── cta.tsx
-└── footer.tsx
-```
-
-**Repo:** [create-next-landing](https://github.com/nimbuslab/create-next-landing)
-
----
-
-### Web App (`--app`)
-
-Landing + autenticacao + banco de dados.
-
-| Tecnologia | Versao |
-|------------|--------|
-| Next.js | 16+ |
-| React | 19+ |
-| Tailwind CSS | 4+ |
-| shadcn/ui | latest |
-| Better Auth | latest |
-| Drizzle ORM | latest |
-| Docker | Compose |
-
-**Estrutura:**
-```
-app/
-├── (auth)/           # Rotas autenticacao
-│   ├── login/
-│   └── register/
-├── (dashboard)/      # Rotas protegidas
-│   └── dashboard/
-├── api/              # API routes
-└── page.tsx          # Landing
-components/
-├── ui/               # shadcn/ui
-└── auth/             # Componentes auth
-lib/
-├── auth.ts           # Config Better Auth
-└── db.ts             # Config Drizzle
-```
-
-**Repo:** [create-next-app](https://github.com/nimbuslab/create-next-app)
-
----
-
-### Turborepo (`--turborepo`)
-
-Monorepo com apps e packages compartilhados.
-
-| Tecnologia | Uso |
-|------------|-----|
-| Turborepo | Build system |
-| pnpm | Workspaces |
-| TypeScript | Config compartilhada |
-| ESLint | Config compartilhada |
-
-**Estrutura:**
-```
-apps/
-├── web/              # App principal
-├── docs/             # Documentacao
-└── admin/            # Painel admin
-packages/
-├── ui/               # Design system
-├── config/           # Configs (TS, ESLint)
-└── utils/            # Utilitarios
-```
-
-**Repo:** [create-turborepo](https://github.com/nimbuslab/create-turborepo)
-
----
-
-### Pacote npm (`--package`)
-
-Pacote npm pronto para publicar.
-
-| Tecnologia | Uso |
-|------------|-----|
-| TypeScript | Linguagem |
-| tsup | Build (ESM + CJS) |
-| Bun | Runtime e testes |
-
-**Estrutura:**
-```
-meu-pacote/
-├── src/
-│   └── index.ts          # Entry point
-├── package.json          # Configurado para npm
-├── tsconfig.json
-├── tsup.config.ts        # Build config
-├── CHANGELOG.md
-└── .github/
-    └── workflows/
-        └── publish.yml   # CI/CD automatico
-```
-
-**Documentacao completa:** [docs/package.md](./package.md)
-
----
-
-## Opcoes
-
-| Flag | Descricao |
-|------|-----------|
-| `-y, --yes` | Aceitar todos os padroes |
-| `--no-git` | Nao inicializar repositorio Git |
-| `--no-install` | Nao instalar dependencias |
-| `--template <url>` | Usar template customizado |
-
----
-
-## Fluxo Interativo
-
-Quando executado sem flags, o CLI pergunta:
-
-1. **Nome do projeto** - Nome da pasta
-2. **Tipo de projeto** - landing, app ou turborepo
-3. **Tema** - dark, light ou system
-4. **Assistente IA** - Claude, Cursor, Gemini, Copilot, Windsurf
-5. **Criar repo GitHub?** - Se sim, busca orgs do usuario
-
----
-
-## Exemplos
-
-### Criar landing page rapida
-
-```bash
-nimbus create meu-site --landing -y
-cd meu-site
-bun dev
-```
-
-### Criar app com banco de dados
-
-```bash
-nimbus create meu-app --app
-cd meu-app
-bun setup    # Configura Docker + Drizzle
-bun dev
-```
-
-### Criar monorepo
-
-```bash
-nimbus create minha-empresa --turborepo
-cd minha-empresa
-turbo dev
-```
-
----
-
-## Pos-criacao
-
-### Landing Page
-
-```bash
-bun dev      # Iniciar servidor
-```
-
-### Web App
-
-```bash
-bun setup    # Configurar ambiente (Docker, banco)
-bun dev      # Iniciar servidor
-```
-
-### Turborepo
-
-```bash
-turbo dev    # Iniciar todos os apps
-turbo build  # Build de producao
-```
-
----
-
-[Voltar ao README](../README.md) | [analyze](./analyze.md) | [upgrade](./upgrade.md) | [migrate](./migrate.md)

package/docs/migrate.md

@@ -1,177 +0,0 @@
-# nimbus migrate
-
-Migra projetos de outras tecnologias para a stack nimbuslab usando Strangler Fig Pattern.
-
-> **Status:** Em desenvolvimento - Veja [MIGRATION-ROADMAP.md](../MIGRATION-ROADMAP.md)
-
-## Uso
-
-```bash
-# Ver plano de migracao
-nimbus migrate --from=angular --plan
-
-# Executar migracao (futuro)
-nimbus migrate --execute
-
-# Verificar resultado (futuro)
-nimbus migrate --verify
-```
-
-## Strangler Fig Pattern
-
-Padrao criado por Martin Fowler para migrar sistemas sem "big bang rewrite".
-
-### Como Funciona
-
-```
-1. Sistema Antigo (100% trafego)
-         ↓
-2. Criar facade/gateway
-         ↓
-3. Migrar primeira fatia (10% no novo)
-         ↓
-4. Aumentar gradualmente (50%, 80%, 100%)
-         ↓
-5. Aposentar sistema antigo
-```
-
-### Por que NAO fazer Big Bang?
-
-| Big Bang | Strangler Fig |
-|----------|---------------|
-| Alto risco | Risco controlado |
-| Tudo ou nada | Entregas continuas |
-| Meses sem valor | Valor a cada sprint |
-| Rollback impossivel | Rollback facil |
-
-## Tipos de Migracao
-
-### 1. Upgrade de Versao (Baixo Risco)
-
-```
-Next.js 15 -> 16
-React 18 -> 19
-Tailwind 3 -> 4
-```
-
-**Estrategia:** Codemods automaticos
-
-### 2. Mudanca de Stack (Medio Risco)
-
-```
-pnpm -> bun
-Prisma -> Drizzle
-NextAuth -> Better Auth
-```
-
-**Estrategia:** Dual write + feature flags
-
-### 3. Mudanca de Tecnologia (Alto Risco)
-
-```
-Angular -> Next.js
-PHP/Laravel -> Next.js
-Vue -> React
-```
-
-**Estrategia:** Strangler Fig completo
-
-### 4. Mudanca de Arquitetura (Muito Alto Risco)
-
-```
-Monolito -> Microservices
-Projeto solo -> Monorepo
-```
-
-**Estrategia:** Strangler Fig + event sourcing
-
-## Padroes de Migracao
-
-### Feature Flag Migration
-
-```typescript
-if (featureFlags.newCheckout) {
-  return <NewCheckout />   // Next.js
-} else {
-  return <LegacyCheckout /> // Angular
-}
-```
-
-### Dual Write
-
-```typescript
-async function saveUser(data) {
-  await legacyDB.save(data)  // Sistema antigo
-  await newDB.save(data)      // Sistema novo
-}
-```
-
-### API Gateway
-
-```
-Cliente -> Gateway -> /api/v1/* -> Sistema Antigo
-                  -> /api/v2/* -> Sistema Novo
-```
-
-## Checklist de Migracao
-
-### Pre-Migracao
-- [ ] Inventario de features
-- [ ] Mapa de dependencias
-- [ ] Cobertura de testes
-- [ ] Backup completo
-- [ ] Branch de migracao
-- [ ] CI/CD configurado
-- [ ] Feature flags prontos
-
-### Durante (por fatia)
-- [ ] Fatia isolada
-- [ ] Testes primeiro
-- [ ] Implementacao
-- [ ] Code review
-- [ ] Deploy staging
-- [ ] Rollout gradual
-- [ ] Monitoramento
-
-### Pos-Migracao
-- [ ] Codigo antigo removido
-- [ ] Docs atualizados
-- [ ] Retrospectiva
-
-## Anti-Patterns
-
-### 1. Big Bang Rewrite
-**Problema:** Meses sem entregar valor, risco total
-**Solucao:** Strangler Fig
-
-### 2. Migracao sem Testes
-**Problema:** Bugs em producao
-**Solucao:** Testes antes de migrar
-
-### 3. Dual Write Infinito
-**Problema:** Dois sistemas para sempre
-**Solucao:** Prazo para aposentar
-
-### 4. Ignorar Dados
-**Problema:** Inconsistencia
-**Solucao:** Event sourcing
-
-## Roadmap
-
-Veja [MIGRATION-ROADMAP.md](../MIGRATION-ROADMAP.md) para milestones detalhadas:
-
-- **Fase 1:** Fundacao (analyze, upgrade)
-- **Fase 2:** Codemods (Tailwind, React, Prisma)
-- **Fase 3:** Templates modulares
-- **Fase 4:** Migracao assistida
-- **Fase 5:** Automacao completa
-
-## Referencias
-
-- [Strangler Fig Pattern - Martin Fowler](https://martinfowler.com/bliki/StranglerFigApplication.html)
-- [Codemods API Refactoring](https://martinfowler.com/articles/codemods-api-refactoring.html)
-- [ThoughtWorks - Strangler Fig](https://www.thoughtworks.com/insights/articles/embracing-strangler-fig-pattern-legacy-modernization-part-one)
-
----
-
-[Voltar ao README](../README.md) | [create](./create.md) | [analyze](./analyze.md) | [upgrade](./upgrade.md)