@aidriftline/driftline 0.1.17 → 0.2.1

package/README.md

@@ -103,6 +103,10 @@ Needs Node 20+. Free, no key.
 
 Every model also has its own page with the date, replacement and source: [aidriftline.com/models](https://aidriftline.com/models/).
 
+## Versions
+
+Releases are numbered `0.x.y`. A new `x` means new features; a new `y` means fixes or updated retirement data, which can ship several times a week. `uses: AI-Driftline/driftline@v0` always runs the newest release, and the Action reads the live retirement list at aidriftline.com either way, so a provider's change reaches you without a new version.
+
 ## Development
 
 ```sh

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aidriftline/driftline",
-  "version": "0.1.17",
+  "version": "0.2.1",
   "description": "Finds OpenAI, Anthropic and Google model IDs in your code and warns before they are retired. CLI, GitHub Action and MCP server.",
   "mcpName": "io.github.AI-Driftline/driftline",
   "type": "module",

package/registry/models.json

@@ -1,6 +1,6 @@
 {
   "checked": "2026-11-13",
-  "note": "Hand-maintained from the official deprecation pages. Re-check before each release. Entries with a 'kind' other than text are scanned and reported but never drift-tested. gpt-4-1106-preview is listed on OpenAI's page under both 2026-03-26 and 2026-10-23; the later date is used so builds are not failed on a conflicting record. Entries with routes: true keep answering after the date, but the provider sends the requests to the replacement model (Google calls this automatic routing); the 'retires' date is the day routing starts. gemini-3.5-flash and gemini-3.7-flash already route to newer models with no date given, so they are left out.",
+  "note": "Hand-maintained from the official deprecation pages. Re-check before each release. Entries with a 'kind' other than text are scanned and reported but never drift-tested. gpt-4-1106-preview is listed on OpenAI's page under both 2026-03-26 and 2026-10-23; the later date is used so builds are not failed on a conflicting record. Entries with routes: true keep answering after the date, but the provider sends the requests to the replacement model (Google calls this automatic routing); the 'retires' date is the day routing starts. gemini-3.5-flash and gemini-3.7-flash already route to newer models with no date given, so they are left out. gemini-3.1-flash-live-preview was removed on 2026-11-14: Google now lists it with no shutdown date.",
   "sources": {
     "openai": "https://developers.openai.com/api/docs/deprecations",
     "anthropic": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
@@ -1709,18 +1709,10 @@
       "replacement": "gemini-3.8-live",
       "kind": "audio"
     },
-    {
-      "id": "gemini-3.1-flash-live-preview",
-      "provider": "google",
-      "retires": "2026-11-17",
-      "qualifier": "earliest",
-      "replacement": "gemini-3.8-live",
-      "kind": "audio"
-    },
     {
       "id": "gemini-2.5-flash-native-audio-preview-12-2025",
       "provider": "google",
-      "retires": "2026-11-17",
+      "retires": "2027-03-31",
       "qualifier": "earliest",
       "replacement": "gemini-3.8-live",
       "kind": "audio"
@@ -1728,25 +1720,28 @@
     {
       "id": "gemini-3.1-flash-tts-preview",
       "provider": "google",
-      "retires": "2026-11-17",
+      "retires": "2026-12-18",
       "qualifier": "earliest",
       "replacement": "gemini-3.8-flash-tts",
+      "replacement_alt": "gemini-3.8-flash-lite-tts",
       "kind": "audio"
     },
     {
       "id": "gemini-2.5-flash-preview-tts",
       "provider": "google",
-      "retires": "2026-11-17",
+      "retires": "2026-12-18",
       "qualifier": "earliest",
       "replacement": "gemini-3.8-flash-tts",
+      "replacement_alt": "gemini-3.8-flash-lite-tts",
       "kind": "audio"
     },
     {
       "id": "gemini-2.5-pro-preview-tts",
       "provider": "google",
-      "retires": "2026-11-17",
+      "retires": "2026-12-18",
       "qualifier": "earliest",
       "replacement": "gemini-3.8-flash-tts",
+      "replacement_alt": "gemini-3.8-flash-lite-tts",
       "kind": "audio"
     },
     {

package/src/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 // GitHub Action entry point.
-import { replacementText, replacementChange, loadBestRegistry } from "./registry.js";
+import { replacementText, replacementChange, loadBestRegistry, reviewText } from "./registry.js";
 import { migrationFor } from "./migration.js";
 import { resolve } from "node:path";
 import { statSync } from "node:fs";
@@ -65,7 +65,8 @@ async function main() {
       ? `${f.id} is past its earliest shutdown date (${f.entry.retires}) and may stop working at any time.`
       : `${f.id} ${STATUS_TEXT[f.status]} (${f.entry.retires}).`;
     const routedMore = f.entry.routes && migrationFor(f.entry)?.change === "params" ? ` Before then, apply the request changes the provider lists: ${migrationFor(f.entry).note}` : "";
-    annotate(level, text + repl + more + routedMore, f.file, f.line);
+    const review = f.entry.under_review ? ` ${reviewText(f.entry)}` : "";
+    annotate(level, text + repl + more + routedMore + review, f.file, f.line);
   }
 
   // The report contains model answers; stop GitHub from reading any "::command::" lines inside it.

package/src/mcp.js

@@ -6,7 +6,7 @@
 import { readFileSync, statSync } from "node:fs";
 import { resolve } from "node:path";
 import { createInterface } from "node:readline";
-import { loadBestRegistry, classify, normalizeId, replacementChange, replacementText } from "./registry.js";
+import { loadBestRegistry, classify, normalizeId, replacementChange, replacementText, reviewText } from "./registry.js";
 import { migrationFor } from "./migration.js";
 import { scanDirectory } from "./scan.js";
 
@@ -47,7 +47,8 @@ function describe(rawId, reg, today) {
       ...(m.previous_replacement ? { previous_replacement: m.previous_replacement, replacement_changed: m.replacement_changed } : {}), routes: !!m.routes, ...(m.aliasOf ? { alias_of: m.aliasOf } : {}), page: page(m.aliasOf || m.id),
     } : {}),
     ...(m && migrationFor(m) ? { migration: migrationFor(m) } : {}),
-    advice: advice(c, today),
+    ...(m?.under_review ? { under_review: m.under_review } : {}),
+    advice: (m?.under_review ? reviewText(m) + " " : "") + advice(c, today),
   };
 }
 
@@ -62,6 +63,7 @@ const MODEL_RESULT = {
     qualifier: { type: "string", enum: ["exact", "earliest", "not-before"], description: "exact date, earliest possible shutdown (Google), or not before this date (Anthropic)" },
     days_left: { type: "number", description: "Days until the date; 0 or negative when it has passed" },
     replacement: { type: ["string", "null"] },
+    under_review: { type: "object", description: "Present when the provider's page no longer matches this entry and Driftline is updating it: since (date), what (date, replacement or listing), page (source to check)", properties: { since: { type: "string" }, what: { type: "string" }, page: { type: "string" } } },
     replacement_alt: { type: "string", description: "A second replacement the provider names (\"X or Y\"); which one fits depends on how the model is used" },
     previous_replacement: { type: "string", description: "The replacement the provider recommended before it changed its advice" },
     replacement_changed: { type: "string", description: "YYYY-MM-DD: when the change was seen on the provider's page" },

package/src/registry.js

@@ -103,6 +103,15 @@ export const isTextModel = (entry) => !entry?.kind || entry.kind === "text";
 export const replacementText = (entry) => entry?.replacement
   ? entry.replacement + (entry.replacement_alt ? ` or ${entry.replacement_alt}` : "") + (entry.replacement_note ? ` (${entry.replacement_note})` : "") : "";
 
+// The live list marks an entry under_review when the provider's page no longer matches it (found by the page check
+// every 6 hours) and the registry hasn't been fixed yet. Say so instead of presenting the stored date as fact.
+const WHO_NAME = { openai: "OpenAI", anthropic: "Anthropic", google: "Google" };
+export function reviewText(entry) {
+  const r = entry?.under_review;
+  if (!r) return "";
+  return `Under review: ${WHO_NAME[entry.provider] || entry.provider}'s page no longer matches the ${r.what || "entry"} shown here (since ${r.since}); Driftline is updating it. Check ${r.page || "the provider's deprecation page"} before acting on this ${r.what === "replacement" ? "replacement" : "date"}.`;
+}
+
 // Providers sometimes change the recommended replacement after announcing a retirement. The registry keeps
 // the old one and the date we saw the change, so reports can say so instead of silently switching targets.
 export const RECENT_CHANGE_DAYS = 120;

package/src/report.js

@@ -1,4 +1,4 @@
-import { replacementChange } from "./registry.js";
+import { replacementChange, reviewText } from "./registry.js";
 import { migrationFor, MIGRATION_LABEL } from "./migration.js";
 
 const STATUS_LABEL = {
@@ -68,6 +68,7 @@ export function renderReport({ findings, drift, registry, notices = [], answers
       : `Found ${byModel.size} model ID${byModel.size === 1 ? "" : "s"}. None are scheduled for retirement.`);
     lines.push("", "| Model | Status | Retirement | Replacement | Change needed | Where |", "|---|---|---|---|---|---|");
     const migNotes = new Map(); // note → { n, ids, guide } for the list under the table
+    const underReview = []; // rows whose provider page changed and the registry isn't fixed yet
     const order = ["retired", "at-risk", "deprecated", "active", "unknown"];
     const all = [...byModel.values()].sort((a, b) => order.indexOf(a.status) - order.indexOf(b.status));
     const rows = all.slice(0, MAX_ROWS); // flagged models sort first, so only unknown/active rows get cut
@@ -83,9 +84,14 @@ export function renderReport({ findings, drift, registry, notices = [], answers
       }
       const places = r.places.slice(0, 3).join(", ") + (r.places.length > 3 ? ` +${r.places.length - 3} more` : "");
       const docsOnly = r.places.length && byModel.get(r.id).docs === r.places.length ? " · docs only" : "";
-      lines.push(`| ${code(r.id)}${r.entry?.aliasOf ? " · alias of " + code(r.entry.aliasOf) : ""}${r.entry?.kind && r.entry.kind !== "text" ? " · " + r.entry.kind : ""} | ${label(r)}${docsOnly} | ${esc(when(r))} | ${r.entry?.replacement ? code(r.entry.replacement) + (r.entry.replacement_alt ? " or " + code(r.entry.replacement_alt) : "") + (r.entry.replacement_note ? " (" + esc(r.entry.replacement_note) + ")" : "") + changed(r.entry, today) : ""} | ${changeCell} | ${places} |`);
+      if (r.entry?.under_review) underReview.push(r);
+      lines.push(`| ${code(r.id)}${r.entry?.aliasOf ? " · alias of " + code(r.entry.aliasOf) : ""}${r.entry?.kind && r.entry.kind !== "text" ? " · " + r.entry.kind : ""} | ${label(r)}${docsOnly}${r.entry?.under_review ? " · 🔍 under review" : ""} | ${esc(when(r))} | ${r.entry?.replacement ? code(r.entry.replacement) + (r.entry.replacement_alt ? " or " + code(r.entry.replacement_alt) : "") + (r.entry.replacement_note ? " (" + esc(r.entry.replacement_note) + ")" : "") + changed(r.entry, today) : ""} | ${changeCell} | ${places} |`);
     }
     if (all.length > rows.length) lines.push("", `_${all.length - rows.length} more model ID(s) with no retirement listed are not shown._`);
+    if (underReview.length) {
+      lines.push("", "**🔍 Under review:**", "");
+      for (const r of underReview) lines.push(`- ${code(r.id)}: ${esc(reviewText(r.entry))}`);
+    }
     if (migNotes.size) {
       lines.push("", "**More than a rename:**", "");
       for (const [note, m] of migNotes) lines.push(`${m.n}. ${m.ids.map(code).join(", ")}: ${esc(note)}${m.guide ? ` ([provider guide](${m.guide}))` : ""}`);