@aidriftline/driftline 0.1.11 → 0.1.13

package/README.md

@@ -76,6 +76,9 @@ If you are an agent (Claude Code, Cursor, Copilot, Codex…) changing code that
 
 Driftline also runs as an [MCP](https://modelcontextprotocol.io) server, so your agent can ask it directly. Tools: `check_models` (status, date and replacement for a list of IDs), `scan_project` (retired and retiring IDs in a folder, with file and line) and `upcoming_retirements` (what retires in the next N days). It reads the daily-updated list from aidriftline.com and falls back to the copy in the package when offline.
 
+[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=driftline&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBhaWRyaWZ0bGluZS9kcmlmdGxpbmUiLCJtY3AiXX0%3D)
+[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522driftline%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522%2540aidriftline%252Fdriftline%2522%252C%2522mcp%2522%255D%257D)
+
 Claude Code:
 
 ```sh

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aidriftline/driftline",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "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/src/cli.js

@@ -28,10 +28,10 @@ function accountFromGit() {
 const HELP = `Driftline: finds AI model IDs in your code and warns before they are retired.
 
 Usage:
-  npx github:AI-Driftline/driftline [directory]            scan and print the report
-  npx github:AI-Driftline/driftline activate <license-key>  register this GitHub account for Pro
-  npx github:AI-Driftline/driftline deactivate <code>       free that account's slot
-  npx github:AI-Driftline/driftline mcp                     MCP server for coding agents (stdio)
+  npx @aidriftline/driftline [directory]            scan and print the report
+  npx @aidriftline/driftline activate <license-key>  register this GitHub account for Pro
+  npx @aidriftline/driftline deactivate <code>       free that account's slot
+  npx @aidriftline/driftline mcp                     MCP server for coding agents (stdio)
 
 Options:
   --json             print the scan as JSON (for scripts and coding agents)

package/src/mcp.js

@@ -3,7 +3,7 @@
 // Speaks JSON-RPC 2.0, one message per line on stdin/stdout (the MCP stdio transport). No dependencies.
 // Data: the live registry at aidriftline.com/models.json (updated daily), or the copy bundled with this
 // version when the site can't be reached or is older. Set DRIFTLINE_OFFLINE=1 to never fetch.
-import { readFileSync } from "node:fs";
+import { readFileSync, statSync } from "node:fs";
 import { resolve } from "node:path";
 import { createInterface } from "node:readline";
 import { REGISTRY_PATH, buildRegistry, classify, normalizeId } from "./registry.js";
@@ -55,46 +55,110 @@ function describe(rawId, reg, today) {
   };
 }
 
+const STATUS_ENUM = ["retired", "at-risk", "deprecated", "active", "unknown"];
+const MODEL_RESULT = {
+  type: "object",
+  properties: {
+    id: { type: "string", description: "The ID as given" },
+    normalized: { type: "string", description: "The ID after removing provider prefixes such as models/ or openai/" },
+    status: { type: "string", enum: STATUS_ENUM, description: "retired = calls fail (or are re-routed) now; at-risk = retires within 90 days; deprecated = retirement announced, further out; active = announced as active; unknown = no retirement published" },
+    provider: { type: "string" }, retires: { type: "string", description: "YYYY-MM-DD" },
+    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"] },
+    routes: { type: "boolean", description: "true: after the date the provider answers with the replacement model instead of failing" },
+    alias_of: { type: "string" }, page: { type: "string", description: "aidriftline.com page with the source for this date" },
+    advice: { type: "string", description: "One plain sentence to pass on to the user" },
+  },
+  required: ["id", "status", "advice"],
+};
+const META = {
+  registry_checked: { type: "string", description: "Date the registry was last checked against the provider pages" },
+  registry_source: { type: "string", enum: ["live", "bundled"], description: "live = aidriftline.com/models.json; bundled = the copy shipped in the package (used offline)" },
+  all_dates: { type: "string" },
+  next_step: { type: "string", description: "Present when a model has to move: how to test prompts on the replacement first" },
+};
+const READ_ONLY = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true };
+
 const TOOLS = [
   {
     name: "check_models",
-    description: "Check AI model IDs (OpenAI, Anthropic, Google) for retirement: status, retirement date, replacement. Use before writing or keeping a model ID in code. Accepts provider spellings such as models/gemini-2.5-pro, openai/gpt-4o or Bedrock IDs.",
-    inputSchema: { type: "object", properties: { ids: { type: "array", items: { type: "string" }, minItems: 1, description: "Model IDs, e.g. [\"gpt-4o\", \"claude-sonnet-4-5\"]" } }, required: ["ids"] },
+    title: "Check model IDs for retirement",
+    description: "Look up OpenAI, Anthropic and Google model IDs and return, for each one, its retirement status, retirement date, days left and replacement. " +
+      "Use it before writing, changing or keeping a model ID in code, or when the user asks whether a model still works. " +
+      "To find the IDs inside a codebase use scan_project instead; to list everything retiring soon use upcoming_retirements. " +
+      "Read-only. Data comes from the providers' official deprecation pages, re-checked daily at aidriftline.com (fetched with a 4 s timeout, falling back to the copy in the package when offline). " +
+      "IDs not in the registry return status \"unknown\": no retirement is published for them, which does not prove the ID exists. Up to 100 IDs per call; extra IDs are ignored.",
+    inputSchema: { type: "object", properties: {
+      ids: { type: "array", items: { type: "string" }, minItems: 1, maxItems: 100,
+        description: "Model IDs exactly as written in code, e.g. [\"gpt-4o\", \"claude-sonnet-4-5\", \"models/gemini-2.5-pro\"]. Provider prefixes (openai/, models/), Bedrock, Vertex and OpenRouter spellings and Claude short names are accepted and normalized." },
+    }, required: ["ids"] },
+    outputSchema: { type: "object", properties: { models: { type: "array", items: MODEL_RESULT }, ...META }, required: ["models", "registry_checked", "registry_source"] },
+    annotations: { title: "Check model IDs for retirement", ...READ_ONLY },
   },
   {
     name: "scan_project",
-    description: "Scan a project folder for AI model IDs in code and config and report the ones that are retired, retiring or being re-routed, with file and line. Pass the absolute path of the project if unsure what the current directory is.",
+    title: "Scan a project for retiring model IDs",
+    description: "Scan a project folder for OpenAI, Anthropic and Google model IDs in code and config files and report the ones that are retired, retiring soon, deprecated or being re-routed, with file and line, most urgent first. " +
+      "Use it to audit a repository or before a release. For IDs you already know use check_models; for a time-based list use upcoming_retirements. " +
+      "Read-only: reads files on this machine and never changes them. Scans subfolders recursively, skips .git, node_modules, vendor, dist, build and similar folders, and files over 1 MB. " +
+      "Mentions in .md and .txt files are marked in_docs. Returns at most 200 findings (truncated: true when cut). Fails with an error if the path does not exist.",
     inputSchema: { type: "object", properties: {
-      path: { type: "string", description: "Folder to scan (default: the server's current directory)" },
-      include_ok: { type: "boolean", description: "Also list models with no retirement announced (default false)" },
+      path: { type: "string", description: "Absolute path of the folder to scan. Defaults to the server's working directory, which may not be the user's project, so pass it explicitly." },
+      include_ok: { type: "boolean", default: false, description: "Also list models with no retirement announced (status active or unknown). Default false." },
     } },
+    outputSchema: { type: "object", properties: {
+      scanned: { type: "string" }, model_references: { type: "number", description: "All model ID mentions found, before filtering" },
+      flagged: { type: "number" }, truncated: { type: "boolean" },
+      findings: { type: "array", items: { ...MODEL_RESULT, properties: { file: { type: "string" }, line: { type: "number" }, in_docs: { type: "boolean" }, ...MODEL_RESULT.properties } } },
+      ...META,
+    }, required: ["scanned", "flagged", "findings"] },
+    annotations: { title: "Scan a project for retiring model IDs", ...READ_ONLY },
   },
   {
     name: "upcoming_retirements",
-    description: "List AI models retiring or being re-routed in the next N days, soonest first. Optionally filter by provider.",
+    title: "List upcoming model retirements",
+    description: "List OpenAI, Anthropic and Google models whose retirement or re-routing date falls in the next N days, soonest first, with replacement for each. " +
+      "Use it to answer \"what is being retired soon?\" or to plan migrations. It does not look at code: use scan_project for that, or check_models for specific IDs. " +
+      "Read-only. Models already past their date are not included (check_models reports those as retired). Anthropic \"not before\" dates are left out because those models are still active.",
     inputSchema: { type: "object", properties: {
-      days: { type: "number", description: "Look-ahead window in days (default 90)" },
-      provider: { type: "string", enum: ["openai", "anthropic", "google"] },
+      days: { type: "number", minimum: 1, maximum: 3650, default: 90, description: "Look-ahead window in days, 1 to 3650. Default 90." },
+      provider: { type: "string", enum: ["openai", "anthropic", "google"], description: "Only this provider. Omit for all three." },
     } },
+    outputSchema: { type: "object", properties: { days: { type: "number" }, count: { type: "number" }, models: { type: "array", items: MODEL_RESULT }, ...META }, required: ["days", "count", "models"] },
+    annotations: { title: "List upcoming model retirements", ...READ_ONLY },
   },
 ];
 
+// When a model has to move, the open question is whether the replacement answers the same way.
+const SWITCHING = new Set(["retired", "at-risk", "deprecated"]);
+function nextStep(rows) {
+  const r = rows.find((x) => x.replacement && (SWITCHING.has(x.status) || x.routes));
+  if (!r) return {};
+  return { next_step: `Before moving ${r.id} to ${r.replacement}, test the prompts this app really sends on both models: answers often change between model versions. ` +
+    "Driftline Pro runs each prompt on the current model and the replacement in GitHub Actions and shows what changed (https://aidriftline.com/#drift)." };
+}
+
 export async function callTool(name, args = {}, { reg, source, today = new Date() }) {
   const meta = { registry_checked: reg.checked, registry_source: source, all_dates: "https://aidriftline.com/models/" };
   if (name === "check_models") {
     const ids = Array.isArray(args.ids) ? args.ids.filter((x) => typeof x === "string").slice(0, 100) : [];
     if (!ids.length) throw new Error("ids must be a non-empty array of model ID strings");
-    return { models: ids.map((id) => describe(id, reg, today)), ...meta };
+    const models = ids.map((id) => describe(id, reg, today));
+    return { models, ...nextStep(models), ...meta };
   }
   if (name === "scan_project") {
     const root = resolve(args.path || ".");
+    let isDir = false;
+    try { isDir = statSync(root).isDirectory(); } catch { /* missing */ }
+    if (!isDir) throw new Error(`Not a folder: ${root}. Pass the absolute path of the project to scan.`);
     const hits = scanDirectory(root, { known: reg.byId });
     const rows = hits.map((h) => ({ file: h.file.split("\\").join("/"), line: h.line, in_docs: h.doc, ...describe(h.id, reg, today) }))
       .filter((r) => args.include_ok || !["active", "unknown"].includes(r.status));
     const order = { retired: 0, "at-risk": 1, deprecated: 2, active: 3, unknown: 4 };
     rows.sort((a, b) => order[a.status] - order[b.status] || (a.days_left ?? 1e9) - (b.days_left ?? 1e9));
     return { scanned: root, model_references: hits.length, flagged: rows.length, findings: rows.slice(0, 200),
-      ...(rows.length > 200 ? { truncated: true } : {}), ...meta };
+      ...(rows.length > 200 ? { truncated: true } : {}), ...nextStep(rows), ...meta };
   }
   if (name === "upcoming_retirements") {
     const days = Number.isFinite(args.days) && args.days > 0 ? Math.min(args.days, 3650) : 90;

package/src/run.js

@@ -57,7 +57,7 @@ export async function run({
       notices.push(`Drift tests stopped: ${e.message}. The scan results above are complete.`);
     }
   } else if (findings.some((f) => FLAGGED.has(f.status))) {
-    notices.push(`Add ${promptsFile} to test your real prompts on the replacement model before you switch.`);
+    notices.push(`Before you switch, test the prompts your app really sends on the replacement model: list them in ${promptsFile} and Driftline Pro runs each one on both models and shows what changed. https://aidriftline.com/#drift`);
   }
 
   const atRisk = findings.filter((f) => !f.doc && (f.status === "retired" || f.status === "at-risk")).length;