@aiuby-ia/cli 0.3.0 → 0.4.0

package/README.md

@@ -2,24 +2,26 @@
 
 Linha de comando e templates de partida do **AIUBY Compute**.
 
-> **Estado: prévia (0.3.0).** A CLI autentica, copia templates, cadastra aplicações e
+> **Estado: prévia (0.4.0).** A CLI autentica, copia templates, cadastra aplicações e
 > revisões a partir do `aiuby.toml`, lê o catálogo de hardware e mostra o plano de
 > implantação. **Implantar funciona só em organizações com a prévia do runtime habilitada
 > pela AIUBY**: CPU no Google Cloud, até 1 vCPU e 1 GB, 1 réplica, endereço público e prazo
-> (a aplicação para sozinha). Nas demais, o pedido é recusado com os motivos. Logs, escala,
-> volumes, segredos e GPU ainda não existem.
+> (a aplicação para sozinha), com `aiuby logs` para ver a saída. Nas demais, o pedido é
+> recusado com os motivos. Escala, volumes, segredos e GPU ainda não existem.
 
 ## Instalação
 
-Precisa de Node.js 20 ou mais novo. O pacote é distribuído pelo site da AIUBY:
+Precisa de Node.js 20 ou mais novo.
 
 ```bash
-npm install -g https://aiuby.com/cli/aiuby-cli-latest.tgz
+npm install -g @aiuby-ia/cli
 aiuby --version
 ```
 
-Para fixar uma versão, troque `latest` pelo número (por exemplo `aiuby-cli-0.3.0.tgz`).
-Para atualizar, rode o mesmo comando de novo. Para remover: `npm uninstall -g @aiuby-ia/cli`.
+Sem acesso ao registro do npm, o mesmo pacote está no site da AIUBY:
+`npm install -g https://aiuby.com/cli/aiuby-cli-latest.tgz`.
+
+Para atualizar, rode o comando de instalação de novo. Para remover: `npm uninstall -g @aiuby-ia/cli`.
 
 ## Primeiros passos
 
@@ -51,6 +53,7 @@ aiuby apps create            # cadastra; não implanta
 aiuby apps update            # depois de mudar o aiuby.toml: nova revisão
 aiuby deploy --dry-run minha-api
 aiuby deploy minha-api       # só com a prévia do runtime; pede o escopo "Implantar no Compute"
+aiuby logs minha-api
 aiuby stop minha-api
 ```
 

package/dist/aiuby.mjs

@@ -20482,6 +20482,9 @@ var APP_SLUG = /^[a-z][a-z0-9-]{1,38}[a-z0-9]$/;
 var MAX_REPLICAS = 100;
 var CONTROL_CHARS = /[\u0000-\u001f\u007f-\u009f]/;
 var noControl = (v) => !CONTROL_CHARS.test(v);
+var ENV_NAME = /^[A-Z_][A-Z0-9_]{0,63}$/;
+var RESERVED_ENV = /* @__PURE__ */ new Set(["PORT", "K_SERVICE", "K_REVISION", "K_CONFIGURATION"]);
+var MAX_ENV_VARS = 50;
 var IMAGE_REF = /^(?!.*\/\/)[A-Za-z0-9][A-Za-z0-9._\-/:@]*$/;
 var HardwareRequest = external_exports.object({
   /** `any`: o planejador escolhe entre os provedores habilitados. */
@@ -20497,6 +20500,11 @@ var AppConfig = external_exports.object({
   image: external_exports.string().min(1).max(300).regex(IMAGE_REF, "image precisa ser uma refer\xEAncia de imagem de container, sem espa\xE7os").nullable().default(null),
   entrypoint: external_exports.string().min(1).max(300).refine(noControl, "entrypoint n\xE3o aceita caracteres de controle").nullable().default(null),
   port: external_exports.number().int().min(1).max(65535).default(8080),
+  /**
+   * Variáveis de ambiente da aplicação. Ficam na configuração, visíveis a quem vê a
+   * aplicação: servem para ajuste, NÃO para segredo (senha, chave, token).
+   */
+  env: external_exports.record(external_exports.string().regex(ENV_NAME, "nome de vari\xE1vel: mai\xFAsculas, d\xEDgitos e sublinhado").refine((name) => !RESERVED_ENV.has(name), "nome reservado pela plataforma"), external_exports.string().max(2e3).refine(noControl, "valor n\xE3o aceita caracteres de controle")).refine((env) => Object.keys(env).length <= MAX_ENV_VARS, `no m\xE1ximo ${MAX_ENV_VARS} vari\xE1veis`).default({}),
   hardware: HardwareRequest,
   scaling: external_exports.object({
     minReplicas: external_exports.number().int().min(0).max(MAX_REPLICAS).default(0),
@@ -20672,6 +20680,18 @@ async function stop(io, args) {
   await apiPost(requireLogin(), `/api/platform/compute/apps/${encodeURIComponent(slug)}/deployments/stop`, void 0, io.fetcher).catch(scopeHint(DEPLOY_HINT));
   emit(io, { ok: true, slug }, () => io.out(`${slug} parada: o servi\xE7o foi apagado e o endere\xE7o n\xE3o responde mais.`));
 }
+async function logs(io, args) {
+  const slug = args.find((a, i) => !a.startsWith("--") && args[i - 1] !== "--limit");
+  if (!slug) throw new CliError("Uso: aiuby logs [--limit N] <identificador>", EXIT.usage);
+  const flag = args.indexOf("--limit");
+  const limit = flag >= 0 ? Number(args[flag + 1]) : 100;
+  if (!Number.isInteger(limit) || limit < 1 || limit > 200) throw new CliError("--limit precisa ser um n\xFAmero de 1 a 200.", EXIT.usage);
+  const data = await apiGet(requireLogin(), `/api/platform/compute/apps/${encodeURIComponent(slug)}/logs?limit=${limit}`, io.fetcher);
+  emit(io, data, () => {
+    if (data.lines.length === 0) return io.out(`Nenhuma linha de log desde a implanta\xE7\xE3o (revis\xE3o r${data.deployment.revision}).`);
+    for (const line of [...data.lines].reverse()) io.out(`${line.time.replace("T", " ").slice(0, 19)} ${line.severity.padEnd(7)} ${line.text}`);
+  });
+}
 async function capacityList(io, args) {
   const flag = args.indexOf("--provider");
   const provider = flag >= 0 ? args[flag + 1] : void 0;
@@ -20791,7 +20811,7 @@ var notYet = (command) => async () => {
 };
 
 // src/main.ts
-var VERSION = "0.3.0";
+var VERSION = "0.4.0";
 var HELP = `aiuby ${VERSION} \u2014 linha de comando do AIUBY Compute
 
 Uso: aiuby <comando> [op\xE7\xF5es]
@@ -20811,10 +20831,11 @@ Dispon\xEDveis hoje:
   deploy --dry-run <identificador> Mostra o plano, sem criar nada
   deploy [--no-wait] <identificador>  Implanta a revis\xE3o atual (s\xF3 em organiza\xE7\xE3o com a pr\xE9via do runtime)
   stop <identificador>             Para a implanta\xE7\xE3o e apaga o servi\xE7o
+  logs [--limit N] <identificador> \xDAltimas linhas de log da implanta\xE7\xE3o mais recente
   doctor                           Confere ambiente, credencial e API
 
 Ainda n\xE3o dispon\xEDveis:
-  run, logs, scale, rollback, volumes, secrets, domains
+  run, scale, rollback, volumes, secrets, domains
 
 Op\xE7\xF5es gerais:
   --json       Sa\xEDda em JSON
@@ -20823,7 +20844,7 @@ Op\xE7\xF5es gerais:
 
 Ambiente: AIUBY_TOKEN, AIUBY_API_URL, AIUBY_CONFIG_DIR
 C\xF3digos de sa\xEDda: 0 ok \xB7 1 erro \xB7 2 uso incorreto \xB7 3 n\xE3o autenticado \xB7 4 recusado \xB7 5 configura\xE7\xE3o inv\xE1lida`;
-var PLANNED = ["run", "logs", "scale", "rollback", "volumes", "secrets", "domains"];
+var PLANNED = ["run", "scale", "rollback", "volumes", "secrets", "domains"];
 var ROUTES = {
   login,
   logout,
@@ -20838,6 +20859,7 @@ var ROUTES = {
   "config validate": configValidate,
   deploy,
   stop,
+  logs,
   doctor
 };
 async function run(argv, io) {

package/docs/api.md

@@ -74,10 +74,15 @@ Cadastra a aplicação com a primeira revisão. Nada é implantado. Responde `20
 ```json
 { "name": "Minha API", "slug": "minha-api",
   "config": { "runtime": "container", "image": "REGISTRO/minha-api:1", "port": 8080,
+    "env": { "LOG_LEVEL": "info" },
     "hardware": { "provider": "any", "cpu": 1, "memoryMb": 512 },
     "scaling": { "minReplicas": 0, "maxReplicas": 2 } } }
 ```
 
+`config.env` são variáveis de ambiente (até 50; nomes em maiúsculas, dígitos e sublinhado;
+`PORT` e os nomes `K_*` são da plataforma). Elas ficam visíveis a quem vê a aplicação: não
+use para senha, chave ou token.
+
 Regras: `slug` com 3 a 40 caracteres (minúsculas, dígitos e hífen, começando por letra),
 único no workspace; `runtime` `container` exige `image`; campos desconhecidos são recusados.
 Limites: 50 aplicações por workspace, 200 revisões por aplicação.
@@ -102,6 +107,17 @@ Leitura. A implantação mais recente, já conferida com a conta de nuvem, ou `n
 
 `status`: `deploying`, `running`, `failed` ou `stopped`.
 
+### `GET /apps/{ref}/logs`
+
+Leitura. Últimas linhas de log da implantação mais recente, da mais nova para a mais antiga
+(`?limit=`, padrão 100, até 200). Vale também para implantação que falhou ou já parou. Só em
+organização com a prévia do runtime; sem implantação, responde `409`. Limite: 20 leituras por minuto.
+
+```json
+{ "lines": [ { "time": "2026-11-12T10:05:00Z", "severity": "INFO", "text": "servidor no ar" } ],
+  "deployment": { "status": "running", "revision": 2 } }
+```
+
 ### `POST /apps/{ref}/deployments`
 
 Sessão de quem gerencia o workspace, ou chave com `compute:deploy`. Implanta a revisão atual.

package/docs/cli.md

@@ -1,9 +1,9 @@
 # Referência da CLI `aiuby`
 
-Versão 0.3.0. A CLI fala só com a API da AIUBY: nunca pede nem usa credenciais da AWS ou
+Versão 0.4.0. A CLI fala só com a API da AIUBY: nunca pede nem usa credenciais da AWS ou
 do Google Cloud.
 
-Instalação: `npm install -g https://aiuby.com/cli/aiuby-cli-latest.tgz` (Node.js 20 ou mais novo).
+Instalação: `npm install -g @aiuby-ia/cli` (Node.js 20 ou mais novo).
 
 ## Autenticação
 
@@ -53,6 +53,7 @@ runtime habilitada pela AIUBY. Fora dela, a API recusa com os motivos (código d
 | --- | --- |
 | `aiuby deploy [--no-wait] <identificador>` | Implanta a revisão atual no Google Cloud e acompanha até ficar em execução (até 3 minutos). Mostra o endereço público e o prazo. Reimplantar troca a revisão no mesmo endereço |
 | `aiuby stop <identificador>` | Para a implantação: o serviço é apagado e o endereço deixa de responder |
+| `aiuby logs [--limit N] <identificador>` | Últimas linhas de log da implantação mais recente (padrão 100, até 200). Vale também para uma que falhou ou já parou |
 
 Limites da prévia: só CPU, até 1 vCPU e 1 GB, 1 réplica (escala a zero quando ociosa),
 endereço público sem autenticação, prazo de algumas horas. Sem cobrança nesta fase.
@@ -67,7 +68,7 @@ endereço público sem autenticação, prazo de algumas horas. Sem cobrança nes
 
 ## Ainda não disponíveis
 
-`run`, `logs`, `scale`, `rollback`, `volumes`, `secrets`
+`run`, `scale`, `rollback`, `volumes`, `secrets`
 e `domains` respondem que ainda não estão disponíveis e saem com código 4. Nenhum deles chama a API.
 
 ## Opções gerais

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiuby-ia/cli",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Linha de comando do AIUBY Compute",
   "type": "module",
   "bin": {