v5

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-211355122.6 KB

Get Schedule Diagnosis

Diagnose hard-constraint feasibility for a submitted session configuration.

Args: schedule_id: Unique identifier of the session to diagnose.

Returns: Full structured diagnosis including cores, domains, repairs, provenance, completeness metadata, timing, and solver status.

Raises: HTTPException: Status 404 when no session exists or status 422 if scheduler initialization fails. Unhandled executor failures become server errors.

Behavior: Scheduler initialization is awaited, then diagnosis runs on the shared Z3 executor while holding the session generation lock so it cannot race model enumeration or auditing. Internal immutable contracts are copied into API response models, and successful access refreshes the session TTL.

get/schedules/{schedule_id}/diagnosis

Path parameters

schedule_idstring required

Response

Successful Response

schedule_idstring required
status'satisfiable' | 'unsatisfiable' | 'unknown' required
configuration_fingerprintstring nullable required
core_is_minimalboolean nullable required
alternative_cores_completeboolean nullable required
repair_sets_completeboolean nullable required
diagnostic_completenessstring required
diagnostic_versionstring required
elapsed_msinteger required
solver_timeout_msinteger nullable required
reasonstring nullable required