fix(model): use .md doc URLs and fail the drift job on unverified

Two corrections to the drift check:

- SOURCES.context pointed at the extensionless docs URL, justified by a
  comment claiming the .md form returned 404. Not reproducible: measured
  against both URL shapes, the .md form returns the markdown table under
  both a markdown-preferring and a wildcard Accept header, while the
  extensionless form returns a ~110KB HTML page under a wildcard Accept.
  The .md form does not depend on the Accept header staying
  markdown-preferring, so both sources now use it. Comment corrected to
  the measured behavior.

- Exit 2 (docs unreachable/unparseable, or a model id matching nothing)
  annotated a warning and exited 0, so a permanently broken check would
  pass every week indefinitely. It now fails the job: unverified is not
  the same as verified-clean.

Regenerated output changes one line, the source URL recorded in the
generated header. No numeric value changed.

Author: justin-carper

.github/workflows/ci.yml

@@ -84,8 +84,8 @@ jobs:
             exit 1
           fi
           if [ "$code" = "2" ]; then
-            echo "::warning::Could not verify model data (docs unreachable or unparseable)."
-            exit 0
+            echo "::error::Could not verify model data (docs unreachable, unparseable, or a model id matched nothing). The drift check did not run — treat this as unverified, not as passing."
+            exit 1
           fi
           if [ "$code" != "0" ]; then
             echo "::error::Unexpected exit code $code from the drift check."

scripts/sync-model-limits.mjs

@@ -39,17 +39,22 @@ const HERE = dirname(fileURLToPath(import.meta.url));
 const OUTPUT_PATH = join(HERE, "..", "src", "model-limits.ts");
 
 /**
- * The two docs pages. Cursor serves markdown for these two paths through
- * different URL shapes and it is not symmetric: `models-and-pricing.md` returns
- * markdown while the extensionless form returns HTML, and
- * `request-based-legacy.md` returns `{"error":"File not found"}` (HTTP 404)
- * while the extensionless form returns markdown. Each URL is therefore the one
- * that currently serves markdown for its page, not a consistent convention. A
- * non-2xx response or a page that stops carrying the expected columns exits 2,
- * so if Cursor moves either one it surfaces rather than going quiet.
+ * The two docs pages, both in their `.md` form.
+ *
+ * Cursor's docs site content-negotiates. Measured against both URL shapes:
+ * with the markdown-preferring Accept header `fetchDoc` sends, the `.md` and
+ * extensionless forms both return the same markdown. With a default wildcard
+ * Accept header, only the `.md` form does — the extensionless form returns the
+ * ~110KB HTML page instead, which carries no pipe table.
+ *
+ * The `.md` form is therefore the more robust choice: it does not depend on the
+ * Accept header staying markdown-preferring. Keep both URLs on `.md`.
+ *
+ * A non-2xx response, or a page that stops carrying the expected columns,
+ * exits 2 — so if Cursor moves either page it surfaces rather than going quiet.
  */
 export const SOURCES = {
-  context: "https://cursor.com/docs/account/pricing/request-based-legacy",
+  context: "https://cursor.com/docs/account/pricing/request-based-legacy.md",
   pricing: "https://cursor.com/docs/models-and-pricing.md",
 };
 

src/model-limits.ts

@@ -2,7 +2,7 @@
  * GENERATED FILE — do not edit by hand.
  *
  * Generated by `scripts/sync-model-limits.mjs` from Cursor's published docs:
- *   context windows  https://cursor.com/docs/account/pricing/request-based-legacy
+ *   context windows  https://cursor.com/docs/account/pricing/request-based-legacy.md
  *   pricing          https://cursor.com/docs/models-and-pricing.md
  *
  * Data last changed: 2026-08-03