@neetru/cli 2.19.0 → 2.20.0

package/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 Convenção: [Keep a Changelog](https://keepachangelog.com/) + [SemVer](https://semver.org/).
 
+## [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.
+
+### Corrigido
+
+- **Loop infinito de re-render** — o Ink usa `process.stdout.write` internamente pra desenhar sua própria UI (prompt, barra de status). Como o painel também interceptava `process.stdout.write` globalmente (pra capturar `printEvent`/`printBox`/etc), toda vez que o Ink se redesenhava isso disparava `setState` → novo re-render do Ink → nova escrita → capturada de novo → loop. Fix: o Ink agora usa um `Writable` stream próprio que escreve direto no stdout real, sem passar pela interceptação — os dois nunca mais se cruzam.
+
+### Adicionado
+
+- **Banner Neetru** (`log.banner`, logo + "logado como…") no topo da sessão interativa — mesmo banner usado nos outros pontos de entrada da CLI.
+
 ## [2.19.0] — 2026-07-10 (`neetru code` — painel persistente: histórico + status fixo + progresso ao vivo)
 
 > Feedback direto: o 2.18.0 só resolvia a captura da próxima linha (montava/desmontava Ink por turno) — a barra de status e o indicador de progresso ainda desapareciam durante o processamento. Essa versão reescreve pra um app Ink genuinamente persistente.

package/dist/commands/code.d.ts

@@ -1,5 +1,5 @@
 import { type CodeAgentState } from '../lib/code-agent-session.js';
-import type { CodeMessage, CodeCommandOptions, CodeSettings, ConfirmFn } from '../lib/code-agent-types.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;
 /**
@@ -15,7 +15,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