@neetru/cli 2.4.0 → 2.6.0

package/README.md

@@ -1,192 +1,137 @@
 # @neetru/cli
 
-> Developer Kit oficial da Neetru — scaffold, AI assistant, publish, build e deploy de produtos SaaS via Neetru Core.
+> Developer Kit oficial da Neetru — scaffolding, IA Neetru-aware, deploy de produtos SaaS, gestão de workspaces, bancos isolados por produto, e mais 40+ comandos pra operar todo o ecossistema Neetru via terminal.
 
-[![npm version](https://img.shields.io/npm/v/@neetru/cli.svg)](https://www.npmjs.com/package/@neetru/cli)
+<p>
+  <img alt="npm" src="https://img.shields.io/npm/v/@neetru/cli?logo=npm">
+  <img alt="downloads" src="https://img.shields.io/npm/dm/@neetru/cli?logo=npm">
+  <img alt="Node" src="https://img.shields.io/badge/node-%3E%3D22-339933?logo=node.js&logoColor=white">
+  <img alt="license" src="https://img.shields.io/badge/license-MIT-22c55e">
+</p>
 
 ## Instalação
 
 ```bash
 npm install -g @neetru/cli
-neetru --version
 ```
 
-Requer Node 20 ou superior.
+Bootstrap completo da máquina dev (Node, gcloud, Docker, Firebase CLI, deps NPM, GCP ADC):
 
-> **Migrando de `1.0.x`?** A linha `2.x` é uma **reescrita completa** com arquitetura nova (VM-based agents). Veja [CHANGELOG.md](./CHANGELOG.md) — não há caminho automático.
-
-> **Novo em `2.2.0`?** Veja [v2.2.0 — Fluxo end-to-end](#v220--fluxo-end-to-end) abaixo: 5 comandos novos que fecham o bootstrap completo no terminal.
-
-## Topologia de produto Neetru
-
-```
-┌─────────────┐    build/promote    ┌──────────────┐
-│  Workspace  │  ─────────────────► │ Server (VM)  │
-│ prototipação│                     │  ou Cloud Run│
-│  no Core    │                     │  produção    │
-└─────────────┘                     └──────────────┘
-   neetru                              neetru
-   status / logs / open                build / deploy
+```bash
+neetru bootstrap
 ```
 
-- **Workspace** = ambiente lógico de prototipação no Core (clientId/oauthClientId, domínio temporário, tier de recurso, builds e deployments lógicos). Ideal pra iterar rápido.
-- **Server / Cloud Run** = ambiente físico de produção. Quando o produto matura no workspace, você empacota (`neetru build`) e promove (`neetru deploy`) pra VM gerenciada pelo agent ou Cloud Run.
-
-## Começo rápido
+Login no Core via OAuth Device Code Flow:
 
 ```bash
-# 1. Login (abre browser para Device Code OAuth)
 neetru login
-
-# 2. Valida config + conexão
-neetru validate
-
-# 3. Cria um projeto novo
-neetru init meu-saas --type nextjs
-cd meu-saas
-
-# 4. Vê status do workspace (se você já tem um criado em UI Core)
-neetru status --client-id <oauthClientId>
-
-# 5. Acompanha logs em tempo real
-neetru logs --client-id <oauthClientId> -f
-
-# 6. Quando estiver pronto pra produção: publica no catálogo + builda + deploya
-neetru publish --draft
-neetru build
-neetru deploy --target=vm
 ```
 
-## v2.2.0 — Fluxo end-to-end
-
-A linha `2.2.0` (2026-05-16) fecha o ciclo completo de bootstrap de um SaaS Neetru a partir do terminal — antes, criar produto + workspace exigia ida à UI staff.
-
-| Comando | O que faz | Doc |
-|---|---|---|
-| `neetru products create` | Registra um produto novo em `products/{id}` (registry interno do ProductOS). | [`products.md`](../docs/sistema/manuais/devex/cli-reference/products.md) |
-| `neetru workspaces list` | Lista workspaces com filtros (`--product`, `--customer`, `--env`, `--status`). | [`workspaces.md`](../docs/sistema/manuais/devex/cli-reference/workspaces.md) |
-| `neetru workspaces get <id>` | Detalhes completos de um workspace (sem expor `oauthClientSecret`). | [`workspaces.md`](../docs/sistema/manuais/devex/cli-reference/workspaces.md) |
-| `neetru workspaces open <id>` | Abre o painel `/workspaces/<id>` no browser (best-effort cross-platform). | [`workspaces.md`](../docs/sistema/manuais/devex/cli-reference/workspaces.md) |
-| `neetru new <name>` | **Macro end-to-end:** produto + workspace + scaffold local + abre browser. Pra prototipagem rápida e onboarding. | [`new-macro.md`](../docs/sistema/manuais/devex/cli-reference/new-macro.md) |
+Validar estado:
 
 ```bash
-# Macro: do zero ao dev local em <60s
-neetru new pedidos-pro
-cd pedidos-pro && npm install && npm run dev
+neetru doctor
 ```
 
-Ver os 3 docs canônicos acima pra flags, exit codes, schema e tratamento de erro detalhado.
-
-## Comandos
-
-### Auth
-
-| Comando | O que faz |
-|---|---|
-| `neetru login` | Device Code OAuth (RFC 8628). Abre browser. `--token nrt_…` para CI. |
-| `neetru logout` | Apaga credenciais locais. |
-| `neetru whoami` | Mostra identidade da chave atual. `--json` para scripts. |
-
-### Produtos (registry interno — ProductOS)
-
-| Comando | O que faz |
-|---|---|
-| `neetru products create` | Cria produto em `products/{id}` (interativo ou via flags). v2.2.0. |
-| `neetru products list` | Lista produtos do registry interno. `--status`, `--limit`, `--json`. |
-| `neetru products publish <slug>` | Toggle visibility do catálogo público para um produto já cadastrado. |
-| `neetru products unpublish <slug>` | Esconde da landing (mantém doc). |
-| `neetru products db ...` | Per-product database management (Phase A — 8 subcomandos). |
-
-### Workspaces (prototipação no Core)
+## Quickstart — criar produto SaaS novo
 
-| Comando | O que faz |
-|---|---|
-| `neetru new <name>` | **Macro end-to-end:** produto + workspace + scaffold local. v2.2.0. |
-| `neetru workspaces create` | Cria workspace vinculado a (produto × customer × env). |
-| `neetru workspaces list` | Lista workspaces com filtros. v2.2.0. |
-| `neetru workspaces get <id>` | Detalhes completos. v2.2.0. |
-| `neetru workspaces open <id>` | Abre `/workspaces/<id>` no browser. v2.2.0. |
-| `neetru workspaces advance <id>` | Promove bundle version no workspace. |
-| `neetru init <name>` | Scaffold de projeto Next.js ou Node API. `--type nextjs\|node-api`. |
-| `neetru status --client-id <id>` | Status do workspace: build/deploy último, domínio, tier. `--json` para scripts. |
-| `neetru logs --client-id <id>` | Logs do workspace; `-f` follow, `-n` lines, `--since 30m`, `--level error`. |
-| `neetru validate` | Health check da config local + conexão com Core. |
-| `neetru open [target]` | Abre página do painel: `dashboard\|builds\|logs\|workspaces\|products\|servers`. |
-| `neetru config set <key> <value>` | Define configuração local. |
-| `neetru config get [key]` | Lê configuração. Sem arg = lista tudo. |
-| `neetru config path` | Mostra caminho do arquivo de config. |
-
-### Catálogo
+```bash
+neetru new gestovendas --env=dev --tier=dev --customer=neetru
+```
 
-| Comando | O que faz |
-|---|---|
-| `neetru publish` | Registra produto em `public_products/`. `--draft` para não aparecer público. |
-| `neetru publish --unpublish` | Despublica (mantém doc). |
+Cria produto + workspace + scaffold local Next.js 15 + instala deps + abre cockpit no browser.
 
-### Build & Deploy (promoção pra produção)
+## Comandos principais
 
 | Comando | O que faz |
 |---|---|
-| `neetru build` | Empacota em tarball + manifest. Detecta stack (node/docker/php-apache/static) automaticamente. |
-| `neetru deploy` | Pipeline E2E pra VM (via agent) ou Cloud Run. `--non-interactive` para CI. |
-
-### Assistant
+| `neetru bootstrap` | Setup da máquina dev (binários + deps + ADC) |
+| `neetru login` / `logout` / `whoami` | Auth OAuth Device Code Flow |
+| `neetru doctor` | Diagnóstico saúde (5 checks rápidos) |
+| `neetru new <slug>` | Criar produto completo (registry + workspace + scaffold) |
+| `neetru init <name>` | Só scaffold local Next.js + Firebase |
+| `neetru add <feature>` | Adicionar features ao scaffold (auth, billing, etc) |
+| `neetru deploy` | Pipeline de deploy interativo (cloud-run / vm / workspace) |
+| `neetru build` | Empacotar produto em tarball pra deploy |
+| `neetru promote` | Promover dev → staging → prod |
+| `neetru env switch <target>` | Trocar `NEETRU_ENV` no `.env.local` |
+| `neetru env set --service=X --set KEY=VAL` | Setar env vars de serviço Cloud Run |
+| `neetru ar create <name>` | Criar repositório Artifact Registry |
+| `neetru hosting create-mapping --service=X --domain=Y` | Domain mapping |
+| `neetru db create --product=X --engine=postgres` | Criar banco por produto |
+| `neetru db engines` | Listar engines disponíveis (firestore, postgres, mysql) |
+| `neetru cloud-run pause/resume/delete <service>` | Controle Cloud Run |
+| `neetru products list/create/update` | Registry de produtos |
+| `neetru workspaces create/list/get/advance` | Instâncias por cliente |
+| `neetru deployments create/rollback` | Histórico de deploys |
+| `neetru tenants list/create/update/suspend` | Gerenciar tenants |
+| `neetru audit tail` | Tail de `audit_logs/` em tempo real |
+| `neetru billing summary` | Resumo de billing |
+| `neetru servers list/provision/deactivate` | Gerenciar servidores |
+| `neetru agent release/yank/canary` | Gerenciar releases do agente |
+| `neetru support tickets list/reply/assign` | Suporte inbox staff |
+| `neetru dns zones list` / `hosting list` | Listar DNS + customer domains |
+| `neetru builds list` | Listar Cloud Build |
+| `neetru dr exports/restore` | Disaster Recovery |
+| `neetru logs` | Ver logs de produtos |
+| `neetru status` | Visão geral do ecossistema |
+| `neetru open <produto>` | Abrir cockpit do produto no browser |
+| `neetru ai` | REPL IA Neetru-aware (Claude/OpenAI/Gemini) |
+| `neetru ui` | Menu interativo do CLI |
+| `neetru publish` | Publicar produto no catálogo público |
+| `neetru fn deploy` | Deploy de Cloud Functions |
+| `neetru upgrade` | Auto-update do CLI |
+| `neetru autocomplete <bash\|zsh\|pwsh>` | Gerar script autocomplete |
+
+**Atalhos:** `neetru ar` = `artifact-registry`, `neetru menu` = `ui`.
+
+40+ subcomandos. Quase todos suportam `--json` pra automação.
 
-| Comando | O que faz |
-|---|---|
-| `neetru ai` | REPL interativo Claude/OpenAI/Gemini com contexto Neetru-aware. `--model auto\|claude\|openai\|gemini`. |
+## Configuração
 
-### Estabilidade & maintenance (v2.0)
+Config persiste em `~/.config/neetru-cli/` (Linux/macOS) ou `%APPDATA%\neetru-cli\` (Windows):
 
-| Comando | O que faz |
+| Chave | Valor |
 |---|---|
-| `neetru doctor` | Diagnóstico de 5 checks: token CLI, Core acessível, schema do `neetru.config.json`, valor de `NEETRU_ENV`, versão CLI vs npm latest. `--json` para machine-readable. |
-| `neetru upgrade` | Verifica `dist-tags.latest` em registry.npmjs.org/@neetru/cli. Se diferente da local, mostra instrução `npm install -g @neetru/cli@latest`. Sem auto-install. `--json` aceito. |
-| `neetru autocomplete <bash\|zsh\|pwsh>` | Gera script de shell completion (lista os 22 subcomandos). Cole na config do shell: `neetru autocomplete bash >> ~/.bashrc`. |
-| `neetru config set telemetry.enabled <true\|false>` | Telemetria opt-in (default off). Quando true, CLI envia eventos anonimizados pra `POST /sdk/v1/telemetry/log`. Nunca envia tokens, paths absolutos ou conteúdo de arquivos. |
+| `neetruApiKey` | Token Bearer `nrt_<keyId>_<secret>` (gerado por `neetru login`) |
+| `coreUrl` | URL base do Core (default `https://core.neetru.com`) |
+| `telemetry.enabled` | Telemetry opt-in (default `false`) |
 
-## Configuração
+```bash
+neetru config set telemetry.enabled true
+neetru config get coreUrl
+neetru config path           # mostra caminho do config file
+```
 
-Token OAuth fica em `~/.config/neetru-cli/auth.json` (chmod 0600). Override via env:
+## Output JSON
 
 ```bash
-NEETRU_API_KEY=nrt_xxx_yyy   # bypass do auth.json
-NEETRU_API_BASE=https://api.neetru.com   # default
+neetru products list --json | jq '.[] | select(.status == "ativo")'
+neetru audit tail --json | jq 'select(.action | startswith("billing"))'
 ```
 
-`neetru.config.json` por projeto:
-
-```json
-{
-  "$schema": "https://neetru.com/schema/neetru.config.json",
-  "slug": "meu-saas",
-  "name": "Meu SaaS",
-  "runtime": "nextjs",
-  "publish": {
-    "tagline": "Resumo curto, 2-120 chars",
-    "description": "Descrição detalhada, 10-2000 chars",
-    "iconKey": "spark",
-    "status": "soon",
-    "order": 100
-  }
-}
-```
+## Auth & Segurança
 
-## Exit codes
+- **OAuth Device Code Flow** (RFC 8628) pra login interativo — não armazena password
+- **Tokens** salvos em `conf` cross-platform, permissões 0600 em Unix
+- **Rate-limit** por método HTTP: GET 120/min, POST/PUT/PATCH 30/min, DELETE 5/min
+- **Step-up MFA** (TOTP) obrigatório em operações destrutivas: `--mfa-token <code>` ou prompt
+- **Dry-run** disponível em comandos de mutação: `--dry-run` mostra efeito SEM aplicar
 
-| Code | Significado |
-|---|---|
-| 0 | sucesso |
-| 1 | erro de validação ou recurso negado |
-| 2 | falha de autenticação (token inválido/expirado) |
-| 3 | permissão negada (role insuficiente) |
-| 4 | erro de servidor ou rede |
-| 5 | recurso não implementado |
+## Stack
+
+- TypeScript 5 ESM-first
+- Node 22+ (LTS)
+- Sem `node-fetch`/`axios`: fetch global nativo
+- Commander 11 (CLI framework) + Inquirer 12 (prompts) + Chalk 5 + Ora (spinners)
 
-## Repositório
+## Mais info
 
-Mantido em [`Neetru/neetru-core/cli/`](https://github.com/Neetru/neetru-core/tree/main/cli) como parte do monorepo.
+- **Repo:** [github.com/Neetru/neetru-core](https://github.com/Neetru/neetru-core)
+- **Docs:** [docs.neetru.com](https://docs.neetru.com)
+- **SDK complementar:** `npm install @neetru/sdk`
+- **Issues / suporte:** abrir issue no repo ou `neetru support`
 
-## License
+## Licença
 
-MIT © Neetru Inc.
+MIT © Neetru

package/dist/commands/artifact-registry.d.ts

@@ -0,0 +1,7 @@
+import { type StepUpOptions } from '../lib/cli-write.js';
+export interface ArtifactRegistryCreateOptions extends StepUpOptions {
+    location?: string;
+    format?: string;
+    description?: string;
+}
+export declare function runArtifactRegistryCreate(name: string, opts: ArtifactRegistryCreateOptions): Promise<void>;

package/dist/commands/artifact-registry.js

@@ -0,0 +1,60 @@
+/**
+ * `neetru artifact-registry create <name>` — cria repositório no Artifact Registry.
+ *
+ * Use case típico: setup one-shot por produto SaaS antes do primeiro deploy.
+ * Após criado, `docker push <location>-docker.pkg.dev/neetru/<name>/<image>:<tag>`
+ * passa a funcionar.
+ *
+ * Endpoint: POST /api/cli/v1/artifact-registry
+ *   body: { name, location, format?, description? }
+ *
+ * Não exige step-up MFA (criação não-destrutiva). Admin only.
+ */
+import ora from 'ora';
+import { apiRequest } from '../lib/api-client.js';
+import { requireToken, handleApiError, printWriteResult, } from '../lib/cli-write.js';
+import { log } from '../utils/logger.js';
+export async function runArtifactRegistryCreate(name, opts) {
+    if (!name) {
+        log.error('Uso: neetru artifact-registry create <name> [--location=us-central1] [--format=DOCKER]');
+        process.exit(1);
+    }
+    const location = opts.location ?? 'us-central1';
+    const format = (opts.format ?? 'DOCKER').toUpperCase();
+    const token = await requireToken(opts.json);
+    const spinner = opts.json
+        ? null
+        : ora({
+            text: `Criando repositório ${name} em ${location} (${format})…`,
+            color: 'blue',
+        }).start();
+    const path = `/api/cli/v1/artifact-registry${opts.dryRun ? '?dryRun=true' : ''}`;
+    let res;
+    try {
+        res = await apiRequest(path, {
+            method: 'POST',
+            token,
+            body: { name, location, format, description: opts.description },
+        });
+        spinner?.stop();
+    }
+    catch (error) {
+        spinner?.fail('Falha ao criar repositório.');
+        handleApiError(error, opts.json);
+    }
+    const humanMessage = res.done
+        ? `Repositório ${res.name} criado em ${res.location}. Push: ${res.pushExample}`
+        : `Criação iniciada — operação ${res.operationName ?? '(?)'} ainda em andamento. Confirme via Console ou aguarde uns segundos antes do primeiro push.`;
+    printWriteResult(res.dryRun
+        ? res
+        : {
+            name: res.name,
+            location: res.location,
+            format: res.format,
+            done: res.done,
+            operationName: res.operationName,
+            dockerHost: res.dockerHost,
+            pushExample: res.pushExample,
+        }, humanMessage, opts.json);
+}
+//# sourceMappingURL=artifact-registry.js.map

package/dist/commands/artifact-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-registry.js","sourceRoot":"","sources":["../../src/commands/artifact-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EACL,YAAY,EACZ,cAAc,EACd,gBAAgB,GAEjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAQzC,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,IAAY,EACZ,IAAmC;IAEnC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,GAAG,CAAC,KAAK,CAAC,wFAAwF,CAAC,CAAC;QACpG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,aAAa,CAAC;IAChD,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IAEvD,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE5C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI;QACvB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,GAAG,CAAC;YACF,IAAI,EAAE,uBAAuB,IAAI,OAAO,QAAQ,KAAK,MAAM,IAAI;YAC/D,KAAK,EAAE,MAAM;SACd,CAAC,CAAC,KAAK,EAAE,CAAC;IAEf,MAAM,IAAI,GAAG,gCAAgC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAEjF,IAAI,GAWH,CAAC;IACF,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE;YAC3B,MAAM,EAAE,MAAM;YACd,KAAK;YACL,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE;SAChE,CAAC,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC7C,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,YAAY,GAAG,GAAG,CAAC,IAAI;QAC3B,CAAC,CAAC,eAAe,GAAG,CAAC,IAAI,cAAc,GAAG,CAAC,QAAQ,WAAW,GAAG,CAAC,WAAW,EAAE;QAC/E,CAAC,CAAC,+BAA+B,GAAG,CAAC,aAAa,IAAI,KAAK,2FAA2F,CAAC;IAEzJ,gBAAgB,CACd,GAAG,CAAC,MAAM;QACR,CAAC,CAAC,GAAG;QACL,CAAC,CAAC;YACE,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,WAAW,EAAE,GAAG,CAAC,WAAW;SAC7B,EACL,YAAY,EACZ,IAAI,CAAC,IAAI,CACV,CAAC;AACJ,CAAC"}

package/dist/commands/bootstrap.d.ts

@@ -0,0 +1,7 @@
+export interface BootstrapOptions {
+    yes?: boolean;
+    check?: boolean;
+    json?: boolean;
+    cwd?: string;
+}
+export declare function runBootstrap(opts?: BootstrapOptions): Promise<void>;