@neetru/cli 2.19.1 → 2.20.1

package/CHANGELOG.md

@@ -2,6 +2,33 @@
 
 Convenção: [Keep a Changelog](https://keepachangelog.com/) + [SemVer](https://semver.org/).
 
+## [2.20.1] — 2026-07-11 (`neetru code` — retry automático quando o pool de IA fica sem capacidade)
+
+> O fix de roteamento do 2.20.0 estava correto (o modelo recomendado É nativo do Groq), mas ainda batia em `503 Nenhum provider de IA disponível` — investigando via Firestore, achei a causa real: as 3 keys Groq do pool entraram em cooldown SIMULTÂNEO (429 do próprio Groq — rate-limit de conta, não bug de roteamento), com `cooldownUntil` ~60-90s no futuro. Sem nenhuma key elegível no momento, o Core responde 503 na hora — o usuário precisava reenviar a mesma mensagem manualmente.
+
+### Corrigido
+
+- **Retry curto e automático (GAP-M1-21)** — `runAgentTask` agora tenta de novo automaticamente (até 2x, aguardando 20s e depois 40s, com o spinner mostrando a contagem) quando o erro é especificamente `503 ai_unavailable` (pool do provider forçado momentaneamente sem key elegível). Qualquer outro erro (payload, auth, etc.) continua falhando na hora — retry só faz sentido pra esse caso específico, que se autorresolve assim que o cooldown expira.
+
+## [2.20.0] — 2026-07-11 (`neetru code` — indicador único de progresso, fix 503 do catálogo, effort/ultracode/autosave)
+
+> Feedback direto do uso real (transcript colado pelo usuário): o 2.19.1 ainda imprimia uma linha por evento (`[...] AI Gateway turno X/Y`, `[tool]`, `[ok]`) — poluição visual que já tínhamos tentado resolver antes com o painel persistente, mas faltava trocar o loop de turnos em si. No mesmo transcript, uma sessão real bateu em `503 Nenhum provider de IA disponível` mesmo com Groq saudável no pool.
+
+### Corrigido
+
+- **Indicador de progresso único por tarefa** — `runAgentTask` (`commands/code.ts`) agora usa UM spinner vivo (turno/tool/resultado viram `detail` do mesmo spinner, não uma linha nova por evento) em vez de `printEvent` por turno/tool-call/tool-result. Avisos/erros reais (histórico compactado, streaming caiu pro fallback sem stream) continuam aparecendo como linha permanente — só o progresso normal ficou compacto.
+- **503 "nenhum provider disponível" usando o modelo recomendado do catálogo** — `neetru code -m <nome nativo do catálogo>` sem `--provider`/`gatewayProvider` caía no roteamento livre (WRRR); se sorteasse uma key do provider errado, o modelo dava 404 lá (não-retryable) e a chamada inteira falhava mesmo com o provider certo saudável no pool. `resolveCodeProvider` agora infere o provider automaticamente quando o `model` bate com um nome nativo conhecido do catálogo curado (Groq/NVIDIA).
+- **Aviso `DEP0190` do Node vazando por cima do spinner** — `run_tests` chamava `spawnSync('npm', ['test','--silent'], {shell:true})` no Windows; Node deprecia `shell:true` combinado com array de args. Corrigido montando o comando inteiro como string quando `shell` é necessário.
+- **Warnings do processo (`process.emitWarning`, ex: o DEP0190 acima) vazavam por cima do painel fixo** — eles escrevem direto em `process.stderr.write`, contornando tanto a interceptação de stdout quanto `console.warn`/`console.error`. O painel Ink agora intercepta `process.stderr.write` também.
+
+### Adicionado
+
+- **`--effort <low|medium|high>`** (flag do comando `code`) e **`/effort`** (slash command da sessão interativa) — controle de esforço de raciocínio, encaminhado como `reasoningEffort` pro AI Gateway do Core, que só repassa de verdade pra Groq/OpenAI (nunca pra NVIDIA — histórico de travar em campo OpenAI-compat desconhecido). Persistível via `neetru config set gatewayEffort <nivel>`.
+- **`--ultracode`** (flag) e **`/ultracode`** (toggle na sessão interativa) — preset de sessão longa/densa: 24 turnos (vs 8 default), 32768 tokens, effort alto, tudo de uma vez em vez de lembrar de 3 flags.
+- **Checkpoint automático de sessão** — a cada turno da sessão interativa, a conversa é salva silenciosamente em `.neetru/code/sessions/_autosave.md` (sobrescrito, não acumula 1 arquivo por turno). Aparece primeiro em `/resume`, marcado `[auto]` — sessão longa que fecha/crasha sem `/save` manual não fica mais irrecuperável.
+- **Ferramentas que mutam estado — git/gh/shell (GAP-M1-19)** — `git_commit`/`git_branch`/`git_push`/`gh_pr_create`/`shell_exec` novas em `code-agent-git-tools.ts`. `git_commit`/`git_branch` são locais/reversíveis e seguem o padrão do patch (`--yes` dispensa confirmação); `git_push`, `gh_pr_create` e `shell_exec` **sempre** pedem confirmação mostrando a ação exata, **ignorando `--yes`** — nunca auto-executam, nem push forçado é suportado. `shell_exec` roda sandboxado no cwd do projeto, com timeout e saída redigida/clipada.
+- **Subagentes — iniciar/parar tarefas delegadas (GAP-M1-20)** — `/agents start|list|stop|result|apply` na sessão interativa. Cada subagente roda concorrentemente em modo plano e silencioso (nunca aplica patch sozinho, nunca imprime durante a execução — só uma notificação ao terminar), histórico isolado, limite de 4 simultâneos. Aplicar um patch proposto por um subagente passa pelo mesmo fluxo de confirmação de um patch normal.
+
 ## [2.19.1] — 2026-07-11 (`neetru code` — crash "Maximum update depth exceeded" no painel persistente)
 
 > Achado imediatamente ao testar o 2.19.0 de verdade: o painel travava com um crash do React assim que abria.

package/dist/commands/code.d.ts

@@ -1,7 +1,13 @@
 import { type CodeAgentState } from '../lib/code-agent-session.js';
-import type { CodeMessage, CodeCommandOptions, CodeSettings, ConfirmFn } from '../lib/code-agent-types.js';
+import { type TurnSpinner } from '../lib/code-agent-ui.js';
+import type { CodeMessage, CodeCommandOptions, CodeSettings, ConfirmFn, AgentTaskOutcome, RunAgentTaskOptions } from '../lib/code-agent-types.js';
 export type { CodeMessage, CodeCommandOptions, CodeSettings } from '../lib/code-agent-types.js';
 export declare function resolveSettings(opts: CodeCommandOptions): CodeSettings;
+export declare function isProviderPoolUnavailable(error: unknown): boolean;
+export declare function callGatewayWithProgressRetrying(settings: CodeSettings, messages: CodeMessage[], spinner: TurnSpinner, baseDetail: string, silent: boolean, signal?: AbortSignal): Promise<{
+    content: string;
+    spinner: TurnSpinner;
+}>;
 /**
  * `history` e mutado e reaproveitado entre chamadas: e o que da ao modo
  * interativo memoria de conversa entre turnos do REPL (como Claude Code/Codex),
@@ -15,7 +21,7 @@ export declare function resolveSettings(opts: CodeCommandOptions): CodeSettings;
  * AI Gateway inteiro. Cada chamada de runAgentTask e um ciclo completo
  * (comeca e termina em idle/applied/failed/aborted).
  */
-export declare function runAgentTask(task: string, settings: CodeSettings, confirm: ConfirmFn, history?: CodeMessage[], onState?: (state: CodeAgentState) => void): Promise<void>;
+export declare function runAgentTask(task: string, settings: CodeSettings, confirm: ConfirmFn, history?: CodeMessage[], onState?: (state: CodeAgentState) => void, options?: RunAgentTaskOptions): Promise<AgentTaskOutcome>;
 /**
  * Entrada a partir do menu interativo do CLI (`neetru` sem args / `neetru ui`).
  * Usa settings default (cwd do processo) e gerencia o raw-mode do stdin como