Previous value: -"What re-reads this retailer’s prices: `live-api` a product-lookup API, `feed` a partner datafeed, `none` nothing at all. `none` means the figure is frozen at whatever seeded it and will not move however long it sits — say so rather than quoting it flat."New value: +"What re-reads this retailer’s prices: `live-api` a product-lookup API, `feed` a partner datafeed, `crawl` WEM reading the retailer’s own public product page, `none` nothing at all. `none` means the figure is frozen at whatever seeded it and will not move however long it sits — say so rather than quoting it flat. A `crawl` price was observed on the retailer’s page rather than supplied by them, so date it with `priceAgeDays` and expect `affiliate: false` unless a programme also exists."

Previous value: -[
-  "live-api",
-  "feed",
-  "none"
-]New value: +[
+  "live-api",
+  "feed",
+  "crawl",
+  "none"
+]

Previous value: -"Affiliate disclosure to relay once per answer. Outbound links are tracked at no extra cost to the buyer."New value: +"Disclosure to relay once per answer, verbatim. Its wording changes with the rows: it states whether every outbound link is affiliate-tracked, only some are, or none are. Never substitute the version you saw last time — a row marked `affiliate: false` earns WEM nothing, and saying otherwise misdescribes it to the shopper."

Added value: +{
+  "description": "Present when this result names no offer. GIVE THE USER THIS LINK — it is the answer when WEM has nothing else to say, and `markdown` is ready to paste. WEM searches retailers live on that page, including shops it holds no affiliate programme with, so an empty or withheld result here is not evidence the product is unavailable or unpriced.",
+  "properties": {
+    "markdown": {
+      "description": "The same link, pre-formatted.",
+      "type": "string"
+    },
+    "reason": {
+      "type": "string"
+    },
+    "url": {
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Added value: +{
+  "description": "Present when `price` is the OPENING price of a range, not the price of this item: a multi-variation listing where the seller advertises its cheapest variant and the shopper picks a size on the page. Quote it as \"from £X\", never as the price or the cheapest. Absent means the price is firm for the row as described.",
+  "enum": [
+    "from"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Present when `price` is the OPENING price of a range, not the price of this item: a multi-variation listing where the seller advertises its cheapest variant and the shopper picks a size on the page. Quote it as \"from £X\", never as the price or the cheapest. Absent means the price is firm for the row as described.",
+  "enum": [
+    "from"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Present when `price` is the OPENING price of a range, not the price of this item: a multi-variation listing where the seller advertises its cheapest variant and the shopper picks a size on the page. Quote it as \"from £X\", never as the price or the cheapest. Absent means the price is firm for the row as described.",
+  "enum": [
+    "from"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "retailer is a named shop (Boots, Currys). marketplace is eBay/AliExpress/Temu-style parallel listings. Do not present a marketplace cluster as competing authorised retailers.",
+  "enum": [
+    "retailer",
+    "marketplace"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Delivery window when the feed stated one.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "retailer is a named shop (Boots, Currys). marketplace is eBay/AliExpress/Temu-style parallel listings. Do not present a marketplace cluster as competing authorised retailers.",
+  "enum": [
+    "retailer",
+    "marketplace"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Delivery window when the feed stated one.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "retailer is a named shop (Boots, Currys). marketplace is eBay/AliExpress/Temu-style parallel listings. Do not present a marketplace cluster as competing authorised retailers.",
+  "enum": [
+    "retailer",
+    "marketplace"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Delivery window when the feed stated one.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Previous value: -"A null `recommendation` means no confident match was found. Report that as \"no confident match\" — never soften it into a suggestion."New value: +"A null `recommendation` with `coverage.kind` marketplace_only still has listings in `alternatives` — give those links. A null with no alternatives is a genuine miss. Never soften a genuine miss into a suggestion."

Previous value: -"Up to three runners-up."New value: +"Listings still worth showing, including when recommendation is null."

Added value: +{
+  "description": "False when this is a retailer page WEM observed without a programme. Still a real listing; the click is not commission-bearing. Absent means the usual partner path.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "False when this is a retailer page WEM observed without a programme. Still a real listing; the click is not commission-bearing. Absent means the usual partner path.",
+  "type": "boolean"
+}

Previous value: -"Present when every surviving row is a marketplace listing clustered at similar prices. That is not a retail floor — do not name the cheapest as the deal, and do not present the listings as competing retailers. WEM does not hold an authorised retailer for this product."New value: +"Present when surviving rows include a marketplace cluster at similar prices. That is not a retail floor — do not name the cheapest marketplace listing as the deal. The listings are still in the payload; give the user those links. If `next` points at the Chrome extension, send the shopper there for shops WEM does not yet hold as partners."

Added value: +{
+  "description": "Where to send the shopper when WEM's set is thin. chrome_extension means compare the same product on any retailer page — WEM shows that price even without an affiliate programme.",
+  "properties": {
+    "reason": {
+      "type": "string"
+    },
+    "surface": {
+      "enum": [
+        "chrome_extension"
+      ],
+      "type": "string"
+    },
+    "url": {
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Added value: +{
+  "description": "False when this is a retailer page WEM observed without a programme. Still a real listing; the click is not commission-bearing. Absent means the usual partner path.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Present when every surviving row is a marketplace listing clustered at similar prices. That is not a retail floor — do not name the cheapest as the deal, and do not present the listings as competing retailers. WEM does not hold an authorised retailer for this product.",
+  "properties": {
+    "currency": {
+      "type": "string"
+    },
+    "high": {
+      "type": "number"
+    },
+    "kind": {
+      "enum": [
+        "marketplace_only"
+      ],
+      "type": "string"
+    },
+    "listings": {
+      "type": "number"
+    },
+    "low": {
+      "type": "number"
+    },
+    "provider": {
+      "description": "ebay, aliexpress, or marketplace when mixed.",
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Previous value: -"When WEM last read these offers — the freshness of this block."New value: +"When WEM last actually read any price in this block. Null means none of them can be dated — say so rather than implying the block is current."

Previous value: -"When WEM last wrote this offer row."New value: +"When WEM last VISITED this offer row — not when it read the price. The refresh sweep touches this even when the retailer lookup fails, so it is not evidence the price is current. Use `priceAgeDays` to date a price; never this."

Previous value: -"Whole days since WEM last wrote this price. Null means unknown age — report it as unknown rather than assuming it is current."New value: +"Whole days since WEM last actually READ this price from the retailer or a datafeed. Null means WEM cannot say — common and correct for Amazon, whose licence caps price retention at 24 hours. Report null as undated; never present it as current."

Previous value: -"Offers resolved by barcode rather than by matching titles. When present, prefer these and cite their prices over anything in `products`."New value: +"Offers WEM holds under one catalogue product. Check `identityBasis`: on `barcode` these are resolved by GTIN rather than by matching titles, so prefer them and cite their prices over anything in `products`. On `curated-grouping` the product carries no barcode, the grouping is an inference like any title match, and a cheaper row in `products` may well be the same item — see `cheaperElsewhere`."

Added value: +{
+  "description": "Present only on a `curated-grouping` block that a live row in `products` undercuts. WEM is telling you its own catalogue block is not the best price it found. Quote this row as the cheaper option with its identity stated as unconfirmed; never present the catalogMatch price as the lowest when this is set.",
+  "properties": {
+    "identity": {
+      "description": "Always `inferred` — matched on title, not barcode. Say so when quoting it.",
+      "enum": [
+        "inferred"
+      ],
+      "type": "string"
+    },
+    "note": {
+      "description": "Plain-language restatement, safe to relay.",
+      "type": "string"
+    },
+    "savingVsCatalogue": {
+      "description": "How much cheaper this row is than the block’s lowest offer.",
+      "type": "number"
+    },
+    "verified": {
+      "description": "Always false.",
+      "type": "boolean"
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}

Added value: +{
+  "description": "What this block’s identity rests on. `barcode` — the canonical product carries a GTIN and these offers are the same physical item. `curated-grouping` — it carries none, so the grouping is an inference of the same kind a title match is; do not describe it to the user as barcode-confirmed, and do not let it outrank a cheaper row in `products` on price alone.",
+  "enum": [
+    "barcode",
+    "curated-grouping"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "When WEM last read these offers — the freshness of this block.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "When WEM last wrote this offer row.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Whole days since WEM last wrote this price. Null means unknown age — report it as unknown rather than assuming it is current.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

Added value: +{
+  "description": "What re-reads this retailer’s prices: `live-api` a product-lookup API, `feed` a partner datafeed, `none` nothing at all. `none` means the figure is frozen at whatever seeded it and will not move however long it sits — say so rather than quoting it flat.",
+  "enum": [
+    "live-api",
+    "feed",
+    "none"
+  ],
+  "type": "string"
+}

Previous value: -"ISO 4217 code to quote in. Default GBP. Offers in other currencies are withheld, never converted."New value: +"ISO 4217 code to quote in. Default GBP. Offers in other currencies are withheld, never converted. Pass the shopper's market explicitly — WEM does not infer currency or retailer market from IP."

Previous value: -"What to search for"New value: +"Product name, barcode, ASIN, WEM ID, or wem3.ai/pl URL. A specific model should prefer compare_offers; this still resolves one if the host sends it here."

Added value: +{
+  "description": "ISO 4217 code to quote in. Default GBP. Offers in other currencies are withheld, never converted.",
+  "type": "string"
+}

Added value: +{
+  "description": "If true, include used and refurbished listings. Default false — a used item is a different good, not a cheaper one.",
+  "type": "boolean"
+}

Previous value: -"Always true here — identity is resolved, not inferred."New value: +"True when WEM has recently observed this price on the retailer’s own surface. False means the identity is still catalogue-resolved but the price is indicative (partner feed or stale) — do not present it as verified."

Previous value: -"True when WEM resolved this offer’s identity rather than inferring it from the title."New value: +"True when WEM resolved this offer’s identity AND recently observed its price on the retailer’s surface. A recommendation can be unverified and still the best candidate — report it as such."