@neetru/cli 1.0.0 → 2.0.0

package/CHANGELOG.md

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

package/README.md

@@ -1,197 +1,154 @@
-# Neetru CLI
+# @neetru/cli
 
-SDK scaffolding e operações DevOps para integrar seu SaaS com **Neetru Core**.
+> Developer Kit oficial da Neetru — scaffold, AI assistant, publish, build e deploy de produtos SaaS via Neetru Core.
 
-```bash
-npm install -g @neetru/cli
-```
+[![npm version](https://img.shields.io/npm/v/@neetru/cli.svg)](https://www.npmjs.com/package/@neetru/cli)
 
-## Quick Start
+## Instalação
 
 ```bash
-# 1. Autentique seu CLI (uma vez)
-neetru login
-
-# 2. Inicialize seu projeto
-neetru init
-
-# 3. Adicione integrações (auth, billing, usage, users)
-neetru add auth
-neetru add billing
-
-# 4. Verifique tudo
-neetru validate
-
-# 5. Deploy
-neetru deploy --env dev --watch
+npm install -g @neetru/cli
+neetru --version
 ```
 
-## Comandos
-
-### Setup
+Requer Node 20 ou superior.
 
-| Comando | Descrição |
-|---------|-----------|
-| `neetru init` | Inicializa `neetru.json` no projeto atual |
-| `neetru add <feature>` | Scaffold de integração (auth, billing, usage, users) |
-| `neetru generate-types` | Gera tipos TypeScript a partir do schema do Core |
-| `neetru validate` | Valida configuração e conexão |
+> **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.
 
-### Autenticação
+## Topologia de produto Neetru
 
-| Comando | Descrição |
-|---------|-----------|
-| `neetru login` | Autentica o CLI com API key |
-| `neetru whoami` | Mostra configuração do projeto atual |
+```
+┌─────────────┐    build/promote    ┌──────────────┐
+│  Workspace  │  ─────────────────► │ Server (VM)  │
+│ prototipação│                     │  ou Cloud Run│
+│  no Core    │                     │  produção    │
+└─────────────┘                     └──────────────┘
+   neetru                              neetru
+   status / logs / open                build / deploy
+```
 
-### Operações
+- **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.
 
-| Comando | Descrição |
-|---------|-----------|
-| `neetru status` | Status do workspace (build, deploy, domínio) |
-| `neetru deploy [-e dev\|staging\|prod] [--watch]` | Dispara deploy |
-| `neetru logs [-f] [-n 100] [--since 1h]` | Logs do workspace |
-| `neetru open [page]` | Abre painel Neetru no navegador |
+## Começo rápido
 
-## Como obter API Key
+```bash
+# 1. Login (abre browser para Device Code OAuth)
+neetru login
 
-1. Acesse o painel Neetru Core: `https://core.neetru.com/admin/cli-keys`
-2. Clique em **"Gerar nova API key"**
-3. Dê um nome descritivo (ex: "MacBook Local")
-4. Copie o token mostrado **uma única vez** (formato: `nrt_xxxxxxxx_yyyyy...`)
-5. No terminal: `neetru login` e cole o token
+# 2. Valida config + conexão
+neetru validate
 
-API keys são vinculadas ao seu usuário e respeitam suas roles (admin/operator/viewer).
+# 3. Cria um projeto novo
+neetru init meu-saas --type nextjs
+cd meu-saas
 
-## Configuração
+# 4. Vê status do workspace (se você já tem um criado em UI Core)
+neetru status --client-id <oauthClientId>
 
-### Local (`./neetru.json`)
-Criado por `neetru init`. Define o projeto:
+# 5. Acompanha logs em tempo real
+neetru logs --client-id <oauthClientId> -f
 
-```json
-{
-  "coreUrl": "https://core.neetru.com",
-  "clientId": "client_abc123",
-  "projectName": "minha-app",
-  "features": ["auth", "billing"],
-  "createdAt": "2026-04-25T..."
-}
+# 6. Quando estiver pronto pra produção: publica no catálogo + builda + deploya
+neetru publish --draft
+neetru build
+neetru deploy --target=vm
 ```
 
-### Global (`~/.neetru/config.json`)
-Credenciais (criadas por `neetru login`):
-
-```json
-{
-  "coreUrl": "https://core.neetru.com",
-  "clientSecret": "nrt_xxxxxxxx_yyyy..."
-}
-```
+## Comandos
 
-### Variáveis de ambiente
+### Auth
 
-| Variável | Uso |
-|----------|-----|
-| `NEETRU_CLI_API_KEY` | API key alternativa (override de `~/.neetru/config.json`) |
-| `NEETRU_CORE_URL` | Override do core URL |
-| `NEETRU_CLIENT_ID` | Client ID (necessário no app, não no CLI) |
-| `NEETRU_CLIENT_SECRET` | Client secret OAuth (do SDK no app) |
+| 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. |
 
-## Features
+### Workspace (prototipação no Core)
 
-### `auth` — OAuth 2.0 / OIDC
+| Comando | O que faz |
+|---|---|
+| `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. |
 
-Login SSO com Neetru Core. Scaffold inclui:
-- Rotas `/auth/login` e `/auth/callback`
-- Session management
-- `requireNeetruSession()` middleware
+### Catálogo
 
-### `billing` — Assinaturas e Planos
+| 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). |
 
-Client para checar entitlements e planos:
-```ts
-import { neetruBilling } from '@/lib/neetru';
+### Build & Deploy (promoção pra produção)
 
-const sub = await neetruBilling.getSubscription();
-const canUseFeature = await neetruBilling.checkEntitlement('advanced_reports');
-```
+| 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. |
 
-### `usage` — Metered Billing
+### Assistant
 
-Reportar eventos de uso (faturados via Stripe):
-```ts
-import { reporter } from '@/lib/neetru/usage';
+| Comando | O que faz |
+|---|---|
+| `neetru ai` | REPL interativo Claude/OpenAI/Gemini com contexto Neetru-aware. `--model auto\|claude\|openai\|gemini`. |
 
-reporter.track('api_call', 1);
-reporter.track('storage_gb', 2.5);
-// Eventos enviados em batch a cada 60s
-```
+### Estabilidade & maintenance (v2.0)
 
-### `users` — API de Usuários
+| Comando | O que faz |
+|---|---|
+| `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. |
 
-Buscar perfis e preferências dos usuários autenticados via Neetru Auth.
+## Configuração
 
-## Exemplo End-to-End
+Token OAuth fica em `~/.config/neetru-cli/auth.json` (chmod 0600). Override via env:
 
 ```bash
-# Cliente final (ou DevOps do cliente)
-$ neetru login
-🔐 Neetru CLI — Login
-Obtenha sua API key em: https://core.neetru.com/admin/cli-keys
-API key: ********
-✓ Autenticado como devops@cliente.com (operator)
-
-$ cd ~/projects/minha-app
-$ neetru init
-🚀 Neetru SDK — Inicialização
-URL do Neetru Core: https://core.neetru.com
-OAuth Client ID: client_a1b2c3
-✓ neetru.json criado
-
-$ neetru add auth
-✓ auth adicionado
-  src/lib/neetru/auth.ts
-  src/app/api/auth/callback/route.ts
-
-$ neetru deploy --env staging --watch
-🚀 Deploy → staging
-  Branch: main
-  Workspace: client_a1b2c3
-
-✓ Deploy iniciado: dpl_xyz789
-
-  ✓ pre-checks (success)
-  ✓ download-artifact (success)
-  ✓ run-migrations (success)
-  ✓ restart-services (success)
-  ✓ healthcheck (success)
-  ✓ post-hooks (success)
-
-✓ Deploy concluído com sucesso
-  → https://minha-app.staging.neetru.com
+NEETRU_API_KEY=nrt_xxx_yyy   # bypass do auth.json
+NEETRU_API_BASE=https://api.neetru.com   # default
 ```
 
-## Desenvolvimento Local
+`neetru.config.json` por projeto:
 
-```bash
-git clone https://github.com/neetru/cli.git
-cd cli
-npm install
-npm run dev -- --help
+```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
+  }
+}
+```
 
-# Build
-npm run build
+## Exit codes
 
-# Testar localmente
-node dist/index.js init
-```
+| 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 |
 
-## Suporte
+## Repositório
 
-- Documentação: https://docs.neetru.com
-- Issues: https://github.com/neetru/cli/issues
-- Painel: https://core.neetru.com
+Mantido em [`Neetru/core/cli/`](https://github.com/Neetru/core/tree/main/cli) como parte do monorepo.
 
-## Licença
+## License
 
-MIT © Neetru
+MIT © Neetru Inc.

package/dist/commands/add.d.ts

@@ -1,3 +1,8 @@
-import { Command } from 'commander';
-export declare function addCommand(): Command;
-//# sourceMappingURL=add.d.ts.map
+export interface AddOptions {
+    feature: string;
+    /** Override target dir (test injeta cwd diferente). Default: process.cwd(). */
+    cwd?: string;
+    /** Force-overwrite existing files. Default false. */
+    force?: boolean;
+}
+export declare function runAdd(opts: AddOptions): Promise<void>;