@aidriftline/driftline 0.1.16 → 0.2.0

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.16",
+  "version": "0.2.0",
   "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.",
+  "checked": "2026-11-14",
+  "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",
@@ -13,6 +13,7 @@
       "retires": "2027-02-10",
       "qualifier": "exact",
       "replacement": "gpt-image-2.6-sunburst",
+      "replacement_alt": "gpt-image-2.6-flare",
       "kind": "image",
       "announced": "2026-11-10"
     },
@@ -22,6 +23,7 @@
       "retires": "2027-02-10",
       "qualifier": "exact",
       "replacement": "gpt-image-2.6-sunburst",
+      "replacement_alt": "gpt-image-2.6-flare",
       "kind": "image",
       "announced": "2026-11-10"
     },
@@ -1072,6 +1074,7 @@
       "retires": "2027-02-26",
       "qualifier": "exact",
       "replacement": "gpt-live-transcribe",
+      "replacement_alt": "gpt-transcribe",
       "kind": "audio"
     },
     {
@@ -1080,6 +1083,7 @@
       "retires": "2027-02-26",
       "qualifier": "exact",
       "replacement": "gpt-live-transcribe",
+      "replacement_alt": "gpt-transcribe",
       "kind": "audio"
     },
     {
@@ -1088,6 +1092,7 @@
       "retires": "2027-02-26",
       "qualifier": "exact",
       "replacement": "gpt-live-transcribe",
+      "replacement_alt": "gpt-transcribe",
       "kind": "audio"
     },
     {
@@ -1096,6 +1101,7 @@
       "retires": "2027-02-26",
       "qualifier": "exact",
       "replacement": "gpt-live-transcribe",
+      "replacement_alt": "gpt-transcribe",
       "kind": "audio"
     },
     {
@@ -1104,6 +1110,7 @@
       "retires": "2027-02-26",
       "qualifier": "exact",
       "replacement": "gpt-live-transcribe",
+      "replacement_alt": "gpt-transcribe",
       "kind": "audio"
     },
     {
@@ -1312,6 +1319,7 @@
       "retires": "2026-10-23",
       "qualifier": "exact",
       "replacement": "gpt-image-2.5-sunburst",
+      "replacement_alt": "gpt-image-2.5-flare",
       "kind": "image"
     },
     {
@@ -1320,6 +1328,7 @@
       "retires": "2026-12-01",
       "qualifier": "exact",
       "replacement": "gpt-image-2.6-sunburst",
+      "replacement_alt": "gpt-image-2.6-flare",
       "kind": "image"
     },
     {
@@ -1328,6 +1337,7 @@
       "retires": "2026-12-01",
       "qualifier": "exact",
       "replacement": "gpt-image-2.6-sunburst",
+      "replacement_alt": "gpt-image-2.6-flare",
       "kind": "image"
     },
     {
@@ -1336,6 +1346,7 @@
       "retires": "2026-12-01",
       "qualifier": "exact",
       "replacement": "gpt-image-2.6-sunburst",
+      "replacement_alt": "gpt-image-2.6-flare",
       "kind": "image"
     },
     {
@@ -1344,6 +1355,7 @@
       "retires": "2026-12-01",
       "qualifier": "exact",
       "replacement": "gpt-image-2.6-sunburst",
+      "replacement_alt": "gpt-image-2.6-flare",
       "kind": "image"
     },
     {
@@ -1697,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"
@@ -1716,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/cli.js

@@ -81,7 +81,7 @@ if (cmd === "-h" || cmd === "--help" || cmd === "help") {
     const pick = (f) => ({
       id: f.id, file: f.file, line: f.line, status: f.status, docOnly: !!f.doc,
       provider: f.entry?.provider, retires: f.entry?.retires, qualifier: f.entry?.qualifier,
-      replacement: f.entry?.replacement, migration: migrationFor(f.entry) || undefined, routes: !!f.entry?.routes, aliasOf: f.entry?.aliasOf,
+      replacement: f.entry?.replacement, replacement_alt: f.entry?.replacement_alt, migration: migrationFor(f.entry) || undefined, routes: !!f.entry?.routes, aliasOf: f.entry?.aliasOf,
     });
     console.log(JSON.stringify({ findings: result.findings.map(pick), drift: result.drift || [] }, null, 2));
   } else console.log(result.markdown);

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 } from "./registry.js";
+import { loadBestRegistry, classify, normalizeId, replacementChange, replacementText } from "./registry.js";
 import { migrationFor } from "./migration.js";
 import { scanDirectory } from "./scan.js";
 
@@ -24,7 +24,7 @@ function advice(c, today = new Date()) {
   const chg = replacementChange(m, today);
   const mig = migrationFor(m);
   const migText = mig && !mig.drop_in && mig.change !== "settings" ? ` More than a rename: ${mig.note}` : mig?.change === "choose" ? ` ${mig.note}` : "";
-  const repl = m.replacement ? ` Replacement: ${m.replacement}${m.replacement_note ? ` (${m.replacement_note})` : ""}.${chg ? ` ${who} changed this recommendation on ${chg.on}; before it was ${chg.was}.` : ""}` : "";
+  const repl = m.replacement ? ` Replacement: ${replacementText(m)}.${chg ? ` ${who} changed this recommendation on ${chg.on}; before it was ${chg.was}.` : ""}` : "";
   if (m.qualifier === "not-before") return `Active. ${who} says it will not be retired before ${m.retires}.`;
   if (m.routes) return c.days <= 0
     ? `Since ${m.retires}, ${who} answers requests for it with ${m.replacement}. No error, but answers come from a different model.${migText}`
@@ -43,7 +43,7 @@ function describe(rawId, reg, today) {
     id: rawId, ...(id !== rawId ? { normalized: id } : {}),
     status: c.status, ...(m ? {
       provider: m.provider, retires: m.retires, qualifier: m.qualifier, days_left: c.days,
-      replacement: m.replacement || null, ...(m.replacement_note ? { replacement_note: m.replacement_note } : {}),
+      replacement: m.replacement || null, ...(m.replacement_alt ? { replacement_alt: m.replacement_alt } : {}), ...(m.replacement_note ? { replacement_note: m.replacement_note } : {}),
       ...(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) } : {}),
@@ -62,6 +62,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"] },
+    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" },
     migration: { type: "object", description: "Whether moving to the replacement is just a new model name (drop_in true) or needs more: change = rename | settings | params | api | re-embed | choose, with a note and the provider's guide", properties: { change: { type: "string" }, drop_in: { type: "boolean" }, note: { type: "string" }, guide: { type: ["string", "null"] } } },

package/src/registry.js

@@ -40,12 +40,18 @@ export function buildRegistry(data) {
     if (!m.replacement) continue;
     const seen = new Set([m.id]);
     let next = m.replacement;
+    let hop = m; // the entry whose replacement is `next`: its second option and note belong to that target
     seen.add(next);
     while (byId.get(next)?.replacement && byId.get(next).qualifier !== "not-before" && !seen.has(byId.get(next).replacement)) {
-      next = byId.get(next).replacement;
+      hop = byId.get(next);
+      next = hop.replacement;
       seen.add(next);
     }
-    if (next !== m.replacement && next !== m.id) { m.via = m.replacement; m.replacement = next; }
+    if (next !== m.replacement && next !== m.id) {
+      m.via = m.replacement; m.replacement = next;
+      if (hop.replacement_alt) m.replacement_alt = hop.replacement_alt; else delete m.replacement_alt;
+      if (hop.replacement_note) m.replacement_note = hop.replacement_note; else delete m.replacement_note;
+    }
   }
   // Anthropic short names point at a dated snapshot: "claude-sonnet-4-5" and "-latest" -> claude-sonnet-4-5-20250929,
   // "claude-sonnet-4-0" -> claude-sonnet-4-20250514. The deprecation page lists only snapshots, so a short name
@@ -95,7 +101,7 @@ export const isTextModel = (entry) => !entry?.kind || entry.kind === "text";
 // The replacement as people should read it: the model, plus the provider's extra instruction when there is one,
 // e.g. "gpt-6.1-sol (reasoning.mode: pro, in the Responses API)". Without the note, a rename alone is not the move.
 export const replacementText = (entry) => entry?.replacement
-  ? entry.replacement + (entry.replacement_note ? ` (${entry.replacement_note})` : "") : "";
+  ? entry.replacement + (entry.replacement_alt ? ` or ${entry.replacement_alt}` : "") + (entry.replacement_note ? ` (${entry.replacement_note})` : "") : "";
 
 // 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.

package/src/report.js

@@ -83,7 +83,7 @@ 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_note ? " (" + esc(r.entry.replacement_note) + ")" : "") + changed(r.entry, today) : ""} | ${changeCell} | ${places} |`);
+      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 (all.length > rows.length) lines.push("", `_${all.length - rows.length} more model ID(s) with no retirement listed are not shown._`);
     if (migNotes.size) {