Hospitality

{
  "id": "planning-session",
  "label": "Planning session",
  "kind": "Record",
  "group": "Homes & places",
  "description": "A working map dataset of generated references. It can be kept with the brief for later review without becoming requirements or favourites.",
  "fields": [
    {
      "name": "schema",
      "type": "\"zendo.planning-session/v1\"",
      "required": true,
      "schema": {
        "const": "zendo.planning-session/v1"
      }
    },
    {
      "name": "id",
      "type": "string",
      "required": true,
      "description": "Stable record ID; on Guest Profile, the legacy guest-ID alias.",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "guestId",
      "type": "string",
      "required": true,
      "description": "The Guest this record concerns.",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "briefId",
      "type": "string",
      "required": true,
      "description": "Active trip reference for trip scope; null for reusable guest scope.",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "briefRevision",
      "type": "integer",
      "required": true,
      "schema": {
        "type": "integer",
        "minimum": 1
      }
    },
    {
      "name": "input",
      "type": "object",
      "required": true,
      "schema": {
        "type": "object"
      }
    },
    {
      "name": "inputHash",
      "type": "string",
      "required": true,
      "description": "Digest of the profile/brief/reference input used to detect stale planning context.",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "workspaceVersion",
      "type": "integer",
      "required": true,
      "schema": {
        "type": "integer",
        "minimum": 1
      }
    },
    {
      "name": "createdBy",
      "type": "object",
      "required": true,
      "schema": {
        "type": "object"
      }
    },
    {
      "name": "createdAt",
      "type": "string",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "method",
      "type": "string",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "retention",
      "type": "working | retained",
      "required": true,
      "description": "Working map or retained brief-linked review snapshot.",
      "schema": {
        "enum": [
          "working",
          "retained"
        ]
      }
    },
    {
      "name": "points",
      "type": "array",
      "required": true,
      "schema": {
        "type": "array",
        "maxItems": 50,
        "items": {
          "$ref": "#/$defs/PlanningPoint"
        }
      }
    },
    {
      "name": "datasetHash",
      "type": "string",
      "required": true,
      "description": "Integrity fingerprint of the exact generated point dataset; not signed external proof.",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "keptAt",
      "type": "string",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "keptBy",
      "type": "object",
      "required": false,
      "schema": {
        "type": "object"
      }
    }
  ],
  "rules": [
    "Generate replaces only the working map; keep freezes a separate brief-linked review snapshot.",
    "Working sessions survive local restart until regenerated or discarded. No automatic expiry is claimed.",
    "Keep preserves inputs, revisions, point sources, generating actor, method and dataset hash. No evaluation or training is executed.",
    "Changed profile/brief/reference inputs mark the working map stale. Historical snapshots retain their original meaning.",
    "Discard removes only the working dataset. Kept snapshots and operational history remain."
  ],
  "facts": [
    {
      "label": "Identity",
      "value": "planningSession.id; retained snapshots in planningSessions[].id"
    },
    {
      "label": "Owner",
      "value": "Concierge/Hermes planning workflow, linked to one guest and brief revision."
    }
  ],
  "links": [
    {
      "label": "plans for",
      "target": "trip-brief",
      "note": "0..* → 1"
    },
    {
      "label": "contains generated reference",
      "target": "planning-point",
      "note": "1 → 0..*"
    }
  ]
}