verbatra doctor

Responde una pregunta antes de ejecutar cualquier otra cosa: ¿este proyecto está bien configurado? doctor valida la configuración, el adaptador de formato, el proveedor, la variable de la clave de API y el archivo de locale fuente, y luego informa de todos los problemas que encontró a la vez. No gasta nada: no construye ningún proveedor, no hace ninguna petición de red, no escribe ningún archivo y nunca lee el valor de una clave de API.

Úsalo en un checkout recién clonado, justo después de verbatra init, o cuando otro comando falle y quieras la lista completa en lugar del primer error. verbatra check es la validación más barata una vez que el proyecto ya funciona, pero lee los archivos de locale y se detiene en el primer error global, así que no puede decirte qué falla en un proyecto que todavía no tiene archivo fuente.

Sinopsis

verbatra doctor [flags]

Flags

Qué comprueba

Todas las comprobaciones se ejecutan aunque una anterior haya fallado, así que una sola ejecución informa de cada problema independiente. La única excepción es la propia configuración: cuando no se puede cargar, las cuatro comprobaciones que la necesitan informan skip en lugar de un veredicto al que no pudieron llegar.

Tres detalles importan:

• La clave de API se comprueba solo por nombre. doctor pregunta si la variable está definida, nunca qué contiene. El valor no se lee, no se imprime y no se envía a ninguna parte. Consulta Proveedores para saber qué variable usa cada proveedor.
• El proveedor openai-compatible es la excepción. Recurre a una clave de marcador de posición, así que una variable ausente no es problema. Solo falla cuando tu config nombra su propia variable con provider.options.apiKeyEnvVar y esa variable no está definida.
• Un archivo de locale destino que falta no es un problema: verbatra translate lo crea. Un archivo de locale fuente que falta sí lo es, porque todos los demás comandos fallan por él.

Igual que verbatra translate, doctor carga .env.local y luego .env desde el directorio de trabajo antes de mirar el entorno, así que una clave guardada en un archivo dotenv cuenta como definida.

Ejemplos

# report every setup problem at once
verbatra doctor

# validate a project in another directory, with an explicit config
verbatra doctor --cwd apps/web --config verbatra.config.ts

# machine-readable report for a CI preflight step
verbatra doctor --json

Una ejecución con dos problemas se ve así:

verbatra doctor
  [ok  ] Configuration: Loaded /app/verbatra.config.ts.
  [ok  ] Format adapter: Format "i18next-json" resolves to an adapter.
  [ok  ] Provider: Provider "anthropic" resolves to a factory.
  [fail] API key environment variable: The ANTHROPIC_API_KEY environment variable is not set.
  [fail] Source locale file: The source locale file was not found at /app/locales/en.json.
2 problems found (run verbatra doctor again after fixing them)

Códigos de salida

La salida 1 significa "se ejecutó y encontró problemas". La salida 2 queda reservada a que doctor no pueda ejecutarse en absoluto, por eso un archivo de config que la búsqueda no encuentra es una comprobación fallida y salida 1, mientras que una ruta --config que apunta a la nada es salida 2.

Relacionado

• verbatra init genera la config y el .env.example que doctor valida.
• verbatra check es el control de deriva que ejecutas una vez que la configuración es correcta.
• El archivo de configuración documenta todas las claves que doctor valida.
• Proveedores lista la variable de clave de API que lee cada proveedor.