@pandi-coding-agent/pandi-doctor

Agrega /doctor, un atajo dentro de la sesión para correr el chequeo de entorno de pandi-extensions. Sirve para responder “¿mi máquina está bien configurada?” sin salir del chat. Usa el mismo reporte de solo lectura que npm run doctor, a un comando de distancia.

Inicio rápido

/doctor

pandi-extensions doctor

Obligatorios:
  ✓ Node.js 22.19.0 — ≥ 22.19.0
...

✓ Todos los requisitos obligatorios están presentes.

El comando busca scripts/doctor.mjs, lo ejecuta y muestra el reporte como un mensaje info (si pasan todos los controles obligatorios), error (si el script sale con código distinto de cero o vence el tiempo) o warning (si no encuentra el script).

Instalación

| Modo | Comando | Cuándo usarlo | | ----------------- | ------------------------------------------------- | --------------------------------------- | | Desde npm | pi install npm:@pandi-coding-agent/pandi-doctor | Uso independiente, fuera de este repo | | Global | pi install ./extensions/pandi-doctor | Querés /doctor en todas las sesiones | | Local al proyecto | pi install -l ./extensions/pandi-doctor | Solo este proyecto debe tener /doctor | | Prueba puntual | pi --no-extensions -e ./extensions/pandi-doctor | Querés probarlo sin cargar nada más |

Comandos

| Comando | Qué hace | | --------- | -------------------------------------------------------------------------- | | /doctor | Ejecuta el chequeo de entorno (scripts/doctor.mjs) y muestra el reporte. |

Cómo funciona

• Sube desde el cwd de la sesión buscando una copia del working tree (<repo>/extensions/pandi-doctor/scripts/doctor.mjs), así el desarrollo dentro del repo siempre usa la versión más nueva; si no, cae en la copia vendorizada que viene en el tarball de npm para instalaciones independientes.
• Lo ejecuta con node usando un array de argv — nunca una shell string — y captura la salida con NO_COLOR activado, así el reporte queda en texto plano.
• El handler pasa al proceso hijo el agent-dir, el directorio de configuración del proyecto y el binario efectivos de la distribución host. En Picante inspecciona su perfil aislado y prueba picante; en desarrollo, PI_DYNAMIC_WORKFLOWS_PI_COMMAND sigue teniendo precedencia para usar el wrapper local.
• En Windows, el probe ejecuta con node.exe el entrypoint declarado en package.json#bin, usando argv explícito y sin abrir una shell. En POSIX conserva el nombre nominal del binario.
• Los recursos opcionales se buscan en el agent-dir efectivo y en el proyecto de la sesión (node_modules, .agents y <config-dir>/skills). Sin overrides, el fallback vanilla sigue siendo ~/.pi/agent y pi.
• Corre el script como un proceso hijo resuelto en runtime en vez de importarlo: un import estático rompería el bundling, así que la extensión siempre lo carga de forma dinámica.

Límites y seguridad

• Las instalaciones independientes se degradan con honestidad: sincronización global de Claude reporta N/A fuera del repo de la suite, las consultas a node_modules locales usan el cwd de la sesión y el chequeo de doble copia saltea la detección del working tree.
• Bajo Picante o Pandi, la disponibilidad de packages y skills no se infiere desde el perfil vanilla ~/.pi: el doctor sólo usa el perfil efectivo que recibió del host.
• Durante el onboarding, antes de pi install ./ + /reload, usá npm run doctor en su lugar: /doctor solo existe una vez cargada la extensión.
• El proceso externo de /doctor vence a los 120 segundos y lo reporta como error. Podés sobrescribirlo con PI_DOCTOR_TIMEOUT_MS cuando un entorno más lento necesite más margen.
• Los probes internos también tienen límite: PI_DOCTOR_PROBE_TIMEOUT_MS controla los probes rápidos de binarios/git (por defecto 8s) y PI_DOCTOR_SYNC_TIMEOUT_MS controla los checks de sincronización del repo (por defecto 20s).
• Los overrides de timeout usan milisegundos y se clavan como mínimo en 1000ms; los valores inválidos vuelven a los defaults en vez de desactivar la protección.

Relacionado

Para obtener el paquete completo de extensiones y skills, instalá la raíz del repositorio.