run-doctor

To run a read-only health check for GTM-OS, execute the diagnostics tool to verify environment, SQLite schema, configuration, provider connectivity, and runtime layers. It groups results by layer using PASS, FAIL, WARN, and SKIP statuses without modifying your files.

A YALC diagnostics report shows a structured per-layer breakdown of environment, SQLite schema, and runtime checks. It flags failing configurations with actionable statuses and surfaces direct dashboard routes to resolve provider connection issues.

Yes, you can validate framework and user configuration non-invasively. The diagnostic process executes strictly read-only checks across all layers, ensuring your current setup, database, and configuration files remain unmodified during the health verification.

To get direct links for expired keys or missing DSN issues, run the YALC health diagnostics. It automatically detects provider failures and surfaces one-click dashboard routes using /keys/connect/<provider> URLs for immediate resolution.

If you run diagnostics during ongoing GTM-OS onboarding, the tool detects the in-flight setup and asks whether you want to run the health check against the current incomplete state or resume the setup process first.

Your YALC setup might not work due to hidden failures in SQLite schema, runtime state, or live provider connectivity. A 5-layer health diagnosis identifies the exact failing layer and provides direct links to fix provider-specific issues.