Software & interfaces

{
  "id": "provenance-event",
  "label": "Provenance event",
  "kind": "Record",
  "group": "Decisions & evidence",
  "description": "A visible command, actor, input and revision linked to earlier local history.",
  "fields": [
    {
      "name": "command / commandId",
      "type": "string",
      "description": "Operation and idempotency identity.",
      "required": true
    },
    {
      "name": "actor",
      "type": "Actor",
      "description": "The acting session.",
      "required": true
    },
    {
      "name": "guestId / briefId",
      "type": "references",
      "description": "Guest and active-trip context on new events.",
      "required": true
    },
    {
      "name": "guestRevision / tripBriefRevision",
      "type": "integer",
      "description": "Record-local revision counters on new events.",
      "required": true
    },
    {
      "name": "briefVersion",
      "type": "integer",
      "description": "Legacy name for workspace revision.",
      "required": true
    },
    {
      "name": "source / details",
      "type": "object",
      "description": "Source scope and visible command input.",
      "required": true
    },
    {
      "name": "previousHash / hash",
      "type": "string | null",
      "description": "Local ledger integrity links.",
      "required": true
    },
    {
      "name": "trainingEligibility",
      "type": "excluded | pending-review",
      "description": "Review intent, not consent or training.",
      "required": true
    }
  ],
  "rules": [
    "A local hash chain is not signed external evidence or provider reconciliation.",
    "Historical event hashes are preserved by additive migrations.",
    "Workspace revision and trip revision are different counters."
  ],
  "facts": [
    {
      "label": "Identity",
      "value": "events[].id and commandId"
    },
    {
      "label": "Owner",
      "value": "Shared service command path."
    }
  ],
  "links": [
    {
      "label": "records active context",
      "target": "trip-brief",
      "note": "0..* → 1"
    }
  ]
}