@aidriftline/driftline 0.1.10 → 0.1.12

package/README.md

@@ -21,10 +21,10 @@ It runs inside your own CI with your own API keys. There is no Driftline server:
 3. Activate your Pro key once per GitHub account or organization, from inside one of its repositories:
 
    ```sh
-   npx github:AI-Driftline/driftline activate <your-license-key>
+   npx @aidriftline/driftline activate <your-license-key>
    ```
 
-   It prints a license code. Save that code as the secret `DRIFTLINE_LICENSE_KEY`. A key works on up to 3 GitHub accounts or organizations; `npx github:AI-Driftline/driftline deactivate <code>` frees one.
+   It prints a license code. Save that code as the secret `DRIFTLINE_LICENSE_KEY`. A key works on up to 3 GitHub accounts or organizations; `npx @aidriftline/driftline deactivate <code>` frees one.
 
 ## Inputs
 
@@ -62,24 +62,27 @@ Text is compared with word and word-pair overlap. JSON is compared field by fiel
 No install, no key:
 
 ```sh
-npx github:AI-Driftline/driftline path/to/your/repo          # report
-npx github:AI-Driftline/driftline path/to/your/repo --json   # same, as JSON
+npx @aidriftline/driftline path/to/your/repo          # report
+npx @aidriftline/driftline path/to/your/repo --json   # same, as JSON
 ```
 
 Exit code 1 means a retired model is used in code.
 
 ## For AI coding agents
 
-If you are an agent (Claude Code, Cursor, Copilot, Codex…) changing code that calls OpenAI, Anthropic or Google: run `npx -y github:AI-Driftline/driftline . --json` before you pick or keep a model ID, and do not introduce an ID whose `status` is `retired` or `at-risk`. Without a shell, look the ID up in [`registry/models.json`](registry/models.json) or at `https://aidriftline.com/models/<model-id>/`. More, including a snippet for `AGENTS.md` / `CLAUDE.md`: [aidriftline.com/agents](https://aidriftline.com/agents/).
+If you are an agent (Claude Code, Cursor, Copilot, Codex…) changing code that calls OpenAI, Anthropic or Google: run `npx -y @aidriftline/driftline . --json` before you pick or keep a model ID, and do not introduce an ID whose `status` is `retired` or `at-risk`. Without a shell, look the ID up in [`registry/models.json`](registry/models.json) or at `https://aidriftline.com/models/<model-id>/`. More, including a snippet for `AGENTS.md` / `CLAUDE.md`: [aidriftline.com/agents](https://aidriftline.com/agents/).
 
 ### MCP server
 
 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
-claude mcp add driftline -- npx -y github:AI-Driftline/driftline mcp
+claude mcp add driftline -- npx -y @aidriftline/driftline mcp
 ```
 
 Cursor, Windsurf, Claude Desktop and other clients (`mcp.json` / `claude_desktop_config.json`):
@@ -87,7 +90,7 @@ Cursor, Windsurf, Claude Desktop and other clients (`mcp.json` / `claude_desktop
 ```json
 {
   "mcpServers": {
-    "driftline": { "command": "npx", "args": ["-y", "github:AI-Driftline/driftline", "mcp"] }
+    "driftline": { "command": "npx", "args": ["-y", "@aidriftline/driftline", "mcp"] }
   }
 }
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aidriftline/driftline",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "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

@@ -1033,7 +1033,7 @@
       "provider": "openai",
       "retires": "2027-02-26",
       "qualifier": "exact",
-      "replacement": "gpt-transcribe",
+      "replacement": "gpt-live-transcribe",
       "kind": "audio"
     },
     {
@@ -1041,7 +1041,7 @@
       "provider": "openai",
       "retires": "2027-02-26",
       "qualifier": "exact",
-      "replacement": "gpt-transcribe",
+      "replacement": "gpt-live-transcribe",
       "kind": "audio"
     },
     {
@@ -1049,7 +1049,7 @@
       "provider": "openai",
       "retires": "2027-02-26",
       "qualifier": "exact",
-      "replacement": "gpt-transcribe",
+      "replacement": "gpt-live-transcribe",
       "kind": "audio"
     },
     {
@@ -1057,7 +1057,7 @@
       "provider": "openai",
       "retires": "2027-02-26",
       "qualifier": "exact",
-      "replacement": "gpt-transcribe",
+      "replacement": "gpt-live-transcribe",
       "kind": "audio"
     },
     {
@@ -1065,7 +1065,7 @@
       "provider": "openai",
       "retires": "2027-02-26",
       "qualifier": "exact",
-      "replacement": "gpt-transcribe",
+      "replacement": "gpt-live-transcribe",
       "kind": "audio"
     },
     {

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

@@ -79,12 +79,22 @@ const TOOLS = [
   },
 ];
 
+// 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 || ".");
@@ -94,7 +104,7 @@ export async function callTool(name, args = {}, { reg, source, today = new Date(
     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;