doctor --format agent

Fast diagnostics before expensive live checks. Returns structured JSON for agents.

npx prodverdict doctor --format agent --config prodverdict.yml

Sample output

{
  "schemaVersion": "1",
  "ok": false,
  "checks": [
    {
      "name": "config:valid",
      "status": "pass",
      "message": "prodverdict.yml is valid — 2 contract(s) defined."
    },
    {
      "name": "access:env:STRIPE_SECRET_KEY",
      "status": "fail",
      "message": "Missing or empty env var \"STRIPE_SECRET_KEY\"."
    }
  ]
}

When to use

• Agent starting a billing or migration task
• CI debugging missing secrets
• MCP doctor tool (same logic)

MCP

Local MCP exposes doctor as a tool. Remote MCP does not replace access credential checks — use local doctor before live access runs.