@neetru/cli 2.7.5 → 2.9.1

package/CHANGELOG.md

@@ -1,220 +1,316 @@
-# Changelog @neetru/cli
-
-Convenção: [Keep a Changelog](https://keepachangelog.com/) + [SemVer](https://semver.org/).
-
-## [2.7.5] — 2026-05-20 (fix do crash no upgrade)
-
-### Corrigido
-
-- `neetru upgrade` não crasha mais ao terminar. O comando chamava
-  `process.exit(0)` logo após o `fetch` ao npm — no Windows isso
-  derrubava o libuv com `Assertion failed: !(handle->flags &
-  UV_HANDLE_CLOSING)` (`async.c`), porque o socket do undici (fetch
-  nativo) ainda estava em teardown. Agora o comando só retorna; o event
-  loop drena sozinho (o undici dá unref nos sockets idle) e o processo
-  encerra limpo na hora.
-
-## [2.7.4] — 2026-05-20 (submenus redesenhados)
-
-### Adicionado
-
-- Submenu **"Começar um projeto"** no menu principal — reúne o scaffold
-  local (`neetru init`), a criação completa (`neetru new`) e uma tela de
-  info sobre o `@neetru/sdk` (o que é, como instalar e consumir).
-- Os 10 submenus ganharam o **mesmo visual do menu principal**: moldura
-  azul-marinho, marcador `> <` no item ativo e navegação por setas — em
-  coluna única, alinhada à esquerda.
-
-### Corrigido
-
-- Submenu não engole mais a primeira seta. O menu principal entregava o
-  stdin pausado / fora de raw mode pro submenu, e o inquirer perdia a
-  1ª tecla — só respondia depois de um toque inicial. Agora o stdin fica
-  "quente" na entrega; a seta funciona de cara.
-
-## [2.7.3] — 2026-05-20 (polish do cabeçalho)
-
-### Mudado
-
-- Cabeçalho do `neetru` interativo: logo renderizado **ao lado** do texto
-  (antes era acima), com a sessão e a versão alinhadas à direita do logo.
-- Paleta de contorno do menu e do logo ajustada para um azul mais suave.
-
-## [2.7.2] — 2026-05-20 (aviso de versão + menu em 2 colunas)
-
-### Adicionado
-
-- O cabeçalho do `neetru` interativo mostra a **versão instalada** (`v2.7.2`)
-  ao lado do usuário logado. Quando há uma versão mais nova publicada no
-  npm, aparece uma linha **amarela** avisando pra rodar `neetru upgrade`.
-  A checagem tem timeout curto e é à prova de falha — offline não trava o
-  CLI.
-- Menu principal redesenhado em **duas colunas**, com navegação por setas
-  (↑/↓/←/→) e contorno azul-marinho; o item ativo é marcado com `> <`.
-
-## [2.7.1] — 2026-05-20 (UI do CLI interativo)
-
-### Adicionado
-
-- Logo Neetru em ANSI truecolor no cabeçalho do `neetru` interativo.
-- Cabeçalho mostra o usuário logado (email), lido localmente do
-  `auth.json` — sem chamada de rede.
-- Menu principal com o nome do recurso + uma descrição curta abaixo,
-  quando útil.
-
-### Corrigido
-
-- O CLI interativo não encerra mais sozinho: comandos que chamavam
-  `process.exit()` em erro (ex.: "Nenhum server encontrado") matavam o
-  menu inteiro. Agora o erro é capturado e o CLI volta ao menu — só
-  "Sair" (ou Ctrl+C) encerra.
-
-## [2.7.0] — 2026-05-20 (Fluxo de Ambientes Fase 3 — destino cloud-run)
-
-### Adicionado
-
-- `neetru deploy --target=cloud-run` — caminho de deploy pro destino Cloud Run
-  dedicado. Aceita `--image <uri>` (imagem de container já buildada e pushada)
-  ou faz `docker build` + `docker push` automático via `--registry <host>`
-  (Artifact Registry). O destino `cloud-run` agora aparece no menu interativo.
-
-### Mudado
-
-- `neetru promote` — vocabulário de estágios migrado para `dev | staging | prod`
-  (antes `dev/workspace/beta/prod`). Gates: 24h em `dev→staging`,
-  168h + canary em `staging→prod`.
-- `neetru deploy --target` — sem valor default; omitir abre o menu interativo
-  (workspace / cloud-run / vm). Modo não-interativo continua assumindo `vm`.
-
-## [2.0.0] — 2026-05-06 (Sprint 12 — CLI estabilizada)
-
-### Adicionado
-
-- `neetru doctor` — diagnóstico completo do ambiente: token CLI, Core acessível,
-  schema do `neetru.config.json`, valor de `NEETRU_ENV`, e versão do CLI
-  comparada com a `latest` no npm. Saída em tabela colorida (default) ou
-  JSON (`--json`). Diferença pra `validate`: doctor inclui environment +
-  version mismatch (warning, não fail).
-- `neetru upgrade` — verifica `dist-tags.latest` em
-  `https://registry.npmjs.org/@neetru/cli` e exibe instrução de upgrade
-  (`npm install -g @neetru/cli@latest`). Sem auto-install — não quebra
-  pipelines pinados.
-- `neetru autocomplete <bash|zsh|pwsh>` — gera script de shell completion
-  pra os 22 subcomandos top-level. Usuário cola na config do shell:
-  `neetru autocomplete bash >> ~/.bashrc`.
-- `neetru config set telemetry.enabled <true|false>` — opt-in explícito de
-  telemetria. Default desligado. Quando ligado, CLI envia eventos
-  anonimizados pra `POST /sdk/v1/telemetry/log` (placeholder na v2.0).
-  Nunca envia tokens, paths absolutos ou conteúdo de arquivos.
-
-### Bumped
-
-- `1.4.0 → 2.0.0` (major bump por convenção de estabilidade — sem breaking
-  changes funcionais).
-
-### Não publicado no npm ainda
-
-Bump local. Publish manual pra npm fica deferido — owner aprovará. Build
-local (`npm run build` em `cli/`) gera o `dist/` pronto pra publicação.
-
-## [1.3.0] — 2026-05-06
-
-### Adicionado
-
-- `neetru add <feature>` — copia template em `cli/templates/{feature}/*` para
-  `src/lib/neetru/{feature}/*` no projeto atual. Features: `auth`, `billing`,
-  `usage`, `users`, `support`. Suporta `--force` pra sobrescrever.
-- `neetru mocks reset` — reseta `.neetru/dev-fixtures.json` para `{}` (útil
-  com `NEETRU_ENV=dev`).
-- `neetru env switch <dev|workspace|production>` — atualiza/insere
-  `NEETRU_ENV=<value>` em `.env.local` preservando as outras chaves.
-- `neetru logs` ganhou flags:
-  - `--product <productId>` — filtra logs por produto.
-  - `--channel <channel>` — filtra por channel (stdout/stderr/app/...).
-  - `--correlation-id <uuid>` — filtra por correlation ID.
-
-### Templates novos (`cli/templates/`)
-
-- `auth/sign-in.tsx`, `auth/callback.ts`
-- `billing/page.tsx`, `billing/checkout.ts`
-- `usage/track.ts`
-- `users/profile.tsx`
-- `support/ticket-form.tsx`
-
-### Não publicado no npm ainda
-
-Bump local `1.2.0 → 1.3.0`. Publish pra npm fica deferido — owner aprovará
-manualmente quando quiser. Build local (`npm run build` em `cli/`) já compila.
-
-## [1.2.0] — 2026-05-06
-
-**Consolidação das duas linhas paralelas.** Esta versão unifica os comandos das duas linhas de CLI que estavam coexistindo:
-
-- **`@neetru/cli@1.0.x` (publicada no npm)**: linha *workspace-centric* com `init`, `add`, `validate`, `generate-types`, `whoami`, `login`, `status`, `logs`, `deploy`, `open`. APIs: `/api/v1/cli/workspace/*`.
-- **`@neetru/cli@0.1.0` (monorepo, não publicada)**: linha *server-centric* com `ai`, `init`, `config`, `login`, `logout`, `whoami`, `build`, `deploy`, `publish`. APIs: `/api/v1/cli/{catalog,deploy,servers}`.
-
-As duas falam **APIs distintas e complementares** do mesmo Neetru Core, refletindo a topologia real do produto:
-
-```
-Workspace (prototipação) ──build/promote──► Server VM ou Cloud Run (produção)
-```
-
-A `1.2.0` traz ambos os conjuntos de comandos numa única CLI. O monorepo passa a ser a fonte canônica.
-
-### Adicionado em relação a `1.0.1`
-
-Comandos da linha *server-centric* (deploy via VM agent ou Cloud Run):
-
-- `neetru ai` — REPL multi-model (Claude/OpenAI/Gemini) com contexto Neetru-aware
-- `neetru build` — empacota produto local em tarball + manifest com sha256, detecção automática de stack (node/docker/php-apache/static)
-- `neetru deploy` — pipeline E2E interativo (escolha de produto/server/domain/port + polling status até estado terminal). Suporta `--non-interactive` para CI.
-- `neetru publish` — registra produto no catálogo público (`public_products`), com `--draft` e `--unpublish`
-- `neetru config {set|get|path}` — gerenciamento de chaves de API e config local
-- `neetru logout` — limpa credenciais
-- `neetru login --token nrt_<keyId>_<secret>` — modo CI/legacy paralelo ao Device Code OAuth
-- `neetru login --json` — saída machine-readable para scripts
-
-### Mantido de `1.0.1` (re-implementado em TypeScript com convenções do monorepo)
-
-- `neetru status --client-id <id>` — status de workspace (build/deploy último, domínio, tier, expira em N dias)
-- `neetru logs --client-id <id>` — visualiza logs do workspace; suporta `-f` follow + `-n N` lines + `--since 30m` + `--level error`
-- `neetru validate` — health-check da config local + ping `/api/health` + whoami
-- `neetru open [target]` — abre dashboard, builds, logs, workspaces, products, servers, incidents no browser
-- `neetru init <name>` — agora gera projeto Next.js 15 OU Node API (Fastify) com schema canônico v2
-
-### Backlog 1.3.x
-
-Comandos que ainda dependem de design/templates novos:
-
-- `neetru add <feature>` — scaffolds OAuth/billing/usage/users
-- `neetru generate-types` — codegen TypeScript de planos/features/entitlements
-
-### Alterado
-
-- Package agora é ESM nativo (`"type": "module"`). Imports usam `.js` extension.
-- `neetru login` agora usa Device Code OAuth (RFC 8628) por default; `--token` permanece para CI.
-
-### Migração de `1.0.x`
-
-Não há caminho 100% automático porque a config local muda:
-
-- `1.0.x` lia `neetru.json` workspace-local com `{clientId, coreUrl}` + var de ambiente `NEETRU_CLIENT_SECRET`
-- `1.2.0` lê `~/.config/neetru-cli/auth.json` (Bearer token salvo por `neetru login`) + `neetru.config.json` por projeto com `{slug, runtime, publish}`
-
-Recomendação:
-
-1. `npm uninstall -g @neetru/cli && npm install -g @neetru/cli@1.2.0`
-2. `neetru login` (Device Code) — gera credencial Bearer no novo formato
-3. Para comandos workspace (`status`, `logs`, `open`), passe `--client-id <oauthClientId>` explicitamente — o `clientId` continua sendo o `oauthClientId` do seu workspace, achável em UI Core `/workspaces/{id}`
-
-## [1.0.1] — anterior
-
-Linha workspace publicada no npm. Comandos: `init`, `add`, `validate`, `generate-types`, `whoami`, `login`, `status`, `logs`, `deploy`, `open`. APIs: `/api/v1/cli/workspace/*`.
-
-## [1.0.0] — anterior
-
-Primeira versão pública.
-
-## [0.1.0] — interno (não publicado)
-
-Snapshot interno do monorepo durante desenvolvimento da Sprint 1+. Substituído por `1.2.0`.
+# Changelog @neetru/cli
+
+Convenção: [Keep a Changelog](https://keepachangelog.com/) + [SemVer](https://semver.org/).
+
+## [2.9.1] — 2026-05-25 (security: 5 HIGH fixes)
+
+### Corrigido (segurança)
+
+- **HIGH-1 — `db apply --json` selecionava o primeiro banco silenciosamente com múltiplos bancos.**
+  Em modo não-interativo (`--json` ou `--yes` sem TTY), se `.neetru/db.json` tiver N > 1 bancos
+  e `--db` não for passado, o CLI agora emite erro estruturado em vez de aplicar no primeiro banco.
+  Saída JSON: `{ ok: false, error: "db_required", message: "...", available: [...] }`.
+  Em CI isso evitava migração silenciosa no banco errado.
+
+- **HIGH-2 — Abertura de URL no Windows usava `cmd /c start` sem validação de protocolo.**
+  URLs derivadas de config podiam conter caracteres de injeção de shell (`& malicious.exe`).
+  Nova função `safeOpenUrl` valida `^https?://` antes de qualquer chamada de sistema e usa
+  `rundll32 url.dll,FileProtocolHandler` (sem shell) no Windows. Aplica em `open.ts` e
+  `workspaces.ts` (que agora delega para `safeOpenUrl`).
+
+- **HIGH-3 — `db init` gravava stub local em `.neetru/db.json` antes de registrar no Core.**
+  Falha de rede/400 do Core deixava entrada órfã e re-rodar `db init` adicionava banco duplicado.
+  Agora o registro no Core acontece primeiro; `.neetru/db.json` só é escrito após sucesso.
+
+- **HIGH-4 — `marketplace sdk add <template>` aceitava path traversal.**
+  `path.join(templatesDir, templateName)` aceitava `../../etc/passwd` como nome.
+  Adicionada whitelist `ALLOWED_SDK_TEMPLATES` e verificação `startsWith(resolve(templatesDir) + sep)`
+  como defesa em profundidade.
+
+- **HIGH-5 — `docs publish` usava path absoluto Windows como slug.**
+  Path como `C:/Users/dev/projeto/docs/intro.md` virava slug `C:/Users/dev/projeto/docs/intro`,
+  expondo estrutura de filesystem. `deriveSlugFromPath` agora converte para relativo via
+  `path.relative(cwd, file)` e rejeita slugs com `:`, `..` ou `/` inicial.
+
+## [2.8.2] — 2026-05-25 (fix UX slug conflict + docs open)
+
+### Corrigido
+
+- **Bug #31 — `neetru new` não falha seco em conflito de slug.**
+  Quando o Core retorna 400 com "Já existe um produto com o slug X", o CLI
+  agora exibe o produto existente (nome, ID, status) e oferece um prompt
+  interativo com três opções:
+  1. Vincular este projeto local ao produto existente (escreve `.neetru/config.json`
+     apontando para o `productId`).
+  2. Criar com slug diferente — lista sugestões (`gestovendas-v2`, `-2`, etc.)
+     ou permite digitar um slug livre.
+  3. Cancelar.
+  Removida a mensagem "Tente manualmente: neetru products create --slug <mesmo-slug>"
+  que sugeria repetir exatamente o comando que vai falhar de novo.
+  O fallback genérico cobre qualquer 400 cujo `message` contenha "Já existe",
+  "slug", "already exists" ou "duplicate".
+
+- **Bug #26 — `neetru docs` não abria documentação ao vivo.**
+  O comando `neetru docs` era exclusivamente um registry CRUD (publish/list/get/delete)
+  e não tinha forma de acessar a documentação pública. Adicionado:
+  - `neetru docs open [topic]` — abre `https://core.neetru.com/docs` (ou seção
+    específica) no browser padrão. Tópicos: `sdk`, `cli`, `db`, `webhooks`, `auth`,
+    `billing`, `observability`, `infra`, `dns`, `deploy`, `architecture`.
+  - `neetru docs open` sem argumento — abre o índice geral.
+  - Argumentos desconhecidos abrem busca: `core.neetru.com/docs?q=<query>`.
+  - No menu interativo (`neetru ui`), "Docs live" agora exibe "Abrir documentação
+    no navegador" como primeira opção antes das opções de registry.
+
+### Notas de uso
+
+```
+neetru docs open          # abre core.neetru.com/docs
+neetru docs open sdk      # vai direto pra referência do SDK
+neetru docs open webhooks # manual de runtime/webhooks
+```
+
+## [2.8.1] — 2026-05-25 (marketplace)
+
+### Adicionado
+
+- **`neetru marketplace`** — central de artefatos do ecossistema Neetru.
+  - `neetru marketplace skills install` — clona `Neetru/neetru-libs` em
+    `~/.neetru/marketplace-cache/` e instala skills em `~/.claude/skills/`.
+    Linux/macOS: symlink (atualizações automáticas via git pull).
+    Windows: cópia recursiva (sem exigir Developer Mode).
+  - `neetru marketplace skills update` — git pull no cache + re-copia skills
+    instaladas como cópia (symlinks já são atualizados pelo pull).
+  - `neetru marketplace skills list` — tabela com nome, versão, status e
+    descrição de cada skill disponível no cache local.
+  - `neetru marketplace skills uninstall` — remove skills de `~/.claude/skills/`
+    com confirmação interativa (bypass via `--yes`).
+  - `neetru marketplace sdk init` — adiciona `@neetru/sdk@^2.1.0` ao
+    `package.json` do projeto atual e cria `src/neetru.ts` com boilerplate
+    de `createNeetruClient`. Idempotente — não sobrescreve arquivo existente.
+  - `neetru marketplace sdk templates` — lista templates disponíveis em
+    `templates/` da instalação do CLI.
+  - `neetru marketplace sdk add <template>` — copia template de feature
+    (auth/billing/usage/support/users) pra `src/` do projeto atual.
+  - `neetru marketplace browse` — abre `https://github.com/Neetru/neetru-libs`
+    no browser (start/open/xdg-open por plataforma).
+- **Menu interativo** — item **"Marketplace"** adicionado ao menu principal
+  (entre Suporte e Docs live) com sub-menu completo: skills (instalar /
+  atualizar / listar / remover) + SDK (init / add template / listar / docs)
+  + abrir no GitHub.
+
+## [2.7.5] — 2026-05-20 (fix do crash no upgrade)
+
+### Corrigido
+
+- `neetru upgrade` não crasha mais ao terminar. O comando chamava
+  `process.exit(0)` logo após o `fetch` ao npm — no Windows isso
+  derrubava o libuv com `Assertion failed: !(handle->flags &
+  UV_HANDLE_CLOSING)` (`async.c`), porque o socket do undici (fetch
+  nativo) ainda estava em teardown. Agora o comando só retorna; o event
+  loop drena sozinho (o undici dá unref nos sockets idle) e o processo
+  encerra limpo na hora.
+
+## [2.7.4] — 2026-05-20 (submenus redesenhados)
+
+### Adicionado
+
+- Submenu **"Começar um projeto"** no menu principal — reúne o scaffold
+  local (`neetru init`), a criação completa (`neetru new`) e uma tela de
+  info sobre o `@neetru/sdk` (o que é, como instalar e consumir).
+- Os 10 submenus ganharam o **mesmo visual do menu principal**: moldura
+  azul-marinho, marcador `> <` no item ativo e navegação por setas — em
+  coluna única, alinhada à esquerda.
+
+### Corrigido
+
+- Submenu não engole mais a primeira seta. O menu principal entregava o
+  stdin pausado / fora de raw mode pro submenu, e o inquirer perdia a
+  1ª tecla — só respondia depois de um toque inicial. Agora o stdin fica
+  "quente" na entrega; a seta funciona de cara.
+
+## [2.7.3] — 2026-05-20 (polish do cabeçalho)
+
+### Mudado
+
+- Cabeçalho do `neetru` interativo: logo renderizado **ao lado** do texto
+  (antes era acima), com a sessão e a versão alinhadas à direita do logo.
+- Paleta de contorno do menu e do logo ajustada para um azul mais suave.
+
+## [2.7.2] — 2026-05-20 (aviso de versão + menu em 2 colunas)
+
+### Adicionado
+
+- O cabeçalho do `neetru` interativo mostra a **versão instalada** (`v2.7.2`)
+  ao lado do usuário logado. Quando há uma versão mais nova publicada no
+  npm, aparece uma linha **amarela** avisando pra rodar `neetru upgrade`.
+  A checagem tem timeout curto e é à prova de falha — offline não trava o
+  CLI.
+- Menu principal redesenhado em **duas colunas**, com navegação por setas
+  (↑/↓/←/→) e contorno azul-marinho; o item ativo é marcado com `> <`.
+
+## [2.7.1] — 2026-05-20 (UI do CLI interativo)
+
+### Adicionado
+
+- Logo Neetru em ANSI truecolor no cabeçalho do `neetru` interativo.
+- Cabeçalho mostra o usuário logado (email), lido localmente do
+  `auth.json` — sem chamada de rede.
+- Menu principal com o nome do recurso + uma descrição curta abaixo,
+  quando útil.
+
+### Corrigido
+
+- O CLI interativo não encerra mais sozinho: comandos que chamavam
+  `process.exit()` em erro (ex.: "Nenhum server encontrado") matavam o
+  menu inteiro. Agora o erro é capturado e o CLI volta ao menu — só
+  "Sair" (ou Ctrl+C) encerra.
+
+## [2.7.0] — 2026-05-20 (Fluxo de Ambientes Fase 3 — destino cloud-run)
+
+### Adicionado
+
+- `neetru deploy --target=cloud-run` — caminho de deploy pro destino Cloud Run
+  dedicado. Aceita `--image <uri>` (imagem de container já buildada e pushada)
+  ou faz `docker build` + `docker push` automático via `--registry <host>`
+  (Artifact Registry). O destino `cloud-run` agora aparece no menu interativo.
+
+### Mudado
+
+- `neetru promote` — vocabulário de estágios migrado para `dev | staging | prod`
+  (antes `dev/workspace/beta/prod`). Gates: 24h em `dev→staging`,
+  168h + canary em `staging→prod`.
+- `neetru deploy --target` — sem valor default; omitir abre o menu interativo
+  (workspace / cloud-run / vm). Modo não-interativo continua assumindo `vm`.
+
+## [2.0.0] — 2026-05-06 (Sprint 12 — CLI estabilizada)
+
+### Adicionado
+
+- `neetru doctor` — diagnóstico completo do ambiente: token CLI, Core acessível,
+  schema do `neetru.config.json`, valor de `NEETRU_ENV`, e versão do CLI
+  comparada com a `latest` no npm. Saída em tabela colorida (default) ou
+  JSON (`--json`). Diferença pra `validate`: doctor inclui environment +
+  version mismatch (warning, não fail).
+- `neetru upgrade` — verifica `dist-tags.latest` em
+  `https://registry.npmjs.org/@neetru/cli` e exibe instrução de upgrade
+  (`npm install -g @neetru/cli@latest`). Sem auto-install — não quebra
+  pipelines pinados.
+- `neetru autocomplete <bash|zsh|pwsh>` — gera script de shell completion
+  pra os 22 subcomandos top-level. Usuário cola na config do shell:
+  `neetru autocomplete bash >> ~/.bashrc`.
+- `neetru config set telemetry.enabled <true|false>` — opt-in explícito de
+  telemetria. Default desligado. Quando ligado, CLI envia eventos
+  anonimizados pra `POST /sdk/v1/telemetry/log` (placeholder na v2.0).
+  Nunca envia tokens, paths absolutos ou conteúdo de arquivos.
+
+### Bumped
+
+- `1.4.0 → 2.0.0` (major bump por convenção de estabilidade — sem breaking
+  changes funcionais).
+
+### Não publicado no npm ainda
+
+Bump local. Publish manual pra npm fica deferido — owner aprovará. Build
+local (`npm run build` em `cli/`) gera o `dist/` pronto pra publicação.
+
+## [1.3.0] — 2026-05-06
+
+### Adicionado
+
+- `neetru add <feature>` — copia template em `cli/templates/{feature}/*` para
+  `src/lib/neetru/{feature}/*` no projeto atual. Features: `auth`, `billing`,
+  `usage`, `users`, `support`. Suporta `--force` pra sobrescrever.
+- `neetru mocks reset` — reseta `.neetru/dev-fixtures.json` para `{}` (útil
+  com `NEETRU_ENV=dev`).
+- `neetru env switch <dev|workspace|production>` — atualiza/insere
+  `NEETRU_ENV=<value>` em `.env.local` preservando as outras chaves.
+- `neetru logs` ganhou flags:
+  - `--product <productId>` — filtra logs por produto.
+  - `--channel <channel>` — filtra por channel (stdout/stderr/app/...).
+  - `--correlation-id <uuid>` — filtra por correlation ID.
+
+### Templates novos (`cli/templates/`)
+
+- `auth/sign-in.tsx`, `auth/callback.ts`
+- `billing/page.tsx`, `billing/checkout.ts`
+- `usage/track.ts`
+- `users/profile.tsx`
+- `support/ticket-form.tsx`
+
+### Não publicado no npm ainda
+
+Bump local `1.2.0 → 1.3.0`. Publish pra npm fica deferido — owner aprovará
+manualmente quando quiser. Build local (`npm run build` em `cli/`) já compila.
+
+## [1.2.0] — 2026-05-06
+
+**Consolidação das duas linhas paralelas.** Esta versão unifica os comandos das duas linhas de CLI que estavam coexistindo:
+
+- **`@neetru/cli@1.0.x` (publicada no npm)**: linha *workspace-centric* com `init`, `add`, `validate`, `generate-types`, `whoami`, `login`, `status`, `logs`, `deploy`, `open`. APIs: `/api/v1/cli/workspace/*`.
+- **`@neetru/cli@0.1.0` (monorepo, não publicada)**: linha *server-centric* com `ai`, `init`, `config`, `login`, `logout`, `whoami`, `build`, `deploy`, `publish`. APIs: `/api/v1/cli/{catalog,deploy,servers}`.
+
+As duas falam **APIs distintas e complementares** do mesmo Neetru Core, refletindo a topologia real do produto:
+
+```
+Workspace (prototipação) ──build/promote──► Server VM ou Cloud Run (produção)
+```
+
+A `1.2.0` traz ambos os conjuntos de comandos numa única CLI. O monorepo passa a ser a fonte canônica.
+
+### Adicionado em relação a `1.0.1`
+
+Comandos da linha *server-centric* (deploy via VM agent ou Cloud Run):
+
+- `neetru ai` — REPL multi-model (Claude/OpenAI/Gemini) com contexto Neetru-aware
+- `neetru build` — empacota produto local em tarball + manifest com sha256, detecção automática de stack (node/docker/php-apache/static)
+- `neetru deploy` — pipeline E2E interativo (escolha de produto/server/domain/port + polling status até estado terminal). Suporta `--non-interactive` para CI.
+- `neetru publish` — registra produto no catálogo público (`public_products`), com `--draft` e `--unpublish`
+- `neetru config {set|get|path}` — gerenciamento de chaves de API e config local
+- `neetru logout` — limpa credenciais
+- `neetru login --token nrt_<keyId>_<secret>` — modo CI/legacy paralelo ao Device Code OAuth
+- `neetru login --json` — saída machine-readable para scripts
+
+### Mantido de `1.0.1` (re-implementado em TypeScript com convenções do monorepo)
+
+- `neetru status --client-id <id>` — status de workspace (build/deploy último, domínio, tier, expira em N dias)
+- `neetru logs --client-id <id>` — visualiza logs do workspace; suporta `-f` follow + `-n N` lines + `--since 30m` + `--level error`
+- `neetru validate` — health-check da config local + ping `/api/health` + whoami
+- `neetru open [target]` — abre dashboard, builds, logs, workspaces, products, servers, incidents no browser
+- `neetru init <name>` — agora gera projeto Next.js 15 OU Node API (Fastify) com schema canônico v2
+
+### Backlog 1.3.x
+
+Comandos que ainda dependem de design/templates novos:
+
+- `neetru add <feature>` — scaffolds OAuth/billing/usage/users
+- `neetru generate-types` — codegen TypeScript de planos/features/entitlements
+
+### Alterado
+
+- Package agora é ESM nativo (`"type": "module"`). Imports usam `.js` extension.
+- `neetru login` agora usa Device Code OAuth (RFC 8628) por default; `--token` permanece para CI.
+
+### Migração de `1.0.x`
+
+Não há caminho 100% automático porque a config local muda:
+
+- `1.0.x` lia `neetru.json` workspace-local com `{clientId, coreUrl}` + var de ambiente `NEETRU_CLIENT_SECRET`
+- `1.2.0` lê `~/.config/neetru-cli/auth.json` (Bearer token salvo por `neetru login`) + `neetru.config.json` por projeto com `{slug, runtime, publish}`
+
+Recomendação:
+
+1. `npm uninstall -g @neetru/cli && npm install -g @neetru/cli@1.2.0`
+2. `neetru login` (Device Code) — gera credencial Bearer no novo formato
+3. Para comandos workspace (`status`, `logs`, `open`), passe `--client-id <oauthClientId>` explicitamente — o `clientId` continua sendo o `oauthClientId` do seu workspace, achável em UI Core `/workspaces/{id}`
+
+## [1.0.1] — anterior
+
+Linha workspace publicada no npm. Comandos: `init`, `add`, `validate`, `generate-types`, `whoami`, `login`, `status`, `logs`, `deploy`, `open`. APIs: `/api/v1/cli/workspace/*`.
+
+## [1.0.0] — anterior
+
+Primeira versão pública.
+
+## [0.1.0] — interno (não publicado)
+
+Snapshot interno do monorepo durante desenvolvimento da Sprint 1+. Substituído por `1.2.0`.