Config Doctor¶

Readiness you can trust — know before you run.

Config Doctor tells you, before you spend compute, whether a run is ready, and if not, exactly why and how to fix it. Available today (engine + case API).

The Case Lifecycle¶

stateDiagram-v2
    [*] --> Open: createConfigDoctorCase
    Open --> Validated: validateConfigDoctorCase
    Validated --> Repaired: planConfigDoctorRepair
    Validated --> Finalized: finalizeConfigDoctorCaseForRun
    Repaired --> Finalized
    Finalized --> [*]

Core Operations¶

Operation	Purpose
`createConfigDoctorCase`	Open a readiness case
`getConfigDoctorCase`	Inspect a case
`validateConfigDoctorCase`	Validate configuration; returns a gate outcome
`planConfigDoctorRepair`	Deterministic repair recommendations
`finalizeConfigDoctorCaseForRun`	Finalize a case so a run may proceed

The Pinned Evidence Surface¶

The Config Doctor routes the platform currently lowers as authoritative EAA evidence:

Operation	Method	Path
`createConfigDoctorCase`	POST	`/config-doctor/cases`
`getConfigDoctorCase`	GET	`/config-doctor/cases/{case_id}`
`finalizeConfigDoctorCaseForRun`	POST	`/config-doctor/cases/{case_id}:finalize-for-run`
`planConfigDoctorRepair`	POST	`/config-doctor/cases/{case_id}:plan-repair`
`validateConfigDoctorCase`	POST	`/config-doctor/cases/{case_id}:validate`

Gate Outcomes¶

Outcome	Meaning	Your next step
`RUNNABLE`	Ready	Proceed to governance/run
`RUNNABLE_WITH_APPROVED_WARNINGS`	Ready with accepted warnings	Ensure waivers are recorded
`BLOCKED_MISSING_INPUT`	Required input missing	Supply the named input, re-validate
`BLOCKED_CONFIG_INCONSISTENT`	Configuration conflict	Apply repair plan, re-validate

A Defining Rule¶

Config Doctor may recommend; it may not self-approve. Repair plans are deterministic; approval remains a governed human decision (see Governance).

What This Means For Integration¶

Always validate before requesting a run; treat a non-RUNNABLE outcome as a hard stop in your pipeline.
Use the repair plan to drive automated remediation, then re-validate.
Persist the gate outcome — it is part of the evidence trail for the run.