@zenifra/cli 0.5.0 → 0.6.0

package/README.md

@@ -59,6 +59,7 @@ zenifra git runtimes
 zenifra git connections
 zenifra git repositories resolve --connection <connection-id> --path equipe/aplicacao
 zenifra git branches --connection <connection-id> --repository <repository-id>
+zenifra plans --type job
 zenifra create project
 zenifra create project --name <name> --plan free --payment-mode hourly --config @examples/http-project.json
 zenifra create project --name <name> --plan basic --payment-mode hourly --config @examples/http-github-project.json
@@ -70,6 +71,7 @@ zenifra create project --name <name> --plan analytics-starter --payment-mode hou
 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 create project --name nightly-report --plan job-basic --payment-mode per_minute --config @examples/job-project.json
 zenifra projects --type http --page 1 --limit 15
 zenifra projects --type valkey --page 1 --limit 15
 zenifra project info --project <project-id>
@@ -82,6 +84,9 @@ 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 runs --project <project-id> --page 1 --limit 20
+zenifra project runs cancel --project <project-id> --run <run-id>
+zenifra project runs logs --project <project-id> --run <run-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
@@ -275,7 +280,7 @@ zenifra plans --type database
 zenifra plans --type storage --json
 ```
 
-`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.
+`zenifra plans` funciona sem autenticacao e mostra os catalogos publicos de HTTP, banco, armazenamento, Jobs agendados e Valkey. Use `--type job` para consultar Jobs agendados ou `--type valkey` para consultar Key Value, Cache e Queue.
 
 Para planos HTTP, a saida legivel tambem mostra as capacidades disponiveis, como logs, metricas, verificacao de saude, auto-scaling, subdominio personalizado e acesso de rede. Use `--json` quando precisar consumir o catalogo sem formatacao.
 
@@ -353,6 +358,7 @@ Use os arquivos em `examples/` como base para `zenifra create project`:
 - `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
+- `examples/job-project.json`: Job agendado com cron UTC, imagem e armazenamento efêmero
 
 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:
 
@@ -366,17 +372,18 @@ O wizard atual cobre:
 - projetos `postgresql`
 - projetos `mariadb`
 - projetos `valkey` nos perfis `key_value`, `cache` e `queue`
+- Jobs agendados com uma imagem OCI pronta
 
 Projetos `clickhouse` usam atualmente o fluxo nao interativo com `--config`, como em `examples/clickhouse-project.json`.
 
-`zenifra create project` nao assume valores default para `--plan` e `--payment-mode`.
+`zenifra create project` nao assume valores default para `--plan` e `--payment-mode`, exceto para Jobs, que usam `per_minute` automaticamente.
 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.
 Antes de escolher um plano com o usuario, compare os catalogos com `zenifra plans` para evitar suposicoes sobre custo.
 
 Valores aceitos:
 
-- `payment_mode`: `hourly`, `monthly`, `yearly`
-- `type_project` no `config`: `http`, `postgresql`, `mariadb`, `valkey`, `clickhouse`
+- `payment_mode`: `hourly`, `monthly`, `yearly`, `per_minute` (somente Jobs)
+- `type_project` no `config`: `http`, `postgresql`, `mariadb`, `valkey`, `clickhouse`, `job`
 - `exposure` no `config` HTTP: `public`, `private`
 - `plan`: consulte `zenifra plans` para os planos atuais; ClickHouse usa `analytics-*`; Valkey usa `db-*` para Key Value, `cache-*` para Cache e `queue-*` para Queue
 - `config.profile` em projetos Valkey: `key_value`, `cache` ou `queue`
@@ -387,6 +394,7 @@ Valores aceitos:
 - `config.github.version_deploy`: use `enabled: true`, `event: "tag"` ou `"release"` e um `tag_pattern` explicito; `include_prereleases` e opcional e padrao `false`
 - `config.source` e `config.build` (quando houver origem Git por conexao): use os IDs retornados pela configuracao segura no Console/API; nao informe credenciais Git nesses campos
 - `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
+- `config.job` (somente Jobs): cron com cinco campos em UTC; o wizard usa a imagem OCI pronta e nao pergunta comando, argumentos, URL, exposicao, porta ou instancias
 
 Observacoes do wizard:
 
@@ -397,7 +405,8 @@ Observacoes do wizard:
 - 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; uma rotação concluída pode salvar a conexão utilizável em arquivo privado com `--connection-file <path>`
+- em Jobs, a imagem OCI pronta é obrigatória, o cron usa cinco campos em UTC, a cobrança é por minuto inteiro e a CLI não pergunta origem GitHub, tipo de pagamento, comando, argumentos, exposição HTTP, porta ou instâncias
+- 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, podendo ser salva em arquivo privado com `--connection-file <path>`
 - `valkey credentials rotate` retorna uma operação assíncrona; use `--wait` ou `valkey credentials status` para acompanhar
 
 Exemplo de entrega segura para automação local:
@@ -408,6 +417,20 @@ zenifra valkey credentials rotate --project <project-id> --wait --connection-fil
 
 O arquivo é criado com permissão privada; a conexão não aparece na saída do comando quando essa opção é usada.
 
+## Execuções de Jobs agendados
+
+Consulte o histórico de execuções e os logs de uma execução específica:
+
+```bash
+zenifra project runs --project <project-id>
+zenifra project runs cancel --project <project-id> --run <run-id>
+zenifra project runs logs --project <project-id> --run <run-id>
+```
+
+`project runs cancel` cancela somente a execução selecionada. O cron do projeto continua agendando novas execuções; use `zenifra project stop --project <project-id>` para pausar o projeto e interromper execuções futuras.
+
+O cancelamento aguarda até 30 segundos pela finalização segura e pode forçar o encerramento depois desse período. Se uma execução antiga não puder ser cancelada com segurança, o comando informa o problema e você deve aguardar que ela termine ou alcance o limite de tempo.
+
 ## Regressao manual de auto-scaling em staging
 
 O teste de staging cria projetos, gera trafego, consulta consumo e remove somente os projetos criados pela propria execucao. Ele exige uma API de teste explicita, rejeita a API de producao e exige habilitacao explicita das mutacoes. O exemplo abaixo usa uma API local de teste.

package/bin/zenifra.mjs

@@ -27,6 +27,9 @@ const PROFILES_FILE = join(SESSION_DIR, 'profiles.json');
 const PROFILE_STORE_VERSION = 1;
 const DEFAULT_PROFILE_NAME = 'default';
 const DEFAULT_HTTP_TIMEOUT_MS = 300_000;
+const OCI_IMAGE_REFERENCE_PATTERN = /^[a-z0-9._-]+\/(?:[a-z0-9._-]+\/)*[a-z0-9._-]+(?::[a-z0-9._-]+|@sha256:[a-f0-9]{64})$/;
+const OCI_IMAGE_REFERENCE_MIN_LENGTH = 8;
+const OCI_IMAGE_REFERENCE_MAX_LENGTH = 256;
 const KNOWN_FLAG_NAMES = new Set([
   'apiBase',
   'oauth',
@@ -74,6 +77,8 @@ const KNOWN_FLAG_NAMES = new Set([
   'project',
   'repository',
   'revoke',
+  'run',
+  'runId',
   'showValues',
   'status',
   'tagPattern',
@@ -115,8 +120,8 @@ const ALLOWED_PLAN_VALUES = new Set([
   'queue-premium',
   'queue-enterprise',
 ]);
-const ALLOWED_PAYMENT_MODE_VALUES = new Set(['hourly', 'monthly', 'yearly']);
-const ALLOWED_TYPE_PROJECT_VALUES = new Set(['http', 'postgresql', 'mariadb', 'valkey', 'clickhouse']);
+const ALLOWED_PAYMENT_MODE_VALUES = new Set(['hourly', 'monthly', 'yearly', 'per_minute']);
+const ALLOWED_TYPE_PROJECT_VALUES = new Set(['http', 'postgresql', 'mariadb', 'valkey', 'clickhouse', 'job']);
 const ALLOWED_RUNTIME_VALUES = new Set(['nodejs', 'python']);
 const ALLOWED_GITHUB_VERSION_DEPLOY_EVENTS = new Set(['tag', 'release']);
 const ALLOWED_GITHUB_VERSION_DEPLOY_FIELDS = new Set(['enabled', 'event', 'tag_pattern', 'include_prereleases']);
@@ -171,6 +176,7 @@ const WIZARD_DATABASE_PLAN_OPTIONS = [
   'db-free',
 ];
 const WIZARD_PAYMENT_MODE_OPTIONS = ['hourly', 'monthly', 'yearly'];
+const WIZARD_JOB_PLAN_OPTIONS = WIZARD_HTTP_PLAN_OPTIONS.map((plan) => `job-${plan}`);
 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'];
@@ -212,15 +218,15 @@ Usage:
   zenifra whoami [--json]
   zenifra orgs [--json]
   zenifra org set [--org <id>]
-  zenifra plans [--type <all|http|database|storage|valkey>] [--json]
+  zenifra plans [--type <all|http|database|storage|valkey|job>] [--json]
   zenifra git providers [--json]
   zenifra git runtimes [--json]
   zenifra git connections [--json]
   zenifra git repositories resolve --connection <id> --path <owner/repo> [--json]
   zenifra git branches --connection <id> --repository <opaque-id> [--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|valkey>] [--page <n>] [--limit <n>]
+  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|valkey|job>] [--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]
@@ -231,6 +237,9 @@ Usage:
   zenifra project delete --project <id> --yes [--json]
   zenifra project url --project <id> [--json]
   zenifra project logs --project <id> [--instance <id>] [--json]
+  zenifra project runs --project <id> [--page <n>] [--limit <n>] [--json]
+  zenifra project runs cancel --project <id> --run <id> [--json]
+  zenifra project runs logs --project <id> --run <id> [--json]
   zenifra project metrics --project <id> [--instance <id>] [--json]
   zenifra project metrics capabilities --project <id> [--json]
   zenifra project healthcheck get --project <id> [--json]
@@ -413,10 +422,10 @@ const HELP_SPECS = [
   },
   {
     command: 'plans',
-    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'],
+    usage: 'zenifra plans [--type <all|http|database|storage|valkey|job>] [--json]',
+    description: 'Lista os catalogos publicos de preco de planos HTTP, banco, armazenamento, Valkey e Jobs agendados.',
+    flags: ['--type <type>  Filtra o catalogo: all, http, database, storage, valkey, job, key-value, cache ou queue.', '--json         Imprime a resposta em JSON.'],
+    examples: ['zenifra plans', 'zenifra plans --type http', 'zenifra plans --type valkey --json', 'zenifra plans --type job --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":[]}',
   },
@@ -533,7 +542,7 @@ const HELP_SPECS = [
   },
   {
     command: 'projects',
-    usage: 'zenifra projects [--json] [--org <id>] [--type <http|postgresql|mariadb|valkey>] [--page <n>] [--limit <n>]',
+    usage: 'zenifra projects [--json] [--org <id>] [--type <http|postgresql|mariadb|valkey|job>] [--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'],
@@ -542,9 +551,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>] [--idempotency-key <key>] [--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.', '--idempotency-key <key>   Chave para repetir a mesma criacao com seguranca.', '--json                    Imprime a resposta em JSON.'],
+    flags: ['--name <name>             Nome do projeto.', '--plan <plan>             Plano do projeto.', '--payment-mode <mode>     Opcional para Jobs; demais tipos seguem a validacao do catalogo.', '--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.clients.zenifra.com',
     jsonOutput: '{"status":"success","data":{"id":"507f1f77bcf86cd799439012","name":"api-web"}}',
@@ -552,11 +561,11 @@ const HELP_SPECS = [
   },
   {
     command: 'project',
-    usage: 'zenifra project\n  zenifra project info --project <id> [--json]\n  zenifra project source --project <id> [--json]\n  zenifra project source branches --project <id> [--json]\n  zenifra project source deploy-settings set --project <id> --mode <manual|branch|tag|release> [--tag-pattern <pattern>] [--include-prereleases <true|false>] [--json]\n  zenifra project stop --project <id> [--json]\n  zenifra project resume --project <id> [--json]\n  zenifra project delete --project <id> --yes [--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 healthcheck get --project <id> [--json]\n  zenifra project healthcheck set --project <id> --path /health [--json]\n  zenifra project healthcheck disable --project <id> [--json]\n  zenifra project healthcheck failures --project <id> [--page <n>] [--limit <n>] [--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 source --project <id> [--json]\n  zenifra project source branches --project <id> [--json]\n  zenifra project source deploy-settings set --project <id> --mode <manual|branch|tag|release> [--tag-pattern <pattern>] [--include-prereleases <true|false>] [--json]\n  zenifra project stop --project <id> [--json]\n  zenifra project resume --project <id> [--json]\n  zenifra project delete --project <id> --yes [--json]\n  zenifra project url --project <id> [--json]\n  zenifra project logs --project <id> [--instance <id>] [--json]\n  zenifra project runs --project <id> [--page <n>] [--limit <n>] [--json]\n  zenifra project runs cancel --project <id> --run <id> [--json]\n  zenifra project runs logs --project <id> --run <id> [--json]\n  zenifra project metrics --project <id> [--instance <id>] [--json]\n  zenifra project metrics capabilities --project <id> [--json]\n  zenifra project healthcheck get --project <id> [--json]\n  zenifra project healthcheck set --project <id> --path /health [--json]\n  zenifra project healthcheck disable --project <id> [--json]\n  zenifra project healthcheck failures --project <id> [--page <n>] [--limit <n>] [--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 source --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, stop, resume, delete, url, logs, metrics, capabilities, network, image, github, source, exposure, autoscaling, billing, envs e instances.'],
+    notes: ['Use "zenifra help project <subcomando>" para detalhes de info, stop, resume, delete, url, logs, runs, cancelamento, metrics, capabilities, network, image, github, source, exposure, autoscaling, billing, envs e instances.'],
   },
   {
     command: 'project source',
@@ -698,6 +707,38 @@ const HELP_SPECS = [
     jsonOutput: '"server started\\nGET /health 200"',
     notes: ['Nao faz streaming continuo; retorna o snapshot disponibilizado pela API.'],
   },
+  {
+    command: 'project runs',
+    usage: 'zenifra project runs --project <id> [--page <n>] [--limit <n>] [--json]',
+    description: 'Lista as execucoes de um Job agendado com o historico de cobranca.',
+    flags: ['--project <id>  ID do projeto.', '--page <n>      Pagina. Padrao: 1.', '--limit <n>     Itens por pagina. Maximo: 50.', '--json          Imprime a resposta em JSON.'],
+    examples: ['zenifra project runs --project 507f1f77bcf86cd799439012', 'zenifra project runs --project 507f1f77bcf86cd799439012 --page 2 --limit 20 --json'],
+    output: 'ID      Status     Agendada                  Duracao  Minutos cobrados  Valor\nrun_1   succeeded  2026-09-01T12:00:00.000Z  70 s     2                 R$ 0,04',
+    jsonOutput: '{"runs":[{"id":"run_1","status":"succeeded","duration_seconds":70,"billed_minutes":2,"plan":"job-basic","currency":"brl","amount":4}],"pagination":{"page":1,"limit":20,"total":1,"total_pages":1}}',
+  },
+  {
+    command: 'project runs cancel',
+    usage: 'zenifra project runs cancel --project <id> --run <id> [--json]',
+    description: 'Cancela somente a execucao selecionada de um Job e cobra somente o tempo consumido.',
+    flags: ['--project <id>  ID do projeto.', '--run <id>      ID publico da execucao.', '--json          Imprime a resposta em JSON.'],
+    examples: ['zenifra project runs cancel --project 507f1f77bcf86cd799439012 --run run_1'],
+    output: 'Execucao: cancelled',
+    jsonOutput: '{"run":{"id":"run_1","status":"cancelled","billed_minutes":2}}',
+    notes: [
+      'Cancela somente a execucao informada; o cron do projeto continua agendando novas execucoes. Use "zenifra project stop --project <id>" para pausar o projeto e interromper execucoes futuras.',
+      'O cancelamento aguarda ate 30 segundos pela finalizacao segura e pode forcar o encerramento depois desse periodo. Se a execucao nao puder ser cancelada com seguranca, aguarde que ela termine ou alcance o limite de tempo.',
+    ],
+  },
+  {
+    command: 'project runs logs',
+    usage: 'zenifra project runs logs --project <id> --run <id> [--json]',
+    description: 'Mostra os logs de uma execucao especifica de um Job agendado.',
+    flags: ['--project <id>  ID do projeto.', '--run <id>      ID publico da execucao.', '--json          Imprime a resposta em JSON.'],
+    examples: ['zenifra project runs logs --project 507f1f77bcf86cd799439012 --run run_1', 'zenifra project runs logs --project 507f1f77bcf86cd799439012 --run run_1 --json'],
+    output: 'started\ncompleted',
+    jsonOutput: '{"logs":"started\\ncompleted","truncated":false}',
+    notes: ['Os logs pertencem a uma execucao identificada pelo ID publico retornado em project runs.'],
+  },
   {
     command: 'project metrics',
     usage: 'zenifra project metrics --project <id> [--instance <id>] [--json]',
@@ -1009,7 +1050,8 @@ function commandHelp(positionals) {
   const key = helpKeyFromPositionals(positionals);
   if (!key) return usage();
 
-  const spec = HELP_BY_COMMAND.get(key);
+  const spec = HELP_BY_COMMAND.get(key)
+    || (key === 'project run logs' ? HELP_BY_COMMAND.get('project runs logs') : undefined);
   if (!spec) {
     throw new CliError(`Ajuda nao encontrada para: ${key}. Use "zenifra help <command>".`);
   }
@@ -1602,9 +1644,9 @@ async function promptWizardBoolean({ label, docs, examples = ['sim', 'nao'] }) {
   }
 }
 
-async function promptWizardSelect({ label, options, docs, examples = [] }) {
+async function promptWizardSelect({ label, options, docs, examples = [], extraValues = [] }) {
   while (true) {
-    const allowedValues = options.map((option) => option.value);
+    const allowedValues = [...options.map((option) => option.value), ...extraValues];
     const answer = await prompt(buildWizardPromptLine({
       ui: promptWizardSelect.ui,
       label,
@@ -1625,6 +1667,8 @@ async function promptWizardSelect({ label, options, docs, examples = [] }) {
     const normalized = normalizeFreeText(answer);
     const found = options.find((option) => normalizeFreeText(option.value) === normalized);
     if (found) return found.value;
+    const extraValue = extraValues.find((value) => normalizeFreeText(value) === normalized);
+    if (extraValue) return extraValue;
     process.stdout.write(`${tone(`valor invalido: escolha um item entre ${options.map((_, index) => index + 1).join(', ')} ou um dos valores aceitos.`, 'red')}\n`);
     promptWizardSelect.ui.step -= 1;
   }
@@ -1757,6 +1801,14 @@ function httpTimeoutMs() {
   return value;
 }
 
+function publicApiErrorMessage(value) {
+  const message = String(value || 'Nao foi possivel concluir a operacao.');
+  if (/kubernetes|k8s|namespace|cluster|pod|serviceaccount|deployment|internal[_ -]/i.test(message)) {
+    return 'Nao foi possivel concluir a operacao. Tente novamente mais tarde.';
+  }
+  return message;
+}
+
 async function request(session, flags, method, path, {
   body,
   orgId,
@@ -1823,7 +1875,7 @@ async function request(session, flags, method, path, {
   }
 
   if (!response.ok) {
-    const message = payload?.message || payload?.error || `Zenifra API retornou HTTP ${response.status}`;
+    const message = publicApiErrorMessage(payload?.message || payload?.error || `Zenifra API retornou HTTP ${response.status}`);
     const httpError = (errorMessage) => new CliError(errorMessage, 1, response.status);
     if (response.status === 401) {
       if (credential?.type === 'api_key') {
@@ -2440,9 +2492,66 @@ function printEnvs(envs, flags) {
   ]);
 }
 
+function isJobProject(project) {
+  return project?.type_project === 'job' || project?.config?.type_project === 'job';
+}
+
+const JOB_INFO_HIDDEN_KEYS = new Set(['domain', 'url', 'exposure', 'port', 'instances']);
+const JOB_CONFIG_HIDDEN_KEYS = new Set(['exposure', 'port', 'instances', 'network_access', 'domain', 'custom_domains', 'autoscaling', 'healthcheck']);
+const INTERNAL_PROJECT_KEYS = new Set([
+  'current_instances',
+  'runtime_name',
+  'namespace',
+  'k8s_job_name',
+]);
+
+function sanitizePublicProjectValue(value) {
+  if (Array.isArray(value)) return value.map(sanitizePublicProjectValue);
+  if (!value || typeof value !== 'object') return value;
+  return Object.fromEntries(Object.entries(value)
+    .filter(([key]) => !INTERNAL_PROJECT_KEYS.has(key))
+    .map(([key, entryValue]) => [key, sanitizePublicProjectValue(entryValue)]));
+}
+
+function sanitizeJobConfigInfo(value) {
+  if (Array.isArray(value)) return value.map(sanitizeJobConfigInfo);
+  if (!value || typeof value !== 'object') return value;
+  return Object.fromEntries(Object.entries(value)
+    .filter(([key]) => !JOB_CONFIG_HIDDEN_KEYS.has(key))
+    .map(([key, entryValue]) => [key, sanitizeJobConfigInfo(entryValue)]));
+}
+
+function sanitizePublicProject(project) {
+  const sanitized = sanitizePublicProjectValue(project);
+  if (!sanitized || typeof sanitized !== 'object' || Array.isArray(sanitized)) return sanitized;
+  return Object.fromEntries(Object.entries(sanitized)
+    .filter(([key]) => !JOB_INFO_HIDDEN_KEYS.has(key))
+    .map(([key, value]) => [key, key === 'config' ? sanitizeJobConfigInfo(value) : value]));
+}
+
+function sanitizeJobProjectResponse(payload) {
+  if (!payload || typeof payload !== 'object' || Array.isArray(payload)) return payload;
+  if (payload.data && typeof payload.data === 'object' && !Array.isArray(payload.data)) {
+    return { ...payload, data: sanitizePublicProject(payload.data) };
+  }
+  return sanitizePublicProjectValue(payload);
+}
+
+function publicProjectsData(data) {
+  if (Array.isArray(data)) return data.map((project) => isJobProject(project) ? sanitizePublicProject(project) : project);
+  if (!data || typeof data !== 'object') return data;
+  return {
+    ...data,
+    projects: Array.isArray(data.projects)
+      ? data.projects.map((project) => isJobProject(project) ? sanitizePublicProject(project) : project)
+      : data.projects,
+  };
+}
+
 function printProject(project) {
   const managedService = project.managed_service;
   const isValkey = project.type_project === 'valkey' || managedService?.engine === 'valkey';
+  const isJob = isJobProject(project);
   const rows = [
     { label: 'ID', value: projectIdOf(project) || '-' },
     { label: 'Nome', value: project.name || '-' },
@@ -2451,7 +2560,13 @@ function printProject(project) {
     { label: 'Plano', value: project.plan || '-' },
   ];
 
-  if (isValkey) {
+  if (isJob) {
+    const schedule = project.job || project.config?.job || {};
+    rows.push(
+      { label: 'Agendamento', value: schedule.cron || '-' },
+      { label: 'Armazenamento', value: project.storage?.persistent === true || project.config?.storage?.persistent === true ? 'persistente' : 'efemero' },
+    );
+  } else if (isValkey) {
     rows.push(
       { label: 'Perfil', value: managedService?.profile || '-' },
       { label: 'Versao', value: managedService?.version || '-' },
@@ -2918,9 +3033,10 @@ async function handleProjects(session, flags) {
   };
   const query = buildQuery(projectFlags, ['type', 'page', 'limit']);
   const data = unwrapData(await request(session, flags, 'GET', `/project${query}`, { orgId }));
-  const projects = asArray(data);
+  const publicData = publicProjectsData(data);
+  const projects = asArray(publicData);
 
-  if (flags.json) return printJson(data);
+  if (flags.json) return printJson(publicData);
   printTable(projects, [
     { label: 'ID', value: projectIdOf },
     { label: 'Nome', value: (project) => project.name || '-' },
@@ -3009,6 +3125,8 @@ function normalizePlan(value) {
   ]);
 
   if (aliases.has(normalized)) return aliases.get(normalized);
+  const normalizedJobPlan = normalized.startsWith('job_') ? `job-${normalized.slice(4)}` : '';
+  if (WIZARD_JOB_PLAN_OPTIONS.includes(normalizedJobPlan)) return normalizedJobPlan;
   if (ALLOWED_PLAN_VALUES.has(normalized)) return normalized;
   return normalized;
 }
@@ -3028,6 +3146,10 @@ function normalizePaymentMode(value) {
     ['annual', 'yearly'],
     ['anual', 'yearly'],
     ['por ano', 'yearly'],
+    ['per_minute', 'per_minute'],
+    ['per-minute', 'per_minute'],
+    ['por minuto', 'per_minute'],
+    ['minuto', 'per_minute'],
   ]);
   return aliases.get(raw) || raw;
 }
@@ -3164,12 +3286,21 @@ async function fetchWizardCatalogs(session, flags) {
   return { httpPlans, availableInstances, databasePlans };
 }
 
+function requireJobPlans(value) {
+  const plans = Array.isArray(value) ? value : value?.plans;
+  if (!Array.isArray(plans)) {
+    throw new CliError('Falha ao carregar o catalogo de Jobs agendados. Tente novamente mais tarde.');
+  }
+  return plans;
+}
+
 function normalizePlansCatalogType(value) {
   const normalized = normalizeFreeText(value || 'all');
   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 === 'job' || normalized === 'jobs' || normalized === 'scheduled job' || normalized === 'scheduled jobs') return 'job';
   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';
@@ -3190,6 +3321,18 @@ function formatBrlFromCents(value) {
   return formatBrl(Number.isFinite(number) ? number / 100 : 0);
 }
 
+function formatJobBrlFromCents(value) {
+  if (value === undefined || value === null || value === '') return '-';
+  const number = Number(value);
+  if (!Number.isFinite(number)) return '-';
+  return new Intl.NumberFormat('pt-BR', {
+    style: 'currency',
+    currency: 'BRL',
+    minimumFractionDigits: 2,
+    maximumFractionDigits: 4,
+  }).format(number / 100);
+}
+
 function humanizeStorageName(value) {
   const raw = String(value || '').trim();
   if (!raw) return { storage: '-', type: '-' };
@@ -3287,6 +3430,17 @@ async function fetchPlansCatalogs(session, flags, type) {
     };
   }
 
+  if (type === 'job') {
+    return {
+      http: [],
+      database: [],
+      storage: [],
+      job: requireJobPlans(
+        unwrapData(await request(session, flags, 'GET', '/project/job/plans', { tokenRequired: false })),
+      ),
+    };
+  }
+
   if (type === 'valkey' || type.startsWith('valkey-')) {
     const catalog = requireValkeyCatalog(
       unwrapData(await request(session, flags, 'GET', '/managed-services/catalog', { tokenRequired: false })),
@@ -3299,10 +3453,11 @@ async function fetchPlansCatalogs(session, flags, type) {
     };
   }
 
-  const [httpPayload, databasePayload, storagePayload, valkeyPayload] = await Promise.all([
+  const [httpPayload, databasePayload, storagePayload, jobPayload, 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', '/project/job/plans', { tokenRequired: false }),
     request(session, flags, 'GET', '/managed-services/catalog', { tokenRequired: false }),
   ]);
 
@@ -3310,6 +3465,7 @@ async function fetchPlansCatalogs(session, flags, type) {
     http: requireWizardCatalogArray(unwrapData(httpPayload), 'os planos HTTP'),
     database: requireWizardCatalogArray(unwrapData(databasePayload), 'os planos de banco'),
     storage: requireWizardCatalogArray(unwrapData(storagePayload), 'os planos de storage'),
+    job: requireJobPlans(unwrapData(jobPayload)),
     valkey: requireValkeyCatalog(unwrapData(valkeyPayload)),
   };
 }
@@ -3348,6 +3504,15 @@ function formatPlanCapabilities(capabilities) {
   return available.join(', ') || '-';
 }
 
+function printJobCatalog(plans) {
+  process.stdout.write('Jobs agendados' + String.fromCharCode(10));
+  printTable(asArray(plans), [
+    { label: 'Plano', value: (plan) => plan.plan || plan.id || '-' },
+    { label: 'Por minuto', value: (plan) => formatJobBrlFromCents(plan.price_per_minute) },
+    { label: 'Features', value: (plan) => asArray(plan.features).join(', ') || '-' },
+  ]);
+}
+
 function printPlansCatalogs(payload, type) {
   if (type === 'all' || type === 'http') {
     process.stdout.write('HTTP\n');
@@ -3385,6 +3550,16 @@ function printPlansCatalogs(payload, type) {
     ]);
   }
 
+  if (type === 'all') {
+    process.stdout.write('\n');
+    printJobCatalog(payload.job);
+  }
+
+  if (type === 'job') {
+    printJobCatalog(payload.job);
+    return;
+  }
+
   if (type === 'all' || type === 'valkey' || type.startsWith('valkey-')) {
     if (type === 'all') process.stdout.write('\n');
     printValkeyCatalog(payload.valkey, valkeyProfileFilter(type));
@@ -3394,7 +3569,7 @@ function printPlansCatalogs(payload, 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, valkey.');
+    throw new CliError('Tipo de catalogo invalido. Valores aceitos: all, http, database, storage, valkey, job, key-value, cache ou queue.');
   }
 
   const payload = await fetchPlansCatalogs(session, flags, type);
@@ -3406,6 +3581,75 @@ function formatAllowedValues(values) {
   return [...values].join(', ');
 }
 
+function validateJobConfig(config) {
+  if (!isRecord(config)) throw new CliError('config deve ser um objeto.');
+
+  if (!isRecord(config.job)) throw new CliError('Jobs exigem config.job.');
+  const cron = String(config.job.cron || '').trim();
+  if (cron.split(/\s+/).filter(Boolean).length !== 5) {
+    throw new CliError('config.job.cron deve conter exatamente cinco campos em UTC.');
+  }
+  const forbiddenFields = ['instances', 'port', 'exposure', 'network_access', 'domain', 'custom_domains', 'autoscaling', 'healthcheck'];
+  const forbiddenField = forbiddenFields.find((field) => config[field] !== undefined);
+  if (forbiddenField) {
+    throw new CliError(`Jobs nao aceitam config.${forbiddenField}.`);
+  }
+  const forbiddenJobField = ['command', 'args'].find((field) => config.job[field] !== undefined);
+  if (forbiddenJobField) {
+    throw new CliError(`Jobs nao aceitam config.job.${forbiddenJobField}. A imagem ja define o comando e os argumentos.`);
+  }
+
+  if (!isRecord(config.image) || typeof config.image.url !== 'string' || !config.image.url.trim()) {
+    throw new CliError('Jobs exigem uma imagem OCI em config.image. O fluxo GitHub ainda nao esta disponivel para Jobs.');
+  }
+  const imageReference = config.image.url.trim();
+  if (imageReference.length < OCI_IMAGE_REFERENCE_MIN_LENGTH
+    || imageReference.length > OCI_IMAGE_REFERENCE_MAX_LENGTH
+    || !OCI_IMAGE_REFERENCE_PATTERN.test(imageReference)) {
+    throw new CliError('config.image.url deve ser uma referencia OCI completa com registro e tag ou digest.');
+  }
+  if (config.github !== undefined) {
+    throw new CliError('Jobs aceitam somente config.image. O fluxo GitHub ainda nao esta disponivel para Jobs.');
+  }
+
+  if (!Array.isArray(config.envs)) {
+    throw new CliError('config.envs deve ser um array.');
+  }
+  if (config.envs.length > 100) throw new CliError('config.envs nao pode conter mais de 100 variaveis.');
+  for (const env of config.envs) {
+    if (!isRecord(env) || typeof env.name !== 'string' || typeof env.value !== 'string') {
+      throw new CliError('Cada item de config.envs deve conter name e value como texto.');
+    }
+  }
+
+  if (!isRecord(config.storage)) throw new CliError('Jobs exigem config.storage.');
+  if (typeof config.storage.persistent !== 'boolean') {
+    throw new CliError('config.storage.persistent deve ser booleano.');
+  }
+  const capacity = Number(config.storage.capacity);
+  if (!Number.isInteger(capacity) || capacity < 1 || capacity > 250) {
+    throw new CliError('config.storage.capacity deve ser um inteiro entre 1 e 250 GiB.');
+  }
+  if (config.storage.persistent) {
+    if (typeof config.storage.dir_path_to_persist !== 'string' || !config.storage.dir_path_to_persist.trim()) {
+      throw new CliError('config.storage.dir_path_to_persist e obrigatorio para storage persistente.');
+    }
+  } else if (config.storage.dir_path_to_persist !== undefined) {
+    throw new CliError('config.storage.dir_path_to_persist nao e aceito para storage efemero.');
+  }
+
+  return { ...config, type_project: 'job', job: { ...config.job, cron } };
+}
+
+function validateJobPlanAndPayment(plan, paymentMode) {
+  if (!WIZARD_JOB_PLAN_OPTIONS.includes(plan)) {
+    throw new CliError(`Plano invalido para Jobs: "${plan}". Valores aceitos: ${formatAllowedValues(WIZARD_JOB_PLAN_OPTIONS)}.`);
+  }
+  if (paymentMode !== 'per_minute') {
+    throw new CliError('Jobs agendados aceitam somente o modo de pagamento per_minute.');
+  }
+}
+
 function validateCreateAutoscaling(config, plan, typeProject) {
   if (config?.autoscaling === undefined) return config;
   if (typeProject !== 'http') {
@@ -3549,13 +3793,22 @@ function validateGithubVersionDeployConfig(github) {
 function validateCreateInput({ plan, paymentMode, config, valkeyCatalog }) {
   const nextTypeProject = normalizeTypeProject(config?.type_project);
   const nextPlan = normalizePlan(plan);
+  const nextPaymentMode = normalizePaymentMode(paymentMode);
+
+  if (nextTypeProject === 'job') {
+    validateJobPlanAndPayment(nextPlan, nextPaymentMode);
+    return {
+      plan: nextPlan,
+      paymentMode: nextPaymentMode,
+      config: validateJobConfig({ ...config, type_project: nextTypeProject }),
+    };
+  }
+
   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}`);
   }
-
-  const nextPaymentMode = normalizePaymentMode(paymentMode);
-  if (!nextPaymentMode || !ALLOWED_PAYMENT_MODE_VALUES.has(nextPaymentMode)) {
-    throw new CliError(`Modo de pagamento invalido: "${paymentMode}". Valores aceitos: ${formatAllowedValues(ALLOWED_PAYMENT_MODE_VALUES)}. Docs: ${DOCS_PAYMENTS_URL}`);
+  if (!nextPaymentMode || !ALLOWED_PAYMENT_MODE_VALUES.has(nextPaymentMode) || nextPaymentMode === 'per_minute') {
+    throw new CliError(`Modo de pagamento invalido: "${paymentMode}". Valores aceitos: ${formatAllowedValues(new Set(['hourly', 'monthly', 'yearly']))}. Docs: ${DOCS_PAYMENTS_URL}`);
   }
 
   if (!nextTypeProject || !ALLOWED_TYPE_PROJECT_VALUES.has(nextTypeProject)) {
@@ -3624,10 +3877,13 @@ function maskWizardSummary(value, key = '') {
 
 function printWizardSummary(payload) {
   const masked = maskWizardSummary(payload);
+  const projectSummary = masked.config.type_project === 'job'
+    ? `  projeto: ${masked.name} | plano: ${masked.plan}`
+    : `  projeto: ${masked.name} | plano: ${masked.plan} | pagamento: ${masked.payment_mode}`;
   const lines = [
     '',
     tone('Resumo da criacao', 'green'),
-    `  projeto: ${masked.name} | plano: ${masked.plan} | pagamento: ${masked.payment_mode}`,
+    projectSummary,
     `  tipo: ${masked.config.type_project}`,
   ];
 
@@ -3649,6 +3905,12 @@ 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 === 'job') {
+    lines.push(`  Job: cron ${masked.config.job.cron} UTC | storage ${masked.config.storage.capacity}Gi (${masked.config.storage.persistent ? 'persistente' : 'efemero'})`);
+    if (masked.config.image) lines.push(`  imagem: ${masked.config.image.url} | publica: ${masked.config.image.is_public ? 'sim' : 'nao'}`);
+    if (masked.config.github) lines.push(`  github: ${masked.config.github.repository_owner}/${masked.config.github.repository_name}@${masked.config.github.branch}`);
+  }
+
   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'}`);
   }
@@ -4138,6 +4400,67 @@ async function buildValkeyConfig({ profile, plan, catalog }) {
   };
 }
 
+async function buildJobConfig() {
+  const image = {
+    url: await promptWizardText({
+      label: 'Imagem OCI da tarefa',
+      required: true,
+      examples: ['ghcr.io/example/report:1.0.0', 'registry.example.com/team/job@sha256:digest'],
+      docs: DOCS_CONFIGURATION_URL,
+      validate: (value) => {
+        const reference = value.trim();
+        return reference.length >= OCI_IMAGE_REFERENCE_MIN_LENGTH
+          && reference.length <= OCI_IMAGE_REFERENCE_MAX_LENGTH
+          && OCI_IMAGE_REFERENCE_PATTERN.test(reference)
+          ? null
+          : 'use uma referencia OCI com registro e tag ou digest';
+      },
+    }),
+    is_public: true,
+  };
+  const persistent = await promptWizardBoolean({
+    label: 'Armazenamento persistente',
+    docs: DOCS_CONFIGURATION_URL,
+    examples: ['sim', 'nao'],
+  });
+  const storage = {
+    persistent,
+    capacity: await promptWizardNumber({
+      label: 'Capacidade de armazenamento (Gi)',
+      docs: DOCS_CONFIGURATION_URL,
+      examples: ['1', '5', '10'],
+      min: 1,
+      max: 250,
+    }),
+    ...(persistent ? {
+      dir_path_to_persist: await promptWizardText({
+        label: 'Diretorio persistente',
+        required: true,
+        examples: ['/data'],
+        docs: DOCS_CONFIGURATION_URL,
+      }),
+    } : {}),
+  };
+  const envs = await promptWizardPairs({
+    introLabel: 'Deseja adicionar variaveis de ambiente?',
+    docs: DOCS_CONFIGURATION_URL,
+    examples: ['sim', 'nao'],
+    stateKey: 'jobEnvs',
+    itemLabels: [
+      { key: 'name', label: 'Nome da env', required: true, examples: ['MODE'], docs: DOCS_CONFIGURATION_URL },
+      { key: 'value', label: 'Valor da env', required: true, examples: ['daily'], docs: DOCS_CONFIGURATION_URL },
+    ],
+  });
+  const cron = await promptWizardText({
+    label: 'Cron em UTC (cinco campos)',
+    required: true,
+    examples: ['0 * * * *'],
+    docs: DOCS_CONFIGURATION_URL,
+    validate: (value) => value.split(/\s+/).filter(Boolean).length === 5 ? null : 'use exatamente cinco campos em UTC',
+  });
+  return { type_project: 'job', image, envs, storage, job: { cron } };
+}
+
 async function runProjectCreateWizard(session, flags) {
   const catalogs = await fetchWizardCatalogs(session, flags);
   const ui = createWizardUi();
@@ -4166,11 +4489,15 @@ async function runProjectCreateWizard(session, flags) {
     docs: DOCS_CONFIGURATION_URL,
     examples: WIZARD_TYPE_PROJECT_OPTIONS,
     options: WIZARD_TYPE_PROJECT_OPTIONS.map((value) => ({ value })),
+    extraValues: ['job'],
   });
   ui.state.typeProject = typeProject;
   const valkeyCatalog = typeProject === 'valkey'
     ? requireValkeyCatalog(unwrapData(await request(session, flags, 'GET', '/managed-services/catalog')))
     : undefined;
+  const jobPlans = typeProject === 'job'
+    ? requireJobPlans(unwrapData(await request(session, flags, 'GET', '/project/job/plans')))
+    : undefined;
   const profile = typeProject === 'valkey'
     ? await promptWizardSelect({
       label: 'Perfil Valkey',
@@ -4188,6 +4515,8 @@ async function runProjectCreateWizard(session, flags) {
       ? valkeyCatalog.plans
         .filter((planDefinition) => planDefinition.profile === profile)
         .map((planDefinition) => planDefinition.id)
+      : typeProject === 'job'
+        ? sortWizardOptions(jobPlans.map((plan) => plan?.plan || plan?.id).filter(Boolean), WIZARD_JOB_PLAN_OPTIONS)
     : sortWizardOptions(catalogs.databasePlans
       .map((plan) => plan?.plan)
       .filter((plan) => WIZARD_DATABASE_PLAN_OPTIONS.includes(plan) && (typeProject !== 'mariadb' || plan !== 'db-free')), WIZARD_DATABASE_PLAN_OPTIONS);
@@ -4195,7 +4524,8 @@ async function runProjectCreateWizard(session, flags) {
     label: 'Plano',
     docs: typeProject === 'http'
       ? DOCS_CREATE_HTTP_URL
-      : typeProject === 'valkey' ? DOCS_CREATE_VALKEY_URL : DOCS_DATABASE_CONFIGURATION_URL,
+      : typeProject === 'valkey' ? DOCS_CREATE_VALKEY_URL
+        : typeProject === 'job' ? DOCS_CONFIGURATION_URL : DOCS_DATABASE_CONFIGURATION_URL,
     examples: [planOptions[0], planOptions.at(-1)],
     options: planOptions.map((value) => ({ value })),
   });
@@ -4205,7 +4535,7 @@ async function runProjectCreateWizard(session, flags) {
     ui.state.planAllowsSubdomain = isSubdomainCustomizable(catalogs.httpPlans, plan);
     ui.state.planAllowsAutoscaling = isAutoscalingEnabledForPlan(catalogs.httpPlans, plan);
   }
-  const paymentMode = await promptWizardSelect({
+  const paymentMode = typeProject === 'job' ? 'per_minute' : await promptWizardSelect({
     label: 'Modo de pagamento',
     docs: DOCS_PAYMENTS_URL,
     examples: WIZARD_PAYMENT_MODE_OPTIONS,
@@ -4223,6 +4553,8 @@ async function runProjectCreateWizard(session, flags) {
     config = await buildPostgresqlConfig({ plan, databasePlans: catalogs.databasePlans });
   } else if (typeProject === 'valkey') {
     config = await buildValkeyConfig({ profile, plan, catalog: valkeyCatalog });
+  } else if (typeProject === 'job') {
+    config = await buildJobConfig();
   } else {
     config = await buildMariadbConfig();
   }
@@ -4259,13 +4591,15 @@ async function handleProjectCreate(session, flags) {
   const name = wizardPayload?.name || flags.name || await prompt('Nome do projeto');
   const description = wizardPayload?.description || flags.description;
   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 idempotencyKey = flags.idempotencyKey === undefined ? undefined : validateIdempotencyKey(flags.idempotencyKey);
   if (Array.isArray(config?.custom_domains)) {
     config.custom_domains = normalizeCustomDomains(config.custom_domains, { primaryDomain: config.domain });
   }
   const typeProject = normalizeTypeProject(config?.type_project);
+  const paymentMode = typeProject === 'job'
+    ? flags.paymentMode || 'per_minute'
+    : wizardPayload?.payment_mode || flags.paymentMode || await prompt('Modo de pagamento');
   const valkeyCatalog = typeProject === 'valkey'
     ? requireValkeyCatalog(unwrapData(await request(session, flags, 'GET', '/managed-services/catalog')))
     : undefined;
@@ -4289,14 +4623,16 @@ async function handleProjectCreate(session, flags) {
     },
   });
 
-  if (flags.json) return printJson(payload);
+  if (flags.json) {
+    return printJson(validated.config.type_project === 'job' ? sanitizeJobProjectResponse(payload) : payload);
+  }
   if (wizardPayload) {
     closePromptResources();
   }
   const project = unwrapData(payload);
   const rows = [
     { field: 'Projeto', value: projectIdOf(project) || 'id indisponivel' },
-    ...(project.domain ? [{ field: 'Dominio', value: formatPublicUrl(project.domain) }] : []),
+    ...(validated.config.type_project === 'job' ? [] : project.domain ? [{ field: 'Dominio', value: formatPublicUrl(project.domain) }] : []),
     ...(project.api_key ? [{ field: 'API key', value: project.api_key }] : []),
   ];
   if (validated.config.type_project === 'valkey') {
@@ -4331,7 +4667,9 @@ async function handleProjectInfo(session, flags) {
   const orgId = await resolveOrgId(session, flags);
   const project = await getProject(session, flags, projectId, orgId);
 
-  if (flags.json) return printJson(projectInfoForOutput(project));
+  if (flags.json) return printJson(projectInfoForOutput(
+    isJobProject(project) ? sanitizePublicProject(project) : project,
+  ));
   printProject({ ...project, id: projectId });
 }
 
@@ -4544,6 +4882,231 @@ async function handleProjectLogs(session, flags) {
   printLogs(logs, flags);
 }
 
+const PUBLIC_JOB_RUN_KEYS = [
+  'status',
+  'scheduled_at',
+  'started_at',
+  'finished_at',
+  'duration_seconds',
+  'billed_minutes',
+  'plan',
+  'currency',
+  'amount',
+];
+
+function sanitizeJobRun(run) {
+  if (!run || typeof run !== 'object' || Array.isArray(run)) return {};
+  const output = {};
+  const id = run.id || run._id || run.run_id;
+  if (id !== undefined) output.id = id;
+  for (const key of PUBLIC_JOB_RUN_KEYS) {
+    if (run[key] !== undefined) output[key] = run[key];
+  }
+  return output;
+}
+
+function jobRunsDataOf(data) {
+  if (Array.isArray(data)) return { runs: data.map(sanitizeJobRun), pagination: null };
+  if (!data || typeof data !== 'object') return { runs: [], pagination: null };
+  return {
+    runs: Array.isArray(data.runs) ? data.runs.map(sanitizeJobRun) : [],
+    pagination: data.pagination ?? null,
+  };
+}
+
+function sanitizeJobRunResponse(data) {
+  if (data && typeof data === 'object' && !Array.isArray(data) && data.run !== undefined) {
+    return { run: sanitizeJobRun(data.run) };
+  }
+  return sanitizeJobRun(data);
+}
+
+function formatJobRunDuration(durationSeconds) {
+  if (durationSeconds === undefined || durationSeconds === null || !Number.isFinite(Number(durationSeconds))) return '-';
+  return `${Number(Number(durationSeconds).toFixed(1))} s`;
+}
+
+function formatJobRunAmount(run) {
+  const amount = run.amount;
+  if (amount === undefined || amount === null) return '-';
+  return formatJobBrlFromCents(amount);
+}
+
+function printJobRuns(data) {
+  const runs = asArray(data?.runs);
+  printTable(runs, [
+    { label: 'ID', value: (run) => run.id || '-' },
+    { label: 'Status', value: (run) => run.status || '-' },
+    { label: 'Agendada', value: (run) => run.scheduled_at || '-' },
+    { label: 'Iniciada', value: (run) => run.started_at || '-' },
+    { label: 'Finalizada', value: (run) => run.finished_at || '-' },
+    { label: 'Duracao', value: (run) => formatJobRunDuration(run.duration_seconds) },
+    { label: 'Minutos cobrados', value: (run) => run.billed_minutes ?? '-' },
+    { label: 'Valor', value: formatJobRunAmount },
+  ]);
+  printPagination(data?.pagination, 'execucao');
+}
+
+function sanitizeJobRunLogEntries(logs) {
+  if (!Array.isArray(logs)) return logs;
+  return logs.map((entry) => {
+    if (typeof entry === 'string') return entry;
+    if (!entry || typeof entry !== 'object') return String(entry ?? '');
+    return Object.fromEntries(['sequence', 'timestamp', 'level', 'message']
+      .filter((key) => entry[key] !== undefined)
+      .map((key) => [key, entry[key]]));
+  });
+}
+
+function sanitizeJobRunLogs(data) {
+  if (typeof data === 'string') return data;
+  if (Array.isArray(data)) return sanitizeJobRunLogEntries(data);
+  if (!data || typeof data !== 'object') return data;
+  const output = {};
+  for (const key of ['logs', 'next_cursor', 'truncated', 'finished', 'status']) {
+    if (data[key] !== undefined) output[key] = key === 'logs' ? sanitizeJobRunLogEntries(data[key]) : data[key];
+  }
+  return output;
+}
+
+function skipTerminalString(text, index) {
+  while (index < text.length) {
+    const code = text.charCodeAt(index);
+    if (code === 0x07 || code === 0x9c) return index + 1;
+    if (code === 0x1b && text.charCodeAt(index + 1) === 0x5c) return index + 2;
+    index += 1;
+  }
+  return index;
+}
+
+function skipTerminalCsi(text, index) {
+  while (index < text.length) {
+    const code = text.charCodeAt(index);
+    index += 1;
+    if (code >= 0x40 && code <= 0x7e) break;
+  }
+  return index;
+}
+
+function skipTerminalEscape(text, index) {
+  const next = text.charCodeAt(index);
+  if (next >= 0x30 && next <= 0x7e) return index + 1;
+  while (index < text.length && text.charCodeAt(index) >= 0x20 && text.charCodeAt(index) <= 0x2f) {
+    index += 1;
+  }
+  if (index < text.length && text.charCodeAt(index) >= 0x30 && text.charCodeAt(index) <= 0x7e) {
+    return index + 1;
+  }
+  return index;
+}
+
+function stripTerminalControls(value) {
+  const text = String(value ?? '');
+  let output = '';
+  let index = 0;
+
+  while (index < text.length) {
+    const code = text.charCodeAt(index);
+    if (code === 0x1b) {
+      const next = text.charCodeAt(index + 1);
+      if (next === 0x5d) {
+        index = skipTerminalString(text, index + 2);
+      } else if (next === 0x50 || next === 0x58 || next === 0x5e || next === 0x5f) {
+        index = skipTerminalString(text, index + 2);
+      } else if (next === 0x5b) {
+        index = skipTerminalCsi(text, index + 2);
+      } else {
+        index = skipTerminalEscape(text, index + 1);
+      }
+      continue;
+    }
+    if (code === 0x9b) {
+      index = skipTerminalCsi(text, index + 1);
+      continue;
+    }
+    if (code === 0x9d || code === 0x90 || code === 0x98 || code === 0x9e || code === 0x9f) {
+      index = skipTerminalString(text, index + 1);
+      continue;
+    }
+    if ((code <= 0x1f && code !== 0x09 && code !== 0x0a) || code === 0x7f || (code >= 0x80 && code <= 0x9f)) {
+      index += 1;
+      continue;
+    }
+    output += text[index];
+    index += 1;
+  }
+
+  return output;
+}
+
+function printHumanJobRunLogs(logs) {
+  if (Array.isArray(logs)) {
+    for (const log of logs) {
+      const line = typeof log === 'string' ? log : buildLogLineOf(log);
+      process.stdout.write(`${stripTerminalControls(line)}\n`);
+    }
+    return;
+  }
+  const value = logs || '';
+  process.stdout.write(`${stripTerminalControls(value)}${String(value).endsWith('\n') ? '' : '\n'}`);
+}
+
+async function handleProjectRuns(session, flags) {
+  const projectId = requireProjectId(flags, 'project runs');
+  if (!projectId) return;
+  validateProjectListFlags(flags, { maxLimit: 50 });
+  const orgId = await resolveOrgId(session, flags);
+  const query = buildQuery(flags, ['page', 'limit']);
+  const data = jobRunsDataOf(unwrapData(await request(session, flags, 'GET', `/project/${projectId}/job-runs${query}`, { orgId })));
+
+  if (flags.json) return printJson(data);
+  printJobRuns(data);
+}
+
+async function handleProjectRunCancel(session, flags) {
+  const projectId = requireProjectId(flags, 'project runs cancel');
+  if (!projectId) return;
+  if (!flags.run && !flags.runId || flags.run === true || flags.runId === true) {
+    printCommandHelpAndFail('project runs cancel');
+    return;
+  }
+  const runId = String(flags.run || flags.runId);
+  const orgId = await resolveOrgId(session, flags);
+  const data = unwrapData(await request(
+    session,
+    flags,
+    'POST',
+    `/project/${projectId}/job-runs/${encodeURIComponent(runId)}/cancel`,
+    { orgId, body: {} },
+  ));
+
+  if (flags.json) return printJson(sanitizeJobRunResponse(data));
+  const run = data?.run || data;
+  process.stdout.write(`Execucao: ${run?.status || 'cancelled'}\n`);
+}
+
+async function handleProjectRunLogs(session, flags) {
+  const projectId = requireProjectId(flags, 'project runs logs');
+  if (!projectId) return;
+  if (!flags.run && !flags.runId || flags.run === true || flags.runId === true) {
+    printCommandHelpAndFail('project runs logs');
+    return;
+  }
+  const runId = String(flags.run || flags.runId);
+  const orgId = await resolveOrgId(session, flags);
+  const data = sanitizeJobRunLogs(unwrapData(await request(
+    session,
+    flags,
+    'GET',
+    `/project/${projectId}/job-runs/${encodeURIComponent(runId)}/logs`,
+    { orgId },
+  )));
+
+  if (flags.json) return printJson(data);
+  const logs = typeof data === 'object' && data !== null && !Array.isArray(data) ? data.logs : data;
+  printHumanJobRunLogs(logs);
+}
+
 async function handleProjectMetricsCapabilities(session, flags) {
   const projectId = requireProjectId(flags, 'project metrics capabilities');
   if (!projectId) return;
@@ -5536,6 +6099,10 @@ async function main() {
     if (command === 'project' && subcommand === 'resume') return handleProjectLifecycleMutation(session, flags, 'resume');
     if (command === 'project' && subcommand === 'delete') return handleProjectDelete(session, flags);
     if (command === 'project' && subcommand === 'url') return handleProjectUrl(session, flags);
+    if (command === 'project' && subcommand === 'runs' && positional[2] === 'cancel') return handleProjectRunCancel(session, flags);
+    if (command === 'project' && subcommand === 'runs' && positional[2] === 'logs') return handleProjectRunLogs(session, flags);
+    if (command === 'project' && subcommand === 'runs') return handleProjectRuns(session, flags);
+    if (command === 'project' && subcommand === 'run' && positional[2] === 'logs') return handleProjectRunLogs(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);

package/examples/job-project.json

@@ -0,0 +1,20 @@
+{
+  "type_project": "job",
+  "image": {
+    "url": "ghcr.io/example/report:1.0.0",
+    "is_public": true
+  },
+  "envs": [
+    {
+      "name": "MODE",
+      "value": "daily"
+    }
+  ],
+  "storage": {
+    "persistent": false,
+    "capacity": 1
+  },
+  "job": {
+    "cron": "0 3 * * *"
+  }
+}

package/package.json

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