Skip to main content
Glama
echelongraph

EchelonGraph MCP Server

Official

Am I affected? (product or package at a version)

check_affected
Read-onlyIdempotent

Check whether a product or package version is affected by known CVEs via CPE or registry lookups, returning CVE matches, fixed versions, and severity.

Instructions

Whether a product or package at a given version is affected by known CVEs, from the same matcher as echelongraph.io/am-i-affected. The CPE path takes product (an NVD CPE product token, such as nginx) and version, and returns the CVEs whose NVD CPE match criteria include that product at that version; each match names the vendor NVD asserts (cpe_vendor) and whether it was verified (vendor_unknown). The registry path takes ecosystem (npm, PyPI, Maven and other OSV ecosystem names), package and version, and decides each OSV advisory EchelonGraph holds for that package as affected, not affected or undetermined. count depends on assessed: assessed false means the lookup did not evaluate this component, not_assessed_reason says why, and a count of 0 there is not a finding of not affected. An advisory undecidable at this version is reported as undetermined (undetermined_count, and up to 50 of them in undetermined), never as safe. Each match carries cve_id, kev_listed, ransomware, epss_score, effective_score, effective_severity and score_assessed (false: not yet scored, so echelongraph_score is withheld). A registry match also carries interval, the advisory interval holding it, and fixed_in, the lowest unaffected version above it, or null with fixed_in_reason; a CPE match carries no fixed_in. All four inputs travel in request headers, never in the URL. 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. Cut, the excluded and undetermined samples keep their first 10 entries, each its cve_id and reason, cve_ids keeps its first 10, and each match keeps cve_id, kev_listed, ransomware, epss_score, effective_score, score_assessed and fixed_in at least. Every CPE match stays in the text; near the cap, a registry list's last matches can leave it, and the note says how many.

Input Schema

TableJSON 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.
packageNoRegistry path: the package name in that ecosystem, such as lodash.
productNoCPE path: the NVD CPE product token, such as openssl, nginx or linux_kernel. Leave out for the registry path.
versionYesThe version to check, such as 3.0.0.
ecosystemNoRegistry path: the package's ecosystem, such as npm, PyPI or Maven. Give with package, not with product.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv3.0.2
    • 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": {
      -              "assessed": {
      -                "description": "The answer's assessed, first: null when the answer does not say.",
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "candidates_capped": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "capped": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "count": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "degraded": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "excluded_count": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "lookup": {
      -                "description": "Which lookup path this call asked for.",
      -                "enum": [
      -                  "cpe",
      -                  "registry"
      -                ],
      -                "type": "string"
      -              },
      -              "match_layer": {
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "not_affected_count": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "not_assessed_reason": {
      -                "anyOf": [
      -                  {
      -                    "anyOf": [
      -                      {
      -                        "enum": [
      -                          "product_not_in_cpe_corpus",
      -                          "package_not_cpe_nameable",
      -                          "candidate_load_pending",
      -                          "candidate_window_truncated",
      -                          "package_not_in_advisory_corpus",
      -                          "no_decidable_advisory",
      -                          "advisory_lookup_failed"
      -                        ],
      -                        "type": "string"
      -                      },
      -                      {
      -                        "type": "string"
      -                      }
      -                    ],
      -                    "description": "Why assessed is false; empty or absent when it is true."
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "undetermined_count": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              }
      -            },
      -            "required": [
      -              "assessed",
      -              "not_assessed_reason",
      -              "lookup",
      -              "match_layer",
      -              "count",
      -              "capped",
      -              "candidates_capped",
      -              "excluded_count",
      -              "undetermined_count",
      -              "not_affected_count",
      -              "degraded"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "What the answer covers; null where the answer says nothing about it."
      -      },
      -      "data": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "advisories_considered": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "assessed": {
      -            "description": "count depends on it. true: the lookup evaluated this component. false: it did not, and count 0 says nothing about whether this version is affected.",
      -            "type": [
      -              "boolean",
      -              "null"
      -            ]
      -          },
      -          "candidate_count": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "candidates_capped": {
      -            "description": "true: not every candidate CVE was loaded.",
      -            "type": [
      -              "boolean",
      -              "null"
      -            ]
      -          },
      -          "capped": {
      -            "description": "true: the match list stopped at its cap.",
      -            "type": [
      -              "boolean",
      -              "null"
      -            ]
      -          },
      -          "count": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "degraded": {
      -            "description": "true: the lookup ran out of time.",
      -            "type": [
      -              "boolean",
      -              "null"
      -            ]
      -          },
      -          "ecosystem": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "ecosystem_recognised": {
      -            "type": [
      -              "boolean",
      -              "null"
      -            ]
      -          },
      -          "excluded": {},
      -          "excluded_count": {
      -            "description": "CPE candidates suppressed by the vendor or platform gate.",
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "match_layer": {
      -            "description": "Which lookup path answered.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "matches": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "additionalProperties": {},
      -                  "properties": {
      -                    "cpe_vendor": {
      -                      "description": "The vendor NVD's CPE asserts for this match.",
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "cve_id": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "cvss_v2_score": {
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "cvss_v3_score": {
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "cvss_v4_score": {
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "description": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "echelongraph_score": {
      -                      "description": "EchelonGraph's 0-10 score: present only when score_assessed is true.",
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "echelongraph_severity": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "effective_score": {
      -                      "description": "The best real score held for the CVE (EchelonGraph's, else CVSS), the number the matches are ranked by.",
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "effective_severity": {
      -                      "description": "The band of effective_score; absent or empty when the CVE has no band at all (unrated, not harmless).",
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "epss_score": {
      -                      "description": "EPSS exploitation probability, 0 to 1.",
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "fixed_in": {
      -                      "description": "Registry match: the fixed bound of the advisory interval that holds this version, always above it. null when that interval records no fix (it ends at last_affected, or has no end) or no interval holds the version, with fixed_in_reason saying which. Absent on a CPE match.",
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "fixed_in_reason": {
      -                      "description": "Why fixed_in is null; absent when fixed_in is a version.",
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "interval": {
      -                      "anyOf": [
      -                        {
      -                          "additionalProperties": {},
      -                          "properties": {
      -                            "fixed": {
      -                              "type": [
      -                                "string",
      -                                "null"
      -                              ]
      -                            },
      -                            "introduced": {
      -                              "type": [
      -                                "string",
      -                                "null"
      -                              ]
      -                            },
      -                            "last_affected": {
      -                              "type": [
      -                                "string",
      -                                "null"
      -                              ]
      -                            }
      -                          },
      -                          "type": "object"
      -                        },
      -                        {
      -                          "type": "null"
      -                        }
      -                      ],
      -                      "description": "Registry match: the advisory interval that holds this version (fixed is exclusive, last_affected inclusive); absent when no interval holds it."
      -                    },
      -                    "kev_listed": {
      -                      "description": "Listed in CISA-KEV: known to be exploited.",
      -                      "type": [
      -                        "boolean",
      -                        "null"
      -                      ]
      -                    },
      -                    "match_confidence": {
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "match_method": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "match_reason": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "matched_criteria": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "ransomware": {
      -                      "description": "CISA-KEV records known use in ransomware campaigns.",
      -                      "type": [
      -                        "boolean",
      -                        "null"
      -                      ]
      -                    },
      -                    "score_assessed": {
      -                      "description": "Whether EchelonGraph has scored the CVE. false: NOT YET SCORED, and echelongraph_score is withheld.",
      -                      "type": [
      -                        "boolean",
      -                        "null"
      -                      ]
      -                    },
      -                    "score_unassessed_reason": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "severity": {
      -                      "description": "NVD's own CVSS v3 band, as provenance: it can be NONE for a CVE NVD rated only under CVSS v2. Rank and display on effective_severity.",
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "vendor_severity": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "vendor_unknown": {
      -                      "description": "true: the vendor was not verified, so the match is real but its attribution to your vendor is not.",
      -                      "type": [
      -                        "boolean",
      -                        "null"
      -                      ]
      -                    },
      -                    "version_evidence": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    }
      -                  },
      -                  "type": "object"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "not_affected_count": {
      -            "description": "Advisories decided as not affecting this version.",
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "not_assessed_reason": {
      -            "anyOf": [
      -              {
      -                "anyOf": [
      -                  {
      -                    "enum": [
      -                      "product_not_in_cpe_corpus",
      -                      "package_not_cpe_nameable",
      -                      "candidate_load_pending",
      -                      "candidate_window_truncated",
      -                      "package_not_in_advisory_corpus",
      -                      "no_decidable_advisory",
      -                      "advisory_lookup_failed"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "string"
      -                  }
      -                ],
      -                "description": "Why assessed is false; empty or absent when it is true."
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "package": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "product": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "product_named_count": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "undecidable_excluded_count": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "undecided_candidate_count": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "undetermined": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "additionalProperties": {},
      -                  "properties": {
      -                    "cve_id": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "detail": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "ecosystem": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "package": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "reason": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    }
      -                  },
      -                  "type": "object"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "undetermined_count": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "vendor": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_advisory_count": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "version": {
      -            "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": {
      -              "assessed": {
      -                "description": "The answer's assessed, first: null when the answer does not say.",
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "candidates_capped": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "capped": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "count": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "degraded": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "excluded_count": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "lookup": {
      -                "description": "Which lookup path this call asked for.",
      -                "enum": [
      -                  "cpe",
      -                  "registry"
      -                ],
      -                "type": "string"
      -              },
      -              "match_layer": {
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "not_affected_count": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "not_assessed_reason": {
      -                "anyOf": [
      -                  {
      -                    "anyOf": [
      -                      {
      -                        "enum": [
      -                          "product_not_in_cpe_corpus",
      -                          "package_not_cpe_nameable",
      -                          "candidate_load_pending",
      -                          "candidate_window_truncated",
      -                          "package_not_in_advisory_corpus",
      -                          "no_decidable_advisory",
      -                          "advisory_lookup_failed"
      -                        ],
      -                        "type": "string"
      -                      },
      -                      {
      -                        "type": "string"
      -                      }
      -                    ],
      -                    "description": "Why assessed is false; empty or absent when it is true."
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "undetermined_count": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              }
      -            },
      -            "required": [
      -              "assessed",
      -              "not_assessed_reason",
      -              "lookup",
      -              "match_layer",
      -              "count",
      -              "capped",
      -              "candidates_capped",
      -              "excluded_count",
      -              "undetermined_count",
      -              "not_affected_count",
      -              "degraded"
      -            ],
      -            "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": {
      +              "assessed": {
      +                "description": "The answer's assessed, first: null when the answer does not say.",
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "candidates_capped": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "capped": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "count": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "degraded": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "excluded_count": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "lookup": {
      +                "description": "Which lookup path this call asked for.",
      +                "enum": [
      +                  "cpe",
      +                  "registry"
      +                ],
      +                "type": "string"
      +              },
      +              "match_layer": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "not_affected_count": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "not_assessed_reason": {
      +                "anyOf": [
      +                  {
      +                    "anyOf": [
      +                      {
      +                        "enum": [
      +                          "product_not_in_cpe_corpus",
      +                          "package_not_cpe_nameable",
      +                          "candidate_load_pending",
      +                          "candidate_window_truncated",
      +                          "package_not_in_advisory_corpus",
      +                          "no_decidable_advisory",
      +                          "advisory_lookup_failed"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "string"
      +                      }
      +                    ],
      +                    "description": "Why assessed is false; empty or absent when it is true."
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "undetermined_count": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "assessed",
      +              "not_assessed_reason",
      +              "lookup",
      +              "match_layer",
      +              "count",
      +              "capped",
      +              "candidates_capped",
      +              "excluded_count",
      +              "undetermined_count",
      +              "not_affected_count",
      +              "degraded"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "What the answer covers; null where the answer says nothing about it."
      +      },
      +      "data": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "advisories_considered": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "assessed": {
      +            "description": "count depends on it. true: the lookup evaluated this component. false: it did not, and count 0 says nothing about whether this version is affected.",
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "candidate_count": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "candidates_capped": {
      +            "description": "true: not every candidate CVE was loaded.",
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "capped": {
      +            "description": "true: the match list stopped at its cap.",
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "count": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "degraded": {
      +            "description": "true: the lookup ran out of time.",
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "ecosystem": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "ecosystem_recognised": {
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "excluded": {},
      +          "excluded_count": {
      +            "description": "CPE candidates suppressed by the vendor or platform gate.",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "match_layer": {
      +            "description": "Which lookup path answered.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "matches": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "additionalProperties": {},
      +                  "properties": {
      +                    "cpe_vendor": {
      +                      "description": "The vendor NVD's CPE asserts for this match.",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "cve_id": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "cvss_v2_score": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "cvss_v3_score": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "cvss_v4_score": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "description": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "echelongraph_score": {
      +                      "description": "EchelonGraph's 0-10 score: present only when score_assessed is true.",
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "echelongraph_severity": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "effective_score": {
      +                      "description": "The best real score held for the CVE (EchelonGraph's, else CVSS), the number the matches are ranked by.",
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "effective_severity": {
      +                      "description": "The band of effective_score; absent or empty when the CVE has no band at all (unrated, not harmless).",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "epss_score": {
      +                      "description": "EPSS exploitation probability, 0 to 1.",
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "fixed_in": {
      +                      "description": "Registry match: the lowest version above this one that no affected interval of the CVE's record for the package holds, always above it: the fixed bound of the interval that holds this version, moved past any overlapping interval that still holds that bound (fixed_in_detail then names it). null when no such version is on record (an interval on the way records no fix: it ends at last_affected, or has no end) or no interval holds the version, with fixed_in_reason saying which. Absent on a CPE match.",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "fixed_in_detail": {
      +                      "description": "Set when fixed_in is not the fixed bound of the interval that holds this version: the overlapping intervals of the same record it moved past, which still hold that bound.",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "fixed_in_reason": {
      +                      "description": "Why fixed_in is null; absent when fixed_in is a version.",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "interval": {
      +                      "anyOf": [
      +                        {
      +                          "additionalProperties": {},
      +                          "properties": {
      +                            "fixed": {
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            },
      +                            "introduced": {
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            },
      +                            "last_affected": {
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            }
      +                          },
      +                          "type": "object"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ],
      +                      "description": "Registry match: the advisory interval that holds this version (fixed is exclusive, last_affected inclusive); absent when no interval holds it."
      +                    },
      +                    "kev_listed": {
      +                      "description": "Listed in CISA-KEV: known to be exploited.",
      +                      "type": [
      +                        "boolean",
      +                        "null"
      +                      ]
      +                    },
      +                    "match_confidence": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "match_method": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "match_reason": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "matched_criteria": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "ransomware": {
      +                      "description": "CISA-KEV records known use in ransomware campaigns.",
      +                      "type": [
      +                        "boolean",
      +                        "null"
      +                      ]
      +                    },
      +                    "score_assessed": {
      +                      "description": "Whether EchelonGraph has scored the CVE. false: NOT YET SCORED, and echelongraph_score is withheld.",
      +                      "type": [
      +                        "boolean",
      +                        "null"
      +                      ]
      +                    },
      +                    "score_unassessed_reason": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "severity": {
      +                      "description": "NVD's own CVSS v3 band, as provenance: it can be NONE for a CVE NVD rated only under CVSS v2. Rank and display on effective_severity.",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "vendor_severity": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "vendor_unknown": {
      +                      "description": "true: the vendor was not verified, so the match is real but its attribution to your vendor is not.",
      +                      "type": [
      +                        "boolean",
      +                        "null"
      +                      ]
      +                    },
      +                    "version_evidence": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    }
      +                  },
      +                  "type": "object"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "not_affected_count": {
      +            "description": "Advisories decided as not affecting this version.",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "not_assessed_reason": {
      +            "anyOf": [
      +              {
      +                "anyOf": [
      +                  {
      +                    "enum": [
      +                      "product_not_in_cpe_corpus",
      +                      "package_not_cpe_nameable",
      +                      "candidate_load_pending",
      +                      "candidate_window_truncated",
      +                      "package_not_in_advisory_corpus",
      +                      "no_decidable_advisory",
      +                      "advisory_lookup_failed"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "string"
      +                  }
      +                ],
      +                "description": "Why assessed is false; empty or absent when it is true."
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "package": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "product": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "product_named_count": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "undecidable_excluded_count": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "undecided_candidate_count": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "undetermined": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "additionalProperties": {},
      +                  "properties": {
      +                    "cve_id": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "detail": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "ecosystem": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "package": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "reason": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    }
      +                  },
      +                  "type": "object"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "undetermined_count": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "vendor": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_advisory_count": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "version": {
      +            "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": {
      +              "assessed": {
      +                "description": "The answer's assessed, first: null when the answer does not say.",
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "candidates_capped": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "capped": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "count": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "degraded": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "excluded_count": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "lookup": {
      +                "description": "Which lookup path this call asked for.",
      +                "enum": [
      +                  "cpe",
      +                  "registry"
      +                ],
      +                "type": "string"
      +              },
      +              "match_layer": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "not_affected_count": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "not_assessed_reason": {
      +                "anyOf": [
      +                  {
      +                    "anyOf": [
      +                      {
      +                        "enum": [
      +                          "product_not_in_cpe_corpus",
      +                          "package_not_cpe_nameable",
      +                          "candidate_load_pending",
      +                          "candidate_window_truncated",
      +                          "package_not_in_advisory_corpus",
      +                          "no_decidable_advisory",
      +                          "advisory_lookup_failed"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "string"
      +                      }
      +                    ],
      +                    "description": "Why assessed is false; empty or absent when it is true."
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "undetermined_count": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "assessed",
      +              "not_assessed_reason",
      +              "lookup",
      +              "match_layer",
      +              "count",
      +              "capped",
      +              "candidates_capped",
      +              "excluded_count",
      +              "undetermined_count",
      +              "not_affected_count",
      +              "degraded"
      +            ],
      +            "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"
      +  }
      +]
  2. Changed1 schema field changedv2.7.0
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "coverage": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "assessed": {
      -                "description": "The answer's assessed, first: null when the answer does not say.",
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "candidates_capped": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "capped": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "count": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "degraded": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "excluded_count": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "lookup": {
      -                "description": "Which lookup path this call asked for.",
      -                "enum": [
      -                  "cpe",
      -                  "registry"
      -                ],
      -                "type": "string"
      -              },
      -              "match_layer": {
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "not_affected_count": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "not_assessed_reason": {
      -                "anyOf": [
      -                  {
      -                    "anyOf": [
      -                      {
      -                        "enum": [
      -                          "product_not_in_cpe_corpus",
      -                          "package_not_cpe_nameable",
      -                          "candidate_load_pending",
      -                          "candidate_window_truncated",
      -                          "package_not_in_advisory_corpus",
      -                          "no_decidable_advisory",
      -                          "advisory_lookup_failed"
      -                        ],
      -                        "type": "string"
      -                      },
      -                      {
      -                        "type": "string"
      -                      }
      -                    ],
      -                    "description": "Why assessed is false; empty or absent when it is true."
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "undetermined_count": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              }
      -            },
      -            "required": [
      -              "assessed",
      -              "not_assessed_reason",
      -              "lookup",
      -              "match_layer",
      -              "count",
      -              "capped",
      -              "candidates_capped",
      -              "excluded_count",
      -              "undetermined_count",
      -              "not_affected_count",
      -              "degraded"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "What the answer covers; null where the answer says nothing about it."
      -      },
      -      "data": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "advisories_considered": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "assessed": {
      -            "description": "Read first. true: the lookup evaluated this component. false: it did not, and count 0 says nothing about whether this version is affected.",
      -            "type": [
      -              "boolean",
      -              "null"
      -            ]
      -          },
      -          "candidate_count": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "candidates_capped": {
      -            "type": [
      -              "boolean",
      -              "null"
      -            ]
      -          },
      -          "capped": {
      -            "type": [
      -              "boolean",
      -              "null"
      -            ]
      -          },
      -          "count": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "cve_ids": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "degraded": {
      -            "type": [
      -              "boolean",
      -              "null"
      -            ]
      -          },
      -          "ecosystem": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "ecosystem_recognised": {
      -            "type": [
      -              "boolean",
      -              "null"
      -            ]
      -          },
      -          "excluded": {},
      -          "excluded_count": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "match_layer": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "matches": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "additionalProperties": {},
      -                  "properties": {
      -                    "cpe_vendor": {
      -                      "description": "The vendor NVD's CPE asserts for this match.",
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "cve_id": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "cvss_v2_score": {
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "cvss_v3_score": {
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "cvss_v4_score": {
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "description": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "echelongraph_score": {
      -                      "description": "EchelonGraph's 0-10 score: present only when score_assessed is true.",
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "echelongraph_severity": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "effective_score": {
      -                      "description": "The best real score held for the CVE (EchelonGraph's, else CVSS), the number the matches are ranked by.",
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "effective_severity": {
      -                      "description": "The band of effective_score; absent or empty when the CVE has no band at all (unrated, not harmless).",
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "epss_score": {
      -                      "description": "EPSS exploitation probability, 0 to 1.",
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "kev_listed": {
      -                      "description": "Listed in CISA-KEV: known to be exploited.",
      -                      "type": [
      -                        "boolean",
      -                        "null"
      -                      ]
      -                    },
      -                    "match_confidence": {
      -                      "type": [
      -                        "number",
      -                        "null"
      -                      ]
      -                    },
      -                    "match_method": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "match_reason": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "matched_criteria": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "ransomware": {
      -                      "description": "CISA-KEV records known use in ransomware campaigns.",
      -                      "type": [
      -                        "boolean",
      -                        "null"
      -                      ]
      -                    },
      -                    "score_assessed": {
      -                      "description": "Whether EchelonGraph has scored the CVE. false: NOT YET SCORED, and echelongraph_score is withheld.",
      -                      "type": [
      -                        "boolean",
      -                        "null"
      -                      ]
      -                    },
      -                    "score_unassessed_reason": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "severity": {
      -                      "description": "NVD's own CVSS v3 band, as provenance: it can be NONE for a CVE NVD rated only under CVSS v2. Rank and display on effective_severity.",
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "vendor_severity": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "vendor_unknown": {
      -                      "description": "true: the vendor was not verified, so the match is real but its attribution to your vendor is not.",
      -                      "type": [
      -                        "boolean",
      -                        "null"
      -                      ]
      -                    },
      -                    "version_evidence": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    }
      -                  },
      -                  "type": "object"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "not_affected_count": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "not_assessed_reason": {
      -            "anyOf": [
      -              {
      -                "anyOf": [
      -                  {
      -                    "enum": [
      -                      "product_not_in_cpe_corpus",
      -                      "package_not_cpe_nameable",
      -                      "candidate_load_pending",
      -                      "candidate_window_truncated",
      -                      "package_not_in_advisory_corpus",
      -                      "no_decidable_advisory",
      -                      "advisory_lookup_failed"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "string"
      -                  }
      -                ],
      -                "description": "Why assessed is false; empty or absent when it is true."
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "package": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "product": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "product_named_count": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "undecidable_excluded_count": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "undecided_candidate_count": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "undetermined": {
      -            "anyOf": [
      -              {
      -                "items": {
      -                  "additionalProperties": {},
      -                  "properties": {
      -                    "cve_id": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "detail": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "ecosystem": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "package": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "reason": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    }
      -                  },
      -                  "type": "object"
      -                },
      -                "type": "array"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "undetermined_count": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "vendor": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "vendor_advisory_count": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "version": {
      -            "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": {
      -              "assessed": {
      -                "description": "The answer's assessed, first: null when the answer does not say.",
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "candidates_capped": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "capped": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "count": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "degraded": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "excluded_count": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "lookup": {
      -                "description": "Which lookup path this call asked for.",
      -                "enum": [
      -                  "cpe",
      -                  "registry"
      -                ],
      -                "type": "string"
      -              },
      -              "match_layer": {
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "not_affected_count": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "not_assessed_reason": {
      -                "anyOf": [
      -                  {
      -                    "anyOf": [
      -                      {
      -                        "enum": [
      -                          "product_not_in_cpe_corpus",
      -                          "package_not_cpe_nameable",
      -                          "candidate_load_pending",
      -                          "candidate_window_truncated",
      -                          "package_not_in_advisory_corpus",
      -                          "no_decidable_advisory",
      -                          "advisory_lookup_failed"
      -                        ],
      -                        "type": "string"
      -                      },
      -                      {
      -                        "type": "string"
      -                      }
      -                    ],
      -                    "description": "Why assessed is false; empty or absent when it is true."
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "undetermined_count": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              }
      -            },
      -            "required": [
      -              "assessed",
      -              "not_assessed_reason",
      -              "lookup",
      -              "match_layer",
      -              "count",
      -              "capped",
      -              "candidates_capped",
      -              "excluded_count",
      -              "undetermined_count",
      -              "not_affected_count",
      -              "degraded"
      -            ],
      -            "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": {
      +              "assessed": {
      +                "description": "The answer's assessed, first: null when the answer does not say.",
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "candidates_capped": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "capped": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "count": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "degraded": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "excluded_count": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "lookup": {
      +                "description": "Which lookup path this call asked for.",
      +                "enum": [
      +                  "cpe",
      +                  "registry"
      +                ],
      +                "type": "string"
      +              },
      +              "match_layer": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "not_affected_count": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "not_assessed_reason": {
      +                "anyOf": [
      +                  {
      +                    "anyOf": [
      +                      {
      +                        "enum": [
      +                          "product_not_in_cpe_corpus",
      +                          "package_not_cpe_nameable",
      +                          "candidate_load_pending",
      +                          "candidate_window_truncated",
      +                          "package_not_in_advisory_corpus",
      +                          "no_decidable_advisory",
      +                          "advisory_lookup_failed"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "string"
      +                      }
      +                    ],
      +                    "description": "Why assessed is false; empty or absent when it is true."
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "undetermined_count": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "assessed",
      +              "not_assessed_reason",
      +              "lookup",
      +              "match_layer",
      +              "count",
      +              "capped",
      +              "candidates_capped",
      +              "excluded_count",
      +              "undetermined_count",
      +              "not_affected_count",
      +              "degraded"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "What the answer covers; null where the answer says nothing about it."
      +      },
      +      "data": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "advisories_considered": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "assessed": {
      +            "description": "count depends on it. true: the lookup evaluated this component. false: it did not, and count 0 says nothing about whether this version is affected.",
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "candidate_count": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "candidates_capped": {
      +            "description": "true: not every candidate CVE was loaded.",
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "capped": {
      +            "description": "true: the match list stopped at its cap.",
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "count": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "cve_ids": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "degraded": {
      +            "description": "true: the lookup ran out of time.",
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "ecosystem": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "ecosystem_recognised": {
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "excluded": {},
      +          "excluded_count": {
      +            "description": "CPE candidates suppressed by the vendor or platform gate.",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "match_layer": {
      +            "description": "Which lookup path answered.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "matches": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "additionalProperties": {},
      +                  "properties": {
      +                    "cpe_vendor": {
      +                      "description": "The vendor NVD's CPE asserts for this match.",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "cve_id": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "cvss_v2_score": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "cvss_v3_score": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "cvss_v4_score": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "description": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "echelongraph_score": {
      +                      "description": "EchelonGraph's 0-10 score: present only when score_assessed is true.",
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "echelongraph_severity": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "effective_score": {
      +                      "description": "The best real score held for the CVE (EchelonGraph's, else CVSS), the number the matches are ranked by.",
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "effective_severity": {
      +                      "description": "The band of effective_score; absent or empty when the CVE has no band at all (unrated, not harmless).",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "epss_score": {
      +                      "description": "EPSS exploitation probability, 0 to 1.",
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "fixed_in": {
      +                      "description": "Registry match: the fixed bound of the advisory interval that holds this version, always above it. null when that interval records no fix (it ends at last_affected, or has no end) or no interval holds the version, with fixed_in_reason saying which. Absent on a CPE match.",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "fixed_in_reason": {
      +                      "description": "Why fixed_in is null; absent when fixed_in is a version.",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "interval": {
      +                      "anyOf": [
      +                        {
      +                          "additionalProperties": {},
      +                          "properties": {
      +                            "fixed": {
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            },
      +                            "introduced": {
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            },
      +                            "last_affected": {
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            }
      +                          },
      +                          "type": "object"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ],
      +                      "description": "Registry match: the advisory interval that holds this version (fixed is exclusive, last_affected inclusive); absent when no interval holds it."
      +                    },
      +                    "kev_listed": {
      +                      "description": "Listed in CISA-KEV: known to be exploited.",
      +                      "type": [
      +                        "boolean",
      +                        "null"
      +                      ]
      +                    },
      +                    "match_confidence": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "match_method": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "match_reason": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "matched_criteria": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "ransomware": {
      +                      "description": "CISA-KEV records known use in ransomware campaigns.",
      +                      "type": [
      +                        "boolean",
      +                        "null"
      +                      ]
      +                    },
      +                    "score_assessed": {
      +                      "description": "Whether EchelonGraph has scored the CVE. false: NOT YET SCORED, and echelongraph_score is withheld.",
      +                      "type": [
      +                        "boolean",
      +                        "null"
      +                      ]
      +                    },
      +                    "score_unassessed_reason": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "severity": {
      +                      "description": "NVD's own CVSS v3 band, as provenance: it can be NONE for a CVE NVD rated only under CVSS v2. Rank and display on effective_severity.",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "vendor_severity": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "vendor_unknown": {
      +                      "description": "true: the vendor was not verified, so the match is real but its attribution to your vendor is not.",
      +                      "type": [
      +                        "boolean",
      +                        "null"
      +                      ]
      +                    },
      +                    "version_evidence": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    }
      +                  },
      +                  "type": "object"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "not_affected_count": {
      +            "description": "Advisories decided as not affecting this version.",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "not_assessed_reason": {
      +            "anyOf": [
      +              {
      +                "anyOf": [
      +                  {
      +                    "enum": [
      +                      "product_not_in_cpe_corpus",
      +                      "package_not_cpe_nameable",
      +                      "candidate_load_pending",
      +                      "candidate_window_truncated",
      +                      "package_not_in_advisory_corpus",
      +                      "no_decidable_advisory",
      +                      "advisory_lookup_failed"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "string"
      +                  }
      +                ],
      +                "description": "Why assessed is false; empty or absent when it is true."
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "package": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "product": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "product_named_count": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "undecidable_excluded_count": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "undecided_candidate_count": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "undetermined": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "additionalProperties": {},
      +                  "properties": {
      +                    "cve_id": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "detail": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "ecosystem": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "package": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "reason": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    }
      +                  },
      +                  "type": "object"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "undetermined_count": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "vendor": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "vendor_advisory_count": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "version": {
      +            "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": {
      +              "assessed": {
      +                "description": "The answer's assessed, first: null when the answer does not say.",
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "candidates_capped": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "capped": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "count": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "degraded": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "excluded_count": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "lookup": {
      +                "description": "Which lookup path this call asked for.",
      +                "enum": [
      +                  "cpe",
      +                  "registry"
      +                ],
      +                "type": "string"
      +              },
      +              "match_layer": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "not_affected_count": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "not_assessed_reason": {
      +                "anyOf": [
      +                  {
      +                    "anyOf": [
      +                      {
      +                        "enum": [
      +                          "product_not_in_cpe_corpus",
      +                          "package_not_cpe_nameable",
      +                          "candidate_load_pending",
      +                          "candidate_window_truncated",
      +                          "package_not_in_advisory_corpus",
      +                          "no_decidable_advisory",
      +                          "advisory_lookup_failed"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "string"
      +                      }
      +                    ],
      +                    "description": "Why assessed is false; empty or absent when it is true."
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "undetermined_count": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "assessed",
      +              "not_assessed_reason",
      +              "lookup",
      +              "match_layer",
      +              "count",
      +              "capped",
      +              "candidates_capped",
      +              "excluded_count",
      +              "undetermined_count",
      +              "not_affected_count",
      +              "degraded"
      +            ],
      +            "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"
      +  }
      +]
  3. Addedv2.6.3

TDQS

A4.5/5.0
Behavior5/5

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

Annotations already cover the safety profile (readOnly, idempotent, openWorld, non-destructive), and the description adds substantial behavioral context beyond them: truncation at 30,000 characters with the exact fields each list keeps, the meaning of assessed=false and count=0, undetermined advisories never being reported as safe, and that all inputs travel in request headers. This is well past the bar set by the annotations.

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 purpose is front-loaded, but the body is a dense run-on that packs truncation rules, cut-field lists and score semantics into a single paragraph, and repeats truncation detail already present in the 'full' schema description. Much of it earns its place given the tool's complexity, but it is not easy to scan.

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

Completeness5/5

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

For a tool with an output schema, five parameters, no nested objects and high complexity, the description is complete: it covers both lookup paths, truncation behavior, undetermined vs not-affected outcomes, header transport, and score gating. Nothing an agent needs to invoke 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, but the description adds cross-parameter semantics the schema does not: product selects the CPE path and must not be combined with ecosystem/package, and it explains the output fields (fixed_in, fixed_in_reason, interval, undetermined_count) that parameters drive. Slight tension with 'all four inputs' when the schema lists five parameters.

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

Purpose5/5

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

States a specific verb (check whether affected) and resource (a product or package at a given version), and goes further by naming the two distinct modes — the CPE path (product+version) and the registry path (ecosystem+package+version). An agent can tell what this does and how it maps to the NVD/OSV data model without opening the schema.

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

Usage Guidelines4/5

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

Gives clear mode-selection guidance: use the CPE path when you have a product token, the registry path when you have an ecosystem+package. However, it never contrasts itself against closely related siblings such as check_sbom or scan_manifest, so an agent gets no explicit routing rule between this tool and those.

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