{
  "openapi": "3.1.0",
  "info": {
    "title": "Brendan Irvine-Broque Personal API",
    "summary": "Read-only access to Brendan’s public collections and recommendations.",
    "version": "1.0.0",
    "description": "Browse Brendan's concerts, movies, places, music, videos, podcasts, tweets, code activity, photos, books, reading links, and work timeline.\n\nPublic REST operations are anonymous and read-only. The bounded music query operations use POST to carry structured requests but do not mutate records.",
    "contact": {
      "name": "Brendan Irvine-Broque",
      "email": "brendanib@gmail.com",
      "url": "https://irvinebroque.com"
    },
    "license": {
      "name": "MIT"
    }
  },
  "servers": [
    {
      "url": "https://irvinebroque.com",
      "description": "Production server"
    }
  ],
  "externalDocs": {
    "description": "API guide, media types, standards, and usage policies",
    "url": "https://irvinebroque.com/api"
  },
  "tags": [
    {
      "name": "activities",
      "description": "Public Strava activities"
    },
    {
      "name": "movies",
      "description": "Public movie and TV series recommendations"
    },
    {
      "name": "places",
      "description": "Restaurant and location recommendations"
    },
    {
      "name": "events",
      "description": "Upcoming and past concert and sports recommendations"
    },
    {
      "name": "sports",
      "description": "Sporting events Brendan attended in person or watched, plus events he plans to attend or watch"
    },
    {
      "name": "music",
      "description": "Tracks, albums, playlists, and DJ mixes"
    },
    {
      "name": "concerts",
      "description": "Concerts Brendan attended or plans to attend, including artists, venues, flyers, and setlists"
    },
    {
      "name": "videos",
      "description": "YouTube video recommendations"
    },
    {
      "name": "podcasts",
      "description": "Podcast episode recommendations"
    },
    {
      "name": "tweets",
      "description": "Curated tweet recommendations"
    },
    {
      "name": "code",
      "description": "Public GitHub activity timeline"
    },
    {
      "name": "photos",
      "description": "Personal photography"
    },
    {
      "name": "books",
      "description": "Books Brendan has read"
    },
    {
      "name": "work",
      "description": "Work items and employment markers, followed by education"
    },
    {
      "name": "reading",
      "description": "Saved links with metadata previews"
    },
    {
      "name": "blog",
      "description": "blog list surface"
    },
    {
      "name": "writing",
      "description": "writing list surface"
    },
    {
      "name": "search",
      "description": "search list surface"
    },
    {
      "name": "feed-items",
      "description": "feed-items list surface"
    },
    {
      "name": "meta",
      "description": "API metadata and service discovery"
    },
    {
      "name": "taste-summary",
      "description": "Complete-corpus public taste summaries"
    }
  ],
  "paths": {
    "/api/activities.json": {
      "get": {
        "operationId": "getActivities",
        "summary": "List public Strava activities",
        "tags": [
          "activities"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (default: 50, max: 100)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Pagination cursor for fetching next page",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Sort field and direction (e.g., \"year:desc\", \"addedAt:asc\")",
            "schema": {
              "type": "string",
              "pattern": "^[\\w.-]+:(asc|desc)(,[\\w.-]+:(asc|desc))*$"
            }
          },
          {
            "name": "facets",
            "in": "query",
            "description": "Include facet metadata in response meta (set to 1)",
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "enum": [
                    1
                  ]
                },
                {
                  "type": "boolean"
                },
                {
                  "type": "string"
                }
              ]
            }
          },
          {
            "name": "year",
            "in": "query",
            "description": "Filter by activity year",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "sportType",
            "in": "query",
            "description": "Filter by Strava sport type",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "q",
            "in": "query",
            "description": "Case-insensitive activity title search",
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-idempotency": "intrinsic-safe-method",
        "responses": {
          "200": {
            "description": "List response for activities",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Activity"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    },
                    "links": {
                      "$ref": "#/components/schemas/PaginationLinks"
                    }
                  },
                  "required": [
                    "data",
                    "meta",
                    "links"
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "406": {
            "description": "Not Acceptable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "503": {
            "description": "Portable location provenance is incomplete, so the export is unavailable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headActivities",
        "summary": "Get activities list metadata",
        "tags": [
          "activities"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsActivities",
        "summary": "CORS preflight",
        "tags": [
          "activities"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/api/movies.json": {
      "get": {
        "operationId": "getMovies",
        "summary": "List movie and TV series recommendations",
        "tags": [
          "movies"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (default: 50, max: 100)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Pagination cursor for fetching next page",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Sort field and direction (e.g., \"year:desc\", \"addedAt:asc\")",
            "schema": {
              "type": "string",
              "pattern": "^[\\w.-]+:(asc|desc)(,[\\w.-]+:(asc|desc))*$"
            }
          },
          {
            "name": "facets",
            "in": "query",
            "description": "Include facet metadata in response meta (set to 1)",
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "enum": [
                    1
                  ]
                },
                {
                  "type": "boolean"
                },
                {
                  "type": "string"
                }
              ]
            }
          },
          {
            "name": "type",
            "in": "query",
            "description": "Filter by movie or TV series",
            "schema": {
              "type": "string",
              "enum": [
                "movie",
                "tv"
              ]
            }
          },
          {
            "name": "year",
            "in": "query",
            "description": "Filter by release year",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "genre",
            "in": "query",
            "description": "Filter by genre",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "director",
            "in": "query",
            "description": "Filter by director",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "actor",
            "in": "query",
            "description": "Filter by cast member",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "q",
            "in": "query",
            "description": "Case-insensitive title search",
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-idempotency": "intrinsic-safe-method",
        "responses": {
          "200": {
            "description": "List response for movies",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Movie"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    },
                    "links": {
                      "$ref": "#/components/schemas/PaginationLinks"
                    }
                  },
                  "required": [
                    "data",
                    "meta",
                    "links"
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "406": {
            "description": "Not Acceptable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "503": {
            "description": "Portable location provenance is incomplete, so the export is unavailable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headMovies",
        "summary": "Get movies list metadata",
        "tags": [
          "movies"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsMovies",
        "summary": "CORS preflight",
        "tags": [
          "movies"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/api/places.json": {
      "get": {
        "operationId": "getPlaces",
        "summary": "List place recommendations",
        "tags": [
          "places"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (default: 50, max: 100)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Pagination cursor for fetching next page",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Sort field and direction (e.g., \"year:desc\", \"addedAt:asc\")",
            "schema": {
              "type": "string",
              "pattern": "^[\\w.-]+:(asc|desc)(,[\\w.-]+:(asc|desc))*$"
            }
          },
          {
            "name": "facets",
            "in": "query",
            "description": "Include facet metadata in response meta (set to 1)",
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "enum": [
                    1
                  ]
                },
                {
                  "type": "boolean"
                },
                {
                  "type": "string"
                }
              ]
            }
          },
          {
            "name": "city",
            "in": "query",
            "description": "Filter by city",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "description": "Filter by country",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "category",
            "in": "query",
            "description": "Filter by category",
            "schema": {
              "type": "string",
              "enum": [
                "food",
                "coffee",
                "bars",
                "nature",
                "entertainment",
                "lodging",
                "other"
              ]
            }
          },
          {
            "name": "neighborhood",
            "in": "query",
            "description": "Filter by neighborhood",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "q",
            "in": "query",
            "description": "Case-insensitive search across place name and location metadata",
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-idempotency": "intrinsic-safe-method",
        "responses": {
          "200": {
            "description": "List response for places",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Place"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    },
                    "links": {
                      "$ref": "#/components/schemas/PaginationLinks"
                    }
                  },
                  "required": [
                    "data",
                    "meta",
                    "links"
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              },
              "application/geo+json": {
                "schema": {
                  "$ref": "#/components/schemas/PlaceGeoJsonResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "406": {
            "description": "Not Acceptable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "503": {
            "description": "Portable location provenance is incomplete, so the export is unavailable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headPlaces",
        "summary": "Get places list metadata",
        "tags": [
          "places"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsPlaces",
        "summary": "CORS preflight",
        "tags": [
          "places"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/api/events.json": {
      "get": {
        "operationId": "getEvents",
        "summary": "List concert and sports event recommendations",
        "tags": [
          "events"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (default: 50, max: 100)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Pagination cursor for fetching next page",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Sort field and direction (e.g., \"year:desc\", \"addedAt:asc\")",
            "schema": {
              "type": "string",
              "pattern": "^[\\w.-]+:(asc|desc)(,[\\w.-]+:(asc|desc))*$"
            }
          },
          {
            "name": "facets",
            "in": "query",
            "description": "Include facet metadata in response meta (set to 1)",
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "enum": [
                    1
                  ]
                },
                {
                  "type": "boolean"
                },
                {
                  "type": "string"
                }
              ]
            }
          },
          {
            "name": "type",
            "in": "query",
            "description": "Filter by concert or sports event",
            "schema": {
              "type": "string",
              "enum": [
                "concert",
                "sports"
              ]
            }
          },
          {
            "name": "city",
            "in": "query",
            "description": "Filter by city",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "year",
            "in": "query",
            "description": "Filter by event year",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "q",
            "in": "query",
            "description": "Search title, venue, participants, league, and location",
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-idempotency": "intrinsic-safe-method",
        "responses": {
          "200": {
            "description": "List response for events",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Event"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    },
                    "links": {
                      "$ref": "#/components/schemas/PaginationLinks"
                    }
                  },
                  "required": [
                    "data",
                    "meta",
                    "links"
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "406": {
            "description": "Not Acceptable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "503": {
            "description": "Portable location provenance is incomplete, so the export is unavailable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headEvents",
        "summary": "Get events list metadata",
        "tags": [
          "events"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsEvents",
        "summary": "CORS preflight",
        "tags": [
          "events"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/api/sporting-events.json": {
      "get": {
        "operationId": "getSportingEvents",
        "summary": "List Brendan’s sporting events",
        "tags": [
          "sports"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (default: 50, max: 100)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Pagination cursor for fetching next page",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Sort field and direction (e.g., \"year:desc\", \"addedAt:asc\")",
            "schema": {
              "type": "string",
              "pattern": "^[\\w.-]+:(asc|desc)(,[\\w.-]+:(asc|desc))*$"
            }
          },
          {
            "name": "facets",
            "in": "query",
            "description": "Include facet metadata in response meta (set to 1)",
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "enum": [
                    1
                  ]
                },
                {
                  "type": "boolean"
                },
                {
                  "type": "string"
                }
              ]
            }
          },
          {
            "name": "team",
            "in": "query",
            "description": "Filter by team name or abbreviation",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sport",
            "in": "query",
            "description": "Filter by sport",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "league",
            "in": "query",
            "description": "Filter by league or competition",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "year",
            "in": "query",
            "description": "Filter by local event year",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "city",
            "in": "query",
            "description": "Filter by venue city",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "venue",
            "in": "query",
            "description": "Filter by venue name",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "experience",
            "in": "query",
            "description": "Filter by in-person or watch experience",
            "schema": {
              "type": "string",
              "enum": [
                "in-person",
                "watch"
              ]
            }
          },
          {
            "name": "experienceStatus",
            "in": "query",
            "description": "Filter by planned or completed experience",
            "schema": {
              "type": "string",
              "enum": [
                "planned",
                "completed"
              ]
            }
          },
          {
            "name": "q",
            "in": "query",
            "description": "Normalized search across teams, competition, venue, date, and notes",
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-idempotency": "intrinsic-safe-method",
        "responses": {
          "200": {
            "description": "List response for sports",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/SportEvent"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    },
                    "links": {
                      "$ref": "#/components/schemas/PaginationLinks"
                    }
                  },
                  "required": [
                    "data",
                    "meta",
                    "links"
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "406": {
            "description": "Not Acceptable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "503": {
            "description": "Portable location provenance is incomplete, so the export is unavailable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headSportingEvents",
        "summary": "Get sports list metadata",
        "tags": [
          "sports"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsSportingEvents",
        "summary": "CORS preflight",
        "tags": [
          "sports"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/api/music.json": {
      "get": {
        "operationId": "getMusic",
        "summary": "List music recommendations",
        "tags": [
          "music"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (default: 50, max: 100)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Pagination cursor for fetching next page",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Sort field and direction (e.g., \"year:desc\", \"addedAt:asc\")",
            "schema": {
              "type": "string",
              "pattern": "^[\\w.-]+:(asc|desc)(,[\\w.-]+:(asc|desc))*$"
            }
          },
          {
            "name": "facets",
            "in": "query",
            "description": "Include facet metadata in response meta (set to 1)",
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "enum": [
                    1
                  ]
                },
                {
                  "type": "boolean"
                },
                {
                  "type": "string"
                }
              ]
            }
          },
          {
            "name": "genre",
            "in": "query",
            "description": "Filter by a canonical music genre",
            "schema": {
              "type": "string",
              "enum": [
                "Afrobeats",
                "Ambient",
                "Blues",
                "Classical",
                "Country",
                "Dance",
                "Electronic",
                "Folk",
                "Funk",
                "Hip-Hop",
                "House",
                "Jazz",
                "Latin",
                "Metal",
                "Pop",
                "Punk",
                "R&B",
                "Reggae",
                "Rock",
                "Soul"
              ]
            }
          },
          {
            "name": "type",
            "in": "query",
            "description": "Filter by music type",
            "schema": {
              "type": "string",
              "enum": [
                "album",
                "playlist",
                "mix",
                "track"
              ]
            }
          },
          {
            "name": "q",
            "in": "query",
            "description": "Normalized multi-token search across public title, artist, notes, genre, path, and source URL fields",
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-idempotency": "intrinsic-safe-method",
        "responses": {
          "200": {
            "description": "List response for music",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/MusicItem"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    },
                    "links": {
                      "$ref": "#/components/schemas/PaginationLinks"
                    }
                  },
                  "required": [
                    "data",
                    "meta",
                    "links"
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "406": {
            "description": "Not Acceptable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "503": {
            "description": "Portable location provenance is incomplete, so the export is unavailable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headMusic",
        "summary": "Get music list metadata",
        "tags": [
          "music"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsMusic",
        "summary": "CORS preflight",
        "tags": [
          "music"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/api/concerts.json": {
      "get": {
        "operationId": "getConcerts",
        "summary": "List concerts Brendan attended or plans to attend",
        "tags": [
          "concerts"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (default: 50, max: 100)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Pagination cursor for fetching next page",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Sort field and direction (e.g., \"year:desc\", \"addedAt:asc\")",
            "schema": {
              "type": "string",
              "pattern": "^[\\w.-]+:(asc|desc)(,[\\w.-]+:(asc|desc))*$"
            }
          },
          {
            "name": "facets",
            "in": "query",
            "description": "Include facet metadata in response meta (set to 1)",
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "enum": [
                    1
                  ]
                },
                {
                  "type": "boolean"
                },
                {
                  "type": "string"
                }
              ]
            }
          },
          {
            "name": "year",
            "in": "query",
            "description": "Filter by concert year",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "artist",
            "in": "query",
            "description": "Filter by performer name",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "venue",
            "in": "query",
            "description": "Filter by venue name",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "city",
            "in": "query",
            "description": "Filter by venue city",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "q",
            "in": "query",
            "description": "Search titles, artists, venues, tours, notes, and setlists",
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-idempotency": "intrinsic-safe-method",
        "responses": {
          "200": {
            "description": "List response for concerts",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Concert"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    },
                    "links": {
                      "$ref": "#/components/schemas/PaginationLinks"
                    }
                  },
                  "required": [
                    "data",
                    "meta",
                    "links"
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "406": {
            "description": "Not Acceptable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "503": {
            "description": "Portable location provenance is incomplete, so the export is unavailable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headConcerts",
        "summary": "Get concerts list metadata",
        "tags": [
          "concerts"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsConcerts",
        "summary": "CORS preflight",
        "tags": [
          "concerts"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/api/videos.json": {
      "get": {
        "operationId": "getVideos",
        "summary": "List video recommendations",
        "tags": [
          "videos"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (default: 50, max: 100)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Pagination cursor for fetching next page",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Sort field and direction (e.g., \"year:desc\", \"addedAt:asc\")",
            "schema": {
              "type": "string",
              "pattern": "^[\\w.-]+:(asc|desc)(,[\\w.-]+:(asc|desc))*$"
            }
          },
          {
            "name": "facets",
            "in": "query",
            "description": "Include facet metadata in response meta (set to 1)",
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "enum": [
                    1
                  ]
                },
                {
                  "type": "boolean"
                },
                {
                  "type": "string"
                }
              ]
            }
          },
          {
            "name": "category",
            "in": "query",
            "description": "Filter by category",
            "schema": {
              "type": "string",
              "enum": [
                "music-video",
                "live-performance",
                "music-making",
                "music-culture",
                "skate",
                "basketball",
                "sports",
                "tech-talk",
                "technology",
                "architecture-design",
                "documentary",
                "comedy",
                "nature",
                "health-fitness",
                "business",
                "politics",
                "culture",
                "other"
              ]
            }
          },
          {
            "name": "q",
            "in": "query",
            "description": "Case-insensitive title search",
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-idempotency": "intrinsic-safe-method",
        "responses": {
          "200": {
            "description": "List response for videos",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Video"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    },
                    "links": {
                      "$ref": "#/components/schemas/PaginationLinks"
                    }
                  },
                  "required": [
                    "data",
                    "meta",
                    "links"
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "406": {
            "description": "Not Acceptable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "503": {
            "description": "Portable location provenance is incomplete, so the export is unavailable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headVideos",
        "summary": "Get videos list metadata",
        "tags": [
          "videos"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsVideos",
        "summary": "CORS preflight",
        "tags": [
          "videos"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/api/podcasts.json": {
      "get": {
        "operationId": "getPodcasts",
        "summary": "List podcast recommendations",
        "tags": [
          "podcasts"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (default: 50, max: 100)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Pagination cursor for fetching next page",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Sort field and direction (e.g., \"year:desc\", \"addedAt:asc\")",
            "schema": {
              "type": "string",
              "pattern": "^[\\w.-]+:(asc|desc)(,[\\w.-]+:(asc|desc))*$"
            }
          },
          {
            "name": "facets",
            "in": "query",
            "description": "Include facet metadata in response meta (set to 1)",
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "enum": [
                    1
                  ]
                },
                {
                  "type": "boolean"
                },
                {
                  "type": "string"
                }
              ]
            }
          },
          {
            "name": "show",
            "in": "query",
            "description": "Filter by podcast show name",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "q",
            "in": "query",
            "description": "Case-insensitive search across podcast text fields",
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-idempotency": "intrinsic-safe-method",
        "responses": {
          "200": {
            "description": "List response for podcasts",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Podcast"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    },
                    "links": {
                      "$ref": "#/components/schemas/PaginationLinks"
                    }
                  },
                  "required": [
                    "data",
                    "meta",
                    "links"
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "406": {
            "description": "Not Acceptable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "503": {
            "description": "Portable location provenance is incomplete, so the export is unavailable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headPodcasts",
        "summary": "Get podcasts list metadata",
        "tags": [
          "podcasts"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsPodcasts",
        "summary": "CORS preflight",
        "tags": [
          "podcasts"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/api/tweets.json": {
      "get": {
        "operationId": "getTweets",
        "summary": "List tweet recommendations",
        "tags": [
          "tweets"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (default: 50, max: 100)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Pagination cursor for fetching next page",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Sort field and direction (e.g., \"year:desc\", \"addedAt:asc\")",
            "schema": {
              "type": "string",
              "pattern": "^[\\w.-]+:(asc|desc)(,[\\w.-]+:(asc|desc))*$"
            }
          },
          {
            "name": "facets",
            "in": "query",
            "description": "Include facet metadata in response meta (set to 1)",
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "enum": [
                    1
                  ]
                },
                {
                  "type": "boolean"
                },
                {
                  "type": "string"
                }
              ]
            }
          },
          {
            "name": "author",
            "in": "query",
            "description": "Filter by tweet author",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "q",
            "in": "query",
            "description": "Case-insensitive search across tweet text fields",
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-idempotency": "intrinsic-safe-method",
        "responses": {
          "200": {
            "description": "List response for tweets",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Tweet"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    },
                    "links": {
                      "$ref": "#/components/schemas/PaginationLinks"
                    }
                  },
                  "required": [
                    "data",
                    "meta",
                    "links"
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "406": {
            "description": "Not Acceptable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "503": {
            "description": "Portable location provenance is incomplete, so the export is unavailable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headTweets",
        "summary": "Get tweets list metadata",
        "tags": [
          "tweets"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsTweets",
        "summary": "CORS preflight",
        "tags": [
          "tweets"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/api/code.json": {
      "get": {
        "operationId": "getCode",
        "summary": "List public code activity highlights",
        "tags": [
          "code"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (default: 50, max: 100)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Pagination cursor for fetching next page",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Sort field and direction (e.g., \"year:desc\", \"addedAt:asc\")",
            "schema": {
              "type": "string",
              "pattern": "^[\\w.-]+:(asc|desc)(,[\\w.-]+:(asc|desc))*$"
            }
          },
          {
            "name": "facets",
            "in": "query",
            "description": "Include facet metadata in response meta (set to 1)",
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "enum": [
                    1
                  ]
                },
                {
                  "type": "boolean"
                },
                {
                  "type": "string"
                }
              ]
            }
          },
          {
            "name": "kind",
            "in": "query",
            "description": "Filter by activity kind",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "repo",
            "in": "query",
            "description": "Filter by repository full name (owner/repo)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "year",
            "in": "query",
            "description": "Filter by activity year",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "q",
            "in": "query",
            "description": "Case-insensitive search across title, repo, and reasons",
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-idempotency": "intrinsic-safe-method",
        "responses": {
          "200": {
            "description": "List response for code",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Code"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    },
                    "links": {
                      "$ref": "#/components/schemas/PaginationLinks"
                    }
                  },
                  "required": [
                    "data",
                    "meta",
                    "links"
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "406": {
            "description": "Not Acceptable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "503": {
            "description": "Portable location provenance is incomplete, so the export is unavailable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headCode",
        "summary": "Get code list metadata",
        "tags": [
          "code"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsCode",
        "summary": "CORS preflight",
        "tags": [
          "code"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/api/photos.json": {
      "get": {
        "operationId": "getPhotos",
        "summary": "List photos",
        "tags": [
          "photos"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (default: 50, max: 100)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Pagination cursor for fetching next page",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Sort field and direction (e.g., \"year:desc\", \"addedAt:asc\")",
            "schema": {
              "type": "string",
              "pattern": "^[\\w.-]+:(asc|desc)(,[\\w.-]+:(asc|desc))*$"
            }
          },
          {
            "name": "facets",
            "in": "query",
            "description": "Include facet metadata in response meta (set to 1)",
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "enum": [
                    1
                  ]
                },
                {
                  "type": "boolean"
                },
                {
                  "type": "string"
                }
              ]
            }
          },
          {
            "name": "year",
            "in": "query",
            "description": "Filter by year",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "month",
            "in": "query",
            "description": "Filter by month (1-12)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 12
            }
          }
        ],
        "x-idempotency": "intrinsic-safe-method",
        "responses": {
          "200": {
            "description": "List response for photos",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Photo"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    },
                    "links": {
                      "$ref": "#/components/schemas/PaginationLinks"
                    }
                  },
                  "required": [
                    "data",
                    "meta",
                    "links"
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              },
              "application/geo+json": {
                "schema": {
                  "$ref": "#/components/schemas/PhotoGeoJsonResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "406": {
            "description": "Not Acceptable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "503": {
            "description": "Portable location provenance is incomplete, so the export is unavailable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headPhotos",
        "summary": "Get photos list metadata",
        "tags": [
          "photos"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsPhotos",
        "summary": "CORS preflight",
        "tags": [
          "photos"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/api/books.json": {
      "get": {
        "operationId": "getBooks",
        "summary": "List books Brendan has read",
        "tags": [
          "books"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (default: 50, max: 100)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Pagination cursor for fetching next page",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Sort field and direction (e.g., \"year:desc\", \"addedAt:asc\")",
            "schema": {
              "type": "string",
              "pattern": "^[\\w.-]+:(asc|desc)(,[\\w.-]+:(asc|desc))*$"
            }
          },
          {
            "name": "facets",
            "in": "query",
            "description": "Include facet metadata in response meta (set to 1)",
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "enum": [
                    1
                  ]
                },
                {
                  "type": "boolean"
                },
                {
                  "type": "string"
                }
              ]
            }
          },
          {
            "name": "author",
            "in": "query",
            "description": "Filter by author",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "q",
            "in": "query",
            "description": "Case-insensitive search across book fields",
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-idempotency": "intrinsic-safe-method",
        "responses": {
          "200": {
            "description": "List response for books",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Book"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    },
                    "links": {
                      "$ref": "#/components/schemas/PaginationLinks"
                    }
                  },
                  "required": [
                    "data",
                    "meta",
                    "links"
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "406": {
            "description": "Not Acceptable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "503": {
            "description": "Portable location provenance is incomplete, so the export is unavailable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headBooks",
        "summary": "Get books list metadata",
        "tags": [
          "books"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsBooks",
        "summary": "CORS preflight",
        "tags": [
          "books"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/api/work.json": {
      "get": {
        "operationId": "getWork",
        "summary": "List work items, employment markers, and education",
        "tags": [
          "work"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (default: 50, max: 100)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Pagination cursor for fetching next page",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Sort field and direction (e.g., \"year:desc\", \"addedAt:asc\")",
            "schema": {
              "type": "string",
              "pattern": "^[\\w.-]+:(asc|desc)(,[\\w.-]+:(asc|desc))*$"
            }
          },
          {
            "name": "facets",
            "in": "query",
            "description": "Include facet metadata in response meta (set to 1)",
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "enum": [
                    1
                  ]
                },
                {
                  "type": "boolean"
                },
                {
                  "type": "string"
                }
              ]
            }
          },
          {
            "name": "year",
            "in": "query",
            "description": "Filter by timeline year",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "kind",
            "in": "query",
            "description": "Filter by work, employment, or education record kind",
            "schema": {
              "type": "string",
              "enum": [
                "work",
                "employment",
                "education"
              ]
            }
          },
          {
            "name": "company",
            "in": "query",
            "description": "Filter by company",
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-idempotency": "intrinsic-safe-method",
        "responses": {
          "200": {
            "description": "List response for work",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/WorkTimelineItem"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    },
                    "links": {
                      "$ref": "#/components/schemas/PaginationLinks"
                    }
                  },
                  "required": [
                    "data",
                    "meta",
                    "links"
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "406": {
            "description": "Not Acceptable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "503": {
            "description": "Portable location provenance is incomplete, so the export is unavailable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headWork",
        "summary": "Get work list metadata",
        "tags": [
          "work"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsWork",
        "summary": "CORS preflight",
        "tags": [
          "work"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/api/reading.json": {
      "get": {
        "operationId": "getReading",
        "summary": "List reading links",
        "tags": [
          "reading"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (default: 50, max: 100)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Pagination cursor for fetching next page",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Sort field and direction (e.g., \"year:desc\", \"addedAt:asc\")",
            "schema": {
              "type": "string",
              "pattern": "^[\\w.-]+:(asc|desc)(,[\\w.-]+:(asc|desc))*$"
            }
          },
          {
            "name": "facets",
            "in": "query",
            "description": "Include facet metadata in response meta (set to 1)",
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "enum": [
                    1
                  ]
                },
                {
                  "type": "boolean"
                },
                {
                  "type": "string"
                }
              ]
            }
          },
          {
            "name": "q",
            "in": "query",
            "description": "Case-insensitive title search",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "domain",
            "in": "query",
            "description": "Filter by normalized link domain",
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-idempotency": "intrinsic-safe-method",
        "responses": {
          "200": {
            "description": "List response for reading",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Reading"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    },
                    "links": {
                      "$ref": "#/components/schemas/PaginationLinks"
                    }
                  },
                  "required": [
                    "data",
                    "meta",
                    "links"
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "406": {
            "description": "Not Acceptable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "503": {
            "description": "Portable location provenance is incomplete, so the export is unavailable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headReading",
        "summary": "Get reading list metadata",
        "tags": [
          "reading"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsReading",
        "summary": "CORS preflight",
        "tags": [
          "reading"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/api/blog.json": {
      "get": {
        "operationId": "getBlog",
        "summary": "List blog posts",
        "tags": [
          "blog"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (default: 50, max: 100)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Pagination cursor for fetching next page",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Sort field and direction (e.g., \"year:desc\", \"addedAt:asc\")",
            "schema": {
              "type": "string",
              "pattern": "^[\\w.-]+:(asc|desc)(,[\\w.-]+:(asc|desc))*$"
            }
          },
          {
            "name": "facets",
            "in": "query",
            "description": "Include facet metadata in response meta (set to 1)",
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "enum": [
                    1
                  ]
                },
                {
                  "type": "boolean"
                },
                {
                  "type": "string"
                }
              ]
            }
          },
          {
            "name": "q",
            "in": "query",
            "description": "Case-insensitive search across blog title and description",
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-idempotency": "intrinsic-safe-method",
        "responses": {
          "200": {
            "description": "List response for blog",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/BlogItem"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    },
                    "links": {
                      "$ref": "#/components/schemas/PaginationLinks"
                    }
                  },
                  "required": [
                    "data",
                    "meta",
                    "links"
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "406": {
            "description": "Not Acceptable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "503": {
            "description": "Portable location provenance is incomplete, so the export is unavailable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headBlog",
        "summary": "Get blog list metadata",
        "tags": [
          "blog"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsBlog",
        "summary": "CORS preflight",
        "tags": [
          "blog"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/api/writing.json": {
      "get": {
        "operationId": "getWriting",
        "summary": "List external writing links",
        "tags": [
          "writing"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (default: 50, max: 100)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Pagination cursor for fetching next page",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Sort field and direction (e.g., \"year:desc\", \"addedAt:asc\")",
            "schema": {
              "type": "string",
              "pattern": "^[\\w.-]+:(asc|desc)(,[\\w.-]+:(asc|desc))*$"
            }
          },
          {
            "name": "facets",
            "in": "query",
            "description": "Include facet metadata in response meta (set to 1)",
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "enum": [
                    1
                  ]
                },
                {
                  "type": "boolean"
                },
                {
                  "type": "string"
                }
              ]
            }
          },
          {
            "name": "source",
            "in": "query",
            "description": "Filter by publication source",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "q",
            "in": "query",
            "description": "Case-insensitive search across writing fields",
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-idempotency": "intrinsic-safe-method",
        "responses": {
          "200": {
            "description": "List response for writing",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/WritingItem"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    },
                    "links": {
                      "$ref": "#/components/schemas/PaginationLinks"
                    }
                  },
                  "required": [
                    "data",
                    "meta",
                    "links"
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "406": {
            "description": "Not Acceptable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "503": {
            "description": "Portable location provenance is incomplete, so the export is unavailable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headWriting",
        "summary": "Get writing list metadata",
        "tags": [
          "writing"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsWriting",
        "summary": "CORS preflight",
        "tags": [
          "writing"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/api/search.json": {
      "get": {
        "operationId": "getSearch",
        "summary": "List full-site search results",
        "tags": [
          "search"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (default: 50, max: 100)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Pagination cursor for fetching next page",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Sort field and direction (e.g., \"year:desc\", \"addedAt:asc\")",
            "schema": {
              "type": "string",
              "pattern": "^[\\w.-]+:(asc|desc)(,[\\w.-]+:(asc|desc))*$"
            }
          },
          {
            "name": "facets",
            "in": "query",
            "description": "Include facet metadata in response meta (set to 1)",
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "enum": [
                    1
                  ]
                },
                {
                  "type": "boolean"
                },
                {
                  "type": "string"
                }
              ]
            }
          },
          {
            "name": "q",
            "in": "query",
            "description": "Search query text",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "type",
            "in": "query",
            "description": "Filter by comma-separated content type values",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "source",
            "in": "query",
            "description": "Filter by comma-separated source values",
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-idempotency": "intrinsic-safe-method",
        "responses": {
          "200": {
            "description": "List response for search",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/SearchResultItem"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    },
                    "links": {
                      "$ref": "#/components/schemas/PaginationLinks"
                    }
                  },
                  "required": [
                    "data",
                    "meta",
                    "links"
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "406": {
            "description": "Not Acceptable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "503": {
            "description": "Portable location provenance is incomplete, so the export is unavailable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headSearch",
        "summary": "Get search list metadata",
        "tags": [
          "search"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsSearch",
        "summary": "CORS preflight",
        "tags": [
          "search"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/api/feed-items.json": {
      "get": {
        "operationId": "getFeedItems",
        "summary": "List unified feed items",
        "tags": [
          "feed-items"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (default: 50, max: 100)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Pagination cursor for fetching next page",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Sort field and direction (e.g., \"year:desc\", \"addedAt:asc\")",
            "schema": {
              "type": "string",
              "pattern": "^[\\w.-]+:(asc|desc)(,[\\w.-]+:(asc|desc))*$"
            }
          },
          {
            "name": "facets",
            "in": "query",
            "description": "Include facet metadata in response meta (set to 1)",
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "enum": [
                    1
                  ]
                },
                {
                  "type": "boolean"
                },
                {
                  "type": "string"
                }
              ]
            }
          },
          {
            "name": "kind",
            "in": "query",
            "description": "Filter by comma-separated kind values",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "source",
            "in": "query",
            "description": "Filter by comma-separated source values",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "year",
            "in": "query",
            "description": "Filter by feed content year",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "from",
            "in": "query",
            "description": "Include items on or after this YYYY-MM-DD content date",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "to",
            "in": "query",
            "description": "Include items before this YYYY-MM-DD content date",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "q",
            "in": "query",
            "description": "Case-insensitive search across feed item fields",
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-idempotency": "intrinsic-safe-method",
        "responses": {
          "200": {
            "description": "List response for feed-items",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/FeedItem"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    },
                    "links": {
                      "$ref": "#/components/schemas/PaginationLinks"
                    }
                  },
                  "required": [
                    "data",
                    "meta",
                    "links"
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "406": {
            "description": "Not Acceptable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "503": {
            "description": "Portable location provenance is incomplete, so the export is unavailable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headFeedItems",
        "summary": "Get feed-items list metadata",
        "tags": [
          "feed-items"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsFeedItems",
        "summary": "CORS preflight",
        "tags": [
          "feed-items"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/api/taste/summary.json": {
      "get": {
        "operationId": "summarizeTasteCollection",
        "summary": "Summarize Brendan’s public movie and TV recommendations",
        "description": "Returns complete-corpus counts, type, genre, release-decade, and director distributions with coverage plus deterministic illustrative examples. Examples are not a statistical sample. A public miss or absence does not establish private viewing or save history.",
        "tags": [
          "taste-summary"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "collection",
            "in": "query",
            "required": true,
            "description": "Approved public collection to summarize. Version 1 supports movies only.",
            "schema": {
              "type": "string",
              "enum": [
                "movies"
              ]
            },
            "example": "movies"
          },
          {
            "name": "exampleLimit",
            "in": "query",
            "required": false,
            "description": "Number of deterministic illustrative examples.",
            "schema": {
              "type": "integer",
              "minimum": 3,
              "maximum": 8,
              "default": 6
            }
          }
        ],
        "x-idempotency": "intrinsic-safe-method",
        "responses": {
          "200": {
            "description": "Complete public movie recommendation summary",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Last modification date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TasteCollectionSummaryV1"
                },
                "example": {
                  "schemaVersion": 1,
                  "outcome": "ok",
                  "summary": "Summarized 320 public movie and TV recommendations and returned 1 illustrative example. Overall claims should use the distributions; the examples are not a statistical sample.",
                  "scope": {
                    "visibility": "public",
                    "corpusId": "public-movie-recommendations",
                    "label": "Brendan’s public movie and TV recommendations",
                    "definition": "Public, non-deleted movie records explicitly marked recommended.",
                    "inclusionRules": [
                      "The canonical collection is movies.",
                      "The publication state is public.",
                      "The preference state is recommended.",
                      "The record has not been deleted."
                    ],
                    "exclusionMeaning": "Absence does not establish whether Brendan has seen, saved, or privately recorded an item elsewhere.",
                    "canonicalUrl": "https://irvinebroque.com/movies"
                  },
                  "counts": {
                    "returnedCount": 1,
                    "collectionCount": 320
                  },
                  "coverage": {
                    "dataAsOf": "2026-08-30T00:00:00.000Z",
                    "dimensions": [
                      {
                        "dimension": "type",
                        "eligibleCount": 320,
                        "populatedCount": 320,
                        "missingCount": 0
                      },
                      {
                        "dimension": "genre",
                        "eligibleCount": 320,
                        "populatedCount": 318,
                        "missingCount": 2
                      },
                      {
                        "dimension": "releaseDecade",
                        "eligibleCount": 320,
                        "populatedCount": 319,
                        "missingCount": 1
                      },
                      {
                        "dimension": "director",
                        "eligibleCount": 320,
                        "populatedCount": 310,
                        "missingCount": 10
                      }
                    ]
                  },
                  "distributions": [
                    {
                      "dimension": "genre",
                      "label": "Most represented genres",
                      "multiValue": true,
                      "denominator": "eligible_records",
                      "denominatorCount": 320,
                      "values": [
                        {
                          "value": "drama",
                          "label": "Drama",
                          "count": 201,
                          "shareOfEligible": 0.628125
                        }
                      ]
                    }
                  ],
                  "examples": [
                    {
                      "canonicalId": "itm_0123456789abcdef01234567",
                      "collection": "movies",
                      "title": "Example title",
                      "canonicalUrl": "https://irvinebroque.com/movies/example-title",
                      "description": "Movie · 2024 · Drama",
                      "evidence": [
                        "Illustrates the drama genre distribution."
                      ],
                      "evidenceDetails": [
                        {
                          "code": "summary.genre-example",
                          "text": "Illustrates the drama genre distribution.",
                          "fields": [
                            "genres"
                          ]
                        }
                      ],
                      "data": {
                        "canonicalId": "itm_0123456789abcdef01234567",
                        "title": "Example title",
                        "type": "movie"
                      }
                    }
                  ],
                  "selection": {
                    "task": "summarize",
                    "method": "deterministic-illustrative-v1",
                    "role": "illustrative",
                    "supportsPopulationClaims": false,
                    "explanation": "Examples are selected deterministically to illustrate leading dimensions. Population claims must use the complete-corpus distributions."
                  },
                  "generatedAt": "2026-08-30T12:00:00.000Z",
                  "renderInput": {
                    "canonicalIds": [
                      "itm_0123456789abcdef01234567"
                    ]
                  }
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Unsupported collection or invalid example limit",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "503": {
            "description": "Summary service unavailable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headTasteCollectionSummary",
        "summary": "Get taste summary validators and count headers",
        "tags": [
          "taste-summary"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Last modification date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsTasteCollectionSummary",
        "summary": "CORS preflight",
        "tags": [
          "taste-summary"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/places.geojson": {
      "get": {
        "operationId": "downloadPlacesGeoJson",
        "summary": "Download the complete places collection as GeoJson",
        "description": "Returns one complete, current, filterable projection with no cursor pagination.",
        "tags": [
          "places"
        ],
        "parameters": [
          {
            "name": "city",
            "in": "query",
            "description": "Filter by city",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "description": "Filter by country",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "category",
            "in": "query",
            "description": "Filter by category",
            "schema": {
              "type": "string",
              "enum": [
                "food",
                "coffee",
                "bars",
                "nature",
                "entertainment",
                "lodging",
                "other"
              ]
            }
          },
          {
            "name": "neighborhood",
            "in": "query",
            "description": "Filter by neighborhood",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "q",
            "in": "query",
            "description": "Case-insensitive search across place name and location metadata",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Complete GeoJson places export",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Last modification date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/geo+json": {
                "schema": {
                  "$ref": "#/components/schemas/CompletePlacesGeoJson"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headPlacesGeoJson",
        "summary": "Get GeoJson places export headers",
        "tags": [
          "places"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Last modification date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsPlacesGeoJson",
        "summary": "CORS preflight",
        "tags": [
          "places"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/places.csv": {
      "get": {
        "operationId": "downloadPlacesCsv",
        "summary": "Download the complete places collection as Csv",
        "description": "Returns one complete, current, filterable projection with no cursor pagination.",
        "tags": [
          "places"
        ],
        "parameters": [
          {
            "name": "city",
            "in": "query",
            "description": "Filter by city",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "description": "Filter by country",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "category",
            "in": "query",
            "description": "Filter by category",
            "schema": {
              "type": "string",
              "enum": [
                "food",
                "coffee",
                "bars",
                "nature",
                "entertainment",
                "lodging",
                "other"
              ]
            }
          },
          {
            "name": "neighborhood",
            "in": "query",
            "description": "Filter by neighborhood",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "q",
            "in": "query",
            "description": "Case-insensitive search across place name and location metadata",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Complete Csv places export",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Last modification date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headPlacesCsv",
        "summary": "Get Csv places export headers",
        "tags": [
          "places"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Last modification date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsPlacesCsv",
        "summary": "CORS preflight",
        "tags": [
          "places"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/places.kml": {
      "get": {
        "operationId": "downloadPlacesKml",
        "summary": "Download the complete places collection as Kml",
        "description": "Returns one complete, current, filterable projection with no cursor pagination.",
        "tags": [
          "places"
        ],
        "parameters": [
          {
            "name": "city",
            "in": "query",
            "description": "Filter by city",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "description": "Filter by country",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "category",
            "in": "query",
            "description": "Filter by category",
            "schema": {
              "type": "string",
              "enum": [
                "food",
                "coffee",
                "bars",
                "nature",
                "entertainment",
                "lodging",
                "other"
              ]
            }
          },
          {
            "name": "neighborhood",
            "in": "query",
            "description": "Filter by neighborhood",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "q",
            "in": "query",
            "description": "Case-insensitive search across place name and location metadata",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Complete Kml places export",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Last modification date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/vnd.google-earth.kml+xml": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headPlacesKml",
        "summary": "Get Kml places export headers",
        "tags": [
          "places"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Last modification date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsPlacesKml",
        "summary": "CORS preflight",
        "tags": [
          "places"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/places.gpx": {
      "get": {
        "operationId": "downloadPlacesGpx",
        "summary": "Download the complete places collection as Gpx",
        "description": "Returns one complete, current, filterable projection with no cursor pagination.",
        "tags": [
          "places"
        ],
        "parameters": [
          {
            "name": "city",
            "in": "query",
            "description": "Filter by city",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "description": "Filter by country",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "category",
            "in": "query",
            "description": "Filter by category",
            "schema": {
              "type": "string",
              "enum": [
                "food",
                "coffee",
                "bars",
                "nature",
                "entertainment",
                "lodging",
                "other"
              ]
            }
          },
          {
            "name": "neighborhood",
            "in": "query",
            "description": "Filter by neighborhood",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "q",
            "in": "query",
            "description": "Case-insensitive search across place name and location metadata",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Complete Gpx places export",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Last modification date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/gpx+xml": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headPlacesGpx",
        "summary": "Get Gpx places export headers",
        "tags": [
          "places"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Last modification date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              },
              "X-Total-Count": {
                "description": "Total number of items",
                "schema": {
                  "type": "integer"
                }
              },
              "Link": {
                "description": "RFC 8288 Web Linking header with pagination links",
                "schema": {
                  "type": "string"
                }
              },
              "Link-Template": {
                "description": "RFC 9652 Link-Template header with query parameter templates",
                "schema": {
                  "type": "string"
                }
              },
              "Deprecation": {
                "description": "RFC 9745 lifecycle deprecation signal",
                "schema": {
                  "type": "string"
                }
              },
              "Sunset": {
                "description": "RFC 8594 lifecycle sunset date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsPlacesGpx",
        "summary": "CORS preflight",
        "tags": [
          "places"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/api/music-search-index.json": {
      "get": {
        "operationId": "getMusicSearchIndex",
        "summary": "Get the client music search index",
        "description": "Returns the compact, versioned public projection used for instant local music search. Conditional requests are supported with ETag.",
        "tags": [
          "music"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          }
        ],
        "x-idempotency": "intrinsic-safe-method",
        "responses": {
          "200": {
            "description": "Versioned music search index",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Last modification date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MusicSearchIndexResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "412": {
            "description": "Precondition Failed"
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headMusicSearchIndex",
        "summary": "Get music search index headers only",
        "tags": [
          "music"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Last modification date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsMusicSearchIndex",
        "summary": "CORS preflight",
        "tags": [
          "music"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/api/music/intersections.json": {
      "post": {
        "operationId": "intersectMusicTaste",
        "summary": "Compare a portable listener profile with Brendan’s canonical tracks",
        "description": "Read-only bounded structured query. The UTF-8 request body is limited to 32768 bytes, is not retained, and returns grounded canonical IDs with reason codes rather than a compatibility percentage.",
        "tags": [
          "music"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          }
        ],
        "x-idempotency": "read-only-structured-query",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MusicIntersectionRequestV1"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Grounded music intersection result",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MusicIntersectionResultV1"
                }
              }
            }
          },
          "400": {
            "description": "Invalid profile or request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "413": {
            "description": "Request exceeds the 32 KiB limit",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "415": {
            "description": "Content-Type is not application/json",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "503": {
            "description": "Intersection service unavailable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsMusicTasteIntersection",
        "summary": "CORS preflight",
        "tags": [
          "music"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/api/music/station.json": {
      "post": {
        "operationId": "buildMusicStation",
        "summary": "Build a deterministic personalized queue from Brendan’s canonical tracks",
        "description": "Read-only bounded structured query over the playable collection. The UTF-8 request body is limited to 24576 bytes. Inputs are canonical affinities, direct votes, recent tracks, optional intent, closed local context, and optional version-1 continuation (up to 120 timestamped plays, 12 buffered canonical IDs, and sequence position). All track attributes are rehydrated from D1; the server retains no listener state. Legacy requests without continuation retain their response shape and hard recency exclusions. Continuation responses additionally report cooldown relaxation and applied context signals.",
        "tags": [
          "music"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          }
        ],
        "x-idempotency": "read-only-structured-query",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MusicStationRequestV1"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Canonical personalized queue, honest empty result, or bounded degraded fallback",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MusicStationResultV1"
                }
              }
            }
          },
          "400": {
            "description": "Invalid station request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "413": {
            "description": "Request exceeds the 24 KiB limit",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "415": {
            "description": "Content-Type is not application/json",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "503": {
            "description": "Station service unavailable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsMusicStation",
        "summary": "CORS preflight",
        "tags": [
          "music"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/.well-known/taste-profile.json": {
      "get": {
        "operationId": "getTasteProfile",
        "summary": "Get Brendan’s portable public music taste profile",
        "description": "A bounded version 1 projection of the same canonical D1-owned music records used by the website, REST, Cap’n Web, and MCP.",
        "tags": [
          "music"
        ],
        "responses": {
          "200": {
            "description": "Portable taste profile document",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Last modification date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/taste-profile+json; version=1": {
                "schema": {
                  "$ref": "#/components/schemas/TasteProfileDocumentV1"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          }
        }
      },
      "head": {
        "operationId": "headTasteProfile",
        "summary": "Get taste profile validators only",
        "tags": [
          "music"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Last modification date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsTasteProfile",
        "summary": "CORS preflight",
        "tags": [
          "music"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/api/meta.json": {
      "get": {
        "operationId": "getMeta",
        "summary": "Get API metadata",
        "description": "Returns service metadata including collection counts and capabilities (RFC 8631 service-meta)",
        "tags": [
          "meta"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          }
        ],
        "x-idempotency": "intrinsic-safe-method",
        "responses": {
          "200": {
            "description": "API metadata",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Last modification date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceMeta"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "412": {
            "description": "Precondition Failed"
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headMeta",
        "summary": "Get metadata headers only",
        "tags": [
          "meta"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Last modification date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsMeta",
        "summary": "CORS preflight",
        "tags": [
          "meta"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    },
    "/api/status.json": {
      "get": {
        "operationId": "getStatus",
        "summary": "Get service status",
        "description": "Returns service health and status information (RFC 8631 status)",
        "tags": [
          "meta"
        ],
        "parameters": [
          {
            "name": "API-Version",
            "in": "header",
            "required": false,
            "description": "Header-based API version selection. Omit it or send 1.0.0.",
            "schema": {
              "type": "string",
              "enum": [
                "1.0.0"
              ],
              "default": "1.0.0"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Accepted for clients that attach a key uniformly. GET, HEAD, and OPTIONS are already safe and intrinsically idempotent, so read responses are not stored in an idempotency replay cache.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          }
        ],
        "x-idempotency": "intrinsic-safe-method",
        "responses": {
          "200": {
            "description": "Service is healthy",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Last modification date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/health+json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceStatus"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified"
          },
          "412": {
            "description": "Precondition Failed"
          },
          "429": {
            "description": "Public REST request limit exceeded",
            "headers": {
              "Retry-After": {
                "description": "Seconds before the request should be retried",
                "schema": {
                  "type": "integer",
                  "enum": [
                    60
                  ]
                }
              },
              "RateLimit": {
                "description": "Current quota state for the exhausted public-rest policy",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "503": {
            "description": "Service is degraded",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Last modification date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/health+json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceStatus"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headStatus",
        "summary": "Get status headers only",
        "tags": [
          "meta"
        ],
        "responses": {
          "200": {
            "description": "Headers only",
            "headers": {
              "Content-Usage": {
                "description": "IETF AIPREF usage preferences for this public content",
                "schema": {
                  "type": "string",
                  "examples": [
                    "train-ai=y, search=y"
                  ]
                }
              },
              "Content-Signal": {
                "description": "Compatibility AI usage preferences for deployed crawlers",
                "schema": {
                  "type": "string",
                  "examples": [
                    "ai-train=yes, search=yes, ai-input=yes"
                  ]
                }
              },
              "API-Version": {
                "description": "Selected public REST contract version",
                "schema": {
                  "type": "string",
                  "enum": [
                    "1.0.0"
                  ]
                }
              },
              "RateLimit-Policy": {
                "description": "Public REST quota policy: 1000 Worker requests per 60 seconds for each source and Cloudflare location",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Limit": {
                "description": "Compatibility form of the current public REST request limit",
                "schema": {
                  "type": "integer",
                  "enum": [
                    1000
                  ]
                }
              },
              "ETag": {
                "description": "Entity tag for conditional requests",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Last modification date",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "Cache-Control": {
                "description": "Caching directives",
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsStatus",
        "summary": "CORS preflight",
        "tags": [
          "meta"
        ],
        "responses": {
          "204": {
            "description": "CORS preflight response"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Activity": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "canonicalId": {
            "type": "string",
            "pattern": "^itm_[a-f0-9]{24,32}$"
          },
          "itemPath": {
            "type": "string"
          },
          "stravaActivityId": {
            "type": "string",
            "pattern": "^\\d+$"
          },
          "embedToken": {
            "type": [
              "string",
              "null"
            ],
            "pattern": "^[A-Za-z0-9_-]{20,200}$"
          },
          "routeSummaryPolyline": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 100000
          },
          "title": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "sportType": {
            "type": "string"
          },
          "startDate": {
            "type": "string",
            "format": "date-time"
          },
          "startDateLocal": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "timezone": {
            "type": [
              "string",
              "null"
            ]
          },
          "distanceMeters": {
            "type": "number",
            "minimum": 0
          },
          "movingTimeSeconds": {
            "type": "integer",
            "minimum": 0
          },
          "elapsedTimeSeconds": {
            "type": "integer",
            "minimum": 0
          },
          "totalElevationGainMeters": {
            "type": "number",
            "minimum": 0
          },
          "averageSpeedMetersPerSecond": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0
          },
          "maxSpeedMetersPerSecond": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0
          },
          "achievementCount": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0
          },
          "trainer": {
            "type": "boolean"
          },
          "commute": {
            "type": "boolean"
          },
          "manual": {
            "type": "boolean"
          },
          "visibility": {
            "const": "everyone"
          },
          "syncedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "id",
          "canonicalId",
          "itemPath",
          "stravaActivityId",
          "embedToken",
          "routeSummaryPolyline",
          "title",
          "description",
          "url",
          "sportType",
          "startDate",
          "startDateLocal",
          "timezone",
          "distanceMeters",
          "movingTimeSeconds",
          "elapsedTimeSeconds",
          "totalElevationGainMeters",
          "averageSpeedMetersPerSecond",
          "maxSpeedMetersPerSecond",
          "achievementCount",
          "trainer",
          "commute",
          "manual",
          "visibility",
          "syncedAt"
        ],
        "additionalProperties": false
      },
      "Movie": {
        "type": "object",
        "properties": {
          "topics": {
            "maxItems": 8,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "architecture",
                "art",
                "artificial intelligence",
                "basketball",
                "business",
                "cities",
                "creativity",
                "culture",
                "design",
                "food",
                "health",
                "history",
                "internet",
                "leadership",
                "music",
                "nature",
                "politics",
                "product development",
                "science",
                "sports",
                "technology",
                "urbanism",
                "work"
              ]
            }
          },
          "themes": {
            "maxItems": 5,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "ambition",
                "belonging",
                "change",
                "community",
                "connection",
                "craft",
                "discovery",
                "freedom",
                "friendship",
                "identity",
                "loss",
                "memory",
                "power",
                "resilience",
                "transformation"
              ]
            }
          },
          "moods": {
            "maxItems": 4,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "atmospheric",
                "calm",
                "contemplative",
                "energizing",
                "hopeful",
                "intimate",
                "joyful",
                "melancholic",
                "playful",
                "tense",
                "warm"
              ]
            }
          },
          "tones": {
            "maxItems": 3,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "analytical",
                "earnest",
                "humorous",
                "irreverent",
                "observational",
                "optimistic",
                "provocative",
                "reflective",
                "suspenseful"
              ]
            }
          },
          "styles": {
            "maxItems": 4,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "cinematic",
                "conversational",
                "documentary",
                "experimental",
                "immersive",
                "minimalist",
                "narrative",
                "practical",
                "technical",
                "visual"
              ]
            }
          },
          "pace": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "slow",
              "measured",
              "moderate",
              "brisk",
              "fast",
              "varied",
              null
            ]
          },
          "id": {
            "type": "string"
          },
          "canonicalId": {
            "type": "string",
            "pattern": "^itm_[a-f0-9]{24,32}$"
          },
          "itemPath": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "enum": [
              "movie",
              "tv"
            ]
          },
          "year": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1888,
            "maximum": 2100
          },
          "releaseDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "genres": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "directors": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "cast": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "youtubeTrailerUrl": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "notes": {
            "type": [
              "string",
              "null"
            ]
          },
          "addedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          }
        },
        "required": [
          "topics",
          "themes",
          "moods",
          "tones",
          "styles",
          "pace",
          "id",
          "canonicalId",
          "itemPath",
          "title",
          "type",
          "year",
          "releaseDate",
          "genres",
          "directors",
          "cast",
          "youtubeTrailerUrl",
          "notes",
          "addedAt"
        ],
        "additionalProperties": false
      },
      "Place": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "canonicalId": {
            "type": "string",
            "pattern": "^itm_[a-f0-9]{24,32}$"
          },
          "itemPath": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "placeId": {
            "type": "string"
          },
          "category": {
            "type": "string",
            "enum": [
              "food",
              "coffee",
              "bars",
              "nature",
              "entertainment",
              "lodging",
              "other"
            ]
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "food",
                "coffee",
                "bars",
                "nature",
                "entertainment",
                "lodging",
                "other"
              ]
            }
          },
          "address": {
            "type": [
              "string",
              "null"
            ]
          },
          "neighborhood": {
            "type": [
              "string",
              "null"
            ]
          },
          "city": {
            "type": [
              "string",
              "null"
            ]
          },
          "country": {
            "type": [
              "string",
              "null"
            ]
          },
          "latitude": {
            "type": "number",
            "minimum": -90,
            "maximum": 90
          },
          "longitude": {
            "type": "number",
            "minimum": -180,
            "maximum": 180
          },
          "website": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "notes": {
            "type": [
              "string",
              "null"
            ]
          },
          "googleMapsUrl": {
            "type": "string",
            "format": "uri"
          },
          "appleMapsUrl": {
            "type": "string",
            "format": "uri"
          },
          "geoUri": {
            "type": "string",
            "pattern": "^geo:-?[0-9.]+,-?[0-9.]+$"
          }
        },
        "required": [
          "id",
          "canonicalId",
          "itemPath",
          "name",
          "placeId",
          "category",
          "categories",
          "address",
          "neighborhood",
          "city",
          "country",
          "latitude",
          "longitude",
          "website",
          "notes",
          "googleMapsUrl",
          "appleMapsUrl",
          "geoUri"
        ],
        "additionalProperties": false
      },
      "Event": {
        "type": "object",
        "properties": {
          "topics": {
            "maxItems": 8,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "architecture",
                "art",
                "artificial intelligence",
                "basketball",
                "business",
                "cities",
                "creativity",
                "culture",
                "design",
                "food",
                "health",
                "history",
                "internet",
                "leadership",
                "music",
                "nature",
                "politics",
                "product development",
                "science",
                "sports",
                "technology",
                "urbanism",
                "work"
              ]
            }
          },
          "themes": {
            "maxItems": 5,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "ambition",
                "belonging",
                "change",
                "community",
                "connection",
                "craft",
                "discovery",
                "freedom",
                "friendship",
                "identity",
                "loss",
                "memory",
                "power",
                "resilience",
                "transformation"
              ]
            }
          },
          "moods": {
            "maxItems": 4,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "atmospheric",
                "calm",
                "contemplative",
                "energizing",
                "hopeful",
                "intimate",
                "joyful",
                "melancholic",
                "playful",
                "tense",
                "warm"
              ]
            }
          },
          "tones": {
            "maxItems": 3,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "analytical",
                "earnest",
                "humorous",
                "irreverent",
                "observational",
                "optimistic",
                "provocative",
                "reflective",
                "suspenseful"
              ]
            }
          },
          "styles": {
            "maxItems": 4,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "cinematic",
                "conversational",
                "documentary",
                "experimental",
                "immersive",
                "minimalist",
                "narrative",
                "practical",
                "technical",
                "visual"
              ]
            }
          },
          "pace": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "slow",
              "measured",
              "moderate",
              "brisk",
              "fast",
              "varied",
              null
            ]
          },
          "id": {
            "type": "string"
          },
          "canonicalId": {
            "type": "string",
            "pattern": "^itm_[a-f0-9]{24,32}$"
          },
          "itemPath": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "enum": [
              "concert",
              "sports"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "startsAt": {
            "type": "string",
            "format": "date-time"
          },
          "endsAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "venue": {
            "type": "string"
          },
          "city": {
            "type": [
              "string",
              "null"
            ]
          },
          "country": {
            "type": [
              "string",
              "null"
            ]
          },
          "participants": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "performers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "role": {
                  "type": "string"
                }
              },
              "required": [
                "name"
              ],
              "additionalProperties": false
            }
          },
          "teams": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "designation": {
                  "type": "string",
                  "enum": [
                    "home",
                    "away"
                  ]
                }
              },
              "required": [
                "name"
              ],
              "additionalProperties": false
            }
          },
          "genres": {
            "maxItems": 20,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            }
          },
          "league": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "scheduled",
              "preseason",
              "regular-season",
              "postseason",
              "cancelled",
              "postponed",
              "rescheduled",
              "sold-out",
              "other",
              null
            ]
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "image": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "addedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "notes": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "topics",
          "themes",
          "moods",
          "tones",
          "styles",
          "pace",
          "id",
          "canonicalId",
          "itemPath",
          "title",
          "type",
          "url",
          "startsAt",
          "endsAt",
          "venue",
          "city",
          "country",
          "participants",
          "performers",
          "teams",
          "genres",
          "league",
          "status",
          "description",
          "image",
          "addedAt",
          "notes"
        ],
        "additionalProperties": false
      },
      "SportEvent": {
        "type": "object",
        "properties": {
          "topics": {
            "maxItems": 8,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "architecture",
                "art",
                "artificial intelligence",
                "basketball",
                "business",
                "cities",
                "creativity",
                "culture",
                "design",
                "food",
                "health",
                "history",
                "internet",
                "leadership",
                "music",
                "nature",
                "politics",
                "product development",
                "science",
                "sports",
                "technology",
                "urbanism",
                "work"
              ]
            }
          },
          "themes": {
            "maxItems": 5,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "ambition",
                "belonging",
                "change",
                "community",
                "connection",
                "craft",
                "discovery",
                "freedom",
                "friendship",
                "identity",
                "loss",
                "memory",
                "power",
                "resilience",
                "transformation"
              ]
            }
          },
          "moods": {
            "maxItems": 4,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "atmospheric",
                "calm",
                "contemplative",
                "energizing",
                "hopeful",
                "intimate",
                "joyful",
                "melancholic",
                "playful",
                "tense",
                "warm"
              ]
            }
          },
          "tones": {
            "maxItems": 3,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "analytical",
                "earnest",
                "humorous",
                "irreverent",
                "observational",
                "optimistic",
                "provocative",
                "reflective",
                "suspenseful"
              ]
            }
          },
          "styles": {
            "maxItems": 4,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "cinematic",
                "conversational",
                "documentary",
                "experimental",
                "immersive",
                "minimalist",
                "narrative",
                "practical",
                "technical",
                "visual"
              ]
            }
          },
          "pace": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "slow",
              "measured",
              "moderate",
              "brisk",
              "fast",
              "varied",
              null
            ]
          },
          "id": {
            "type": "string"
          },
          "canonicalId": {
            "type": "string",
            "pattern": "^itm_[a-f0-9]{24,32}$"
          },
          "itemPath": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "sport": {
            "type": "string"
          },
          "league": {
            "type": "string"
          },
          "season": {
            "type": [
              "string",
              "null"
            ]
          },
          "date": {
            "type": "string",
            "format": "date",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
          },
          "startTime": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "endTime": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "timeZone": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "scheduled",
              "completed",
              "cancelled"
            ]
          },
          "experience": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "enum": [
                  "in-person",
                  "watch"
                ]
              },
              "status": {
                "type": "string",
                "enum": [
                  "planned",
                  "completed"
                ]
              }
            },
            "required": [
              "kind",
              "status"
            ],
            "additionalProperties": false
          },
          "venue": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^venue_[a-z0-9_]+$"
              },
              "name": {
                "type": "string"
              },
              "address": {
                "type": "string"
              },
              "city": {
                "type": "string"
              },
              "region": {
                "type": "string"
              },
              "country": {
                "type": "string"
              },
              "latitude": {
                "type": "number",
                "minimum": -90,
                "maximum": 90
              },
              "longitude": {
                "type": "number",
                "minimum": -180,
                "maximum": 180
              },
              "placeCanonicalId": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{24}$"
              }
            },
            "required": [
              "id",
              "name"
            ],
            "additionalProperties": false
          },
          "competitors": {
            "maxItems": 2,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "designation": {
                  "type": "string",
                  "enum": [
                    "away",
                    "home"
                  ]
                },
                "team": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "pattern": "^team_[a-z0-9_]+$"
                    },
                    "name": {
                      "type": "string"
                    },
                    "shortName": {
                      "type": "string"
                    },
                    "abbreviation": {
                      "type": "string"
                    },
                    "logos": {
                      "type": "object",
                      "properties": {
                        "universal": {
                          "type": "string",
                          "pattern": "^\\/team-logos\\/[a-z0-9][a-z0-9/_-]*\\.svg$"
                        },
                        "light": {
                          "type": "string",
                          "pattern": "^\\/team-logos\\/[a-z0-9][a-z0-9/_-]*\\.svg$"
                        },
                        "dark": {
                          "type": "string",
                          "pattern": "^\\/team-logos\\/[a-z0-9][a-z0-9/_-]*\\.svg$"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "id",
                    "name"
                  ],
                  "additionalProperties": false
                },
                "score": {
                  "type": "integer",
                  "minimum": 0
                },
                "result": {
                  "type": "string",
                  "enum": [
                    "win",
                    "loss",
                    "tie"
                  ]
                }
              },
              "required": [
                "designation",
                "team"
              ],
              "additionalProperties": false
            }
          },
          "teams": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "designation": {
                  "type": "string",
                  "enum": [
                    "home",
                    "away"
                  ]
                }
              },
              "required": [
                "name"
              ],
              "additionalProperties": false
            }
          },
          "notes": {
            "type": [
              "string",
              "null"
            ]
          },
          "referenceUrl": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "topics",
          "themes",
          "moods",
          "tones",
          "styles",
          "pace",
          "id",
          "canonicalId",
          "itemPath",
          "title",
          "sport",
          "league",
          "season",
          "date",
          "startTime",
          "endTime",
          "timeZone",
          "status",
          "experience",
          "venue",
          "competitors",
          "teams",
          "notes",
          "referenceUrl"
        ],
        "additionalProperties": false
      },
      "MusicItem": {
        "type": "object",
        "properties": {
          "topics": {
            "maxItems": 8,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "architecture",
                "art",
                "artificial intelligence",
                "basketball",
                "business",
                "cities",
                "creativity",
                "culture",
                "design",
                "food",
                "health",
                "history",
                "internet",
                "leadership",
                "music",
                "nature",
                "politics",
                "product development",
                "science",
                "sports",
                "technology",
                "urbanism",
                "work"
              ]
            }
          },
          "themes": {
            "maxItems": 5,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "ambition",
                "belonging",
                "change",
                "community",
                "connection",
                "craft",
                "discovery",
                "freedom",
                "friendship",
                "identity",
                "loss",
                "memory",
                "power",
                "resilience",
                "transformation"
              ]
            }
          },
          "moods": {
            "maxItems": 4,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "atmospheric",
                "calm",
                "contemplative",
                "energizing",
                "hopeful",
                "intimate",
                "joyful",
                "melancholic",
                "playful",
                "tense",
                "warm"
              ]
            }
          },
          "tones": {
            "maxItems": 3,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "analytical",
                "earnest",
                "humorous",
                "irreverent",
                "observational",
                "optimistic",
                "provocative",
                "reflective",
                "suspenseful"
              ]
            }
          },
          "styles": {
            "maxItems": 4,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "cinematic",
                "conversational",
                "documentary",
                "experimental",
                "immersive",
                "minimalist",
                "narrative",
                "practical",
                "technical",
                "visual"
              ]
            }
          },
          "pace": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "slow",
              "measured",
              "moderate",
              "brisk",
              "fast",
              "varied",
              null
            ]
          },
          "id": {
            "type": "string"
          },
          "canonicalId": {
            "type": "string",
            "pattern": "^itm_[a-f0-9]{24,32}$"
          },
          "itemPath": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "externalLinks": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "properties": {
                "provider": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 64,
                  "pattern": "^[a-z0-9][a-z0-9-]*$"
                },
                "relation": {
                  "type": "string",
                  "enum": [
                    "same-as",
                    "listen",
                    "purchase",
                    "appears-on",
                    "release-group",
                    "performance",
                    "official-page"
                  ]
                },
                "resourceType": {
                  "type": "string",
                  "enum": [
                    "recording",
                    "release",
                    "master",
                    "album",
                    "track",
                    "video",
                    "page"
                  ]
                },
                "url": {
                  "type": "string",
                  "format": "uri",
                  "pattern": "^https://"
                },
                "externalId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512
                }
              },
              "required": [
                "provider",
                "relation",
                "resourceType",
                "url"
              ],
              "additionalProperties": false
            }
          },
          "type": {
            "type": "string",
            "enum": [
              "album",
              "playlist",
              "mix",
              "track"
            ]
          },
          "artist": {
            "type": [
              "string",
              "null"
            ]
          },
          "album": {
            "type": [
              "string",
              "null"
            ]
          },
          "albumCanonicalId": {
            "type": [
              "string",
              "null"
            ],
            "pattern": "^itm_[a-f0-9]{24}$"
          },
          "durationSeconds": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1,
            "maximum": 86400
          },
          "isrc": {
            "type": [
              "string",
              "null"
            ],
            "pattern": "^[A-Z]{2}[A-Z0-9]{3}\\d{7}$"
          },
          "discNumber": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1
          },
          "trackNumber": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1
          },
          "compositionCanonicalId": {
            "type": [
              "string",
              "null"
            ],
            "pattern": "^itm_[a-f0-9]{24}$"
          },
          "genres": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "Afrobeats",
                "Ambient",
                "Blues",
                "Classical",
                "Country",
                "Dance",
                "Electronic",
                "Folk",
                "Funk",
                "Hip-Hop",
                "House",
                "Jazz",
                "Latin",
                "Metal",
                "Pop",
                "Punk",
                "R&B",
                "Reggae",
                "Rock",
                "Soul"
              ]
            }
          },
          "releaseDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "addedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "notes": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "topics",
          "themes",
          "moods",
          "tones",
          "styles",
          "pace",
          "id",
          "canonicalId",
          "itemPath",
          "title",
          "url",
          "externalLinks",
          "type",
          "artist",
          "album",
          "albumCanonicalId",
          "durationSeconds",
          "isrc",
          "discNumber",
          "trackNumber",
          "compositionCanonicalId",
          "genres",
          "releaseDate",
          "addedAt",
          "notes"
        ],
        "additionalProperties": false
      },
      "Concert": {
        "type": "object",
        "properties": {
          "topics": {
            "maxItems": 8,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "architecture",
                "art",
                "artificial intelligence",
                "basketball",
                "business",
                "cities",
                "creativity",
                "culture",
                "design",
                "food",
                "health",
                "history",
                "internet",
                "leadership",
                "music",
                "nature",
                "politics",
                "product development",
                "science",
                "sports",
                "technology",
                "urbanism",
                "work"
              ]
            }
          },
          "themes": {
            "maxItems": 5,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "ambition",
                "belonging",
                "change",
                "community",
                "connection",
                "craft",
                "discovery",
                "freedom",
                "friendship",
                "identity",
                "loss",
                "memory",
                "power",
                "resilience",
                "transformation"
              ]
            }
          },
          "moods": {
            "maxItems": 4,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "atmospheric",
                "calm",
                "contemplative",
                "energizing",
                "hopeful",
                "intimate",
                "joyful",
                "melancholic",
                "playful",
                "tense",
                "warm"
              ]
            }
          },
          "tones": {
            "maxItems": 3,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "analytical",
                "earnest",
                "humorous",
                "irreverent",
                "observational",
                "optimistic",
                "provocative",
                "reflective",
                "suspenseful"
              ]
            }
          },
          "styles": {
            "maxItems": 4,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "cinematic",
                "conversational",
                "documentary",
                "experimental",
                "immersive",
                "minimalist",
                "narrative",
                "practical",
                "technical",
                "visual"
              ]
            }
          },
          "pace": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "slow",
              "measured",
              "moderate",
              "brisk",
              "fast",
              "varied",
              null
            ]
          },
          "id": {
            "type": "string"
          },
          "canonicalId": {
            "type": "string",
            "pattern": "^itm_[a-f0-9]{24,32}$"
          },
          "itemPath": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "startDate": {
            "type": "string",
            "format": "date-time"
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "tourName": {
            "type": [
              "string",
              "null"
            ]
          },
          "artists": {
            "minItems": 1,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "role": {
                  "type": "string",
                  "enum": [
                    "headliner",
                    "support",
                    "opener",
                    "guest",
                    "festival-bill"
                  ]
                },
                "spotifyUrl": {
                  "type": "string",
                  "format": "uri"
                },
                "spotifyArtistId": {
                  "type": "string"
                }
              },
              "required": [
                "name"
              ],
              "additionalProperties": false
            }
          },
          "performers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "role": {
                  "type": "string"
                }
              },
              "required": [
                "name"
              ],
              "additionalProperties": false
            }
          },
          "genres": {
            "maxItems": 20,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            }
          },
          "venue": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "address": {
                "type": "string"
              },
              "city": {
                "type": "string"
              },
              "region": {
                "type": "string"
              },
              "country": {
                "type": "string"
              },
              "googlePlaceId": {
                "type": "string"
              },
              "latitude": {
                "type": "number",
                "minimum": -90,
                "maximum": 90
              },
              "longitude": {
                "type": "number",
                "minimum": -180,
                "maximum": 180
              }
            },
            "required": [
              "name"
            ],
            "additionalProperties": false
          },
          "venueMapsUrl": {
            "type": "string",
            "format": "uri"
          },
          "flyer": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "image": {
                "type": "string",
                "format": "uri"
              },
              "alt": {
                "type": "string"
              },
              "credit": {
                "type": "string"
              },
              "sourceUrl": {
                "type": "string",
                "format": "uri"
              },
              "rights": {
                "type": "string"
              }
            },
            "required": [
              "image"
            ],
            "additionalProperties": false
          },
          "flyerImage": {
            "type": [
              "string",
              "null"
            ]
          },
          "setlists": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "performerName": {
                  "type": "string"
                },
                "setlistFmId": {
                  "type": "string"
                },
                "sourceUrl": {
                  "type": "string",
                  "format": "uri"
                },
                "versionId": {
                  "type": "string"
                },
                "lastUpdated": {
                  "type": "string",
                  "format": "date-time"
                },
                "sets": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string"
                      },
                      "encore": {
                        "type": "integer",
                        "minimum": 1
                      },
                      "songs": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "title": {
                              "type": "string"
                            },
                            "coverArtist": {
                              "type": "string"
                            },
                            "note": {
                              "type": "string"
                            },
                            "tape": {
                              "type": "boolean"
                            }
                          },
                          "required": [
                            "title"
                          ],
                          "additionalProperties": false
                        }
                      }
                    },
                    "required": [
                      "songs"
                    ],
                    "additionalProperties": false
                  }
                }
              },
              "required": [
                "performerName",
                "sets"
              ],
              "additionalProperties": false
            }
          },
          "sources": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "provider": {
                  "type": "string",
                  "enum": [
                    "concert-archives",
                    "setlist.fm",
                    "venue",
                    "artist",
                    "ticket",
                    "video",
                    "other"
                  ]
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                },
                "label": {
                  "type": "string"
                },
                "retrievedAt": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "required": [
                "provider",
                "url"
              ],
              "additionalProperties": false
            }
          },
          "notes": {
            "type": [
              "string",
              "null"
            ]
          },
          "addedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          }
        },
        "required": [
          "topics",
          "themes",
          "moods",
          "tones",
          "styles",
          "pace",
          "id",
          "canonicalId",
          "itemPath",
          "title",
          "url",
          "startDate",
          "endDate",
          "tourName",
          "artists",
          "performers",
          "genres",
          "venue",
          "venueMapsUrl",
          "flyer",
          "flyerImage",
          "setlists",
          "sources",
          "notes",
          "addedAt"
        ],
        "additionalProperties": false
      },
      "Video": {
        "type": "object",
        "properties": {
          "topics": {
            "maxItems": 8,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "architecture",
                "art",
                "artificial intelligence",
                "basketball",
                "business",
                "cities",
                "creativity",
                "culture",
                "design",
                "food",
                "health",
                "history",
                "internet",
                "leadership",
                "music",
                "nature",
                "politics",
                "product development",
                "science",
                "sports",
                "technology",
                "urbanism",
                "work"
              ]
            }
          },
          "themes": {
            "maxItems": 5,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "ambition",
                "belonging",
                "change",
                "community",
                "connection",
                "craft",
                "discovery",
                "freedom",
                "friendship",
                "identity",
                "loss",
                "memory",
                "power",
                "resilience",
                "transformation"
              ]
            }
          },
          "moods": {
            "maxItems": 4,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "atmospheric",
                "calm",
                "contemplative",
                "energizing",
                "hopeful",
                "intimate",
                "joyful",
                "melancholic",
                "playful",
                "tense",
                "warm"
              ]
            }
          },
          "tones": {
            "maxItems": 3,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "analytical",
                "earnest",
                "humorous",
                "irreverent",
                "observational",
                "optimistic",
                "provocative",
                "reflective",
                "suspenseful"
              ]
            }
          },
          "styles": {
            "maxItems": 4,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "cinematic",
                "conversational",
                "documentary",
                "experimental",
                "immersive",
                "minimalist",
                "narrative",
                "practical",
                "technical",
                "visual"
              ]
            }
          },
          "pace": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "slow",
              "measured",
              "moderate",
              "brisk",
              "fast",
              "varied",
              null
            ]
          },
          "id": {
            "type": "string"
          },
          "canonicalId": {
            "type": "string",
            "pattern": "^itm_[a-f0-9]{24,32}$"
          },
          "itemPath": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "category": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "music-video",
              "live-performance",
              "music-making",
              "music-culture",
              "skate",
              "basketball",
              "sports",
              "tech-talk",
              "technology",
              "architecture-design",
              "documentary",
              "comedy",
              "nature",
              "health-fitness",
              "business",
              "politics",
              "culture",
              "other",
              null
            ]
          },
          "releaseDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "addedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "notes": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "topics",
          "themes",
          "moods",
          "tones",
          "styles",
          "pace",
          "id",
          "canonicalId",
          "itemPath",
          "title",
          "description",
          "url",
          "category",
          "releaseDate",
          "addedAt",
          "notes"
        ],
        "additionalProperties": false
      },
      "Podcast": {
        "type": "object",
        "properties": {
          "topics": {
            "maxItems": 8,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "architecture",
                "art",
                "artificial intelligence",
                "basketball",
                "business",
                "cities",
                "creativity",
                "culture",
                "design",
                "food",
                "health",
                "history",
                "internet",
                "leadership",
                "music",
                "nature",
                "politics",
                "product development",
                "science",
                "sports",
                "technology",
                "urbanism",
                "work"
              ]
            }
          },
          "themes": {
            "maxItems": 5,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "ambition",
                "belonging",
                "change",
                "community",
                "connection",
                "craft",
                "discovery",
                "freedom",
                "friendship",
                "identity",
                "loss",
                "memory",
                "power",
                "resilience",
                "transformation"
              ]
            }
          },
          "moods": {
            "maxItems": 4,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "atmospheric",
                "calm",
                "contemplative",
                "energizing",
                "hopeful",
                "intimate",
                "joyful",
                "melancholic",
                "playful",
                "tense",
                "warm"
              ]
            }
          },
          "tones": {
            "maxItems": 3,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "analytical",
                "earnest",
                "humorous",
                "irreverent",
                "observational",
                "optimistic",
                "provocative",
                "reflective",
                "suspenseful"
              ]
            }
          },
          "styles": {
            "maxItems": 4,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "cinematic",
                "conversational",
                "documentary",
                "experimental",
                "immersive",
                "minimalist",
                "narrative",
                "practical",
                "technical",
                "visual"
              ]
            }
          },
          "pace": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "slow",
              "measured",
              "moderate",
              "brisk",
              "fast",
              "varied",
              null
            ]
          },
          "id": {
            "type": "string"
          },
          "canonicalId": {
            "type": "string",
            "pattern": "^itm_[a-f0-9]{24,32}$"
          },
          "itemPath": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "showName": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "appleUrl": {
            "type": "string",
            "format": "uri"
          },
          "spotifyUrl": {
            "type": "string",
            "format": "uri"
          },
          "releaseDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "addedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "notes": {
            "type": [
              "string",
              "null"
            ]
          },
          "guests": {
            "maxItems": 30,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 300
                },
                "role": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 120
                },
                "canonicalPersonId": {
                  "type": "string",
                  "pattern": "^person_[a-z0-9_]+$"
                }
              },
              "required": [
                "name"
              ],
              "additionalProperties": false
            }
          },
          "feed": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "guid": {
                "type": "string",
                "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-5[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
              },
              "guidSource": {
                "type": "string",
                "enum": [
                  "publisher",
                  "derived"
                ]
              },
              "medium": {
                "type": "string",
                "minLength": 1,
                "maxLength": 40
              },
              "updateFrequency": {
                "type": "object",
                "properties": {
                  "description": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "complete": {
                    "type": "boolean"
                  },
                  "startsAt": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "date",
                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                      },
                      {
                        "type": "string",
                        "format": "date-time",
                        "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\\d|0[1-9]|3[01])[T ](?:0\\d|1\\d|2[0-3])(?::[0-5]\\d){2}(?:\\.\\d{1,9})?(?:Z| ?[+-](?:0\\d|1\\d|2[0-3])(?::?[0-5]\\d)?)$"
                      }
                    ]
                  },
                  "recurrenceRule": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  }
                },
                "required": [
                  "description"
                ],
                "additionalProperties": false
              },
              "usesPodping": {
                "type": "boolean"
              }
            },
            "required": [
              "url"
            ],
            "additionalProperties": false
          },
          "episodeGuid": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 1024
          },
          "episodeUrl": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "credits": {
            "maxItems": 100,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128
                },
                "role": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128
                },
                "group": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128
                },
                "canonicalPersonId": {
                  "type": "string",
                  "pattern": "^person_[a-z0-9_]+$"
                },
                "sourceUrl": {
                  "type": "string",
                  "format": "uri"
                },
                "imageUrl": {
                  "type": "string",
                  "format": "uri"
                }
              },
              "required": [
                "name"
              ],
              "additionalProperties": false
            }
          },
          "transcripts": {
            "maxItems": 20,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string",
                  "format": "uri"
                },
                "type": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "language": {
                  "type": "string",
                  "pattern": "^[A-Za-z]{2,8}(?:-[A-Za-z0-9]{1,8})*$"
                },
                "rel": {
                  "const": "captions"
                }
              },
              "required": [
                "url",
                "type"
              ],
              "additionalProperties": false
            }
          },
          "chapters": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "type": {
                "const": "application/json+chapters"
              }
            },
            "required": [
              "url",
              "type"
            ],
            "additionalProperties": false
          },
          "images": {
            "maxItems": 20,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string",
                  "format": "uri"
                },
                "alt": {
                  "type": "string",
                  "maxLength": 1000
                },
                "aspectRatio": {
                  "type": "string",
                  "pattern": "^\\d+(?:\\.\\d+)?\\/\\d+(?:\\.\\d+)?$"
                },
                "width": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 20000
                },
                "height": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 20000
                },
                "type": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "purposes": {
                  "maxItems": 20,
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  }
                }
              },
              "required": [
                "url"
              ],
              "additionalProperties": false
            }
          },
          "license": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "identifier": {
                "type": "string",
                "minLength": 1,
                "maxLength": 128
              },
              "url": {
                "type": "string",
                "format": "uri"
              }
            },
            "required": [
              "identifier"
            ],
            "additionalProperties": false
          },
          "funding": {
            "maxItems": 20,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string",
                  "format": "uri"
                },
                "label": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128
                }
              },
              "required": [
                "url",
                "label"
              ],
              "additionalProperties": false
            }
          },
          "soundbites": {
            "maxItems": 20,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "startTime": {
                  "type": "number",
                  "minimum": 0
                },
                "duration": {
                  "type": "number",
                  "minimum": 0.001,
                  "maximum": 3600
                },
                "title": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128
                }
              },
              "required": [
                "startTime",
                "duration"
              ],
              "additionalProperties": false
            }
          },
          "season": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "number": {
                "type": "integer",
                "minimum": 0
              },
              "name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 128
              }
            },
            "required": [
              "number"
            ],
            "additionalProperties": false
          },
          "episode": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "number": {
                "type": "number",
                "minimum": 0
              },
              "display": {
                "type": "string",
                "minLength": 1,
                "maxLength": 32
              }
            },
            "required": [
              "number"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "topics",
          "themes",
          "moods",
          "tones",
          "styles",
          "pace",
          "id",
          "canonicalId",
          "itemPath",
          "title",
          "showName",
          "description",
          "appleUrl",
          "spotifyUrl",
          "releaseDate",
          "addedAt",
          "notes",
          "guests",
          "feed",
          "episodeGuid",
          "episodeUrl",
          "credits",
          "transcripts",
          "chapters",
          "images",
          "license",
          "funding",
          "soundbites",
          "season",
          "episode"
        ],
        "additionalProperties": false
      },
      "Tweet": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "canonicalId": {
            "type": "string",
            "pattern": "^itm_[a-f0-9]{24,32}$"
          },
          "itemPath": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "author": {
            "type": "string"
          },
          "authorName": {
            "type": [
              "string",
              "null"
            ]
          },
          "authorUsername": {
            "type": [
              "string",
              "null"
            ]
          },
          "authorProfileImageUrl": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "text": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "createdAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "media": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "photo",
                    "video",
                    "animated_gif"
                  ]
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                },
                "previewImageUrl": {
                  "type": "string",
                  "format": "uri"
                },
                "altText": {
                  "type": "string"
                },
                "width": {
                  "type": "integer",
                  "minimum": 0
                },
                "height": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "required": [
                "type"
              ],
              "additionalProperties": false
            }
          },
          "addedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "notes": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "canonicalId",
          "itemPath",
          "title",
          "author",
          "authorName",
          "authorUsername",
          "authorProfileImageUrl",
          "text",
          "description",
          "url",
          "createdAt",
          "media",
          "addedAt",
          "notes"
        ],
        "additionalProperties": false
      },
      "Code": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "canonicalId": {
            "type": "string",
            "pattern": "^itm_[a-f0-9]{24,32}$"
          },
          "itemPath": {
            "type": "string"
          },
          "activityId": {
            "type": "string"
          },
          "kind": {
            "type": "string",
            "enum": [
              "release-published",
              "pull-request-merged",
              "pull-request-reviewed",
              "repository-created",
              "repository-publicized",
              "repository-starred",
              "other"
            ]
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "repo": {
            "type": "string"
          },
          "occurredAt": {
            "type": "string",
            "format": "date-time"
          },
          "addedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "source": {
            "type": "string",
            "enum": [
              "events-api",
              "graphql",
              "manual"
            ]
          },
          "score": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100
          },
          "reasons": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "notes": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "canonicalId",
          "itemPath",
          "activityId",
          "kind",
          "title",
          "url",
          "repo",
          "occurredAt",
          "addedAt",
          "source",
          "score",
          "reasons",
          "notes"
        ],
        "additionalProperties": false
      },
      "Photo": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "canonicalId": {
            "type": "string",
            "pattern": "^itm_[a-f0-9]{24,32}$"
          },
          "itemPath": {
            "type": "string"
          },
          "date": {
            "type": "string",
            "format": "date-time"
          },
          "image": {
            "type": "string"
          },
          "alt": {
            "type": [
              "string",
              "null"
            ]
          },
          "caption": {
            "type": [
              "string",
              "null"
            ]
          },
          "latitude": {
            "type": [
              "number",
              "null"
            ],
            "minimum": -90,
            "maximum": 90
          },
          "longitude": {
            "type": [
              "number",
              "null"
            ],
            "minimum": -180,
            "maximum": 180
          },
          "camera": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "canonicalId",
          "itemPath",
          "date",
          "image",
          "alt",
          "caption",
          "latitude",
          "longitude",
          "camera"
        ],
        "additionalProperties": false
      },
      "Book": {
        "type": "object",
        "properties": {
          "topics": {
            "maxItems": 8,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "architecture",
                "art",
                "artificial intelligence",
                "basketball",
                "business",
                "cities",
                "creativity",
                "culture",
                "design",
                "food",
                "health",
                "history",
                "internet",
                "leadership",
                "music",
                "nature",
                "politics",
                "product development",
                "science",
                "sports",
                "technology",
                "urbanism",
                "work"
              ]
            }
          },
          "themes": {
            "maxItems": 5,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "ambition",
                "belonging",
                "change",
                "community",
                "connection",
                "craft",
                "discovery",
                "freedom",
                "friendship",
                "identity",
                "loss",
                "memory",
                "power",
                "resilience",
                "transformation"
              ]
            }
          },
          "moods": {
            "maxItems": 4,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "atmospheric",
                "calm",
                "contemplative",
                "energizing",
                "hopeful",
                "intimate",
                "joyful",
                "melancholic",
                "playful",
                "tense",
                "warm"
              ]
            }
          },
          "tones": {
            "maxItems": 3,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "analytical",
                "earnest",
                "humorous",
                "irreverent",
                "observational",
                "optimistic",
                "provocative",
                "reflective",
                "suspenseful"
              ]
            }
          },
          "styles": {
            "maxItems": 4,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "cinematic",
                "conversational",
                "documentary",
                "experimental",
                "immersive",
                "minimalist",
                "narrative",
                "practical",
                "technical",
                "visual"
              ]
            }
          },
          "pace": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "slow",
              "measured",
              "moderate",
              "brisk",
              "fast",
              "varied",
              null
            ]
          },
          "id": {
            "type": "string"
          },
          "canonicalId": {
            "type": "string",
            "pattern": "^itm_[a-f0-9]{24,32}$"
          },
          "itemPath": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "image": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "author": {
            "type": "string"
          },
          "authorSortName": {
            "type": [
              "string",
              "null"
            ]
          },
          "additionalAuthors": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "contributors": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "role": {
                  "type": "string"
                }
              },
              "required": [
                "name",
                "role"
              ],
              "additionalProperties": false
            }
          },
          "year": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1,
            "maximum": 2100
          },
          "originalPublicationYear": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1,
            "maximum": 2100
          },
          "publicationDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "originalPublicationDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "originalTitle": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "amazonAsin": {
            "type": [
              "string",
              "null"
            ],
            "pattern": "^[A-Z0-9]{10}$"
          },
          "goodreadsId": {
            "type": [
              "string",
              "null"
            ],
            "pattern": "^\\d+$"
          },
          "goodreadsUrl": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "goodreadsWorkId": {
            "type": [
              "string",
              "null"
            ],
            "pattern": "^\\d+$"
          },
          "goodreadsWorkUrl": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "goodreadsAverageRating": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0,
            "maximum": 5
          },
          "goodreadsRatingsCount": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0
          },
          "goodreadsReviewsCount": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0
          },
          "goodreadsRatingsByStar": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "one": {
                "type": "integer",
                "minimum": 0
              },
              "two": {
                "type": "integer",
                "minimum": 0
              },
              "three": {
                "type": "integer",
                "minimum": 0
              },
              "four": {
                "type": "integer",
                "minimum": 0
              },
              "five": {
                "type": "integer",
                "minimum": 0
              }
            },
            "required": [
              "one",
              "two",
              "three",
              "four",
              "five"
            ],
            "additionalProperties": false
          },
          "goodreadsCurrentlyReadingCount": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0
          },
          "goodreadsWantToReadCount": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0
          },
          "goodreadsMetadataFetchedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "goodreadsShelves": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "goodreadsShelvesWithPositions": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "isbn10": {
            "type": [
              "string",
              "null"
            ],
            "pattern": "^\\d{9}[\\dX]$"
          },
          "isbn13": {
            "type": [
              "string",
              "null"
            ],
            "pattern": "^\\d{13}$"
          },
          "genres": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "language": {
            "type": [
              "string",
              "null"
            ]
          },
          "series": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                },
                "position": {
                  "type": "string"
                }
              },
              "required": [
                "name"
              ],
              "additionalProperties": false
            }
          },
          "awards": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "category": {
                  "type": "string"
                },
                "designation": {
                  "type": "string"
                },
                "year": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 2100
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                }
              },
              "required": [
                "name"
              ],
              "additionalProperties": false
            }
          },
          "rating": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1,
            "maximum": 5
          },
          "dateRead": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "purchasedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "purchaseFormat": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "kindle",
              "paperback",
              "hardcover",
              "print",
              null
            ]
          },
          "addedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "publisher": {
            "type": [
              "string",
              "null"
            ]
          },
          "binding": {
            "type": [
              "string",
              "null"
            ]
          },
          "pageCount": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1
          },
          "readCount": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1
          },
          "ownedCopies": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0
          },
          "review": {
            "type": [
              "string",
              "null"
            ]
          },
          "reviewIsSpoiler": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "notes": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "topics",
          "themes",
          "moods",
          "tones",
          "styles",
          "pace",
          "id",
          "canonicalId",
          "itemPath",
          "title",
          "description",
          "image",
          "author",
          "authorSortName",
          "additionalAuthors",
          "contributors",
          "year",
          "originalPublicationYear",
          "publicationDate",
          "originalPublicationDate",
          "originalTitle",
          "url",
          "amazonAsin",
          "goodreadsId",
          "goodreadsUrl",
          "goodreadsWorkId",
          "goodreadsWorkUrl",
          "goodreadsAverageRating",
          "goodreadsRatingsCount",
          "goodreadsReviewsCount",
          "goodreadsRatingsByStar",
          "goodreadsCurrentlyReadingCount",
          "goodreadsWantToReadCount",
          "goodreadsMetadataFetchedAt",
          "goodreadsShelves",
          "goodreadsShelvesWithPositions",
          "isbn10",
          "isbn13",
          "genres",
          "language",
          "series",
          "awards",
          "rating",
          "dateRead",
          "purchasedAt",
          "purchaseFormat",
          "addedAt",
          "publisher",
          "binding",
          "pageCount",
          "readCount",
          "ownedCopies",
          "review",
          "reviewIsSpoiler",
          "notes"
        ],
        "additionalProperties": false
      },
      "WorkTimelineItem": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{24}$"
              },
              "kind": {
                "const": "work"
              },
              "title": {
                "type": "string"
              },
              "sourceUrl": {
                "type": "string",
                "format": "uri"
              },
              "occurredAt": {
                "type": "string",
                "pattern": "^\\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\\d|3[01]))?)?$"
              },
              "company": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "itemPath": {
                "type": "string"
              },
              "addedAt": {
                "type": "string",
                "format": "date-time",
                "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\\d|0[1-9]|3[01])[T ](?:0\\d|1\\d|2[0-3])(?::[0-5]\\d){2}(?:\\.\\d{1,9})?(?:Z| ?[+-](?:0\\d|1\\d|2[0-3])(?::?[0-5]\\d)?)$"
              }
            },
            "required": [
              "id",
              "kind",
              "title",
              "sourceUrl",
              "occurredAt",
              "company",
              "itemPath",
              "addedAt"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{24}$"
              },
              "kind": {
                "const": "employment"
              },
              "title": {
                "type": "string"
              },
              "company": {
                "type": "string"
              },
              "startDate": {
                "type": "string",
                "pattern": "^\\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\\d|3[01]))?)?$"
              },
              "endDate": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\\d|3[01]))?)?$"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "itemPath": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "kind",
              "title",
              "company",
              "startDate",
              "endDate",
              "itemPath"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{24}$"
              },
              "kind": {
                "const": "education"
              },
              "institution": {
                "type": "string"
              },
              "credential": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "fieldOfStudy": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "startDate": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\\d|3[01]))?)?$"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "endDate": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\\d|3[01]))?)?$"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "artifacts": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "title": {
                      "type": "string"
                    },
                    "sourceUrl": {
                      "type": "string",
                      "format": "uri"
                    },
                    "occurredAt": {
                      "type": "string",
                      "pattern": "^\\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\\d|3[01]))?)?$"
                    }
                  },
                  "required": [
                    "title",
                    "sourceUrl",
                    "occurredAt"
                  ],
                  "additionalProperties": false
                }
              },
              "itemPath": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "kind",
              "institution",
              "credential",
              "fieldOfStudy",
              "startDate",
              "endDate",
              "artifacts",
              "itemPath"
            ],
            "additionalProperties": false
          }
        ]
      },
      "Reading": {
        "type": "object",
        "properties": {
          "topics": {
            "maxItems": 8,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "architecture",
                "art",
                "artificial intelligence",
                "basketball",
                "business",
                "cities",
                "creativity",
                "culture",
                "design",
                "food",
                "health",
                "history",
                "internet",
                "leadership",
                "music",
                "nature",
                "politics",
                "product development",
                "science",
                "sports",
                "technology",
                "urbanism",
                "work"
              ]
            }
          },
          "themes": {
            "maxItems": 5,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "ambition",
                "belonging",
                "change",
                "community",
                "connection",
                "craft",
                "discovery",
                "freedom",
                "friendship",
                "identity",
                "loss",
                "memory",
                "power",
                "resilience",
                "transformation"
              ]
            }
          },
          "moods": {
            "maxItems": 4,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "atmospheric",
                "calm",
                "contemplative",
                "energizing",
                "hopeful",
                "intimate",
                "joyful",
                "melancholic",
                "playful",
                "tense",
                "warm"
              ]
            }
          },
          "tones": {
            "maxItems": 3,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "analytical",
                "earnest",
                "humorous",
                "irreverent",
                "observational",
                "optimistic",
                "provocative",
                "reflective",
                "suspenseful"
              ]
            }
          },
          "styles": {
            "maxItems": 4,
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "enum": [
                "cinematic",
                "conversational",
                "documentary",
                "experimental",
                "immersive",
                "minimalist",
                "narrative",
                "practical",
                "technical",
                "visual"
              ]
            }
          },
          "pace": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "slow",
              "measured",
              "moderate",
              "brisk",
              "fast",
              "varied",
              null
            ]
          },
          "id": {
            "type": "string"
          },
          "canonicalId": {
            "type": "string",
            "pattern": "^itm_[a-f0-9]{24,32}$"
          },
          "itemPath": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "normalizedUrl": {
            "type": "string",
            "format": "uri"
          },
          "siteName": {
            "type": [
              "string",
              "null"
            ]
          },
          "domain": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "image": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "author": {
            "type": [
              "string",
              "null"
            ]
          },
          "publishedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "addedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "metadataSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "open_graph",
              "twitter_card",
              "semantic",
              "fallback",
              null
            ]
          },
          "fetchedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "tags": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "topics",
          "themes",
          "moods",
          "tones",
          "styles",
          "pace",
          "id",
          "canonicalId",
          "itemPath",
          "title",
          "url",
          "normalizedUrl",
          "siteName",
          "domain",
          "description",
          "image",
          "author",
          "publishedAt",
          "addedAt",
          "metadataSource",
          "fetchedAt",
          "tags"
        ],
        "additionalProperties": false
      },
      "BlogItem": {
        "type": "object",
        "properties": {
          "topics": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "architecture",
                    "art",
                    "artificial intelligence",
                    "basketball",
                    "business",
                    "cities",
                    "creativity",
                    "culture",
                    "design",
                    "food",
                    "health",
                    "history",
                    "internet",
                    "leadership",
                    "music",
                    "nature",
                    "politics",
                    "product development",
                    "science",
                    "sports",
                    "technology",
                    "urbanism",
                    "work"
                  ]
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "themes": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "ambition",
                    "belonging",
                    "change",
                    "community",
                    "connection",
                    "craft",
                    "discovery",
                    "freedom",
                    "friendship",
                    "identity",
                    "loss",
                    "memory",
                    "power",
                    "resilience",
                    "transformation"
                  ]
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "moods": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "atmospheric",
                    "calm",
                    "contemplative",
                    "energizing",
                    "hopeful",
                    "intimate",
                    "joyful",
                    "melancholic",
                    "playful",
                    "tense",
                    "warm"
                  ]
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "tones": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "analytical",
                    "earnest",
                    "humorous",
                    "irreverent",
                    "observational",
                    "optimistic",
                    "provocative",
                    "reflective",
                    "suspenseful"
                  ]
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "styles": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "cinematic",
                    "conversational",
                    "documentary",
                    "experimental",
                    "immersive",
                    "minimalist",
                    "narrative",
                    "practical",
                    "technical",
                    "visual"
                  ]
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "pace": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "slow",
                  "measured",
                  "moderate",
                  "brisk",
                  "fast",
                  "varied"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "type": "string"
          },
          "canonicalId": {
            "type": "string",
            "pattern": "^itm_[a-f0-9]{24}$"
          },
          "slug": {
            "type": "string"
          },
          "itemPath": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "date": {
            "type": "string",
            "format": "date-time",
            "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\\d|0[1-9]|3[01])[T ](?:0\\d|1\\d|2[0-3])(?::[0-5]\\d){2}(?:\\.\\d{1,9})?(?:Z| ?[+-](?:0\\d|1\\d|2[0-3])(?::?[0-5]\\d)?)$"
          }
        },
        "required": [
          "topics",
          "themes",
          "moods",
          "tones",
          "styles",
          "pace",
          "id",
          "canonicalId",
          "slug",
          "itemPath",
          "title",
          "description",
          "date"
        ],
        "additionalProperties": false
      },
      "WritingItem": {
        "type": "object",
        "properties": {
          "topics": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "architecture",
                    "art",
                    "artificial intelligence",
                    "basketball",
                    "business",
                    "cities",
                    "creativity",
                    "culture",
                    "design",
                    "food",
                    "health",
                    "history",
                    "internet",
                    "leadership",
                    "music",
                    "nature",
                    "politics",
                    "product development",
                    "science",
                    "sports",
                    "technology",
                    "urbanism",
                    "work"
                  ]
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "themes": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "ambition",
                    "belonging",
                    "change",
                    "community",
                    "connection",
                    "craft",
                    "discovery",
                    "freedom",
                    "friendship",
                    "identity",
                    "loss",
                    "memory",
                    "power",
                    "resilience",
                    "transformation"
                  ]
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "moods": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "atmospheric",
                    "calm",
                    "contemplative",
                    "energizing",
                    "hopeful",
                    "intimate",
                    "joyful",
                    "melancholic",
                    "playful",
                    "tense",
                    "warm"
                  ]
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "tones": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "analytical",
                    "earnest",
                    "humorous",
                    "irreverent",
                    "observational",
                    "optimistic",
                    "provocative",
                    "reflective",
                    "suspenseful"
                  ]
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "styles": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "cinematic",
                    "conversational",
                    "documentary",
                    "experimental",
                    "immersive",
                    "minimalist",
                    "narrative",
                    "practical",
                    "technical",
                    "visual"
                  ]
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "pace": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "slow",
                  "measured",
                  "moderate",
                  "brisk",
                  "fast",
                  "varied"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "type": "string"
          },
          "canonicalId": {
            "type": "string",
            "pattern": "^itm_[a-f0-9]{24}$"
          },
          "itemPath": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "normalizedUrl": {
            "type": "string",
            "format": "uri"
          },
          "source": {
            "type": "string"
          },
          "siteName": {
            "type": [
              "string",
              "null"
            ]
          },
          "domain": {
            "type": "string"
          },
          "date": {
            "type": "string",
            "format": "date-time",
            "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\\d|0[1-9]|3[01])[T ](?:0\\d|1\\d|2[0-3])(?::[0-5]\\d){2}(?:\\.\\d{1,9})?(?:Z| ?[+-](?:0\\d|1\\d|2[0-3])(?::?[0-5]\\d)?)$"
          },
          "publishedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\\d|0[1-9]|3[01])[T ](?:0\\d|1\\d|2[0-3])(?::[0-5]\\d){2}(?:\\.\\d{1,9})?(?:Z| ?[+-](?:0\\d|1\\d|2[0-3])(?::?[0-5]\\d)?)$"
              },
              {
                "type": "null"
              }
            ]
          },
          "addedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\\d|0[1-9]|3[01])[T ](?:0\\d|1\\d|2[0-3])(?::[0-5]\\d){2}(?:\\.\\d{1,9})?(?:Z| ?[+-](?:0\\d|1\\d|2[0-3])(?::?[0-5]\\d)?)$"
              },
              {
                "type": "null"
              }
            ]
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "image": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ]
          },
          "author": {
            "type": [
              "string",
              "null"
            ]
          },
          "metadataSource": {
            "type": [
              "string",
              "null"
            ]
          },
          "fetchedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\\d|0[1-9]|3[01])[T ](?:0\\d|1\\d|2[0-3])(?::[0-5]\\d){2}(?:\\.\\d{1,9})?(?:Z| ?[+-](?:0\\d|1\\d|2[0-3])(?::?[0-5]\\d)?)$"
              },
              {
                "type": "null"
              }
            ]
          },
          "tags": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "topics",
          "themes",
          "moods",
          "tones",
          "styles",
          "pace",
          "id",
          "canonicalId",
          "itemPath",
          "title",
          "url",
          "normalizedUrl",
          "source",
          "siteName",
          "domain",
          "date",
          "publishedAt",
          "addedAt",
          "description",
          "image",
          "author",
          "metadataSource",
          "fetchedAt",
          "tags"
        ],
        "additionalProperties": false
      },
      "SearchResultItem": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "canonicalId": {
            "type": "string",
            "pattern": "^itm_[a-f0-9]{24}$"
          },
          "source": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "subtitle": {
            "type": [
              "string",
              "null"
            ]
          },
          "itemPath": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "score": {
            "type": "number"
          },
          "match": {
            "type": "object",
            "properties": {
              "field": {
                "type": "string",
                "enum": [
                  "canonical-id",
                  "canonical-path",
                  "source-url",
                  "title",
                  "subtitle",
                  "keywords",
                  "description"
                ]
              },
              "label": {
                "type": "string",
                "maxLength": 48
              },
              "excerpt": {
                "type": "string",
                "maxLength": 240
              },
              "terms": {
                "maxItems": 12,
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 64
                }
              },
              "kind": {
                "type": "string",
                "enum": [
                  "exact",
                  "prefix",
                  "lexical",
                  "alias",
                  "fuzzy",
                  "semantic"
                ]
              }
            },
            "required": [
              "field",
              "label",
              "excerpt",
              "terms",
              "kind"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "id",
          "canonicalId",
          "source",
          "type",
          "title",
          "subtitle",
          "itemPath",
          "url",
          "score"
        ],
        "additionalProperties": false
      },
      "FeedItem": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "canonicalId": {
            "type": "string",
            "pattern": "^itm_[a-f0-9]{24}$"
          },
          "kind": {
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "itemPath": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": [
              "string",
              "null"
            ]
          },
          "activityAt": {
            "type": "string",
            "format": "date-time",
            "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\\d|0[1-9]|3[01])[T ](?:0\\d|1\\d|2[0-3])(?::[0-5]\\d){2}(?:\\.\\d{1,9})?(?:Z| ?[+-](?:0\\d|1\\d|2[0-3])(?::?[0-5]\\d)?)$"
          },
          "activityYear": {
            "type": "integer"
          },
          "contentTimestamp": {
            "type": "string",
            "format": "date-time",
            "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\\d|0[1-9]|3[01])[T ](?:0\\d|1\\d|2[0-3])(?::[0-5]\\d){2}(?:\\.\\d{1,9})?(?:Z| ?[+-](?:0\\d|1\\d|2[0-3])(?::?[0-5]\\d)?)$"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time",
            "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\\d|0[1-9]|3[01])[T ](?:0\\d|1\\d|2[0-3])(?::[0-5]\\d){2}(?:\\.\\d{1,9})?(?:Z| ?[+-](?:0\\d|1\\d|2[0-3])(?::?[0-5]\\d)?)$"
          },
          "summary": {
            "type": [
              "string",
              "null"
            ]
          },
          "year": {
            "type": [
              "integer",
              "null"
            ]
          },
          "slug": {
            "type": "string"
          },
          "writingSource": {
            "type": "string",
            "enum": [
              "substack",
              "cloudflare",
              "other"
            ]
          },
          "videoId": {
            "type": "string"
          },
          "embedUrl": {
            "type": "string",
            "format": "uri"
          },
          "movieType": {
            "type": "string",
            "enum": [
              "movie",
              "tv"
            ]
          },
          "category": {
            "type": "string"
          },
          "playlistId": {
            "type": "string"
          },
          "mixId": {
            "type": "string"
          },
          "mixSource": {
            "type": "string",
            "enum": [
              "youtube",
              "soundcloud",
              "unknown"
            ]
          },
          "albumId": {
            "type": "string"
          },
          "trackId": {
            "type": "string"
          },
          "appleUrl": {
            "type": "string",
            "format": "uri"
          },
          "spotifyUrl": {
            "type": "string",
            "format": "uri"
          },
          "tweetId": {
            "type": "string"
          },
          "author": {
            "type": "string"
          },
          "eventType": {
            "type": "string"
          },
          "repo": {
            "type": "string"
          },
          "score": {
            "type": "number"
          },
          "reasons": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "notes": {
            "type": "string"
          },
          "domain": {
            "type": "string"
          },
          "siteName": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "image": {
            "type": "string"
          },
          "alt": {
            "type": "string"
          },
          "caption": {
            "type": "string"
          },
          "bookAuthor": {
            "type": "string"
          },
          "displayYear": {
            "type": "integer"
          },
          "stravaActivityId": {
            "type": "string"
          },
          "embedToken": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{20,200}$"
          },
          "routeSummaryPolyline": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100000
          },
          "sportType": {
            "type": "string"
          },
          "distanceMeters": {
            "type": "number",
            "minimum": 0
          },
          "movingTimeSeconds": {
            "type": "integer",
            "minimum": 0
          },
          "totalElevationGainMeters": {
            "type": "number",
            "minimum": 0
          },
          "sportingEvent": {
            "type": "object",
            "properties": {
              "sport": {
                "type": "string"
              },
              "league": {
                "type": "string"
              },
              "date": {
                "type": "string",
                "format": "date",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
              },
              "startTime": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\\d|0[1-9]|3[01])[T ](?:0\\d|1\\d|2[0-3])(?::[0-5]\\d){2}(?:\\.\\d{1,9})?(?:Z| ?[+-](?:0\\d|1\\d|2[0-3])(?::?[0-5]\\d)?)$"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "endTime": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\\d|0[1-9]|3[01])[T ](?:0\\d|1\\d|2[0-3])(?::[0-5]\\d){2}(?:\\.\\d{1,9})?(?:Z| ?[+-](?:0\\d|1\\d|2[0-3])(?::?[0-5]\\d)?)$"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "timeZone": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "status": {
                "type": "string",
                "enum": [
                  "scheduled",
                  "completed",
                  "cancelled"
                ]
              },
              "experience": {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "in-person",
                      "watch"
                    ]
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "planned",
                      "completed"
                    ]
                  }
                },
                "required": [
                  "kind",
                  "status"
                ],
                "additionalProperties": false
              },
              "venue": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string"
                      },
                      "city": {
                        "type": "string"
                      },
                      "region": {
                        "type": "string"
                      },
                      "country": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "name"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "competitors": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "designation": {
                      "type": "string",
                      "enum": [
                        "away",
                        "home"
                      ]
                    },
                    "team": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "shortName": {
                          "type": "string"
                        },
                        "abbreviation": {
                          "type": "string"
                        },
                        "logos": {
                          "type": "object",
                          "properties": {
                            "universal": {
                              "type": "string"
                            },
                            "light": {
                              "type": "string"
                            },
                            "dark": {
                              "type": "string"
                            }
                          },
                          "additionalProperties": false
                        }
                      },
                      "required": [
                        "id",
                        "name"
                      ],
                      "additionalProperties": false
                    },
                    "score": {
                      "type": "integer",
                      "minimum": 0
                    },
                    "result": {
                      "type": "string",
                      "enum": [
                        "win",
                        "loss",
                        "tie"
                      ]
                    }
                  },
                  "required": [
                    "designation",
                    "team"
                  ],
                  "additionalProperties": false
                }
              },
              "referenceUrl": {
                "type": "string",
                "format": "uri"
              }
            },
            "required": [
              "sport",
              "league",
              "date",
              "startTime",
              "endTime",
              "timeZone",
              "status",
              "experience",
              "venue",
              "competitors",
              "referenceUrl"
            ],
            "additionalProperties": false
          },
          "semantic": {
            "type": "object",
            "properties": {
              "creators": {
                "maxItems": 12,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 240
                    },
                    "role": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 64
                    }
                  },
                  "required": [
                    "name"
                  ],
                  "additionalProperties": false
                }
              },
              "parent": {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "album",
                      "podcast-show",
                      "series",
                      "tour"
                    ]
                  },
                  "title": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 240
                  },
                  "canonicalId": {
                    "type": "string",
                    "pattern": "^itm_[a-f0-9]{24}$"
                  },
                  "position": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 48
                  }
                },
                "required": [
                  "kind",
                  "title"
                ],
                "additionalProperties": false
              },
              "genres": {
                "maxItems": 12,
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 240
                }
              },
              "topics": {
                "maxItems": 12,
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 240
                }
              },
              "publication": {
                "type": "string",
                "minLength": 1,
                "maxLength": 240
              },
              "venue": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 240
                  },
                  "city": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 240
                  },
                  "region": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 240
                  }
                },
                "required": [
                  "name"
                ],
                "additionalProperties": false
              },
              "personal": {
                "type": "object",
                "properties": {
                  "rating": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 5
                  },
                  "experience": {
                    "type": "string",
                    "enum": [
                      "in-person",
                      "watch"
                    ]
                  },
                  "format": {
                    "type": "string",
                    "enum": [
                      "kindle",
                      "paperback",
                      "hardcover",
                      "print"
                    ]
                  },
                  "sourceSignals": {
                    "maxItems": 4,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "authored",
                        "retweeted",
                        "liked",
                        "bookmarked"
                      ]
                    }
                  },
                  "readCount": {
                    "type": "integer",
                    "minimum": 1
                  },
                  "dateRead": {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\\d|0[1-9]|3[01])[T ](?:0\\d|1\\d|2[0-3])(?::[0-5]\\d){2}(?:\\.\\d{1,9})?(?:Z| ?[+-](?:0\\d|1\\d|2[0-3])(?::?[0-5]\\d)?)$"
                  }
                },
                "additionalProperties": false
              },
              "counts": {
                "type": "object",
                "properties": {
                  "tracks": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "songs": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "sets": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "encores": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "pages": {
                    "type": "integer",
                    "minimum": 1
                  },
                  "performers": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "achievements": {
                    "type": "integer",
                    "minimum": 0
                  }
                },
                "additionalProperties": false
              },
              "activity": {
                "type": "object",
                "properties": {
                  "averageSpeedMetersPerSecond": {
                    "type": "number",
                    "minimum": 0
                  },
                  "achievementCount": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "trainer": {
                    "type": "boolean"
                  },
                  "commute": {
                    "type": "boolean"
                  },
                  "manual": {
                    "type": "boolean"
                  }
                },
                "additionalProperties": false
              },
              "sourceLabel": {
                "type": "string",
                "minLength": 1,
                "maxLength": 240
              },
              "camera": {
                "type": "string",
                "minLength": 1,
                "maxLength": 240
              },
              "endAt": {
                "type": "string",
                "format": "date-time",
                "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\\d|0[1-9]|3[01])[T ](?:0\\d|1\\d|2[0-3])(?::[0-5]\\d){2}(?:\\.\\d{1,9})?(?:Z| ?[+-](?:0\\d|1\\d|2[0-3])(?::?[0-5]\\d)?)$"
              }
            },
            "additionalProperties": false
          },
          "company": {
            "type": "string"
          },
          "occurredAt": {
            "type": "string",
            "pattern": "^\\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\\d|3[01]))?)?$"
          }
        },
        "required": [
          "id",
          "canonicalId",
          "kind",
          "source",
          "title",
          "itemPath",
          "url",
          "activityAt",
          "activityYear",
          "contentTimestamp",
          "timestamp",
          "summary",
          "year"
        ],
        "additionalProperties": false
      },
      "PaginationMeta": {
        "type": "object",
        "properties": {
          "totalCount": {
            "type": "integer"
          },
          "pageSize": {
            "type": "integer"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          },
          "facets": {
            "type": "object",
            "additionalProperties": true
          },
          "correction": {
            "type": "object",
            "properties": {
              "original": {
                "type": "string"
              },
              "resolved": {
                "type": "string"
              },
              "applied": {
                "type": "boolean",
                "const": true
              },
              "kind": {
                "type": "string",
                "enum": [
                  "alias",
                  "fuzzy"
                ]
              }
            },
            "required": [
              "original",
              "resolved",
              "applied",
              "kind"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "totalCount",
          "pageSize",
          "timestamp"
        ],
        "additionalProperties": false
      },
      "PaginationLinks": {
        "type": "object",
        "properties": {
          "self": {
            "type": "string",
            "format": "uri"
          },
          "first": {
            "type": "string",
            "format": "uri"
          },
          "next": {
            "type": "string",
            "format": "uri"
          },
          "prev": {
            "type": "string",
            "format": "uri"
          },
          "last": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "self",
          "first",
          "last"
        ],
        "additionalProperties": false
      },
      "CollectionsMetadata": {
        "type": "object",
        "properties": {
          "activities": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer",
                "minimum": 0
              },
              "endpoint": {
                "const": "/api/activities.json"
              },
              "filters": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "year",
                    "sportType",
                    "q"
                  ]
                }
              },
              "sortable": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "startDate",
                    "distanceMeters",
                    "movingTimeSeconds",
                    "title"
                  ]
                }
              }
            },
            "required": [
              "count",
              "endpoint",
              "filters",
              "sortable"
            ],
            "additionalProperties": false
          },
          "movies": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer",
                "minimum": 0
              },
              "endpoint": {
                "const": "/api/movies.json"
              },
              "filters": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "type",
                    "year",
                    "genre",
                    "director",
                    "actor",
                    "q"
                  ]
                }
              },
              "sortable": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "releaseDate",
                    "year",
                    "addedAt",
                    "title"
                  ]
                }
              }
            },
            "required": [
              "count",
              "endpoint",
              "filters",
              "sortable"
            ],
            "additionalProperties": false
          },
          "places": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer",
                "minimum": 0
              },
              "endpoint": {
                "const": "/api/places.json"
              },
              "filters": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "city",
                    "country",
                    "category",
                    "neighborhood",
                    "q"
                  ]
                }
              },
              "sortable": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "name"
                  ]
                }
              }
            },
            "required": [
              "count",
              "endpoint",
              "filters",
              "sortable"
            ],
            "additionalProperties": false
          },
          "events": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer",
                "minimum": 0
              },
              "endpoint": {
                "const": "/api/events.json"
              },
              "filters": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "type",
                    "city",
                    "year",
                    "q"
                  ]
                }
              },
              "sortable": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "startsAt",
                    "addedAt",
                    "title"
                  ]
                }
              }
            },
            "required": [
              "count",
              "endpoint",
              "filters",
              "sortable"
            ],
            "additionalProperties": false
          },
          "sports": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer",
                "minimum": 0
              },
              "endpoint": {
                "const": "/api/sporting-events.json"
              },
              "filters": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "team",
                    "sport",
                    "league",
                    "year",
                    "city",
                    "venue",
                    "experience",
                    "experienceStatus",
                    "q"
                  ]
                }
              },
              "sortable": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "date",
                    "title",
                    "sport",
                    "league"
                  ]
                }
              }
            },
            "required": [
              "count",
              "endpoint",
              "filters",
              "sortable"
            ],
            "additionalProperties": false
          },
          "music": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer",
                "minimum": 0
              },
              "endpoint": {
                "const": "/api/music.json"
              },
              "filters": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "genre",
                    "type",
                    "q"
                  ]
                }
              },
              "sortable": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "addedAt",
                    "releaseDate",
                    "title",
                    "relevance"
                  ]
                }
              }
            },
            "required": [
              "count",
              "endpoint",
              "filters",
              "sortable"
            ],
            "additionalProperties": false
          },
          "concerts": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer",
                "minimum": 0
              },
              "endpoint": {
                "const": "/api/concerts.json"
              },
              "filters": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "year",
                    "artist",
                    "venue",
                    "city",
                    "q"
                  ]
                }
              },
              "sortable": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "startDate",
                    "addedAt",
                    "title"
                  ]
                }
              }
            },
            "required": [
              "count",
              "endpoint",
              "filters",
              "sortable"
            ],
            "additionalProperties": false
          },
          "videos": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer",
                "minimum": 0
              },
              "endpoint": {
                "const": "/api/videos.json"
              },
              "filters": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "category",
                    "q"
                  ]
                }
              },
              "sortable": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "addedAt",
                    "releaseDate",
                    "title"
                  ]
                }
              }
            },
            "required": [
              "count",
              "endpoint",
              "filters",
              "sortable"
            ],
            "additionalProperties": false
          },
          "podcasts": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer",
                "minimum": 0
              },
              "endpoint": {
                "const": "/api/podcasts.json"
              },
              "filters": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "show",
                    "q"
                  ]
                }
              },
              "sortable": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "addedAt",
                    "releaseDate"
                  ]
                }
              }
            },
            "required": [
              "count",
              "endpoint",
              "filters",
              "sortable"
            ],
            "additionalProperties": false
          },
          "tweets": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer",
                "minimum": 0
              },
              "endpoint": {
                "const": "/api/tweets.json"
              },
              "filters": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "author",
                    "q"
                  ]
                }
              },
              "sortable": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "createdAt",
                    "addedAt"
                  ]
                }
              }
            },
            "required": [
              "count",
              "endpoint",
              "filters",
              "sortable"
            ],
            "additionalProperties": false
          },
          "code": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer",
                "minimum": 0
              },
              "endpoint": {
                "const": "/api/code.json"
              },
              "filters": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "kind",
                    "repo",
                    "year",
                    "q"
                  ]
                }
              },
              "sortable": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "occurredAt",
                    "addedAt",
                    "score",
                    "title"
                  ]
                }
              }
            },
            "required": [
              "count",
              "endpoint",
              "filters",
              "sortable"
            ],
            "additionalProperties": false
          },
          "photos": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer",
                "minimum": 0
              },
              "endpoint": {
                "const": "/api/photos.json"
              },
              "filters": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "year",
                    "month"
                  ]
                }
              },
              "sortable": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "date"
                  ]
                }
              }
            },
            "required": [
              "count",
              "endpoint",
              "filters",
              "sortable"
            ],
            "additionalProperties": false
          },
          "books": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer",
                "minimum": 0
              },
              "endpoint": {
                "const": "/api/books.json"
              },
              "filters": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "author",
                    "q"
                  ]
                }
              },
              "sortable": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "dateRead",
                    "purchasedAt",
                    "addedAt",
                    "year",
                    "rating",
                    "title",
                    "author"
                  ]
                }
              }
            },
            "required": [
              "count",
              "endpoint",
              "filters",
              "sortable"
            ],
            "additionalProperties": false
          },
          "work": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer",
                "minimum": 0
              },
              "endpoint": {
                "const": "/api/work.json"
              },
              "filters": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "year",
                    "kind",
                    "company"
                  ]
                }
              },
              "sortable": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "date",
                    "title",
                    "company",
                    "id"
                  ]
                }
              }
            },
            "required": [
              "count",
              "endpoint",
              "filters",
              "sortable"
            ],
            "additionalProperties": false
          },
          "reading": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer",
                "minimum": 0
              },
              "endpoint": {
                "const": "/api/reading.json"
              },
              "filters": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "q",
                    "domain"
                  ]
                }
              },
              "sortable": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "publishedAt",
                    "addedAt",
                    "title",
                    "domain"
                  ]
                }
              }
            },
            "required": [
              "count",
              "endpoint",
              "filters",
              "sortable"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "activities",
          "movies",
          "places",
          "events",
          "sports",
          "music",
          "concerts",
          "videos",
          "podcasts",
          "tweets",
          "code",
          "photos",
          "books",
          "work",
          "reading"
        ],
        "additionalProperties": false
      },
      "ServiceMeta": {
        "type": "object",
        "properties": {
          "name": {
            "const": "Brendan Irvine-Broque Personal API"
          },
          "version": {
            "const": "1.0.0"
          },
          "lastUpdated": {
            "type": "string",
            "format": "date-time",
            "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\\d|0[1-9]|3[01])[T ](?:0\\d|1\\d|2[0-3])(?::[0-5]\\d){2}(?:\\.\\d{1,9})?(?:Z| ?[+-](?:0\\d|1\\d|2[0-3])(?::?[0-5]\\d)?)$"
          },
          "documentation": {
            "const": "/api/"
          },
          "openapi": {
            "const": "/api/openapi.json"
          },
          "sql": {
            "type": "object",
            "properties": {
              "endpoint": {
                "const": "/api/sql"
              },
              "profile": {
                "const": "/api/sql-profile.json"
              },
              "version": {
                "const": "1.1.0"
              },
              "methods": {
                "type": "array",
                "prefixItems": [
                  {
                    "const": "QUERY"
                  },
                  {
                    "const": "HEAD"
                  },
                  {
                    "const": "OPTIONS"
                  }
                ],
                "items": false,
                "minItems": 3,
                "maxItems": 3
              },
              "requestMediaType": {
                "const": "application/sql"
              },
              "responseMediaTypes": {
                "type": "array",
                "prefixItems": [
                  {
                    "const": "application/json"
                  },
                  {
                    "const": "text/csv"
                  }
                ],
                "items": false,
                "minItems": 2,
                "maxItems": 2
              },
              "limits": {
                "type": "object",
                "properties": {
                  "maxRequestBytes": {
                    "const": 16384
                  },
                  "maxTokens": {
                    "const": 256
                  },
                  "maxAstDepth": {
                    "const": 16
                  },
                  "maxProjectionColumns": {
                    "const": 24
                  },
                  "maxPredicates": {
                    "const": 24
                  },
                  "maxInItems": {
                    "const": 32
                  },
                  "maxPatternLength": {
                    "const": 256
                  },
                  "maxRows": {
                    "const": 100
                  },
                  "maxColumns": {
                    "const": 24
                  },
                  "maxGroupColumns": {
                    "const": 2
                  },
                  "maxCost": {
                    "const": 500
                  },
                  "maxResponseBytes": {
                    "const": 524288
                  },
                  "requestsPerMinute": {
                    "const": 120
                  },
                  "rateLimitWindowSeconds": {
                    "const": 60
                  }
                },
                "required": [
                  "maxRequestBytes",
                  "maxTokens",
                  "maxAstDepth",
                  "maxProjectionColumns",
                  "maxPredicates",
                  "maxInItems",
                  "maxPatternLength",
                  "maxRows",
                  "maxColumns",
                  "maxGroupColumns",
                  "maxCost",
                  "maxResponseBytes",
                  "requestsPerMinute",
                  "rateLimitWindowSeconds"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "endpoint",
              "profile",
              "version",
              "methods",
              "requestMediaType",
              "responseMediaTypes",
              "limits"
            ],
            "additionalProperties": false
          },
          "graphql": {
            "type": "object",
            "properties": {
              "endpoint": {
                "const": "/graphql"
              },
              "schema": {
                "const": "/graphql/schema.graphql"
              },
              "version": {
                "const": "1.0.0"
              },
              "methods": {
                "type": "array",
                "prefixItems": [
                  {
                    "const": "GET"
                  },
                  {
                    "const": "POST"
                  }
                ],
                "items": false,
                "minItems": 2,
                "maxItems": 2
              },
              "limits": {
                "type": "object",
                "properties": {
                  "requestBytes": {
                    "const": 65536
                  },
                  "urlBytes": {
                    "const": 16384
                  },
                  "operationDefinitions": {
                    "const": 5
                  },
                  "rootFields": {
                    "const": 20
                  },
                  "depth": {
                    "const": 12
                  },
                  "aliases": {
                    "const": 50
                  },
                  "fragmentSpreads": {
                    "const": 100
                  },
                  "selections": {
                    "const": 500
                  },
                  "pageSize": {
                    "const": 100
                  },
                  "aggregateNodes": {
                    "const": 500
                  },
                  "cost": {
                    "const": 20000
                  },
                  "responseBytes": {
                    "const": 2097152
                  },
                  "timeoutMs": {
                    "const": 15000
                  }
                },
                "required": [
                  "requestBytes",
                  "urlBytes",
                  "operationDefinitions",
                  "rootFields",
                  "depth",
                  "aliases",
                  "fragmentSpreads",
                  "selections",
                  "pageSize",
                  "aggregateNodes",
                  "cost",
                  "responseBytes",
                  "timeoutMs"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "endpoint",
              "schema",
              "version",
              "methods",
              "limits"
            ],
            "additionalProperties": false
          },
          "skillsIndex": {
            "const": "/.well-known/skills/index.json"
          },
          "apiCatalog": {
            "const": "/.well-known/api-catalog"
          },
          "agenticResourceCatalog": {
            "const": "/.well-known/ai-catalog.json"
          },
          "tasteProfile": {
            "type": "object",
            "properties": {
              "endpoint": {
                "const": "/.well-known/taste-profile.json"
              },
              "mediaType": {
                "const": "application/taste-profile+json; version=1"
              },
              "discoveryRelation": {
                "const": "taste-profile"
              }
            },
            "required": [
              "endpoint",
              "mediaType",
              "discoveryRelation"
            ],
            "additionalProperties": false
          },
          "musicIntersection": {
            "type": "object",
            "properties": {
              "endpoint": {
                "const": "/api/music/intersections.json"
              },
              "method": {
                "const": "POST"
              },
              "readOnly": {
                "const": true
              }
            },
            "required": [
              "endpoint",
              "method",
              "readOnly"
            ],
            "additionalProperties": false
          },
          "musicStation": {
            "type": "object",
            "properties": {
              "endpoint": {
                "const": "/api/music/station.json"
              },
              "method": {
                "const": "POST"
              },
              "readOnly": {
                "const": true
              },
              "stateful": {
                "const": false
              }
            },
            "required": [
              "endpoint",
              "method",
              "readOnly",
              "stateful"
            ],
            "additionalProperties": false
          },
          "capnweb": {
            "type": "object",
            "properties": {
              "endpoint": {
                "const": "/api/rpc"
              },
              "transport": {
                "const": "object-capability-rpc"
              },
              "transports": {
                "type": "array",
                "prefixItems": [
                  {
                    "const": "http-batch"
                  },
                  {
                    "const": "websocket"
                  }
                ],
                "items": false,
                "minItems": 2,
                "maxItems": 2
              },
              "packageVersion": {
                "const": "0.12.0"
              },
              "declaration": {
                "const": "/api/capnweb.d.ts"
              },
              "metadata": {
                "const": "/api/capnweb.json"
              },
              "stability": {
                "const": "stable"
              },
              "methods": {
                "minItems": 5,
                "maxItems": 5,
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "service",
                    "content",
                    "discovery",
                    "taste",
                    "feed"
                  ]
                }
              },
              "sessionLimits": {
                "type": "object",
                "properties": {
                  "httpBatch": {
                    "type": "object",
                    "properties": {
                      "maxCalls": {
                        "type": "number"
                      },
                      "maxWeightedWork": {
                        "type": "number"
                      },
                      "maxCapabilities": {
                        "type": "number"
                      },
                      "maxReturnedIds": {
                        "type": "number"
                      },
                      "maxExportRecords": {
                        "type": "number"
                      },
                      "maxResponseBytes": {
                        "type": "number"
                      },
                      "maxRequestBytes": {
                        "type": "number"
                      },
                      "maxIdleMs": {
                        "type": "null"
                      },
                      "maxAgeMs": {
                        "type": "null"
                      },
                      "maxStreams": {
                        "type": "number"
                      },
                      "maxStreamChunks": {
                        "type": "number"
                      },
                      "maxStreamBytes": {
                        "type": "number"
                      },
                      "maxStreamDurationMs": {
                        "type": "number"
                      }
                    },
                    "required": [
                      "maxCalls",
                      "maxWeightedWork",
                      "maxCapabilities",
                      "maxReturnedIds",
                      "maxExportRecords",
                      "maxResponseBytes",
                      "maxRequestBytes",
                      "maxIdleMs",
                      "maxAgeMs",
                      "maxStreams",
                      "maxStreamChunks",
                      "maxStreamBytes",
                      "maxStreamDurationMs"
                    ],
                    "additionalProperties": false
                  },
                  "websocket": {
                    "type": "object",
                    "properties": {
                      "maxCalls": {
                        "type": "number"
                      },
                      "maxWeightedWork": {
                        "type": "number"
                      },
                      "maxCapabilities": {
                        "type": "number"
                      },
                      "maxReturnedIds": {
                        "type": "number"
                      },
                      "maxExportRecords": {
                        "type": "number"
                      },
                      "maxResponseBytes": {
                        "type": "number"
                      },
                      "maxRequestBytes": {
                        "type": "number"
                      },
                      "maxIdleMs": {
                        "type": "number"
                      },
                      "maxAgeMs": {
                        "type": "number"
                      },
                      "maxStreams": {
                        "type": "number"
                      },
                      "maxStreamChunks": {
                        "type": "number"
                      },
                      "maxStreamBytes": {
                        "type": "number"
                      },
                      "maxStreamDurationMs": {
                        "type": "number"
                      }
                    },
                    "required": [
                      "maxCalls",
                      "maxWeightedWork",
                      "maxCapabilities",
                      "maxReturnedIds",
                      "maxExportRecords",
                      "maxResponseBytes",
                      "maxRequestBytes",
                      "maxIdleMs",
                      "maxAgeMs",
                      "maxStreams",
                      "maxStreamChunks",
                      "maxStreamBytes",
                      "maxStreamDurationMs"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "httpBatch",
                  "websocket"
                ],
                "additionalProperties": false
              },
              "limits": {
                "type": "object",
                "properties": {
                  "maxRequestBytes": {
                    "const": 65536
                  },
                  "maxBatchOperations": {
                    "const": 32
                  },
                  "sessionAdmissionsPerMinute": {
                    "const": 100
                  },
                  "sessionAdmissionWindowSeconds": {
                    "const": 60
                  },
                  "operationsPerMinute": {
                    "const": 100,
                    "description": "Deprecated since 2026-09-03: compatibility alias for sessionAdmissionsPerMinute; it describes session admissions, not RPC operations. Earliest removal is 2026-12-02.",
                    "deprecated": true
                  },
                  "rateLimitWindowSeconds": {
                    "const": 60,
                    "description": "Deprecated since 2026-09-03: use sessionAdmissionWindowSeconds. Earliest removal is 2026-12-02.",
                    "deprecated": true
                  }
                },
                "required": [
                  "maxRequestBytes",
                  "maxBatchOperations",
                  "sessionAdmissionsPerMinute",
                  "sessionAdmissionWindowSeconds",
                  "operationsPerMinute",
                  "rateLimitWindowSeconds"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "endpoint",
              "transport",
              "transports",
              "packageVersion",
              "declaration",
              "metadata",
              "stability",
              "methods",
              "sessionLimits",
              "limits"
            ],
            "additionalProperties": false
          },
          "mcp": {
            "type": "object",
            "properties": {
              "endpoint": {
                "const": "/mcp"
              },
              "serverCard": {
                "const": "/.well-known/mcp/server-card.json"
              },
              "discovery": {
                "const": "/.well-known/mcp.json"
              },
              "protocolVersion": {
                "const": "2025-11-25"
              }
            },
            "required": [
              "endpoint",
              "serverCard",
              "discovery",
              "protocolVersion"
            ],
            "additionalProperties": false
          },
          "collections": {
            "$ref": "#/components/schemas/CollectionsMetadata"
          }
        },
        "required": [
          "name",
          "version",
          "lastUpdated",
          "documentation",
          "openapi",
          "sql",
          "graphql",
          "skillsIndex",
          "apiCatalog",
          "agenticResourceCatalog",
          "tasteProfile",
          "musicIntersection",
          "musicStation",
          "capnweb",
          "mcp",
          "collections"
        ],
        "additionalProperties": false
      },
      "ServiceStatus": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "healthy",
              "degraded"
            ]
          },
          "timestamp": {
            "type": "string",
            "format": "date-time",
            "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\\d|0[1-9]|3[01])[T ](?:0\\d|1\\d|2[0-3])(?::[0-5]\\d){2}(?:\\.\\d{1,9})?(?:Z| ?[+-](?:0\\d|1\\d|2[0-3])(?::?[0-5]\\d)?)$"
          },
          "version": {
            "const": "1.0.0"
          },
          "checks": {
            "type": "object",
            "properties": {
              "collections": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "pass",
                      "fail"
                    ]
                  },
                  "componentType": {
                    "const": "datastore"
                  },
                  "observedValue": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "observedUnit": {
                    "const": "items"
                  }
                },
                "required": [
                  "status",
                  "componentType",
                  "observedValue",
                  "observedUnit"
                ],
                "additionalProperties": false
              },
              "searchProjection": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "pass",
                      "fail"
                    ]
                  },
                  "componentType": {
                    "const": "datastore"
                  },
                  "projectionVersion": {
                    "type": "integer",
                    "minimum": 1
                  },
                  "baselineProjectionVersion": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 1
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "targetProjectionVersion": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 1
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "state": {
                    "type": "string",
                    "enum": [
                      "ready",
                      "rebuilding",
                      "degraded"
                    ]
                  },
                  "activeProvider": {
                    "type": "string",
                    "enum": [
                      "d1-lexical-v1",
                      "canonical-d1-fallback"
                    ]
                  },
                  "dirtyCount": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "dueCount": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "leasedCount": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "quarantinedCount": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "maintenanceInstanceId": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "vocabularyGeneration": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "lastVerifiedAgeSeconds": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "status",
                  "componentType",
                  "projectionVersion",
                  "baselineProjectionVersion",
                  "targetProjectionVersion",
                  "state",
                  "activeProvider",
                  "dirtyCount",
                  "dueCount",
                  "leasedCount",
                  "quarantinedCount",
                  "maintenanceInstanceId",
                  "vocabularyGeneration",
                  "lastVerifiedAgeSeconds"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "collections",
              "searchProjection"
            ],
            "additionalProperties": false
          },
          "metrics": {
            "type": "object",
            "properties": {
              "responseTimeMs": {
                "type": "integer",
                "minimum": 1
              }
            },
            "required": [
              "responseTimeMs"
            ],
            "additionalProperties": false
          },
          "links": {
            "type": "object",
            "properties": {
              "self": {
                "const": "/api/status.json"
              },
              "meta": {
                "const": "/api/meta.json"
              },
              "docs": {
                "const": "/api/"
              },
              "capnweb": {
                "const": "/api/rpc"
              },
              "mcp": {
                "const": "/mcp"
              },
              "graphql": {
                "const": "/graphql"
              },
              "sql": {
                "const": "/api/sql"
              }
            },
            "required": [
              "self",
              "meta",
              "docs",
              "capnweb",
              "mcp",
              "graphql",
              "sql"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "status",
          "timestamp",
          "version",
          "checks",
          "metrics",
          "links"
        ],
        "additionalProperties": false
      },
      "GeoJsonPointGeometry": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "Point"
            ]
          },
          "coordinates": {
            "type": "array",
            "items": {
              "type": "number"
            },
            "minItems": 2,
            "maxItems": 2
          }
        },
        "required": [
          "type",
          "coordinates"
        ]
      },
      "PlaceGeoJsonResponse": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "FeatureCollection"
            ]
          },
          "features": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "Feature"
                  ]
                },
                "id": {
                  "type": [
                    "string",
                    "number"
                  ]
                },
                "geometry": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/GeoJsonPointGeometry"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "properties": {
                  "$ref": "#/components/schemas/Place"
                }
              },
              "required": [
                "type",
                "geometry",
                "properties"
              ]
            }
          },
          "meta": {
            "$ref": "#/components/schemas/PaginationMeta"
          },
          "links": {
            "$ref": "#/components/schemas/PaginationLinks"
          }
        },
        "required": [
          "type",
          "features",
          "meta",
          "links"
        ]
      },
      "PhotoGeoJsonResponse": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "FeatureCollection"
            ]
          },
          "features": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "Feature"
                  ]
                },
                "id": {
                  "type": [
                    "string",
                    "number"
                  ]
                },
                "geometry": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/GeoJsonPointGeometry"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "properties": {
                  "$ref": "#/components/schemas/Photo"
                }
              },
              "required": [
                "type",
                "geometry",
                "properties"
              ]
            }
          },
          "meta": {
            "$ref": "#/components/schemas/PaginationMeta"
          },
          "links": {
            "$ref": "#/components/schemas/PaginationLinks"
          }
        },
        "required": [
          "type",
          "features",
          "meta",
          "links"
        ]
      },
      "MusicSearchProjection": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string"
          },
          "subtitle": {
            "type": "string"
          },
          "keywords": {
            "type": "string"
          },
          "body": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "sourceUrl": {
            "type": "string"
          }
        },
        "required": [
          "title",
          "subtitle",
          "keywords",
          "body",
          "path",
          "sourceUrl"
        ],
        "additionalProperties": false
      },
      "MusicSearchIndexEntry": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "canonicalId": {
            "type": "string"
          },
          "itemPath": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "type": {
            "type": "string",
            "enum": [
              "album",
              "playlist",
              "mix",
              "track"
            ]
          },
          "artist": {
            "type": [
              "string",
              "null"
            ]
          },
          "genres": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "releaseDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "addedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "notes": {
            "type": [
              "string",
              "null"
            ]
          },
          "search": {
            "$ref": "#/components/schemas/MusicSearchProjection"
          }
        },
        "required": [
          "id",
          "canonicalId",
          "itemPath",
          "title",
          "url",
          "type",
          "artist",
          "genres",
          "releaseDate",
          "addedAt",
          "notes",
          "search"
        ],
        "additionalProperties": false
      },
      "MusicSearchIndexResponse": {
        "type": "object",
        "properties": {
          "version": {
            "type": "string",
            "description": "Content-derived version that changes whenever the index data changes."
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MusicSearchIndexEntry"
            }
          }
        },
        "required": [
          "version",
          "data"
        ],
        "additionalProperties": false
      },
      "ListenerTasteProfileV1": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "const": "1"
          },
          "subject": {
            "type": "object",
            "properties": {
              "canonicalUrl": {
                "type": "string",
                "format": "uri"
              },
              "displayName": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160,
                "pattern": "^(?![\\s\\S]*(?:[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]|<\\/?[A-Za-z][^>]*>|```|(?:[Dd][Aa][Tt][Aa]|[Jj][Aa][Vv][Aa][Ss][Cc][Rr][Ii][Pp][Tt]|[Vv][Bb][Ss][Cc][Rr][Ii][Pp][Tt]):))[\\s\\S]+$"
              }
            },
            "additionalProperties": false
          },
          "music": {
            "type": "object",
            "properties": {
              "artists": {
                "maxItems": 50,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^(?![\\s\\S]*(?:[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]|<\\/?[A-Za-z][^>]*>|```|(?:[Dd][Aa][Tt][Aa]|[Jj][Aa][Vv][Aa][Ss][Cc][Rr][Ii][Pp][Tt]|[Vv][Bb][Ss][Cc][Rr][Ii][Pp][Tt]):))[\\s\\S]+$"
                    },
                    "stance": {
                      "type": "string",
                      "enum": [
                        "love",
                        "like",
                        "curious",
                        "avoid"
                      ]
                    },
                    "weight": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 100
                    },
                    "externalIds": {
                      "type": "object",
                      "properties": {
                        "spotify-artist": {
                          "type": "string",
                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "name",
                    "stance"
                  ],
                  "additionalProperties": false
                }
              },
              "recordings": {
                "maxItems": 100,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "title": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 240,
                      "pattern": "^(?![\\s\\S]*(?:[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]|<\\/?[A-Za-z][^>]*>|```|(?:[Dd][Aa][Tt][Aa]|[Jj][Aa][Vv][Aa][Ss][Cc][Rr][Ii][Pp][Tt]|[Vv][Bb][Ss][Cc][Rr][Ii][Pp][Tt]):))[\\s\\S]+$"
                    },
                    "artist": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 240,
                      "pattern": "^(?![\\s\\S]*(?:[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]|<\\/?[A-Za-z][^>]*>|```|(?:[Dd][Aa][Tt][Aa]|[Jj][Aa][Vv][Aa][Ss][Cc][Rr][Ii][Pp][Tt]|[Vv][Bb][Ss][Cc][Rr][Ii][Pp][Tt]):))[\\s\\S]+$"
                    },
                    "stance": {
                      "type": "string",
                      "enum": [
                        "love",
                        "like",
                        "curious",
                        "avoid"
                      ]
                    },
                    "weight": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 100
                    },
                    "externalIds": {
                      "type": "object",
                      "properties": {
                        "isrc": {
                          "type": "string",
                          "pattern": "^[A-Z]{2}[A-Z0-9]{3}\\d{7}$"
                        },
                        "spotify-track": {
                          "type": "string",
                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "title",
                    "artist",
                    "stance"
                  ],
                  "additionalProperties": false
                }
              },
              "albums": {
                "maxItems": 40,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "title": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 240,
                      "pattern": "^(?![\\s\\S]*(?:[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]|<\\/?[A-Za-z][^>]*>|```|(?:[Dd][Aa][Tt][Aa]|[Jj][Aa][Vv][Aa][Ss][Cc][Rr][Ii][Pp][Tt]|[Vv][Bb][Ss][Cc][Rr][Ii][Pp][Tt]):))[\\s\\S]+$"
                    },
                    "artist": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 240,
                      "pattern": "^(?![\\s\\S]*(?:[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]|<\\/?[A-Za-z][^>]*>|```|(?:[Dd][Aa][Tt][Aa]|[Jj][Aa][Vv][Aa][Ss][Cc][Rr][Ii][Pp][Tt]|[Vv][Bb][Ss][Cc][Rr][Ii][Pp][Tt]):))[\\s\\S]+$"
                    },
                    "stance": {
                      "type": "string",
                      "enum": [
                        "love",
                        "like",
                        "curious",
                        "avoid"
                      ]
                    },
                    "weight": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 100
                    },
                    "externalIds": {
                      "type": "object",
                      "properties": {
                        "discogs-master": {
                          "type": "string",
                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
                        },
                        "discogs-release": {
                          "type": "string",
                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "title",
                    "artist",
                    "stance"
                  ],
                  "additionalProperties": false
                }
              },
              "genres": {
                "maxItems": 30,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100,
                      "pattern": "^(?![\\s\\S]*(?:[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]|<\\/?[A-Za-z][^>]*>|```|(?:[Dd][Aa][Tt][Aa]|[Jj][Aa][Vv][Aa][Ss][Cc][Rr][Ii][Pp][Tt]|[Vv][Bb][Ss][Cc][Rr][Ii][Pp][Tt]):))[\\s\\S]+$"
                    },
                    "stance": {
                      "type": "string",
                      "enum": [
                        "love",
                        "like",
                        "curious",
                        "avoid"
                      ]
                    },
                    "weight": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 100
                    }
                  },
                  "required": [
                    "name",
                    "stance"
                  ],
                  "additionalProperties": false
                }
              },
              "notes": {
                "maxItems": 12,
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 240,
                  "pattern": "^(?![\\s\\S]*(?:[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]|<\\/?[A-Za-z][^>]*>|```|(?:[Dd][Aa][Tt][Aa]|[Jj][Aa][Vv][Aa][Ss][Cc][Rr][Ii][Pp][Tt]|[Vv][Bb][Ss][Cc][Rr][Ii][Pp][Tt]):))[\\s\\S]+$"
                }
              }
            },
            "required": [
              "artists",
              "recordings",
              "albums",
              "genres",
              "notes"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "schemaVersion",
          "music"
        ],
        "additionalProperties": false
      },
      "TasteProfileDocumentV1": {
        "type": "object",
        "properties": {
          "profile": {
            "type": "object",
            "properties": {
              "schemaVersion": {
                "const": "1"
              },
              "subject": {
                "type": "object",
                "properties": {
                  "canonicalUrl": {
                    "type": "string",
                    "format": "uri"
                  },
                  "displayName": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 160,
                    "pattern": "^(?![\\s\\S]*(?:[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]|<\\/?[A-Za-z][^>]*>|```|(?:[Dd][Aa][Tt][Aa]|[Jj][Aa][Vv][Aa][Ss][Cc][Rr][Ii][Pp][Tt]|[Vv][Bb][Ss][Cc][Rr][Ii][Pp][Tt]):))[\\s\\S]+$"
                  }
                },
                "additionalProperties": false
              },
              "music": {
                "type": "object",
                "properties": {
                  "artists": {
                    "maxItems": 50,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200,
                          "pattern": "^(?![\\s\\S]*(?:[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]|<\\/?[A-Za-z][^>]*>|```|(?:[Dd][Aa][Tt][Aa]|[Jj][Aa][Vv][Aa][Ss][Cc][Rr][Ii][Pp][Tt]|[Vv][Bb][Ss][Cc][Rr][Ii][Pp][Tt]):))[\\s\\S]+$"
                        },
                        "stance": {
                          "type": "string",
                          "enum": [
                            "love",
                            "like",
                            "curious",
                            "avoid"
                          ]
                        },
                        "weight": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 100
                        },
                        "externalIds": {
                          "type": "object",
                          "properties": {
                            "spotify-artist": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
                            }
                          },
                          "additionalProperties": false
                        }
                      },
                      "required": [
                        "name",
                        "stance"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "recordings": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "title": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 240,
                          "pattern": "^(?![\\s\\S]*(?:[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]|<\\/?[A-Za-z][^>]*>|```|(?:[Dd][Aa][Tt][Aa]|[Jj][Aa][Vv][Aa][Ss][Cc][Rr][Ii][Pp][Tt]|[Vv][Bb][Ss][Cc][Rr][Ii][Pp][Tt]):))[\\s\\S]+$"
                        },
                        "artist": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 240,
                          "pattern": "^(?![\\s\\S]*(?:[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]|<\\/?[A-Za-z][^>]*>|```|(?:[Dd][Aa][Tt][Aa]|[Jj][Aa][Vv][Aa][Ss][Cc][Rr][Ii][Pp][Tt]|[Vv][Bb][Ss][Cc][Rr][Ii][Pp][Tt]):))[\\s\\S]+$"
                        },
                        "stance": {
                          "type": "string",
                          "enum": [
                            "love",
                            "like",
                            "curious",
                            "avoid"
                          ]
                        },
                        "weight": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 100
                        },
                        "externalIds": {
                          "type": "object",
                          "properties": {
                            "isrc": {
                              "type": "string",
                              "pattern": "^[A-Z]{2}[A-Z0-9]{3}\\d{7}$"
                            },
                            "spotify-track": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
                            }
                          },
                          "additionalProperties": false
                        }
                      },
                      "required": [
                        "title",
                        "artist",
                        "stance"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "albums": {
                    "maxItems": 40,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "title": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 240,
                          "pattern": "^(?![\\s\\S]*(?:[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]|<\\/?[A-Za-z][^>]*>|```|(?:[Dd][Aa][Tt][Aa]|[Jj][Aa][Vv][Aa][Ss][Cc][Rr][Ii][Pp][Tt]|[Vv][Bb][Ss][Cc][Rr][Ii][Pp][Tt]):))[\\s\\S]+$"
                        },
                        "artist": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 240,
                          "pattern": "^(?![\\s\\S]*(?:[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]|<\\/?[A-Za-z][^>]*>|```|(?:[Dd][Aa][Tt][Aa]|[Jj][Aa][Vv][Aa][Ss][Cc][Rr][Ii][Pp][Tt]|[Vv][Bb][Ss][Cc][Rr][Ii][Pp][Tt]):))[\\s\\S]+$"
                        },
                        "stance": {
                          "type": "string",
                          "enum": [
                            "love",
                            "like",
                            "curious",
                            "avoid"
                          ]
                        },
                        "weight": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 100
                        },
                        "externalIds": {
                          "type": "object",
                          "properties": {
                            "discogs-master": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
                            },
                            "discogs-release": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
                            }
                          },
                          "additionalProperties": false
                        }
                      },
                      "required": [
                        "title",
                        "artist",
                        "stance"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "genres": {
                    "maxItems": 30,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100,
                          "pattern": "^(?![\\s\\S]*(?:[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]|<\\/?[A-Za-z][^>]*>|```|(?:[Dd][Aa][Tt][Aa]|[Jj][Aa][Vv][Aa][Ss][Cc][Rr][Ii][Pp][Tt]|[Vv][Bb][Ss][Cc][Rr][Ii][Pp][Tt]):))[\\s\\S]+$"
                        },
                        "stance": {
                          "type": "string",
                          "enum": [
                            "love",
                            "like",
                            "curious",
                            "avoid"
                          ]
                        },
                        "weight": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 100
                        }
                      },
                      "required": [
                        "name",
                        "stance"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "notes": {
                    "maxItems": 12,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 240,
                      "pattern": "^(?![\\s\\S]*(?:[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]|<\\/?[A-Za-z][^>]*>|```|(?:[Dd][Aa][Tt][Aa]|[Jj][Aa][Vv][Aa][Ss][Cc][Rr][Ii][Pp][Tt]|[Vv][Bb][Ss][Cc][Rr][Ii][Pp][Tt]):))[\\s\\S]+$"
                    }
                  }
                },
                "required": [
                  "artists",
                  "recordings",
                  "albums",
                  "genres",
                  "notes"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "schemaVersion",
              "music"
            ],
            "additionalProperties": false
          },
          "canonicalUrl": {
            "type": "string",
            "format": "uri"
          },
          "generatedAt": {
            "type": "string",
            "format": "date-time",
            "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\\d|0[1-9]|3[01])[T ](?:0\\d|1\\d|2[0-3])(?::[0-5]\\d){2}(?:\\.\\d{1,9})?(?:Z| ?[+-](?:0\\d|1\\d|2[0-3])(?::?[0-5]\\d)?)$"
          },
          "source": {
            "type": "object",
            "properties": {
              "type": {
                "const": "personal-website"
              },
              "musicCollection": {
                "type": "string",
                "format": "uri"
              },
              "mcpServerCard": {
                "type": "string",
                "format": "uri"
              }
            },
            "required": [
              "type"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "profile",
          "canonicalUrl",
          "generatedAt",
          "source"
        ],
        "additionalProperties": false
      },
      "MusicIntersectionRequestV1": {
        "type": "object",
        "properties": {
          "profile": {
            "type": "object",
            "properties": {
              "schemaVersion": {
                "const": "1"
              },
              "subject": {
                "type": "object",
                "properties": {
                  "canonicalUrl": {
                    "type": "string",
                    "maxLength": 2048,
                    "pattern": "^https:\\/\\/(?![^/]*@)[^#]+$"
                  },
                  "displayName": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 160,
                    "pattern": "^(?![\\s\\S]*(?:[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]|<\\/?[A-Za-z][^>]*>|```|(?:[Dd][Aa][Tt][Aa]|[Jj][Aa][Vv][Aa][Ss][Cc][Rr][Ii][Pp][Tt]|[Vv][Bb][Ss][Cc][Rr][Ii][Pp][Tt]):))[\\s\\S]+$"
                  }
                },
                "additionalProperties": false
              },
              "music": {
                "type": "object",
                "properties": {
                  "artists": {
                    "maxItems": 50,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200,
                          "pattern": "^(?![\\s\\S]*(?:[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]|<\\/?[A-Za-z][^>]*>|```|(?:[Dd][Aa][Tt][Aa]|[Jj][Aa][Vv][Aa][Ss][Cc][Rr][Ii][Pp][Tt]|[Vv][Bb][Ss][Cc][Rr][Ii][Pp][Tt]):))[\\s\\S]+$"
                        },
                        "stance": {
                          "default": "like",
                          "type": "string",
                          "enum": [
                            "love",
                            "like",
                            "curious",
                            "avoid"
                          ]
                        },
                        "weight": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 100
                        },
                        "externalIds": {
                          "type": "object",
                          "properties": {
                            "spotify-artist": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
                            }
                          },
                          "additionalProperties": false
                        }
                      },
                      "required": [
                        "name"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "recordings": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "title": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 240,
                          "pattern": "^(?![\\s\\S]*(?:[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]|<\\/?[A-Za-z][^>]*>|```|(?:[Dd][Aa][Tt][Aa]|[Jj][Aa][Vv][Aa][Ss][Cc][Rr][Ii][Pp][Tt]|[Vv][Bb][Ss][Cc][Rr][Ii][Pp][Tt]):))[\\s\\S]+$"
                        },
                        "artist": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 240,
                          "pattern": "^(?![\\s\\S]*(?:[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]|<\\/?[A-Za-z][^>]*>|```|(?:[Dd][Aa][Tt][Aa]|[Jj][Aa][Vv][Aa][Ss][Cc][Rr][Ii][Pp][Tt]|[Vv][Bb][Ss][Cc][Rr][Ii][Pp][Tt]):))[\\s\\S]+$"
                        },
                        "stance": {
                          "default": "like",
                          "type": "string",
                          "enum": [
                            "love",
                            "like",
                            "curious",
                            "avoid"
                          ]
                        },
                        "weight": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 100
                        },
                        "externalIds": {
                          "type": "object",
                          "properties": {
                            "isrc": {
                              "type": "string",
                              "pattern": "^[A-Z]{2}[A-Z0-9]{3}\\d{7}$"
                            },
                            "spotify-track": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
                            }
                          },
                          "additionalProperties": false
                        }
                      },
                      "required": [
                        "title",
                        "artist"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "albums": {
                    "maxItems": 40,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "title": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 240,
                          "pattern": "^(?![\\s\\S]*(?:[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]|<\\/?[A-Za-z][^>]*>|```|(?:[Dd][Aa][Tt][Aa]|[Jj][Aa][Vv][Aa][Ss][Cc][Rr][Ii][Pp][Tt]|[Vv][Bb][Ss][Cc][Rr][Ii][Pp][Tt]):))[\\s\\S]+$"
                        },
                        "artist": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 240,
                          "pattern": "^(?![\\s\\S]*(?:[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]|<\\/?[A-Za-z][^>]*>|```|(?:[Dd][Aa][Tt][Aa]|[Jj][Aa][Vv][Aa][Ss][Cc][Rr][Ii][Pp][Tt]|[Vv][Bb][Ss][Cc][Rr][Ii][Pp][Tt]):))[\\s\\S]+$"
                        },
                        "stance": {
                          "default": "like",
                          "type": "string",
                          "enum": [
                            "love",
                            "like",
                            "curious",
                            "avoid"
                          ]
                        },
                        "weight": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 100
                        },
                        "externalIds": {
                          "type": "object",
                          "properties": {
                            "discogs-master": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
                            },
                            "discogs-release": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
                            }
                          },
                          "additionalProperties": false
                        }
                      },
                      "required": [
                        "title",
                        "artist"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "genres": {
                    "maxItems": 30,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100,
                          "pattern": "^(?![\\s\\S]*(?:[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]|<\\/?[A-Za-z][^>]*>|```|(?:[Dd][Aa][Tt][Aa]|[Jj][Aa][Vv][Aa][Ss][Cc][Rr][Ii][Pp][Tt]|[Vv][Bb][Ss][Cc][Rr][Ii][Pp][Tt]):))[\\s\\S]+$"
                        },
                        "stance": {
                          "default": "like",
                          "type": "string",
                          "enum": [
                            "love",
                            "like",
                            "curious",
                            "avoid"
                          ]
                        },
                        "weight": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 100
                        }
                      },
                      "required": [
                        "name"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "notes": {
                    "maxItems": 12,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 240,
                      "pattern": "^(?![\\s\\S]*(?:[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]|<\\/?[A-Za-z][^>]*>|```|(?:[Dd][Aa][Tt][Aa]|[Jj][Aa][Vv][Aa][Ss][Cc][Rr][Ii][Pp][Tt]|[Vv][Bb][Ss][Cc][Rr][Ii][Pp][Tt]):))[\\s\\S]+$"
                    }
                  }
                },
                "required": [
                  "artists",
                  "recordings",
                  "albums",
                  "genres",
                  "notes"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "schemaVersion",
              "music"
            ],
            "additionalProperties": false
          },
          "limit": {
            "default": 40,
            "type": "integer",
            "minimum": 1,
            "maximum": 100
          }
        },
        "required": [
          "profile"
        ],
        "additionalProperties": false
      },
      "MusicIntersectionResultV1": {
        "type": "object",
        "properties": {
          "summary": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "matches": {
            "maxItems": 100,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "canonicalId": {
                  "type": "string",
                  "pattern": "^itm_[a-f0-9]{24}$"
                },
                "score": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 100
                },
                "reasons": {
                  "minItems": 1,
                  "maxItems": 12,
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "code": {
                        "type": "string",
                        "enum": [
                          "recording-id",
                          "recording-name",
                          "artist-id",
                          "artist-name",
                          "album-id",
                          "album-name",
                          "genre",
                          "semantic",
                          "avoid"
                        ]
                      },
                      "label": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 240
                      },
                      "strength": {
                        "type": "integer",
                        "minimum": -100,
                        "maximum": 100
                      }
                    },
                    "required": [
                      "code",
                      "label",
                      "strength"
                    ],
                    "additionalProperties": false
                  }
                }
              },
              "required": [
                "canonicalId",
                "score",
                "reasons"
              ],
              "additionalProperties": false
            }
          },
          "unmatched": {
            "type": "object",
            "properties": {
              "artists": {
                "type": "integer",
                "minimum": 0
              },
              "recordings": {
                "type": "integer",
                "minimum": 0
              },
              "albums": {
                "type": "integer",
                "minimum": 0
              },
              "genres": {
                "type": "integer",
                "minimum": 0
              }
            },
            "required": [
              "artists",
              "recordings",
              "albums",
              "genres"
            ],
            "additionalProperties": false
          },
          "truncated": {
            "type": "boolean"
          }
        },
        "required": [
          "summary",
          "matches",
          "unmatched",
          "truncated"
        ],
        "additionalProperties": false
      },
      "MusicStationRequestV1": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "const": "1"
          },
          "stationSeed": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "pattern": "^[A-Za-z0-9_-]+$"
          },
          "affinities": {
            "maxItems": 100,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "canonicalId": {
                  "type": "string",
                  "pattern": "^itm_[a-f0-9]{24}$"
                },
                "weight": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 100
                },
                "reasonCodes": {
                  "minItems": 1,
                  "maxItems": 8,
                  "type": "array",
                  "items": {
                    "type": "string",
                    "enum": [
                      "recording-id",
                      "recording-name",
                      "artist-id",
                      "artist-name",
                      "album-id",
                      "album-name",
                      "genre",
                      "semantic",
                      "avoid"
                    ]
                  }
                }
              },
              "required": [
                "canonicalId",
                "weight",
                "reasonCodes"
              ],
              "additionalProperties": false
            }
          },
          "votes": {
            "maxItems": 30,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "canonicalId": {
                  "type": "string",
                  "pattern": "^itm_[a-f0-9]{24}$"
                },
                "direction": {
                  "type": "string",
                  "enum": [
                    "more",
                    "less"
                  ]
                },
                "evidence": {
                  "default": "explicit",
                  "type": "string",
                  "enum": [
                    "explicit",
                    "completion",
                    "early-skip"
                  ]
                },
                "weight": {
                  "default": 1,
                  "type": "number",
                  "minimum": 0.05,
                  "maximum": 1
                }
              },
              "required": [
                "canonicalId",
                "direction"
              ],
              "additionalProperties": false
            }
          },
          "hardExclusions": {
            "maxItems": 30,
            "type": "array",
            "items": {
              "type": "string",
              "pattern": "^itm_[a-f0-9]{24}$"
            }
          },
          "recentCanonicalIds": {
            "maxItems": 60,
            "type": "array",
            "items": {
              "type": "string",
              "pattern": "^itm_[a-f0-9]{24}$"
            }
          },
          "intent": {
            "type": "string",
            "minLength": 3,
            "maxLength": 160
          },
          "context": {
            "type": "object",
            "properties": {
              "timeOfDay": {
                "type": "string",
                "enum": [
                  "dawn",
                  "morning",
                  "afternoon",
                  "evening",
                  "night"
                ]
              },
              "weatherKind": {
                "type": "string",
                "enum": [
                  "clear",
                  "cloudy",
                  "fog",
                  "drizzle",
                  "rain",
                  "snow",
                  "storm",
                  "unknown"
                ]
              },
              "calendarKind": {
                "type": "string",
                "enum": [
                  "weekday",
                  "weekend",
                  "holiday"
                ]
              },
              "daylight": {
                "type": "string",
                "enum": [
                  "day",
                  "night",
                  "unknown"
                ]
              },
              "season": {
                "type": "string",
                "enum": [
                  "spring",
                  "summer",
                  "autumn",
                  "winter",
                  "unknown"
                ]
              }
            },
            "required": [
              "timeOfDay",
              "weatherKind",
              "calendarKind"
            ],
            "additionalProperties": false
          },
          "continuation": {
            "type": "object",
            "properties": {
              "version": {
                "const": "1"
              },
              "played": {
                "maxItems": 120,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "canonicalId": {
                      "type": "string",
                      "pattern": "^itm_[a-f0-9]{24}$"
                    },
                    "playedAt": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 8640000000000000
                    }
                  },
                  "required": [
                    "canonicalId",
                    "playedAt"
                  ],
                  "additionalProperties": false
                }
              },
              "queuedCanonicalIds": {
                "maxItems": 12,
                "type": "array",
                "items": {
                  "type": "string",
                  "pattern": "^itm_[a-f0-9]{24}$"
                }
              },
              "position": {
                "type": "integer",
                "minimum": 0,
                "maximum": 1000000
              }
            },
            "required": [
              "version",
              "played",
              "queuedCanonicalIds",
              "position"
            ],
            "additionalProperties": false
          },
          "limit": {
            "default": 6,
            "type": "integer",
            "minimum": 1,
            "maximum": 6
          }
        },
        "required": [
          "schemaVersion",
          "stationSeed",
          "affinities",
          "votes",
          "hardExclusions",
          "recentCanonicalIds"
        ],
        "additionalProperties": false
      },
      "MusicStationResultV1": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "const": "1"
          },
          "status": {
            "type": "string",
            "enum": [
              "ready",
              "empty",
              "degraded"
            ]
          },
          "profile": {
            "type": "object",
            "properties": {
              "seedCount": {
                "type": "integer",
                "minimum": 0
              },
              "positiveVoteCount": {
                "type": "integer",
                "minimum": 0
              },
              "negativeVoteCount": {
                "type": "integer",
                "minimum": 0
              },
              "intentApplied": {
                "type": "boolean"
              },
              "contextApplied": {
                "type": "boolean"
              }
            },
            "required": [
              "seedCount",
              "positiveVoteCount",
              "negativeVoteCount",
              "intentApplied",
              "contextApplied"
            ],
            "additionalProperties": false
          },
          "tracks": {
            "maxItems": 6,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "canonicalId": {
                  "type": "string",
                  "pattern": "^itm_[a-f0-9]{24}$"
                },
                "title": {
                  "type": "string",
                  "minLength": 1
                },
                "artist": {
                  "type": "string",
                  "minLength": 1
                },
                "genres": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "spotifyUri": {
                  "type": "string",
                  "pattern": "^spotify:track:[A-Za-z0-9]{10,64}$"
                },
                "spotifyUrl": {
                  "type": "string",
                  "format": "uri"
                },
                "itemPath": {
                  "type": "string",
                  "pattern": "^\\/"
                },
                "reasonCodes": {
                  "minItems": 1,
                  "maxItems": 8,
                  "type": "array",
                  "items": {
                    "type": "string",
                    "enum": [
                      "profile-affinity",
                      "session-more",
                      "intent-adjacent",
                      "context-adjacent",
                      "musical-neighbor",
                      "exploration",
                      "editorial-core",
                      "editorial-recurrent",
                      "underplayed",
                      "contrast",
                      "discovery",
                      "transition-fit"
                    ]
                  }
                },
                "programming": {
                  "type": "object",
                  "properties": {
                    "role": {
                      "type": "string",
                      "enum": [
                        "core-opener",
                        "adjacent",
                        "deep-cut",
                        "listener-affinity",
                        "contrast",
                        "discovery"
                      ]
                    },
                    "rotation": {
                      "type": "string",
                      "enum": [
                        "core",
                        "recurrent",
                        "deep-cut",
                        "discovery"
                      ]
                    }
                  },
                  "required": [
                    "role",
                    "rotation"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "canonicalId",
                "title",
                "artist",
                "genres",
                "spotifyUri",
                "spotifyUrl",
                "itemPath",
                "reasonCodes"
              ],
              "additionalProperties": false
            }
          },
          "diagnostics": {
            "type": "object",
            "properties": {
              "profileVersion": {
                "type": "string",
                "minLength": 1,
                "maxLength": 80
              },
              "candidateCount": {
                "type": "integer",
                "minimum": 0
              },
              "eligibleCount": {
                "type": "integer",
                "minimum": 0
              },
              "fallback": {
                "type": "boolean"
              },
              "cooldownRelaxed": {
                "type": "boolean"
              },
              "contextSignals": {
                "maxItems": 4,
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "time-of-day",
                    "weather",
                    "daylight",
                    "season"
                  ]
                }
              },
              "clock": {
                "type": "string",
                "minLength": 1,
                "maxLength": 80
              },
              "slots": {
                "maxItems": 6,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "position": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 6
                    },
                    "role": {
                      "type": "string",
                      "enum": [
                        "core-opener",
                        "adjacent",
                        "deep-cut",
                        "listener-affinity",
                        "contrast",
                        "discovery"
                      ]
                    },
                    "candidateCount": {
                      "type": "integer",
                      "minimum": 0
                    },
                    "shortlistSize": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 8
                    },
                    "selectedRank": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 8
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "relaxedRules": {
                      "maxItems": 3,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "artist-separation",
                          "sound-family-separation",
                          "album-separation"
                        ]
                      }
                    }
                  },
                  "required": [
                    "position",
                    "role",
                    "candidateCount",
                    "shortlistSize",
                    "selectedRank",
                    "relaxedRules"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "profileVersion",
              "candidateCount",
              "eligibleCount",
              "fallback"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "schemaVersion",
          "status",
          "profile",
          "tracks",
          "diagnostics"
        ],
        "additionalProperties": false
      },
      "TasteCollectionSummaryV1": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "const": 1
          },
          "outcome": {
            "type": "string",
            "enum": [
              "ok",
              "empty_collection"
            ]
          },
          "summary": {
            "type": "string"
          },
          "scope": {
            "type": "object",
            "properties": {
              "visibility": {
                "const": "public"
              },
              "corpusId": {
                "type": "string"
              },
              "label": {
                "type": "string"
              },
              "definition": {
                "type": "string"
              },
              "inclusionRules": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "exclusionMeaning": {
                "type": "string"
              },
              "canonicalUrl": {
                "type": "string",
                "format": "uri"
              }
            },
            "required": [
              "visibility",
              "corpusId",
              "label",
              "definition",
              "inclusionRules",
              "exclusionMeaning",
              "canonicalUrl"
            ],
            "additionalProperties": false
          },
          "counts": {
            "type": "object",
            "properties": {
              "returnedCount": {
                "type": "integer",
                "minimum": 0
              },
              "collectionCount": {
                "type": "integer",
                "minimum": 0
              }
            },
            "required": [
              "returnedCount",
              "collectionCount"
            ],
            "additionalProperties": false
          },
          "coverage": {
            "type": "object",
            "properties": {
              "dataAsOf": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\\d|0[1-9]|3[01])[T ](?:0\\d|1\\d|2[0-3])(?::[0-5]\\d){2}(?:\\.\\d{1,9})?(?:Z| ?[+-](?:0\\d|1\\d|2[0-3])(?::?[0-5]\\d)?)$"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "dimensions": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "dimension": {
                      "type": "string",
                      "enum": [
                        "type",
                        "genre",
                        "releaseDecade",
                        "director"
                      ]
                    },
                    "eligibleCount": {
                      "type": "integer",
                      "minimum": 0
                    },
                    "populatedCount": {
                      "type": "integer",
                      "minimum": 0
                    },
                    "missingCount": {
                      "type": "integer",
                      "minimum": 0
                    }
                  },
                  "required": [
                    "dimension",
                    "eligibleCount",
                    "populatedCount",
                    "missingCount"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "dataAsOf",
              "dimensions"
            ],
            "additionalProperties": false
          },
          "distributions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "dimension": {
                  "type": "string",
                  "enum": [
                    "type",
                    "genre",
                    "releaseDecade",
                    "director"
                  ]
                },
                "label": {
                  "type": "string"
                },
                "multiValue": {
                  "type": "boolean"
                },
                "denominator": {
                  "const": "eligible_records"
                },
                "denominatorCount": {
                  "type": "integer",
                  "minimum": 0
                },
                "values": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "value": {
                        "type": "string",
                        "minLength": 1
                      },
                      "label": {
                        "type": "string",
                        "minLength": 1
                      },
                      "count": {
                        "type": "integer",
                        "minimum": 0
                      },
                      "shareOfEligible": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                      }
                    },
                    "required": [
                      "value",
                      "label",
                      "count",
                      "shareOfEligible"
                    ],
                    "additionalProperties": false
                  }
                }
              },
              "required": [
                "dimension",
                "label",
                "multiValue",
                "denominator",
                "denominatorCount",
                "values"
              ],
              "additionalProperties": false
            }
          },
          "examples": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "canonicalId": {
                  "type": "string",
                  "pattern": "^itm_[a-f0-9]{24}$"
                },
                "collection": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "canonicalUrl": {
                  "type": "string",
                  "format": "uri"
                },
                "description": {
                  "type": "string"
                },
                "evidence": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "evidenceDetails": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "code": {
                        "type": "string",
                        "enum": [
                          "public-corpus-membership",
                          "exact-title-match",
                          "partial-title-match",
                          "genre-constraint-match",
                          "director-constraint-match",
                          "semantic-candidate-rehydrated",
                          "summary.genre-example",
                          "summary.director-example",
                          "summary.type-example",
                          "summary.decade-example"
                        ]
                      },
                      "text": {
                        "type": "string"
                      },
                      "fields": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      }
                    },
                    "required": [
                      "code",
                      "text",
                      "fields"
                    ],
                    "additionalProperties": false
                  }
                },
                "data": {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {}
                }
              },
              "required": [
                "canonicalId",
                "collection",
                "title",
                "canonicalUrl",
                "description",
                "evidence",
                "evidenceDetails",
                "data"
              ],
              "additionalProperties": false
            }
          },
          "selection": {
            "type": "object",
            "properties": {
              "task": {
                "const": "summarize"
              },
              "method": {
                "const": "deterministic-illustrative-v1"
              },
              "role": {
                "const": "illustrative"
              },
              "supportsPopulationClaims": {
                "const": false
              },
              "explanation": {
                "type": "string"
              }
            },
            "required": [
              "task",
              "method",
              "role",
              "supportsPopulationClaims",
              "explanation"
            ],
            "additionalProperties": false
          },
          "generatedAt": {
            "type": "string",
            "format": "date-time",
            "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\\d|0[1-9]|3[01])[T ](?:0\\d|1\\d|2[0-3])(?::[0-5]\\d){2}(?:\\.\\d{1,9})?(?:Z| ?[+-](?:0\\d|1\\d|2[0-3])(?::?[0-5]\\d)?)$"
          },
          "renderInput": {
            "type": "object",
            "properties": {
              "canonicalIds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "pattern": "^itm_[a-f0-9]{24}$"
                }
              }
            },
            "required": [
              "canonicalIds"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "schemaVersion",
          "outcome",
          "summary",
          "scope",
          "counts",
          "coverage",
          "distributions",
          "examples",
          "selection",
          "generatedAt",
          "renderInput"
        ],
        "additionalProperties": false
      },
      "ProblemDetails": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "format": "uri",
            "description": "Problem type URI (see /problems/)",
            "examples": [
              "https://irvinebroque.com/problems/api-not-found",
              "https://irvinebroque.com/problems/invalid-cursor",
              "https://irvinebroque.com/problems/invalid-limit",
              "https://irvinebroque.com/problems/invalid-offset",
              "https://irvinebroque.com/problems/invalid-sort",
              "https://irvinebroque.com/problems/invalid-filter-value",
              "https://irvinebroque.com/problems/invalid-request",
              "https://irvinebroque.com/problems/payload-too-large",
              "https://irvinebroque.com/problems/unsupported-media-type",
              "https://irvinebroque.com/problems/not-acceptable",
              "https://irvinebroque.com/problems/rate-limit-exceeded",
              "https://irvinebroque.com/problems/recommendation-session-invalid",
              "https://irvinebroque.com/problems/resource-conflict",
              "https://irvinebroque.com/problems/resource-not-ready",
              "https://irvinebroque.com/problems/service-unavailable",
              "https://irvinebroque.com/problems/upstream-service-failure",
              "https://irvinebroque.com/problems/unsupported-api-version",
              "https://irvinebroque.com/problems/sql-method-not-allowed",
              "https://irvinebroque.com/problems/sql-syntax-error",
              "https://irvinebroque.com/problems/sql-query-not-supported",
              "https://irvinebroque.com/problems/sql-result-invalid",
              "https://irvinebroque.com/problems/unsupported-sql-version"
            ]
          },
          "title": {
            "type": "string",
            "description": "Short human-readable summary"
          },
          "status": {
            "type": "integer",
            "description": "HTTP status code"
          },
          "detail": {
            "type": "string",
            "description": "Human-readable explanation"
          },
          "instance": {
            "type": "string",
            "format": "uri",
            "description": "URI reference for this occurrence"
          }
        },
        "required": [
          "type",
          "title",
          "status",
          "detail"
        ]
      },
      "PortablePlace": {
        "type": "object",
        "properties": {
          "canonicalId": {
            "type": "string",
            "pattern": "^itm_[a-f0-9]{24,32}$"
          },
          "name": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "address": {
            "type": [
              "string",
              "null"
            ]
          },
          "neighborhood": {
            "type": [
              "string",
              "null"
            ]
          },
          "city": {
            "type": [
              "string",
              "null"
            ]
          },
          "country": {
            "type": [
              "string",
              "null"
            ]
          },
          "latitude": {
            "type": "number",
            "minimum": -90,
            "maximum": 90
          },
          "longitude": {
            "type": "number",
            "minimum": -180,
            "maximum": 180
          },
          "website": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ]
          },
          "notes": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "googleMapsUrl": {
            "type": "string",
            "format": "uri"
          },
          "appleMapsUrl": {
            "type": "string",
            "format": "uri"
          },
          "geoUri": {
            "type": "string",
            "pattern": "^geo:-?\\d+(?:\\.\\d+)?,-?\\d+(?:\\.\\d+)?$"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\\d|0[1-9]|3[01])[T ](?:0\\d|1\\d|2[0-3])(?::[0-5]\\d){2}(?:\\.\\d{1,9})?(?:Z| ?[+-](?:0\\d|1\\d|2[0-3])(?::?[0-5]\\d)?)$"
          },
          "locationSource": {
            "type": "string",
            "enum": [
              "owner",
              "openstreetmap",
              "overture",
              "us_census",
              "wikidata"
            ]
          },
          "locationSourceId": {
            "type": [
              "string",
              "null"
            ]
          },
          "locationSourceUrl": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ]
          },
          "locationEvidenceUrl": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ]
          },
          "locationReviewedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\\d|0[1-9]|3[01])[T ](?:0\\d|1\\d|2[0-3])(?::[0-5]\\d){2}(?:\\.\\d{1,9})?(?:Z| ?[+-](?:0\\d|1\\d|2[0-3])(?::?[0-5]\\d)?)$"
              },
              {
                "type": "null"
              }
            ]
          },
          "attribution": {
            "type": "string"
          },
          "dataLicense": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "canonicalId",
          "name",
          "category",
          "categories",
          "address",
          "neighborhood",
          "city",
          "country",
          "latitude",
          "longitude",
          "website",
          "notes",
          "url",
          "googleMapsUrl",
          "appleMapsUrl",
          "geoUri",
          "updatedAt",
          "locationSource",
          "locationSourceId",
          "locationSourceUrl",
          "locationEvidenceUrl",
          "locationReviewedAt",
          "attribution",
          "dataLicense"
        ],
        "additionalProperties": false
      },
      "CompletePlacesGeoJson": {
        "type": "object",
        "properties": {
          "type": {
            "const": "FeatureCollection"
          },
          "bbox": {
            "type": "array",
            "prefixItems": [
              {
                "type": "number"
              },
              {
                "type": "number"
              },
              {
                "type": "number"
              },
              {
                "type": "number"
              }
            ],
            "items": false,
            "minItems": 4,
            "maxItems": 4
          },
          "attribution": {
            "type": "string"
          },
          "licenses": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uri"
            }
          },
          "features": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "const": "Feature"
                },
                "id": {
                  "type": "string",
                  "pattern": "^itm_[a-f0-9]{24,32}$"
                },
                "geometry": {
                  "type": "object",
                  "properties": {
                    "type": {
                      "const": "Point"
                    },
                    "coordinates": {
                      "type": "array",
                      "prefixItems": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "number"
                        }
                      ],
                      "items": false,
                      "minItems": 2,
                      "maxItems": 2
                    }
                  },
                  "required": [
                    "type",
                    "coordinates"
                  ],
                  "additionalProperties": false
                },
                "properties": {
                  "type": "object",
                  "properties": {
                    "canonicalId": {
                      "type": "string",
                      "pattern": "^itm_[a-f0-9]{24,32}$"
                    },
                    "name": {
                      "type": "string"
                    },
                    "category": {
                      "type": "string"
                    },
                    "categories": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "address": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "neighborhood": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "city": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "country": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "latitude": {
                      "type": "number",
                      "minimum": -90,
                      "maximum": 90
                    },
                    "longitude": {
                      "type": "number",
                      "minimum": -180,
                      "maximum": 180
                    },
                    "website": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uri"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "notes": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "googleMapsUrl": {
                      "type": "string",
                      "format": "uri"
                    },
                    "appleMapsUrl": {
                      "type": "string",
                      "format": "uri"
                    },
                    "geoUri": {
                      "type": "string",
                      "pattern": "^geo:-?\\d+(?:\\.\\d+)?,-?\\d+(?:\\.\\d+)?$"
                    },
                    "updatedAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\\d|0[1-9]|3[01])[T ](?:0\\d|1\\d|2[0-3])(?::[0-5]\\d){2}(?:\\.\\d{1,9})?(?:Z| ?[+-](?:0\\d|1\\d|2[0-3])(?::?[0-5]\\d)?)$"
                    },
                    "locationSource": {
                      "type": "string",
                      "enum": [
                        "owner",
                        "openstreetmap",
                        "overture",
                        "us_census",
                        "wikidata"
                      ]
                    },
                    "locationSourceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "locationSourceUrl": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uri"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "locationEvidenceUrl": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uri"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "locationReviewedAt": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\\d|0[1-9]|3[01])[T ](?:0\\d|1\\d|2[0-3])(?::[0-5]\\d){2}(?:\\.\\d{1,9})?(?:Z| ?[+-](?:0\\d|1\\d|2[0-3])(?::?[0-5]\\d)?)$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "attribution": {
                      "type": "string"
                    },
                    "dataLicense": {
                      "type": "string",
                      "format": "uri"
                    }
                  },
                  "required": [
                    "canonicalId",
                    "name",
                    "category",
                    "categories",
                    "address",
                    "neighborhood",
                    "city",
                    "country",
                    "latitude",
                    "longitude",
                    "website",
                    "notes",
                    "url",
                    "googleMapsUrl",
                    "appleMapsUrl",
                    "geoUri",
                    "updatedAt",
                    "locationSource",
                    "locationSourceId",
                    "locationSourceUrl",
                    "locationEvidenceUrl",
                    "locationReviewedAt",
                    "attribution",
                    "dataLicense"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "type",
                "id",
                "geometry",
                "properties"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "type",
          "attribution",
          "licenses",
          "features"
        ],
        "additionalProperties": false
      }
    },
    "parameters": {
      "limitParam": {
        "name": "limit",
        "in": "query",
        "description": "Maximum number of items to return",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "maximum": 100,
          "default": 50
        }
      },
      "cursorParam": {
        "name": "cursor",
        "in": "query",
        "description": "Pagination cursor",
        "schema": {
          "type": "string"
        }
      },
      "sortParam": {
        "name": "sort",
        "in": "query",
        "description": "Sort field and direction (e.g., \"year:desc\")",
        "schema": {
          "type": "string",
          "pattern": "^[\\w.-]+:(asc|desc)(,[\\w.-]+:(asc|desc))*$"
        }
      },
      "facetsParam": {
        "name": "facets",
        "in": "query",
        "description": "Include facet metadata in response meta (set to 1)",
        "schema": {
          "oneOf": [
            {
              "type": "integer",
              "enum": [
                1
              ]
            },
            {
              "type": "boolean"
            },
            {
              "type": "string"
            }
          ]
        }
      }
    },
    "headers": {
      "X-Total-Count": {
        "description": "Total number of items",
        "schema": {
          "type": "integer"
        }
      },
      "ETag": {
        "description": "Entity tag for conditional requests",
        "schema": {
          "type": "string"
        }
      },
      "Link": {
        "description": "RFC 8288 Web Linking header with pagination links",
        "schema": {
          "type": "string"
        }
      },
      "Link-Template": {
        "description": "RFC 9652 Link-Template header with query parameter templates",
        "schema": {
          "type": "string"
        }
      },
      "Cache-Control": {
        "description": "Caching directives",
        "schema": {
          "type": "string"
        }
      },
      "Deprecation": {
        "description": "RFC 9745 lifecycle deprecation signal",
        "schema": {
          "type": "string"
        }
      },
      "Sunset": {
        "description": "RFC 8594 lifecycle sunset date",
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      },
      "Content-Usage": {
        "description": "IETF AIPREF usage preferences for this public content",
        "schema": {
          "type": "string",
          "examples": [
            "train-ai=y, search=y"
          ]
        }
      },
      "Content-Signal": {
        "description": "Compatibility AI usage preferences for deployed crawlers",
        "schema": {
          "type": "string",
          "examples": [
            "ai-train=yes, search=yes, ai-input=yes"
          ]
        }
      }
    }
  }
}