Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "note": {
+      "description": "One line naming what the page shows; the same text is in summary where a reply has one.",
+      "type": "string"
+    },
+    "url": {
+      "description": "The member's own dashboard page.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "url",
+    "note"
+  ],
+  "type": "object"
+}

Added value: +{
+  "additionalProperties": true,
+  "description": "How far behind the competitor you trail most the site is, each side as a share of its own answers, compared on the assistants that answered for both. Present only when both audits recorded stances; its sentence reads the result back in one line.",
+  "properties": {
+    "assistants": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "The assistants the figures are over: those that answered for both sites. Null when that could not be checked."
+    },
+    "by_competitor": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "answers": {
+            "type": "number"
+          },
+          "assistants": {
+            "anyOf": [
+              {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "domain": {
+            "type": "string"
+          },
+          "gap_points": {
+            "type": "number"
+          },
+          "recommended": {
+            "type": "number"
+          },
+          "same_questions": {
+            "type": [
+              "boolean",
+              "null"
+            ]
+          },
+          "state": {
+            "enum": [
+              "behind",
+              "level",
+              "ahead"
+            ],
+            "type": "string"
+          },
+          "unverified": {
+            "description": "True when this competitor's business name could not be verified.",
+            "type": "boolean"
+          },
+          "you_answers": {
+            "description": "Your answers on the same basis as this competitor's figures.",
+            "type": "number"
+          },
+          "you_recommended": {
+            "description": "Your recommended answers on the same basis as this competitor's figures.",
+            "type": "number"
+          }
+        },
+        "required": [
+          "domain",
+          "same_questions",
+          "assistants",
+          "state",
+          "gap_points",
+          "recommended",
+          "answers",
+          "you_recommended",
+          "you_answers",
+          "unverified"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "gap_points": {
+      "description": "Positive when the top competitor is recommended more often.",
+      "type": "number"
+    },
+    "not_compared": {
+      "description": "Competitors left out because their audit recorded no stances.",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "rival": {
+      "description": "The competitor you trail most (when you lead every competitor, the one you lead least), compared on the assistants that answered for both sites.",
+      "type": "string"
+    },
+    "rival_answers": {
+      "type": "number"
+    },
+    "rival_recommended": {
+      "type": "number"
+    },
+    "same_questions": {
+      "description": "Whether both audits asked the same set of questions; null when either did not record them.",
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "sentence": {
+      "type": "string"
+    },
+    "state": {
+      "enum": [
+        "behind",
+        "level",
+        "ahead"
+      ],
+      "type": "string"
+    },
+    "tied_with": {
+      "description": "Other competitors with identical counts over the identical basis: one gap, all named.",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "you_answers": {
+      "type": "number"
+    },
+    "you_recommended": {
+      "type": "number"
+    }
+  },
+  "required": [
+    "state",
+    "gap_points",
+    "rival",
+    "tied_with",
+    "same_questions",
+    "assistants",
+    "rival_recommended",
+    "rival_answers",
+    "you_recommended",
+    "you_answers",
+    "not_compared",
+    "sentence",
+    "by_competitor"
+  ],
+  "type": "object"
+}

Previous value: -"\"quota\" | \"unreachable\" | \"error\"."New value: +"\"quota\" | \"unreachable\" | \"time_limit\" | \"error\"."

Added value: +{
+  "type": [
+    "boolean",
+    "null"
+  ]
+}

Added value: +{
+  "type": [
+    "boolean",
+    "null"
+  ]
+}

Previous value: -[
-  "chatgpt",
-  "perplexity",
-  "claude",
-  "gemini"
-]New value: +[
+  "chatgpt",
+  "perplexity",
+  "claude",
+  "gemini",
+  "google_ai_overviews",
+  "copilot"
+]

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

Previous value: -[
-  "chatgpt",
-  "perplexity",
-  "claude",
-  "gemini"
-]New value: +[
+  "chatgpt",
+  "perplexity",
+  "claude",
+  "gemini",
+  "google_ai_overviews",
+  "copilot"
+]

Previous value: -"Present exactly when an engine was asked and did not answer. Relay it: the score covers fewer engines than the four this tool can query."New value: +"Present exactly when an engine was asked and did not answer. Relay it: the score covers fewer engines than the run asked (four on a free audit, six on a paid one)."

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "note": {
+      "description": "One line naming what the page shows; the same text is in summary where a reply has one.",
+      "type": "string"
+    },
+    "url": {
+      "description": "The member's own dashboard page.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "url",
+    "note"
+  ],
+  "type": "object"
+}

Previous value: -"Why each engine's score is what it is. 'scored' — the engine answered and the number is a measurement. 'unanswered' — it was asked and returned nothing, so there is no score; do not report it as 0. 'not_asked' — it was not part of this run at all."New value: +"Why each engine's score is what it is. 'scored' — the engine answered and the number is a measurement. 'unanswered' — it was asked and returned nothing, so there is no score; do not report it as 0. 'not_asked' — it was not part of this run at all — Google AI Overviews and Microsoft Copilot are asked on paid plans only."

Added value: +{
+  "enum": [
+    "scored",
+    "unanswered",
+    "not_asked"
+  ],
+  "type": "string"
+}

Added value: +{
+  "enum": [
+    "scored",
+    "unanswered",
+    "not_asked"
+  ],
+  "type": "string"
+}

Previous value: -[
-  "chatgpt",
-  "perplexity",
-  "claude",
-  "gemini"
-]New value: +[
+  "chatgpt",
+  "perplexity",
+  "claude",
+  "gemini",
+  "google_ai_overviews",
+  "copilot"
+]

Added value: +{
+  "description": "Free audits only: what this result found that another tool can act on, as plain facts with the tool's name.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "tool": {
+        "description": "The tool that does it.",
+        "type": "string"
+      },
+      "what": {
+        "description": "A plain fact about this result.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "tool",
+      "what"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "The questions put to the assistants for this score, when the report recorded them.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "additionalProperties": true,
+  "description": "How far behind the top beatable rival the site is, in the answers that recommend it. Present only when measured; its sentence is also in summary.",
+  "properties": {
+    "answers": {
+      "description": "The answers this is a share of: one per question, per assistant.",
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "gap_points": {
+      "description": "Points behind the top rival in the answers that RECOMMEND the site (negative when ahead). Null, never 0, when there is no rival or too few answers.",
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "per_engine": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "answers": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "engine": {
+            "type": "string"
+          },
+          "gap_points": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "rival_recommended": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "state": {
+            "anyOf": [
+              {
+                "anyOf": [
+                  {
+                    "enum": [
+                      "behind",
+                      "level",
+                      "ahead",
+                      "no_rival",
+                      "no_local_rival",
+                      "not_enough_answers"
+                    ],
+                    "type": "string"
+                  },
+                  {
+                    "const": "not_measured",
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "you_recommended": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "engine",
+          "state",
+          "gap_points",
+          "you_recommended",
+          "rival_recommended",
+          "answers"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "rival": {
+      "description": "The top BEATABLE rival: marketplaces, delivery and booking apps, directories and national chains are left out. Null when none is recommended.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "rival_recommended": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "sentence": {
+      "description": "One plain sentence to read back to the owner; also folded into summary.",
+      "type": "string"
+    },
+    "state": {
+      "description": "Which kind of gap this is, or why there is none.",
+      "enum": [
+        "behind",
+        "level",
+        "ahead",
+        "no_rival",
+        "no_local_rival",
+        "not_enough_answers"
+      ],
+      "type": "string"
+    },
+    "tied_with": {
+      "description": "Other rivals tied for the top: one gap, all named.",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "you_recommended": {
+      "type": [
+        "number",
+        "null"
+      ]
+    }
+  },
+  "required": [
+    "state",
+    "gap_points",
+    "rival",
+    "rival_recommended",
+    "tied_with",
+    "you_recommended",
+    "answers",
+    "per_engine",
+    "sentence"
+  ],
+  "type": "object"
+}

Added value: +{
+  "additionalProperties": true,
+  "description": "How many answers recommended, mentioned or cautioned against the site. Present when recorded.",
+  "properties": {
+    "answers": {
+      "type": "number"
+    },
+    "cautioned": {
+      "type": "number"
+    },
+    "mentioned": {
+      "type": "number"
+    },
+    "not_named": {
+      "type": "number"
+    },
+    "recommended": {
+      "type": "number"
+    },
+    "unclear": {
+      "description": "The rules could not say how the answer treated the site. Not negative.",
+      "type": "number"
+    }
+  },
+  "required": [
+    "recommended",
+    "mentioned",
+    "cautioned",
+    "unclear",
+    "not_named",
+    "answers"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "The change in plain sentences, built from this result's two snapshots and any newer run the comparison leaves out: the overall scores and move, each assistant that moved, those newer runs, and what Pro checks each week; note beside it carries any snapshot passed over in between.",
+  "type": "string"
+}

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "note": {
+      "description": "One line naming what the page shows; the same text is in summary where a reply has one.",
+      "type": "string"
+    },
+    "url": {
+      "description": "The member's own dashboard page.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "url",
+    "note"
+  ],
+  "type": "object"
+}

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "note": {
+      "description": "One line naming what the page shows; the same text is in summary where a reply has one.",
+      "type": "string"
+    },
+    "url": {
+      "description": "The member's own dashboard page.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "url",
+    "note"
+  ],
+  "type": "object"
+}

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "note": {
+      "description": "One line naming what the page shows; the same text is in summary where a reply has one.",
+      "type": "string"
+    },
+    "url": {
+      "description": "The member's own dashboard page.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "url",
+    "note"
+  ],
+  "type": "object"
+}

Previous value: -[
-  "is_sample",
-  "domain",
-  "note",
-  "audit",
-  "price",
-  "upgrade_url"
-]New value: +[
+  "is_sample",
+  "domain",
+  "note",
+  "audit",
+  "upgrade_url"
+]

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "note": {
+      "description": "One line naming what the page shows; the same text is in summary where a reply has one.",
+      "type": "string"
+    },
+    "url": {
+      "description": "The member's own dashboard page.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "url",
+    "note"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "Free audits only: what this result found that another tool can act on, as plain facts with the tool's name.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "tool": {
+        "description": "The tool that does it.",
+        "type": "string"
+      },
+      "what": {
+        "description": "A plain fact about this result.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "tool",
+      "what"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "additionalProperties": true,
+  "description": "How far behind the top beatable rival the site is, in the answers that recommend it. Present only when measured; its sentence reads the result back in one line.",
+  "properties": {
+    "answers": {
+      "description": "The answers this is a share of: one per question, per assistant.",
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "gap_points": {
+      "description": "Points behind the top rival in the answers that RECOMMEND the site (negative when ahead). Null, never 0, when there is no rival or too few answers.",
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "per_engine": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "answers": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "engine": {
+            "type": "string"
+          },
+          "gap_points": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "rival_recommended": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "state": {
+            "anyOf": [
+              {
+                "anyOf": [
+                  {
+                    "enum": [
+                      "behind",
+                      "level",
+                      "ahead",
+                      "no_rival",
+                      "no_local_rival",
+                      "not_enough_answers"
+                    ],
+                    "type": "string"
+                  },
+                  {
+                    "const": "not_measured",
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "you_recommended": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "engine",
+          "state",
+          "gap_points",
+          "you_recommended",
+          "rival_recommended",
+          "answers"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "rival": {
+      "description": "The top BEATABLE rival: marketplaces, delivery and booking apps, directories and national chains are left out. Null when none is recommended.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "rival_recommended": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "sentence": {
+      "description": "One plain sentence to read back to the owner; also folded into summary.",
+      "type": "string"
+    },
+    "state": {
+      "description": "Which kind of gap this is, or why there is none.",
+      "enum": [
+        "behind",
+        "level",
+        "ahead",
+        "no_rival",
+        "no_local_rival",
+        "not_enough_answers"
+      ],
+      "type": "string"
+    },
+    "tied_with": {
+      "description": "Other rivals tied for the top: one gap, all named.",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "you_recommended": {
+      "type": [
+        "number",
+        "null"
+      ]
+    }
+  },
+  "required": [
+    "state",
+    "gap_points",
+    "rival",
+    "rival_recommended",
+    "tied_with",
+    "you_recommended",
+    "answers",
+    "per_engine",
+    "sentence"
+  ],
+  "type": "object"
+}

Added value: +{
+  "additionalProperties": true,
+  "properties": {
+    "answers": {
+      "type": "number"
+    },
+    "cautioned": {
+      "type": "number"
+    },
+    "mentioned": {
+      "type": "number"
+    },
+    "not_named": {
+      "type": "number"
+    },
+    "recommended": {
+      "type": "number"
+    },
+    "unclear": {
+      "description": "The rules could not say how the answer treated the site. Not negative.",
+      "type": "number"
+    }
+  },
+  "required": [
+    "recommended",
+    "mentioned",
+    "cautioned",
+    "unclear",
+    "not_named",
+    "answers"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "Free audits only: next_steps in one sentence.",
+  "type": "string"
+}

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "note": {
+      "description": "One line naming what the page shows; the same text is in summary where a reply has one.",
+      "type": "string"
+    },
+    "url": {
+      "description": "The member's own dashboard page.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "url",
+    "note"
+  ],
+  "type": "object"
+}

Added value: +{
+  "additionalProperties": {},
+  "type": "object"
+}

Added value: +{
+  "type": "string"
+}

Added value: +{
+  "type": "string"
+}

Added value: +{
+  "type": "boolean"
+}

Added value: +{
+  "type": "number"
+}

Added value: +{
+  "type": "string"
+}

Added value: +{
+  "description": "The audit the steps come from.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Which list the API served. \"free\" omits where to get listed, what the assistants get wrong and each finding's fix file; its step marked `locked` only counts what Pro shows.",
+  "enum": [
+    "free",
+    "pro"
+  ],
+  "type": "string"
+}

Previous value: -"Schema type, or auto-detect."New value: +"Schema type; \"auto\" (also the default when omitted) does not detect anything — it returns an Organization draft."

Previous value: -"The JSON-LD document, ready to paste into the site."New value: +"The JSON-LD draft (object or array). NOT ready to paste: every name field arrives as a placeholder — \"Your Business Name\" on the business types, and on a Product the product's own name and brand as \"Your Product Name\" and \"Brand Name\" — that the owner must replace with real names confirmed with them, never guessed from the domain or copied from an audit."

Previous value: -"Where to put the snippet, e.g. \"in the <head> of every page\"."New value: +"What to replace in the draft first — each name placeholder, confirmed with the owner — then where to embed the finished snippet, e.g. \"in the <head> of every page\". Relay the whole string, in that order: the replacement ask comes before the placement."

Previous value: -[
-  {
-    "additionalProperties": true,
-    "properties": {
-      "change_30d": {
-        "anyOf": [
-          {
-            "$ref": "#/properties/trend/anyOf/0/properties/change_7d/anyOf/0"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "change_7d": {
-        "anyOf": [
-          {
-            "additionalProperties": true,
-            "properties": {
-              "engine_changes": {
-                "items": {
-                  "additionalProperties": true,
-                  "properties": {
-                    "delta": {
-                      "type": "number"
-                    },
-                    "engine": {
-                      "type": "string"
-                    },
-                    "from": {
-                      "type": "number"
-                    },
-                    "to": {
-                      "type": "number"
-                    }
-                  },
-                  "required": [
-                    "engine",
-                    "from",
-                    "to",
-                    "delta"
-                  ],
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "from_captured_at": {
-                "description": "When the snapshot this window compares against was captured.",
-                "type": "string"
-              },
-              "from_score": {
-                "type": "number"
-              },
-              "score_delta": {
-                "type": "number"
-              },
-              "skipped_snapshots": {
-                "description": "Snapshots in the window that were not compared: they asked a different question (another business name, market or queries), or do not record what they asked.",
-                "type": "number"
-              },
-              "snapshots": {
-                "description": "Snapshots that fell inside this window.",
-                "type": "number"
-              },
-              "to_score": {
-                "type": "number"
-              },
-              "window_days": {
-                "type": "number"
-              }
-            },
-            "required": [
-              "window_days",
-              "from_score",
-              "to_score",
-              "score_delta",
-              "engine_changes",
-              "snapshots"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Null when the window holds no earlier snapshot that asked the same question as the latest."
-      },
-      "includes_simulated": {
-        "description": "Always false: simulated snapshots are left out of the trend. Kept for clients that read it.",
-        "type": "boolean"
-      },
-      "latest_captured_at": {
-        "type": "string"
-      },
-      "question_note": {
-        "description": "Present when what the snapshots asked shaped the trend: no earlier snapshot asked the latest one's question, snapshots from the last 30 days were not compared, or the latest snapshot does not record what it asked. Relay it — a difference between scores that answered different questions is not a change in visibility.",
-        "type": "string"
-      },
-      "snapshots_analyzed": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "change_7d",
-      "change_30d",
-      "snapshots_analyzed",
-      "latest_captured_at",
-      "includes_simulated"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": true,
+    "properties": {
+      "change_30d": {
+        "anyOf": [
+          {
+            "$ref": "#/properties/trend/anyOf/0/properties/change_7d/anyOf/0"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "change_7d": {
+        "anyOf": [
+          {
+            "additionalProperties": true,
+            "properties": {
+              "engine_changes": {
+                "items": {
+                  "additionalProperties": true,
+                  "properties": {
+                    "delta": {
+                      "type": "number"
+                    },
+                    "engine": {
+                      "type": "string"
+                    },
+                    "from": {
+                      "type": "number"
+                    },
+                    "to": {
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "engine",
+                    "from",
+                    "to",
+                    "delta"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "from_captured_at": {
+                "description": "When the snapshot this window compares against was captured.",
+                "type": "string"
+              },
+              "from_score": {
+                "type": "number"
+              },
+              "overall_note": {
+                "description": "Present exactly when score_delta is null: which engines answered each endpoint. Relay it — a null delta for this reason reads like one for want of history otherwise.",
+                "type": "string"
+              },
+              "score_delta": {
+                "description": "The overall move across the window, or null when its two endpoints were answered by different engines — an overall over a different set of engines is a different quantity. `overall_note` says which engines answered each; engine_changes still compares every engine that answered both.",
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "skipped_snapshots": {
+                "description": "Snapshots in the window that were not compared: they asked a different question (another business name, market or queries), or do not record what they asked.",
+                "type": "number"
+              },
+              "snapshots": {
+                "description": "Snapshots that fell inside this window.",
+                "type": "number"
+              },
+              "to_score": {
+                "type": "number"
+              },
+              "window_days": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "window_days",
+              "from_score",
+              "to_score",
+              "score_delta",
+              "engine_changes",
+              "snapshots"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Null when the window holds no earlier snapshot that asked the same question as the latest."
+      },
+      "includes_simulated": {
+        "description": "Always false: simulated snapshots are left out of the trend. Kept for clients that read it.",
+        "type": "boolean"
+      },
+      "latest_captured_at": {
+        "type": "string"
+      },
+      "question_note": {
+        "description": "Present when what the snapshots asked shaped the trend: no earlier snapshot asked the latest one's question, snapshots from the last 30 days were not compared, or the latest snapshot does not record what it asked. Relay it — a difference between scores that answered different questions is not a change in visibility.",
+        "type": "string"
+      },
+      "snapshots_analyzed": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "change_7d",
+      "change_30d",
+      "snapshots_analyzed",
+      "latest_captured_at",
+      "includes_simulated"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -"Present when skipped_snapshots is above 0, when newer measured snapshots were left out of the series, or when newer weekly re-audits measured nothing of the business: which, and why, in words. Relay it."New value: +"Present when skipped_snapshots is above 0, when the two snapshots compared were answered by different engines, when newer measured snapshots were left out of the series, or when newer weekly re-audits measured nothing of the business: which, and why, in words. Relay it."

Added value: +{
+  "description": "Present exactly when score_delta is null: the two snapshots were answered by different engines, and which answered each. Relay it — a null delta for this reason must not read like a null for want of history.",
+  "type": "string"
+}

Previous value: -"Only ever between two snapshots that asked the same question. When there is no such pair, including a re-baseline after the business name, market or queries changed, the tool returns NOT_YET_AVAILABLE saying so, never a number."New value: +"Only ever between two snapshots that asked the same question AND were answered by the same engines. When there is no such pair, including a re-baseline after the business name, market or queries changed, the tool returns NOT_YET_AVAILABLE saying so, never a number; when the pair exists but different engines answered the two snapshots, the overall is not subtracted and is null with overall_note, and engine_changes still compares every engine that answered both."

Previous value: -"number"New value: +[
+  "number",
+  "null"
+]

Previous value: -[
-  {
-    "additionalProperties": true,
-    "properties": {
-      "competitor_changes": {
-        "description": "Always empty: AI-visibility snapshots record no competitors. Kept for clients that read it.",
-        "items": {},
-        "type": "array"
-      },
-      "engine_changes": {
-        "items": {
-          "additionalProperties": true,
-          "properties": {
-            "delta": {
-              "type": "number"
-            },
-            "engine": {
-              "type": "string"
-            },
-            "from": {
-              "type": "number"
-            },
-            "to": {
-              "type": "number"
-            }
-          },
-          "required": [
-            "engine",
-            "from",
-            "to",
-            "delta"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "from_captured_at": {
-        "description": "When the earlier snapshot compared was captured.",
-        "type": "string"
-      },
-      "new_issues": {
-        "description": "Always empty: AI-visibility snapshots record no audit issues. Kept for clients that read it.",
-        "items": {},
-        "type": "array"
-      },
-      "resolved_issues": {
-        "description": "Always empty: AI-visibility snapshots record no audit issues. Kept for clients that read it.",
-        "items": {},
-        "type": "array"
-      },
-      "score_delta": {
-        "type": "number"
-      },
-      "skipped_snapshots": {
-        "description": "Snapshots passed over because they asked a different question (another business name, market or queries) or do not record what they asked.",
-        "type": "number"
-      },
-      "to_captured_at": {
-        "description": "When the later one was.",
-        "type": "string"
-      }
-    },
-    "required": [
-      "score_delta",
-      "engine_changes",
-      "competitor_changes",
-      "new_issues",
-      "resolved_issues"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": true,
+    "properties": {
+      "competitor_changes": {
+        "description": "Always empty: AI-visibility snapshots record no competitors. Kept for clients that read it.",
+        "items": {},
+        "type": "array"
+      },
+      "engine_changes": {
+        "items": {
+          "additionalProperties": true,
+          "properties": {
+            "delta": {
+              "type": "number"
+            },
+            "engine": {
+              "type": "string"
+            },
+            "from": {
+              "type": "number"
+            },
+            "to": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "engine",
+            "from",
+            "to",
+            "delta"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "from_captured_at": {
+        "description": "When the earlier snapshot compared was captured.",
+        "type": "string"
+      },
+      "new_issues": {
+        "description": "Always empty: AI-visibility snapshots record no audit issues. Kept for clients that read it.",
+        "items": {},
+        "type": "array"
+      },
+      "overall_note": {
+        "description": "Present exactly when score_delta is null: which engines answered each snapshot. Relay it.",
+        "type": "string"
+      },
+      "resolved_issues": {
+        "description": "Always empty: AI-visibility snapshots record no audit issues. Kept for clients that read it.",
+        "items": {},
+        "type": "array"
+      },
+      "score_delta": {
+        "description": "The overall move, or null when the two snapshots were answered by different engines: the overall is computed over the engines that answered, so an overall over a different set of engines is a different quantity and is not subtracted. `overall_note` says which engines answered each; engine_changes still compares every engine that answered both.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "skipped_snapshots": {
+        "description": "Snapshots passed over because they asked a different question (another business name, market or queries) or do not record what they asked.",
+        "type": "number"
+      },
+      "to_captured_at": {
+        "description": "When the later one was.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "score_delta",
+      "engine_changes",
+      "competitor_changes",
+      "new_issues",
+      "resolved_issues"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -"Present when there is no like-for-like change because of a re-baseline or snapshots that do not record what they asked, or when snapshots were passed over: why, in words. Relay it."New value: +"Present when there is no like-for-like change because of a re-baseline or snapshots that do not record what they asked, when snapshots were passed over, or when the change shown has no overall because different engines answered the two snapshots: why, in words. Relay it."

Previous value: -[
-  {
-    "additionalProperties": true,
-    "properties": {
-      "change_30d": {
-        "anyOf": [
-          {
-            "$ref": "#/properties/trend/anyOf/0/properties/change_7d/anyOf/0"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "change_7d": {
-        "anyOf": [
-          {
-            "additionalProperties": true,
-            "properties": {
-              "engine_changes": {
-                "items": {
-                  "additionalProperties": true,
-                  "properties": {
-                    "delta": {
-                      "type": "number"
-                    },
-                    "engine": {
-                      "type": "string"
-                    },
-                    "from": {
-                      "type": "number"
-                    },
-                    "to": {
-                      "type": "number"
-                    }
-                  },
-                  "required": [
-                    "engine",
-                    "from",
-                    "to",
-                    "delta"
-                  ],
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "from_score": {
-                "type": "number"
-              },
-              "score_delta": {
-                "type": "number"
-              },
-              "snapshots": {
-                "description": "Snapshots that fell inside this window.",
-                "type": "number"
-              },
-              "to_score": {
-                "type": "number"
-              },
-              "window_days": {
-                "type": "number"
-              }
-            },
-            "required": [
-              "window_days",
-              "from_score",
-              "to_score",
-              "score_delta",
-              "engine_changes",
-              "snapshots"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Null when fewer than two snapshots fall in the window."
-      },
-      "includes_simulated": {
-        "description": "True if any analyzed snapshot was estimated rather than measured.",
-        "type": "boolean"
-      },
-      "latest_captured_at": {
-        "type": "string"
-      },
-      "snapshots_analyzed": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "change_7d",
-      "change_30d",
-      "snapshots_analyzed",
-      "latest_captured_at",
-      "includes_simulated"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": true,
+    "properties": {
+      "change_30d": {
+        "anyOf": [
+          {
+            "$ref": "#/properties/trend/anyOf/0/properties/change_7d/anyOf/0"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "change_7d": {
+        "anyOf": [
+          {
+            "additionalProperties": true,
+            "properties": {
+              "engine_changes": {
+                "items": {
+                  "additionalProperties": true,
+                  "properties": {
+                    "delta": {
+                      "type": "number"
+                    },
+                    "engine": {
+                      "type": "string"
+                    },
+                    "from": {
+                      "type": "number"
+                    },
+                    "to": {
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "engine",
+                    "from",
+                    "to",
+                    "delta"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "from_captured_at": {
+                "description": "When the snapshot this window compares against was captured.",
+                "type": "string"
+              },
+              "from_score": {
+                "type": "number"
+              },
+              "score_delta": {
+                "type": "number"
+              },
+              "skipped_snapshots": {
+                "description": "Snapshots in the window that were not compared: they asked a different question (another business name, market or queries), or do not record what they asked.",
+                "type": "number"
+              },
+              "snapshots": {
+                "description": "Snapshots that fell inside this window.",
+                "type": "number"
+              },
+              "to_score": {
+                "type": "number"
+              },
+              "window_days": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "window_days",
+              "from_score",
+              "to_score",
+              "score_delta",
+              "engine_changes",
+              "snapshots"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Null when the window holds no earlier snapshot that asked the same question as the latest."
+      },
+      "includes_simulated": {
+        "description": "Always false: simulated snapshots are left out of the trend. Kept for clients that read it.",
+        "type": "boolean"
+      },
+      "latest_captured_at": {
+        "type": "string"
+      },
+      "question_note": {
+        "description": "Present when what the snapshots asked shaped the trend: no earlier snapshot asked the latest one's question, snapshots from the last 30 days were not compared, or the latest snapshot does not record what it asked. Relay it — a difference between scores that answered different questions is not a change in visibility.",
+        "type": "string"
+      },
+      "snapshots_analyzed": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "change_7d",
+      "change_30d",
+      "snapshots_analyzed",
+      "latest_captured_at",
+      "includes_simulated"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Added value: +"Always empty: AI-visibility snapshots record no competitors. Kept for clients that read it."

Added value: +{
+  "description": "When the earlier snapshot compared was captured.",
+  "type": "string"
+}

Added value: +"Always empty: AI-visibility snapshots record no audit issues. Kept for clients that read it."

Added value: +{
+  "description": "Present when skipped_snapshots is above 0, when newer measured snapshots were left out of the series, or when newer weekly re-audits measured nothing of the business: which, and why, in words. Relay it.",
+  "type": "string"
+}

Added value: +"Always empty: AI-visibility snapshots record no audit issues. Kept for clients that read it."

Added value: +"Only ever between two snapshots that asked the same question. When there is no such pair, including a re-baseline after the business name, market or queries changed, the tool returns NOT_YET_AVAILABLE saying so, never a number."

Added value: +{
+  "description": "Snapshots passed over because they asked a different question (another business name, market or queries) or do not record what they asked.",
+  "type": "number"
+}

Added value: +{
+  "description": "When the later one was.",
+  "type": "string"
+}

Previous value: -[
-  {
-    "additionalProperties": true,
-    "properties": {
-      "competitor_changes": {
-        "items": {},
-        "type": "array"
-      },
-      "engine_changes": {
-        "items": {
-          "additionalProperties": true,
-          "properties": {
-            "delta": {
-              "type": "number"
-            },
-            "engine": {
-              "type": "string"
-            },
-            "from": {
-              "type": "number"
-            },
-            "to": {
-              "type": "number"
-            }
-          },
-          "required": [
-            "engine",
-            "from",
-            "to",
-            "delta"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "new_issues": {
-        "items": {},
-        "type": "array"
-      },
-      "resolved_issues": {
-        "items": {},
-        "type": "array"
-      },
-      "score_delta": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "score_delta",
-      "engine_changes",
-      "competitor_changes",
-      "new_issues",
-      "resolved_issues"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": true,
+    "properties": {
+      "competitor_changes": {
+        "description": "Always empty: AI-visibility snapshots record no competitors. Kept for clients that read it.",
+        "items": {},
+        "type": "array"
+      },
+      "engine_changes": {
+        "items": {
+          "additionalProperties": true,
+          "properties": {
+            "delta": {
+              "type": "number"
+            },
+            "engine": {
+              "type": "string"
+            },
+            "from": {
+              "type": "number"
+            },
+            "to": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "engine",
+            "from",
+            "to",
+            "delta"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "from_captured_at": {
+        "description": "When the earlier snapshot compared was captured.",
+        "type": "string"
+      },
+      "new_issues": {
+        "description": "Always empty: AI-visibility snapshots record no audit issues. Kept for clients that read it.",
+        "items": {},
+        "type": "array"
+      },
+      "resolved_issues": {
+        "description": "Always empty: AI-visibility snapshots record no audit issues. Kept for clients that read it.",
+        "items": {},
+        "type": "array"
+      },
+      "score_delta": {
+        "type": "number"
+      },
+      "skipped_snapshots": {
+        "description": "Snapshots passed over because they asked a different question (another business name, market or queries) or do not record what they asked.",
+        "type": "number"
+      },
+      "to_captured_at": {
+        "description": "When the later one was.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "score_delta",
+      "engine_changes",
+      "competitor_changes",
+      "new_issues",
+      "resolved_issues"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -"Latest vs previous snapshot; null if fewer than two."New value: +"The latest change against the most recent earlier snapshot that asked the same question; null when there is none — no scored latest snapshot (the summary says why), a first snapshot, a re-baseline, or snapshots that do not record what they asked."

Added value: +"The date of the last scheduled run, stamped when the scheduler claims it and before the audit runs. It does not say how that run ended: it may still be going, or may have failed, been skipped or measured nothing of the business."

Added value: +{
+  "description": "Present when there is no like-for-like change because of a re-baseline or snapshots that do not record what they asked, or when snapshots were passed over: why, in words. Relay it.",
+  "type": "string"
+}

Added value: +"The date of the last scheduled run, stamped when the scheduler claims it and before the audit runs. It does not say how that run ended: it may still be going, or may have failed, been skipped or measured nothing of the business."

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "cancel_at_period_end": {
+      "type": "boolean"
+    },
+    "current_period_end": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "message": {
+      "type": "string"
+    },
+    "status": {
+      "description": "Raw subscription status: active, trialing, canceled, none, …",
+      "type": "string"
+    },
+    "tier": {
+      "description": "\"none\" | \"free\" | \"pro\".",
+      "type": "string"
+    },
+    "upgrade_url": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "tier",
+    "status",
+    "current_period_end",
+    "cancel_at_period_end",
+    "upgrade_url",
+    "message"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "Optional. The market to compare within, e.g. \"Chiang Mai, Thailand\". Applied to the site AND every competitor, because a comparison asks about one market — scoring one locally and the others globally would rank answers to two different questions. Leave it out and each audit detects its own location, which is right for national or global businesses and wrong for local ones.",
+  "type": "string"
+}

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "gaps": {
+      "description": "Engines where a competitor appears in AI answers and this site does not.",
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "competitor": {
+            "type": "string"
+          },
+          "engine": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "engine",
+          "competitor"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "market": {
+      "description": "The market every audit in this comparison was scored in, or null when each domain's own location was detected.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "quota": {
+      "additionalProperties": true,
+      "properties": {
+        "audits_skipped": {
+          "description": "Competitors skipped because the daily quota ran out.",
+          "type": "number"
+        },
+        "audits_used": {
+          "description": "Fresh audits actually spent by this call.",
+          "type": "number"
+        },
+        "cached_reused": {
+          "description": "Domains served from a recent cached audit; cost no quota.",
+          "type": "number"
+        },
+        "limit": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "remaining": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "reset": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "limit",
+        "remaining",
+        "audits_used",
+        "audits_skipped",
+        "cached_reused",
+        "reset"
+      ],
+      "type": "object"
+    },
+    "ranking": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "domain": {
+            "type": "string"
+          },
+          "note": {
+            "type": "string"
+          },
+          "score": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "domain",
+          "score"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "skipped": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "detail": {
+            "type": "string"
+          },
+          "domain": {
+            "type": "string"
+          },
+          "reason": {
+            "description": "\"quota\" | \"unreachable\" | \"error\".",
+            "type": "string"
+          }
+        },
+        "required": [
+          "domain",
+          "reason"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "summary": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "ranking",
+    "gaps",
+    "quota",
+    "skipped",
+    "summary",
+    "market"
+  ],
+  "type": "object"
+}

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "jsonld": {
+      "description": "The JSON-LD document, ready to paste into the site."
+    },
+    "placement_notes": {
+      "description": "Where to put the snippet, e.g. \"in the <head> of every page\".",
+      "type": "string"
+    }
+  },
+  "required": [
+    "placement_notes"
+  ],
+  "type": "object"
+}

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "appears_by_engine": {
+      "additionalProperties": true,
+      "description": "Whether the site appeared at all on each engine. Distinct from the scores: an engine can have appearances yet a low score, or the reverse. NULL when the engine was not scored — false would assert it did not name the business, which is a claim an unmeasured engine cannot support.",
+      "properties": {
+        "chatgpt": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "claude": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "gemini": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "perplexity": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "chatgpt",
+        "perplexity",
+        "claude",
+        "gemini"
+      ],
+      "type": "object"
+    },
+    "by_engine": {
+      "additionalProperties": true,
+      "description": "Per-engine AI-visibility score, 0–100. NULL means the engine was not scored — see engine_status for which of the two reasons. A null is NOT a zero: zero means the engine answered and never named the business.",
+      "properties": {
+        "chatgpt": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "claude": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "gemini": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "perplexity": {
+          "type": [
+            "number",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "chatgpt",
+        "perplexity",
+        "claude",
+        "gemini"
+      ],
+      "type": "object"
+    },
+    "coverage_note": {
+      "description": "Present exactly when an engine was asked and did not answer. Relay it: the score covers fewer engines than the four this tool can query.",
+      "type": "string"
+    },
+    "engine_status": {
+      "additionalProperties": true,
+      "description": "Why each engine's score is what it is. 'scored' — the engine answered and the number is a measurement. 'unanswered' — it was asked and returned nothing, so there is no score; do not report it as 0. 'not_asked' — it was not part of this run at all.",
+      "properties": {
+        "chatgpt": {
+          "enum": [
+            "scored",
+            "unanswered",
+            "not_asked"
+          ],
+          "type": "string"
+        },
+        "claude": {
+          "enum": [
+            "scored",
+            "unanswered",
+            "not_asked"
+          ],
+          "type": "string"
+        },
+        "gemini": {
+          "enum": [
+            "scored",
+            "unanswered",
+            "not_asked"
+          ],
+          "type": "string"
+        },
+        "perplexity": {
+          "enum": [
+            "scored",
+            "unanswered",
+            "not_asked"
+          ],
+          "type": "string"
+        }
+      },
+      "required": [
+        "chatgpt",
+        "perplexity",
+        "claude",
+        "gemini"
+      ],
+      "type": "object"
+    },
+    "name_source": {
+      "description": "\"detected\" | \"user_supplied\" | \"domain_fallback\".",
+      "type": "string"
+    },
+    "name_verified": {
+      "type": "boolean"
+    },
+    "name_warning": {
+      "description": "Set ONLY when the business name behind the score could not be verified. The score is computed from queries built around that name, so relay this caveat rather than presenting the score as settled.",
+      "type": "string"
+    },
+    "score": {
+      "description": "Overall AI-visibility score, 0–100.",
+      "type": "number"
+    },
+    "sources": {
+      "anyOf": [
+        {
+          "items": {
+            "additionalProperties": true,
+            "properties": {
+              "answers": {
+                "description": "Answers citing this domain — not citation entries.",
+                "type": "number"
+              },
+              "domain": {
+                "type": "string"
+              },
+              "ownership": {
+                "description": "\"yours\" | \"competitor\" | \"third_party\". Competitor rows are context, not targets.",
+                "type": "string"
+              },
+              "platforms": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              "title": {
+                "type": "string"
+              },
+              "url": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "required": [
+              "domain",
+              "answers",
+              "platforms",
+              "ownership",
+              "url",
+              "title"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "summary": {
+      "type": "string"
+    },
+    "top_competitor": {
+      "description": "The competitor appearing in place of the site, if any.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "trend": {
+      "anyOf": [
+        {
+          "additionalProperties": true,
+          "properties": {
+            "change_30d": {
+              "anyOf": [
+                {
+                  "$ref": "#/properties/trend/anyOf/0/properties/change_7d/anyOf/0"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "change_7d": {
+              "anyOf": [
+                {
+                  "additionalProperties": true,
+                  "properties": {
+                    "engine_changes": {
+                      "items": {
+                        "additionalProperties": true,
+                        "properties": {
+                          "delta": {
+                            "type": "number"
+                          },
+                          "engine": {
+                            "type": "string"
+                          },
+                          "from": {
+                            "type": "number"
+                          },
+                          "to": {
+                            "type": "number"
+                          }
+                        },
+                        "required": [
+                          "engine",
+                          "from",
+                          "to",
+                          "delta"
+                        ],
+                        "type": "object"
+                      },
+                      "type": "array"
+                    },
+                    "from_score": {
+                      "type": "number"
+                    },
+                    "score_delta": {
+                      "type": "number"
+                    },
+                    "snapshots": {
+                      "description": "Snapshots that fell inside this window.",
+                      "type": "number"
+                    },
+                    "to_score": {
+                      "type": "number"
+                    },
+                    "window_days": {
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "window_days",
+                    "from_score",
+                    "to_score",
+                    "score_delta",
+                    "engine_changes",
+                    "snapshots"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Null when fewer than two snapshots fall in the window."
+            },
+            "includes_simulated": {
+              "description": "True if any analyzed snapshot was estimated rather than measured.",
+              "type": "boolean"
+            },
+            "latest_captured_at": {
+              "type": "string"
+            },
+            "snapshots_analyzed": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "change_7d",
+            "change_30d",
+            "snapshots_analyzed",
+            "latest_captured_at",
+            "includes_simulated"
+          ],
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "Pro only; null when unavailable — trend_note says why."
+    },
+    "trend_note": {
+      "description": "Present exactly when trend is null: the reason.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "score",
+    "by_engine",
+    "engine_status",
+    "appears_by_engine",
+    "top_competitor",
+    "summary",
+    "trend"
+  ],
+  "type": "object"
+}

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "peer_median": {
+      "type": "number"
+    },
+    "percentile": {
+      "description": "The domain's percentile within its industry/geo peer set, 0–100.",
+      "type": "number"
+    },
+    "position_summary": {
+      "type": "string"
+    },
+    "sample_size": {
+      "description": "How many peers the percentile and median are computed over.",
+      "type": "number"
+    }
+  },
+  "required": [
+    "percentile",
+    "peer_median",
+    "sample_size",
+    "position_summary"
+  ],
+  "type": "object"
+}

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "competitor_changes": {
+      "items": {},
+      "type": "array"
+    },
+    "engine_changes": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "delta": {
+            "type": "number"
+          },
+          "engine": {
+            "type": "string"
+          },
+          "from": {
+            "type": "number"
+          },
+          "to": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "engine",
+          "from",
+          "to",
+          "delta"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "new_issues": {
+      "items": {},
+      "type": "array"
+    },
+    "resolved_issues": {
+      "items": {},
+      "type": "array"
+    },
+    "score_delta": {
+      "type": "number"
+    }
+  },
+  "required": [
+    "score_delta",
+    "engine_changes",
+    "competitor_changes",
+    "new_issues",
+    "resolved_issues"
+  ],
+  "type": "object"
+}

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "domain": {
+      "type": "string"
+    },
+    "evidence_note": {
+      "description": "Additive, never an error: set when the plan had no citation evidence.",
+      "type": "string"
+    },
+    "model": {
+      "type": "string"
+    },
+    "plan": {
+      "additionalProperties": true,
+      "properties": {
+        "markdown": {
+          "type": "string"
+        },
+        "phases": {
+          "description": "The same plan as `markdown`, cut into 30/60/90-day cards — a rendering, never extra content. An empty array means this plan was not written in card form: render `markdown` instead, and do not report it as a plan without actions. The key being absent means the plan came from a build that predates the cards, which is also not a claim about the plan.",
+          "items": {
+            "additionalProperties": true,
+            "properties": {
+              "actions": {
+                "description": "Empty for a phase the plan wrote as prose. That is a real plan with nothing cut into cards for this band, not a plan with nothing in it.",
+                "items": {
+                  "additionalProperties": true,
+                  "properties": {
+                    "effort": {
+                      "description": "The plan's own effort estimate, or null when it did not give one. Null means unknown — never render a substitute.",
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "goal": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "priority": {
+                      "description": "Typically \"High\" or \"Medium\"; null when the plan gave none or gave one outside the two the engine keeps. Upstream text, so not an enum here.",
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "steps": {
+                      "description": "How to apply it, in order. May be empty.",
+                      "items": {
+                        "type": "string"
+                      },
+                      "type": "array"
+                    },
+                    "title": {
+                      "type": "string"
+                    },
+                    "why": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "focus": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "headline": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "name": {
+                "type": "string"
+              },
+              "phase": {
+                "description": "30, 60 or 90 — the day the band closes.",
+                "type": "number"
+              },
+              "range": {
+                "description": "The band as the engine names it, e.g. \"Days 1–30\".",
+                "type": "string"
+              },
+              "short": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "sections": {
+          "items": {
+            "additionalProperties": true,
+            "properties": {
+              "body_lines": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              "title": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "markdown",
+        "sections"
+      ],
+      "type": "object"
+    },
+    "sources_used": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "summary": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "domain",
+    "plan",
+    "sources_used",
+    "model",
+    "summary"
+  ],
+  "type": "object"
+}

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "limit": {
+      "type": "number"
+    },
+    "remaining": {
+      "type": "number"
+    },
+    "sites": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "active": {
+            "type": "boolean"
+          },
+          "cadence": {
+            "type": "string"
+          },
+          "change": {
+            "anyOf": [
+              {
+                "additionalProperties": true,
+                "properties": {
+                  "competitor_changes": {
+                    "items": {},
+                    "type": "array"
+                  },
+                  "engine_changes": {
+                    "items": {
+                      "additionalProperties": true,
+                      "properties": {
+                        "delta": {
+                          "type": "number"
+                        },
+                        "engine": {
+                          "type": "string"
+                        },
+                        "from": {
+                          "type": "number"
+                        },
+                        "to": {
+                          "type": "number"
+                        }
+                      },
+                      "required": [
+                        "engine",
+                        "from",
+                        "to",
+                        "delta"
+                      ],
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "new_issues": {
+                    "items": {},
+                    "type": "array"
+                  },
+                  "resolved_issues": {
+                    "items": {},
+                    "type": "array"
+                  },
+                  "score_delta": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "score_delta",
+                  "engine_changes",
+                  "competitor_changes",
+                  "new_issues",
+                  "resolved_issues"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Latest vs previous snapshot; null if fewer than two."
+          },
+          "domain": {
+            "type": "string"
+          },
+          "last_audited_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "latest_score": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "next_run_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "summary": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "domain",
+          "latest_score",
+          "change",
+          "summary"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "summary": {
+      "type": "string"
+    },
+    "used": {
+      "type": "number"
+    }
+  },
+  "required": [
+    "limit",
+    "used",
+    "remaining",
+    "sites",
+    "summary"
+  ],
+  "type": "object"
+}

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "recommendations": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "action": {
+            "type": "string"
+          },
+          "effort": {
+            "type": "string"
+          },
+          "expected_impact": {
+            "type": "string"
+          },
+          "why": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "recommendations"
+  ],
+  "type": "object"
+}

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "badge_html": {
+      "type": "string"
+    },
+    "report_url": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "report_url",
+    "badge_html"
+  ],
+  "type": "object"
+}

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "audit": {
+      "additionalProperties": true,
+      "description": "A real GET /api/audit payload, populated with sample data.",
+      "properties": {
+        "ai_visibility": {},
+        "base_url": {
+          "type": "string"
+        },
+        "results": {
+          "items": {},
+          "type": "array"
+        },
+        "run_id": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string"
+        },
+        "summary": {}
+      },
+      "type": "object"
+    },
+    "domain": {
+      "description": "The fixed sample domain. Never the caller's own.",
+      "type": "string"
+    },
+    "is_sample": {
+      "const": true,
+      "description": "Always true. Never present this as a live result.",
+      "type": "boolean"
+    },
+    "note": {
+      "type": "string"
+    },
+    "price": {
+      "type": "string"
+    },
+    "upgrade_url": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "is_sample",
+    "domain",
+    "note",
+    "audit",
+    "price",
+    "upgrade_url"
+  ],
+  "type": "object"
+}

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "limit": {
+      "type": "number"
+    },
+    "remaining": {
+      "type": "number"
+    },
+    "summary": {
+      "type": "string"
+    },
+    "tracked": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "active": {
+            "type": "boolean"
+          },
+          "cadence": {
+            "type": "string"
+          },
+          "created_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "digest_enabled": {
+            "type": "boolean"
+          },
+          "domain": {
+            "type": "string"
+          },
+          "last_audited_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "next_run_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "domain"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "used": {
+      "type": "number"
+    }
+  },
+  "required": [
+    "limit",
+    "used",
+    "remaining",
+    "tracked",
+    "summary"
+  ],
+  "type": "object"
+}

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "name_warning": {
+      "description": "Set ONLY when the business name could not be verified, which puts the AI-visibility score in question.",
+      "type": "string"
+    },
+    "report_url": {
+      "type": "string"
+    },
+    "scores": {
+      "additionalProperties": true,
+      "properties": {
+        "ai_visibility": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "performance": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "security": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "seo": {
+          "type": [
+            "number",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "ai_visibility",
+        "seo",
+        "security",
+        "performance"
+      ],
+      "type": "object"
+    },
+    "top_issues": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "details": {
+            "type": "string"
+          },
+          "module": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "recommendation": {
+            "type": "string"
+          },
+          "severity": {
+            "type": "string"
+          },
+          "url": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "severity"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "scores",
+    "top_issues",
+    "report_url"
+  ],
+  "type": "object"
+}

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "already_tracked": {
+      "type": "boolean"
+    },
+    "cadence": {
+      "type": "string"
+    },
+    "created": {
+      "description": "Present when starting: whether this call created a new tracking.",
+      "type": "boolean"
+    },
+    "domain": {
+      "type": "string"
+    },
+    "message": {
+      "type": "string"
+    },
+    "removed": {
+      "description": "Present when stopping.",
+      "type": "boolean"
+    },
+    "tracking": {
+      "description": "True after a start/confirm; false after a stop.",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "domain",
+    "tracking",
+    "message"
+  ],
+  "type": "object"
+}

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "domain": {
+      "type": "string"
+    },
+    "limit": {
+      "type": "number"
+    },
+    "message": {
+      "type": "string"
+    },
+    "remaining": {
+      "type": "number"
+    },
+    "removed": {
+      "type": "boolean"
+    },
+    "tracking": {
+      "type": "boolean"
+    },
+    "used": {
+      "type": "number"
+    }
+  },
+  "required": [
+    "domain",
+    "tracking",
+    "removed",
+    "message"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "Optional. The city the business trades in, e.g. \"Hilo, HI\". Leave it out and the audit detects it; when nothing is detectable the questions widen to the country or drop the place entirely, which is right for a national or global business and wrong for a local one.",
+  "type": "string"
+}

Added value: +{
+  "description": "Optional. The business's real name, if you know it. Leave it out and the audit detects the name from the site and flags it when unverified — a guessed name is scored as if confirmed, so supply one only when it is actually known.",
+  "type": "string"
+}

Added value: +{
+  "description": "Optional. The city the business trades in, e.g. \"Hilo, HI\". Leave it out and the audit detects it; when nothing is detectable the questions widen to the country or drop the place entirely, which is right for a national or global business and wrong for a local one.",
+  "type": "string"
+}

Added value: +{
+  "description": "Optional. The business's real name, if you know it. Leave it out and the audit detects the name from the site and flags it when unverified — a guessed name is scored as if confirmed, so supply one only when it is actually known.",
+  "type": "string"
+}