Skip to content

feat: imp doctor — checkup somente-leitura de assinaturas, CLIs, Pi e projeto - #22

Merged
elberrd merged 1 commit into
mainfrom
feat/imp-doctor
Aug 16, 2026
Merged

feat: imp doctor — checkup somente-leitura de assinaturas, CLIs, Pi e projeto#22
elberrd merged 1 commit into
mainfrom
feat/imp-doctor

Conversation

@elberrd

@elberrd elberrd commented Aug 16, 2026

Copy link
Copy Markdown
Owner

O que é

imp doctor (e imp doctor --json): checkup somente detecção — nunca instala, nunca abre login, nunca reescreve arquivo. Cada achado termina no comando exato que o aluno roda para resolver. Os irmãos que remediam continuam com seus próprios fluxos de consentimento: imp init, imp update, npx impactus --update-runtime, npx impactus --verify.

Seções

  1. Engines (assinaturas) — Claude Code no PATH, login Codex dentro do Pi (~/.pi/agent/auth.json), Cursor CLI (cursor-agent). Informativos, nunca erro — qual assinatura usar é decisão do profissional. Sem probe de login do claude (mesma razão documentada no preflight).
  2. Core CLIs — piso do Node (22.12), git, npm; gh/vercel como opcionais.
  3. Pi & imp — Pi + versão, os 3 pacotes de extensão (novo piPackageStatus(): pinned/custom/unpinned/missing) e o mesmo probe de updates do launcher (timebox 4 s, offline-tolerante).
  4. Projeto (quando rodado dentro de um) — runtime da FIA presente, higiene do .mcp.json (npx sem -y morre com cache frio — a lição do "Connection closed" virou checagem permanente) e resumo da auditoria do --verify (top 8 achados + ponteiro para o relatório completo).

Exit 0 = nenhum achado de nível erro; --json imprime { ok, sections } sem banner (mesma convenção do --version).

Registro do comando

  • imp help (bin/imp.js)
  • README (bloco de comandos)
  • DOCS §14.3 (tabela do launcher) + receita 15.7
  • Painel de engines do finish: "Re-check this roster anytime with imp doctor."

Checagens

  • npm test: 732 pass (6 novos em test/doctor.test.js — regra pura do .mcp.json + contrato do relatório em fixtures temp)
  • npm run lint: limpo
  • Smoke real na máquina: roster completo detectado, updates pendentes reportados, --json com exit 0

🤖 Generated with Claude Code

… projeto

Novo comando do launcher, só detecção por contrato (nunca instala, loga ou
reescreve nada — cada achado termina no comando exato que resolve):

- Engines (assinaturas): claude no PATH, login Codex dentro do Pi
  (~/.pi/agent/auth.json) e cursor-agent — informativos, nunca erro; sem
  probe de login do claude (mesma razão do preflight).
- Core CLIs: piso do Node, git, npm; gh/vercel como opcionais.
- Pi & imp: versão do Pi, os 3 pacotes de extensão pinados
  (piPackageStatus, com estado unpinned do fallback offline) e o mesmo
  probe de updates do launcher, com timebox de 4 s.
- Projeto (quando dentro de um): runtime da FIA, higiene do .mcp.json
  (npx sem -y morre com cache frio — lição do "Connection closed") e
  resumo da auditoria do --verify (relatório completo segue lá).

--json imprime { ok, sections } sem banner; exit 0 = nenhum achado de
nível erro. Registrado no help do imp, README, DOCS §14.3 e painel de
engines do finish ("re-check anytime with imp doctor").

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@elberrd
elberrd merged commit 5aff810 into main Aug 16, 2026
@elberrd
elberrd deleted the feat/imp-doctor branch August 16, 2026 00:48
elberrd added a commit that referenced this pull request Aug 16, 2026
…-y (#24)

Publica as PRs #21/#22/#23: o fix do "Connection closed" do Playwright no
Windows (npx -y no registro do MCP), o checkup somente-leitura `imp doctor`
(assinaturas, CLIs, Pi e projeto, com --json) e o `imp fix` restore-only
(plano + consentimento, gate de git, manifest do stamp do harness gravado
pelo instalador).

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