@nimbuslab/cli 0.9.0 → 0.10.0

package/docs/create.md

@@ -0,0 +1,219 @@
+# 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

@@ -0,0 +1,177 @@
+# 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)

package/docs/package.md

@@ -0,0 +1,229 @@
+# 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)