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. Once the operand resolves, the next tick or commit re-checks the transitions, and the instance advances only if one is then satisfied. transition-unevaluable carries the undecidable transitions declared before the first satisfied one, and is reported even when a later transition is satisfied: that transition does not fire until the held ones resolve. no-transition-fires means every when is a definite false.