@nio-cli/cli 0.10.1 → 0.11.0

package/.env.example

@@ -1,114 +1,118 @@
-# Database connection string
-# CLI/MCP: role `nio_cli` (migration 0008) — SELECT em user_cli/auth_sessions,
-# escreve só em sessions/dependency_events/log_session/session_activity.
-NIO_DATABASE_URL=postgres://nio_cli_user:senha@localhost:5432/nio_cli
-
-# Gateway: role `nio_gateway` — escreve em user_cli/auth_sessions/login_challenges/
-# auth_events/login_ip_events. Só o processo nio-gateway lê esta var; se ausente,
-# ele cai em NIO_DATABASE_URL (dev com um único role).
-# NIO_GATEWAY_DATABASE_URL=postgres://nio_gw_user:senha@localhost:5432/nio_cli
-
-# TLS — LIGADO POR PADRÃO em banco remoto (não-loopback), com verificação de
-# cert. Exceções: banco em loopback (dev local, sem TLS) ou opt-out explícito:
-# NIO_DATABASE_SSL=false
-# Com TLS ligado, o certificado do servidor É VERIFICADO. CA privada:
-# NIO_DATABASE_CA=/etc/ssl/nio/db-ca.pem
-# Último recurso — desliga a verificação de cert (expõe a MITM). Prefira NIO_DATABASE_CA:
-# NIO_DATABASE_SSL_INSECURE=1
-
-# Gateway — JWT (login v2). Sem prefixo NIO_ de propósito: segredo da equipe,
-# mesmo valor em toda máquina que roda o nio-gateway.
-# Mínimo 32 caracteres aleatórios. Gere com: `nio config setup` ou
-#   node -e "console.log(require('crypto').randomBytes(32).toString('base64url'))"
-JWT_SECRET=
-# JWT_EXPIRES_IN=12h
-
-# ── Endurecimento de cripto (ADR 0011) — tudo opcional, defaults = comportamento atual ──
-#
-# Pepper de senha: segredo de servidor combinado à senha antes do argon2. Um dump
-# do banco SEM ele não dá pra brute-forçar offline. MESMO valor em todo nó do
-# gateway. PERDER = reset de senha forçado dos usuários peppered — FAÇA BACKUP.
-# Formato: id:segredo[,id:segredo] — o de maior id é o atual (rotação: adiciona o
-# novo, o re-hash on login migra, depois remove o velho). Gere: openssl rand -base64 32
-# NIO_PEPPERS=1:troque-por-um-segredo-forte-de-32-ou-mais-chars
-#
-# Chave do HMAC do OTP — separa do JWT_SECRET. Default = JWT_SECRET.
-# OTP_HMAC_SECRET=
-#
-# Rotação de JWT sem derrubar sessão: JWT_SECRETS = kid:segredo[,kid:segredo].
-# A ÚLTIMA entrada assina os tokens novos; QUALQUER uma verifica. Token antigo
-# (sem kid) verifica contra JWT_SECRET. Fluxo: adiciona o kid novo no fim →
-# deploy → espera 12h (TTL do JWT) → remove o kid velho. Ausente = usa JWT_SECRET.
-# JWT_SECRETS=2026a:segredo-antigo-de-32+-chars,2026b:segredo-novo-de-32+-chars
-#
-# Params do argon2id — defaults = piso OWASP. Calibre na máquina do gateway com
-#   node scripts/argon2-calibrate.mjs        (ou `bun run argon2:calibrate`)
-# mire ~250-500 ms no hash. Subir só re-hasheia no próximo login (não é breaking).
-# NIO_ARGON2_MEMORY_MIB=19
-# NIO_ARGON2_TIME=2
-# NIO_ARGON2_PARALLELISM=1
-#
-# Auditoria de IP de login (ADR 0011 §F) — o gateway registra de quais IPs cada
-# usuário loga (visível em `nio security status`; retenção 90 d). SÓ registro,
-# não bloqueia. Ligue NIO_TRUST_PROXY=1 pra usar o X-Forwarded-For **apenas** se
-# o Kong for a ÚNICA entrada do gateway (senão o IP é forjável).
-# NIO_TRUST_PROXY=1
-
-# Trilha de auth persistente (ADR 0012) — `auth_events` guarda todo evento de auth
-# (login OK/falho, 2FA, mudanças de 2FA, logout). Retenção default 180 d.
-# NIO_AUTH_EVENTS_RETENTION_DAYS=180
-# No modo HOST (sem container), o stdout/stderr do gateway — incl. a trilha —
-# vai pra ~/.nio/gateway.log (chmod 600).
-#
-# Teto de sessões (dispositivos) ativas por usuário (SP-5). Login além disso
-# revoga as mais antigas. `nio logout --all` encerra todas de uma vez.
-# NIO_MAX_SESSIONS_PER_USER=5
-#
-# Checagem de senha vazada (SP-7): lista local (sempre) + Have I Been Pwned
-# (k-anonymity — só o prefixo do SHA-1 sai; falha de rede = ignora).
-# NIO_HIBP_DISABLE=1        # desliga o HIBP (ambiente sem saída pra internet)
-# NIO_HIBP_TIMEOUT_MS=1500
-
-# Bind do nio-gateway. Default 127.0.0.1 (loopback). Ponha 0.0.0.0 quando o Kong
-# roda em container e alcança o gateway via host.docker.internal.
-# NIO_GATEWAY_HOST=0.0.0.0
-# Onde a CLI acha o gateway. Default http://127.0.0.1:3000 (o nio-gateway direto).
-# Com Kong na frente: http://127.0.0.1:8000.
-# NIO_GATEWAY_URL=http://127.0.0.1:8000
-# Porta do proxy Kong publicada no host pelo `dev:kong` (default 8000).
-# NIO_KONG_PROXY_PORT=8010
-
-# 2º fator (WhatsApp OTP via Meta Graph) — spec 0004 / ADR 0006. Sem endpoint
-# + token, o login com auth_2 responde 503 "2FA não configurado" (o login de
-# 1 fator segue normal).
-# WHATSAPP_ENDPOINT_URL=https://graph.facebook.com/v25.0/1076830002188066/messages
-# WHATSAPP_TOKEN=<bearer da Meta Graph>           # app secret; rotaciona ~24h
-# WHATSAPP_TEMPLATE_NAME=autenticao               # template de autenticação aprovado
-# WHATSAPP_TEMPLATE_LANGUAGE=pt_BR                # variação do template
-#
-# DEV: se WHATSAPP_ENDPOINT_URL for loopback (127.0.0.1/localhost — o mock
-# `bun run dev:whatsapp-echo`), o gateway entra em "modo echo": NENHUM WhatsApp real sai.
-# A CLI avisa e mostra o código direto; `nio security status` mostra o backend.
-
-# Client de IA (nio ai) — backend OpenAI-compatível que o provider `opencode`
-# consome (o SDK anexa /chat/completions). Estes são os knobs da "troca" do client.
-# Motor = provider DEDICADO (openai-compatible) direto no backend; o provider `opencode`
-# fica no default (big-pickle), fora do motor da CLI.
-# NIO_AI_PROVIDER=nio-local                                # id do provider dedicado no opencode.json
-# NIO_AI_BASE_URL=http://192.168.0.140:8001/v1            # backend de IA (default); raiz /v1
-# NIO_AI_MODEL=RedHatAI/Qwen3.8-27B-INT4                 # id do model EXATO que o backend serve (sem prefixo de provider)
-# NIO_AI_CONTEXT=65536                                    # janela de contexto (tokens) declarada p/ o model; 0 = usa catálogo
-# NIO_AI_OUTPUT=2048                                       # teto de tokens de saída reservados dentro da janela
-# NIO_AI_MAX_INPUT=32000                                  # hard cap de input por prompt (0 = desativa a trava)
-# NIO_SKILLS_DESC_CHARS=200                             # teto das descrições em prompts/list e resources/list (0 = sem corte)
-# NIO_SKILLS_PROMPT_CHARS=12000                         # orçamento do texto montado por get_prompt (apoio excedente vira resource sob demanda; 0 = sem teto)
-# ^ NIO_AI_* NÃO valem no .env do projeto (cwd é allowlist) — ponha em ~/.nio/config.env ou no shell.
-#
-# Headroom — proxy de compressão em container (ADR 0007), DORMENTE (ADR 0010).
-# NIO_HEADROOM_PORT=8787                                  # porta do proxy no host
-# NIO_HEADROOM_URL=http://127.0.0.1:8787/v1               # override total (o provider do OpenCode aponta pra cá)
-# NIO_HEADROOM_OPENAI_TARGET=https://opencode.ai/zen/v1   # upstream OpenAI-compatível (default: OpenCode Zen)
-
-# Debug 
-# NIO_DEBUG=1      # log verboso [nio:debug] + stack trace completo nos erros
-# NIO_NO_ANIM=1    # logo Matrix sempre estático (sem a animação de chuva)
+# Database connection string
+# CLI/MCP: role `nio_cli` (migration 0008) — SELECT em user_cli/auth_sessions,
+# escreve só em sessions/dependency_events/log_session/session_activity.
+NIO_DATABASE_URL=postgres://nio_cli_user:senha@localhost:5432/nio_cli
+
+# Gateway: role `nio_gateway` — escreve em user_cli/auth_sessions/login_challenges/
+# auth_events/login_ip_events. Só o processo nio-gateway lê esta var; se ausente,
+# ele cai em NIO_DATABASE_URL (dev com um único role).
+# NIO_GATEWAY_DATABASE_URL=postgres://nio_gw_user:senha@localhost:5432/nio_cli
+
+# TLS — LIGADO POR PADRÃO em banco remoto (não-loopback), com verificação de
+# cert. Exceções: banco em loopback (dev local, sem TLS) ou opt-out explícito:
+# NIO_DATABASE_SSL=false
+# Com TLS ligado, o certificado do servidor É VERIFICADO. CA privada (ou o próprio
+# cert self-signed, pra pinning):
+# NIO_DATABASE_CA=/etc/ssl/nio/db-ca.pem
+# Cert cujo SAN é um NOME mas você conecta por IP: verifica o hostname contra este
+# nome (o do SAN) sem afrouxar a verificação — evita ERR_TLS_CERT_ALTNAME_INVALID:
+# NIO_DATABASE_SSL_SERVERNAME=nome-no-san-do-cert
+# Último recurso — desliga a verificação de cert (expõe a MITM). Prefira NIO_DATABASE_CA:
+# NIO_DATABASE_SSL_INSECURE=1
+
+# Gateway — JWT (login v2). Sem prefixo NIO_ de propósito: segredo da equipe,
+# mesmo valor em toda máquina que roda o nio-gateway.
+# Mínimo 32 caracteres aleatórios. Gere com: `nio config setup` ou
+#   node -e "console.log(require('crypto').randomBytes(32).toString('base64url'))"
+JWT_SECRET=
+# JWT_EXPIRES_IN=12h
+
+# ── Endurecimento de cripto (ADR 0011) — tudo opcional, defaults = comportamento atual ──
+#
+# Pepper de senha: segredo de servidor combinado à senha antes do argon2. Um dump
+# do banco SEM ele não dá pra brute-forçar offline. MESMO valor em todo nó do
+# gateway. PERDER = reset de senha forçado dos usuários peppered — FAÇA BACKUP.
+# Formato: id:segredo[,id:segredo] — o de maior id é o atual (rotação: adiciona o
+# novo, o re-hash on login migra, depois remove o velho). Gere: openssl rand -base64 32
+# NIO_PEPPERS=1:troque-por-um-segredo-forte-de-32-ou-mais-chars
+#
+# Chave do HMAC do OTP — separa do JWT_SECRET. Default = JWT_SECRET.
+# OTP_HMAC_SECRET=
+#
+# Rotação de JWT sem derrubar sessão: JWT_SECRETS = kid:segredo[,kid:segredo].
+# A ÚLTIMA entrada assina os tokens novos; QUALQUER uma verifica. Token antigo
+# (sem kid) verifica contra JWT_SECRET. Fluxo: adiciona o kid novo no fim →
+# deploy → espera 12h (TTL do JWT) → remove o kid velho. Ausente = usa JWT_SECRET.
+# JWT_SECRETS=2026a:segredo-antigo-de-32+-chars,2026b:segredo-novo-de-32+-chars
+#
+# Params do argon2id — defaults = piso OWASP. Calibre na máquina do gateway com
+#   node scripts/argon2-calibrate.mjs        (ou `bun run argon2:calibrate`)
+# mire ~250-500 ms no hash. Subir só re-hasheia no próximo login (não é breaking).
+# NIO_ARGON2_MEMORY_MIB=19
+# NIO_ARGON2_TIME=2
+# NIO_ARGON2_PARALLELISM=1
+#
+# Auditoria de IP de login (ADR 0011 §F) — o gateway registra de quais IPs cada
+# usuário loga (visível em `nio security status`; retenção 90 d). SÓ registro,
+# não bloqueia. Ligue NIO_TRUST_PROXY=1 pra usar o X-Forwarded-For **apenas** se
+# o Kong for a ÚNICA entrada do gateway (senão o IP é forjável).
+# NIO_TRUST_PROXY=1
+
+# Trilha de auth persistente (ADR 0012) — `auth_events` guarda todo evento de auth
+# (login OK/falho, 2FA, mudanças de 2FA, logout). Retenção default 180 d.
+# NIO_AUTH_EVENTS_RETENTION_DAYS=180
+# No modo HOST (sem container), o stdout/stderr do gateway — incl. a trilha —
+# vai pra ~/.nio/gateway.log (chmod 600).
+#
+# Teto de sessões (dispositivos) ativas por usuário (SP-5). Login além disso
+# revoga as mais antigas. `nio logout --all` encerra todas de uma vez.
+# NIO_MAX_SESSIONS_PER_USER=5
+#
+# Checagem de senha vazada (SP-7): lista local (sempre) + Have I Been Pwned
+# (k-anonymity — só o prefixo do SHA-1 sai; falha de rede = ignora).
+# NIO_HIBP_DISABLE=1        # desliga o HIBP (ambiente sem saída pra internet)
+# NIO_HIBP_TIMEOUT_MS=1500
+
+# Bind do nio-gateway. Default 127.0.0.1 (loopback). Ponha 0.0.0.0 quando o Kong
+# roda em container e alcança o gateway via host.docker.internal.
+# NIO_GATEWAY_HOST=0.0.0.0
+# Onde a CLI acha o gateway. Default http://127.0.0.1:3000 (o nio-gateway direto).
+# Com Kong na frente: http://127.0.0.1:8000.
+# NIO_GATEWAY_URL=http://127.0.0.1:8000
+# Porta do proxy Kong publicada no host pelo `dev:kong` (default 8000).
+# NIO_KONG_PROXY_PORT=8010
+
+# 2º fator (WhatsApp OTP via Meta Graph) — spec 0004 / ADR 0006. Sem endpoint
+# + token, o login com auth_2 responde 503 "2FA não configurado" (o login de
+# 1 fator segue normal).
+# WHATSAPP_ENDPOINT_URL=https://graph.facebook.com/v25.0/1076830002188066/messages
+# WHATSAPP_TOKEN=<bearer da Meta Graph>           # app secret; rotaciona ~24h
+# WHATSAPP_TEMPLATE_NAME=autenticao               # template de autenticação aprovado
+# WHATSAPP_TEMPLATE_LANGUAGE=pt_BR                # variação do template
+#
+# DEV: se WHATSAPP_ENDPOINT_URL for loopback (127.0.0.1/localhost — o mock
+# `bun run dev:whatsapp-echo`), o gateway entra em "modo echo": NENHUM WhatsApp real sai.
+# A CLI avisa e mostra o código direto; `nio security status` mostra o backend.
+
+# Client de IA (nio ai) — backend OpenAI-compatível que o provider `opencode`
+# consome (o SDK anexa /chat/completions). Estes são os knobs da "troca" do client.
+# Motor = provider DEDICADO (openai-compatible) direto no backend; o provider `opencode`
+# fica no default (big-pickle), fora do motor da CLI.
+# NIO_AI_PROVIDER=nio-local                                # id do provider dedicado no opencode.json
+# NIO_AI_BASE_URL=http://192.168.0.140:8001/v1            # backend de IA (default); raiz /v1
+# NIO_AI_MODEL=RedHatAI/Qwen3.8-27B-INT4                 # id do model EXATO que o backend serve (sem prefixo de provider)
+# NIO_AI_CONTEXT=65536                                    # janela de contexto (tokens) declarada p/ o model; 0 = usa catálogo
+# NIO_AI_OUTPUT=2048                                       # teto de tokens de saída reservados dentro da janela
+# NIO_AI_MAX_INPUT=32000                                  # hard cap de input por prompt (0 = desativa a trava)
+# NIO_SKILLS_DESC_CHARS=200                             # teto das descrições em prompts/list e resources/list (0 = sem corte)
+# NIO_SKILLS_PROMPT_CHARS=12000                         # orçamento do texto montado por get_prompt (apoio excedente vira resource sob demanda; 0 = sem teto)
+# ^ NIO_AI_* NÃO valem no .env do projeto (cwd é allowlist) — ponha em ~/.nio/config.env ou no shell.
+#
+# Headroom — proxy de compressão em container (ADR 0007), DORMENTE (ADR 0010).
+# NIO_HEADROOM_PORT=8787                                  # porta do proxy no host
+# NIO_HEADROOM_URL=http://127.0.0.1:8787/v1               # override total (o provider do OpenCode aponta pra cá)
+# NIO_HEADROOM_OPENAI_TARGET=https://opencode.ai/zen/v1   # upstream OpenAI-compatível (default: OpenCode Zen)
+
+# Debug 
+# NIO_DEBUG=1      # log verboso [nio:debug] + stack trace completo nos erros
+# NIO_NO_ANIM=1    # logo Matrix sempre estático (sem a animação de chuva)

package/Dockerfile.gateway

@@ -1,20 +1,20 @@
-# Build reprodutível (auditoria M-2 + I-3a): um lockfile só (`bun.lock`), imagens
-# pinadas por digest. Multi-stage — o Bun resolve as deps com o lockfile
-# congelado; o runtime continua sendo Node (o alvo do projeto).
-
-# --- deps: instala node_modules de runtime a partir do bun.lock ---
-FROM oven/bun:1-slim@sha256:cb3bbbb08e13a4a2ff400f24c7a2a1d5efa83f6ef8544d52d95a519631e2fc61 AS deps
-WORKDIR /app
-COPY package.json bun.lock ./
-RUN bun install --frozen-lockfile --production
-
-# --- runtime: Node + curl (healthcheck do compose) ---
-FROM node:20-slim@sha256:2cf067cfed83d5ea958367df9f966191a942351a2df77d6f0193e162b5febfc0
-RUN apt-get update && apt-get install -y --no-install-recommends curl \
-    && rm -rf /var/lib/apt/lists/*
-WORKDIR /app
-COPY --from=deps /app/node_modules ./node_modules
-COPY package.json ./
-COPY dist ./dist
-EXPOSE 3000
-CMD ["node", "dist/gateway/index.js"]
+# Build reprodutível (auditoria M-2 + I-3a): um lockfile só (`bun.lock`), imagens
+# pinadas por digest. Multi-stage — o Bun resolve as deps com o lockfile
+# congelado; o runtime continua sendo Node (o alvo do projeto).
+
+# --- deps: instala node_modules de runtime a partir do bun.lock ---
+FROM oven/bun:1-slim@sha256:cb3bbbb08e13a4a2ff400f24c7a2a1d5efa83f6ef8544d52d95a519631e2fc61 AS deps
+WORKDIR /app
+COPY package.json bun.lock ./
+RUN bun install --frozen-lockfile --production
+
+# --- runtime: Node + curl (healthcheck do compose) ---
+FROM node:20-slim@sha256:2cf067cfed83d5ea958367df9f966191a942351a2df77d6f0193e162b5febfc0
+RUN apt-get update && apt-get install -y --no-install-recommends curl \
+    && rm -rf /var/lib/apt/lists/*
+WORKDIR /app
+COPY --from=deps /app/node_modules ./node_modules
+COPY package.json ./
+COPY dist ./dist
+EXPOSE 3000
+CMD ["node", "dist/gateway/index.js"]