{
  "schema_version": "1.2",
  "updated_at": "2026-03-27T00:00:00Z",
  "endpoints": {
    "readme": "/ai/readme",
    "brand": "/ai/brand",
    "coffees": "/ai/coffees",
    "coffee": "/ai/coffees/{id}",
    "awards": "/ai/awards",
    "award": "/ai/awards/{id}"
  },
  "contracts": {
    "ids": {
      "coffee": "sa.coffee.*",
      "award": "sa.award.*"
    },
    "notes": [
      "IDs are editorial and stable. If a coffee returns as a new harvest and you treat it as a new entity, it MUST get a new id.",
      "Coffees expose award_ids to link to awards without duplicating award details.",
      "Use /ai/index to discover endpoints; do not hardcode routes.",
      "Use /ai/readme for a Markdown overview intended for agents."
    ]
  }
}