@zenifra/cli 0.2.4 → 0.2.6

package/README.md

@@ -51,6 +51,7 @@ zenifra orgs
 zenifra org set
 zenifra plans
 zenifra plans --type http
+zenifra plans --type valkey
 zenifra plans --type storage --json
 zenifra create project
 zenifra create project --name <name> --plan free --payment-mode hourly --config @examples/http-project.json
@@ -58,11 +59,20 @@ zenifra create project --name <name> --plan basic --payment-mode hourly --config
 zenifra create project --name <name> --plan premium --payment-mode hourly --config @examples/http-autoscaling-project.json
 zenifra create project --name <name> --plan db-basic --payment-mode monthly --config @examples/postgresql-project.json
 zenifra create project --name <name> --plan db-basic --payment-mode monthly --config @examples/mariadb-project.json
+zenifra create project --name <name> --plan db-free --payment-mode hourly --config @examples/valkey-key-value-project.json
+zenifra create project --name <name> --plan cache-free --payment-mode hourly --config @examples/valkey-cache-project.json
+zenifra create project --name <name> --plan queue-free --payment-mode hourly --config @examples/valkey-queue-project.json
 zenifra projects --type http --page 1 --limit 15
+zenifra projects --type valkey --page 1 --limit 15
 zenifra project info --project <project-id>
+zenifra valkey status --project <project-id>
+zenifra valkey connection --project <project-id>
+zenifra valkey credentials rotate --project <project-id> --wait
+zenifra valkey credentials status --project <project-id> --operation <operation-id>
 zenifra project url --project <project-id>
 zenifra project logs --project <project-id> --instance <instance-id>
 zenifra project metrics --project <project-id> --instance <instance-id>
+zenifra project metrics capabilities --project <project-id>
 zenifra project network --project <project-id> --view summary
 zenifra project image set --project <project-id> --image ghcr.io/zenifra/app:tag
 zenifra project envs --project <project-id>
@@ -84,6 +94,41 @@ zenifra deploy --project <project-id> --branch main
 zenifra deploy watch --project <project-id> --build <build-id>
 ```
 
+## Metricas de projetos Valkey
+
+O comando `zenifra project metrics` mostra as metricas do projeto e, para projetos Valkey, o snapshot da instancia selecionada:
+
+```bash
+zenifra project metrics --project <project-id> --instance instance-1
+```
+
+A saida legivel inclui:
+
+- recursos: CPU e memoria da instancia;
+- capacidade: memoria usada, pico, limite e fragmentacao;
+- clientes conectados e bloqueados;
+- atividade: operacoes por segundo e trafego de entrada/saida;
+- ciclo de vida: chaves expiradas e removidas;
+- uptime e perfil (`cache`, `key-value` ou `queue`);
+- confiabilidade: replicacao e persistencia, quando disponiveis.
+
+Perfis especificos podem incluir:
+
+- `cache`: hits, misses e hit ratio;
+- `key-value`: total de chaves e chaves com expiracao;
+- `queue`: metricas comuns, sem estimar profundidade quando ela nao esta disponivel.
+
+Para consultar o nivel de acesso e os grupos disponiveis antes de buscar um snapshot:
+
+```bash
+zenifra project metrics capabilities --project <project-id>
+zenifra project metrics capabilities --project <project-id> --json
+```
+
+`--json` preserva a resposta publica da API. Valores ausentes sao exibidos como `indisponivel` no modo legivel; `0` continua sendo um valor valido. O historico nao esta disponivel neste momento.
+
+---
+
 ## Builds GitHub
 
 Use `zenifra builds` para listar o historico de builds e `zenifra builds logs` para ler os logs do pipeline GitHub de um build especifico.
@@ -125,7 +170,7 @@ zenifra plans --type database
 zenifra plans --type storage --json
 ```
 
-`zenifra plans` funciona sem autenticacao e mostra os catalogos publicos de HTTP, banco e armazenamento.
+`zenifra plans` funciona sem autenticacao e mostra os catalogos publicos de HTTP, banco, armazenamento e Valkey. Use `--type valkey` para consultar Key Value, Cache e Queue.
 
 Valores de variaveis de ambiente sao mascarados por padrao, inclusive em `--json`.
 Use `--show-values` apenas quando precisar inspecionar os valores completos.
@@ -193,6 +238,9 @@ Use os arquivos em `examples/` como base para `zenifra create project`:
 - `examples/http-autoscaling-project.json`: projeto HTTP pago criado com auto-scaling
 - `examples/postgresql-project.json`: projeto PostgreSQL
 - `examples/mariadb-project.json`: projeto MariaDB
+- `examples/valkey-key-value-project.json`: projeto Valkey Key Value com armazenamento persistente
+- `examples/valkey-cache-project.json`: projeto Valkey Cache sem armazenamento persistente
+- `examples/valkey-queue-project.json`: projeto Valkey Queue com armazenamento persistente
 
 Se voce rodar apenas `zenifra create project`, a CLI abre um wizard interativo estilo `npm init` e pergunta todos os campos guiados. Cada pergunta mostra:
 
@@ -205,6 +253,7 @@ O wizard atual cobre:
 - projetos `http` com origem `github` ou `oci`
 - projetos `postgresql`
 - projetos `mariadb`
+- projetos `valkey` nos perfis `key_value`, `cache` e `queue`
 
 `zenifra create project` nao assume valores default para `--plan` e `--payment-mode`.
 Configs HTTP nao interativas tambem devem informar `config.exposure`; use `public` para criar rota/dominio publico ou `private` para manter a aplicacao sem exposicao na internet.
@@ -213,9 +262,12 @@ Antes de escolher um plano com o usuario, compare os catalogos com `zenifra plan
 Valores aceitos:
 
 - `payment_mode`: `hourly`, `monthly`, `yearly`
-- `type_project` no `config`: `http`, `postgresql`, `mariadb`
+- `type_project` no `config`: `http`, `postgresql`, `mariadb`, `valkey`
 - `exposure` no `config` HTTP: `public`, `private`
-- `plan`: `free`, `static`, `basic`, `premium`, `premium_plus`, `business`, `deep_learning_basic`, `deep_learning_premium`, `db-free`, `db-starter`, `db-basic`, `db-premium`, `db-enterprise`
+- `plan`: consulte `zenifra plans` para os planos atuais; Valkey usa `db-*` para Key Value, `cache-*` para Cache e `queue-*` para Queue
+- `config.profile` em projetos Valkey: `key_value`, `cache` ou `queue`
+- `config.version` em projetos Valkey: a versão retornada por `zenifra plans --type valkey`
+- `config.storage` em projetos Valkey: obrigatório e persistente para Key Value/Queue; omitido para Cache
 - `config.github.runtime` (quando houver GitHub em projeto HTTP): `nodejs` ou `python`
 - `config.autoscaling` (somente HTTP pago): `enabled: true`, `max_instances` maior ou igual a `config.instances` e alvos opcionais de CPU/memoria entre 1 e 100
 
@@ -226,6 +278,9 @@ Observacoes do wizard:
 - na criacao com auto-scaling, `config.instances` e o minimo inicial e `config.autoscaling.max_instances` e o maximo
 - em projetos de banco, o wizard nao pergunta `username`, `password` nem `database name`
 - em projetos de banco, a CLI preenche apenas campos tecnicos minimos exigidos pela validacao atual da API
+- em projetos Valkey, a capacidade é definida pelo plano e a CLI não pergunta instâncias, imagem, variáveis de ambiente ou exposição HTTP
+- a conexão mascarada pode ser consultada a qualquer momento; a credencial completa aparece apenas na criação ou em uma rotação concluída
+- `valkey credentials rotate` retorna uma operação assíncrona; use `--wait` ou `valkey credentials status` para acompanhar
 
 ## Regressao manual de auto-scaling em staging
 

package/bin/zenifra.mjs

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 
+import { randomUUID } from 'node:crypto';
 import { mkdir, readFile, rm, writeFile, chmod } from 'node:fs/promises';
 import { existsSync } from 'node:fs';
 import { dirname, join } from 'node:path';
@@ -13,6 +14,7 @@ const DOCS_RUNTIME_URL = `${DOCS_BASE_URL}/docs/runtime`;
 const DOCS_CREATE_HTTP_URL = `${DOCS_BASE_URL}/docs/how-use-zenifra/http/how-to-create-a-http-project-at-zenifra-via-console`;
 const DOCS_CREATE_POSTGRESQL_URL = `${DOCS_BASE_URL}/docs/how-use-zenifra/database/how-to-create-a-postgresql-project-at-zenifra-via-console`;
 const DOCS_CREATE_MARIADB_URL = `${DOCS_BASE_URL}/docs/how-use-zenifra/database/how-to-create-a-mariadb-project-at-zenifra-via-console`;
+const DOCS_CREATE_VALKEY_URL = `${DOCS_BASE_URL}/docs/managed-services/valkey`;
 const DOCS_CONFIGURATION_URL = `${DOCS_BASE_URL}/docs/configuration`;
 const DOCS_DATABASE_CONFIGURATION_URL = `${DOCS_BASE_URL}/docs/database/configuration/configuration`;
 const DOCS_PAYMENTS_URL = `${DOCS_BASE_URL}/docs/payments/payments`;
@@ -41,6 +43,7 @@ const KNOWN_FLAG_NAMES = new Set([
   'from',
   'help',
   'image',
+  'idempotencyKey',
   'instance',
   'interval',
   'json',
@@ -52,6 +55,7 @@ const KNOWN_FLAG_NAMES = new Set([
   'mode',
   'name',
   'org',
+  'operation',
   'page',
   'password',
   'paymentMode',
@@ -67,6 +71,7 @@ const KNOWN_FLAG_NAMES = new Set([
   'type',
   'value',
   'view',
+  'wait',
 ]);
 const ALLOWED_PLAN_VALUES = new Set([
   'free',
@@ -82,9 +87,19 @@ const ALLOWED_PLAN_VALUES = new Set([
   'db-basic',
   'db-premium',
   'db-enterprise',
+  'cache-free',
+  'cache-starter',
+  'cache-basic',
+  'cache-premium',
+  'cache-enterprise',
+  'queue-free',
+  'queue-starter',
+  'queue-basic',
+  'queue-premium',
+  'queue-enterprise',
 ]);
 const ALLOWED_PAYMENT_MODE_VALUES = new Set(['hourly', 'monthly', 'yearly']);
-const ALLOWED_TYPE_PROJECT_VALUES = new Set(['http', 'postgresql', 'mariadb']);
+const ALLOWED_TYPE_PROJECT_VALUES = new Set(['http', 'postgresql', 'mariadb', 'valkey']);
 const ALLOWED_RUNTIME_VALUES = new Set(['nodejs', 'python']);
 const ALLOWED_EXPOSURE_VALUES = new Set(['public', 'private']);
 const GITHUB_RUNTIME_VERSIONS = {
@@ -115,7 +130,8 @@ const WIZARD_DATABASE_PLAN_OPTIONS = [
   'db-free',
 ];
 const WIZARD_PAYMENT_MODE_OPTIONS = ['hourly', 'monthly', 'yearly'];
-const WIZARD_TYPE_PROJECT_OPTIONS = ['http', 'postgresql', 'mariadb'];
+const WIZARD_TYPE_PROJECT_OPTIONS = ['http', 'postgresql', 'mariadb', 'valkey'];
+const WIZARD_VALKEY_PROFILE_OPTIONS = ['key_value', 'cache', 'queue'];
 const WIZARD_HTTP_EXPOSURE_OPTIONS = ['public', 'private'];
 let promptInterface;
 let pipedInputPromise;
@@ -153,14 +169,19 @@ Usage:
   zenifra profile remove <name> [--json]
   zenifra orgs [--json]
   zenifra org set [--org <id>]
-  zenifra plans [--type <all|http|database|storage>] [--json]
+  zenifra plans [--type <all|http|database|storage|valkey>] [--json]
   zenifra create project
   zenifra create project --name <name> --plan <plan> --payment-mode <mode> --config <json|@file> [--description <text>] [--org <id>] [--json]
-  zenifra projects [--json] [--org <id>] [--type <http|postgresql|mariadb>] [--page <n>] [--limit <n>]
+  zenifra projects [--json] [--org <id>] [--type <http|postgresql|mariadb|valkey>] [--page <n>] [--limit <n>]
+  zenifra valkey status --project <id> [--json]
+  zenifra valkey connection --project <id> [--json]
+  zenifra valkey credentials rotate --project <id> [--idempotency-key <key>] [--wait] [--interval <seconds>] [--timeout <seconds>] [--json]
+  zenifra valkey credentials status --project <id> --operation <id> [--json]
   zenifra project info --project <id> [--json]
   zenifra project url --project <id> [--json]
   zenifra project logs --project <id> [--instance <id>] [--json]
   zenifra project metrics --project <id> [--instance <id>] [--json]
+  zenifra project metrics capabilities --project <id> [--json]
   zenifra project network --project <id> [--view <summary|status-codes|routes|user-agents|request-events|source-ips>] [--json]
   zenifra project image set --project <id> --image <image> [--json]
   zenifra project exposure set --project <id> --exposure <public|private> [--json]
@@ -319,16 +340,65 @@ const HELP_SPECS = [
   },
   {
     command: 'plans',
-    usage: 'zenifra plans [--type <all|http|database|storage>] [--json]',
-    description: 'Lista os catalogos publicos de preco de planos HTTP, banco e armazenamento.',
-    flags: ['--type <type>  Filtra o catalogo: all, http, database ou storage.', '--json         Imprime a resposta em JSON.'],
-    examples: ['zenifra plans', 'zenifra plans --type http', 'zenifra plans --type storage --json'],
+    usage: 'zenifra plans [--type <all|http|database|storage|valkey>] [--json]',
+    description: 'Lista os catalogos publicos de preco de planos HTTP, banco, armazenamento e Valkey.',
+    flags: ['--type <type>  Filtra o catalogo: all, http, database, storage, valkey, key-value, cache ou queue.', '--json         Imprime a resposta em JSON.'],
+    examples: ['zenifra plans', 'zenifra plans --type http', 'zenifra plans --type valkey --json'],
     output: 'HTTP\nPlano  Hora     Mes      Ano      Recursos\nfree   R$ 0,00  R$ 0,00  R$ 0,00  1 GB Armazenamento Efemero',
     jsonOutput: '{"http":[{"plan":"free","prices":{"hourly":0,"monthly":0,"yearly":0},"features":["1 GB Armazenamento Efemero"]}],"database":[],"storage":[]}',
   },
+  {
+    command: 'valkey',
+    usage: 'zenifra valkey\n  zenifra valkey status --project <id> [--json]\n  zenifra valkey connection --project <id> [--json]\n  zenifra valkey credentials rotate --project <id> [--idempotency-key <key>] [--wait] [--interval <seconds>] [--timeout <seconds>] [--json]\n  zenifra valkey credentials status --project <id> --operation <id> [--json]',
+    description: 'Consulta projetos Valkey e gerencia suas conexoes e credenciais.',
+    examples: ['zenifra valkey status --project proj_1', 'zenifra valkey connection --project proj_1', 'zenifra valkey credentials rotate --project proj_1 --wait'],
+    output: 'Zenifra CLI - valkey',
+    notes: ['A string de conexao completa aparece somente quando uma criacao ou rotacao a disponibiliza.'],
+  },
+  {
+    command: 'valkey status',
+    usage: 'zenifra valkey status --project <id> [--json]',
+    description: 'Mostra estado, perfil, versao e persistencia de um projeto Valkey.',
+    flags: ['--project <id>  ID do projeto.', '--json          Imprime a resposta em JSON.'],
+    examples: ['zenifra valkey status --project proj_1'],
+    output: 'Status     Perfil  Versao  Persistente  Instancias\nrunning    cache   9.1.1   nao           1',
+  },
+  {
+    command: 'valkey connection',
+    usage: 'zenifra valkey connection --project <id> [--json]',
+    description: 'Mostra os dados de conexao de um projeto Valkey sem revelar a credencial.',
+    flags: ['--project <id>  ID do projeto.', '--json          Imprime a resposta em JSON.'],
+    examples: ['zenifra valkey connection --project proj_1'],
+    output: 'Host                 Porta  TLS  Conexao\nvalkey.example.com   6380   sim  valkeys://default:********@valkey.example.com:6380/0',
+    notes: ['Use a credencial recebida na criacao ou em uma rotacao concluida.'],
+  },
+  {
+    command: 'valkey credentials',
+    usage: 'zenifra valkey credentials\n  zenifra valkey credentials rotate --project <id> [--idempotency-key <key>] [--wait] [--interval <seconds>] [--timeout <seconds>] [--json]\n  zenifra valkey credentials status --project <id> --operation <id> [--json]',
+    description: 'Agrupa comandos de renovacao e acompanhamento de credenciais Valkey.',
+    examples: ['zenifra valkey credentials rotate --project proj_1', 'zenifra valkey credentials status --project proj_1 --operation operation_1'],
+    output: 'Zenifra CLI - valkey credentials',
+  },
+  {
+    command: 'valkey credentials rotate',
+    usage: 'zenifra valkey credentials rotate --project <id> [--idempotency-key <key>] [--wait] [--interval <seconds>] [--timeout <seconds>] [--json]',
+    description: 'Solicita a renovacao da credencial e retorna uma operacao acompanhavel.',
+    flags: ['--project <id>          ID do projeto.', '--idempotency-key <key> Chave para repetir a mesma solicitacao.', '--wait                  Aguarda a conclusao.', '--interval <seconds>    Intervalo do polling. Padrao: 2.', '--timeout <seconds>     Timeout total. Padrao: 900.', '--json                  Imprime a resposta em JSON.'],
+    examples: ['zenifra valkey credentials rotate --project proj_1', 'zenifra valkey credentials rotate --project proj_1 --wait --timeout 120'],
+    output: 'Operacao aceita: rotation_123\nEstado: accepted',
+    notes: ['Salve a nova string de conexao quando a operacao atingir completed.'],
+  },
+  {
+    command: 'valkey credentials status',
+    usage: 'zenifra valkey credentials status --project <id> --operation <id> [--json]',
+    description: 'Consulta o estado de uma renovacao de credencial Valkey.',
+    flags: ['--project <id>     ID do projeto.', '--operation <id>   ID da operacao.', '--json             Imprime a resposta em JSON.'],
+    examples: ['zenifra valkey credentials status --project proj_1 --operation rotation_123'],
+    output: 'Operacao: rotation_123\nEstado: completed',
+  },
   {
     command: 'projects',
-    usage: 'zenifra projects [--json] [--org <id>] [--type <http|postgresql|mariadb>] [--page <n>] [--limit <n>]',
+    usage: 'zenifra projects [--json] [--org <id>] [--type <http|postgresql|mariadb|valkey>] [--page <n>] [--limit <n>]',
     description: 'Lista projetos da organizacao ativa ou da API key.',
     flags: ['--json       Imprime a resposta em JSON.', '--org <id>   Usa uma organizacao especifica com sessao de usuario.', '--type <type> Filtra por tipo de projeto.', '--page <n>   Pagina. Padrao: 1.', '--limit <n>  Itens por pagina. Padrao: 15.'],
     examples: ['zenifra projects --type http --page 1 --limit 15', 'zenifra projects --json'],
@@ -337,9 +407,9 @@ const HELP_SPECS = [
   },
   {
     command: 'create project',
-    usage: 'zenifra create project\n  zenifra create project --name <name> --plan <plan> --payment-mode <mode> --config <json|@file> [--description <text>] [--org <id>] [--json]',
+    usage: 'zenifra create project\n  zenifra create project --name <name> --plan <plan> --payment-mode <mode> --config <json|@file> [--description <text>] [--idempotency-key <key>] [--org <id>] [--json]',
     description: 'Cria um projeto via wizard interativo ou via payload de configuracao JSON.',
-    flags: ['--name <name>          Nome do projeto.', '--plan <plan>          Plano do projeto.', '--payment-mode <mode>  Modo de pagamento.', '--config <json|@file>  JSON inline ou arquivo.', '--description <text>   Descricao opcional.', '--json                 Imprime a resposta em JSON.'],
+    flags: ['--name <name>             Nome do projeto.', '--plan <plan>             Plano do projeto.', '--payment-mode <mode>     Modo de pagamento.', '--config <json|@file>     JSON inline ou arquivo.', '--description <text>      Descricao opcional.', '--idempotency-key <key>   Chave para repetir a mesma criacao com seguranca.', '--json                    Imprime a resposta em JSON.'],
     examples: ['zenifra create project', 'zenifra create project --name api-web --plan free --payment-mode hourly --config @examples/http-project.json'],
     output: 'Campo    Valor\n-------  --------------------------------------\nProjeto  507f1f77bcf86cd799439012\nDominio  https://api-web.client.zenifra.com',
     jsonOutput: '{"status":"success","data":{"id":"507f1f77bcf86cd799439012","name":"api-web"}}',
@@ -347,11 +417,11 @@ const HELP_SPECS = [
   },
   {
     command: 'project',
-    usage: 'zenifra project\n  zenifra project info --project <id> [--json]\n  zenifra project url --project <id> [--json]\n  zenifra project logs --project <id> [--instance <id>] [--json]\n  zenifra project metrics --project <id> [--instance <id>] [--json]\n  zenifra project network --project <id> [--view <summary|status-codes|routes|user-agents|request-events|source-ips>] [--json]\n  zenifra project image set --project <id> --image <image> [--json]\n  zenifra project exposure set --project <id> --exposure <public|private> [--json]\n  zenifra project envs --project <id> [--json] [--show-values]\n  zenifra project env add --project <id> --name <name> --value <value> [--json]\n  zenifra project env update --project <id> --name <name> --value <value> [--json]\n  zenifra project env remove --project <id> --name <name> [--json]\n  zenifra project autoscaling --project <id> [--json]\n  zenifra project autoscaling set --project <id> --min <n> --max <n> [--cpu <percent>] [--memory <percent>] [--json]\n  zenifra project autoscaling disable --project <id> [--json]\n  zenifra project autoscaling events --project <id> [--direction <scale_up|scale_down>] [--from <iso>] [--to <iso>] [--page <n>] [--limit <n>] [--json]\n  zenifra project billing usage --project <id> [--from <iso>] [--to <iso>] [--page <n>] [--limit <n>] [--json]\n  zenifra project instances --project <id> [--json]\n  zenifra project instances set --project <id> --count <n> [--json]',
+    usage: 'zenifra project\n  zenifra project info --project <id> [--json]\n  zenifra project url --project <id> [--json]\n  zenifra project logs --project <id> [--instance <id>] [--json]\n  zenifra project metrics --project <id> [--instance <id>] [--json]\n  zenifra project metrics capabilities --project <id> [--json]\n  zenifra project network --project <id> [--view <summary|status-codes|routes|user-agents|request-events|source-ips>] [--json]\n  zenifra project image set --project <id> --image <image> [--json]\n  zenifra project exposure set --project <id> --exposure <public|private> [--json]\n  zenifra project envs --project <id> [--json] [--show-values]\n  zenifra project env add --project <id> --name <name> --value <value> [--json]\n  zenifra project env update --project <id> --name <name> --value <value> [--json]\n  zenifra project env remove --project <id> --name <name> [--json]\n  zenifra project autoscaling --project <id> [--json]\n  zenifra project autoscaling set --project <id> --min <n> --max <n> [--cpu <percent>] [--memory <percent>] [--json]\n  zenifra project autoscaling disable --project <id> [--json]\n  zenifra project autoscaling events --project <id> [--direction <scale_up|scale_down>] [--from <iso>] [--to <iso>] [--page <n>] [--limit <n>] [--json]\n  zenifra project billing usage --project <id> [--from <iso>] [--to <iso>] [--page <n>] [--limit <n>] [--json]\n  zenifra project instances --project <id> [--json]\n  zenifra project instances set --project <id> --count <n> [--json]',
     description: 'Agrupa comandos operacionais e de introspecao sobre um projeto especifico.',
     examples: ['zenifra project', 'zenifra project info --project proj_1', 'zenifra project env add --project proj_1 --name NODE_ENV --value production'],
     output: 'Zenifra CLI - project',
-    notes: ['Use "zenifra help project <subcomando>" para detalhes de info, url, logs, metrics, network, image, exposure, autoscaling, billing, envs e instances.'],
+    notes: ['Use "zenifra help project <subcomando>" para detalhes de info, url, logs, metrics, capabilities, network, image, exposure, autoscaling, billing, envs e instances.'],
   },
   {
     command: 'project info',
@@ -384,11 +454,26 @@ const HELP_SPECS = [
   {
     command: 'project metrics',
     usage: 'zenifra project metrics --project <id> [--instance <id>] [--json]',
-    description: 'Mostra CPU, memoria e dados basicos de rede do projeto.',
-    flags: ['--project <id>   ID do projeto.', '--instance <id>  Filtra uma instancia.', '--json           Imprime a resposta em JSON.'],
-    examples: ['zenifra project metrics --project 507f1f77bcf86cd799439012 --instance web-1'],
-    output: 'Instancia  Tipo         CPU  Memoria\nweb-1      application  0.2  64',
-    jsonOutput: '{"type":"application","instance":"web-1","cpu":0.2,"memory":64,"network":{"requests":120}}',
+    description: 'Mostra metricas de recursos do projeto e, para Valkey, o snapshot nativo da instancia.',
+    flags: ['--project <id>   ID do projeto.', '--instance <id>  Filtra uma instancia.', '--json           Imprime a resposta em JSON sem formatacao adicional.'],
+    examples: ['zenifra project metrics --project 507f1f77bcf86cd799439012 --instance web-1', 'zenifra project metrics --project 507f1f77bcf86cd799439012 --instance instance-1'],
+    output: 'Campo       Valor\n----------  ----------------\nPerfil      cache\nDisponibilidade  available\nMemoria usada    100 MB',
+    jsonOutput: '{"instance":"instance-1","type":"valkey","availability":"available","valkey":{"schema_version":1,"profile":"cache","memory":{"used_bytes":104857600}}}',
+    notes: [
+      'Para projetos Valkey, a saida legivel inclui recursos, capacidade, clientes, atividade, ciclo de vida de chaves, perfil e confiabilidade.',
+      'Valores ausentes sao exibidos como indisponivel; zero continua sendo um valor valido.',
+      'Use "zenifra project metrics capabilities --project <id>" para consultar o acesso e os grupos de metricas disponiveis.',
+    ],
+  },
+  {
+    command: 'project metrics capabilities',
+    usage: 'zenifra project metrics capabilities --project <id> [--json]',
+    description: 'Mostra os grupos de metricas e o nivel de acesso disponivel para o projeto.',
+    flags: ['--project <id>  ID do projeto.', '--json          Imprime a resposta em JSON.'],
+    examples: ['zenifra project metrics capabilities --project 507f1f77bcf86cd799439012'],
+    output: 'Campo       Valor\n----------  ------------------------------------------------------------\nAcesso      snapshot\nAtualizacao 60 s\nHistorico   indisponivel',
+    jsonOutput: '{"access":"snapshot","groups":["resources","capacity","clients","activity","key_lifecycle","profile","reliability"],"refresh_seconds":60,"history":null}',
+    notes: ['A API permanece como fonte de autorizacao. A CLI nao mantem uma lista local de planos.'],
   },
   {
     command: 'project network',
@@ -654,7 +739,7 @@ function removedProjectsCreateMessage() {
 }
 
 function isNamespaceCommand(command) {
-  return ['auth', 'profile', 'project', 'org'].includes(command);
+  return ['auth', 'profile', 'project', 'org', 'valkey'].includes(command);
 }
 
 function parseArgs(argv) {
@@ -1029,6 +1114,11 @@ function estimateWizardTotal(state = {}) {
     return total;
   }
 
+  if (typeProject === 'valkey') {
+    total += 3;
+    return total;
+  }
+
   return 18;
 }
 
@@ -1346,6 +1436,7 @@ async function request(session, flags, method, path, {
   orgId,
   tokenRequired = true,
   credential: credentialOverride,
+  headers: extraHeaders = {},
 } = {}) {
   const credential = credentialOverride || resolveCredential(session);
   if (tokenRequired && !credential) {
@@ -1356,6 +1447,14 @@ async function request(session, flags, method, path, {
   if (body !== undefined) {
     headers['Content-Type'] = 'application/json';
   }
+  for (const [name, value] of Object.entries(extraHeaders)) {
+    if (value === undefined) continue;
+    const normalizedName = name.toLowerCase();
+    if (['authorization', 'x-organization-id', 'content-type'].includes(normalizedName)) {
+      throw new CliError(`Header nao permitido: ${name}.`);
+    }
+    headers[name] = String(value);
+  }
   if (credential?.token) {
     headers.Authorization = `Bearer ${credential.token}`;
   }
@@ -1403,6 +1502,9 @@ async function request(session, flags, method, path, {
     if (response.status === 429 && Number.isFinite(Number(payload?.retry_after_seconds))) {
       throw new CliError(`${message} Tente novamente em ${Number(payload.retry_after_seconds)} segundo(s).`);
     }
+    if (response.status === 402 && path.includes('/metrics') && /support metrics/i.test(String(message))) {
+      throw new CliError('Este projeto nao possui acesso a metricas.');
+    }
     if (String(message).includes('missing x-organization-id')) {
       throw new CliError('Organizacao nao selecionada. Rode "zenifra org set" ou use --org <id>.');
     }
@@ -1443,6 +1545,128 @@ function printTable(rows, columns) {
   }
 }
 
+function formatValkeyNumber(value) {
+  if (value === null || value === undefined || !Number.isFinite(Number(value))) return 'indisponivel';
+  return String(value);
+}
+
+function formatValkeyBytes(value, suffix = '') {
+  if (value === null || value === undefined || !Number.isFinite(Number(value))) return 'indisponivel';
+
+  const numericValue = Number(value);
+  const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+  let unitIndex = 0;
+  let normalizedValue = numericValue;
+  while (normalizedValue >= 1024 && unitIndex < units.length - 1) {
+    normalizedValue /= 1024;
+    unitIndex += 1;
+  }
+
+  const digits = normalizedValue >= 100 ? 0 : normalizedValue >= 10 ? 1 : 2;
+  const formattedValue = Number(normalizedValue.toFixed(digits)).toString();
+  return `${formattedValue} ${units[unitIndex]}${suffix}`;
+}
+
+function formatValkeyPercent(value) {
+  if (value === null || value === undefined || !Number.isFinite(Number(value))) return 'indisponivel';
+  return `${Number((Number(value) * 100).toFixed(2))}%`;
+}
+
+function valkeyMetricRows(metrics) {
+  const native = metrics?.valkey;
+  const rows = [
+    { field: 'Instancia', value: metrics?.instance || '-' },
+    { field: 'Disponibilidade', value: metrics?.availability || 'indisponivel' },
+    { field: 'Observado em', value: metrics?.observed_at || 'indisponivel' },
+    { field: 'CPU', value: formatValkeyNumber(metrics?.cpu) },
+    { field: 'Memoria', value: formatValkeyBytes(metrics?.memory) },
+  ];
+
+  if (!native) {
+    rows.push({ field: 'Metricas Valkey', value: 'indisponivel' });
+    return rows;
+  }
+
+  rows.push(
+    { field: 'Perfil', value: native.profile || '-' },
+    { field: 'Memoria usada', value: formatValkeyBytes(native.memory?.used_bytes) },
+    { field: 'Pico de memoria', value: formatValkeyBytes(native.memory?.peak_bytes) },
+    { field: 'Limite de memoria', value: formatValkeyBytes(native.memory?.limit_bytes) },
+    { field: 'Fragmentacao', value: formatValkeyNumber(native.memory?.fragmentation_ratio) },
+    { field: 'Clientes conectados', value: formatValkeyNumber(native.clients?.connected) },
+    { field: 'Clientes bloqueados', value: formatValkeyNumber(native.clients?.blocked) },
+    { field: 'Operacoes por segundo', value: formatValkeyNumber(native.activity?.operations_per_second) },
+    { field: 'Entrada', value: formatValkeyBytes(native.activity?.input_bytes_per_second, '/s') },
+    { field: 'Saida', value: formatValkeyBytes(native.activity?.output_bytes_per_second, '/s') },
+    { field: 'Chaves expiradas', value: formatValkeyNumber(native.keys?.expired_total) },
+    { field: 'Chaves removidas', value: formatValkeyNumber(native.keys?.evicted_total) },
+    { field: 'Uptime', value: `${formatValkeyNumber(native.uptime_seconds)} s` },
+  );
+
+  if (native.cache) {
+    rows.push(
+      { field: 'Cache hits', value: formatValkeyNumber(native.cache.hits_total) },
+      { field: 'Cache misses', value: formatValkeyNumber(native.cache.misses_total) },
+      { field: 'Hit ratio', value: formatValkeyPercent(native.cache.hit_ratio) },
+    );
+  }
+
+  if (native.key_value) {
+    rows.push(
+      { field: 'Total de chaves', value: formatValkeyNumber(native.key_value.keys_total) },
+      { field: 'Chaves com expiracao', value: formatValkeyNumber(native.key_value.keys_with_expiration) },
+    );
+  }
+
+  if (native.reliability) {
+    const replication = native.reliability.replication;
+    const persistence = native.reliability.persistence;
+    if (replication) {
+      rows.push(
+        { field: 'Replicacao', value: replication.status || 'indisponivel' },
+        { field: 'Repl. disponiveis', value: formatValkeyNumber(replication.replicas_available) },
+        { field: 'Repl. esperadas', value: formatValkeyNumber(replication.replicas_expected) },
+        { field: 'Lag', value: replication.lag_seconds === null || replication.lag_seconds === undefined ? 'indisponivel' : `${replication.lag_seconds} s` },
+      );
+    }
+    if (persistence) {
+      rows.push(
+        { field: 'Persistencia', value: persistence.status || 'indisponivel' },
+        { field: 'Persistencia ativa', value: persistence.enabled === null || persistence.enabled === undefined ? 'indisponivel' : persistence.enabled ? 'sim' : 'nao' },
+        { field: 'Ultimo sucesso', value: persistence.last_success_at || 'indisponivel' },
+      );
+    }
+  }
+
+  return rows;
+}
+
+function printValkeyMetrics(metrics) {
+  printTable(valkeyMetricRows(metrics), [
+    { label: 'Campo', value: (row) => row.field },
+    { label: 'Valor', value: (row) => row.value },
+  ]);
+}
+
+function printMetricsCapabilities(capabilities) {
+  const groups = Array.isArray(capabilities?.groups) && capabilities.groups.length > 0
+    ? capabilities.groups.join(', ')
+    : 'nenhum';
+  const history = capabilities?.history
+    ? `${capabilities.history.retention_seconds} s de retencao`
+    : 'indisponivel';
+
+  printTable([
+    { field: 'Acesso', value: capabilities?.access || 'indisponivel' },
+    { field: 'Grupos', value: groups },
+    { field: 'Atualizacao', value: capabilities?.refresh_seconds === null || capabilities?.refresh_seconds === undefined ? 'indisponivel' : `${capabilities.refresh_seconds} s` },
+    { field: 'Historico', value: history },
+  ], [
+    { label: 'Campo', value: (row) => row.field },
+    { label: 'Valor', value: (row) => row.value },
+  ]);
+}
+
 function asArray(value) {
   if (Array.isArray(value)) return value;
   if (Array.isArray(value?.projects)) return value.projects;
@@ -1508,20 +1732,33 @@ function printEnvs(envs, flags) {
 }
 
 function printProject(project) {
-  const url = projectUrlOf(project);
+  const managedService = project.managed_service;
+  const isValkey = project.type_project === 'valkey' || managedService?.engine === 'valkey';
   const rows = [
     { label: 'ID', value: projectIdOf(project) || '-' },
     { label: 'Nome', value: project.name || '-' },
     { label: 'Status', value: project.status || '-' },
     { label: 'Tipo', value: project.type_project || '-' },
-    { label: 'Exposicao', value: project.exposure || '-' },
     { label: 'Plano', value: project.plan || '-' },
-    { label: 'URL', value: url || '-' },
-    { label: 'Imagem', value: project.image || '-' },
-    { label: 'Instancias', value: project.instances ?? '-' },
-    { label: 'Instancias atuais', value: project.additional_info?.current_instances ?? '-' },
   ];
 
+  if (isValkey) {
+    rows.push(
+      { label: 'Perfil', value: managedService?.profile || '-' },
+      { label: 'Versao', value: managedService?.version || '-' },
+      { label: 'Persistente', value: managedService?.topology?.persistent === true ? 'sim' : 'nao' },
+      { label: 'Instancias', value: project.instances ?? '-' },
+    );
+  } else {
+    rows.push(
+      { label: 'Exposicao', value: project.exposure || '-' },
+      { label: 'URL', value: projectUrlOf(project) || '-' },
+      { label: 'Imagem', value: project.image || '-' },
+      { label: 'Instancias', value: project.instances ?? '-' },
+      { label: 'Instancias atuais', value: project.additional_info?.current_instances ?? '-' },
+    );
+  }
+
   for (const row of rows) {
     process.stdout.write(`${row.label}: ${row.value}\n`);
   }
@@ -1937,6 +2174,26 @@ function normalizePlan(value) {
     ['dbpremium', 'db-premium'],
     ['db_enterprise', 'db-enterprise'],
     ['dbenterprise', 'db-enterprise'],
+    ['cache_free', 'cache-free'],
+    ['cachefree', 'cache-free'],
+    ['cache_starter', 'cache-starter'],
+    ['cachestarter', 'cache-starter'],
+    ['cache_basic', 'cache-basic'],
+    ['cachebasic', 'cache-basic'],
+    ['cache_premium', 'cache-premium'],
+    ['cachepremium', 'cache-premium'],
+    ['cache_enterprise', 'cache-enterprise'],
+    ['cacheenterprise', 'cache-enterprise'],
+    ['queue_free', 'queue-free'],
+    ['queuefree', 'queue-free'],
+    ['queue_starter', 'queue-starter'],
+    ['queuestarter', 'queue-starter'],
+    ['queue_basic', 'queue-basic'],
+    ['queuebasic', 'queue-basic'],
+    ['queue_premium', 'queue-premium'],
+    ['queuepremium', 'queue-premium'],
+    ['queue_enterprise', 'queue-enterprise'],
+    ['queueenterprise', 'queue-enterprise'],
   ]);
 
   if (aliases.has(normalized)) return aliases.get(normalized);
@@ -1973,6 +2230,21 @@ function normalizeTypeProject(value) {
     ['postgresql', 'postgresql'],
     ['mariadb', 'mariadb'],
     ['maria db', 'mariadb'],
+    ['valkey', 'valkey'],
+    ['key value', 'valkey'],
+    ['key-value', 'valkey'],
+  ]);
+  return aliases.get(raw) || raw;
+}
+
+function normalizeValkeyProfile(value) {
+  const raw = normalizeFreeText(value);
+  const aliases = new Map([
+    ['key_value', 'key_value'],
+    ['key value', 'key_value'],
+    ['key-value', 'key_value'],
+    ['cache', 'cache'],
+    ['queue', 'queue'],
   ]);
   return aliases.get(raw) || raw;
 }
@@ -2075,7 +2347,6 @@ async function fetchWizardCatalogs(session, flags) {
     unwrapData(await request(session, flags, 'GET', '/project/database/plans')),
     'os planos de banco',
   );
-
   return { httpPlans, availableInstances, databasePlans };
 }
 
@@ -2084,6 +2355,10 @@ function normalizePlansCatalogType(value) {
   if (!normalized || normalized === 'all') return 'all';
   if (normalized === 'http') return 'http';
   if (['database', 'db', 'postgresql', 'mariadb'].includes(normalized)) return 'database';
+  if (normalized === 'valkey') return 'valkey';
+  if (normalized === 'key-value' || normalized === 'key value' || normalized === 'key_value') return 'valkey-key_value';
+  if (normalized === 'cache') return 'valkey-cache';
+  if (normalized === 'queue') return 'valkey-queue';
   if (normalized === 'storage') return 'storage';
   return null;
 }
@@ -2096,6 +2371,11 @@ function formatBrl(value) {
   }).format(Number.isFinite(number) ? number : 0);
 }
 
+function formatBrlFromCents(value) {
+  const number = Number(value ?? 0);
+  return formatBrl(Number.isFinite(number) ? number / 100 : 0);
+}
+
 function humanizeStorageName(value) {
   const raw = String(value || '').trim();
   if (!raw) return { storage: '-', type: '-' };
@@ -2116,6 +2396,49 @@ function humanizeStorageName(value) {
   return { storage: raw, type: '-' };
 }
 
+const VALKEY_PROFILE_LABELS = {
+  key_value: 'Key Value',
+  cache: 'Cache',
+  queue: 'Queue',
+};
+
+function requireValkeyCatalog(value) {
+  if (!value || typeof value !== 'object' || Array.isArray(value)
+    || value.engine !== 'valkey'
+    || typeof value.version !== 'string'
+    || typeof value.currency !== 'string'
+    || !Array.isArray(value.profiles)
+    || !Array.isArray(value.plans)
+    || value.profiles.length === 0
+    || value.plans.length === 0) {
+    throw new CliError('Falha ao carregar o catalogo Valkey. Tente novamente mais tarde.');
+  }
+
+  const validProfiles = new Set(Object.keys(VALKEY_PROFILE_LABELS));
+  if (value.profiles.some((profile) => !validProfiles.has(profile?.id) || typeof profile.persistence !== 'boolean')) {
+    throw new CliError('Falha ao carregar o catalogo Valkey. Tente novamente mais tarde.');
+  }
+  if (value.plans.some((plan) => !validProfiles.has(plan?.profile) || typeof plan.id !== 'string' || !plan.prices || typeof plan.prices !== 'object')) {
+    throw new CliError('Falha ao carregar o catalogo Valkey. Tente novamente mais tarde.');
+  }
+
+  return value;
+}
+
+function valkeyProfileFilter(type) {
+  if (!type.startsWith('valkey-')) return null;
+  return type.slice('valkey-'.length);
+}
+
+function filterValkeyCatalog(catalog, profile) {
+  if (!profile) return catalog;
+  return {
+    ...catalog,
+    profiles: catalog.profiles.filter((entry) => entry.id === profile),
+    plans: catalog.plans.filter((plan) => plan.profile === profile),
+  };
+}
+
 async function fetchPlansCatalogs(session, flags, type) {
   if (type === 'http') {
     return {
@@ -2150,27 +2473,59 @@ async function fetchPlansCatalogs(session, flags, type) {
     };
   }
 
-  const [httpPayload, databasePayload, storagePayload] = await Promise.all([
+  if (type === 'valkey' || type.startsWith('valkey-')) {
+    const catalog = requireValkeyCatalog(
+      unwrapData(await request(session, flags, 'GET', '/managed-services/catalog', { tokenRequired: false })),
+    );
+    return {
+      http: [],
+      database: [],
+      storage: [],
+      valkey: filterValkeyCatalog(catalog, valkeyProfileFilter(type)),
+    };
+  }
+
+  const [httpPayload, databasePayload, storagePayload, valkeyPayload] = await Promise.all([
     request(session, flags, 'GET', '/project/plans', { tokenRequired: false }),
     request(session, flags, 'GET', '/project/database/plans', { tokenRequired: false }),
     request(session, flags, 'GET', '/project/storage/plans', { tokenRequired: false }),
+    request(session, flags, 'GET', '/managed-services/catalog', { tokenRequired: false }),
   ]);
 
   return {
     http: requireWizardCatalogArray(unwrapData(httpPayload), 'os planos HTTP'),
     database: requireWizardCatalogArray(unwrapData(databasePayload), 'os planos de banco'),
     storage: requireWizardCatalogArray(unwrapData(storagePayload), 'os planos de storage'),
+    valkey: requireValkeyCatalog(unwrapData(valkeyPayload)),
   };
 }
 
+function printValkeyCatalog(catalog, profileFilter) {
+  const profiles = profileFilter ? [profileFilter] : Object.keys(VALKEY_PROFILE_LABELS);
+  profiles.forEach((profile, index) => {
+    if (index > 0) process.stdout.write('\n');
+    process.stdout.write(`${VALKEY_PROFILE_LABELS[profile]}\n`);
+    const plans = catalog.plans.filter((plan) => plan.profile === profile);
+    printTable(plans, [
+      { label: 'Plano', value: (plan) => plan.id || '-' },
+      { label: 'Hora', value: (plan) => formatBrl(plan.prices?.hourly, catalog.currency) },
+      { label: 'Mes', value: (plan) => formatBrl(plan.prices?.monthly, catalog.currency) },
+      { label: 'Ano', value: (plan) => formatBrl(plan.prices?.yearly, catalog.currency) },
+      { label: 'Capacidade', value: (plan) => `${plan.resources?.cpu || '-'} / ${plan.resources?.memory || '-'}` },
+      { label: 'Storage incluído', value: (plan) => `${plan.included_storage_gb ?? 0} GB` },
+      { label: 'Alta disponibilidade', value: (plan) => plan.high_availability?.[profile] ? 'sim' : 'nao' },
+    ]);
+  });
+}
+
 function printPlansCatalogs(payload, type) {
   if (type === 'all' || type === 'http') {
     process.stdout.write('HTTP\n');
     printTable(asArray(payload.http), [
       { label: 'Plano', value: (plan) => plan.plan || '-' },
-      { label: 'Hora', value: (plan) => formatBrl(plan.prices?.hourly) },
-      { label: 'Mes', value: (plan) => formatBrl(plan.prices?.monthly) },
-      { label: 'Ano', value: (plan) => formatBrl(plan.prices?.yearly) },
+      { label: 'Hora', value: (plan) => formatBrlFromCents(plan.prices?.hourly) },
+      { label: 'Mes', value: (plan) => formatBrlFromCents(plan.prices?.monthly) },
+      { label: 'Ano', value: (plan) => formatBrlFromCents(plan.prices?.yearly) },
       { label: 'Recursos', value: (plan) => asArray(plan.features).join(', ') || '-' },
     ]);
   }
@@ -2180,9 +2535,9 @@ function printPlansCatalogs(payload, type) {
     process.stdout.write('PostgreSQL / MariaDB\n');
     printTable(asArray(payload.database), [
       { label: 'Plano', value: (plan) => plan.plan || '-' },
-      { label: 'Hora', value: (plan) => formatBrl(plan.prices?.hourly) },
-      { label: 'Mes', value: (plan) => formatBrl(plan.prices?.monthly) },
-      { label: 'Ano', value: (plan) => formatBrl(plan.prices?.yearly) },
+      { label: 'Hora', value: (plan) => formatBrlFromCents(plan.prices?.hourly) },
+      { label: 'Mes', value: (plan) => formatBrlFromCents(plan.prices?.monthly) },
+      { label: 'Ano', value: (plan) => formatBrlFromCents(plan.prices?.yearly) },
       { label: 'Recursos', value: (plan) => asArray(plan.features).join(', ') || '-' },
     ]);
   }
@@ -2198,12 +2553,17 @@ function printPlansCatalogs(payload, type) {
       { label: 'Ano', value: (storage) => formatBrl(storage.prices?.yearly) },
     ]);
   }
+
+  if (type === 'all' || type === 'valkey' || type.startsWith('valkey-')) {
+    if (type === 'all') process.stdout.write('\n');
+    printValkeyCatalog(payload.valkey, valkeyProfileFilter(type));
+  }
 }
 
 async function handlePlans(session, flags) {
   const type = normalizePlansCatalogType(flags.type);
   if (!type) {
-    throw new CliError('Tipo de catalogo invalido. Valores aceitos: all, http, database, storage.');
+    throw new CliError('Tipo de catalogo invalido. Valores aceitos: all, http, database, storage, valkey.');
   }
 
   const payload = await fetchPlansCatalogs(session, flags, type);
@@ -2261,9 +2621,53 @@ function validateCreateAutoscaling(config, plan, typeProject) {
   return { ...config, autoscaling: nextAutoscaling };
 }
 
-function validateCreateInput({ plan, paymentMode, config }) {
+function validateValkeyConfig(config, plan, catalog) {
+  const valkeyCatalog = requireValkeyCatalog(catalog);
+  const profile = normalizeValkeyProfile(config?.profile);
+  const profileDefinition = valkeyCatalog.profiles.find((entry) => entry.id === profile);
+  if (!profileDefinition) {
+    throw new CliError('config.profile invalido. Use key_value, cache ou queue.');
+  }
+
+  const planDefinition = valkeyCatalog.plans.find((entry) => entry.id === plan && entry.profile === profile);
+  if (!planDefinition) {
+    throw new CliError(`Plano ${plan} nao pode ser usado com o perfil ${profile}. Consulte "zenifra plans --type valkey".`);
+  }
+
+  if (config.version !== valkeyCatalog.version) {
+    throw new CliError(`config.version invalida: use ${valkeyCatalog.version}, conforme o catalogo Valkey.`);
+  }
+
+  const forbiddenFields = ['instances', 'envs', 'image', 'github', 'port', 'exposure', 'autoscaling'];
+  const forbiddenField = forbiddenFields.find((field) => config[field] !== undefined);
+  if (forbiddenField) {
+    throw new CliError(`Valkey nao aceita config.${forbiddenField}. A capacidade e definida pelo plano.`);
+  }
+
+  if (profileDefinition.persistence) {
+    if (!isRecord(config.storage) || config.storage.persistent !== true) {
+      throw new CliError('Perfis Valkey persistentes exigem storage.persistent=true.');
+    }
+    const capacity = Number(config.storage.capacity);
+    if (!Number.isInteger(capacity) || capacity < 1 || capacity > 250) {
+      throw new CliError('storage.capacity deve ser um inteiro entre 1 e 250 GiB.');
+    }
+  } else if (config.storage !== undefined) {
+    throw new CliError('O perfil Cache nao aceita storage.');
+  }
+
+  return {
+    ...config,
+    type_project: 'valkey',
+    profile,
+    version: valkeyCatalog.version,
+  };
+}
+
+function validateCreateInput({ plan, paymentMode, config, valkeyCatalog }) {
+  const nextTypeProject = normalizeTypeProject(config?.type_project);
   const nextPlan = normalizePlan(plan);
-  if (!nextPlan || !ALLOWED_PLAN_VALUES.has(nextPlan)) {
+  if (!nextPlan || (nextTypeProject !== 'valkey' && !ALLOWED_PLAN_VALUES.has(nextPlan))) {
     throw new CliError(`Plano invalido: "${plan}". Valores aceitos: ${formatAllowedValues(ALLOWED_PLAN_VALUES)}. Docs: ${DOCS_CREATE_HTTP_URL}`);
   }
 
@@ -2272,12 +2676,19 @@ function validateCreateInput({ plan, paymentMode, config }) {
     throw new CliError(`Modo de pagamento invalido: "${paymentMode}". Valores aceitos: ${formatAllowedValues(ALLOWED_PAYMENT_MODE_VALUES)}. Docs: ${DOCS_PAYMENTS_URL}`);
   }
 
-  const nextTypeProject = normalizeTypeProject(config?.type_project);
   if (!nextTypeProject || !ALLOWED_TYPE_PROJECT_VALUES.has(nextTypeProject)) {
     throw new CliError(`type_project invalido: "${config?.type_project}". Valores aceitos: ${formatAllowedValues(ALLOWED_TYPE_PROJECT_VALUES)}. Docs: ${DOCS_CREATE_HTTP_URL}`);
   }
 
   const nextConfig = { ...config, type_project: nextTypeProject };
+  if (nextTypeProject === 'valkey') {
+    return {
+      plan: nextPlan,
+      paymentMode: nextPaymentMode,
+      config: validateValkeyConfig(nextConfig, nextPlan, valkeyCatalog),
+    };
+  }
+
   if (nextTypeProject === 'http' && nextConfig.github) {
     const nextRuntime = normalizeRuntime(nextConfig.github.runtime);
     if (!nextRuntime || !ALLOWED_RUNTIME_VALUES.has(nextRuntime)) {
@@ -2344,6 +2755,10 @@ function printWizardSummary(payload) {
     lines.push(`  banco: versao ${masked.config.version} | instancias ${masked.config.instances} | storage ${masked.config.storage.capacity}Gi`);
   }
 
+  if (masked.config.type_project === 'valkey') {
+    lines.push(`  Valkey: perfil ${masked.config.profile} | versao ${masked.config.version}${masked.config.storage ? ` | storage ${masked.config.storage.capacity}Gi persistente` : ' | sem storage persistente'}`);
+  }
+
   process.stdout.write(`${lines.join('\n')}\n`);
 }
 
@@ -2735,6 +3150,65 @@ async function buildMariadbConfig() {
   };
 }
 
+async function buildValkeyConfig({ profile, plan, catalog }) {
+  const planDefinition = catalog.plans.find((entry) => entry.id === plan && entry.profile === profile);
+  const profileDefinition = catalog.profiles.find((entry) => entry.id === profile);
+  if (!planDefinition || !profileDefinition) {
+    throw new CliError('O catalogo Valkey nao possui o plano ou perfil selecionado. Tente novamente.');
+  }
+
+  let storage;
+  if (profileDefinition.persistence) {
+    storage = {
+      persistent: true,
+      capacity: await promptWizardNumber({
+        label: `Capacidade de armazenamento persistente (Gi, inclui ${planDefinition.included_storage_gb ?? 0} Gi)`,
+        docs: DOCS_CREATE_VALKEY_URL,
+        examples: [String(Math.max(1, planDefinition.included_storage_gb ?? 1)), '10', '20'],
+        min: 1,
+        max: 250,
+      }),
+    };
+  }
+
+  const whitelist = await promptWizardPairs({
+    introLabel: 'Deseja configurar acesso de rede para este projeto?',
+    docs: DOCS_CREATE_VALKEY_URL,
+    examples: ['sim', 'nao'],
+    stateKey: 'valkeyNetworkAccess',
+    itemLabels: [
+      { key: 'cidr', label: 'CIDR permitido', required: true, examples: ['203.0.113.0/24'], docs: DOCS_CREATE_VALKEY_URL },
+      { key: 'description', label: 'Descricao do acesso', required: true, examples: ['Aplicacao'], docs: DOCS_CREATE_VALKEY_URL },
+    ],
+  });
+
+  let blacklist = [];
+  if (whitelist.length > 0) {
+    blacklist = await promptWizardPairs({
+      introLabel: 'Deseja adicionar bloqueios de rede?',
+      docs: DOCS_CREATE_VALKEY_URL,
+      examples: ['sim', 'nao'],
+      itemLabels: [
+        { key: 'cidr', label: 'CIDR bloqueado', required: true, examples: ['198.51.100.0/24'], docs: DOCS_CREATE_VALKEY_URL },
+        { key: 'description', label: 'Descricao do bloqueio', required: true, examples: ['Bloqueio'], docs: DOCS_CREATE_VALKEY_URL },
+      ],
+    });
+  }
+
+  return {
+    type_project: 'valkey',
+    profile,
+    version: catalog.version,
+    ...(storage ? { storage } : {}),
+    ...(whitelist.length > 0 ? {
+      network_access: {
+        ingress_white_list: whitelist,
+        ingress_black_list: blacklist,
+      },
+    } : {}),
+  };
+}
+
 async function runProjectCreateWizard(session, flags) {
   const catalogs = await fetchWizardCatalogs(session, flags);
   const ui = createWizardUi();
@@ -2765,16 +3239,34 @@ async function runProjectCreateWizard(session, flags) {
     options: WIZARD_TYPE_PROJECT_OPTIONS.map((value) => ({ value })),
   });
   ui.state.typeProject = typeProject;
+  const valkeyCatalog = typeProject === 'valkey'
+    ? requireValkeyCatalog(unwrapData(await request(session, flags, 'GET', '/managed-services/catalog')))
+    : undefined;
+  const profile = typeProject === 'valkey'
+    ? await promptWizardSelect({
+      label: 'Perfil Valkey',
+      docs: DOCS_CREATE_VALKEY_URL,
+      examples: WIZARD_VALKEY_PROFILE_OPTIONS,
+      options: WIZARD_VALKEY_PROFILE_OPTIONS.map((value) => ({ value })),
+    })
+    : undefined;
+  ui.state.valkeyProfile = profile;
   const planOptions = typeProject === 'http'
     ? sortWizardOptions(catalogs.httpPlans
       .map((plan) => plan?.plan)
       .filter((plan) => WIZARD_HTTP_PLAN_OPTIONS.includes(plan) && Number(catalogs.availableInstances?.[plan] || 0) > 0), WIZARD_HTTP_PLAN_OPTIONS)
+    : typeProject === 'valkey'
+      ? valkeyCatalog.plans
+        .filter((planDefinition) => planDefinition.profile === profile)
+        .map((planDefinition) => planDefinition.id)
     : sortWizardOptions(catalogs.databasePlans
       .map((plan) => plan?.plan)
       .filter((plan) => WIZARD_DATABASE_PLAN_OPTIONS.includes(plan) && (typeProject !== 'mariadb' || plan !== 'db-free')), WIZARD_DATABASE_PLAN_OPTIONS);
   const plan = await promptWizardSelect({
     label: 'Plano',
-    docs: typeProject === 'http' ? DOCS_CREATE_HTTP_URL : DOCS_DATABASE_CONFIGURATION_URL,
+    docs: typeProject === 'http'
+      ? DOCS_CREATE_HTTP_URL
+      : typeProject === 'valkey' ? DOCS_CREATE_VALKEY_URL : DOCS_DATABASE_CONFIGURATION_URL,
     examples: [planOptions[0], planOptions.at(-1)],
     options: planOptions.map((value) => ({ value })),
   });
@@ -2800,6 +3292,8 @@ async function runProjectCreateWizard(session, flags) {
     });
   } else if (typeProject === 'postgresql') {
     config = await buildPostgresqlConfig({ plan, databasePlans: catalogs.databasePlans });
+  } else if (typeProject === 'valkey') {
+    config = await buildValkeyConfig({ profile, plan, catalog: valkeyCatalog });
   } else {
     config = await buildMariadbConfig();
   }
@@ -2815,7 +3309,9 @@ async function runProjectCreateWizard(session, flags) {
   printWizardSummary(payload);
   const confirmed = await promptWizardBoolean({
     label: 'Confirmar criacao do projeto',
-    docs: typeProject === 'http' ? DOCS_CREATE_HTTP_URL : DOCS_DATABASE_CONFIGURATION_URL,
+    docs: typeProject === 'http'
+      ? DOCS_CREATE_HTTP_URL
+      : typeProject === 'valkey' ? DOCS_CREATE_VALKEY_URL : DOCS_DATABASE_CONFIGURATION_URL,
     examples: ['sim', 'nao'],
   });
   if (!confirmed) return null;
@@ -2836,10 +3332,18 @@ async function handleProjectCreate(session, flags) {
   const plan = wizardPayload?.plan || flags.plan || await prompt('Plano');
   const paymentMode = wizardPayload?.payment_mode || flags.paymentMode || await prompt('Modo de pagamento');
   const config = wizardPayload?.config || await parseConfig(flags.config || await prompt('Config JSON ou @arquivo'));
-  const validated = validateCreateInput({ plan, paymentMode, config });
+  const typeProject = normalizeTypeProject(config?.type_project);
+  const valkeyCatalog = typeProject === 'valkey'
+    ? requireValkeyCatalog(unwrapData(await request(session, flags, 'GET', '/managed-services/catalog')))
+    : undefined;
+  if (flags.idempotencyKey !== undefined && !/^[A-Za-z0-9._-]{16,200}$/.test(String(flags.idempotencyKey))) {
+    throw new CliError('--idempotency-key deve ter entre 16 e 200 caracteres: letras, numeros, ponto, underscore ou hifen.');
+  }
+  const validated = validateCreateInput({ plan, paymentMode, config, valkeyCatalog });
 
   const payload = await request(session, flags, 'POST', '/project', {
     orgId,
+    headers: flags.idempotencyKey === undefined ? {} : { 'Idempotency-Key': String(flags.idempotencyKey) },
     body: {
       name,
       ...(description ? { description: String(description) } : {}),
@@ -2859,6 +3363,21 @@ async function handleProjectCreate(session, flags) {
     ...(project.domain ? [{ field: 'Dominio', value: formatPublicUrl(project.domain) }] : []),
     ...(project.api_key ? [{ field: 'API key', value: project.api_key }] : []),
   ];
+  if (validated.config.type_project === 'valkey') {
+    const service = project.managed_service || {};
+    rows.push(
+      { field: 'Perfil', value: service.profile || validated.config.profile },
+      { field: 'Host', value: service.host || '-' },
+      { field: 'Porta', value: service.port ?? '-' },
+      { field: 'TLS', value: service.tls === true ? 'sim' : 'nao' },
+    );
+    if (service.connection_string) {
+      rows.push({ field: 'String de conexao', value: service.connection_string });
+      process.stdout.write('Salve a string de conexao em um local seguro; ela pode nao ser exibida novamente.\n');
+    } else {
+      rows.push({ field: 'Credencial', value: 'nao retornada nesta resposta; use valkey credentials rotate' });
+    }
+  }
   process.stdout.write('\n');
   printTable(rows, [
     { label: 'Campo', value: (row) => row.field },
@@ -2908,6 +3427,16 @@ async function handleProjectLogs(session, flags) {
   printLogs(logs, flags);
 }
 
+async function handleProjectMetricsCapabilities(session, flags) {
+  const projectId = requireProjectId(flags, 'project metrics capabilities');
+  if (!projectId) return;
+  const orgId = await resolveOrgId(session, flags);
+  const capabilities = unwrapData(await request(session, flags, 'GET', `/project/${projectId}/metrics/capabilities`, { orgId }));
+
+  if (flags.json) return printJson(capabilities);
+  printMetricsCapabilities(capabilities);
+}
+
 async function handleProjectMetrics(session, flags) {
   const projectId = requireProjectId(flags, 'project metrics');
   if (!projectId) return
@@ -2916,6 +3445,9 @@ async function handleProjectMetrics(session, flags) {
   const metrics = unwrapData(await request(session, flags, 'GET', `/project/${projectId}/metrics${query}`, { orgId }));
 
   if (flags.json) return printJson(metrics);
+  if (metrics?.type === 'valkey') {
+    return printValkeyMetrics(metrics);
+  }
   if (Array.isArray(metrics)) {
     return printTable(metrics, [
       { label: 'Instancia', value: (metric) => metric.instance || '-' },
@@ -3330,6 +3862,131 @@ async function handleProjectBillingUsage(session, flags) {
   printBillingUsage(data);
 }
 
+function printValkeyStatus(data) {
+  printTable([data], [
+    { label: 'Status', value: (service) => service.status || '-' },
+    { label: 'Perfil', value: (service) => service.profile || '-' },
+    { label: 'Versao', value: (service) => service.version || '-' },
+    { label: 'Persistente', value: (service) => service.persistence === true ? 'sim' : 'nao' },
+    { label: 'Instancias', value: (service) => service.instances ?? '-' },
+  ]);
+}
+
+function printValkeyConnection(data) {
+  printTable([data], [
+    { label: 'Host', value: (service) => service.host || '-' },
+    { label: 'Porta', value: (service) => service.port ?? '-' },
+    { label: 'Usuario', value: (service) => service.username || '-' },
+    { label: 'TLS', value: (service) => service.tls === true ? 'sim' : 'nao' },
+    { label: 'Conexao', value: (service) => service.connection_string || '-' },
+  ]);
+}
+
+function printValkeyRotation(data, { accepted = false } = {}) {
+  const rows = [
+    { field: accepted ? 'Operacao aceita' : 'Operacao', value: data.operation_id || '-' },
+    { field: 'Estado', value: data.state || '-' },
+  ];
+  if (data.connection_string) {
+    rows.push({ field: 'String de conexao', value: data.connection_string });
+    process.stdout.write('Salve a nova string de conexao em um local seguro; ela pode nao ser exibida novamente.\n');
+  }
+  printTable(rows, [
+    { label: 'Campo', value: (row) => row.field },
+    { label: 'Valor', value: (row) => row.value },
+  ]);
+}
+
+async function waitForValkeyRotation(session, flags, projectId, operationId, orgId) {
+  const intervalMs = parseSecondsOption(flags.interval, '--interval', { defaultValue: 2, min: 0.1 }) * 1000;
+  const timeoutMs = parseSecondsOption(flags.timeout, '--timeout', { defaultValue: 900, min: 1 }) * 1000;
+  const startedAt = Date.now();
+  let lastState = 'accepted';
+
+  while (true) {
+    const data = unwrapData(await request(
+      session,
+      flags,
+      'GET',
+      `/managed-services/${projectId}/credential-rotations/${operationId}`,
+      { orgId },
+    ));
+    lastState = data?.state || lastState;
+    if (lastState === 'completed') return data;
+    if (['failed', 'cancelled', 'canceled'].includes(lastState)) {
+      throw new CliError(`A renovacao de credencial terminou com estado ${lastState}. Operacao: ${operationId}.`);
+    }
+    if (Date.now() - startedAt >= timeoutMs) {
+      throw new CliError(`Timeout aguardando a renovacao ${operationId}. Ultimo estado: ${lastState}.`);
+    }
+    await new Promise((resolvePromise) => setTimeout(resolvePromise, intervalMs));
+  }
+}
+
+async function handleValkeyStatus(session, flags) {
+  const projectId = requireProjectId(flags, 'valkey status');
+  if (!projectId) return;
+  const orgId = await resolveOrgId(session, flags);
+  const data = unwrapData(await request(session, flags, 'GET', `/managed-services/${projectId}/status`, { orgId }));
+  if (flags.json) return printJson(data);
+  printValkeyStatus(data);
+}
+
+async function handleValkeyConnection(session, flags) {
+  const projectId = requireProjectId(flags, 'valkey connection');
+  if (!projectId) return;
+  const orgId = await resolveOrgId(session, flags);
+  const data = unwrapData(await request(session, flags, 'GET', `/managed-services/${projectId}/connection`, { orgId }));
+  if (flags.json) return printJson(data);
+  printValkeyConnection(data);
+}
+
+async function handleValkeyCredentialStatus(session, flags) {
+  const projectId = requireProjectId(flags, 'valkey credentials status');
+  if (!projectId) return;
+  if (!flags.operation) {
+    printCommandHelpAndFail('valkey credentials status');
+    return;
+  }
+  const orgId = await resolveOrgId(session, flags);
+  const data = unwrapData(await request(
+    session,
+    flags,
+    'GET',
+    `/managed-services/${projectId}/credential-rotations/${flags.operation}`,
+    { orgId },
+  ));
+  if (flags.json) return printJson(data);
+  printValkeyRotation(data);
+}
+
+async function handleValkeyCredentialRotate(session, flags) {
+  const projectId = requireProjectId(flags, 'valkey credentials rotate');
+  if (!projectId) return;
+  const idempotencyKey = String(flags.idempotencyKey || randomUUID());
+  if (!/^[A-Za-z0-9._-]{16,200}$/.test(idempotencyKey)) {
+    throw new CliError('--idempotency-key deve ter entre 16 e 200 caracteres: letras, numeros, ponto, underscore ou hifen.');
+  }
+  const orgId = await resolveOrgId(session, flags);
+  const acceptedPayload = await request(session, flags, 'PATCH', `/managed-services/${projectId}/credentials`, {
+    orgId,
+    body: {},
+    headers: { 'Idempotency-Key': idempotencyKey },
+  });
+  const accepted = unwrapData(acceptedPayload);
+  if (!accepted?.operation_id) throw new CliError('A API nao retornou o identificador da renovacao de credencial.');
+
+  if (flags.wait) {
+    const completed = await waitForValkeyRotation(session, flags, projectId, accepted.operation_id, orgId);
+    if (flags.json) return printJson(completed);
+    printValkeyRotation(completed);
+    return;
+  }
+
+  if (flags.json) return printJson(acceptedPayload);
+  printValkeyRotation(accepted, { accepted: true });
+}
+
 function buildQuery(flags, allowedKeys) {
   const params = new URLSearchParams();
   for (const key of allowedKeys) {
@@ -3540,7 +4197,7 @@ async function main() {
       return;
     }
 
-    if (command === 'auth' && subcommand === 'login') return handleLogin(session, flags);
+    if (command === 'auth' && subcommand === 'login') return await handleLogin(session, flags);
     if (command === 'auth' && subcommand === 'api-key') return handleApiKeyLogin(session, flags);
     if (command === 'auth' && subcommand === 'logout') return handleLogout(session, flags);
     if (command === 'profile' && subcommand === 'list') return handleProfileList(session, flags);
@@ -3549,16 +4206,25 @@ async function main() {
     if (command === 'profile' && subcommand === 'edit') return handleProfileEdit(session, flags, positional);
     if (command === 'profile' && subcommand === 'use') return handleProfileUse(session, flags, positional);
     if (command === 'profile' && subcommand === 'remove') return handleProfileRemove(session, flags, positional);
-    if (command === 'login') return handleLogin(session, flags);
+    if (command === 'login') return await handleLogin(session, flags);
     if (command === 'logout') return handleLogout(session, flags);
     if (command === 'plans') return handlePlans(session, flags);
     if (command === 'create' && subcommand === 'project') return handleProjectCreate(session, flags);
     if (command === 'orgs') return handleOrgs(session, flags);
     if (command === 'org' && subcommand === 'set') return handleOrgSet(session, flags);
     if (command === 'projects') return handleProjects(session, flags);
+    if (command === 'valkey' && subcommand === 'credentials' && positional.length === 2) {
+      process.stdout.write(commandHelp(['valkey', 'credentials']));
+      return;
+    }
+    if (command === 'valkey' && subcommand === 'status') return handleValkeyStatus(session, flags);
+    if (command === 'valkey' && subcommand === 'connection') return handleValkeyConnection(session, flags);
+    if (command === 'valkey' && subcommand === 'credentials' && positional[2] === 'rotate') return handleValkeyCredentialRotate(session, flags);
+    if (command === 'valkey' && subcommand === 'credentials' && positional[2] === 'status') return handleValkeyCredentialStatus(session, flags);
     if (command === 'project' && subcommand === 'info') return handleProjectInfo(session, flags);
     if (command === 'project' && subcommand === 'url') return handleProjectUrl(session, flags);
     if (command === 'project' && subcommand === 'logs') return handleProjectLogs(session, flags);
+    if (command === 'project' && subcommand === 'metrics' && positional[2] === 'capabilities') return handleProjectMetricsCapabilities(session, flags);
     if (command === 'project' && subcommand === 'metrics') return handleProjectMetrics(session, flags);
     if (command === 'project' && subcommand === 'network') return handleProjectNetwork(session, flags);
     if (command === 'project' && subcommand === 'image' && positional[2] === 'set') return handleProjectImageSet(session, flags);

package/examples/valkey-cache-project.json

@@ -0,0 +1,14 @@
+{
+  "type_project": "valkey",
+  "profile": "cache",
+  "version": "9.1.1",
+  "network_access": {
+    "ingress_white_list": [
+      {
+        "cidr": "203.0.113.0/24",
+        "description": "Application network"
+      }
+    ],
+    "ingress_black_list": []
+  }
+}

package/examples/valkey-key-value-project.json

@@ -0,0 +1,18 @@
+{
+  "type_project": "valkey",
+  "profile": "key_value",
+  "version": "9.1.1",
+  "storage": {
+    "persistent": true,
+    "capacity": 1
+  },
+  "network_access": {
+    "ingress_white_list": [
+      {
+        "cidr": "203.0.113.0/24",
+        "description": "Application network"
+      }
+    ],
+    "ingress_black_list": []
+  }
+}

package/examples/valkey-queue-project.json

@@ -0,0 +1,18 @@
+{
+  "type_project": "valkey",
+  "profile": "queue",
+  "version": "9.1.1",
+  "storage": {
+    "persistent": true,
+    "capacity": 1
+  },
+  "network_access": {
+    "ingress_white_list": [
+      {
+        "cidr": "203.0.113.0/24",
+        "description": "Application network"
+      }
+    ],
+    "ingress_black_list": []
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zenifra/cli",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Official Zenifra command line interface.",
   "type": "module",
   "license": "MIT",