@neetru/cli 2.7.4 → 2.8.0

package/README.md

@@ -1,137 +1,137 @@
-# @neetru/cli
-
-> 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.
-
-<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
-```
-
-Bootstrap completo da máquina dev (Node, gcloud, Docker, Firebase CLI, deps NPM, GCP ADC):
-
-```bash
-neetru bootstrap
-```
-
-Login no Core via OAuth Device Code Flow:
-
-```bash
-neetru login
-```
-
-Validar estado:
-
-```bash
-neetru doctor
-```
-
-## Quickstart — criar produto SaaS novo
-
-```bash
-neetru new gestovendas --env=dev --tier=dev --customer=neetru
-```
-
-Cria produto + workspace + scaffold local Next.js 15 + instala deps + abre cockpit no browser.
-
-## Comandos principais
-
-| Comando | O que faz |
-|---|---|
-| `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.
-
-## Configuração
-
-Config persiste em `~/.config/neetru-cli/` (Linux/macOS) ou `%APPDATA%\neetru-cli\` (Windows):
-
-| Chave | Valor |
-|---|---|
-| `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`) |
-
-```bash
-neetru config set telemetry.enabled true
-neetru config get coreUrl
-neetru config path           # mostra caminho do config file
-```
-
-## Output JSON
-
-```bash
-neetru products list --json | jq '.[] | select(.status == "ativo")'
-neetru audit tail --json | jq 'select(.action | startswith("billing"))'
-```
-
-## Auth & Segurança
-
-- **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
-
-## 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)
-
-## Mais info
-
-- **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`
-
-## Licença
-
-MIT © Neetru
+# @neetru/cli
+
+> 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.
+
+<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
+```
+
+Bootstrap completo da máquina dev (Node, gcloud, Docker, Firebase CLI, deps NPM, GCP ADC):
+
+```bash
+neetru bootstrap
+```
+
+Login no Core via OAuth Device Code Flow:
+
+```bash
+neetru login
+```
+
+Validar estado:
+
+```bash
+neetru doctor
+```
+
+## Quickstart — criar produto SaaS novo
+
+```bash
+neetru new gestovendas --env=dev --tier=dev --customer=neetru
+```
+
+Cria produto + workspace + scaffold local Next.js 15 + instala deps + abre cockpit no browser.
+
+## Comandos principais
+
+| Comando | O que faz |
+|---|---|
+| `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.
+
+## Configuração
+
+Config persiste em `~/.config/neetru-cli/` (Linux/macOS) ou `%APPDATA%\neetru-cli\` (Windows):
+
+| Chave | Valor |
+|---|---|
+| `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`) |
+
+```bash
+neetru config set telemetry.enabled true
+neetru config get coreUrl
+neetru config path           # mostra caminho do config file
+```
+
+## Output JSON
+
+```bash
+neetru products list --json | jq '.[] | select(.status == "ativo")'
+neetru audit tail --json | jq 'select(.action | startswith("billing"))'
+```
+
+## Auth & Segurança
+
+- **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
+
+## 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)
+
+## Mais info
+
+- **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`
+
+## Licença
+
+MIT © Neetru

package/dist/cli-kit/format.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Indicador de passo: `step(2, 6, 'instalando')` → `"[2/6] instalando"`.
+ *
+ * `n` e `total` precisam ser inteiros com `1 <= n <= total`. Fora disso
+ * lança — um contador de passos inválido é bug de chamador, não algo a
+ * mascarar. `label` é coagido para string.
+ */
+export declare function step(n: number, total: number, label: string): string;
+/**
+ * Opções de `errorBlock`.
+ *
+ * `fix` é OBRIGATÓRIO de propósito: torna invariante em tempo de compilação
+ * que todo bloco de erro carrega uma ação corretiva. Não existe erro sem
+ * "como resolver".
+ */
+export interface ErrorBlockOpts {
+    /** A ação corretiva — o que o usuário deve fazer para resolver. */
+    fix: string;
+}
+/**
+ * Bloco de erro multi-linha:
+ *   `✗ <mensagem>`
+ *   `→ Como resolver: <fix>`
+ *
+ * `message` e `fix` precisam ser strings não-vazias — se faltar qualquer um,
+ * lança. Todo erro DEVE dizer ao usuário como sair dele.
+ */
+export declare function errorBlock(message: string, opts: ErrorBlockOpts): string;
+/**
+ * Opções da "pausa sagrada" — confirmação de operação destrutiva.
+ */
+export interface SacredPauseOpts {
+    /** O título da operação (ex.: "Migração destrutiva"). */
+    title: string;
+    /** O que será perdido — o dado/efeito irreversível. */
+    consequence: string;
+    /** Como o usuário confirma (ex.: "digite o nome do banco"). */
+    confirmHint: string;
+}
+/**
+ * Bloco visualmente destacado para a "pausa sagrada" de operações
+ * destrutivas. Renderiza um quadro delimitado por uma linha de `─` com:
+ *   - `title`       — em destaque (heading)
+ *   - `consequence` — em amarelo (warn) — o que será perdido
+ *   - `confirmHint` — como confirmar
+ *
+ * Os três campos são obrigatórios; vazio/espaço/não-string → lança.
+ */
+export declare function sacredPause(opts: SacredPauseOpts): string;

package/dist/cli-kit/format.js

@@ -0,0 +1,88 @@
+/**
+ * Formatadores compostos da gramática visual do CLI.
+ *
+ * Funções puras: dado o mesmo input, devolvem o mesmo output (a estilização
+ * via `chalk` é determinística para um dado nível de cor). Todas devolvem
+ * strings — quem decide imprimir é o call site.
+ */
+import { GLYPHS } from './glyphs.js';
+import { err, warn, dim, heading } from './palette.js';
+/** Verdadeiro se `v` é string com pelo menos um caractere não-espaço. */
+function isNonEmptyString(v) {
+    return typeof v === 'string' && v.trim().length > 0;
+}
+/**
+ * Indicador de passo: `step(2, 6, 'instalando')` → `"[2/6] instalando"`.
+ *
+ * `n` e `total` precisam ser inteiros com `1 <= n <= total`. Fora disso
+ * lança — um contador de passos inválido é bug de chamador, não algo a
+ * mascarar. `label` é coagido para string.
+ */
+export function step(n, total, label) {
+    if (!Number.isInteger(n) || !Number.isInteger(total)) {
+        throw new Error(`step(): n e total precisam ser inteiros — recebido n=${n}, total=${total}`);
+    }
+    if (total < 1) {
+        throw new Error(`step(): total precisa ser >= 1 — recebido total=${total}`);
+    }
+    if (n < 1 || n > total) {
+        throw new Error(`step(): n precisa estar entre 1 e ${total} — recebido n=${n}`);
+    }
+    const text = typeof label === 'string' ? label : String(label);
+    return `[${n}/${total}] ${text}`;
+}
+/**
+ * Bloco de erro multi-linha:
+ *   `✗ <mensagem>`
+ *   `→ Como resolver: <fix>`
+ *
+ * `message` e `fix` precisam ser strings não-vazias — se faltar qualquer um,
+ * lança. Todo erro DEVE dizer ao usuário como sair dele.
+ */
+export function errorBlock(message, opts) {
+    if (!isNonEmptyString(message)) {
+        throw new Error('errorBlock(): message precisa ser uma string não-vazia');
+    }
+    if (!opts || !isNonEmptyString(opts.fix)) {
+        throw new Error('errorBlock(): opts.fix precisa ser uma string não-vazia — todo erro precisa de uma ação corretiva');
+    }
+    const headLine = `${err(GLYPHS.err)} ${err(message)}`;
+    const fixLine = `${dim(GLYPHS.arrow)} ${dim('Como resolver:')} ${opts.fix}`;
+    return `${headLine}\n${fixLine}`;
+}
+/** Largura da borda do bloco de pausa sagrada. */
+const SACRED_PAUSE_WIDTH = 56;
+/**
+ * Bloco visualmente destacado para a "pausa sagrada" de operações
+ * destrutivas. Renderiza um quadro delimitado por uma linha de `─` com:
+ *   - `title`       — em destaque (heading)
+ *   - `consequence` — em amarelo (warn) — o que será perdido
+ *   - `confirmHint` — como confirmar
+ *
+ * Os três campos são obrigatórios; vazio/espaço/não-string → lança.
+ */
+export function sacredPause(opts) {
+    if (!opts) {
+        throw new Error('sacredPause(): opts é obrigatório');
+    }
+    if (!isNonEmptyString(opts.title)) {
+        throw new Error('sacredPause(): title precisa ser uma string não-vazia');
+    }
+    if (!isNonEmptyString(opts.consequence)) {
+        throw new Error('sacredPause(): consequence precisa ser uma string não-vazia');
+    }
+    if (!isNonEmptyString(opts.confirmHint)) {
+        throw new Error('sacredPause(): confirmHint precisa ser uma string não-vazia');
+    }
+    const border = dim('─'.repeat(SACRED_PAUSE_WIDTH));
+    const lines = [
+        border,
+        `${warn(GLYPHS.warn)} ${heading(opts.title)}`,
+        '',
+        `${GLYPHS.bullet} ${warn(opts.consequence)}`,
+        `${GLYPHS.arrow} ${opts.confirmHint}`,
+        border,
+    ];
+    return lines.join('\n');
+}
+//# sourceMappingURL=format.js.map

package/dist/cli-kit/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/cli-kit/format.ts"],"names":[],"mappings":"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"}

package/dist/cli-kit/glyphs.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Glifos canônicos da gramática visual do CLI.
+ *
+ * Conjunto pequeno e fechado de símbolos usados em toda a saída do
+ * `@neetru/cli`. Congelado para que nenhum comando reescreva um glifo no
+ * meio do caminho — a consistência visual é parte do contrato.
+ */
+export declare const GLYPHS: Readonly<{
+    /** Sucesso / passo concluído. */
+    ok: "✓";
+    /** Erro / falha. */
+    err: "✗";
+    /** Aviso / atenção. */
+    warn: "⚠";
+    /** Encaminhamento / próxima ação (ex.: linha de "como resolver"). */
+    arrow: "→";
+    /** Item de lista. */
+    bullet: "·";
+    /** Em andamento / pendente. */
+    pending: "…";
+}>;
+export type Glyphs = typeof GLYPHS;

package/dist/cli-kit/glyphs.js

@@ -0,0 +1,22 @@
+/**
+ * Glifos canônicos da gramática visual do CLI.
+ *
+ * Conjunto pequeno e fechado de símbolos usados em toda a saída do
+ * `@neetru/cli`. Congelado para que nenhum comando reescreva um glifo no
+ * meio do caminho — a consistência visual é parte do contrato.
+ */
+export const GLYPHS = Object.freeze({
+    /** Sucesso / passo concluído. */
+    ok: '✓',
+    /** Erro / falha. */
+    err: '✗',
+    /** Aviso / atenção. */
+    warn: '⚠',
+    /** Encaminhamento / próxima ação (ex.: linha de "como resolver"). */
+    arrow: '→',
+    /** Item de lista. */
+    bullet: '·',
+    /** Em andamento / pendente. */
+    pending: '…',
+});
+//# sourceMappingURL=glyphs.js.map

package/dist/cli-kit/glyphs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glyphs.js","sourceRoot":"","sources":["../../src/cli-kit/glyphs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,iCAAiC;IACjC,EAAE,EAAE,GAAG;IACP,oBAAoB;IACpB,GAAG,EAAE,GAAG;IACR,uBAAuB;IACvB,IAAI,EAAE,GAAG;IACT,qEAAqE;IACrE,KAAK,EAAE,GAAG;IACV,qBAAqB;IACrB,MAAM,EAAE,GAAG;IACX,+BAA+B;IAC/B,OAAO,EAAE,GAAG;CACb,CAAC,CAAC"}

package/dist/cli-kit/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `@neetru/cli-kit` — gramática visual do `@neetru/cli`.
+ *
+ * Primitivos de saída no terminal: glifos canônicos, paleta semântica e
+ * formatadores compostos. Todo comando do CLI deve usar este módulo em vez
+ * de chamar `chalk` direto — assim a identidade visual é consistente e
+ * evolui num lugar só.
+ */
+export { GLYPHS } from './glyphs.js';
+export type { Glyphs } from './glyphs.js';
+export { ok, err, warn, dim, heading } from './palette.js';
+export { step, errorBlock, sacredPause, } from './format.js';
+export type { ErrorBlockOpts, SacredPauseOpts } from './format.js';

package/dist/cli-kit/index.js

@@ -0,0 +1,12 @@
+/**
+ * `@neetru/cli-kit` — gramática visual do `@neetru/cli`.
+ *
+ * Primitivos de saída no terminal: glifos canônicos, paleta semântica e
+ * formatadores compostos. Todo comando do CLI deve usar este módulo em vez
+ * de chamar `chalk` direto — assim a identidade visual é consistente e
+ * evolui num lugar só.
+ */
+export { GLYPHS } from './glyphs.js';
+export { ok, err, warn, dim, heading } from './palette.js';
+export { step, errorBlock, sacredPause, } from './format.js';
+//# sourceMappingURL=index.js.map

package/dist/cli-kit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli-kit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EACL,IAAI,EACJ,UAAU,EACV,WAAW,GACZ,MAAM,aAAa,CAAC"}

package/dist/cli-kit/palette.d.ts

@@ -0,0 +1,10 @@
+/** Sucesso — verde. */
+export declare function ok(s: string): string;
+/** Erro — vermelho. */
+export declare function err(s: string): string;
+/** Aviso — amarelo. */
+export declare function warn(s: string): string;
+/** Texto secundário / esmaecido. */
+export declare function dim(s: string): string;
+/** Título de seção — negrito. */
+export declare function heading(s: string): string;

package/dist/cli-kit/palette.js

@@ -0,0 +1,36 @@
+/**
+ * Paleta semântica do CLI — wrappers finos de `chalk`.
+ *
+ * Cada função recebe uma string e devolve a string estilizada. A intenção é
+ * semântica (ok / err / warn / dim / heading), nunca "pinte de verde" — assim
+ * a paleta pode evoluir sem tocar nos call sites.
+ *
+ * Defensivo: entrada não-string é coagida com `String(...)` em vez de lançar —
+ * estilizar texto nunca deve derrubar o CLI.
+ */
+import chalk from 'chalk';
+/** Coage qualquer valor para string sem lançar. */
+function coerce(s) {
+    return typeof s === 'string' ? s : String(s);
+}
+/** Sucesso — verde. */
+export function ok(s) {
+    return chalk.green(coerce(s));
+}
+/** Erro — vermelho. */
+export function err(s) {
+    return chalk.red(coerce(s));
+}
+/** Aviso — amarelo. */
+export function warn(s) {
+    return chalk.yellow(coerce(s));
+}
+/** Texto secundário / esmaecido. */
+export function dim(s) {
+    return chalk.dim(coerce(s));
+}
+/** Título de seção — negrito. */
+export function heading(s) {
+    return chalk.bold(coerce(s));
+}
+//# sourceMappingURL=palette.js.map

package/dist/cli-kit/palette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.js","sourceRoot":"","sources":["../../src/cli-kit/palette.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,mDAAmD;AACnD,SAAS,MAAM,CAAC,CAAU;IACxB,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,uBAAuB;AACvB,MAAM,UAAU,EAAE,CAAC,CAAS;IAC1B,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,uBAAuB;AACvB,MAAM,UAAU,GAAG,CAAC,CAAS;IAC3B,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED,uBAAuB;AACvB,MAAM,UAAU,IAAI,CAAC,CAAS;IAC5B,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,GAAG,CAAC,CAAS;IAC3B,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,OAAO,CAAC,CAAS;IAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC"}

package/dist/commands/ai.js

@@ -9,14 +9,14 @@ const PROMPT_PREFIX = chalk.hex('#1E90FF').bold('  › ');
 const ASSISTANT_PREFIX = chalk.dim('  ◆ ');
 // Help público — sem /modelo (orchestrator escolhe). /debug:model é o
 // override avançado pra quem quer forçar.
-const HELP_TEXT = `
-  Comandos:
-    /sair  /exit         encerrar sessão
-    /limpar /clear       limpar histórico de contexto
-    /agentes <pergunta>  consultar 2+ modelos em paralelo e comparar
-    /auth                rodar wizard de configuração (claude/codex/gemini)
-    /help                mostrar este texto
-    /debug:model <nome>  forçar modelo (claude|openai|gemini|auto)
+const HELP_TEXT = `
+  Comandos:
+    /sair  /exit         encerrar sessão
+    /limpar /clear       limpar histórico de contexto
+    /agentes <pergunta>  consultar 2+ modelos em paralelo e comparar
+    /auth                rodar wizard de configuração (claude/codex/gemini)
+    /help                mostrar este texto
+    /debug:model <nome>  forçar modelo (claude|openai|gemini|auto)
 `.trim();
 /**
  * Checa se o usuário tem pelo menos uma cred (local OU descoberta). Se zero,