navori
navori

doctor

Audit del proyecto: config, plugins, drift, invariants y próximos pasos sugeridos.

Uso 

navori doctor [--json] [--strict]

Flags

--json Output estructurado para CI (pipeable).
--strict Exit 1 cuando hay drift o .mcp.json incoherente con el manifest de un plugin (intended for CI gates).

Ejemplos

Diagnóstico

$ navori doctor
Config · navori.config.json
Managed blocks · 5
! drift: .claude/agents/orchestrator.md editado a mano
Próximos pasos · corre 'navori sync --interactive'

Notas

  • Corre doctor en CI con --strict para fallar el build si hay drift no resuelto.
  • 'harnessVersion' (clave opcional de navori.config.json) guarda la última versión de navori que aplicó un cambio real; solo la escribe un --apply de render/sync/adopt que escribió o borró algo, y nunca baja. Si es mayor que el CLI que corre doctor, aparece el hallazgo 'harness' y --strict falla.
  • Ya no hay drift de 'version' por bloque ni 'staleBlocks': 'version' en un marker es la versión que cambió el contenido por última vez. En --json, DriftReport.kind pasa a downgrade|harness|content (cambio incompatible para quien consuma el JSON).
  • Valida invariants: substrings load-bearing que deben sobrevivir en el output (exit 2 si faltan).
  • El estado de confianza de Codex se lee de $CODEX_HOME/config.toml si CODEX_HOME está definido, y de ~/.codex/config.toml si no; un valor relativo se rechaza.
  • Con el engine codex habilitado, también revisa cada git worktree del repo que tenga .codex/config.toml: advierte con el hook, la ruta y 'cd <ruta> && navori codex trust' si falta aprobarlo. Advierte además si el codex instalado es más nuevo que la última versión verificada. Si git o el disco fallan, degrada a un aviso.
  • Si algún hook renderizado llama a 'navori', advierte cuando el 'navori' global del PATH es más viejo que el CLI que corre doctor (ejecutaría lógica vieja); nunca cambia ok.
  • Avisa, solo como dato informativo, cuando hay una versión estable más nueva de una herramienta externa con latestRelease en su manifest (hoy, engram), y advierte cuando la versión instalada está por debajo de un piso conocido como defectuoso (hoy, engram < 3.0.0). Ninguno de los dos cambia el veredicto ni --strict.