@neetru/cli 2.7.4 → 2.8.0

package/CHANGELOG.md

@@ -1,208 +1,220 @@
-# Changelog @neetru/cli
-
-Convenção: [Keep a Changelog](https://keepachangelog.com/) + [SemVer](https://semver.org/).
-
-## [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.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`.