{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/mantic/json-schema/mantic-catalog-question-detail-schema.json",
  "title": "CatalogQuestionDetail",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/mantic-catalog-api-openapi.yml#/components/schemas/CatalogQuestionDetail",
  "properties": {
    "id": {
      "type": "integer",
      "title": "Id"
    },
    "title": {
      "type": "string",
      "title": "Title"
    },
    "question": {
      "anyOf": [
        {
          "$ref": "#/$defs/core__question__models__Question"
        },
        {
          "type": "null"
        }
      ]
    },
    "unavailable": {
      "type": "boolean",
      "title": "Unavailable",
      "default": false
    }
  },
  "type": "object",
  "required": [
    "id",
    "title"
  ],
  "$defs": {
    "Annulled": {
      "properties": {
        "type": {
          "type": "string",
          "const": "annulled",
          "title": "Type",
          "default": "annulled"
        },
        "reason": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1,
              "description": "Why the question ended without a resolved value"
            },
            {
              "type": "null"
            }
          ],
          "title": "Reason"
        },
        "at": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time",
              "description": "Timezone-aware timestamp; any offset is accepted and normalized to UTC"
            },
            {
              "type": "null"
            }
          ],
          "title": "At"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "title": "Annulled",
      "description": "The question ended without a resolved value."
    },
    "BinaryOutcome": {
      "properties": {
        "resolution_kind": {
          "$ref": "#/$defs/ResolutionKind",
          "description": "Whether the question resolves to one observed value or to every observation over a window; with a distribution one forecast is scored against each of them",
          "default": "point"
        },
        "type": {
          "type": "string",
          "const": "binary",
          "title": "Type",
          "default": "binary"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "title": "BinaryOutcome",
      "description": "Yes/no outcome space."
    },
    "BinaryValue": {
      "properties": {
        "type": {
          "type": "string",
          "const": "binary",
          "title": "Type",
          "default": "binary"
        },
        "value": {
          "type": "boolean",
          "title": "Value"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "value"
      ],
      "title": "BinaryValue",
      "description": "Observed value of a resolved binary question."
    },
    "CategoricalOutcome": {
      "properties": {
        "resolution_kind": {
          "$ref": "#/$defs/ResolutionKind",
          "description": "Whether the question resolves to one observed value or to every observation over a window; with a distribution one forecast is scored against each of them",
          "default": "point"
        },
        "type": {
          "type": "string",
          "const": "categorical",
          "title": "Type",
          "default": "categorical"
        },
        "options": {
          "items": {
            "type": "string",
            "minLength": 1,
            "description": "Exact name of one categorical outcome"
          },
          "type": "array",
          "title": "Options",
          "description": "Mutually exclusive, collectively exhaustive named outcomes with names unique ignoring case; include Other when the named options are not exhaustive"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "options"
      ],
      "title": "CategoricalOutcome",
      "description": "One-of-several named options outcome space."
    },
    "CategoricalValue": {
      "properties": {
        "type": {
          "type": "string",
          "const": "categorical",
          "title": "Type",
          "default": "categorical"
        },
        "value": {
          "type": "string",
          "title": "Value"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "value"
      ],
      "title": "CategoricalValue",
      "description": "Observed value of a resolved categorical question."
    },
    "Competition": {
      "type": "string",
      "enum": [
        "forecastbench_2026",
        "metaculus_aibq1",
        "metaculus_aibq2",
        "metaculus_aibq3",
        "metaculus_aibq4",
        "metaculus_aib_fall_2025",
        "metaculus_aib_spring_2026",
        "metaculus_cup_summer_2025",
        "metaculus_cup_fall_2025",
        "metaculus_cup_spring_2026",
        "metaculus_market_pulse_25q3",
        "metaculus_market_pulse_25q4",
        "metaculus_market_pulse_26q1",
        "metaculus_aib_summer_2026",
        "metaculus_aib_fall_2026",
        "metaculus_cup_summer_2026",
        "metaculus_cup_fall_2026",
        "metaculus_market_pulse_26q3",
        "metaculus_market_pulse_26q4",
        "metaculus_acx_2026",
        "metaculus_democracy_threat_index",
        "metaculus_minibench",
        "good_judgment_open_2026",
        "mantic_open",
        "crucible_series_1",
        "crucible_preseason_2",
        "crucible_series_2"
      ],
      "title": "Competition",
      "description": "Competition a question appeared in."
    },
    "DateInterval": {
      "properties": {
        "lower_bound": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time",
              "description": "Timezone-aware timestamp; any offset is accepted and normalized to UTC"
            },
            {
              "type": "null"
            }
          ],
          "title": "Lower Bound",
          "description": "Finite lower bound, or null when unbounded below"
        },
        "lower_inclusive": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Lower Inclusive",
          "description": "Whether lower-bound equality belongs to this interval; set exactly when lower_bound is finite"
        },
        "upper_bound": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time",
              "description": "Timezone-aware timestamp; any offset is accepted and normalized to UTC"
            },
            {
              "type": "null"
            }
          ],
          "title": "Upper Bound",
          "description": "Finite upper bound, or null when unbounded above"
        },
        "upper_inclusive": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Upper Inclusive",
          "description": "Whether upper-bound equality belongs to this interval; set exactly when upper_bound is finite"
        },
        "outcome": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "string",
              "minLength": 1,
              "description": "Exact name of one categorical outcome"
            }
          ],
          "title": "Outcome"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "outcome"
      ],
      "title": "DateInterval",
      "description": "Flat date or timestamp interval producing one binary or categorical outcome."
    },
    "DateIntervalProjection": {
      "properties": {
        "type": {
          "type": "string",
          "const": "date_interval",
          "title": "Type",
          "default": "date_interval"
        },
        "intervals": {
          "items": {
            "$ref": "#/$defs/DateInterval"
          },
          "type": "array",
          "minItems": 2,
          "title": "Intervals",
          "description": "Ascending intervals forming a total partition of the scalar domain: the first is unbounded below, the last is unbounded above, adjacent bounds match, and exactly one adjacent interval includes their shared bound. Outcomes are all booleans for a binary question or all exact option strings for a categorical question."
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "intervals"
      ],
      "title": "DateIntervalProjection",
      "description": "A date answer resolves through an exhaustive partition of event time."
    },
    "DateOutcome": {
      "properties": {
        "resolution_kind": {
          "$ref": "#/$defs/ResolutionKind",
          "description": "Whether the question resolves to one observed value or to every observation over a window; with a distribution one forecast is scored against each of them",
          "default": "point"
        },
        "type": {
          "type": "string",
          "const": "date",
          "title": "Type",
          "default": "date"
        },
        "range_min": {
          "type": "string",
          "format": "date-time",
          "title": "Range Min",
          "description": "UTC-grid start of the earliest admissible scoring period, inclusive. It normally starts the calendar period containing as_of; it may start at a later exactly aligned boundary when the event definition provides future eligibility"
        },
        "range_max": {
          "type": "string",
          "format": "date-time",
          "title": "Range Max",
          "description": "Exclusive end of the authored forecast horizon, aligned to the declared date precision. When date_open_upper_bound is true, later dates may resolve and are represented as one aggregated upper tail"
        },
        "precision": {
          "$ref": "#/$defs/DatePrecision",
          "description": "UTC calendar granularity of the authored date scoring grid; range_max is aligned to the first instant after its final scored period"
        },
        "open_upper_bound": {
          "type": "boolean",
          "title": "Open Upper Bound",
          "description": "Whether dates at or after the exclusive date_range_max may resolve and are represented as one aggregated upper tail",
          "default": true
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "range_min",
        "range_max"
      ],
      "title": "DateOutcome",
      "description": "Date or timestamp outcome space.\n\nThere is no open lower bound: a date question asks when an event *will* occur, so the past\nnever counts. ``range_min`` labels the earliest admissible UTC scoring period: normally the\nperiod containing ``as_of``, or a later aligned period when the event definition supplies a\nreal future eligibility boundary.\n\n``open_upper_bound`` decides what \"not by ``range_max``\" means. Open, the space ends in one\naggregated tail pooling \"after the horizon\" with \"never\"; that bucket's truth is fully\ndetermined once ``range_max`` passes without the event, so the question resolves at the\nhorizon without waiting for the event. Closed, the range asserts the event occurs within\nit, and a premise failure annuls the question instead of resolving it."
    },
    "DatePrecision": {
      "type": "string",
      "enum": [
        "day",
        "week",
        "month"
      ],
      "title": "DatePrecision",
      "description": "Calendar granularity of an authored date scoring grid.\nValues:\n- day: Score in UTC calendar days.\n- week: Score in ISO weeks, beginning Monday in UTC.\n- month: Score in UTC calendar months."
    },
    "DateValue": {
      "properties": {
        "type": {
          "type": "string",
          "const": "date",
          "title": "Type",
          "default": "date"
        },
        "value": {
          "type": "string",
          "format": "date-time",
          "title": "Value",
          "description": "Timezone-aware timestamp; any offset is accepted and normalized to UTC"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "value"
      ],
      "title": "DateValue",
      "description": "Observed value of a resolved date question.\n\nA value at or after the outcome's ``range_max`` records a tail resolution on an\nopen-upper-bound question. A question resolved at its horizon because the event had not\noccurred records ``range_max`` itself: the tail pools \"later\" with \"never\", so no finer\nvalue is knowable and all tail values score identically."
    },
    "DistributionValue": {
      "properties": {
        "type": {
          "type": "string",
          "const": "distribution",
          "title": "Type",
          "default": "distribution"
        },
        "samples": {
          "items": {
            "oneOf": [
              {
                "$ref": "#/$defs/BinaryValue"
              },
              {
                "$ref": "#/$defs/CategoricalValue"
              },
              {
                "$ref": "#/$defs/NumericalValue"
              },
              {
                "$ref": "#/$defs/DateValue"
              },
              {
                "$ref": "#/$defs/JointValue"
              }
            ]
          },
          "type": "array",
          "minItems": 1,
          "title": "Samples"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "samples"
      ],
      "title": "DistributionValue",
      "description": "Every observed value of a question that resolves to a distribution.\n\nValues are kept in reported order and may repeat; scoring treats each as one resolution of\nthe same forecast, so a repeated value simply weighs more. All values share one output type."
    },
    "Domain": {
      "type": "string",
      "enum": [
        "domestic_politics",
        "international_relations",
        "conflict_security",
        "economy_macro",
        "finance_markets",
        "commodities",
        "business_industry",
        "crypto",
        "science_technology",
        "health",
        "society",
        "environment_climate",
        "law_justice",
        "culture_entertainment",
        "sports",
        "infrastructure_transport",
        "other"
      ],
      "title": "Domain",
      "description": "Top-level question domain."
    },
    "EqualityProjection": {
      "properties": {
        "type": {
          "type": "string",
          "const": "equality",
          "title": "Type",
          "default": "equality"
        },
        "option": {
          "type": "string",
          "minLength": 1,
          "title": "Option",
          "description": "The underlying question's option that resolves the question YES"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "option"
      ],
      "title": "EqualityProjection",
      "description": "A categorical answer resolves a binary question by equality with one named option."
    },
    "GroupingProjection": {
      "properties": {
        "type": {
          "type": "string",
          "const": "grouping",
          "title": "Type",
          "default": "grouping"
        },
        "mapping": {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object",
          "minProperties": 2,
          "title": "Mapping",
          "description": "Each underlying question option mapped to the question option it resolves"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "mapping"
      ],
      "title": "GroupingProjection",
      "description": "A categorical answer resolves a coarser categorical question by grouping options."
    },
    "InformationVelocity": {
      "type": "string",
      "enum": [
        "low",
        "medium",
        "high"
      ],
      "title": "InformationVelocity",
      "description": "Baseline cadence for refreshing a forecast.\nValues:\n- low: Refresh monthly by default; material new information is expected infrequently.\n- medium: Refresh weekly by default; material new information is expected periodically.\n- high: Refresh daily by default; material new information is expected frequently."
    },
    "JointConstraint": {
      "type": "string",
      "enum": [
        "simplex",
        "ordered",
        "none"
      ],
      "title": "JointConstraint",
      "description": "Rule every draw of a joint outcome's dimension vector obeys.\nValues:\n- simplex: The dimensions are shares that sum to 1, with an explicit Other dimension.\n- ordered: The values are non-decreasing in dimension order.\n- none: The dimensions are not constrained against each other."
    },
    "JointOutcome": {
      "properties": {
        "resolution_kind": {
          "$ref": "#/$defs/ResolutionKind",
          "description": "Whether the question resolves to one observed value or to every observation over a window; with a distribution one forecast is scored against each of them",
          "default": "point"
        },
        "type": {
          "type": "string",
          "const": "joint",
          "title": "Type",
          "default": "joint"
        },
        "dimensions": {
          "items": {
            "$ref": "#/$defs/JointOutcomeComponent"
          },
          "type": "array",
          "title": "Dimensions"
        },
        "constraint": {
          "$ref": "#/$defs/JointConstraint"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "dimensions",
        "constraint"
      ],
      "title": "JointOutcome",
      "description": "A vector of named numerical dimensions resolving together under one constraint.\n\nDimension order is the order of every draw and resolved vector, and the ordering an\n``ordered`` constraint enforces."
    },
    "JointOutcomeComponent": {
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1,
          "title": "Name",
          "description": "Name of the dimension, unique ignoring case"
        },
        "outcome": {
          "$ref": "#/$defs/NumericalOutcome"
        },
        "target_date": {
          "type": "string",
          "format": "date-time",
          "title": "Target Date",
          "description": "Date at which the dimension's quantity is measured"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "name",
        "outcome",
        "target_date"
      ],
      "title": "JointOutcomeComponent",
      "description": "One named component of a joint outcome: a numerical quantity at a target date."
    },
    "JointValue": {
      "properties": {
        "type": {
          "type": "string",
          "const": "joint",
          "title": "Type",
          "default": "joint"
        },
        "value": {
          "additionalProperties": {
            "type": "number"
          },
          "type": "object",
          "title": "Value"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "value"
      ],
      "title": "JointValue",
      "description": "Observed vector of a resolved joint question, keyed by dimension name."
    },
    "JsonValue": {},
    "MarginalProjection": {
      "properties": {
        "type": {
          "type": "string",
          "const": "marginal",
          "title": "Type",
          "default": "marginal"
        },
        "dimension": {
          "type": "string",
          "minLength": 1,
          "title": "Dimension",
          "description": "Name of the joint question's dimension the question takes"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "dimension"
      ],
      "title": "MarginalProjection",
      "description": "A joint answer resolves a member question by the value of one named dimension."
    },
    "MembershipProjection": {
      "properties": {
        "type": {
          "type": "string",
          "const": "membership",
          "title": "Type",
          "default": "membership"
        },
        "options": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "minItems": 1,
          "title": "Options",
          "description": "The underlying question's options whose selection resolves the question YES"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "options"
      ],
      "title": "MembershipProjection",
      "description": "A categorical answer resolves a binary question by membership in a set of options."
    },
    "NumericKind": {
      "type": "string",
      "enum": [
        "continuous",
        "discrete"
      ],
      "title": "NumericKind",
      "description": "Values:\n- continuous: The underlying quantity is continuous, even when reported rounded.\n- discrete: The underlying quantity lies on an intrinsic lattice, such as a count."
    },
    "NumericalInterval": {
      "properties": {
        "lower_bound": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Lower Bound",
          "description": "Finite lower bound, or null when unbounded below"
        },
        "lower_inclusive": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Lower Inclusive",
          "description": "Whether lower-bound equality belongs to this interval; set exactly when lower_bound is finite"
        },
        "upper_bound": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Upper Bound",
          "description": "Finite upper bound, or null when unbounded above"
        },
        "upper_inclusive": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Upper Inclusive",
          "description": "Whether upper-bound equality belongs to this interval; set exactly when upper_bound is finite"
        },
        "outcome": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "string",
              "minLength": 1,
              "description": "Exact name of one categorical outcome"
            }
          ],
          "title": "Outcome"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "outcome"
      ],
      "title": "NumericalInterval",
      "description": "Flat numerical interval producing one binary or categorical outcome."
    },
    "NumericalIntervalProjection": {
      "properties": {
        "type": {
          "type": "string",
          "const": "numerical_interval",
          "title": "Type",
          "default": "numerical_interval"
        },
        "intervals": {
          "items": {
            "$ref": "#/$defs/NumericalInterval"
          },
          "type": "array",
          "minItems": 2,
          "title": "Intervals",
          "description": "Ascending intervals forming a total partition of the scalar domain: the first is unbounded below, the last is unbounded above, adjacent bounds match, and exactly one adjacent interval includes their shared bound. Outcomes are all booleans for a binary question or all exact option strings for a categorical question."
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "intervals"
      ],
      "title": "NumericalIntervalProjection",
      "description": "A numerical answer resolves through an exhaustive partition of the number line."
    },
    "NumericalOutcome": {
      "properties": {
        "resolution_kind": {
          "$ref": "#/$defs/ResolutionKind",
          "description": "Whether the question resolves to one observed value or to every observation over a window; with a distribution one forecast is scored against each of them",
          "default": "point"
        },
        "type": {
          "type": "string",
          "const": "numerical",
          "title": "Type",
          "default": "numerical"
        },
        "unit": {
          "type": "string",
          "minLength": 1,
          "title": "Unit",
          "description": "Unit of the resolving value, or 'dimensionless' when none applies"
        },
        "range_min": {
          "type": "number",
          "title": "Range Min",
          "description": "Lowest in-range resolution value"
        },
        "range_max": {
          "type": "number",
          "title": "Range Max",
          "description": "Highest in-range resolution value"
        },
        "log_origin": {
          "anyOf": [
            {
              "type": "number",
              "description": "Origin defining a logarithmic forecast scale. Null selects a linear scale where precision is an absolute step; set selects a logarithmic scale where precision is a ratio greater than one"
            },
            {
              "type": "null"
            }
          ],
          "title": "Log Origin"
        },
        "reporting_quantum": {
          "anyOf": [
            {
              "type": "number",
              "exclusiveMinimum": 0.0,
              "description": "Smallest reporting increment of the resolving value"
            },
            {
              "type": "null"
            }
          ],
          "title": "Reporting Quantum"
        },
        "kind": {
          "$ref": "#/$defs/NumericKind",
          "description": "Whether the underlying quantity is continuous or intrinsically discrete",
          "default": "continuous"
        },
        "scoring_precision": {
          "type": "number",
          "exclusiveMinimum": 0.0,
          "title": "Scoring Precision",
          "description": "Width of each linear scoring bin, or ratio between adjacent logarithmic bin edges; stored as part of the authored forecast contract"
        },
        "open_lower_bound": {
          "type": "boolean",
          "title": "Open Lower Bound",
          "description": "Whether values below range_min may resolve; forecasts aggregate them into one lower tail below the first scoring boundary. False makes range_min an inclusive resolution floor",
          "default": false
        },
        "open_upper_bound": {
          "type": "boolean",
          "title": "Open Upper Bound",
          "description": "Whether values above range_max may resolve; forecasts aggregate them into one upper tail beyond the last scoring boundary. False makes range_max an inclusive resolution ceiling",
          "default": false
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "unit",
        "range_min",
        "range_max"
      ],
      "title": "NumericalOutcome",
      "description": "Numeric-value outcome space."
    },
    "NumericalValue": {
      "properties": {
        "type": {
          "type": "string",
          "const": "numerical",
          "title": "Type",
          "default": "numerical"
        },
        "value": {
          "type": "number",
          "title": "Value"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "value"
      ],
      "title": "NumericalValue",
      "description": "Observed value of a resolved numerical question."
    },
    "ProjectionStatus": {
      "type": "string",
      "enum": [
        "not_attempted",
        "derived",
        "declined",
        "failed",
        "underlying"
      ],
      "title": "ProjectionStatus",
      "description": "A question's role in the projection linking an original to its underlying question.\nValues:\n- not_attempted: Underlying-question generation has not run for this original yet.\n- derived: The original's answer projects from the underlying question it produced.\n- declined: This original correctly has no underlying question; it stays as asked.\n- failed: Underlying-question generation errored for this original; retry it.\n- underlying: An underlying question another question's answer derives from."
    },
    "QgenSource": {
      "type": "string",
      "enum": [
        "wikipedia",
        "yfinance",
        "fred",
        "acled",
        "dbnomics",
        "serpapi",
        "trading_economics",
        "macrobond",
        "eia",
        "unhcr",
        "who",
        "ukhsa",
        "uk_home_office",
        "nifc",
        "bluesky",
        "google_scholar",
        "box_office_mojo",
        "opusdata",
        "layoffs_fyi",
        "categorical_qgen",
        "manual"
      ],
      "title": "QgenSource",
      "description": "Input dataset or generation workflow behind a Mantic-generated question."
    },
    "QuestionSource": {
      "type": "string",
      "enum": [
        "app",
        "qgen",
        "situations",
        "forecastbench",
        "dev",
        "metaculus",
        "crucible",
        "polymarket",
        "polymarket_us",
        "kalshi",
        "manifold",
        "infer",
        "good_judgment",
        "client"
      ],
      "title": "QuestionSource",
      "description": "Where a question originated in our workflow."
    },
    "ResolutionKind": {
      "type": "string",
      "enum": [
        "point",
        "distribution"
      ],
      "title": "ResolutionKind",
      "description": "How many observed values a question resolves to.\nValues:\n- point: Resolves to one observed value.\n- distribution: Resolves to every observed value of the quantity over a window, such as a price on each trading day of a month; one forecast distribution is scored against all of them."
    },
    "Resolved": {
      "properties": {
        "type": {
          "type": "string",
          "const": "resolved",
          "title": "Type",
          "default": "resolved"
        },
        "value": {
          "oneOf": [
            {
              "$ref": "#/$defs/BinaryValue"
            },
            {
              "$ref": "#/$defs/CategoricalValue"
            },
            {
              "$ref": "#/$defs/NumericalValue"
            },
            {
              "$ref": "#/$defs/DateValue"
            },
            {
              "$ref": "#/$defs/JointValue"
            },
            {
              "$ref": "#/$defs/DistributionValue"
            }
          ],
          "title": "Value"
        },
        "at": {
          "type": "string",
          "format": "date-time",
          "title": "At",
          "description": "Timezone-aware timestamp; any offset is accepted and normalized to UTC"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "value",
        "at"
      ],
      "title": "Resolved",
      "description": "The question resolved to an observed value at a known time."
    },
    "Subdomain": {
      "type": "string",
      "enum": [
        "elections",
        "legislation",
        "political_leadership",
        "public_policy",
        "appointments",
        "diplomacy",
        "trade",
        "treaties",
        "international_organizations",
        "sanctions",
        "armed_conflict",
        "military_action",
        "coups",
        "civil_unrest",
        "terrorism",
        "territorial_control",
        "cyber_conflict",
        "inflation",
        "monetary_policy",
        "economic_growth",
        "sentiment_surveys",
        "external_sector",
        "consumer_activity",
        "industrial_activity",
        "labor_market",
        "fiscal_policy",
        "equities",
        "credit_debt",
        "housing_markets",
        "currencies",
        "fixed_income",
        "volatility_derivatives",
        "financial_institutions",
        "corporate_actions",
        "net_worth",
        "energy_commodities",
        "precious_metals",
        "industrial_metals",
        "agricultural_commodities",
        "livestock",
        "earnings",
        "company_financials",
        "products",
        "supply_chains",
        "business_operations",
        "bankruptcy",
        "crypto_asset_prices",
        "stablecoins",
        "on_chain_technology",
        "token_launches",
        "crypto_regulation",
        "ai",
        "space",
        "computing",
        "robotics",
        "biotechnology",
        "scientific_discoveries",
        "medicine",
        "public_health",
        "pandemics",
        "healthcare_policy",
        "drug_approvals",
        "demographics",
        "migration",
        "education",
        "social_trends",
        "public_opinion",
        "weather",
        "natural_disasters",
        "climate",
        "emissions",
        "energy_policy",
        "agriculture",
        "trials",
        "sentencings",
        "courts",
        "indictments",
        "criminal_investigations",
        "awards",
        "film_tv",
        "music",
        "gaming",
        "publishing",
        "celebrities",
        "game_outcomes",
        "championships",
        "player_performance",
        "player_trades",
        "transportation",
        "aviation",
        "maritime",
        "civil_infrastructure",
        "energy_infrastructure",
        "domestic_politics_other",
        "international_relations_other",
        "conflict_security_other",
        "economy_macro_other",
        "finance_markets_other",
        "commodities_other",
        "business_industry_other",
        "crypto_other",
        "science_technology_other",
        "health_other",
        "society_other",
        "environment_climate_other",
        "law_justice_other",
        "culture_entertainment_other",
        "sports_other",
        "infrastructure_transport_other",
        "other"
      ],
      "title": "Subdomain",
      "description": "Specific topic within a top-level question domain."
    },
    "Unresolved": {
      "properties": {
        "type": {
          "type": "string",
          "const": "unresolved",
          "title": "Type",
          "default": "unresolved"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "title": "Unresolved",
      "description": "The question has not reached a terminal lifecycle state."
    },
    "core__question__models__Question": {
      "properties": {
        "id_key": {
          "type": "string",
          "title": "Id Key",
          "description": "Stable dedupe key used to derive the question ID",
          "default": ""
        },
        "id": {
          "type": "string",
          "format": "uuid",
          "title": "Id",
          "description": "Question UUID derived from id_key",
          "default": "00000000-0000-0000-0000-000000000000"
        },
        "source": {
          "$ref": "#/$defs/QuestionSource",
          "description": "Immediate supplier or creator of this canonical question"
        },
        "competition": {
          "anyOf": [
            {
              "$ref": "#/$defs/Competition",
              "description": "Competition the question appeared in"
            },
            {
              "type": "null"
            }
          ]
        },
        "upstream_source": {
          "anyOf": [
            {
              "anyOf": [
                {
                  "$ref": "#/$defs/QuestionSource"
                },
                {
                  "$ref": "#/$defs/QgenSource"
                }
              ],
              "description": "Venue or dataset from which the immediate source obtained the content"
            },
            {
              "type": "null"
            }
          ],
          "title": "Upstream Source"
        },
        "external_id": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1,
              "description": "ID of the question in the originating source"
            },
            {
              "type": "null"
            }
          ],
          "title": "External Id"
        },
        "source_url": {
          "type": "string",
          "title": "Source Url",
          "description": "Source question url, or empty when the source exposes none"
        },
        "created_at": {
          "type": "string",
          "format": "date-time",
          "title": "Created At",
          "description": "A time by which the question's wording and contract existed: when they were written, or else when they were observed"
        },
        "added_at": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time",
              "description": "Timezone-aware timestamp; any offset is accepted and normalized to UTC"
            },
            {
              "type": "null"
            }
          ],
          "title": "Added At",
          "description": "When the question was written to the DB, or None before it is"
        },
        "commit_hash": {
          "type": "string",
          "minLength": 1,
          "title": "Commit Hash",
          "description": "Git commit hash of the codebase that produced the record"
        },
        "title": {
          "type": "string",
          "minLength": 1,
          "title": "Title",
          "description": "Short, self-contained question title, at most one sentence"
        },
        "title_short": {
          "type": "string",
          "minLength": 1,
          "title": "Title Short",
          "description": "A concise display title that identifies the forecast target. Preserve whether the forecast concerns an event, quantity, identity, or date. Prefer declarative form when unambiguous. Preserve all identifying entities, thresholds, outcome-defining time periods, conditionals, meaning, and polarity, including negation; never reverse whether the named event counts as the positive or negative outcome."
        },
        "context": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1,
              "description": "Relevant factual background that helps understand the question: the entities involved, the current situation, and recent events"
            },
            {
              "type": "null"
            }
          ],
          "title": "Context"
        },
        "resolution_criteria": {
          "type": "string",
          "minLength": 1,
          "title": "Resolution Criteria",
          "description": "Operational rule for what observable outcome or value resolves the question, and its source"
        },
        "as_of": {
          "type": "string",
          "format": "date-time",
          "title": "As Of",
          "description": "The current time for the question; only facts available at or before it are known"
        },
        "domain": {
          "$ref": "#/$defs/Domain",
          "description": "Single top-level topic that the question's resolving variable belongs to; use other only when no named domain fits"
        },
        "subdomain": {
          "$ref": "#/$defs/Subdomain",
          "description": "Tightest subdomain belonging to the question's domain, including a domain already supplied; every domain has a <domain>_other for when no named subdomain fits"
        },
        "regions": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "minItems": 1,
          "title": "Regions",
          "description": "Every geography that constrains resolution, plus the jurisdiction, location, or release market of the resolving fact. Give ISO 3166 alpha-2 country codes in capitals (e.g. US, GB, CN), or these group codes in lower case: africa, asia, europe, global, middle_east, north_america, oceania, south_america. Use an overseas territory's own code, and add the country administering it only where that government also acts. Where two groups overlap, name only the narrower one: middle_east rather than asia, and a continent only where no narrower group fits. Use global only for something that belongs to no particular place."
        },
        "information_velocity": {
          "$ref": "#/$defs/InformationVelocity"
        },
        "metadata": {
          "anyOf": [
            {
              "additionalProperties": {
                "$ref": "#/$defs/JsonValue"
              },
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Metadata"
        },
        "outcome": {
          "oneOf": [
            {
              "$ref": "#/$defs/BinaryOutcome"
            },
            {
              "$ref": "#/$defs/CategoricalOutcome"
            },
            {
              "$ref": "#/$defs/NumericalOutcome"
            },
            {
              "$ref": "#/$defs/DateOutcome"
            },
            {
              "$ref": "#/$defs/JointOutcome"
            }
          ],
          "title": "Outcome",
          "description": "The question's authored outcome space"
        },
        "lifecycle": {
          "oneOf": [
            {
              "$ref": "#/$defs/Unresolved"
            },
            {
              "$ref": "#/$defs/Resolved"
            },
            {
              "$ref": "#/$defs/Annulled"
            }
          ],
          "title": "Lifecycle"
        },
        "fixed_resolution_time": {
          "type": "boolean",
          "title": "Fixed Resolution Time",
          "description": "Whether the exact time that determines the answer is known and fixed in advance. True for a stated observation time or measurement-period end and requires expected_resolution_time. False when that exact time is unknown or the outcome may settle earlier. A scheduled event date does not make its result or declaration time fixed. A later publication time or fallback deadline also does not make the determining time fixed. For a date outcome this is false because the event time is the answer. This is derived schedule metadata and does not affect question identity"
        },
        "expected_resolution_time": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time",
              "description": "When the event or measurement that determines the answer is expected to occur, as stated by the question. Null when the question states no such time, and for a date outcome, where the event time is the answer and the outcome's range_max is the horizon. This can be non-null when fixed_resolution_time is false, but fixed_resolution_time cannot be true when this is null. It contributes to question identity. A time the question states only as a date is recorded as an exact instant within that date, such as its final second. Operationally this is when to check for the resolution; it is never an input to forecasting"
            },
            {
              "type": "null"
            }
          ],
          "title": "Expected Resolution Time"
        },
        "family_id": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid"
            },
            {
              "type": "null"
            }
          ],
          "title": "Family Id",
          "description": "ID shared by versions of the same source question as it genuinely evolves over time; as_of orders those versions by their information cutoff. Also links repeated forecast dates or resolution horizons for that source question. Do not use it alone to mark a retrospective correction."
        },
        "superseded_by": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid"
            },
            {
              "type": "null"
            }
          ],
          "title": "Superseded By",
          "description": "ID of the replacement for this retrospectively corrected question. Use for mistakes such as wording or source metadata, including an incorrect as_of; do not use for the normal evolution of a question over time, which is represented by family_id and as_of."
        },
        "projection_status": {
          "$ref": "#/$defs/ProjectionStatus",
          "description": "This question's role in the projection linking an original question to its underlying question",
          "default": "not_attempted"
        },
        "viewable_in_app": {
          "type": "boolean",
          "title": "Viewable In App",
          "description": "Whether the app shows this question",
          "default": false
        },
        "underlying_question_id": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid"
            },
            {
              "type": "null"
            }
          ],
          "title": "Underlying Question Id"
        },
        "projection": {
          "anyOf": [
            {
              "oneOf": [
                {
                  "$ref": "#/$defs/NumericalIntervalProjection"
                },
                {
                  "$ref": "#/$defs/EqualityProjection"
                },
                {
                  "$ref": "#/$defs/MembershipProjection"
                },
                {
                  "$ref": "#/$defs/GroupingProjection"
                },
                {
                  "$ref": "#/$defs/DateIntervalProjection"
                },
                {
                  "$ref": "#/$defs/MarginalProjection"
                }
              ]
            },
            {
              "type": "null"
            }
          ],
          "title": "Projection"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "source",
        "source_url",
        "created_at",
        "title",
        "title_short",
        "resolution_criteria",
        "as_of",
        "domain",
        "subdomain",
        "regions",
        "information_velocity",
        "outcome",
        "lifecycle",
        "fixed_resolution_time"
      ],
      "title": "Question",
      "description": "A canonical forecasting question.\n\nTightens the draft: canonicalisation must produce title_short, resolution_criteria, and a\ncomplete set of metadata labels. Context stays optional."
    }
  }
}