type: object
description: |
    Result of running the Big Order checklist — what action the state machine
    thinks should happen next. Returned by `GET /admin/shop/order/{bigOrderId}/checklist`,
    embedded on `BigOrder.checklistResult`, and surfaced inside `runBigOrderChecklistAll`'s
    summary.

    `success: false` is **not** an API failure — it means the checklist ran
    cleanly but the order isn't ready to advance. Callers that treat any
    non-success as fatal will mishandle this.
required: [success]
properties:
    success: { type: boolean }
    nextAction:
        type: string
        description: |
            Suggested next action. Values are from `FabricatorSchemas.BigOrderAction`
            (e.g. `SendScanRequest`, `AdminOverrideIPD`, `CreateJob`, `CreateShipment`,
            `ShipIt`, `Complete`, `Unknown`).
    message:
        type: string
        description: "Human-readable explanation, especially when `success: false`."
    metaData:
        description: Optional action-specific structured payload.
example:
    success: true
    nextAction: "CreateJob"
    message: "Scan request verified; ready to spawn job."
    metaData: { scanRequestId: "scan_01HXJ58DQX5N9P2VRC8B3MZ7Y4" }
