Hospitality

{
  "id": "context-reference",
  "label": "Context reference",
  "kind": "Record",
  "group": "Homes & places",
  "description": "A place and why it matters, with explicit guest-profile or trip scope.",
  "fields": [
    {
      "name": "id",
      "type": "string",
      "required": true,
      "description": "Stable record ID; on Guest Profile, the legacy guest-ID alias.",
      "schema": {
        "type": "string",
        "maxLength": 120
      }
    },
    {
      "name": "guestId",
      "type": "string",
      "required": true,
      "description": "The Guest this record concerns.",
      "schema": {
        "type": "string",
        "maxLength": 120
      }
    },
    {
      "name": "scope",
      "type": "guest | brief",
      "required": true,
      "description": "Guest-profile or active-trip ownership of a place reference.",
      "schema": {
        "enum": [
          "guest",
          "brief"
        ]
      }
    },
    {
      "name": "briefId",
      "type": "string | null",
      "required": true,
      "description": "Active trip reference for trip scope; null for reusable guest scope.",
      "schema": {
        "type": [
          "string",
          "null"
        ]
      }
    },
    {
      "name": "label",
      "type": "string",
      "required": true,
      "schema": {
        "type": "string",
        "minLength": 1,
        "maxLength": 120
      }
    },
    {
      "name": "category",
      "type": "Work | Lifestyle | Transport | Other",
      "required": true,
      "schema": {
        "enum": [
          "Work",
          "Lifestyle",
          "Transport",
          "Other"
        ]
      }
    },
    {
      "name": "lat",
      "type": "number",
      "required": true,
      "schema": {
        "type": "number",
        "minimum": 49.15,
        "maximum": 49.4
      }
    },
    {
      "name": "lng",
      "type": "number",
      "required": true,
      "schema": {
        "type": "number",
        "minimum": -123.35,
        "maximum": -122.9
      }
    },
    {
      "name": "notes",
      "type": "string",
      "required": true,
      "description": "Ordinary freeform notes in the owning record.",
      "schema": {
        "type": "string",
        "maxLength": 2000
      }
    },
    {
      "name": "status",
      "type": "suggested | confirmed",
      "required": true,
      "schema": {
        "enum": [
          "suggested",
          "confirmed"
        ]
      }
    },
    {
      "name": "placeId",
      "type": "string | null",
      "required": false,
      "schema": {
        "type": [
          "string",
          "null"
        ]
      }
    },
    {
      "name": "source",
      "type": "object",
      "required": true,
      "schema": {
        "type": "object"
      }
    },
    {
      "name": "createdBy",
      "type": "object",
      "required": true,
      "schema": {
        "type": "object"
      }
    },
    {
      "name": "updatedBy",
      "type": "object",
      "required": true,
      "schema": {
        "type": "object"
      }
    },
    {
      "name": "confirmedBy",
      "type": "object | null",
      "required": true,
      "schema": {
        "type": [
          "object",
          "null"
        ]
      }
    },
    {
      "name": "relationship",
      "type": "pinned | relevant | profile-context | itinerary-option",
      "required": false,
      "description": "Pinned guest preference, relevant trip place, or unclassified older profile context.",
      "schema": {
        "enum": [
          "pinned",
          "relevant",
          "profile-context",
          "itinerary-option"
        ],
        "description": "Reference role. itinerary-option is a brief-scoped candidate place, not a reservation, scheduled visit or durable guest favourite."
      }
    },
    {
      "name": "preferenceEvidence",
      "type": "object | null",
      "required": false,
      "description": "The guest’s expressed interest as recorded by the concierge; not authenticated guest approval.",
      "schema": {
        "type": [
          "object",
          "null"
        ],
        "description": "Guest-stated interest, recordedBy/recordedAt and guestConfirmation null. Required by service for new profile pins."
      }
    },
    {
      "name": "planningOrigin",
      "type": "object | null",
      "required": false,
      "description": "Server-verified source session, point and dataset lineage.",
      "schema": {
        "type": [
          "object",
          "null"
        ],
        "description": "Planning session/point IDs, dataset hash, original source/evidence and generating actor, assigned by service."
      }
    }
  ],
  "rules": [
    "Guest scope is reusable and has no brief ID. Trip scope binds to the active brief.",
    "Suggested context is not treated as a confirmed fact.",
    "Creator, source and confirming concierge are separate attributions.",
    "New profile pins require a concierge-recorded statement of the guest’s expressed interest. Hermes cannot pin profile favourites.",
    "Earlier guest references remain profile-context until explicitly reviewed; no liking is inferred by migration.",
    "Explicit promotion from a planning point carries its source session and dataset lineage.",
    "Trip-scoped itinerary-option references are candidates, not scheduled visits, reservations or profile favourites."
  ],
  "facts": [
    {
      "label": "Identity",
      "value": "context.referencePoints[].id"
    },
    {
      "label": "Owner",
      "value": "Concierge confirms; Hermes may propose."
    }
  ],
  "links": [
    {
      "label": "can reference",
      "target": "place-document",
      "note": "0..* → 0..1"
    },
    {
      "label": "may be promoted from",
      "target": "planning-point",
      "note": "0..* → 0..1"
    }
  ]
}