Skip to main content
Glama

EchelonGraph CVE & Exposure

Vendor advisory detail

get_vendor_advisory
Read-onlyIdempotent

One vendor advisory in full, by vendor and advisory ID (the vendor and vendor_advisory_id of a vendor advisory row, never its advisory_id): title, description, severity, cvss_v3_score, cve_ids and known_cve_ids (in EchelonGraph's CVE feed), affected_products, remediation, references, vendor_modified_at, and withdrawn_at and withdrawn_reason when the vendor withdrew it. remediations: each the vendor lists, with kind (vendor_fix, workaround, mitigation, no_fix_planned, none_available or other: the vendor's category, or may be no_fix_planned if Cisco's summary says none will be released), source_category, text, url, cve_ids and product_ids; each text is the vendor's, verbatim, untested by EchelonGraph. remediation_state none_in_source or not_parsed is not a finding that no fix exists. Each advisory carries vendor_published_at (the vendor's date), our_first_seen_at (when EchelonGraph first recorded it) and withdrawn (true: the vendor rescinded it). Each advisory also carries rejected_cve_ids: the CVE IDs it names whose CVE record was rejected (withdrawn) by its numbering authority, which are not active vulnerabilities. coverage.vendor_window is what EchelonGraph holds of that vendor: earliest_vendor_published_at, latest_vendor_published_at, held_since (where that window begins), history_backfill (in_progress or not_started: older advisories not all held yet), history_scope and feed_held_since; null if unreadable or empty. measured_at is our_first_seen_at. freshness is null; vendor_window.last_success_at is the last successful poll. Past 30,000 characters of JSON, the first text block holds data cut to fit, and the note says what the cut leaves out and where to read it (TEXT CUT); so is structured data (DATA CUT), unless full: true. vendor_text_withheld true (Microsoft): title is EchelonGraph's; description, remediation and item texts are empty; cve_records: its first CVEs, each with its CVE-record description or null.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "vendor": "<vendor>",
      "advisory_id": "<advisory_id>"
    },
    "name": "get_vendor_advisory"
  }
}

Input Schema

NameRequiredDescriptionDefault
fullNotrue: data in the structured result is the answer whole, however long. Without it, a structured result past 30,000 characters of JSON has its data cut (DATA CUT): in an order the note states, the entries of its longest lists keep only some of their fields, and then the lists only some of their entries; data_truncated is true, and truncated gives each list cut with its total, the number returned and whether its entries are thinned. Whole data is for a program; a client that sizes structured results, as Claude Code does against MAX_MCP_OUTPUT_TOKENS, can refuse an answer past its cap.
vendorYesthe vendor slug, e.g. microsoft, redhat, github
advisory_idYesthe vendor's own advisory ID, a row's vendor_advisory_id, e.g. RHSA-2024:1234, GHSA-xxxx-xxxx-xxxx or CVE-2024-3400; not a row's advisory_id, EchelonGraph's internal UUID

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "coverage": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "properties": {
      -              "vendor_window": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": {},
      -                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it; where history_scope is a part of the vendor's advisories, it is where that part is held from, and the rest is held from feed_held_since), feed_held_since (the start of the window the vendor's own feed has read every one of its advisories from, which is held_since as it would be without any history read; an advisory outside history_scope published before it may not be held; null when none is held or the API does not say), history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried) and history_scope (what the vendor's history read covers: all, or reviewed for GitHub, whose read covers its reviewed advisories and not its unreviewed ones, which are held only from feed_held_since; a value the API adds later as it sends it; null for a vendor with no history read, or when the API does not say).",
      -                    "properties": {
      -                      "advisories": {
      -                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      -                        "type": [
      -                          "number",
      -                          "null"
      -                        ]
      -                      },
      -                      "earliest_vendor_published_at": {
      -                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "feed_held_since": {
      -                        "description": "The start of the window this vendor's own feed has read every one of its advisories from: held_since as it would be without any history read, and equal to it for a vendor with no history read. Where history_scope is a part of the vendor's advisories (reviewed: GitHub's history read covers its reviewed advisories only), an advisory outside it published before feed_held_since may not be held, however early held_since is. null when none is held or the API does not say.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "held_since": {
      -                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older. Where history_scope is a part of the vendor's advisories (reviewed), it is where that part is held from; the rest is held from feed_held_since.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "history_backfill": {
      -                        "anyOf": [
      -                          {
      -                            "anyOf": [
      -                              {
      -                                "enum": [
      -                                  "complete",
      -                                  "complete_reviewed_only",
      -                                  "in_progress",
      -                                  "not_started",
      -                                  "not_supported"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              {
      -                                "type": "string"
      -                              }
      -                            ]
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      -                      },
      -                      "history_scope": {
      -                        "description": "What this vendor's history read covers: all (every advisory its archive publishes) or reviewed (GitHub: its reviewed advisories, not its unreviewed ones, which are held only from feed_held_since); a value the API adds later as it sends it. null for a vendor with no history read, or when the API does not say.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "latest_vendor_published_at": {
      -                        "description": "The latest vendor_published_at among them; null when none is held.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "vendor": {
      -                        "description": "The vendor slug.",
      -                        "type": "string"
      -                      },
      -                      "vendor_display_name": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      }
      -                    },
      -                    "required": [
      -                      "vendor",
      -                      "vendor_display_name",
      -                      "advisories",
      -                      "earliest_vendor_published_at",
      -                      "latest_vendor_published_at",
      -                      "held_since",
      -                      "feed_held_since",
      -                      "history_backfill",
      -                      "history_scope"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      -              }
      -            },
      -            "required": [
      -              "vendor_window"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "What the answer covers; null where the answer says nothing about it."
      -      },
      -      "data": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "advisory_id": {
      -            "description": "EchelonGraph's internal ID for this advisory, a UUID. It is not the vendor's advisory ID (vendor_advisory_id), and an advisory's detail is not looked up by it: the detail is keyed on vendor and vendor_advisory_id.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "affected_products": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "cvss_v3_score": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "description": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "known_cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The CVE IDs of cve_ids that have a record in EchelonGraph's CVE feed."
      -          },
      -          "our_first_seen_at": {
      -            "description": "When EchelonGraph first recorded the advisory; not the vendor's date.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "references": {},
      -          "rejected_cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The CVE IDs this advisory names whose CVE record was rejected (withdrawn) by its numbering authority: each is a rejected record, not an active vulnerability, whatever the advisory's text says. The vendor's withdrawn is separate and unchanged by it. [] when none is; null when that could not be checked."
      -          },
      -          "remediation": {
      -            "description": "The vendor's remediation as one text (the legacy field), beside remediations.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "remediation_items_not_stored": {
      -            "description": "Items past the 64 stored per advisory.",
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "remediation_kinds": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "vendor_fix",
      -                        "workaround",
      -                        "mitigation",
      -                        "no_fix_planned",
      -                        "none_available",
      -                        "other"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "string"
      -                    }
      -                  ]
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The kinds of remediation the advisory lists (for the CVE asked about, on a by-cve row), each the vendor's own category, never read from the text: vendor_fix, workaround, mitigation, no_fix_planned, none_available or other. [] with remediation_state not_parsed is not a finding that it lists none."
      -          },
      -          "remediation_state": {
      -            "anyOf": [
      -              {
      -                "anyOf": [
      -                  {
      -                    "enum": [
      -                      "parsed",
      -                      "none_in_source",
      -                      "not_parsed",
      -                      "withdrawn"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "string"
      -                  }
      -                ]
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "parsed; none_in_source (EchelonGraph read the vendor's remediation, and it lists none for this CVE, which is not a finding that no fix exists); not_parsed (EchelonGraph does not read this vendor's remediation, or has not yet read this advisory: not a finding of none); withdrawn (the vendor rescinded the advisory)."
      -          },
      -          "remediations": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "additionalProperties": {},
      -                  "properties": {
      -                    "cve_ids": {
      -                      "anyOf": [
      -                        {
      -                          "items": {
      -                            "type": "string"
      -                          },
      -                          "type": "array"
      -                        },
      -                        {
      -                          "type": "null"
      -                        }
      -                      ],
      -                      "description": "The CVEs the item covers; [] for the whole advisory."
      -                    },
      -                    "fixed_build": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "kind": {
      -                      "anyOf": [
      -                        {
      -                          "anyOf": [
      -                            {
      -                              "enum": [
      -                                "vendor_fix",
      -                                "workaround",
      -                                "mitigation",
      -                                "no_fix_planned",
      -                                "none_available",
      -                                "other"
      -                              ],
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "string"
      -                            }
      -                          ]
      -                        },
      -                        {
      -                          "type": "null"
      -                        }
      -                      ]
      -                    },
      -                    "product_count": {
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "product_ids": {
      -                      "anyOf": [
      -                        {
      -                          "items": {
      -                            "type": "string"
      -                          },
      -                          "type": "array"
      -                        },
      -                        {
      -                          "type": "null"
      -                        }
      -                      ]
      -                    },
      -                    "source_category": {
      -                      "description": "The vendor's own name for the category.",
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "source_subcategory": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "text": {
      -                      "description": "The vendor's text, verbatim but for HTML markup removed, untested by EchelonGraph; at most 2,000 characters (text_truncated, text_chars).",
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "text_chars": {
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "text_truncated": {
      -                      "type": [
      -                        "boolean",
      -                        "null"
      -                      ]
      -                    },
      -                    "url": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    }
      -                  },
      -                  "type": "object"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "Each remediation the vendor lists, with its kind, the vendor's own category."
      -          },
      -          "severity": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "summary": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "title": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_advisory_id": {
      -            "description": "The vendor's own ID for the advisory (e.g. RHSA-2024:1234, GHSA-xxxx-xxxx-xxxx, or the CVE ID for Microsoft and Palo Alto Networks). With vendor, it is the key an advisory's detail is looked up by, as its advisory_id argument.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_display_name": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_modified_at": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_published_at": {
      -            "description": "The date the vendor gives for the advisory.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "withdrawn": {
      -            "description": "true: the vendor withdrew (rescinded) this advisory, so it is a withdrawn advisory, not a current one.",
      -            "type": [
      -              "boolean",
      -              "null"
      -            ]
      -          },
      -          "withdrawn_at": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "withdrawn_reason": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "data_truncated": {
      -        "description": "false: data is the answer whole. true: the structured result would pass 30,000 characters of JSON with data whole, so data is cut (DATA CUT): the entries of some of its lists keep only some of their fields, or the lists only some of their entries, truncated gives each, and no string is shortened. The same call with full: true returns data whole.",
      -        "type": "boolean"
      -      },
      -      "freshness": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "The producing radar's last completed check (last_run_at), where the API serves one."
      -      },
      -      "measured_at": {
      -        "anyOf": [
      -          {
      -            "description": "An RFC 3339 instant.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation."
      -      },
      -      "method": {
      -        "description": "How the numbers were produced.",
      -        "type": "string"
      -      },
      -      "notes": {
      -        "description": "Caveats, one sentence each.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "state": {
      -        "description": "measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.",
      -        "enum": [
      -          "measured",
      -          "not_assessed"
      -        ],
      -        "type": "string"
      -      },
      -      "truncated": {
      -        "additionalProperties": {
      -          "additionalProperties": {},
      -          "properties": {
      -            "returned": {
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            },
      -            "thinned": {
      -              "const": true,
      -              "type": "boolean"
      -            },
      -            "total": {
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            }
      -          },
      -          "required": [
      -            "total",
      -            "returned"
      -          ],
      -          "type": "object"
      -        },
      -        "description": "Present when data_truncated is true: each list of data that was cut, by its path in data (a dot between the names of an object and a list inside it), with total, its entries in the answer, returned, the entries data holds, and thinned, true when each of them keeps only some of its fields.",
      -        "propertyNames": {
      -          "type": "string"
      -        },
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "state",
      -      "measured_at",
      -      "method",
      -      "coverage",
      -      "freshness",
      -      "notes",
      -      "data_truncated",
      -      "data"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "coverage": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "vendor_window": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": false,
      -                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it; where history_scope is a part of the vendor's advisories, it is where that part is held from, and the rest is held from feed_held_since), feed_held_since (the start of the window the vendor's own feed has read every one of its advisories from, which is held_since as it would be without any history read; an advisory outside history_scope published before it may not be held; null when none is held or the API does not say), history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried) and history_scope (what the vendor's history read covers: all, or reviewed for GitHub, whose read covers its reviewed advisories and not its unreviewed ones, which are held only from feed_held_since; a value the API adds later as it sends it; null for a vendor with no history read, or when the API does not say).",
      -                    "properties": {
      -                      "advisories": {
      -                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      -                        "type": [
      -                          "number",
      -                          "null"
      -                        ]
      -                      },
      -                      "earliest_vendor_published_at": {
      -                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "feed_held_since": {
      -                        "description": "The start of the window this vendor's own feed has read every one of its advisories from: held_since as it would be without any history read, and equal to it for a vendor with no history read. Where history_scope is a part of the vendor's advisories (reviewed: GitHub's history read covers its reviewed advisories only), an advisory outside it published before feed_held_since may not be held, however early held_since is. null when none is held or the API does not say.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "held_since": {
      -                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older. Where history_scope is a part of the vendor's advisories (reviewed), it is where that part is held from; the rest is held from feed_held_since.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "history_backfill": {
      -                        "anyOf": [
      -                          {
      -                            "anyOf": [
      -                              {
      -                                "enum": [
      -                                  "complete",
      -                                  "complete_reviewed_only",
      -                                  "in_progress",
      -                                  "not_started",
      -                                  "not_supported"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              {
      -                                "type": "string"
      -                              }
      -                            ]
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      -                      },
      -                      "history_scope": {
      -                        "description": "What this vendor's history read covers: all (every advisory its archive publishes) or reviewed (GitHub: its reviewed advisories, not its unreviewed ones, which are held only from feed_held_since); a value the API adds later as it sends it. null for a vendor with no history read, or when the API does not say.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "latest_vendor_published_at": {
      -                        "description": "The latest vendor_published_at among them; null when none is held.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "vendor": {
      -                        "description": "The vendor slug.",
      -                        "type": "string"
      -                      },
      -                      "vendor_display_name": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      }
      -                    },
      -                    "required": [
      -                      "vendor",
      -                      "vendor_display_name",
      -                      "advisories",
      -                      "earliest_vendor_published_at",
      -                      "latest_vendor_published_at",
      -                      "held_since",
      -                      "feed_held_since",
      -                      "history_backfill",
      -                      "history_scope"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      -              }
      -            },
      -            "required": [
      -              "vendor_window"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "error": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "kind": {
      -            "description": "What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.",
      -            "enum": [
      -              "network",
      -              "timeout",
      -              "http",
      -              "not_json",
      -              "not_object",
      -              "invalid_input",
      -              "internal",
      -              "unexpected_shape",
      -              "radars"
      -            ],
      -            "type": "string"
      -          },
      -          "message": {
      -            "description": "The cause: the API's own message, or what went wrong.",
      -            "type": "string"
      -          },
      -          "path": {
      -            "description": "The API path requested, when a request was made.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "status": {
      -            "anyOf": [
      -              {
      -                "maximum": 9007199254740991,
      -                "minimum": -9007199254740991,
      -                "type": "integer"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The HTTP status, when the API answered one; 503 with kind internal and path null where this server was too busy to make the call."
      -          }
      -        },
      -        "required": [
      -          "kind",
      -          "path",
      -          "status",
      -          "message"
      -        ],
      -        "type": "object"
      -      },
      -      "freshness": {
      -        "type": "null"
      -      },
      -      "measured_at": {
      -        "type": "null"
      -      },
      -      "method": {
      -        "type": "null"
      -      },
      -      "notes": {
      -        "description": "Caveats, one sentence each.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "state": {
      -        "description": "failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.",
      -        "enum": [
      -          "failed",
      -          "invalid_input"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "state",
      -      "measured_at",
      -      "method",
      -      "coverage",
      -      "freshness",
      -      "notes",
      -      "error"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "coverage": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "properties": {
      +              "vendor_window": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": {},
      +                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it; where history_scope is a part of the vendor's advisories, it is where that part is held from, and the rest is held from feed_held_since), feed_held_since (the start of the window the vendor's own feed has read every one of its advisories from, which is held_since as it would be without any history read; an advisory outside history_scope published before it may not be held; null when none is held or the API does not say), history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried), history_scope (what the vendor's history read covers: all, or reviewed for GitHub, whose read covers its reviewed advisories and not its unreviewed ones, which are held only from feed_held_since; a value the API adds later as it sends it; null for a vendor with no history read, or when the API does not say), and last_success_at (the vendor's last successful poll), collection_state (whether the vendor is being collected now, by EchelonGraph's feed-state rule: ok; partial, its polls succeed but held_back of the documents it lists could not be used, the oldest since held_back_since, and those advisories, or those revisions, may not be held while the rest of its feed is; failing, it is not being collected, and what it published after failing_since, its last successful poll, may not be held, whatever the window says; disabled, this deployment runs no collector for it (its held advisories are still served), so its window ends at last_success_at; a value the API adds later as it sends it, never read as ok), failing_since, held_back and held_back_since (each null when the API does not say).",
      +                    "properties": {
      +                      "advisories": {
      +                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "collection_state": {
      +                        "description": "Whether this vendor is being collected now, by EchelonGraph's feed-state rule: ok, partial, failing or disabled. ok: it is being collected. partial: its polls succeed, but held_back of the documents it lists could not be used, the oldest since held_back_since; those advisories, or those revisions, may not be held, and the rest of its feed is. failing: it is not being collected, and an advisory it published after failing_since, its last successful poll, may not be held, whatever the window says. disabled: this deployment runs no collector for it (its held advisories are still served), so its window ends at last_success_at, and an advisory it published after that may not be held. A value the API adds later is relayed as sent and is not read as ok. null when the API does not say.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "earliest_vendor_published_at": {
      +                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "failing_since": {
      +                        "description": "While collection_state is failing, this vendor's last successful poll: an advisory it published after it may not be held, whatever the window says. null when it is not failing, when no successful poll is on record, or when the API does not say.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "feed_held_since": {
      +                        "description": "The start of the window this vendor's own feed has read every one of its advisories from: held_since as it would be without any history read, and equal to it for a vendor with no history read. Where history_scope is a part of the vendor's advisories (reviewed: GitHub's history read covers its reviewed advisories only), an advisory outside it published before feed_held_since may not be held, however early held_since is. null when none is held or the API does not say.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "held_back": {
      +                        "description": "How many of the documents this vendor lists EchelonGraph could not use (collection_state partial): those advisories, or those revisions, may not be held. 0 when none is held back; null when the API does not say.",
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "held_back_since": {
      +                        "description": "When the oldest held-back document first failed; null when none is held back or the API does not say.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "held_since": {
      +                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older. Where history_scope is a part of the vendor's advisories (reviewed), it is where that part is held from; the rest is held from feed_held_since.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "history_backfill": {
      +                        "anyOf": [
      +                          {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "complete",
      +                                  "complete_reviewed_only",
      +                                  "in_progress",
      +                                  "not_started",
      +                                  "not_supported"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "string"
      +                              }
      +                            ]
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      +                      },
      +                      "history_scope": {
      +                        "description": "What this vendor's history read covers: all (every advisory its archive publishes) or reviewed (GitHub: its reviewed advisories, not its unreviewed ones, which are held only from feed_held_since); a value the API adds later as it sends it. null for a vendor with no history read, or when the API does not say.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "last_success_at": {
      +                        "description": "This vendor's last successful poll; null when none is on record or the API does not say. While collection_state is disabled, the window ends here.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "latest_vendor_published_at": {
      +                        "description": "The latest vendor_published_at among them; null when none is held.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "vendor": {
      +                        "description": "The vendor slug.",
      +                        "type": "string"
      +                      },
      +                      "vendor_display_name": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      }
      +                    },
      +                    "required": [
      +                      "vendor",
      +                      "vendor_display_name",
      +                      "advisories",
      +                      "earliest_vendor_published_at",
      +                      "latest_vendor_published_at",
      +                      "held_since",
      +                      "feed_held_since",
      +                      "history_backfill",
      +                      "history_scope",
      +                      "last_success_at",
      +                      "collection_state",
      +                      "failing_since",
      +                      "held_back",
      +                      "held_back_since"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      +              }
      +            },
      +            "required": [
      +              "vendor_window"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "What the answer covers; null where the answer says nothing about it."
      +      },
      +      "data": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "advisory_id": {
      +            "description": "EchelonGraph's internal ID for this advisory, a UUID. It is not the vendor's advisory ID (vendor_advisory_id), and an advisory's detail is not looked up by it: the detail is keyed on vendor and vendor_advisory_id.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "affected_products": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "content_changed_at": {
      +            "description": "When what EchelonGraph's page of this advisory shows changed with no change to the advisory: when the vendor-text rule began serving; empty when none is recorded.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "cve_records": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "additionalProperties": {},
      +                  "properties": {
      +                    "cna": {
      +                      "description": "The CVE Numbering Authority that assigned the CVE and wrote its record, by its name in the CVE Program's CNA list, else its short name (e.g. Microsoft Corporation, kernel.org); null when none is on record.",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "cve_id": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "cve_record_url": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "description": {
      +                      "description": "The CVE record's description, as its CVE Numbering Authority (cna) published it in the CVE record at cve_record_url; null when there is none to serve, or when description_withheld_reason says why it is withheld.",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "description_withheld_reason": {
      +                      "description": "Why a description the CVE record has is null: matches_vendor_title: it repeats the advisory's own title, and a server-side switch for such descriptions, off by default, withheld it; null otherwise.",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "echelongraph_score": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "echelongraph_severity": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "fix_status": {
      +                      "description": "The fix status by the CVE feed's rule (state, basis, unread_inputs and the rule's evidence); null for a rejected record."
      +                    },
      +                    "kev_added_date": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "kev_listed": {
      +                      "type": [
      +                        "boolean",
      +                        "null"
      +                      ]
      +                    },
      +                    "known": {
      +                      "description": "Whether EchelonGraph holds a CVE record for it; false: EchelonGraph holds no CVE record for it; only cve_id and cve_record_url are set.",
      +                      "type": [
      +                        "boolean",
      +                        "null"
      +                      ]
      +                    },
      +                    "score_assessed": {
      +                      "type": [
      +                        "boolean",
      +                        "null"
      +                      ]
      +                    },
      +                    "score_confidence": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "score_unassessed_reason": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "vuln_status": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    }
      +                  },
      +                  "type": "object"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "When vendor_text_withheld is true: EchelonGraph's facts of the first cve_records_cap CVEs the advisory names, in its order: the CVE record's own description, as the CVE Numbering Authority that assigned the CVE (cna) published it in the CVE record at cve_record_url, reused under the CVE Program's Terms of Use (https://www.cve.org/Legal/TermsOfUse; © The MITRE Corporation; for a CVE the vendor assigned, the vendor wrote it; null where the record has none, was rejected or is still the stub a GitHub advisory seeded, where EchelonGraph holds no record (known false), or where description_withheld_reason says it is withheld), EchelonGraph's score as the CVE feed serves it (null unless score_assessed), the CISA KEV listing, and the fix status by the CVE feed's rule. null when the vendor's text is served, or when the facts could not be read."
      +          },
      +          "cve_records_cap": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "cve_records_total": {
      +            "description": "How many CVE IDs the advisory names; cve_records holds the first cve_records_cap of them.",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "cvss_v3_score": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "cvss_v3_vector": {
      +            "description": "The CVSS v3 vector of cvss_v3_score where the vendor's source carries one (Microsoft's); null otherwise. On by-cve rows and the detail.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "description": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "known_cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The CVE IDs of cve_ids that have a record in EchelonGraph's CVE feed."
      +          },
      +          "our_first_seen_at": {
      +            "description": "When EchelonGraph first recorded the advisory; not the vendor's date.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "references": {},
      +          "rejected_cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The CVE IDs this advisory names whose CVE record was rejected (withdrawn) by its numbering authority: each is a rejected record, not an active vulnerability, whatever the advisory's text says. The vendor's withdrawn is separate and unchanged by it. [] when none is; null when that could not be checked."
      +          },
      +          "remediation": {
      +            "description": "The vendor's remediation as one text (the legacy field), beside remediations.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "remediation_items_not_stored": {
      +            "description": "Items past the 64 stored per advisory.",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "remediation_kinds": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "vendor_fix",
      +                        "workaround",
      +                        "mitigation",
      +                        "no_fix_planned",
      +                        "none_available",
      +                        "other"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "string"
      +                    }
      +                  ]
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The kinds of remediation the advisory lists (for the CVE asked about, on a by-cve row), each the vendor's own category (vendor_fix, workaround, mitigation, no_fix_planned, none_available or other), or may be no_fix_planned where a Cisco advisory's summary says no fix will be released. [] with remediation_state not_parsed is not a finding that it lists none."
      +          },
      +          "remediation_state": {
      +            "anyOf": [
      +              {
      +                "anyOf": [
      +                  {
      +                    "enum": [
      +                      "parsed",
      +                      "none_in_source",
      +                      "not_parsed",
      +                      "withdrawn"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "string"
      +                  }
      +                ]
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "parsed; none_in_source (EchelonGraph read the vendor's remediation, and it lists none for this CVE, which is not a finding that no fix exists); not_parsed (EchelonGraph does not read this vendor's remediation, or has not yet read this advisory: not a finding of none); withdrawn (the vendor rescinded the advisory)."
      +          },
      +          "remediations": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "additionalProperties": {},
      +                  "properties": {
      +                    "cve_ids": {
      +                      "anyOf": [
      +                        {
      +                          "items": {
      +                            "type": "string"
      +                          },
      +                          "type": "array"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ],
      +                      "description": "The CVEs the item covers; [] for the whole advisory."
      +                    },
      +                    "fixed_build": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "kb_article": {
      +                      "description": "The KB article the item's url names, e.g. KB5055519, when vendor_text_withheld is true; absent otherwise.",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "kind": {
      +                      "anyOf": [
      +                        {
      +                          "anyOf": [
      +                            {
      +                              "enum": [
      +                                "vendor_fix",
      +                                "workaround",
      +                                "mitigation",
      +                                "no_fix_planned",
      +                                "none_available",
      +                                "other"
      +                              ],
      +                              "type": "string"
      +                            },
      +                            {
      +                              "type": "string"
      +                            }
      +                          ]
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ],
      +                      "description": "The vendor's own category: vendor_fix, workaround, mitigation, no_fix_planned, none_available or other. One exception: a Cisco vendor_fix is no_fix_planned when the advisory's Summary says, in wording EchelonGraph's parser reads, that Cisco will not release a fix, and none of its Summary, Fixed Software, Recommendations, Details or Affected Products notes says, by the parser's markers, that a fix exists; its source_category then stays vendor_fix, its source_subcategory names the note its text is from, and it carries no url. Wording the parser does not read leaves the item vendor_fix, so a Cisco vendor_fix is not a finding that a fix was released."
      +                    },
      +                    "product_count": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "product_ids": {
      +                      "anyOf": [
      +                        {
      +                          "items": {
      +                            "type": "string"
      +                          },
      +                          "type": "array"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "source_category": {
      +                      "description": "The vendor's own name for the category.",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "source_subcategory": {
      +                      "description": "MSRC's SubType, e.g. Security Update; for a Cisco no_fix_planned item, the title of the note its text is from (Summary); null elsewhere.",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "text": {
      +                      "description": "The vendor's text, verbatim but for HTML markup removed, untested by EchelonGraph; at most 2,000 characters (text_truncated, text_chars). Empty, with text_chars 0, when vendor_text_withheld is true.",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "text_chars": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "text_truncated": {
      +                      "type": [
      +                        "boolean",
      +                        "null"
      +                      ]
      +                    },
      +                    "url": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    }
      +                  },
      +                  "type": "object"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "Each remediation the vendor lists, with its kind: the vendor's own category, or it may be no_fix_planned where a Cisco advisory's summary says no fix will be released."
      +          },
      +          "severity": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "summary": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "title": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor": {
      +            "description": "The vendor's slug. Each vendor's advisory data stays under its own licence, and EchelonGraph's terms add no restriction to it: redhat, Red Hat's security advisories, © Red Hat, Inc., licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/; source https://access.redhat.com/security/data); github, the GitHub Advisory Database, licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/; source https://github.com/github/advisory-database); microsoft, Microsoft's own terms (its advisory pages are not copied: the facts and EchelonGraph's title are served, with a link to Microsoft's advisory where it names a CVE ID); every other vendor, that vendor's own terms.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_advisory_id": {
      +            "description": "The vendor's own ID for the advisory (e.g. RHSA-2024:1234, GHSA-xxxx-xxxx-xxxx, or the CVE ID for Microsoft and Palo Alto Networks). With vendor, it is the key an advisory's detail is looked up by, as its advisory_id argument.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_display_name": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_modified_at": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_published_at": {
      +            "description": "The date the vendor gives for the advisory.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_text_withheld": {
      +            "description": "true: the vendor's advisory page is not copied (Microsoft's): title is EchelonGraph's (Microsoft security update for its first CVE where it lists a vendor fix, Microsoft advisory otherwise, by its own ID when it names no CVE), and the advisory's description, summary, remediation, withdrawn_reason and each remediation's text are empty (instead, a detail's cve_records lists the first cve_records_cap CVEs it names, each with the CVE record's description or null, as cve_records says when); severity, cvss_v3_score, cvss_v3_vector, cve_ids, affected_products, the dates and the links are the vendor's facts, and, where the advisory names a CVE ID, references lead with the vendor's own advisory page.",
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "withdrawn": {
      +            "description": "true: the vendor withdrew (rescinded) this advisory, so it is a withdrawn advisory, not a current one.",
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "withdrawn_at": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "withdrawn_reason": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "data_truncated": {
      +        "description": "false: data is the answer whole. true: the structured result would pass 30,000 characters of JSON with data whole, so data is cut (DATA CUT): the entries of some of its lists keep only some of their fields, or the lists only some of their entries, truncated gives each, and no string is shortened. The same call with full: true returns data whole.",
      +        "type": "boolean"
      +      },
      +      "freshness": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "The producing radar's last completed check (last_run_at), where the API serves one."
      +      },
      +      "measured_at": {
      +        "anyOf": [
      +          {
      +            "description": "An RFC 3339 instant.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation."
      +      },
      +      "method": {
      +        "description": "How the numbers were produced.",
      +        "type": "string"
      +      },
      +      "notes": {
      +        "description": "Caveats, one sentence each.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "state": {
      +        "description": "measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.",
      +        "enum": [
      +          "measured",
      +          "not_assessed"
      +        ],
      +        "type": "string"
      +      },
      +      "truncated": {
      +        "additionalProperties": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "returned": {
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "thinned": {
      +              "const": true,
      +              "type": "boolean"
      +            },
      +            "total": {
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "total",
      +            "returned"
      +          ],
      +          "type": "object"
      +        },
      +        "description": "Present when data_truncated is true: each list of data that was cut, by its path in data (a dot between the names of an object and a list inside it), with total, its entries in the answer, returned, the entries data holds, and thinned, true when each of them keeps only some of its fields.",
      +        "propertyNames": {
      +          "type": "string"
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "state",
      +      "measured_at",
      +      "method",
      +      "coverage",
      +      "freshness",
      +      "notes",
      +      "data_truncated",
      +      "data"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "coverage": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "vendor_window": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it; where history_scope is a part of the vendor's advisories, it is where that part is held from, and the rest is held from feed_held_since), feed_held_since (the start of the window the vendor's own feed has read every one of its advisories from, which is held_since as it would be without any history read; an advisory outside history_scope published before it may not be held; null when none is held or the API does not say), history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried), history_scope (what the vendor's history read covers: all, or reviewed for GitHub, whose read covers its reviewed advisories and not its unreviewed ones, which are held only from feed_held_since; a value the API adds later as it sends it; null for a vendor with no history read, or when the API does not say), and last_success_at (the vendor's last successful poll), collection_state (whether the vendor is being collected now, by EchelonGraph's feed-state rule: ok; partial, its polls succeed but held_back of the documents it lists could not be used, the oldest since held_back_since, and those advisories, or those revisions, may not be held while the rest of its feed is; failing, it is not being collected, and what it published after failing_since, its last successful poll, may not be held, whatever the window says; disabled, this deployment runs no collector for it (its held advisories are still served), so its window ends at last_success_at; a value the API adds later as it sends it, never read as ok), failing_since, held_back and held_back_since (each null when the API does not say).",
      +                    "properties": {
      +                      "advisories": {
      +                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "collection_state": {
      +                        "description": "Whether this vendor is being collected now, by EchelonGraph's feed-state rule: ok, partial, failing or disabled. ok: it is being collected. partial: its polls succeed, but held_back of the documents it lists could not be used, the oldest since held_back_since; those advisories, or those revisions, may not be held, and the rest of its feed is. failing: it is not being collected, and an advisory it published after failing_since, its last successful poll, may not be held, whatever the window says. disabled: this deployment runs no collector for it (its held advisories are still served), so its window ends at last_success_at, and an advisory it published after that may not be held. A value the API adds later is relayed as sent and is not read as ok. null when the API does not say.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "earliest_vendor_published_at": {
      +                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "failing_since": {
      +                        "description": "While collection_state is failing, this vendor's last successful poll: an advisory it published after it may not be held, whatever the window says. null when it is not failing, when no successful poll is on record, or when the API does not say.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "feed_held_since": {
      +                        "description": "The start of the window this vendor's own feed has read every one of its advisories from: held_since as it would be without any history read, and equal to it for a vendor with no history read. Where history_scope is a part of the vendor's advisories (reviewed: GitHub's history read covers its reviewed advisories only), an advisory outside it published before feed_held_since may not be held, however early held_since is. null when none is held or the API does not say.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "held_back": {
      +                        "description": "How many of the documents this vendor lists EchelonGraph could not use (collection_state partial): those advisories, or those revisions, may not be held. 0 when none is held back; null when the API does not say.",
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "held_back_since": {
      +                        "description": "When the oldest held-back document first failed; null when none is held back or the API does not say.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "held_since": {
      +                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older. Where history_scope is a part of the vendor's advisories (reviewed), it is where that part is held from; the rest is held from feed_held_since.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "history_backfill": {
      +                        "anyOf": [
      +                          {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "complete",
      +                                  "complete_reviewed_only",
      +                                  "in_progress",
      +                                  "not_started",
      +                                  "not_supported"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "string"
      +                              }
      +                            ]
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      +                      },
      +                      "history_scope": {
      +                        "description": "What this vendor's history read covers: all (every advisory its archive publishes) or reviewed (GitHub: its reviewed advisories, not its unreviewed ones, which are held only from feed_held_since); a value the API adds later as it sends it. null for a vendor with no history read, or when the API does not say.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "last_success_at": {
      +                        "description": "This vendor's last successful poll; null when none is on record or the API does not say. While collection_state is disabled, the window ends here.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "latest_vendor_published_at": {
      +                        "description": "The latest vendor_published_at among them; null when none is held.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "vendor": {
      +                        "description": "The vendor slug.",
      +                        "type": "string"
      +                      },
      +                      "vendor_display_name": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      }
      +                    },
      +                    "required": [
      +                      "vendor",
      +                      "vendor_display_name",
      +                      "advisories",
      +                      "earliest_vendor_published_at",
      +                      "latest_vendor_published_at",
      +                      "held_since",
      +                      "feed_held_since",
      +                      "history_backfill",
      +                      "history_scope",
      +                      "last_success_at",
      +                      "collection_state",
      +                      "failing_since",
      +                      "held_back",
      +                      "held_back_since"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      +              }
      +            },
      +            "required": [
      +              "vendor_window"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "error": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "kind": {
      +            "description": "What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.",
      +            "enum": [
      +              "network",
      +              "timeout",
      +              "http",
      +              "not_json",
      +              "not_object",
      +              "invalid_input",
      +              "internal",
      +              "unexpected_shape",
      +              "radars"
      +            ],
      +            "type": "string"
      +          },
      +          "message": {
      +            "description": "The cause: the API's own message, or what went wrong.",
      +            "type": "string"
      +          },
      +          "path": {
      +            "description": "The API path requested, when a request was made.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "status": {
      +            "anyOf": [
      +              {
      +                "maximum": 9007199254740991,
      +                "minimum": -9007199254740991,
      +                "type": "integer"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The HTTP status, when the API answered one; 503 with kind internal and path null where this server was too busy to make the call."
      +          }
      +        },
      +        "required": [
      +          "kind",
      +          "path",
      +          "status",
      +          "message"
      +        ],
      +        "type": "object"
      +      },
      +      "freshness": {
      +        "type": "null"
      +      },
      +      "measured_at": {
      +        "type": "null"
      +      },
      +      "method": {
      +        "type": "null"
      +      },
      +      "notes": {
      +        "description": "Caveats, one sentence each.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "state": {
      +        "description": "failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.",
      +        "enum": [
      +          "failed",
      +          "invalid_input"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "state",
      +      "measured_at",
      +      "method",
      +      "coverage",
      +      "freshness",
      +      "notes",
      +      "error"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. Changed1 schema field changed
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "coverage": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "properties": {
      -              "vendor_window": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": {},
      -                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it; where history_scope is a part of the vendor's advisories, it is where that part is held from, and the rest is held from feed_held_since), feed_held_since (the start of the window the vendor's own feed has read every one of its advisories from, which is held_since as it would be without any history read; an advisory outside history_scope published before it may not be held; null when none is held or the API does not say), history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried) and history_scope (what the vendor's history read covers: all, or reviewed for GitHub, whose read covers its reviewed advisories and not its unreviewed ones, which are held only from feed_held_since; a value the API adds later as it sends it; null for a vendor with no history read, or when the API does not say).",
      -                    "properties": {
      -                      "advisories": {
      -                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      -                        "type": [
      -                          "number",
      -                          "null"
      -                        ]
      -                      },
      -                      "earliest_vendor_published_at": {
      -                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "feed_held_since": {
      -                        "description": "The start of the window this vendor's own feed has read every one of its advisories from: held_since as it would be without any history read, and equal to it for a vendor with no history read. Where history_scope is a part of the vendor's advisories (reviewed: GitHub's history read covers its reviewed advisories only), an advisory outside it published before feed_held_since may not be held, however early held_since is. null when none is held or the API does not say.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "held_since": {
      -                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older. Where history_scope is a part of the vendor's advisories (reviewed), it is where that part is held from; the rest is held from feed_held_since.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "history_backfill": {
      -                        "anyOf": [
      -                          {
      -                            "anyOf": [
      -                              {
      -                                "enum": [
      -                                  "complete",
      -                                  "complete_reviewed_only",
      -                                  "in_progress",
      -                                  "not_started",
      -                                  "not_supported"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              {
      -                                "type": "string"
      -                              }
      -                            ]
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      -                      },
      -                      "history_scope": {
      -                        "description": "What this vendor's history read covers: all (every advisory its archive publishes) or reviewed (GitHub: its reviewed advisories, not its unreviewed ones, which are held only from feed_held_since); a value the API adds later as it sends it. null for a vendor with no history read, or when the API does not say.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "latest_vendor_published_at": {
      -                        "description": "The latest vendor_published_at among them; null when none is held.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "vendor": {
      -                        "description": "The vendor slug.",
      -                        "type": "string"
      -                      },
      -                      "vendor_display_name": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      }
      -                    },
      -                    "required": [
      -                      "vendor",
      -                      "vendor_display_name",
      -                      "advisories",
      -                      "earliest_vendor_published_at",
      -                      "latest_vendor_published_at",
      -                      "held_since",
      -                      "feed_held_since",
      -                      "history_backfill",
      -                      "history_scope"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      -              }
      -            },
      -            "required": [
      -              "vendor_window"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "What the answer covers; null where the answer says nothing about it."
      -      },
      -      "data": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "advisory_id": {
      -            "description": "EchelonGraph's internal ID for this advisory, a UUID. It is not the vendor's advisory ID (vendor_advisory_id), and an advisory's detail is not looked up by it: the detail is keyed on vendor and vendor_advisory_id.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "affected_products": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "cvss_v3_score": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "description": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "known_cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The CVE IDs of cve_ids that have a record in EchelonGraph's CVE feed."
      -          },
      -          "our_first_seen_at": {
      -            "description": "When EchelonGraph first recorded the advisory; not the vendor's date.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "references": {},
      -          "rejected_cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The CVE IDs this advisory names whose CVE record was rejected (withdrawn) by its numbering authority: each is a rejected record, not an active vulnerability, whatever the advisory's text says. The vendor's withdrawn is separate and unchanged by it. [] when none is; null when that could not be checked."
      -          },
      -          "remediation": {
      -            "description": "The vendor's remediation as one text (the legacy field), beside remediations.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "remediation_items_not_stored": {
      -            "description": "Items past the 64 stored per advisory.",
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "remediation_kinds": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "vendor_fix",
      -                        "workaround",
      -                        "mitigation",
      -                        "no_fix_planned",
      -                        "none_available",
      -                        "other"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "string"
      -                    }
      -                  ]
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The kinds of remediation the advisory lists (for the CVE asked about, on a by-cve row), each the vendor's own category, never read from the text: vendor_fix, workaround, mitigation, no_fix_planned, none_available or other. [] with remediation_state not_parsed is not a finding that it lists none."
      -          },
      -          "remediation_state": {
      -            "anyOf": [
      -              {
      -                "anyOf": [
      -                  {
      -                    "enum": [
      -                      "parsed",
      -                      "none_in_source",
      -                      "not_parsed",
      -                      "withdrawn"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "string"
      -                  }
      -                ]
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "parsed; none_in_source (EchelonGraph read the vendor's remediation, and it lists none for this CVE, which is not a finding that no fix exists); not_parsed (EchelonGraph does not read this vendor's remediation, or has not yet read this advisory: not a finding of none); withdrawn (the vendor rescinded the advisory)."
      -          },
      -          "remediations": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "additionalProperties": {},
      -                  "properties": {
      -                    "cve_ids": {
      -                      "anyOf": [
      -                        {
      -                          "items": {
      -                            "type": "string"
      -                          },
      -                          "type": "array"
      -                        },
      -                        {
      -                          "type": "null"
      -                        }
      -                      ],
      -                      "description": "The CVEs the item covers; [] for the whole advisory."
      -                    },
      -                    "fixed_build": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "kind": {
      -                      "anyOf": [
      -                        {
      -                          "anyOf": [
      -                            {
      -                              "enum": [
      -                                "vendor_fix",
      -                                "workaround",
      -                                "mitigation",
      -                                "no_fix_planned",
      -                                "none_available",
      -                                "other"
      -                              ],
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "string"
      -                            }
      -                          ]
      -                        },
      -                        {
      -                          "type": "null"
      -                        }
      -                      ]
      -                    },
      -                    "product_count": {
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "product_ids": {
      -                      "anyOf": [
      -                        {
      -                          "items": {
      -                            "type": "string"
      -                          },
      -                          "type": "array"
      -                        },
      -                        {
      -                          "type": "null"
      -                        }
      -                      ]
      -                    },
      -                    "source_category": {
      -                      "description": "The vendor's own name for the category.",
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "source_subcategory": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "text": {
      -                      "description": "The vendor's text, verbatim but for HTML markup removed, untested by EchelonGraph; at most 2,000 characters (text_truncated, text_chars).",
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "text_chars": {
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "text_truncated": {
      -                      "type": [
      -                        "boolean",
      -                        "null"
      -                      ]
      -                    },
      -                    "url": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    }
      -                  },
      -                  "type": "object"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "Each remediation the vendor lists, with its kind, the vendor's own category."
      -          },
      -          "severity": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "summary": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "title": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_advisory_id": {
      -            "description": "The vendor's own ID for the advisory (e.g. RHSA-2024:1234, GHSA-xxxx-xxxx-xxxx, or the CVE ID for Microsoft and Palo Alto Networks). With vendor, it is the key an advisory's detail is looked up by, as its advisory_id argument.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_display_name": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_modified_at": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_published_at": {
      -            "description": "The date the vendor gives for the advisory.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "withdrawn": {
      -            "description": "true: the vendor withdrew (rescinded) this advisory, so it is a withdrawn advisory, not a current one.",
      -            "type": [
      -              "boolean",
      -              "null"
      -            ]
      -          },
      -          "withdrawn_at": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "withdrawn_reason": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "data_truncated": {
      -        "description": "false: data is the answer whole. true: the structured result would pass 30,000 characters of JSON with data whole, so data is cut (DATA CUT): the entries of some of its lists keep only some of their fields, or the lists only some of their entries, truncated gives each, and no string is shortened. The same call with full: true returns data whole.",
      -        "type": "boolean"
      -      },
      -      "freshness": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "The producing radar's last completed check (last_run_at), where the API serves one."
      -      },
      -      "measured_at": {
      -        "anyOf": [
      -          {
      -            "description": "An RFC 3339 instant.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation."
      -      },
      -      "method": {
      -        "description": "How the numbers were produced.",
      -        "type": "string"
      -      },
      -      "notes": {
      -        "description": "Caveats, one sentence each.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "state": {
      -        "description": "measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.",
      -        "enum": [
      -          "measured",
      -          "not_assessed"
      -        ],
      -        "type": "string"
      -      },
      -      "truncated": {
      -        "additionalProperties": {
      -          "additionalProperties": {},
      -          "properties": {
      -            "returned": {
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            },
      -            "thinned": {
      -              "const": true,
      -              "type": "boolean"
      -            },
      -            "total": {
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            }
      -          },
      -          "required": [
      -            "total",
      -            "returned"
      -          ],
      -          "type": "object"
      -        },
      -        "description": "Present when data_truncated is true: each list of data that was cut, by its path in data (a dot between the names of an object and a list inside it), with total, its entries in the answer, returned, the entries data holds, and thinned, true when each of them keeps only some of its fields.",
      -        "propertyNames": {
      -          "type": "string"
      -        },
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "state",
      -      "measured_at",
      -      "method",
      -      "coverage",
      -      "freshness",
      -      "notes",
      -      "data_truncated",
      -      "data"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "coverage": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "vendor_window": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": false,
      -                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it; where history_scope is a part of the vendor's advisories, it is where that part is held from, and the rest is held from feed_held_since), feed_held_since (the start of the window the vendor's own feed has read every one of its advisories from, which is held_since as it would be without any history read; an advisory outside history_scope published before it may not be held; null when none is held or the API does not say), history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried) and history_scope (what the vendor's history read covers: all, or reviewed for GitHub, whose read covers its reviewed advisories and not its unreviewed ones, which are held only from feed_held_since; a value the API adds later as it sends it; null for a vendor with no history read, or when the API does not say).",
      -                    "properties": {
      -                      "advisories": {
      -                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      -                        "type": [
      -                          "number",
      -                          "null"
      -                        ]
      -                      },
      -                      "earliest_vendor_published_at": {
      -                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "feed_held_since": {
      -                        "description": "The start of the window this vendor's own feed has read every one of its advisories from: held_since as it would be without any history read, and equal to it for a vendor with no history read. Where history_scope is a part of the vendor's advisories (reviewed: GitHub's history read covers its reviewed advisories only), an advisory outside it published before feed_held_since may not be held, however early held_since is. null when none is held or the API does not say.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "held_since": {
      -                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older. Where history_scope is a part of the vendor's advisories (reviewed), it is where that part is held from; the rest is held from feed_held_since.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "history_backfill": {
      -                        "anyOf": [
      -                          {
      -                            "anyOf": [
      -                              {
      -                                "enum": [
      -                                  "complete",
      -                                  "complete_reviewed_only",
      -                                  "in_progress",
      -                                  "not_started",
      -                                  "not_supported"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              {
      -                                "type": "string"
      -                              }
      -                            ]
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      -                      },
      -                      "history_scope": {
      -                        "description": "What this vendor's history read covers: all (every advisory its archive publishes) or reviewed (GitHub: its reviewed advisories, not its unreviewed ones, which are held only from feed_held_since); a value the API adds later as it sends it. null for a vendor with no history read, or when the API does not say.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "latest_vendor_published_at": {
      -                        "description": "The latest vendor_published_at among them; null when none is held.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "vendor": {
      -                        "description": "The vendor slug.",
      -                        "type": "string"
      -                      },
      -                      "vendor_display_name": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      }
      -                    },
      -                    "required": [
      -                      "vendor",
      -                      "vendor_display_name",
      -                      "advisories",
      -                      "earliest_vendor_published_at",
      -                      "latest_vendor_published_at",
      -                      "held_since",
      -                      "feed_held_since",
      -                      "history_backfill",
      -                      "history_scope"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      -              }
      -            },
      -            "required": [
      -              "vendor_window"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "error": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "kind": {
      -            "description": "What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.",
      -            "enum": [
      -              "network",
      -              "timeout",
      -              "http",
      -              "not_json",
      -              "not_object",
      -              "invalid_input",
      -              "internal",
      -              "unexpected_shape",
      -              "radars"
      -            ],
      -            "type": "string"
      -          },
      -          "message": {
      -            "description": "The cause: the API's own message, or what went wrong.",
      -            "type": "string"
      -          },
      -          "path": {
      -            "description": "The API path requested, when a request was made.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "status": {
      -            "anyOf": [
      -              {
      -                "maximum": 9007199254740991,
      -                "minimum": -9007199254740991,
      -                "type": "integer"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The HTTP status, when the API answered one."
      -          }
      -        },
      -        "required": [
      -          "kind",
      -          "path",
      -          "status",
      -          "message"
      -        ],
      -        "type": "object"
      -      },
      -      "freshness": {
      -        "type": "null"
      -      },
      -      "measured_at": {
      -        "type": "null"
      -      },
      -      "method": {
      -        "type": "null"
      -      },
      -      "notes": {
      -        "description": "Caveats, one sentence each.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "state": {
      -        "description": "failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.",
      -        "enum": [
      -          "failed",
      -          "invalid_input"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "state",
      -      "measured_at",
      -      "method",
      -      "coverage",
      -      "freshness",
      -      "notes",
      -      "error"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "coverage": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "properties": {
      +              "vendor_window": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": {},
      +                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it; where history_scope is a part of the vendor's advisories, it is where that part is held from, and the rest is held from feed_held_since), feed_held_since (the start of the window the vendor's own feed has read every one of its advisories from, which is held_since as it would be without any history read; an advisory outside history_scope published before it may not be held; null when none is held or the API does not say), history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried) and history_scope (what the vendor's history read covers: all, or reviewed for GitHub, whose read covers its reviewed advisories and not its unreviewed ones, which are held only from feed_held_since; a value the API adds later as it sends it; null for a vendor with no history read, or when the API does not say).",
      +                    "properties": {
      +                      "advisories": {
      +                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "earliest_vendor_published_at": {
      +                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "feed_held_since": {
      +                        "description": "The start of the window this vendor's own feed has read every one of its advisories from: held_since as it would be without any history read, and equal to it for a vendor with no history read. Where history_scope is a part of the vendor's advisories (reviewed: GitHub's history read covers its reviewed advisories only), an advisory outside it published before feed_held_since may not be held, however early held_since is. null when none is held or the API does not say.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "held_since": {
      +                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older. Where history_scope is a part of the vendor's advisories (reviewed), it is where that part is held from; the rest is held from feed_held_since.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "history_backfill": {
      +                        "anyOf": [
      +                          {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "complete",
      +                                  "complete_reviewed_only",
      +                                  "in_progress",
      +                                  "not_started",
      +                                  "not_supported"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "string"
      +                              }
      +                            ]
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      +                      },
      +                      "history_scope": {
      +                        "description": "What this vendor's history read covers: all (every advisory its archive publishes) or reviewed (GitHub: its reviewed advisories, not its unreviewed ones, which are held only from feed_held_since); a value the API adds later as it sends it. null for a vendor with no history read, or when the API does not say.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "latest_vendor_published_at": {
      +                        "description": "The latest vendor_published_at among them; null when none is held.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "vendor": {
      +                        "description": "The vendor slug.",
      +                        "type": "string"
      +                      },
      +                      "vendor_display_name": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      }
      +                    },
      +                    "required": [
      +                      "vendor",
      +                      "vendor_display_name",
      +                      "advisories",
      +                      "earliest_vendor_published_at",
      +                      "latest_vendor_published_at",
      +                      "held_since",
      +                      "feed_held_since",
      +                      "history_backfill",
      +                      "history_scope"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      +              }
      +            },
      +            "required": [
      +              "vendor_window"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "What the answer covers; null where the answer says nothing about it."
      +      },
      +      "data": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "advisory_id": {
      +            "description": "EchelonGraph's internal ID for this advisory, a UUID. It is not the vendor's advisory ID (vendor_advisory_id), and an advisory's detail is not looked up by it: the detail is keyed on vendor and vendor_advisory_id.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "affected_products": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "cvss_v3_score": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "description": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "known_cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The CVE IDs of cve_ids that have a record in EchelonGraph's CVE feed."
      +          },
      +          "our_first_seen_at": {
      +            "description": "When EchelonGraph first recorded the advisory; not the vendor's date.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "references": {},
      +          "rejected_cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The CVE IDs this advisory names whose CVE record was rejected (withdrawn) by its numbering authority: each is a rejected record, not an active vulnerability, whatever the advisory's text says. The vendor's withdrawn is separate and unchanged by it. [] when none is; null when that could not be checked."
      +          },
      +          "remediation": {
      +            "description": "The vendor's remediation as one text (the legacy field), beside remediations.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "remediation_items_not_stored": {
      +            "description": "Items past the 64 stored per advisory.",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "remediation_kinds": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "vendor_fix",
      +                        "workaround",
      +                        "mitigation",
      +                        "no_fix_planned",
      +                        "none_available",
      +                        "other"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "string"
      +                    }
      +                  ]
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The kinds of remediation the advisory lists (for the CVE asked about, on a by-cve row), each the vendor's own category, never read from the text: vendor_fix, workaround, mitigation, no_fix_planned, none_available or other. [] with remediation_state not_parsed is not a finding that it lists none."
      +          },
      +          "remediation_state": {
      +            "anyOf": [
      +              {
      +                "anyOf": [
      +                  {
      +                    "enum": [
      +                      "parsed",
      +                      "none_in_source",
      +                      "not_parsed",
      +                      "withdrawn"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "string"
      +                  }
      +                ]
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "parsed; none_in_source (EchelonGraph read the vendor's remediation, and it lists none for this CVE, which is not a finding that no fix exists); not_parsed (EchelonGraph does not read this vendor's remediation, or has not yet read this advisory: not a finding of none); withdrawn (the vendor rescinded the advisory)."
      +          },
      +          "remediations": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "additionalProperties": {},
      +                  "properties": {
      +                    "cve_ids": {
      +                      "anyOf": [
      +                        {
      +                          "items": {
      +                            "type": "string"
      +                          },
      +                          "type": "array"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ],
      +                      "description": "The CVEs the item covers; [] for the whole advisory."
      +                    },
      +                    "fixed_build": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "kind": {
      +                      "anyOf": [
      +                        {
      +                          "anyOf": [
      +                            {
      +                              "enum": [
      +                                "vendor_fix",
      +                                "workaround",
      +                                "mitigation",
      +                                "no_fix_planned",
      +                                "none_available",
      +                                "other"
      +                              ],
      +                              "type": "string"
      +                            },
      +                            {
      +                              "type": "string"
      +                            }
      +                          ]
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "product_count": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "product_ids": {
      +                      "anyOf": [
      +                        {
      +                          "items": {
      +                            "type": "string"
      +                          },
      +                          "type": "array"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "source_category": {
      +                      "description": "The vendor's own name for the category.",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "source_subcategory": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "text": {
      +                      "description": "The vendor's text, verbatim but for HTML markup removed, untested by EchelonGraph; at most 2,000 characters (text_truncated, text_chars).",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "text_chars": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "text_truncated": {
      +                      "type": [
      +                        "boolean",
      +                        "null"
      +                      ]
      +                    },
      +                    "url": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    }
      +                  },
      +                  "type": "object"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "Each remediation the vendor lists, with its kind, the vendor's own category."
      +          },
      +          "severity": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "summary": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "title": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_advisory_id": {
      +            "description": "The vendor's own ID for the advisory (e.g. RHSA-2024:1234, GHSA-xxxx-xxxx-xxxx, or the CVE ID for Microsoft and Palo Alto Networks). With vendor, it is the key an advisory's detail is looked up by, as its advisory_id argument.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_display_name": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_modified_at": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_published_at": {
      +            "description": "The date the vendor gives for the advisory.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "withdrawn": {
      +            "description": "true: the vendor withdrew (rescinded) this advisory, so it is a withdrawn advisory, not a current one.",
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "withdrawn_at": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "withdrawn_reason": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "data_truncated": {
      +        "description": "false: data is the answer whole. true: the structured result would pass 30,000 characters of JSON with data whole, so data is cut (DATA CUT): the entries of some of its lists keep only some of their fields, or the lists only some of their entries, truncated gives each, and no string is shortened. The same call with full: true returns data whole.",
      +        "type": "boolean"
      +      },
      +      "freshness": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "The producing radar's last completed check (last_run_at), where the API serves one."
      +      },
      +      "measured_at": {
      +        "anyOf": [
      +          {
      +            "description": "An RFC 3339 instant.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation."
      +      },
      +      "method": {
      +        "description": "How the numbers were produced.",
      +        "type": "string"
      +      },
      +      "notes": {
      +        "description": "Caveats, one sentence each.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "state": {
      +        "description": "measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.",
      +        "enum": [
      +          "measured",
      +          "not_assessed"
      +        ],
      +        "type": "string"
      +      },
      +      "truncated": {
      +        "additionalProperties": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "returned": {
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "thinned": {
      +              "const": true,
      +              "type": "boolean"
      +            },
      +            "total": {
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "total",
      +            "returned"
      +          ],
      +          "type": "object"
      +        },
      +        "description": "Present when data_truncated is true: each list of data that was cut, by its path in data (a dot between the names of an object and a list inside it), with total, its entries in the answer, returned, the entries data holds, and thinned, true when each of them keeps only some of its fields.",
      +        "propertyNames": {
      +          "type": "string"
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "state",
      +      "measured_at",
      +      "method",
      +      "coverage",
      +      "freshness",
      +      "notes",
      +      "data_truncated",
      +      "data"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "coverage": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "vendor_window": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it; where history_scope is a part of the vendor's advisories, it is where that part is held from, and the rest is held from feed_held_since), feed_held_since (the start of the window the vendor's own feed has read every one of its advisories from, which is held_since as it would be without any history read; an advisory outside history_scope published before it may not be held; null when none is held or the API does not say), history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried) and history_scope (what the vendor's history read covers: all, or reviewed for GitHub, whose read covers its reviewed advisories and not its unreviewed ones, which are held only from feed_held_since; a value the API adds later as it sends it; null for a vendor with no history read, or when the API does not say).",
      +                    "properties": {
      +                      "advisories": {
      +                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "earliest_vendor_published_at": {
      +                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "feed_held_since": {
      +                        "description": "The start of the window this vendor's own feed has read every one of its advisories from: held_since as it would be without any history read, and equal to it for a vendor with no history read. Where history_scope is a part of the vendor's advisories (reviewed: GitHub's history read covers its reviewed advisories only), an advisory outside it published before feed_held_since may not be held, however early held_since is. null when none is held or the API does not say.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "held_since": {
      +                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older. Where history_scope is a part of the vendor's advisories (reviewed), it is where that part is held from; the rest is held from feed_held_since.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "history_backfill": {
      +                        "anyOf": [
      +                          {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "complete",
      +                                  "complete_reviewed_only",
      +                                  "in_progress",
      +                                  "not_started",
      +                                  "not_supported"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "string"
      +                              }
      +                            ]
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      +                      },
      +                      "history_scope": {
      +                        "description": "What this vendor's history read covers: all (every advisory its archive publishes) or reviewed (GitHub: its reviewed advisories, not its unreviewed ones, which are held only from feed_held_since); a value the API adds later as it sends it. null for a vendor with no history read, or when the API does not say.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "latest_vendor_published_at": {
      +                        "description": "The latest vendor_published_at among them; null when none is held.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "vendor": {
      +                        "description": "The vendor slug.",
      +                        "type": "string"
      +                      },
      +                      "vendor_display_name": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      }
      +                    },
      +                    "required": [
      +                      "vendor",
      +                      "vendor_display_name",
      +                      "advisories",
      +                      "earliest_vendor_published_at",
      +                      "latest_vendor_published_at",
      +                      "held_since",
      +                      "feed_held_since",
      +                      "history_backfill",
      +                      "history_scope"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      +              }
      +            },
      +            "required": [
      +              "vendor_window"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "error": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "kind": {
      +            "description": "What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.",
      +            "enum": [
      +              "network",
      +              "timeout",
      +              "http",
      +              "not_json",
      +              "not_object",
      +              "invalid_input",
      +              "internal",
      +              "unexpected_shape",
      +              "radars"
      +            ],
      +            "type": "string"
      +          },
      +          "message": {
      +            "description": "The cause: the API's own message, or what went wrong.",
      +            "type": "string"
      +          },
      +          "path": {
      +            "description": "The API path requested, when a request was made.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "status": {
      +            "anyOf": [
      +              {
      +                "maximum": 9007199254740991,
      +                "minimum": -9007199254740991,
      +                "type": "integer"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The HTTP status, when the API answered one; 503 with kind internal and path null where this server was too busy to make the call."
      +          }
      +        },
      +        "required": [
      +          "kind",
      +          "path",
      +          "status",
      +          "message"
      +        ],
      +        "type": "object"
      +      },
      +      "freshness": {
      +        "type": "null"
      +      },
      +      "measured_at": {
      +        "type": "null"
      +      },
      +      "method": {
      +        "type": "null"
      +      },
      +      "notes": {
      +        "description": "Caveats, one sentence each.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "state": {
      +        "description": "failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.",
      +        "enum": [
      +          "failed",
      +          "invalid_input"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "state",
      +      "measured_at",
      +      "method",
      +      "coverage",
      +      "freshness",
      +      "notes",
      +      "error"
      +    ],
      +    "type": "object"
      +  }
      +]
  3. Changed1 schema field changed
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "coverage": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "properties": {
      -              "vendor_window": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": {},
      -                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it) and history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried).",
      -                    "properties": {
      -                      "advisories": {
      -                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      -                        "type": [
      -                          "number",
      -                          "null"
      -                        ]
      -                      },
      -                      "earliest_vendor_published_at": {
      -                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "held_since": {
      -                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "history_backfill": {
      -                        "anyOf": [
      -                          {
      -                            "anyOf": [
      -                              {
      -                                "enum": [
      -                                  "complete",
      -                                  "in_progress",
      -                                  "not_started",
      -                                  "not_supported"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              {
      -                                "type": "string"
      -                              }
      -                            ]
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      -                      },
      -                      "latest_vendor_published_at": {
      -                        "description": "The latest vendor_published_at among them; null when none is held.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "vendor": {
      -                        "description": "The vendor slug.",
      -                        "type": "string"
      -                      },
      -                      "vendor_display_name": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      }
      -                    },
      -                    "required": [
      -                      "vendor",
      -                      "vendor_display_name",
      -                      "advisories",
      -                      "earliest_vendor_published_at",
      -                      "latest_vendor_published_at",
      -                      "held_since",
      -                      "history_backfill"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      -              }
      -            },
      -            "required": [
      -              "vendor_window"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "What the answer covers; null where the answer says nothing about it."
      -      },
      -      "data": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "advisory_id": {
      -            "description": "EchelonGraph's internal ID for this advisory, a UUID. It is not the vendor's advisory ID (vendor_advisory_id), and an advisory's detail is not looked up by it: the detail is keyed on vendor and vendor_advisory_id.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "affected_products": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "cvss_v3_score": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "description": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "known_cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The CVE IDs of cve_ids that have a record in EchelonGraph's CVE feed."
      -          },
      -          "our_first_seen_at": {
      -            "description": "When EchelonGraph first recorded the advisory; not the vendor's date.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "references": {},
      -          "rejected_cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The CVE IDs this advisory names whose CVE record was rejected (withdrawn) by its numbering authority: each is a rejected record, not an active vulnerability, whatever the advisory's text says. The vendor's withdrawn is separate and unchanged by it. [] when none is; null when that could not be checked."
      -          },
      -          "remediation": {
      -            "description": "The vendor's remediation as one text (the legacy field), beside remediations.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "remediation_items_not_stored": {
      -            "description": "Items past the 64 stored per advisory.",
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "remediation_kinds": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "vendor_fix",
      -                        "workaround",
      -                        "mitigation",
      -                        "no_fix_planned",
      -                        "none_available",
      -                        "other"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "string"
      -                    }
      -                  ]
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The kinds of remediation the advisory lists (for the CVE asked about, on a by-cve row), each the vendor's own category, never read from the text: vendor_fix, workaround, mitigation, no_fix_planned, none_available or other. [] with remediation_state not_parsed is not a finding that it lists none."
      -          },
      -          "remediation_state": {
      -            "anyOf": [
      -              {
      -                "anyOf": [
      -                  {
      -                    "enum": [
      -                      "parsed",
      -                      "none_in_source",
      -                      "not_parsed",
      -                      "withdrawn"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "string"
      -                  }
      -                ]
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "parsed; none_in_source (EchelonGraph read the vendor's remediation, and it lists none for this CVE, which is not a finding that no fix exists); not_parsed (EchelonGraph does not read this vendor's remediation, or has not yet read this advisory: not a finding of none); withdrawn (the vendor rescinded the advisory)."
      -          },
      -          "remediations": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "additionalProperties": {},
      -                  "properties": {
      -                    "cve_ids": {
      -                      "anyOf": [
      -                        {
      -                          "items": {
      -                            "type": "string"
      -                          },
      -                          "type": "array"
      -                        },
      -                        {
      -                          "type": "null"
      -                        }
      -                      ],
      -                      "description": "The CVEs the item covers; [] for the whole advisory."
      -                    },
      -                    "fixed_build": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "kind": {
      -                      "anyOf": [
      -                        {
      -                          "anyOf": [
      -                            {
      -                              "enum": [
      -                                "vendor_fix",
      -                                "workaround",
      -                                "mitigation",
      -                                "no_fix_planned",
      -                                "none_available",
      -                                "other"
      -                              ],
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "string"
      -                            }
      -                          ]
      -                        },
      -                        {
      -                          "type": "null"
      -                        }
      -                      ]
      -                    },
      -                    "product_count": {
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "product_ids": {
      -                      "anyOf": [
      -                        {
      -                          "items": {
      -                            "type": "string"
      -                          },
      -                          "type": "array"
      -                        },
      -                        {
      -                          "type": "null"
      -                        }
      -                      ]
      -                    },
      -                    "source_category": {
      -                      "description": "The vendor's own name for the category.",
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "source_subcategory": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "text": {
      -                      "description": "The vendor's text, verbatim but for HTML markup removed, untested by EchelonGraph; at most 2,000 characters (text_truncated, text_chars).",
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "text_chars": {
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "text_truncated": {
      -                      "type": [
      -                        "boolean",
      -                        "null"
      -                      ]
      -                    },
      -                    "url": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    }
      -                  },
      -                  "type": "object"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "Each remediation the vendor lists, with its kind, the vendor's own category."
      -          },
      -          "severity": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "summary": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "title": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_advisory_id": {
      -            "description": "The vendor's own ID for the advisory (e.g. RHSA-2024:1234, GHSA-xxxx-xxxx-xxxx, or the CVE ID for Microsoft and Palo Alto Networks). With vendor, it is the key an advisory's detail is looked up by, as its advisory_id argument.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_display_name": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_modified_at": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_published_at": {
      -            "description": "The date the vendor gives for the advisory.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "withdrawn": {
      -            "description": "true: the vendor withdrew (rescinded) this advisory, so it is a withdrawn advisory, not a current one.",
      -            "type": [
      -              "boolean",
      -              "null"
      -            ]
      -          },
      -          "withdrawn_at": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "withdrawn_reason": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "data_truncated": {
      -        "description": "false: data is the answer whole. true: the structured result would pass 30,000 characters of JSON with data whole, so data is cut (DATA CUT): the entries of some of its lists keep only some of their fields, or the lists only some of their entries, truncated gives each, and no string is shortened. The same call with full: true returns data whole.",
      -        "type": "boolean"
      -      },
      -      "freshness": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "The producing radar's last completed check (last_run_at), where the API serves one."
      -      },
      -      "measured_at": {
      -        "anyOf": [
      -          {
      -            "description": "An RFC 3339 instant.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation."
      -      },
      -      "method": {
      -        "description": "How the numbers were produced.",
      -        "type": "string"
      -      },
      -      "notes": {
      -        "description": "Caveats, one sentence each.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "state": {
      -        "description": "measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.",
      -        "enum": [
      -          "measured",
      -          "not_assessed"
      -        ],
      -        "type": "string"
      -      },
      -      "truncated": {
      -        "additionalProperties": {
      -          "additionalProperties": {},
      -          "properties": {
      -            "returned": {
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            },
      -            "thinned": {
      -              "const": true,
      -              "type": "boolean"
      -            },
      -            "total": {
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            }
      -          },
      -          "required": [
      -            "total",
      -            "returned"
      -          ],
      -          "type": "object"
      -        },
      -        "description": "Present when data_truncated is true: each list of data that was cut, by its path in data (a dot between the names of an object and a list inside it), with total, its entries in the answer, returned, the entries data holds, and thinned, true when each of them keeps only some of its fields.",
      -        "propertyNames": {
      -          "type": "string"
      -        },
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "state",
      -      "measured_at",
      -      "method",
      -      "coverage",
      -      "freshness",
      -      "notes",
      -      "data_truncated",
      -      "data"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "coverage": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "vendor_window": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": false,
      -                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it) and history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried).",
      -                    "properties": {
      -                      "advisories": {
      -                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      -                        "type": [
      -                          "number",
      -                          "null"
      -                        ]
      -                      },
      -                      "earliest_vendor_published_at": {
      -                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "held_since": {
      -                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "history_backfill": {
      -                        "anyOf": [
      -                          {
      -                            "anyOf": [
      -                              {
      -                                "enum": [
      -                                  "complete",
      -                                  "in_progress",
      -                                  "not_started",
      -                                  "not_supported"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              {
      -                                "type": "string"
      -                              }
      -                            ]
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      -                      },
      -                      "latest_vendor_published_at": {
      -                        "description": "The latest vendor_published_at among them; null when none is held.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "vendor": {
      -                        "description": "The vendor slug.",
      -                        "type": "string"
      -                      },
      -                      "vendor_display_name": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      }
      -                    },
      -                    "required": [
      -                      "vendor",
      -                      "vendor_display_name",
      -                      "advisories",
      -                      "earliest_vendor_published_at",
      -                      "latest_vendor_published_at",
      -                      "held_since",
      -                      "history_backfill"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      -              }
      -            },
      -            "required": [
      -              "vendor_window"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "error": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "kind": {
      -            "description": "What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.",
      -            "enum": [
      -              "network",
      -              "timeout",
      -              "http",
      -              "not_json",
      -              "not_object",
      -              "invalid_input",
      -              "internal",
      -              "unexpected_shape",
      -              "radars"
      -            ],
      -            "type": "string"
      -          },
      -          "message": {
      -            "description": "The cause: the API's own message, or what went wrong.",
      -            "type": "string"
      -          },
      -          "path": {
      -            "description": "The API path requested, when a request was made.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "status": {
      -            "anyOf": [
      -              {
      -                "maximum": 9007199254740991,
      -                "minimum": -9007199254740991,
      -                "type": "integer"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The HTTP status, when the API answered one."
      -          }
      -        },
      -        "required": [
      -          "kind",
      -          "path",
      -          "status",
      -          "message"
      -        ],
      -        "type": "object"
      -      },
      -      "freshness": {
      -        "type": "null"
      -      },
      -      "measured_at": {
      -        "type": "null"
      -      },
      -      "method": {
      -        "type": "null"
      -      },
      -      "notes": {
      -        "description": "Caveats, one sentence each.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "state": {
      -        "description": "failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.",
      -        "enum": [
      -          "failed",
      -          "invalid_input"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "state",
      -      "measured_at",
      -      "method",
      -      "coverage",
      -      "freshness",
      -      "notes",
      -      "error"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "coverage": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "properties": {
      +              "vendor_window": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": {},
      +                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it; where history_scope is a part of the vendor's advisories, it is where that part is held from, and the rest is held from feed_held_since), feed_held_since (the start of the window the vendor's own feed has read every one of its advisories from, which is held_since as it would be without any history read; an advisory outside history_scope published before it may not be held; null when none is held or the API does not say), history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried) and history_scope (what the vendor's history read covers: all, or reviewed for GitHub, whose read covers its reviewed advisories and not its unreviewed ones, which are held only from feed_held_since; a value the API adds later as it sends it; null for a vendor with no history read, or when the API does not say).",
      +                    "properties": {
      +                      "advisories": {
      +                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "earliest_vendor_published_at": {
      +                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "feed_held_since": {
      +                        "description": "The start of the window this vendor's own feed has read every one of its advisories from: held_since as it would be without any history read, and equal to it for a vendor with no history read. Where history_scope is a part of the vendor's advisories (reviewed: GitHub's history read covers its reviewed advisories only), an advisory outside it published before feed_held_since may not be held, however early held_since is. null when none is held or the API does not say.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "held_since": {
      +                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older. Where history_scope is a part of the vendor's advisories (reviewed), it is where that part is held from; the rest is held from feed_held_since.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "history_backfill": {
      +                        "anyOf": [
      +                          {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "complete",
      +                                  "complete_reviewed_only",
      +                                  "in_progress",
      +                                  "not_started",
      +                                  "not_supported"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "string"
      +                              }
      +                            ]
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      +                      },
      +                      "history_scope": {
      +                        "description": "What this vendor's history read covers: all (every advisory its archive publishes) or reviewed (GitHub: its reviewed advisories, not its unreviewed ones, which are held only from feed_held_since); a value the API adds later as it sends it. null for a vendor with no history read, or when the API does not say.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "latest_vendor_published_at": {
      +                        "description": "The latest vendor_published_at among them; null when none is held.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "vendor": {
      +                        "description": "The vendor slug.",
      +                        "type": "string"
      +                      },
      +                      "vendor_display_name": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      }
      +                    },
      +                    "required": [
      +                      "vendor",
      +                      "vendor_display_name",
      +                      "advisories",
      +                      "earliest_vendor_published_at",
      +                      "latest_vendor_published_at",
      +                      "held_since",
      +                      "feed_held_since",
      +                      "history_backfill",
      +                      "history_scope"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      +              }
      +            },
      +            "required": [
      +              "vendor_window"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "What the answer covers; null where the answer says nothing about it."
      +      },
      +      "data": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "advisory_id": {
      +            "description": "EchelonGraph's internal ID for this advisory, a UUID. It is not the vendor's advisory ID (vendor_advisory_id), and an advisory's detail is not looked up by it: the detail is keyed on vendor and vendor_advisory_id.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "affected_products": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "cvss_v3_score": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "description": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "known_cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The CVE IDs of cve_ids that have a record in EchelonGraph's CVE feed."
      +          },
      +          "our_first_seen_at": {
      +            "description": "When EchelonGraph first recorded the advisory; not the vendor's date.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "references": {},
      +          "rejected_cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The CVE IDs this advisory names whose CVE record was rejected (withdrawn) by its numbering authority: each is a rejected record, not an active vulnerability, whatever the advisory's text says. The vendor's withdrawn is separate and unchanged by it. [] when none is; null when that could not be checked."
      +          },
      +          "remediation": {
      +            "description": "The vendor's remediation as one text (the legacy field), beside remediations.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "remediation_items_not_stored": {
      +            "description": "Items past the 64 stored per advisory.",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "remediation_kinds": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "vendor_fix",
      +                        "workaround",
      +                        "mitigation",
      +                        "no_fix_planned",
      +                        "none_available",
      +                        "other"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "string"
      +                    }
      +                  ]
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The kinds of remediation the advisory lists (for the CVE asked about, on a by-cve row), each the vendor's own category, never read from the text: vendor_fix, workaround, mitigation, no_fix_planned, none_available or other. [] with remediation_state not_parsed is not a finding that it lists none."
      +          },
      +          "remediation_state": {
      +            "anyOf": [
      +              {
      +                "anyOf": [
      +                  {
      +                    "enum": [
      +                      "parsed",
      +                      "none_in_source",
      +                      "not_parsed",
      +                      "withdrawn"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "string"
      +                  }
      +                ]
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "parsed; none_in_source (EchelonGraph read the vendor's remediation, and it lists none for this CVE, which is not a finding that no fix exists); not_parsed (EchelonGraph does not read this vendor's remediation, or has not yet read this advisory: not a finding of none); withdrawn (the vendor rescinded the advisory)."
      +          },
      +          "remediations": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "additionalProperties": {},
      +                  "properties": {
      +                    "cve_ids": {
      +                      "anyOf": [
      +                        {
      +                          "items": {
      +                            "type": "string"
      +                          },
      +                          "type": "array"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ],
      +                      "description": "The CVEs the item covers; [] for the whole advisory."
      +                    },
      +                    "fixed_build": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "kind": {
      +                      "anyOf": [
      +                        {
      +                          "anyOf": [
      +                            {
      +                              "enum": [
      +                                "vendor_fix",
      +                                "workaround",
      +                                "mitigation",
      +                                "no_fix_planned",
      +                                "none_available",
      +                                "other"
      +                              ],
      +                              "type": "string"
      +                            },
      +                            {
      +                              "type": "string"
      +                            }
      +                          ]
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "product_count": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "product_ids": {
      +                      "anyOf": [
      +                        {
      +                          "items": {
      +                            "type": "string"
      +                          },
      +                          "type": "array"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "source_category": {
      +                      "description": "The vendor's own name for the category.",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "source_subcategory": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "text": {
      +                      "description": "The vendor's text, verbatim but for HTML markup removed, untested by EchelonGraph; at most 2,000 characters (text_truncated, text_chars).",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "text_chars": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "text_truncated": {
      +                      "type": [
      +                        "boolean",
      +                        "null"
      +                      ]
      +                    },
      +                    "url": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    }
      +                  },
      +                  "type": "object"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "Each remediation the vendor lists, with its kind, the vendor's own category."
      +          },
      +          "severity": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "summary": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "title": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_advisory_id": {
      +            "description": "The vendor's own ID for the advisory (e.g. RHSA-2024:1234, GHSA-xxxx-xxxx-xxxx, or the CVE ID for Microsoft and Palo Alto Networks). With vendor, it is the key an advisory's detail is looked up by, as its advisory_id argument.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_display_name": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_modified_at": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_published_at": {
      +            "description": "The date the vendor gives for the advisory.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "withdrawn": {
      +            "description": "true: the vendor withdrew (rescinded) this advisory, so it is a withdrawn advisory, not a current one.",
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "withdrawn_at": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "withdrawn_reason": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "data_truncated": {
      +        "description": "false: data is the answer whole. true: the structured result would pass 30,000 characters of JSON with data whole, so data is cut (DATA CUT): the entries of some of its lists keep only some of their fields, or the lists only some of their entries, truncated gives each, and no string is shortened. The same call with full: true returns data whole.",
      +        "type": "boolean"
      +      },
      +      "freshness": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "The producing radar's last completed check (last_run_at), where the API serves one."
      +      },
      +      "measured_at": {
      +        "anyOf": [
      +          {
      +            "description": "An RFC 3339 instant.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation."
      +      },
      +      "method": {
      +        "description": "How the numbers were produced.",
      +        "type": "string"
      +      },
      +      "notes": {
      +        "description": "Caveats, one sentence each.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "state": {
      +        "description": "measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.",
      +        "enum": [
      +          "measured",
      +          "not_assessed"
      +        ],
      +        "type": "string"
      +      },
      +      "truncated": {
      +        "additionalProperties": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "returned": {
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "thinned": {
      +              "const": true,
      +              "type": "boolean"
      +            },
      +            "total": {
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "total",
      +            "returned"
      +          ],
      +          "type": "object"
      +        },
      +        "description": "Present when data_truncated is true: each list of data that was cut, by its path in data (a dot between the names of an object and a list inside it), with total, its entries in the answer, returned, the entries data holds, and thinned, true when each of them keeps only some of its fields.",
      +        "propertyNames": {
      +          "type": "string"
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "state",
      +      "measured_at",
      +      "method",
      +      "coverage",
      +      "freshness",
      +      "notes",
      +      "data_truncated",
      +      "data"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "coverage": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "vendor_window": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it; where history_scope is a part of the vendor's advisories, it is where that part is held from, and the rest is held from feed_held_since), feed_held_since (the start of the window the vendor's own feed has read every one of its advisories from, which is held_since as it would be without any history read; an advisory outside history_scope published before it may not be held; null when none is held or the API does not say), history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried) and history_scope (what the vendor's history read covers: all, or reviewed for GitHub, whose read covers its reviewed advisories and not its unreviewed ones, which are held only from feed_held_since; a value the API adds later as it sends it; null for a vendor with no history read, or when the API does not say).",
      +                    "properties": {
      +                      "advisories": {
      +                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "earliest_vendor_published_at": {
      +                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "feed_held_since": {
      +                        "description": "The start of the window this vendor's own feed has read every one of its advisories from: held_since as it would be without any history read, and equal to it for a vendor with no history read. Where history_scope is a part of the vendor's advisories (reviewed: GitHub's history read covers its reviewed advisories only), an advisory outside it published before feed_held_since may not be held, however early held_since is. null when none is held or the API does not say.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "held_since": {
      +                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older. Where history_scope is a part of the vendor's advisories (reviewed), it is where that part is held from; the rest is held from feed_held_since.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "history_backfill": {
      +                        "anyOf": [
      +                          {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "complete",
      +                                  "complete_reviewed_only",
      +                                  "in_progress",
      +                                  "not_started",
      +                                  "not_supported"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "string"
      +                              }
      +                            ]
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      +                      },
      +                      "history_scope": {
      +                        "description": "What this vendor's history read covers: all (every advisory its archive publishes) or reviewed (GitHub: its reviewed advisories, not its unreviewed ones, which are held only from feed_held_since); a value the API adds later as it sends it. null for a vendor with no history read, or when the API does not say.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "latest_vendor_published_at": {
      +                        "description": "The latest vendor_published_at among them; null when none is held.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "vendor": {
      +                        "description": "The vendor slug.",
      +                        "type": "string"
      +                      },
      +                      "vendor_display_name": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      }
      +                    },
      +                    "required": [
      +                      "vendor",
      +                      "vendor_display_name",
      +                      "advisories",
      +                      "earliest_vendor_published_at",
      +                      "latest_vendor_published_at",
      +                      "held_since",
      +                      "feed_held_since",
      +                      "history_backfill",
      +                      "history_scope"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      +              }
      +            },
      +            "required": [
      +              "vendor_window"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "error": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "kind": {
      +            "description": "What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.",
      +            "enum": [
      +              "network",
      +              "timeout",
      +              "http",
      +              "not_json",
      +              "not_object",
      +              "invalid_input",
      +              "internal",
      +              "unexpected_shape",
      +              "radars"
      +            ],
      +            "type": "string"
      +          },
      +          "message": {
      +            "description": "The cause: the API's own message, or what went wrong.",
      +            "type": "string"
      +          },
      +          "path": {
      +            "description": "The API path requested, when a request was made.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "status": {
      +            "anyOf": [
      +              {
      +                "maximum": 9007199254740991,
      +                "minimum": -9007199254740991,
      +                "type": "integer"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The HTTP status, when the API answered one."
      +          }
      +        },
      +        "required": [
      +          "kind",
      +          "path",
      +          "status",
      +          "message"
      +        ],
      +        "type": "object"
      +      },
      +      "freshness": {
      +        "type": "null"
      +      },
      +      "measured_at": {
      +        "type": "null"
      +      },
      +      "method": {
      +        "type": "null"
      +      },
      +      "notes": {
      +        "description": "Caveats, one sentence each.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "state": {
      +        "description": "failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.",
      +        "enum": [
      +          "failed",
      +          "invalid_input"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "state",
      +      "measured_at",
      +      "method",
      +      "coverage",
      +      "freshness",
      +      "notes",
      +      "error"
      +    ],
      +    "type": "object"
      +  }
      +]
  4. Changed2 schema fields changed
    • changedInput schema / properties / advisory_id / description
      Previous value: -"the vendor's advisory ID, e.g. RHSA-2024:1234 or GHSA-xxxx-xxxx-xxxx"New value: +"the vendor's own advisory ID, a row's vendor_advisory_id, e.g. RHSA-2024:1234, GHSA-xxxx-xxxx-xxxx or CVE-2024-3400; not a row's advisory_id, EchelonGraph's internal UUID"
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "coverage": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "vendor_window": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": false,
      -                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it) and history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried).",
      -                    "properties": {
      -                      "advisories": {
      -                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      -                        "type": [
      -                          "number",
      -                          "null"
      -                        ]
      -                      },
      -                      "earliest_vendor_published_at": {
      -                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "held_since": {
      -                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "history_backfill": {
      -                        "anyOf": [
      -                          {
      -                            "anyOf": [
      -                              {
      -                                "enum": [
      -                                  "complete",
      -                                  "in_progress",
      -                                  "not_started",
      -                                  "not_supported"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              {
      -                                "type": "string"
      -                              }
      -                            ]
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      -                      },
      -                      "latest_vendor_published_at": {
      -                        "description": "The latest vendor_published_at among them; null when none is held.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "vendor": {
      -                        "description": "The vendor slug.",
      -                        "type": "string"
      -                      },
      -                      "vendor_display_name": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      }
      -                    },
      -                    "required": [
      -                      "vendor",
      -                      "vendor_display_name",
      -                      "advisories",
      -                      "earliest_vendor_published_at",
      -                      "latest_vendor_published_at",
      -                      "held_since",
      -                      "history_backfill"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      -              }
      -            },
      -            "required": [
      -              "vendor_window"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "What the answer covers; null where the answer says nothing about it."
      -      },
      -      "data": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "advisory_id": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "affected_products": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "cvss_v3_score": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "description": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "known_cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The CVE IDs of cve_ids that have a record in EchelonGraph's CVE feed."
      -          },
      -          "our_first_seen_at": {
      -            "description": "When EchelonGraph first recorded the advisory; not the vendor's date.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "references": {},
      -          "rejected_cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The CVE IDs this advisory names whose CVE record was rejected (withdrawn) by its numbering authority: each is a rejected record, not an active vulnerability, whatever the advisory's text says. The vendor's withdrawn is separate and unchanged by it. [] when none is; null when that could not be checked."
      -          },
      -          "remediation": {
      -            "description": "The vendor's remediation as one text (the legacy field), beside remediations.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "remediation_items_not_stored": {
      -            "description": "Items past the 64 stored per advisory.",
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "remediation_kinds": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "vendor_fix",
      -                        "workaround",
      -                        "mitigation",
      -                        "no_fix_planned",
      -                        "none_available",
      -                        "other"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "string"
      -                    }
      -                  ]
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The kinds of remediation the advisory lists (for the CVE asked about, on a by-cve row), each the vendor's own category, never read from the text: vendor_fix, workaround, mitigation, no_fix_planned, none_available or other. [] with remediation_state not_parsed is not a finding that it lists none."
      -          },
      -          "remediation_state": {
      -            "anyOf": [
      -              {
      -                "anyOf": [
      -                  {
      -                    "enum": [
      -                      "parsed",
      -                      "none_in_source",
      -                      "not_parsed",
      -                      "withdrawn"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "string"
      -                  }
      -                ]
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "parsed; none_in_source (EchelonGraph read the vendor's remediation, and it lists none for this CVE, which is not a finding that no fix exists); not_parsed (EchelonGraph does not read this vendor's remediation, or has not yet read this advisory: not a finding of none); withdrawn (the vendor rescinded the advisory)."
      -          },
      -          "remediations": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "additionalProperties": {},
      -                  "properties": {
      -                    "cve_ids": {
      -                      "anyOf": [
      -                        {
      -                          "items": {
      -                            "type": "string"
      -                          },
      -                          "type": "array"
      -                        },
      -                        {
      -                          "type": "null"
      -                        }
      -                      ],
      -                      "description": "The CVEs the item covers; [] for the whole advisory."
      -                    },
      -                    "fixed_build": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "kind": {
      -                      "anyOf": [
      -                        {
      -                          "anyOf": [
      -                            {
      -                              "enum": [
      -                                "vendor_fix",
      -                                "workaround",
      -                                "mitigation",
      -                                "no_fix_planned",
      -                                "none_available",
      -                                "other"
      -                              ],
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "string"
      -                            }
      -                          ]
      -                        },
      -                        {
      -                          "type": "null"
      -                        }
      -                      ]
      -                    },
      -                    "product_count": {
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "product_ids": {
      -                      "anyOf": [
      -                        {
      -                          "items": {
      -                            "type": "string"
      -                          },
      -                          "type": "array"
      -                        },
      -                        {
      -                          "type": "null"
      -                        }
      -                      ]
      -                    },
      -                    "source_category": {
      -                      "description": "The vendor's own name for the category.",
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "source_subcategory": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "text": {
      -                      "description": "The vendor's text, verbatim but for HTML markup removed, untested by EchelonGraph; at most 2,000 characters (text_truncated, text_chars).",
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "text_chars": {
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "text_truncated": {
      -                      "type": [
      -                        "boolean",
      -                        "null"
      -                      ]
      -                    },
      -                    "url": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    }
      -                  },
      -                  "type": "object"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "Each remediation the vendor lists, with its kind, the vendor's own category."
      -          },
      -          "severity": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "summary": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "title": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_advisory_id": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_display_name": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_modified_at": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_published_at": {
      -            "description": "The date the vendor gives for the advisory.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "withdrawn": {
      -            "description": "true: the vendor withdrew (rescinded) this advisory, so it is a withdrawn advisory, not a current one.",
      -            "type": [
      -              "boolean",
      -              "null"
      -            ]
      -          },
      -          "withdrawn_at": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "withdrawn_reason": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "data_truncated": {
      -        "description": "false: data is the answer whole. true: the structured result would pass 30,000 characters of JSON with data whole, so data is cut (DATA CUT): the entries of some of its lists keep only some of their fields, or the lists only some of their entries, truncated gives each, and no string is shortened. The same call with full: true returns data whole.",
      -        "type": "boolean"
      -      },
      -      "freshness": {
      -        "description": "The producing radar's last completed check (last_run_at), where the API serves one.",
      -        "type": "null"
      -      },
      -      "measured_at": {
      -        "anyOf": [
      -          {
      -            "description": "An RFC 3339 instant.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation."
      -      },
      -      "method": {
      -        "description": "How the numbers were produced.",
      -        "type": "string"
      -      },
      -      "notes": {
      -        "description": "Caveats, one sentence each.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "state": {
      -        "description": "measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.",
      -        "enum": [
      -          "measured",
      -          "not_assessed"
      -        ],
      -        "type": "string"
      -      },
      -      "truncated": {
      -        "additionalProperties": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "returned": {
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            },
      -            "thinned": {
      -              "const": true,
      -              "type": "boolean"
      -            },
      -            "total": {
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            }
      -          },
      -          "required": [
      -            "total",
      -            "returned"
      -          ],
      -          "type": "object"
      -        },
      -        "description": "Present when data_truncated is true: each list of data that was cut, by its path in data (a dot between the names of an object and a list inside it), with total, its entries in the answer, returned, the entries data holds, and thinned, true when each of them keeps only some of its fields.",
      -        "propertyNames": {
      -          "type": "string"
      -        },
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "state",
      -      "measured_at",
      -      "method",
      -      "coverage",
      -      "freshness",
      -      "notes",
      -      "data_truncated",
      -      "data"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "coverage": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "vendor_window": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": false,
      -                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it) and history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried).",
      -                    "properties": {
      -                      "advisories": {
      -                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      -                        "type": [
      -                          "number",
      -                          "null"
      -                        ]
      -                      },
      -                      "earliest_vendor_published_at": {
      -                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "held_since": {
      -                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "history_backfill": {
      -                        "anyOf": [
      -                          {
      -                            "anyOf": [
      -                              {
      -                                "enum": [
      -                                  "complete",
      -                                  "in_progress",
      -                                  "not_started",
      -                                  "not_supported"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              {
      -                                "type": "string"
      -                              }
      -                            ]
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      -                      },
      -                      "latest_vendor_published_at": {
      -                        "description": "The latest vendor_published_at among them; null when none is held.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "vendor": {
      -                        "description": "The vendor slug.",
      -                        "type": "string"
      -                      },
      -                      "vendor_display_name": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      }
      -                    },
      -                    "required": [
      -                      "vendor",
      -                      "vendor_display_name",
      -                      "advisories",
      -                      "earliest_vendor_published_at",
      -                      "latest_vendor_published_at",
      -                      "held_since",
      -                      "history_backfill"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      -              }
      -            },
      -            "required": [
      -              "vendor_window"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "error": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "kind": {
      -            "description": "What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.",
      -            "enum": [
      -              "network",
      -              "timeout",
      -              "http",
      -              "not_json",
      -              "not_object",
      -              "invalid_input",
      -              "internal",
      -              "unexpected_shape",
      -              "radars"
      -            ],
      -            "type": "string"
      -          },
      -          "message": {
      -            "description": "The cause: the API's own message, or what went wrong.",
      -            "type": "string"
      -          },
      -          "path": {
      -            "description": "The API path requested, when a request was made.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "status": {
      -            "anyOf": [
      -              {
      -                "maximum": 9007199254740991,
      -                "minimum": -9007199254740991,
      -                "type": "integer"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The HTTP status, when the API answered one."
      -          }
      -        },
      -        "required": [
      -          "kind",
      -          "path",
      -          "status",
      -          "message"
      -        ],
      -        "type": "object"
      -      },
      -      "freshness": {
      -        "type": "null"
      -      },
      -      "measured_at": {
      -        "type": "null"
      -      },
      -      "method": {
      -        "type": "null"
      -      },
      -      "notes": {
      -        "description": "Caveats, one sentence each.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "state": {
      -        "description": "failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.",
      -        "enum": [
      -          "failed",
      -          "invalid_input"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "state",
      -      "measured_at",
      -      "method",
      -      "coverage",
      -      "freshness",
      -      "notes",
      -      "error"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "coverage": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "properties": {
      +              "vendor_window": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": {},
      +                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it) and history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried).",
      +                    "properties": {
      +                      "advisories": {
      +                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "earliest_vendor_published_at": {
      +                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "held_since": {
      +                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "history_backfill": {
      +                        "anyOf": [
      +                          {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "complete",
      +                                  "in_progress",
      +                                  "not_started",
      +                                  "not_supported"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "string"
      +                              }
      +                            ]
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      +                      },
      +                      "latest_vendor_published_at": {
      +                        "description": "The latest vendor_published_at among them; null when none is held.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "vendor": {
      +                        "description": "The vendor slug.",
      +                        "type": "string"
      +                      },
      +                      "vendor_display_name": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      }
      +                    },
      +                    "required": [
      +                      "vendor",
      +                      "vendor_display_name",
      +                      "advisories",
      +                      "earliest_vendor_published_at",
      +                      "latest_vendor_published_at",
      +                      "held_since",
      +                      "history_backfill"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      +              }
      +            },
      +            "required": [
      +              "vendor_window"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "What the answer covers; null where the answer says nothing about it."
      +      },
      +      "data": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "advisory_id": {
      +            "description": "EchelonGraph's internal ID for this advisory, a UUID. It is not the vendor's advisory ID (vendor_advisory_id), and an advisory's detail is not looked up by it: the detail is keyed on vendor and vendor_advisory_id.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "affected_products": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "cvss_v3_score": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "description": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "known_cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The CVE IDs of cve_ids that have a record in EchelonGraph's CVE feed."
      +          },
      +          "our_first_seen_at": {
      +            "description": "When EchelonGraph first recorded the advisory; not the vendor's date.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "references": {},
      +          "rejected_cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The CVE IDs this advisory names whose CVE record was rejected (withdrawn) by its numbering authority: each is a rejected record, not an active vulnerability, whatever the advisory's text says. The vendor's withdrawn is separate and unchanged by it. [] when none is; null when that could not be checked."
      +          },
      +          "remediation": {
      +            "description": "The vendor's remediation as one text (the legacy field), beside remediations.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "remediation_items_not_stored": {
      +            "description": "Items past the 64 stored per advisory.",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "remediation_kinds": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "vendor_fix",
      +                        "workaround",
      +                        "mitigation",
      +                        "no_fix_planned",
      +                        "none_available",
      +                        "other"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "string"
      +                    }
      +                  ]
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The kinds of remediation the advisory lists (for the CVE asked about, on a by-cve row), each the vendor's own category, never read from the text: vendor_fix, workaround, mitigation, no_fix_planned, none_available or other. [] with remediation_state not_parsed is not a finding that it lists none."
      +          },
      +          "remediation_state": {
      +            "anyOf": [
      +              {
      +                "anyOf": [
      +                  {
      +                    "enum": [
      +                      "parsed",
      +                      "none_in_source",
      +                      "not_parsed",
      +                      "withdrawn"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "string"
      +                  }
      +                ]
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "parsed; none_in_source (EchelonGraph read the vendor's remediation, and it lists none for this CVE, which is not a finding that no fix exists); not_parsed (EchelonGraph does not read this vendor's remediation, or has not yet read this advisory: not a finding of none); withdrawn (the vendor rescinded the advisory)."
      +          },
      +          "remediations": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "additionalProperties": {},
      +                  "properties": {
      +                    "cve_ids": {
      +                      "anyOf": [
      +                        {
      +                          "items": {
      +                            "type": "string"
      +                          },
      +                          "type": "array"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ],
      +                      "description": "The CVEs the item covers; [] for the whole advisory."
      +                    },
      +                    "fixed_build": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "kind": {
      +                      "anyOf": [
      +                        {
      +                          "anyOf": [
      +                            {
      +                              "enum": [
      +                                "vendor_fix",
      +                                "workaround",
      +                                "mitigation",
      +                                "no_fix_planned",
      +                                "none_available",
      +                                "other"
      +                              ],
      +                              "type": "string"
      +                            },
      +                            {
      +                              "type": "string"
      +                            }
      +                          ]
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "product_count": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "product_ids": {
      +                      "anyOf": [
      +                        {
      +                          "items": {
      +                            "type": "string"
      +                          },
      +                          "type": "array"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "source_category": {
      +                      "description": "The vendor's own name for the category.",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "source_subcategory": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "text": {
      +                      "description": "The vendor's text, verbatim but for HTML markup removed, untested by EchelonGraph; at most 2,000 characters (text_truncated, text_chars).",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "text_chars": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "text_truncated": {
      +                      "type": [
      +                        "boolean",
      +                        "null"
      +                      ]
      +                    },
      +                    "url": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    }
      +                  },
      +                  "type": "object"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "Each remediation the vendor lists, with its kind, the vendor's own category."
      +          },
      +          "severity": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "summary": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "title": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_advisory_id": {
      +            "description": "The vendor's own ID for the advisory (e.g. RHSA-2024:1234, GHSA-xxxx-xxxx-xxxx, or the CVE ID for Microsoft and Palo Alto Networks). With vendor, it is the key an advisory's detail is looked up by, as its advisory_id argument.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_display_name": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_modified_at": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_published_at": {
      +            "description": "The date the vendor gives for the advisory.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "withdrawn": {
      +            "description": "true: the vendor withdrew (rescinded) this advisory, so it is a withdrawn advisory, not a current one.",
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "withdrawn_at": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "withdrawn_reason": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "data_truncated": {
      +        "description": "false: data is the answer whole. true: the structured result would pass 30,000 characters of JSON with data whole, so data is cut (DATA CUT): the entries of some of its lists keep only some of their fields, or the lists only some of their entries, truncated gives each, and no string is shortened. The same call with full: true returns data whole.",
      +        "type": "boolean"
      +      },
      +      "freshness": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "The producing radar's last completed check (last_run_at), where the API serves one."
      +      },
      +      "measured_at": {
      +        "anyOf": [
      +          {
      +            "description": "An RFC 3339 instant.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation."
      +      },
      +      "method": {
      +        "description": "How the numbers were produced.",
      +        "type": "string"
      +      },
      +      "notes": {
      +        "description": "Caveats, one sentence each.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "state": {
      +        "description": "measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.",
      +        "enum": [
      +          "measured",
      +          "not_assessed"
      +        ],
      +        "type": "string"
      +      },
      +      "truncated": {
      +        "additionalProperties": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "returned": {
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "thinned": {
      +              "const": true,
      +              "type": "boolean"
      +            },
      +            "total": {
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "total",
      +            "returned"
      +          ],
      +          "type": "object"
      +        },
      +        "description": "Present when data_truncated is true: each list of data that was cut, by its path in data (a dot between the names of an object and a list inside it), with total, its entries in the answer, returned, the entries data holds, and thinned, true when each of them keeps only some of its fields.",
      +        "propertyNames": {
      +          "type": "string"
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "state",
      +      "measured_at",
      +      "method",
      +      "coverage",
      +      "freshness",
      +      "notes",
      +      "data_truncated",
      +      "data"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "coverage": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "vendor_window": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it) and history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried).",
      +                    "properties": {
      +                      "advisories": {
      +                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "earliest_vendor_published_at": {
      +                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "held_since": {
      +                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "history_backfill": {
      +                        "anyOf": [
      +                          {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "complete",
      +                                  "in_progress",
      +                                  "not_started",
      +                                  "not_supported"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "string"
      +                              }
      +                            ]
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      +                      },
      +                      "latest_vendor_published_at": {
      +                        "description": "The latest vendor_published_at among them; null when none is held.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "vendor": {
      +                        "description": "The vendor slug.",
      +                        "type": "string"
      +                      },
      +                      "vendor_display_name": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      }
      +                    },
      +                    "required": [
      +                      "vendor",
      +                      "vendor_display_name",
      +                      "advisories",
      +                      "earliest_vendor_published_at",
      +                      "latest_vendor_published_at",
      +                      "held_since",
      +                      "history_backfill"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      +              }
      +            },
      +            "required": [
      +              "vendor_window"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "error": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "kind": {
      +            "description": "What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.",
      +            "enum": [
      +              "network",
      +              "timeout",
      +              "http",
      +              "not_json",
      +              "not_object",
      +              "invalid_input",
      +              "internal",
      +              "unexpected_shape",
      +              "radars"
      +            ],
      +            "type": "string"
      +          },
      +          "message": {
      +            "description": "The cause: the API's own message, or what went wrong.",
      +            "type": "string"
      +          },
      +          "path": {
      +            "description": "The API path requested, when a request was made.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "status": {
      +            "anyOf": [
      +              {
      +                "maximum": 9007199254740991,
      +                "minimum": -9007199254740991,
      +                "type": "integer"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The HTTP status, when the API answered one."
      +          }
      +        },
      +        "required": [
      +          "kind",
      +          "path",
      +          "status",
      +          "message"
      +        ],
      +        "type": "object"
      +      },
      +      "freshness": {
      +        "type": "null"
      +      },
      +      "measured_at": {
      +        "type": "null"
      +      },
      +      "method": {
      +        "type": "null"
      +      },
      +      "notes": {
      +        "description": "Caveats, one sentence each.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "state": {
      +        "description": "failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.",
      +        "enum": [
      +          "failed",
      +          "invalid_input"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "state",
      +      "measured_at",
      +      "method",
      +      "coverage",
      +      "freshness",
      +      "notes",
      +      "error"
      +    ],
      +    "type": "object"
      +  }
      +]
  5. Changed1 schema field changed
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "coverage": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "vendor_window": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": false,
      -                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it) and history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried).",
      -                    "properties": {
      -                      "advisories": {
      -                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      -                        "type": [
      -                          "number",
      -                          "null"
      -                        ]
      -                      },
      -                      "earliest_vendor_published_at": {
      -                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "held_since": {
      -                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "history_backfill": {
      -                        "anyOf": [
      -                          {
      -                            "anyOf": [
      -                              {
      -                                "enum": [
      -                                  "complete",
      -                                  "in_progress",
      -                                  "not_started",
      -                                  "not_supported"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              {
      -                                "type": "string"
      -                              }
      -                            ]
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      -                      },
      -                      "latest_vendor_published_at": {
      -                        "description": "The latest vendor_published_at among them; null when none is held.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "vendor": {
      -                        "description": "The vendor slug.",
      -                        "type": "string"
      -                      },
      -                      "vendor_display_name": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      }
      -                    },
      -                    "required": [
      -                      "vendor",
      -                      "vendor_display_name",
      -                      "advisories",
      -                      "earliest_vendor_published_at",
      -                      "latest_vendor_published_at",
      -                      "held_since",
      -                      "history_backfill"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      -              }
      -            },
      -            "required": [
      -              "vendor_window"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "What the answer covers; null where the answer says nothing about it."
      -      },
      -      "data": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "advisory_id": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "affected_products": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "cvss_v3_score": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "description": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "known_cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The CVE IDs of cve_ids that have a record in EchelonGraph's CVE feed."
      -          },
      -          "our_first_seen_at": {
      -            "description": "When EchelonGraph first recorded the advisory; not the vendor's date.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "references": {},
      -          "rejected_cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The CVE IDs this advisory names whose CVE record was rejected (withdrawn) by its numbering authority: each is a rejected record, not an active vulnerability, whatever the advisory's text says. The vendor's withdrawn is separate and unchanged by it. [] when none is; null when that could not be checked."
      -          },
      -          "remediation": {
      -            "description": "The vendor's remediation as one text (the legacy field), beside remediations.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "remediation_items_not_stored": {
      -            "description": "Items past the 64 stored per advisory.",
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "remediation_kinds": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "vendor_fix",
      -                        "workaround",
      -                        "mitigation",
      -                        "no_fix_planned",
      -                        "none_available",
      -                        "other"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "string"
      -                    }
      -                  ]
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The kinds of remediation the advisory lists (for the CVE asked about, on a by-cve row), each the vendor's own category, never read from the text: vendor_fix, workaround, mitigation, no_fix_planned, none_available or other. [] with remediation_state not_parsed is not a finding that it lists none."
      -          },
      -          "remediation_state": {
      -            "anyOf": [
      -              {
      -                "anyOf": [
      -                  {
      -                    "enum": [
      -                      "parsed",
      -                      "none_in_source",
      -                      "not_parsed",
      -                      "withdrawn"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "string"
      -                  }
      -                ]
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "parsed; none_in_source (EchelonGraph read the vendor's remediation, and it lists none for this CVE, which is not a finding that no fix exists); not_parsed (EchelonGraph does not read this vendor's remediation, or has not yet read this advisory: not a finding of none); withdrawn (the vendor rescinded the advisory)."
      -          },
      -          "remediations": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "additionalProperties": {},
      -                  "properties": {
      -                    "cve_ids": {
      -                      "anyOf": [
      -                        {
      -                          "items": {
      -                            "type": "string"
      -                          },
      -                          "type": "array"
      -                        },
      -                        {
      -                          "type": "null"
      -                        }
      -                      ],
      -                      "description": "The CVEs the item covers; [] for the whole advisory."
      -                    },
      -                    "fixed_build": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "kind": {
      -                      "anyOf": [
      -                        {
      -                          "anyOf": [
      -                            {
      -                              "enum": [
      -                                "vendor_fix",
      -                                "workaround",
      -                                "mitigation",
      -                                "no_fix_planned",
      -                                "none_available",
      -                                "other"
      -                              ],
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "string"
      -                            }
      -                          ]
      -                        },
      -                        {
      -                          "type": "null"
      -                        }
      -                      ]
      -                    },
      -                    "product_count": {
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "product_ids": {
      -                      "anyOf": [
      -                        {
      -                          "items": {
      -                            "type": "string"
      -                          },
      -                          "type": "array"
      -                        },
      -                        {
      -                          "type": "null"
      -                        }
      -                      ]
      -                    },
      -                    "source_category": {
      -                      "description": "The vendor's own name for the category.",
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "source_subcategory": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "text": {
      -                      "description": "The vendor's text, verbatim but for HTML markup removed, untested by EchelonGraph; at most 2,000 characters (text_truncated, text_chars).",
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "text_chars": {
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "text_truncated": {
      -                      "type": [
      -                        "boolean",
      -                        "null"
      -                      ]
      -                    },
      -                    "url": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    }
      -                  },
      -                  "type": "object"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "Each remediation the vendor lists, with its kind, the vendor's own category."
      -          },
      -          "severity": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "summary": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "title": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_advisory_id": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_display_name": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_modified_at": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_published_at": {
      -            "description": "The date the vendor gives for the advisory.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "withdrawn": {
      -            "description": "true: the vendor withdrew (rescinded) this advisory, so it is a withdrawn advisory, not a current one.",
      -            "type": [
      -              "boolean",
      -              "null"
      -            ]
      -          },
      -          "withdrawn_at": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "withdrawn_reason": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "data_truncated": {
      -        "description": "false: data is the answer whole. true: the structured result would pass 30,000 characters of JSON with data whole, so data is cut (DATA CUT): the entries of some of its lists keep only some of their fields, or the lists only some of their entries, truncated gives each, and no string is shortened. The same call with full: true returns data whole.",
      -        "type": "boolean"
      -      },
      -      "freshness": {
      -        "description": "The producing radar's last completed check (last_run_at), where the API serves one.",
      -        "type": "null"
      -      },
      -      "measured_at": {
      -        "anyOf": [
      -          {
      -            "description": "An RFC 3339 instant.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation."
      -      },
      -      "method": {
      -        "description": "How the numbers were produced.",
      -        "type": "string"
      -      },
      -      "notes": {
      -        "description": "Caveats, one sentence each.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "state": {
      -        "description": "measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.",
      -        "enum": [
      -          "measured",
      -          "not_assessed"
      -        ],
      -        "type": "string"
      -      },
      -      "truncated": {
      -        "additionalProperties": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "returned": {
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            },
      -            "thinned": {
      -              "const": true,
      -              "type": "boolean"
      -            },
      -            "total": {
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            }
      -          },
      -          "required": [
      -            "total",
      -            "returned"
      -          ],
      -          "type": "object"
      -        },
      -        "description": "Present when data_truncated is true: each list of data that was cut, by its path in data (a dot between the names of an object and a list inside it), with total, its entries in the answer, returned, the entries data holds, and thinned, true when each of them keeps only some of its fields.",
      -        "propertyNames": {
      -          "type": "string"
      -        },
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "state",
      -      "measured_at",
      -      "method",
      -      "coverage",
      -      "freshness",
      -      "notes",
      -      "data_truncated",
      -      "data"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "coverage": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "vendor_window": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": false,
      -                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it) and history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried).",
      -                    "properties": {
      -                      "advisories": {
      -                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      -                        "type": [
      -                          "number",
      -                          "null"
      -                        ]
      -                      },
      -                      "earliest_vendor_published_at": {
      -                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "held_since": {
      -                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "history_backfill": {
      -                        "anyOf": [
      -                          {
      -                            "anyOf": [
      -                              {
      -                                "enum": [
      -                                  "complete",
      -                                  "in_progress",
      -                                  "not_started",
      -                                  "not_supported"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              {
      -                                "type": "string"
      -                              }
      -                            ]
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      -                      },
      -                      "latest_vendor_published_at": {
      -                        "description": "The latest vendor_published_at among them; null when none is held.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "vendor": {
      -                        "description": "The vendor slug.",
      -                        "type": "string"
      -                      },
      -                      "vendor_display_name": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      }
      -                    },
      -                    "required": [
      -                      "vendor",
      -                      "vendor_display_name",
      -                      "advisories",
      -                      "earliest_vendor_published_at",
      -                      "latest_vendor_published_at",
      -                      "held_since",
      -                      "history_backfill"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      -              }
      -            },
      -            "required": [
      -              "vendor_window"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "error": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "kind": {
      -            "description": "What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.",
      -            "enum": [
      -              "network",
      -              "timeout",
      -              "http",
      -              "not_json",
      -              "not_object",
      -              "invalid_input",
      -              "internal",
      -              "unexpected_shape",
      -              "radars"
      -            ],
      -            "type": "string"
      -          },
      -          "message": {
      -            "description": "The cause: the API's own message, or what went wrong.",
      -            "type": "string"
      -          },
      -          "path": {
      -            "description": "The API path requested, when a request was made.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "status": {
      -            "anyOf": [
      -              {
      -                "maximum": 9007199254740991,
      -                "minimum": -9007199254740991,
      -                "type": "integer"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The HTTP status, when the API answered one."
      -          }
      -        },
      -        "required": [
      -          "kind",
      -          "path",
      -          "status",
      -          "message"
      -        ],
      -        "type": "object"
      -      },
      -      "freshness": {
      -        "type": "null"
      -      },
      -      "measured_at": {
      -        "type": "null"
      -      },
      -      "method": {
      -        "type": "null"
      -      },
      -      "notes": {
      -        "description": "Caveats, one sentence each.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "state": {
      -        "description": "failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.",
      -        "enum": [
      -          "failed",
      -          "invalid_input"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "state",
      -      "measured_at",
      -      "method",
      -      "coverage",
      -      "freshness",
      -      "notes",
      -      "error"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "coverage": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "vendor_window": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it) and history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried).",
      +                    "properties": {
      +                      "advisories": {
      +                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "earliest_vendor_published_at": {
      +                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "held_since": {
      +                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "history_backfill": {
      +                        "anyOf": [
      +                          {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "complete",
      +                                  "in_progress",
      +                                  "not_started",
      +                                  "not_supported"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "string"
      +                              }
      +                            ]
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      +                      },
      +                      "latest_vendor_published_at": {
      +                        "description": "The latest vendor_published_at among them; null when none is held.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "vendor": {
      +                        "description": "The vendor slug.",
      +                        "type": "string"
      +                      },
      +                      "vendor_display_name": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      }
      +                    },
      +                    "required": [
      +                      "vendor",
      +                      "vendor_display_name",
      +                      "advisories",
      +                      "earliest_vendor_published_at",
      +                      "latest_vendor_published_at",
      +                      "held_since",
      +                      "history_backfill"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      +              }
      +            },
      +            "required": [
      +              "vendor_window"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "What the answer covers; null where the answer says nothing about it."
      +      },
      +      "data": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "advisory_id": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "affected_products": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "cvss_v3_score": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "description": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "known_cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The CVE IDs of cve_ids that have a record in EchelonGraph's CVE feed."
      +          },
      +          "our_first_seen_at": {
      +            "description": "When EchelonGraph first recorded the advisory; not the vendor's date.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "references": {},
      +          "rejected_cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The CVE IDs this advisory names whose CVE record was rejected (withdrawn) by its numbering authority: each is a rejected record, not an active vulnerability, whatever the advisory's text says. The vendor's withdrawn is separate and unchanged by it. [] when none is; null when that could not be checked."
      +          },
      +          "remediation": {
      +            "description": "The vendor's remediation as one text (the legacy field), beside remediations.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "remediation_items_not_stored": {
      +            "description": "Items past the 64 stored per advisory.",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "remediation_kinds": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "vendor_fix",
      +                        "workaround",
      +                        "mitigation",
      +                        "no_fix_planned",
      +                        "none_available",
      +                        "other"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "string"
      +                    }
      +                  ]
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The kinds of remediation the advisory lists (for the CVE asked about, on a by-cve row), each the vendor's own category, never read from the text: vendor_fix, workaround, mitigation, no_fix_planned, none_available or other. [] with remediation_state not_parsed is not a finding that it lists none."
      +          },
      +          "remediation_state": {
      +            "anyOf": [
      +              {
      +                "anyOf": [
      +                  {
      +                    "enum": [
      +                      "parsed",
      +                      "none_in_source",
      +                      "not_parsed",
      +                      "withdrawn"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "string"
      +                  }
      +                ]
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "parsed; none_in_source (EchelonGraph read the vendor's remediation, and it lists none for this CVE, which is not a finding that no fix exists); not_parsed (EchelonGraph does not read this vendor's remediation, or has not yet read this advisory: not a finding of none); withdrawn (the vendor rescinded the advisory)."
      +          },
      +          "remediations": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "additionalProperties": {},
      +                  "properties": {
      +                    "cve_ids": {
      +                      "anyOf": [
      +                        {
      +                          "items": {
      +                            "type": "string"
      +                          },
      +                          "type": "array"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ],
      +                      "description": "The CVEs the item covers; [] for the whole advisory."
      +                    },
      +                    "fixed_build": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "kind": {
      +                      "anyOf": [
      +                        {
      +                          "anyOf": [
      +                            {
      +                              "enum": [
      +                                "vendor_fix",
      +                                "workaround",
      +                                "mitigation",
      +                                "no_fix_planned",
      +                                "none_available",
      +                                "other"
      +                              ],
      +                              "type": "string"
      +                            },
      +                            {
      +                              "type": "string"
      +                            }
      +                          ]
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "product_count": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "product_ids": {
      +                      "anyOf": [
      +                        {
      +                          "items": {
      +                            "type": "string"
      +                          },
      +                          "type": "array"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "source_category": {
      +                      "description": "The vendor's own name for the category.",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "source_subcategory": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "text": {
      +                      "description": "The vendor's text, verbatim but for HTML markup removed, untested by EchelonGraph; at most 2,000 characters (text_truncated, text_chars).",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "text_chars": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "text_truncated": {
      +                      "type": [
      +                        "boolean",
      +                        "null"
      +                      ]
      +                    },
      +                    "url": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    }
      +                  },
      +                  "type": "object"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "Each remediation the vendor lists, with its kind, the vendor's own category."
      +          },
      +          "severity": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "summary": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "title": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_advisory_id": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_display_name": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_modified_at": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_published_at": {
      +            "description": "The date the vendor gives for the advisory.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "withdrawn": {
      +            "description": "true: the vendor withdrew (rescinded) this advisory, so it is a withdrawn advisory, not a current one.",
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "withdrawn_at": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "withdrawn_reason": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "data_truncated": {
      +        "description": "false: data is the answer whole. true: the structured result would pass 30,000 characters of JSON with data whole, so data is cut (DATA CUT): the entries of some of its lists keep only some of their fields, or the lists only some of their entries, truncated gives each, and no string is shortened. The same call with full: true returns data whole.",
      +        "type": "boolean"
      +      },
      +      "freshness": {
      +        "description": "The producing radar's last completed check (last_run_at), where the API serves one.",
      +        "type": "null"
      +      },
      +      "measured_at": {
      +        "anyOf": [
      +          {
      +            "description": "An RFC 3339 instant.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation."
      +      },
      +      "method": {
      +        "description": "How the numbers were produced.",
      +        "type": "string"
      +      },
      +      "notes": {
      +        "description": "Caveats, one sentence each.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "state": {
      +        "description": "measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.",
      +        "enum": [
      +          "measured",
      +          "not_assessed"
      +        ],
      +        "type": "string"
      +      },
      +      "truncated": {
      +        "additionalProperties": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "returned": {
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "thinned": {
      +              "const": true,
      +              "type": "boolean"
      +            },
      +            "total": {
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "total",
      +            "returned"
      +          ],
      +          "type": "object"
      +        },
      +        "description": "Present when data_truncated is true: each list of data that was cut, by its path in data (a dot between the names of an object and a list inside it), with total, its entries in the answer, returned, the entries data holds, and thinned, true when each of them keeps only some of its fields.",
      +        "propertyNames": {
      +          "type": "string"
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "state",
      +      "measured_at",
      +      "method",
      +      "coverage",
      +      "freshness",
      +      "notes",
      +      "data_truncated",
      +      "data"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "coverage": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "vendor_window": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it) and history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried).",
      +                    "properties": {
      +                      "advisories": {
      +                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "earliest_vendor_published_at": {
      +                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "held_since": {
      +                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "history_backfill": {
      +                        "anyOf": [
      +                          {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "complete",
      +                                  "in_progress",
      +                                  "not_started",
      +                                  "not_supported"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "string"
      +                              }
      +                            ]
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      +                      },
      +                      "latest_vendor_published_at": {
      +                        "description": "The latest vendor_published_at among them; null when none is held.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "vendor": {
      +                        "description": "The vendor slug.",
      +                        "type": "string"
      +                      },
      +                      "vendor_display_name": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      }
      +                    },
      +                    "required": [
      +                      "vendor",
      +                      "vendor_display_name",
      +                      "advisories",
      +                      "earliest_vendor_published_at",
      +                      "latest_vendor_published_at",
      +                      "held_since",
      +                      "history_backfill"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      +              }
      +            },
      +            "required": [
      +              "vendor_window"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "error": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "kind": {
      +            "description": "What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.",
      +            "enum": [
      +              "network",
      +              "timeout",
      +              "http",
      +              "not_json",
      +              "not_object",
      +              "invalid_input",
      +              "internal",
      +              "unexpected_shape",
      +              "radars"
      +            ],
      +            "type": "string"
      +          },
      +          "message": {
      +            "description": "The cause: the API's own message, or what went wrong.",
      +            "type": "string"
      +          },
      +          "path": {
      +            "description": "The API path requested, when a request was made.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "status": {
      +            "anyOf": [
      +              {
      +                "maximum": 9007199254740991,
      +                "minimum": -9007199254740991,
      +                "type": "integer"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The HTTP status, when the API answered one."
      +          }
      +        },
      +        "required": [
      +          "kind",
      +          "path",
      +          "status",
      +          "message"
      +        ],
      +        "type": "object"
      +      },
      +      "freshness": {
      +        "type": "null"
      +      },
      +      "measured_at": {
      +        "type": "null"
      +      },
      +      "method": {
      +        "type": "null"
      +      },
      +      "notes": {
      +        "description": "Caveats, one sentence each.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "state": {
      +        "description": "failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.",
      +        "enum": [
      +          "failed",
      +          "invalid_input"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "state",
      +      "measured_at",
      +      "method",
      +      "coverage",
      +      "freshness",
      +      "notes",
      +      "error"
      +    ],
      +    "type": "object"
      +  }
      +]
  6. Changed2 schema fields changed
    • addedInput schema / properties / full
      Added value: +{
      +  "description": "true: data in the structured result is the answer whole, however long. Without it, a structured result past 30,000 characters of JSON has its data cut (DATA CUT): in an order the note states, the entries of its longest lists keep only some of their fields, and then the lists only some of their entries; data_truncated is true, and truncated gives each list cut with its total, the number returned and whether its entries are thinned. Whole data is for a program; a client that sizes structured results, as Claude Code does against MAX_MCP_OUTPUT_TOKENS, can refuse an answer past its cap.",
      +  "type": "boolean"
      +}
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "coverage": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "vendor_window": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": false,
      -                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it) and history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried).",
      -                    "properties": {
      -                      "advisories": {
      -                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      -                        "type": [
      -                          "number",
      -                          "null"
      -                        ]
      -                      },
      -                      "earliest_vendor_published_at": {
      -                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "held_since": {
      -                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "history_backfill": {
      -                        "anyOf": [
      -                          {
      -                            "anyOf": [
      -                              {
      -                                "enum": [
      -                                  "complete",
      -                                  "in_progress",
      -                                  "not_started",
      -                                  "not_supported"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              {
      -                                "type": "string"
      -                              }
      -                            ]
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      -                      },
      -                      "latest_vendor_published_at": {
      -                        "description": "The latest vendor_published_at among them; null when none is held.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "vendor": {
      -                        "description": "The vendor slug.",
      -                        "type": "string"
      -                      },
      -                      "vendor_display_name": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      }
      -                    },
      -                    "required": [
      -                      "vendor",
      -                      "vendor_display_name",
      -                      "advisories",
      -                      "earliest_vendor_published_at",
      -                      "latest_vendor_published_at",
      -                      "held_since",
      -                      "history_backfill"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      -              }
      -            },
      -            "required": [
      -              "vendor_window"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "What the answer covers; null where the answer says nothing about it."
      -      },
      -      "data": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "advisory_id": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "affected_products": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "cvss_v3_score": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "description": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "known_cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The CVE IDs of cve_ids that have a record in EchelonGraph's CVE feed."
      -          },
      -          "our_first_seen_at": {
      -            "description": "When EchelonGraph first recorded the advisory; not the vendor's date.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "references": {},
      -          "rejected_cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The CVE IDs this advisory names whose CVE record was rejected (withdrawn) by its numbering authority: each is a rejected record, not an active vulnerability, whatever the advisory's text says. The vendor's withdrawn is separate and unchanged by it. [] when none is; null when that could not be checked."
      -          },
      -          "remediation": {
      -            "description": "The vendor's remediation as one text (the legacy field), beside remediations.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "remediation_items_not_stored": {
      -            "description": "Items past the 64 stored per advisory.",
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "remediation_kinds": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "vendor_fix",
      -                        "workaround",
      -                        "mitigation",
      -                        "no_fix_planned",
      -                        "none_available",
      -                        "other"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "string"
      -                    }
      -                  ]
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The kinds of remediation the advisory lists (for the CVE asked about, on a by-cve row), each the vendor's own category, never read from the text: vendor_fix, workaround, mitigation, no_fix_planned, none_available or other. [] with remediation_state not_parsed is not a finding that it lists none."
      -          },
      -          "remediation_state": {
      -            "anyOf": [
      -              {
      -                "anyOf": [
      -                  {
      -                    "enum": [
      -                      "parsed",
      -                      "none_in_source",
      -                      "not_parsed",
      -                      "withdrawn"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "string"
      -                  }
      -                ]
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "parsed; none_in_source (EchelonGraph read the vendor's remediation, and it lists none for this CVE, which is not a finding that no fix exists); not_parsed (EchelonGraph does not read this vendor's remediation, or has not yet read this advisory: not a finding of none); withdrawn (the vendor rescinded the advisory)."
      -          },
      -          "remediations": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "additionalProperties": {},
      -                  "properties": {
      -                    "cve_ids": {
      -                      "anyOf": [
      -                        {
      -                          "items": {
      -                            "type": "string"
      -                          },
      -                          "type": "array"
      -                        },
      -                        {
      -                          "type": "null"
      -                        }
      -                      ],
      -                      "description": "The CVEs the item covers; [] for the whole advisory."
      -                    },
      -                    "fixed_build": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "kind": {
      -                      "anyOf": [
      -                        {
      -                          "anyOf": [
      -                            {
      -                              "enum": [
      -                                "vendor_fix",
      -                                "workaround",
      -                                "mitigation",
      -                                "no_fix_planned",
      -                                "none_available",
      -                                "other"
      -                              ],
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "string"
      -                            }
      -                          ]
      -                        },
      -                        {
      -                          "type": "null"
      -                        }
      -                      ]
      -                    },
      -                    "product_count": {
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "product_ids": {
      -                      "anyOf": [
      -                        {
      -                          "items": {
      -                            "type": "string"
      -                          },
      -                          "type": "array"
      -                        },
      -                        {
      -                          "type": "null"
      -                        }
      -                      ]
      -                    },
      -                    "source_category": {
      -                      "description": "The vendor's own name for the category.",
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "source_subcategory": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "text": {
      -                      "description": "The vendor's text, verbatim but for HTML markup removed, untested by EchelonGraph; at most 2,000 characters (text_truncated, text_chars).",
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "text_chars": {
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "text_truncated": {
      -                      "type": [
      -                        "boolean",
      -                        "null"
      -                      ]
      -                    },
      -                    "url": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    }
      -                  },
      -                  "type": "object"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "Each remediation the vendor lists, with its kind, the vendor's own category."
      -          },
      -          "severity": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "summary": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "title": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_advisory_id": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_display_name": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_modified_at": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_published_at": {
      -            "description": "The date the vendor gives for the advisory.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "withdrawn": {
      -            "description": "true: the vendor withdrew (rescinded) this advisory, so it is a withdrawn advisory, not a current one.",
      -            "type": [
      -              "boolean",
      -              "null"
      -            ]
      -          },
      -          "withdrawn_at": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "withdrawn_reason": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "freshness": {
      -        "description": "The producing radar's last completed check (last_run_at), where the API serves one.",
      -        "type": "null"
      -      },
      -      "measured_at": {
      -        "anyOf": [
      -          {
      -            "description": "An RFC 3339 instant.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation."
      -      },
      -      "method": {
      -        "description": "How the numbers were produced.",
      -        "type": "string"
      -      },
      -      "notes": {
      -        "description": "Caveats, one sentence each.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "state": {
      -        "description": "measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.",
      -        "enum": [
      -          "measured",
      -          "not_assessed"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "state",
      -      "measured_at",
      -      "method",
      -      "coverage",
      -      "freshness",
      -      "notes",
      -      "data"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "coverage": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "vendor_window": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": false,
      -                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it) and history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried).",
      -                    "properties": {
      -                      "advisories": {
      -                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      -                        "type": [
      -                          "number",
      -                          "null"
      -                        ]
      -                      },
      -                      "earliest_vendor_published_at": {
      -                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "held_since": {
      -                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "history_backfill": {
      -                        "anyOf": [
      -                          {
      -                            "anyOf": [
      -                              {
      -                                "enum": [
      -                                  "complete",
      -                                  "in_progress",
      -                                  "not_started",
      -                                  "not_supported"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              {
      -                                "type": "string"
      -                              }
      -                            ]
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      -                      },
      -                      "latest_vendor_published_at": {
      -                        "description": "The latest vendor_published_at among them; null when none is held.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "vendor": {
      -                        "description": "The vendor slug.",
      -                        "type": "string"
      -                      },
      -                      "vendor_display_name": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      }
      -                    },
      -                    "required": [
      -                      "vendor",
      -                      "vendor_display_name",
      -                      "advisories",
      -                      "earliest_vendor_published_at",
      -                      "latest_vendor_published_at",
      -                      "held_since",
      -                      "history_backfill"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      -              }
      -            },
      -            "required": [
      -              "vendor_window"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "error": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "kind": {
      -            "description": "What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.",
      -            "enum": [
      -              "network",
      -              "timeout",
      -              "http",
      -              "not_json",
      -              "not_object",
      -              "invalid_input",
      -              "internal",
      -              "unexpected_shape",
      -              "radars"
      -            ],
      -            "type": "string"
      -          },
      -          "message": {
      -            "description": "The cause: the API's own message, or what went wrong.",
      -            "type": "string"
      -          },
      -          "path": {
      -            "description": "The API path requested, when a request was made.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "status": {
      -            "anyOf": [
      -              {
      -                "maximum": 9007199254740991,
      -                "minimum": -9007199254740991,
      -                "type": "integer"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The HTTP status, when the API answered one."
      -          }
      -        },
      -        "required": [
      -          "kind",
      -          "path",
      -          "status",
      -          "message"
      -        ],
      -        "type": "object"
      -      },
      -      "freshness": {
      -        "type": "null"
      -      },
      -      "measured_at": {
      -        "type": "null"
      -      },
      -      "method": {
      -        "type": "null"
      -      },
      -      "notes": {
      -        "description": "Caveats, one sentence each.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "state": {
      -        "description": "failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.",
      -        "enum": [
      -          "failed",
      -          "invalid_input"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "state",
      -      "measured_at",
      -      "method",
      -      "coverage",
      -      "freshness",
      -      "notes",
      -      "error"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "coverage": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "vendor_window": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it) and history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried).",
      +                    "properties": {
      +                      "advisories": {
      +                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "earliest_vendor_published_at": {
      +                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "held_since": {
      +                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "history_backfill": {
      +                        "anyOf": [
      +                          {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "complete",
      +                                  "in_progress",
      +                                  "not_started",
      +                                  "not_supported"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "string"
      +                              }
      +                            ]
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      +                      },
      +                      "latest_vendor_published_at": {
      +                        "description": "The latest vendor_published_at among them; null when none is held.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "vendor": {
      +                        "description": "The vendor slug.",
      +                        "type": "string"
      +                      },
      +                      "vendor_display_name": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      }
      +                    },
      +                    "required": [
      +                      "vendor",
      +                      "vendor_display_name",
      +                      "advisories",
      +                      "earliest_vendor_published_at",
      +                      "latest_vendor_published_at",
      +                      "held_since",
      +                      "history_backfill"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      +              }
      +            },
      +            "required": [
      +              "vendor_window"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "What the answer covers; null where the answer says nothing about it."
      +      },
      +      "data": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "advisory_id": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "affected_products": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "cvss_v3_score": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "description": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "known_cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The CVE IDs of cve_ids that have a record in EchelonGraph's CVE feed."
      +          },
      +          "our_first_seen_at": {
      +            "description": "When EchelonGraph first recorded the advisory; not the vendor's date.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "references": {},
      +          "rejected_cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The CVE IDs this advisory names whose CVE record was rejected (withdrawn) by its numbering authority: each is a rejected record, not an active vulnerability, whatever the advisory's text says. The vendor's withdrawn is separate and unchanged by it. [] when none is; null when that could not be checked."
      +          },
      +          "remediation": {
      +            "description": "The vendor's remediation as one text (the legacy field), beside remediations.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "remediation_items_not_stored": {
      +            "description": "Items past the 64 stored per advisory.",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "remediation_kinds": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "vendor_fix",
      +                        "workaround",
      +                        "mitigation",
      +                        "no_fix_planned",
      +                        "none_available",
      +                        "other"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "string"
      +                    }
      +                  ]
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The kinds of remediation the advisory lists (for the CVE asked about, on a by-cve row), each the vendor's own category, never read from the text: vendor_fix, workaround, mitigation, no_fix_planned, none_available or other. [] with remediation_state not_parsed is not a finding that it lists none."
      +          },
      +          "remediation_state": {
      +            "anyOf": [
      +              {
      +                "anyOf": [
      +                  {
      +                    "enum": [
      +                      "parsed",
      +                      "none_in_source",
      +                      "not_parsed",
      +                      "withdrawn"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "string"
      +                  }
      +                ]
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "parsed; none_in_source (EchelonGraph read the vendor's remediation, and it lists none for this CVE, which is not a finding that no fix exists); not_parsed (EchelonGraph does not read this vendor's remediation, or has not yet read this advisory: not a finding of none); withdrawn (the vendor rescinded the advisory)."
      +          },
      +          "remediations": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "additionalProperties": {},
      +                  "properties": {
      +                    "cve_ids": {
      +                      "anyOf": [
      +                        {
      +                          "items": {
      +                            "type": "string"
      +                          },
      +                          "type": "array"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ],
      +                      "description": "The CVEs the item covers; [] for the whole advisory."
      +                    },
      +                    "fixed_build": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "kind": {
      +                      "anyOf": [
      +                        {
      +                          "anyOf": [
      +                            {
      +                              "enum": [
      +                                "vendor_fix",
      +                                "workaround",
      +                                "mitigation",
      +                                "no_fix_planned",
      +                                "none_available",
      +                                "other"
      +                              ],
      +                              "type": "string"
      +                            },
      +                            {
      +                              "type": "string"
      +                            }
      +                          ]
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "product_count": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "product_ids": {
      +                      "anyOf": [
      +                        {
      +                          "items": {
      +                            "type": "string"
      +                          },
      +                          "type": "array"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "source_category": {
      +                      "description": "The vendor's own name for the category.",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "source_subcategory": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "text": {
      +                      "description": "The vendor's text, verbatim but for HTML markup removed, untested by EchelonGraph; at most 2,000 characters (text_truncated, text_chars).",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "text_chars": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "text_truncated": {
      +                      "type": [
      +                        "boolean",
      +                        "null"
      +                      ]
      +                    },
      +                    "url": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    }
      +                  },
      +                  "type": "object"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "Each remediation the vendor lists, with its kind, the vendor's own category."
      +          },
      +          "severity": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "summary": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "title": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_advisory_id": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_display_name": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_modified_at": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_published_at": {
      +            "description": "The date the vendor gives for the advisory.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "withdrawn": {
      +            "description": "true: the vendor withdrew (rescinded) this advisory, so it is a withdrawn advisory, not a current one.",
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "withdrawn_at": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "withdrawn_reason": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "data_truncated": {
      +        "description": "false: data is the answer whole. true: the structured result would pass 30,000 characters of JSON with data whole, so data is cut (DATA CUT): the entries of some of its lists keep only some of their fields, or the lists only some of their entries, truncated gives each, and no string is shortened. The same call with full: true returns data whole.",
      +        "type": "boolean"
      +      },
      +      "freshness": {
      +        "description": "The producing radar's last completed check (last_run_at), where the API serves one.",
      +        "type": "null"
      +      },
      +      "measured_at": {
      +        "anyOf": [
      +          {
      +            "description": "An RFC 3339 instant.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation."
      +      },
      +      "method": {
      +        "description": "How the numbers were produced.",
      +        "type": "string"
      +      },
      +      "notes": {
      +        "description": "Caveats, one sentence each.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "state": {
      +        "description": "measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.",
      +        "enum": [
      +          "measured",
      +          "not_assessed"
      +        ],
      +        "type": "string"
      +      },
      +      "truncated": {
      +        "additionalProperties": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "returned": {
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "thinned": {
      +              "const": true,
      +              "type": "boolean"
      +            },
      +            "total": {
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "total",
      +            "returned"
      +          ],
      +          "type": "object"
      +        },
      +        "description": "Present when data_truncated is true: each list of data that was cut, by its path in data (a dot between the names of an object and a list inside it), with total, its entries in the answer, returned, the entries data holds, and thinned, true when each of them keeps only some of its fields.",
      +        "propertyNames": {
      +          "type": "string"
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "state",
      +      "measured_at",
      +      "method",
      +      "coverage",
      +      "freshness",
      +      "notes",
      +      "data_truncated",
      +      "data"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "coverage": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "vendor_window": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it) and history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried).",
      +                    "properties": {
      +                      "advisories": {
      +                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "earliest_vendor_published_at": {
      +                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "held_since": {
      +                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "history_backfill": {
      +                        "anyOf": [
      +                          {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "complete",
      +                                  "in_progress",
      +                                  "not_started",
      +                                  "not_supported"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "string"
      +                              }
      +                            ]
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      +                      },
      +                      "latest_vendor_published_at": {
      +                        "description": "The latest vendor_published_at among them; null when none is held.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "vendor": {
      +                        "description": "The vendor slug.",
      +                        "type": "string"
      +                      },
      +                      "vendor_display_name": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      }
      +                    },
      +                    "required": [
      +                      "vendor",
      +                      "vendor_display_name",
      +                      "advisories",
      +                      "earliest_vendor_published_at",
      +                      "latest_vendor_published_at",
      +                      "held_since",
      +                      "history_backfill"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      +              }
      +            },
      +            "required": [
      +              "vendor_window"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "error": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "kind": {
      +            "description": "What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.",
      +            "enum": [
      +              "network",
      +              "timeout",
      +              "http",
      +              "not_json",
      +              "not_object",
      +              "invalid_input",
      +              "internal",
      +              "unexpected_shape",
      +              "radars"
      +            ],
      +            "type": "string"
      +          },
      +          "message": {
      +            "description": "The cause: the API's own message, or what went wrong.",
      +            "type": "string"
      +          },
      +          "path": {
      +            "description": "The API path requested, when a request was made.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "status": {
      +            "anyOf": [
      +              {
      +                "maximum": 9007199254740991,
      +                "minimum": -9007199254740991,
      +                "type": "integer"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The HTTP status, when the API answered one."
      +          }
      +        },
      +        "required": [
      +          "kind",
      +          "path",
      +          "status",
      +          "message"
      +        ],
      +        "type": "object"
      +      },
      +      "freshness": {
      +        "type": "null"
      +      },
      +      "measured_at": {
      +        "type": "null"
      +      },
      +      "method": {
      +        "type": "null"
      +      },
      +      "notes": {
      +        "description": "Caveats, one sentence each.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "state": {
      +        "description": "failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.",
      +        "enum": [
      +          "failed",
      +          "invalid_input"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "state",
      +      "measured_at",
      +      "method",
      +      "coverage",
      +      "freshness",
      +      "notes",
      +      "error"
      +    ],
      +    "type": "object"
      +  }
      +]
  7. Changed1 schema field changed
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "coverage": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "vendor_window": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "advisories": {
      -                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      -                        "type": [
      -                          "number",
      -                          "null"
      -                        ]
      -                      },
      -                      "earliest_vendor_published_at": {
      -                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "held_since": {
      -                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "history_backfill": {
      -                        "anyOf": [
      -                          {
      -                            "anyOf": [
      -                              {
      -                                "enum": [
      -                                  "complete",
      -                                  "in_progress",
      -                                  "not_started",
      -                                  "not_supported"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              {
      -                                "type": "string"
      -                              }
      -                            ]
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      -                      },
      -                      "latest_vendor_published_at": {
      -                        "description": "The latest vendor_published_at among them; null when none is held.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "vendor": {
      -                        "description": "The vendor slug.",
      -                        "type": "string"
      -                      },
      -                      "vendor_display_name": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      }
      -                    },
      -                    "required": [
      -                      "vendor",
      -                      "vendor_display_name",
      -                      "advisories",
      -                      "earliest_vendor_published_at",
      -                      "latest_vendor_published_at",
      -                      "held_since",
      -                      "history_backfill"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      -              }
      -            },
      -            "required": [
      -              "vendor_window"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "What the answer covers; null where the answer says nothing about it."
      -      },
      -      "data": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "advisory_id": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "affected_products": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "cvss_v3_score": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "description": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "known_cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The CVE IDs of cve_ids that have a record in EchelonGraph's CVE feed."
      -          },
      -          "our_first_seen_at": {
      -            "description": "When EchelonGraph first recorded the advisory; not the vendor's date.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "references": {},
      -          "remediation": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "severity": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "summary": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "title": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_advisory_id": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_display_name": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_modified_at": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_published_at": {
      -            "description": "The date the vendor gives for the advisory.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "withdrawn": {
      -            "description": "true: the vendor withdrew (rescinded) this advisory, so it is a withdrawn advisory, not a current one.",
      -            "type": [
      -              "boolean",
      -              "null"
      -            ]
      -          },
      -          "withdrawn_at": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "withdrawn_reason": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "freshness": {
      -        "description": "The producing radar's last completed check (last_run_at), where the API serves one.",
      -        "type": "null"
      -      },
      -      "measured_at": {
      -        "anyOf": [
      -          {
      -            "description": "An RFC 3339 instant.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation."
      -      },
      -      "method": {
      -        "description": "How the numbers were produced.",
      -        "type": "string"
      -      },
      -      "notes": {
      -        "description": "Caveats, one sentence each.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "state": {
      -        "description": "measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.",
      -        "enum": [
      -          "measured",
      -          "not_assessed"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "state",
      -      "measured_at",
      -      "method",
      -      "coverage",
      -      "freshness",
      -      "notes",
      -      "data"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "coverage": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "vendor_window": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "advisories": {
      -                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      -                        "type": [
      -                          "number",
      -                          "null"
      -                        ]
      -                      },
      -                      "earliest_vendor_published_at": {
      -                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "held_since": {
      -                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "history_backfill": {
      -                        "anyOf": [
      -                          {
      -                            "anyOf": [
      -                              {
      -                                "enum": [
      -                                  "complete",
      -                                  "in_progress",
      -                                  "not_started",
      -                                  "not_supported"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              {
      -                                "type": "string"
      -                              }
      -                            ]
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      -                      },
      -                      "latest_vendor_published_at": {
      -                        "description": "The latest vendor_published_at among them; null when none is held.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "vendor": {
      -                        "description": "The vendor slug.",
      -                        "type": "string"
      -                      },
      -                      "vendor_display_name": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      }
      -                    },
      -                    "required": [
      -                      "vendor",
      -                      "vendor_display_name",
      -                      "advisories",
      -                      "earliest_vendor_published_at",
      -                      "latest_vendor_published_at",
      -                      "held_since",
      -                      "history_backfill"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      -              }
      -            },
      -            "required": [
      -              "vendor_window"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "error": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "kind": {
      -            "description": "What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.",
      -            "enum": [
      -              "network",
      -              "timeout",
      -              "http",
      -              "not_json",
      -              "not_object",
      -              "invalid_input",
      -              "internal",
      -              "unexpected_shape",
      -              "radars"
      -            ],
      -            "type": "string"
      -          },
      -          "message": {
      -            "description": "The cause: the API's own message, or what went wrong.",
      -            "type": "string"
      -          },
      -          "path": {
      -            "description": "The API path requested, when a request was made.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "status": {
      -            "anyOf": [
      -              {
      -                "maximum": 9007199254740991,
      -                "minimum": -9007199254740991,
      -                "type": "integer"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The HTTP status, when the API answered one."
      -          }
      -        },
      -        "required": [
      -          "kind",
      -          "path",
      -          "status",
      -          "message"
      -        ],
      -        "type": "object"
      -      },
      -      "freshness": {
      -        "type": "null"
      -      },
      -      "measured_at": {
      -        "type": "null"
      -      },
      -      "method": {
      -        "type": "null"
      -      },
      -      "notes": {
      -        "description": "Caveats, one sentence each.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "state": {
      -        "description": "failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.",
      -        "enum": [
      -          "failed",
      -          "invalid_input"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "state",
      -      "measured_at",
      -      "method",
      -      "coverage",
      -      "freshness",
      -      "notes",
      -      "error"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "coverage": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "vendor_window": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it) and history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried).",
      +                    "properties": {
      +                      "advisories": {
      +                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "earliest_vendor_published_at": {
      +                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "held_since": {
      +                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "history_backfill": {
      +                        "anyOf": [
      +                          {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "complete",
      +                                  "in_progress",
      +                                  "not_started",
      +                                  "not_supported"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "string"
      +                              }
      +                            ]
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      +                      },
      +                      "latest_vendor_published_at": {
      +                        "description": "The latest vendor_published_at among them; null when none is held.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "vendor": {
      +                        "description": "The vendor slug.",
      +                        "type": "string"
      +                      },
      +                      "vendor_display_name": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      }
      +                    },
      +                    "required": [
      +                      "vendor",
      +                      "vendor_display_name",
      +                      "advisories",
      +                      "earliest_vendor_published_at",
      +                      "latest_vendor_published_at",
      +                      "held_since",
      +                      "history_backfill"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      +              }
      +            },
      +            "required": [
      +              "vendor_window"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "What the answer covers; null where the answer says nothing about it."
      +      },
      +      "data": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "advisory_id": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "affected_products": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "cvss_v3_score": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "description": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "known_cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The CVE IDs of cve_ids that have a record in EchelonGraph's CVE feed."
      +          },
      +          "our_first_seen_at": {
      +            "description": "When EchelonGraph first recorded the advisory; not the vendor's date.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "references": {},
      +          "rejected_cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The CVE IDs this advisory names whose CVE record was rejected (withdrawn) by its numbering authority: each is a rejected record, not an active vulnerability, whatever the advisory's text says. The vendor's withdrawn is separate and unchanged by it. [] when none is; null when that could not be checked."
      +          },
      +          "remediation": {
      +            "description": "The vendor's remediation as one text (the legacy field), beside remediations.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "remediation_items_not_stored": {
      +            "description": "Items past the 64 stored per advisory.",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "remediation_kinds": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "vendor_fix",
      +                        "workaround",
      +                        "mitigation",
      +                        "no_fix_planned",
      +                        "none_available",
      +                        "other"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "string"
      +                    }
      +                  ]
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The kinds of remediation the advisory lists (for the CVE asked about, on a by-cve row), each the vendor's own category, never read from the text: vendor_fix, workaround, mitigation, no_fix_planned, none_available or other. [] with remediation_state not_parsed is not a finding that it lists none."
      +          },
      +          "remediation_state": {
      +            "anyOf": [
      +              {
      +                "anyOf": [
      +                  {
      +                    "enum": [
      +                      "parsed",
      +                      "none_in_source",
      +                      "not_parsed",
      +                      "withdrawn"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "string"
      +                  }
      +                ]
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "parsed; none_in_source (EchelonGraph read the vendor's remediation, and it lists none for this CVE, which is not a finding that no fix exists); not_parsed (EchelonGraph does not read this vendor's remediation, or has not yet read this advisory: not a finding of none); withdrawn (the vendor rescinded the advisory)."
      +          },
      +          "remediations": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "additionalProperties": {},
      +                  "properties": {
      +                    "cve_ids": {
      +                      "anyOf": [
      +                        {
      +                          "items": {
      +                            "type": "string"
      +                          },
      +                          "type": "array"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ],
      +                      "description": "The CVEs the item covers; [] for the whole advisory."
      +                    },
      +                    "fixed_build": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "kind": {
      +                      "anyOf": [
      +                        {
      +                          "anyOf": [
      +                            {
      +                              "enum": [
      +                                "vendor_fix",
      +                                "workaround",
      +                                "mitigation",
      +                                "no_fix_planned",
      +                                "none_available",
      +                                "other"
      +                              ],
      +                              "type": "string"
      +                            },
      +                            {
      +                              "type": "string"
      +                            }
      +                          ]
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "product_count": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "product_ids": {
      +                      "anyOf": [
      +                        {
      +                          "items": {
      +                            "type": "string"
      +                          },
      +                          "type": "array"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "source_category": {
      +                      "description": "The vendor's own name for the category.",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "source_subcategory": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "text": {
      +                      "description": "The vendor's text, verbatim but for HTML markup removed, untested by EchelonGraph; at most 2,000 characters (text_truncated, text_chars).",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "text_chars": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "text_truncated": {
      +                      "type": [
      +                        "boolean",
      +                        "null"
      +                      ]
      +                    },
      +                    "url": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    }
      +                  },
      +                  "type": "object"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "Each remediation the vendor lists, with its kind, the vendor's own category."
      +          },
      +          "severity": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "summary": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "title": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_advisory_id": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_display_name": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_modified_at": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_published_at": {
      +            "description": "The date the vendor gives for the advisory.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "withdrawn": {
      +            "description": "true: the vendor withdrew (rescinded) this advisory, so it is a withdrawn advisory, not a current one.",
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "withdrawn_at": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "withdrawn_reason": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "freshness": {
      +        "description": "The producing radar's last completed check (last_run_at), where the API serves one.",
      +        "type": "null"
      +      },
      +      "measured_at": {
      +        "anyOf": [
      +          {
      +            "description": "An RFC 3339 instant.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation."
      +      },
      +      "method": {
      +        "description": "How the numbers were produced.",
      +        "type": "string"
      +      },
      +      "notes": {
      +        "description": "Caveats, one sentence each.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "state": {
      +        "description": "measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.",
      +        "enum": [
      +          "measured",
      +          "not_assessed"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "state",
      +      "measured_at",
      +      "method",
      +      "coverage",
      +      "freshness",
      +      "notes",
      +      "data"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "coverage": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "vendor_window": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it) and history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried).",
      +                    "properties": {
      +                      "advisories": {
      +                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "earliest_vendor_published_at": {
      +                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "held_since": {
      +                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "history_backfill": {
      +                        "anyOf": [
      +                          {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "complete",
      +                                  "in_progress",
      +                                  "not_started",
      +                                  "not_supported"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "string"
      +                              }
      +                            ]
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      +                      },
      +                      "latest_vendor_published_at": {
      +                        "description": "The latest vendor_published_at among them; null when none is held.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "vendor": {
      +                        "description": "The vendor slug.",
      +                        "type": "string"
      +                      },
      +                      "vendor_display_name": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      }
      +                    },
      +                    "required": [
      +                      "vendor",
      +                      "vendor_display_name",
      +                      "advisories",
      +                      "earliest_vendor_published_at",
      +                      "latest_vendor_published_at",
      +                      "held_since",
      +                      "history_backfill"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      +              }
      +            },
      +            "required": [
      +              "vendor_window"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "error": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "kind": {
      +            "description": "What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.",
      +            "enum": [
      +              "network",
      +              "timeout",
      +              "http",
      +              "not_json",
      +              "not_object",
      +              "invalid_input",
      +              "internal",
      +              "unexpected_shape",
      +              "radars"
      +            ],
      +            "type": "string"
      +          },
      +          "message": {
      +            "description": "The cause: the API's own message, or what went wrong.",
      +            "type": "string"
      +          },
      +          "path": {
      +            "description": "The API path requested, when a request was made.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "status": {
      +            "anyOf": [
      +              {
      +                "maximum": 9007199254740991,
      +                "minimum": -9007199254740991,
      +                "type": "integer"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The HTTP status, when the API answered one."
      +          }
      +        },
      +        "required": [
      +          "kind",
      +          "path",
      +          "status",
      +          "message"
      +        ],
      +        "type": "object"
      +      },
      +      "freshness": {
      +        "type": "null"
      +      },
      +      "measured_at": {
      +        "type": "null"
      +      },
      +      "method": {
      +        "type": "null"
      +      },
      +      "notes": {
      +        "description": "Caveats, one sentence each.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "state": {
      +        "description": "failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.",
      +        "enum": [
      +          "failed",
      +          "invalid_input"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "state",
      +      "measured_at",
      +      "method",
      +      "coverage",
      +      "freshness",
      +      "notes",
      +      "error"
      +    ],
      +    "type": "object"
      +  }
      +]
  8. Changed1 schema field changed
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "coverage": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "vendor_window": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "advisories": {
      -                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      -                        "type": [
      -                          "number",
      -                          "null"
      -                        ]
      -                      },
      -                      "earliest_vendor_published_at": {
      -                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "held_since": {
      -                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "history_backfill": {
      -                        "anyOf": [
      -                          {
      -                            "anyOf": [
      -                              {
      -                                "enum": [
      -                                  "complete",
      -                                  "in_progress",
      -                                  "not_started",
      -                                  "not_supported"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              {
      -                                "type": "string"
      -                              }
      -                            ]
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      -                      },
      -                      "latest_vendor_published_at": {
      -                        "description": "The latest vendor_published_at among them; null when none is held.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "vendor": {
      -                        "description": "The vendor slug.",
      -                        "type": "string"
      -                      },
      -                      "vendor_display_name": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      }
      -                    },
      -                    "required": [
      -                      "vendor",
      -                      "vendor_display_name",
      -                      "advisories",
      -                      "earliest_vendor_published_at",
      -                      "latest_vendor_published_at",
      -                      "held_since",
      -                      "history_backfill"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      -              }
      -            },
      -            "required": [
      -              "vendor_window"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "What the answer covers; null where the answer says nothing about it."
      -      },
      -      "data": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "advisory_id": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "affected_products": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "cvss_v3_score": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "description": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "known_cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The CVE IDs of cve_ids that have a record in EchelonGraph's CVE feed."
      -          },
      -          "our_first_seen_at": {
      -            "description": "When EchelonGraph first recorded the advisory; not the vendor's date.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "references": {},
      -          "remediation": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "severity": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "summary": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "title": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_advisory_id": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_display_name": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_modified_at": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_published_at": {
      -            "description": "The date the vendor gives for the advisory.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "withdrawn": {
      -            "description": "true: the vendor withdrew (rescinded) this advisory; report it as withdrawn.",
      -            "type": [
      -              "boolean",
      -              "null"
      -            ]
      -          },
      -          "withdrawn_at": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "withdrawn_reason": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "freshness": {
      -        "description": "The producing radar's last completed check (last_run_at), where the API serves one.",
      -        "type": "null"
      -      },
      -      "measured_at": {
      -        "anyOf": [
      -          {
      -            "description": "An RFC 3339 instant.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation."
      -      },
      -      "method": {
      -        "description": "How the numbers were produced.",
      -        "type": "string"
      -      },
      -      "notes": {
      -        "description": "Caveats, one sentence each.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "state": {
      -        "description": "measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.",
      -        "enum": [
      -          "measured",
      -          "not_assessed"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "state",
      -      "measured_at",
      -      "method",
      -      "coverage",
      -      "freshness",
      -      "notes",
      -      "data"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "coverage": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "vendor_window": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "advisories": {
      -                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      -                        "type": [
      -                          "number",
      -                          "null"
      -                        ]
      -                      },
      -                      "earliest_vendor_published_at": {
      -                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "held_since": {
      -                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "history_backfill": {
      -                        "anyOf": [
      -                          {
      -                            "anyOf": [
      -                              {
      -                                "enum": [
      -                                  "complete",
      -                                  "in_progress",
      -                                  "not_started",
      -                                  "not_supported"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              {
      -                                "type": "string"
      -                              }
      -                            ]
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      -                      },
      -                      "latest_vendor_published_at": {
      -                        "description": "The latest vendor_published_at among them; null when none is held.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "vendor": {
      -                        "description": "The vendor slug.",
      -                        "type": "string"
      -                      },
      -                      "vendor_display_name": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      }
      -                    },
      -                    "required": [
      -                      "vendor",
      -                      "vendor_display_name",
      -                      "advisories",
      -                      "earliest_vendor_published_at",
      -                      "latest_vendor_published_at",
      -                      "held_since",
      -                      "history_backfill"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      -              }
      -            },
      -            "required": [
      -              "vendor_window"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "error": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "kind": {
      -            "description": "What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.",
      -            "enum": [
      -              "network",
      -              "timeout",
      -              "http",
      -              "not_json",
      -              "not_object",
      -              "invalid_input",
      -              "internal",
      -              "unexpected_shape",
      -              "radars"
      -            ],
      -            "type": "string"
      -          },
      -          "message": {
      -            "description": "The cause: the API's own message, or what went wrong.",
      -            "type": "string"
      -          },
      -          "path": {
      -            "description": "The API path requested, when a request was made.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "status": {
      -            "anyOf": [
      -              {
      -                "maximum": 9007199254740991,
      -                "minimum": -9007199254740991,
      -                "type": "integer"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The HTTP status, when the API answered one."
      -          }
      -        },
      -        "required": [
      -          "kind",
      -          "path",
      -          "status",
      -          "message"
      -        ],
      -        "type": "object"
      -      },
      -      "freshness": {
      -        "type": "null"
      -      },
      -      "measured_at": {
      -        "type": "null"
      -      },
      -      "method": {
      -        "type": "null"
      -      },
      -      "notes": {
      -        "description": "Caveats, one sentence each.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "state": {
      -        "description": "failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.",
      -        "enum": [
      -          "failed",
      -          "invalid_input"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "state",
      -      "measured_at",
      -      "method",
      -      "coverage",
      -      "freshness",
      -      "notes",
      -      "error"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "coverage": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "vendor_window": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "advisories": {
      +                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "earliest_vendor_published_at": {
      +                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "held_since": {
      +                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "history_backfill": {
      +                        "anyOf": [
      +                          {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "complete",
      +                                  "in_progress",
      +                                  "not_started",
      +                                  "not_supported"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "string"
      +                              }
      +                            ]
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      +                      },
      +                      "latest_vendor_published_at": {
      +                        "description": "The latest vendor_published_at among them; null when none is held.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "vendor": {
      +                        "description": "The vendor slug.",
      +                        "type": "string"
      +                      },
      +                      "vendor_display_name": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      }
      +                    },
      +                    "required": [
      +                      "vendor",
      +                      "vendor_display_name",
      +                      "advisories",
      +                      "earliest_vendor_published_at",
      +                      "latest_vendor_published_at",
      +                      "held_since",
      +                      "history_backfill"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      +              }
      +            },
      +            "required": [
      +              "vendor_window"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "What the answer covers; null where the answer says nothing about it."
      +      },
      +      "data": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "advisory_id": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "affected_products": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "cvss_v3_score": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "description": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "known_cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The CVE IDs of cve_ids that have a record in EchelonGraph's CVE feed."
      +          },
      +          "our_first_seen_at": {
      +            "description": "When EchelonGraph first recorded the advisory; not the vendor's date.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "references": {},
      +          "remediation": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "severity": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "summary": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "title": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_advisory_id": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_display_name": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_modified_at": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_published_at": {
      +            "description": "The date the vendor gives for the advisory.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "withdrawn": {
      +            "description": "true: the vendor withdrew (rescinded) this advisory, so it is a withdrawn advisory, not a current one.",
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "withdrawn_at": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "withdrawn_reason": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "freshness": {
      +        "description": "The producing radar's last completed check (last_run_at), where the API serves one.",
      +        "type": "null"
      +      },
      +      "measured_at": {
      +        "anyOf": [
      +          {
      +            "description": "An RFC 3339 instant.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation."
      +      },
      +      "method": {
      +        "description": "How the numbers were produced.",
      +        "type": "string"
      +      },
      +      "notes": {
      +        "description": "Caveats, one sentence each.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "state": {
      +        "description": "measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.",
      +        "enum": [
      +          "measured",
      +          "not_assessed"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "state",
      +      "measured_at",
      +      "method",
      +      "coverage",
      +      "freshness",
      +      "notes",
      +      "data"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "coverage": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "vendor_window": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "advisories": {
      +                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "earliest_vendor_published_at": {
      +                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "held_since": {
      +                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "history_backfill": {
      +                        "anyOf": [
      +                          {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "complete",
      +                                  "in_progress",
      +                                  "not_started",
      +                                  "not_supported"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "string"
      +                              }
      +                            ]
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      +                      },
      +                      "latest_vendor_published_at": {
      +                        "description": "The latest vendor_published_at among them; null when none is held.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "vendor": {
      +                        "description": "The vendor slug.",
      +                        "type": "string"
      +                      },
      +                      "vendor_display_name": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      }
      +                    },
      +                    "required": [
      +                      "vendor",
      +                      "vendor_display_name",
      +                      "advisories",
      +                      "earliest_vendor_published_at",
      +                      "latest_vendor_published_at",
      +                      "held_since",
      +                      "history_backfill"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      +              }
      +            },
      +            "required": [
      +              "vendor_window"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "error": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "kind": {
      +            "description": "What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.",
      +            "enum": [
      +              "network",
      +              "timeout",
      +              "http",
      +              "not_json",
      +              "not_object",
      +              "invalid_input",
      +              "internal",
      +              "unexpected_shape",
      +              "radars"
      +            ],
      +            "type": "string"
      +          },
      +          "message": {
      +            "description": "The cause: the API's own message, or what went wrong.",
      +            "type": "string"
      +          },
      +          "path": {
      +            "description": "The API path requested, when a request was made.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "status": {
      +            "anyOf": [
      +              {
      +                "maximum": 9007199254740991,
      +                "minimum": -9007199254740991,
      +                "type": "integer"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The HTTP status, when the API answered one."
      +          }
      +        },
      +        "required": [
      +          "kind",
      +          "path",
      +          "status",
      +          "message"
      +        ],
      +        "type": "object"
      +      },
      +      "freshness": {
      +        "type": "null"
      +      },
      +      "measured_at": {
      +        "type": "null"
      +      },
      +      "method": {
      +        "type": "null"
      +      },
      +      "notes": {
      +        "description": "Caveats, one sentence each.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "state": {
      +        "description": "failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.",
      +        "enum": [
      +          "failed",
      +          "invalid_input"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "state",
      +      "measured_at",
      +      "method",
      +      "coverage",
      +      "freshness",
      +      "notes",
      +      "error"
      +    ],
      +    "type": "object"
      +  }
      +]
  9. Changed1 schema field changed
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "coverage": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "vendor_window": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "advisories": {
      -                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      -                        "type": [
      -                          "number",
      -                          "null"
      -                        ]
      -                      },
      -                      "earliest_vendor_published_at": {
      -                        "description": "The earliest vendor_published_at among them; null when none is held. An advisory this vendor published before it is not held.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "history_backfill": {
      -                        "anyOf": [
      -                          {
      -                            "anyOf": [
      -                              {
      -                                "enum": [
      -                                  "complete",
      -                                  "in_progress",
      -                                  "not_started",
      -                                  "not_supported"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              {
      -                                "type": "string"
      -                              }
      -                            ]
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      -                      },
      -                      "latest_vendor_published_at": {
      -                        "description": "The latest vendor_published_at among them; null when none is held.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "vendor": {
      -                        "description": "The vendor slug.",
      -                        "type": "string"
      -                      },
      -                      "vendor_display_name": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      }
      -                    },
      -                    "required": [
      -                      "vendor",
      -                      "vendor_display_name",
      -                      "advisories",
      -                      "earliest_vendor_published_at",
      -                      "latest_vendor_published_at",
      -                      "history_backfill"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      -              }
      -            },
      -            "required": [
      -              "vendor_window"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "What the answer covers; null where the answer says nothing about it."
      -      },
      -      "data": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "advisory_id": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "affected_products": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "cvss_v3_score": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "description": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "known_cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The CVE IDs of cve_ids that have a record in EchelonGraph's CVE feed."
      -          },
      -          "our_first_seen_at": {
      -            "description": "When EchelonGraph first recorded the advisory; not the vendor's date.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "references": {},
      -          "remediation": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "severity": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "summary": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "title": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_advisory_id": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_display_name": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_modified_at": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_published_at": {
      -            "description": "The date the vendor gives for the advisory.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "withdrawn": {
      -            "description": "true: the vendor withdrew (rescinded) this advisory; report it as withdrawn.",
      -            "type": [
      -              "boolean",
      -              "null"
      -            ]
      -          },
      -          "withdrawn_at": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "withdrawn_reason": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "freshness": {
      -        "description": "The producing radar's last completed check (last_run_at), where the API serves one.",
      -        "type": "null"
      -      },
      -      "measured_at": {
      -        "anyOf": [
      -          {
      -            "description": "An RFC 3339 instant.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation."
      -      },
      -      "method": {
      -        "description": "How the numbers were produced.",
      -        "type": "string"
      -      },
      -      "notes": {
      -        "description": "Caveats, one sentence each.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "state": {
      -        "description": "measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.",
      -        "enum": [
      -          "measured",
      -          "not_assessed"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "state",
      -      "measured_at",
      -      "method",
      -      "coverage",
      -      "freshness",
      -      "notes",
      -      "data"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "coverage": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "vendor_window": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "advisories": {
      -                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      -                        "type": [
      -                          "number",
      -                          "null"
      -                        ]
      -                      },
      -                      "earliest_vendor_published_at": {
      -                        "description": "The earliest vendor_published_at among them; null when none is held. An advisory this vendor published before it is not held.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "history_backfill": {
      -                        "anyOf": [
      -                          {
      -                            "anyOf": [
      -                              {
      -                                "enum": [
      -                                  "complete",
      -                                  "in_progress",
      -                                  "not_started",
      -                                  "not_supported"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              {
      -                                "type": "string"
      -                              }
      -                            ]
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      -                      },
      -                      "latest_vendor_published_at": {
      -                        "description": "The latest vendor_published_at among them; null when none is held.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "vendor": {
      -                        "description": "The vendor slug.",
      -                        "type": "string"
      -                      },
      -                      "vendor_display_name": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      }
      -                    },
      -                    "required": [
      -                      "vendor",
      -                      "vendor_display_name",
      -                      "advisories",
      -                      "earliest_vendor_published_at",
      -                      "latest_vendor_published_at",
      -                      "history_backfill"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      -              }
      -            },
      -            "required": [
      -              "vendor_window"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "error": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "kind": {
      -            "description": "What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.",
      -            "enum": [
      -              "network",
      -              "timeout",
      -              "http",
      -              "not_json",
      -              "not_object",
      -              "invalid_input",
      -              "internal",
      -              "unexpected_shape",
      -              "radars"
      -            ],
      -            "type": "string"
      -          },
      -          "message": {
      -            "description": "The cause: the API's own message, or what went wrong.",
      -            "type": "string"
      -          },
      -          "path": {
      -            "description": "The API path requested, when a request was made.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "status": {
      -            "anyOf": [
      -              {
      -                "maximum": 9007199254740991,
      -                "minimum": -9007199254740991,
      -                "type": "integer"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The HTTP status, when the API answered one."
      -          }
      -        },
      -        "required": [
      -          "kind",
      -          "path",
      -          "status",
      -          "message"
      -        ],
      -        "type": "object"
      -      },
      -      "freshness": {
      -        "type": "null"
      -      },
      -      "measured_at": {
      -        "type": "null"
      -      },
      -      "method": {
      -        "type": "null"
      -      },
      -      "notes": {
      -        "description": "Caveats, one sentence each.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "state": {
      -        "description": "failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.",
      -        "enum": [
      -          "failed",
      -          "invalid_input"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "state",
      -      "measured_at",
      -      "method",
      -      "coverage",
      -      "freshness",
      -      "notes",
      -      "error"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "coverage": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "vendor_window": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "advisories": {
      +                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "earliest_vendor_published_at": {
      +                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "held_since": {
      +                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "history_backfill": {
      +                        "anyOf": [
      +                          {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "complete",
      +                                  "in_progress",
      +                                  "not_started",
      +                                  "not_supported"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "string"
      +                              }
      +                            ]
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      +                      },
      +                      "latest_vendor_published_at": {
      +                        "description": "The latest vendor_published_at among them; null when none is held.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "vendor": {
      +                        "description": "The vendor slug.",
      +                        "type": "string"
      +                      },
      +                      "vendor_display_name": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      }
      +                    },
      +                    "required": [
      +                      "vendor",
      +                      "vendor_display_name",
      +                      "advisories",
      +                      "earliest_vendor_published_at",
      +                      "latest_vendor_published_at",
      +                      "held_since",
      +                      "history_backfill"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      +              }
      +            },
      +            "required": [
      +              "vendor_window"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "What the answer covers; null where the answer says nothing about it."
      +      },
      +      "data": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "advisory_id": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "affected_products": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "cvss_v3_score": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "description": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "known_cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The CVE IDs of cve_ids that have a record in EchelonGraph's CVE feed."
      +          },
      +          "our_first_seen_at": {
      +            "description": "When EchelonGraph first recorded the advisory; not the vendor's date.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "references": {},
      +          "remediation": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "severity": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "summary": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "title": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_advisory_id": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_display_name": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_modified_at": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_published_at": {
      +            "description": "The date the vendor gives for the advisory.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "withdrawn": {
      +            "description": "true: the vendor withdrew (rescinded) this advisory; report it as withdrawn.",
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "withdrawn_at": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "withdrawn_reason": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "freshness": {
      +        "description": "The producing radar's last completed check (last_run_at), where the API serves one.",
      +        "type": "null"
      +      },
      +      "measured_at": {
      +        "anyOf": [
      +          {
      +            "description": "An RFC 3339 instant.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation."
      +      },
      +      "method": {
      +        "description": "How the numbers were produced.",
      +        "type": "string"
      +      },
      +      "notes": {
      +        "description": "Caveats, one sentence each.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "state": {
      +        "description": "measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.",
      +        "enum": [
      +          "measured",
      +          "not_assessed"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "state",
      +      "measured_at",
      +      "method",
      +      "coverage",
      +      "freshness",
      +      "notes",
      +      "data"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "coverage": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "vendor_window": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "advisories": {
      +                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "earliest_vendor_published_at": {
      +                        "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "held_since": {
      +                        "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "history_backfill": {
      +                        "anyOf": [
      +                          {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "complete",
      +                                  "in_progress",
      +                                  "not_started",
      +                                  "not_supported"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "string"
      +                              }
      +                            ]
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      +                      },
      +                      "latest_vendor_published_at": {
      +                        "description": "The latest vendor_published_at among them; null when none is held.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "vendor": {
      +                        "description": "The vendor slug.",
      +                        "type": "string"
      +                      },
      +                      "vendor_display_name": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      }
      +                    },
      +                    "required": [
      +                      "vendor",
      +                      "vendor_display_name",
      +                      "advisories",
      +                      "earliest_vendor_published_at",
      +                      "latest_vendor_published_at",
      +                      "held_since",
      +                      "history_backfill"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      +              }
      +            },
      +            "required": [
      +              "vendor_window"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "error": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "kind": {
      +            "description": "What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.",
      +            "enum": [
      +              "network",
      +              "timeout",
      +              "http",
      +              "not_json",
      +              "not_object",
      +              "invalid_input",
      +              "internal",
      +              "unexpected_shape",
      +              "radars"
      +            ],
      +            "type": "string"
      +          },
      +          "message": {
      +            "description": "The cause: the API's own message, or what went wrong.",
      +            "type": "string"
      +          },
      +          "path": {
      +            "description": "The API path requested, when a request was made.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "status": {
      +            "anyOf": [
      +              {
      +                "maximum": 9007199254740991,
      +                "minimum": -9007199254740991,
      +                "type": "integer"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The HTTP status, when the API answered one."
      +          }
      +        },
      +        "required": [
      +          "kind",
      +          "path",
      +          "status",
      +          "message"
      +        ],
      +        "type": "object"
      +      },
      +      "freshness": {
      +        "type": "null"
      +      },
      +      "measured_at": {
      +        "type": "null"
      +      },
      +      "method": {
      +        "type": "null"
      +      },
      +      "notes": {
      +        "description": "Caveats, one sentence each.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "state": {
      +        "description": "failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.",
      +        "enum": [
      +          "failed",
      +          "invalid_input"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "state",
      +      "measured_at",
      +      "method",
      +      "coverage",
      +      "freshness",
      +      "notes",
      +      "error"
      +    ],
      +    "type": "object"
      +  }
      +]
  10. Changed1 schema field changed
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "coverage": {
      -        "description": "What the answer covers; null where the answer says nothing about it.",
      -        "type": "null"
      -      },
      -      "data": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "advisory_id": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "affected_products": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "cvss_v3_score": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "description": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "known_cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The CVE IDs of cve_ids that have a record in EchelonGraph's CVE feed."
      -          },
      -          "our_first_seen_at": {
      -            "description": "When EchelonGraph first recorded the advisory; not the vendor's date.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "references": {},
      -          "remediation": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "severity": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "summary": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "title": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_advisory_id": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_display_name": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_modified_at": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_published_at": {
      -            "description": "The date the vendor gives for the advisory.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "withdrawn": {
      -            "description": "true: the vendor withdrew (rescinded) this advisory; report it as withdrawn.",
      -            "type": [
      -              "boolean",
      -              "null"
      -            ]
      -          },
      -          "withdrawn_at": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "withdrawn_reason": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "freshness": {
      -        "description": "The producing radar's last completed check (last_run_at), where the API serves one.",
      -        "type": "null"
      -      },
      -      "measured_at": {
      -        "anyOf": [
      -          {
      -            "description": "An RFC 3339 instant.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation."
      -      },
      -      "method": {
      -        "description": "How the numbers were produced.",
      -        "type": "string"
      -      },
      -      "notes": {
      -        "description": "Caveats, one sentence each.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "state": {
      -        "description": "measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.",
      -        "enum": [
      -          "measured",
      -          "not_assessed"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "state",
      -      "measured_at",
      -      "method",
      -      "coverage",
      -      "freshness",
      -      "notes",
      -      "data"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "coverage": {
      -        "type": "null"
      -      },
      -      "error": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "kind": {
      -            "description": "What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.",
      -            "enum": [
      -              "network",
      -              "timeout",
      -              "http",
      -              "not_json",
      -              "not_object",
      -              "invalid_input",
      -              "internal",
      -              "unexpected_shape",
      -              "radars"
      -            ],
      -            "type": "string"
      -          },
      -          "message": {
      -            "description": "The cause: the API's own message, or what went wrong.",
      -            "type": "string"
      -          },
      -          "path": {
      -            "description": "The API path requested, when a request was made.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "status": {
      -            "anyOf": [
      -              {
      -                "maximum": 9007199254740991,
      -                "minimum": -9007199254740991,
      -                "type": "integer"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "The HTTP status, when the API answered one."
      -          }
      -        },
      -        "required": [
      -          "kind",
      -          "path",
      -          "status",
      -          "message"
      -        ],
      -        "type": "object"
      -      },
      -      "freshness": {
      -        "type": "null"
      -      },
      -      "measured_at": {
      -        "type": "null"
      -      },
      -      "method": {
      -        "type": "null"
      -      },
      -      "notes": {
      -        "description": "Caveats, one sentence each.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "state": {
      -        "description": "failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.",
      -        "enum": [
      -          "failed",
      -          "invalid_input"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "state",
      -      "measured_at",
      -      "method",
      -      "coverage",
      -      "freshness",
      -      "notes",
      -      "error"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "coverage": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "vendor_window": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "advisories": {
      +                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "earliest_vendor_published_at": {
      +                        "description": "The earliest vendor_published_at among them; null when none is held. An advisory this vendor published before it is not held.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "history_backfill": {
      +                        "anyOf": [
      +                          {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "complete",
      +                                  "in_progress",
      +                                  "not_started",
      +                                  "not_supported"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "string"
      +                              }
      +                            ]
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      +                      },
      +                      "latest_vendor_published_at": {
      +                        "description": "The latest vendor_published_at among them; null when none is held.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "vendor": {
      +                        "description": "The vendor slug.",
      +                        "type": "string"
      +                      },
      +                      "vendor_display_name": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      }
      +                    },
      +                    "required": [
      +                      "vendor",
      +                      "vendor_display_name",
      +                      "advisories",
      +                      "earliest_vendor_published_at",
      +                      "latest_vendor_published_at",
      +                      "history_backfill"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      +              }
      +            },
      +            "required": [
      +              "vendor_window"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "What the answer covers; null where the answer says nothing about it."
      +      },
      +      "data": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "advisory_id": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "affected_products": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "cvss_v3_score": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "description": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "known_cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The CVE IDs of cve_ids that have a record in EchelonGraph's CVE feed."
      +          },
      +          "our_first_seen_at": {
      +            "description": "When EchelonGraph first recorded the advisory; not the vendor's date.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "references": {},
      +          "remediation": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "severity": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "summary": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "title": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_advisory_id": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_display_name": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_modified_at": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_published_at": {
      +            "description": "The date the vendor gives for the advisory.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "withdrawn": {
      +            "description": "true: the vendor withdrew (rescinded) this advisory; report it as withdrawn.",
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "withdrawn_at": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "withdrawn_reason": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "freshness": {
      +        "description": "The producing radar's last completed check (last_run_at), where the API serves one.",
      +        "type": "null"
      +      },
      +      "measured_at": {
      +        "anyOf": [
      +          {
      +            "description": "An RFC 3339 instant.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation."
      +      },
      +      "method": {
      +        "description": "How the numbers were produced.",
      +        "type": "string"
      +      },
      +      "notes": {
      +        "description": "Caveats, one sentence each.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "state": {
      +        "description": "measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.",
      +        "enum": [
      +          "measured",
      +          "not_assessed"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "state",
      +      "measured_at",
      +      "method",
      +      "coverage",
      +      "freshness",
      +      "notes",
      +      "data"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "coverage": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "vendor_window": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "advisories": {
      +                        "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "earliest_vendor_published_at": {
      +                        "description": "The earliest vendor_published_at among them; null when none is held. An advisory this vendor published before it is not held.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "history_backfill": {
      +                        "anyOf": [
      +                          {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "complete",
      +                                  "in_progress",
      +                                  "not_started",
      +                                  "not_supported"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "string"
      +                              }
      +                            ]
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
      +                      },
      +                      "latest_vendor_published_at": {
      +                        "description": "The latest vendor_published_at among them; null when none is held.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "vendor": {
      +                        "description": "The vendor slug.",
      +                        "type": "string"
      +                      },
      +                      "vendor_display_name": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      }
      +                    },
      +                    "required": [
      +                      "vendor",
      +                      "vendor_display_name",
      +                      "advisories",
      +                      "earliest_vendor_published_at",
      +                      "latest_vendor_published_at",
      +                      "history_backfill"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
      +              }
      +            },
      +            "required": [
      +              "vendor_window"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "error": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "kind": {
      +            "description": "What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.",
      +            "enum": [
      +              "network",
      +              "timeout",
      +              "http",
      +              "not_json",
      +              "not_object",
      +              "invalid_input",
      +              "internal",
      +              "unexpected_shape",
      +              "radars"
      +            ],
      +            "type": "string"
      +          },
      +          "message": {
      +            "description": "The cause: the API's own message, or what went wrong.",
      +            "type": "string"
      +          },
      +          "path": {
      +            "description": "The API path requested, when a request was made.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "status": {
      +            "anyOf": [
      +              {
      +                "maximum": 9007199254740991,
      +                "minimum": -9007199254740991,
      +                "type": "integer"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The HTTP status, when the API answered one."
      +          }
      +        },
      +        "required": [
      +          "kind",
      +          "path",
      +          "status",
      +          "message"
      +        ],
      +        "type": "object"
      +      },
      +      "freshness": {
      +        "type": "null"
      +      },
      +      "measured_at": {
      +        "type": "null"
      +      },
      +      "method": {
      +        "type": "null"
      +      },
      +      "notes": {
      +        "description": "Caveats, one sentence each.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "state": {
      +        "description": "failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.",
      +        "enum": [
      +          "failed",
      +          "invalid_input"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "state",
      +      "measured_at",
      +      "method",
      +      "coverage",
      +      "freshness",
      +      "notes",
      +      "error"
      +    ],
      +    "type": "object"
      +  }
      +]
  11. First observed

TDQS

A3.9/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly/openWorld/idempotent/non-destructive, and the description still adds substantial context they do not cover: the 30,000-character cut, TEXT CUT vs DATA CUT behavior, what the note explains about omissions, the Microsoft vendor_text_withheld case where description and remediation texts are empty, and that remediation texts are verbatim and untested. It also flags that remediation_state none_in_source/not_parsed is not evidence that no fix exists, which is a real interpretive trap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The lead is well front-loaded and identifies the tool immediately, but the remainder is a single dense block of semicolon-chained field notes with nested parentheticals that is hard to scan. Much of that field-by-field enumeration duplicates the output schema rather than earning its place in the description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a read-only single-record fetch with a full output schema, the definition covers the non-obvious parts: truncation escape hatch, withheld-text vendors, withdrawn/rejected CVE semantics, and coverage-window fields whose meanings are not self-evident. It is arguably over-complete on return fields the output schema already documents, but nothing an agent needs to call it correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3; the description earns an extra point by hammering the vendor_advisory_id vs internal advisory_id distinction and by tying 'full: true' to the truncation consequences described in the body. It does not add new syntax beyond the schema, but it reinforces the one parameter most likely to be supplied incorrectly.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening clause states a specific verb and resource: 'One vendor advisory in full, by vendor and advisory ID.' It further disambiguates the identifier ('the vendor_advisory_id of a vendor advisory row, never its advisory_id'), which prevents a common wrong call. It stops short of naming the sibling listing tool (search_vendor_advisories), so differentiation is inferred from 'in full' rather than stated.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is only implied: this returns one advisory in full, versus the sibling search tools that return many. There is no explicit 'use this when you already have vendor + advisory ID; use search_vendor_advisories when you do not' routing, and no stated prerequisites. The reader can infer the case, but the description never spells it out.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.