Skip to content

fix: engines Claude/Codex viram checagem informativa — instalador nunca bloqueia - #17

Merged
elberrd merged 1 commit into
mainfrom
fix/engines-opcionais-preflight
Aug 14, 2026
Merged

fix: engines Claude/Codex viram checagem informativa — instalador nunca bloqueia#17
elberrd merged 1 commit into
mainfrom
fix/engines-opcionais-preflight

Conversation

@elberrd

@elberrd elberrd commented Aug 14, 2026

Copy link
Copy Markdown
Owner

Problema

No Windows (modo guest), o passo [2/27] Prerequisite: Claude Code abortava o install com "Claude Code is required — run this installer again" quando o binário não existia — e ainda perguntava "já fez login?" com base numa heurística de keychain não confiável.

O gate não tinha razão de existir: o instalador nunca executa um agente. O claude só é usado em claude mcp add (que já degrada com aviso e comando manual) e o login do Codex sempre foi o último passo, dentro do Pi. Quem consome os engines é o profissional, depois do install — obrigar login no começo era fricção dupla.

Mudanças

  • preflight: ensureClaudeCodecheckEngines (status only, nunca bloqueia, nunca pergunta). Sonda claude no PATH + login Codex (piCodexReady), grava em ctx.engines, avisa com o comando de instalação e segue. Sem nenhum dos dois: nota explicando que os melhores resultados vêm com Claude/Codex, mas dá para logar outros providers/modelos depois via /login no Pi. Heurística de login do claude removida (o próprio CLI guia o login no primeiro uso).
  • finish: painel único "Engines — who runs your agents" — estado de cada engine re-sondado na hora do resumo (a pessoa pode ter instalado no meio do run) com o comando exato do que faltar. A visão consolidada fica no FINAL, onde a decisão pertence ao profissional.
  • README (Requirements) e DOCS (tabela do prelúdio): Claude Code/Codex passam a "recomendado, não obrigatório".
  • teste: checkEngines com PATH vazio precisa resolver sem prompt/exit — um gate reintroduzido trava ou mata a suite.

Verificação

  • npm test — 723/723 verdes
  • npm run lint — limpo

🤖 Generated with Claude Code

…ca mais bloqueia

O gate "Prerequisite: Claude Code" abortava o install (process.exit) quando o
binário não existia e ainda perguntava sobre login com heurística não
confiável — mas o instalador nunca executa um agente: claude só serve para
`claude mcp add` (que já degrada) e o login do Codex sempre foi o último
passo, dentro do Pi. Quem usa os engines é o profissional, depois do install.

- preflight: ensureClaudeCode → checkEngines (status only): sonda claude no
  PATH + login Codex, avisa com o comando de instalação e segue; sem nenhum
  dos dois, nota "melhores resultados com um deles, mas dá para usar outros
  providers/modelos depois via /login no Pi". Sem prompt, sem exit; heurística
  de login do claude removida (o próprio CLI guia o login no primeiro uso).
- finish: painel único "Engines — who runs your agents" com o estado de cada
  engine re-sondado na hora e o comando exato do que faltar.
- README (Requirements) e DOCS (tabela do prelúdio) atualizados: recomendado,
  não obrigatório.
- teste: checkEngines com PATH vazio precisa resolver sem travar — guarda
  contra reintroduzir o gate.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@elberrd
elberrd merged commit b3db509 into main Aug 14, 2026
7 checks passed
@elberrd
elberrd deleted the fix/engines-opcionais-preflight branch August 14, 2026 18:49
elberrd added a commit that referenced this pull request Aug 14, 2026
)

Bump de release para publicar o #17: o gate "Prerequisite: Claude Code" virou
checagem informativa (nunca bloqueia, nunca pergunta) e o resumo final ganhou
o painel "Engines — who runs your agents" com os comandos exatos do que faltar.

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant