Sanity Library Reference Docs
    Preparing search index...
    StuckCause:
        | { documents: MissingDocument[]; kind: "document-missing" }
        | { effect: EffectHistoryEntry; kind: "failed-effect" }
        | { effect: PendingEffect; kind: "hung-effect" }
        | { activity: string; kind: "failed-activity" }
        | { kind: "no-transition-fires" }
        | { kind: "transition-unevaluable"; transitions: string[] }

    A fault or missing dependency in an in-flight instance. Missing documents follow effect/activity faults and precede transition faults. The diagnosis is advisory: it does not prohibit actions that can still run. An active activity awaiting a human action is the healthy Diagnosis waiting state.

    transition-unevaluable is the recoverable arm: every activity resolved, but an exit transition's when came back GROQ null (a referenced operand is missing or unreadable), so selection halts and the cascade re-fires once the operand resolves — where no-transition-fires means every when is a definite false. It carries the undecidable transitions.