model-eol 0.2.1

package/check.mjs

@@ -0,0 +1,263 @@
+#!/usr/bin/env node
+// model-eol reference CLI - zero dependencies.
+//
+// Default mode preserves the original CI gate:
+//   node check.mjs [paths...] [--days N] [--feeds DIR] [--via DISTRIBUTOR] [--scope all|direct] [--json] [--include-docs] [--allow-incomplete]
+//
+// New inventory modes:
+//   node check.mjs inventory [paths...] [--json|--format json|cyclonedx|text]
+//   node check.mjs schedule [paths...] [--days N] [--json]
+//   node check.mjs alert [paths...] [--format github|markdown|badge] [--json]
+//   node check.mjs plan [paths...] [--days N] [--scope all|direct] [--via DISTRIBUTOR] [--feeds DIR]
+//   node check.mjs apply --plan plan.json [--dry-run]
+//
+// exit codes: check/alert 0 = clear, 1 = finding, 2 = usage error;
+// apply 0 = all items applied, 1 = item refused, 2 = usage or plan error.
+
+import path from 'node:path'
+
+import { applyPlan } from './lib/apply.mjs'
+import { parseCliArgs } from './lib/cli.mjs'
+import { findingFromRef, isBad, loadFeeds } from './lib/feeds.mjs'
+import { buildPlan } from './lib/plan.mjs'
+import {
+  buildAlert,
+  buildInventory,
+  buildSchedule,
+  formatAlertGithub,
+  formatAlertBadge,
+  formatAlertMarkdown,
+  formatCheck,
+  formatInventory,
+  formatInventoryCycloneDX,
+  formatSchedule,
+} from './lib/reports.mjs'
+import { addedLinesForTargets, filterFindingsToChanged, incompleteScanNotes, scanTargets } from './lib/scanner.mjs'
+
+const COMMANDS = new Set(['check', 'inventory', 'schedule', 'alert', 'plan', 'apply', 'help'])
+const args = process.argv.slice(2)
+
+if (args[0] === '--help' || args[0] === '-h') args[0] = 'help'
+let command = COMMANDS.has(args[0]) ? args.shift() : 'check'
+let parsed
+try {
+  parsed = parseCliArgs({
+    args,
+    options: {
+      days: { type: 'string' },
+      feeds: { type: 'string' },
+      via: { type: 'string' },
+      scope: { type: 'string' },
+      format: { type: 'string' },
+      plan: { type: 'string' },
+      json: { type: 'boolean' },
+      'include-docs': { type: 'boolean' },
+      'allow-incomplete': { type: 'boolean' },
+      'dry-run': { type: 'boolean' },
+      changed: { type: 'string' },
+      help: { type: 'boolean', short: 'h' },
+    },
+    allowPositionals: true,
+    help: 'node check.mjs --help',
+  })
+} catch (error) {
+  console.error(error.message)
+  process.exit(2)
+}
+
+const { values, positionals } = parsed
+if (values.help) command = 'help'
+
+const DAYS = Number(values.days ?? '90')
+const FEEDS_DIR = values.feeds ?? path.join(import.meta.dirname, 'feeds')
+const VIA = values.via ?? null // e.g. azure-ai-foundry, aws-bedrock
+const SCOPE = values.scope ?? 'all'
+const FORMAT = values.format ?? null
+const PLAN_FILE = values.plan ?? null
+const AS_JSON = values.json ?? false
+const INCLUDE_DOCS = values['include-docs'] ?? false
+const ALLOW_INCOMPLETE = values['allow-incomplete'] ?? false
+const DRY_RUN = values['dry-run'] ?? false
+const CHANGED_BASE = values.changed ?? null
+const targets = positionals.length ? positionals : ['.']
+
+if (command === 'help') {
+  console.log(`model-eol
+
+Usage:
+  node check.mjs [paths...] [--days N] [--feeds DIR] [--via DISTRIBUTOR] [--scope all|direct] [--json] [--include-docs] [--allow-incomplete]
+  node check.mjs check [paths...] [--days N] [--scope all|direct] [--json] [--changed BASE_REF] [--allow-incomplete]
+  node check.mjs inventory [paths...] [--json] [--format json|cyclonedx|text]
+  node check.mjs schedule [paths...] [--days N] [--json]
+  node check.mjs alert [paths...] [--days N] [--scope all|direct] [--format github|markdown|badge] [--json]
+  node check.mjs plan [paths...] [--days N] [--scope all|direct] [--via DISTRIBUTOR] [--feeds DIR] [--allow-incomplete]
+  node check.mjs apply --plan plan.json [--dry-run]
+
+Commands:
+  check       Fail when tracked model IDs are retired or retiring within --days.
+              With --changed BASE_REF, answer the PR CI question: "this PR ADDS a
+              dependency on a model that already has a death date".
+  inventory   List tracked model references plus direct/cloud/gateway integration hints.
+              --format json is the machine-readable default; --format cyclonedx emits a CycloneDX 1.6 ML-BOM.
+  schedule    Show the retirement schedule for tracked references in the target.
+  alert       Emit GitHub Actions annotations, Markdown, or a Shields badge JSON and fail on errors.
+  plan        Emit a JSON migration plan with only safely patchable direct API references.
+  apply       Apply a plan with line-hash and occurrence checks; use --dry-run to preview.
+
+Scopes:
+  all        Check every tracked model ID found. This preserves the original behavior.
+  direct     Check direct API and generic model references; leave cloud/gateway refs in inventory.
+`)
+  process.exit(0)
+}
+
+if (command === 'apply') {
+  if (!PLAN_FILE || positionals.length) {
+    console.error('apply requires --plan plan.json and accepts no target paths')
+    process.exit(2)
+  }
+  try {
+    const result = applyPlan({ planPath: PLAN_FILE, dryRun: DRY_RUN, rootDir: process.cwd() })
+    process.exit(result.failed ? 1 : 0)
+  } catch (e) {
+    console.error(`failed to apply plan ${PLAN_FILE}: ${e.message}`)
+    process.exit(2)
+  }
+}
+
+if (!Number.isFinite(DAYS) || !Number.isInteger(DAYS) || DAYS < 0) {
+  console.error('--days must be a finite non-negative integer')
+  process.exit(2)
+}
+if (!['all', 'direct'].includes(SCOPE)) {
+  console.error('--scope must be all or direct')
+  process.exit(2)
+}
+if (CHANGED_BASE !== null && command !== 'check') {
+  console.error('--changed is only supported by the check command')
+  process.exit(2)
+}
+if (command === 'alert' && FORMAT !== null && !['github', 'markdown', 'badge', 'json'].includes(FORMAT)) {
+  console.error('--format must be github, markdown, badge, or json for alert')
+  process.exit(2)
+}
+if (command === 'inventory' && FORMAT !== null && !['json', 'cyclonedx', 'text'].includes(FORMAT)) {
+  console.error('--format must be json, cyclonedx, or text for inventory')
+  process.exit(2)
+}
+
+let feedData
+try {
+  feedData = loadFeeds(FEEDS_DIR)
+} catch (e) {
+  console.error(`failed to load feeds from ${FEEDS_DIR}: ${e.message}`)
+  process.exit(2)
+}
+if (feedData.entries.size === 0) {
+  console.error(`no feed entries loaded from ${FEEDS_DIR}`)
+  process.exit(2)
+}
+
+let scan
+try {
+  scan = scanTargets({
+    targets,
+    entries: feedData.entries,
+    keys: feedData.keys,
+    includeDocs: INCLUDE_DOCS,
+  })
+} catch (e) {
+  console.error(`scan failed: ${e.message}`)
+  process.exit(2)
+}
+
+const incompleteNotes = incompleteScanNotes(scan.notes)
+if (incompleteNotes.length && (command === 'check' || command === 'plan')) {
+  const label = ALLOW_INCOMPLETE ? 'warning: incomplete scan allowed' : 'INCOMPLETE SCAN'
+  console.error(`model-eol: ${label}; ${incompleteNotes.length} coverage-loss note(s) recorded`)
+  for (const note of incompleteNotes) {
+    const location = note.file ? ` (${note.file})` : ''
+    console.error(`  ${note.reason}${location}${note.message ? `: ${note.message}` : ''}`)
+  }
+  if (!ALLOW_INCOMPLETE) process.exit(2)
+}
+
+const findings = scan.modelRefs.map(ref => findingFromRef(ref, { days: DAYS, via: VIA }))
+const checkFindings = SCOPE === 'direct'
+  ? findings.filter(f => f.usage === 'direct-api' || f.usage === 'model-reference')
+  : findings
+const changedFindings = CHANGED_BASE === null
+  ? checkFindings
+  : (() => {
+      try {
+        return filterFindingsToChanged(checkFindings, addedLinesForTargets(targets, CHANGED_BASE))
+      } catch (e) {
+        console.error(`--changed failed: ${e.message}`)
+        process.exit(2)
+      }
+    })()
+const bad = changedFindings.filter(isBad)
+const inventory = () => buildInventory({ scan, findings, days: DAYS, via: VIA, scope: SCOPE, targets })
+const schedule = () => buildSchedule(inventory())
+const alert = () => buildAlert(schedule())
+
+if (command === 'plan') {
+  console.log(JSON.stringify(buildPlan({
+    scan,
+    findings,
+    entries: feedData.entries,
+    days: DAYS,
+    via: VIA,
+    scope: SCOPE,
+  }), null, 2))
+  process.exit(0)
+}
+
+if (command === 'check') {
+  if (AS_JSON) {
+    console.log(JSON.stringify({ threshold_days: DAYS, distributor: VIA, scope: SCOPE, scan_notes: scan.notes, findings: changedFindings }, null, 2))
+  } else {
+    console.log(formatCheck({ findings: changedFindings, bad, scannedFiles: scan.files.length, days: DAYS, scope: SCOPE }))
+  }
+  process.exit(bad.length ? 1 : 0)
+}
+
+if (command === 'inventory') {
+  const inv = inventory()
+  const inventoryFormat = FORMAT ?? 'json'
+  if (inventoryFormat === 'cyclonedx') {
+    console.log(JSON.stringify(formatInventoryCycloneDX(inv), null, 2))
+  } else if (AS_JSON || inventoryFormat === 'json') {
+    console.log(JSON.stringify(inv, null, 2))
+  } else {
+    console.log(formatInventory(inv, DAYS))
+  }
+  process.exit(0)
+}
+
+if (command === 'schedule') {
+  const sched = schedule()
+  if (AS_JSON) {
+    console.log(JSON.stringify(sched, null, 2))
+  } else {
+    console.log(formatSchedule(sched, DAYS))
+  }
+  process.exit(0)
+}
+
+if (command === 'alert') {
+  const payload = alert()
+  if (AS_JSON || FORMAT === 'json') {
+    console.log(JSON.stringify(payload, null, 2))
+  } else if (FORMAT === 'badge') {
+    console.log(JSON.stringify(formatAlertBadge(payload), null, 2))
+  } else if (FORMAT === 'markdown') {
+    console.log(formatAlertMarkdown(payload, DAYS))
+  } else {
+    console.log(formatAlertGithub(payload, DAYS))
+  }
+  process.exit(payload.errors.length ? 1 : 0)
+}
+
+console.error(`unknown command: ${command}`)
+process.exit(2)

package/feeds/amazon.json

@@ -0,0 +1,64 @@
+{
+  "spec": "model-eol/0.1",
+  "publisher": "amazon",
+  "generated": "2026-08-03T14:35:06.544Z",
+  "source": "https://docs.aws.amazon.com/bedrock/latest/userguide/model-lifecycle.html",
+  "models": [
+    {
+      "id": "nova-canvas",
+      "source": "https://docs.aws.amazon.com/bedrock/latest/userguide/model-lifecycle.html",
+      "announced": "2026-03-30",
+      "shutdown": "2026-09-30",
+      "distributions": [
+        {
+          "via": "aws-bedrock",
+          "announced": "2026-03-30",
+          "shutdown": "2026-09-30",
+          "source": "https://docs.aws.amazon.com/bedrock/latest/userguide/model-lifecycle.html"
+        }
+      ]
+    },
+    {
+      "id": "nova-reel",
+      "source": "https://docs.aws.amazon.com/bedrock/latest/userguide/model-lifecycle.html",
+      "announced": "2026-03-30",
+      "shutdown": "2026-09-30",
+      "distributions": [
+        {
+          "via": "aws-bedrock",
+          "announced": "2026-03-30",
+          "shutdown": "2026-09-30",
+          "source": "https://docs.aws.amazon.com/bedrock/latest/userguide/model-lifecycle.html"
+        }
+      ]
+    },
+    {
+      "id": "nova-premier",
+      "source": "https://docs.aws.amazon.com/bedrock/latest/userguide/model-lifecycle.html",
+      "announced": "2026-03-13",
+      "shutdown": "2026-09-14",
+      "distributions": [
+        {
+          "via": "aws-bedrock",
+          "announced": "2026-03-13",
+          "shutdown": "2026-09-14",
+          "source": "https://docs.aws.amazon.com/bedrock/latest/userguide/model-lifecycle.html"
+        }
+      ]
+    },
+    {
+      "id": "nova-sonic",
+      "source": "https://docs.aws.amazon.com/bedrock/latest/userguide/model-lifecycle.html",
+      "announced": "2026-03-13",
+      "shutdown": "2026-09-14",
+      "distributions": [
+        {
+          "via": "aws-bedrock",
+          "announced": "2026-03-13",
+          "shutdown": "2026-09-14",
+          "source": "https://docs.aws.amazon.com/bedrock/latest/userguide/model-lifecycle.html"
+        }
+      ]
+    }
+  ]
+}

package/feeds/anthropic.json

@@ -0,0 +1,252 @@
+{
+  "spec": "model-eol/0.1",
+  "publisher": "anthropic",
+  "generated": "2026-08-03T14:35:06.963Z",
+  "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
+  "policy": {
+    "min_notice_days": 60,
+    "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations"
+  },
+  "note": "Community-maintained seed dataset, compiled 2026-07-25 from the provider's deprecations page. Verify against the source before acting; this file demonstrates the format. Anthropic policy floor: >=60 days notice for publicly released models. Weights of public models are preserved per the Nov 2025 commitments - preservation is not availability.",
+  "models": [
+    {
+      "id": "claude-3-7-sonnet-20250219",
+      "aliases": [
+        "claude-3-7-sonnet"
+      ],
+      "distributions": [
+        {
+          "via": "aws-bedrock",
+          "announced": "2026-01-30",
+          "shutdown": "2026-07-30",
+          "source": "https://docs.aws.amazon.com/bedrock/latest/userguide/model-lifecycle.html"
+        }
+      ],
+      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
+      "announced": "2025-10-28",
+      "shutdown": "2026-02-19",
+      "replacement": "claude-sonnet-4-6"
+    },
+    {
+      "id": "claude-3-5-haiku-20241022",
+      "aliases": [
+        "claude-3-5-haiku"
+      ],
+      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
+      "announced": "2025-12-19",
+      "shutdown": "2026-02-19",
+      "replacement": "claude-haiku-4-5-20251001"
+    },
+    {
+      "id": "claude-3-haiku-20240307",
+      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
+      "distributions": [
+        {
+          "via": "aws-bedrock",
+          "announced": "2026-03-10",
+          "shutdown": "2026-09-10",
+          "source": "https://docs.aws.amazon.com/bedrock/latest/userguide/model-lifecycle.html"
+        }
+      ],
+      "announced": "2026-02-19",
+      "shutdown": "2026-04-20",
+      "replacement": "claude-haiku-4-5-20251001"
+    },
+    {
+      "id": "claude-3-opus-20240229",
+      "aliases": [
+        "claude-opus-3"
+      ],
+      "notes": "Subject of Anthropic's deprecation-commitments follow-up post.",
+      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
+      "announced": "2025-06-30",
+      "shutdown": "2026-01-05",
+      "replacement": "claude-opus-4-8"
+    },
+    {
+      "id": "claude-sonnet-4-20250514",
+      "aliases": [
+        "claude-sonnet-4"
+      ],
+      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
+      "distributions": [
+        {
+          "via": "aws-bedrock",
+          "announced": "2026-04-14",
+          "shutdown": "2026-10-14",
+          "source": "https://docs.aws.amazon.com/bedrock/latest/userguide/model-lifecycle.html"
+        }
+      ],
+      "announced": "2026-04-14",
+      "shutdown": "2026-06-15",
+      "replacement": "claude-sonnet-4-6"
+    },
+    {
+      "id": "claude-opus-4-20250514",
+      "aliases": [
+        "claude-opus-4"
+      ],
+      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
+      "announced": "2026-04-14",
+      "shutdown": "2026-06-15",
+      "replacement": "claude-opus-4-8"
+    },
+    {
+      "id": "claude-opus-4-1-20250805",
+      "aliases": [
+        "claude-opus-4-1"
+      ],
+      "notes": "Upcoming at dataset compile time - eleven days out. This is the entry a CI check should be failing on today.",
+      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
+      "distributions": [
+        {
+          "via": "aws-bedrock",
+          "announced": "2026-07-08",
+          "shutdown": "2027-01-08",
+          "source": "https://docs.aws.amazon.com/bedrock/latest/userguide/model-lifecycle.html"
+        }
+      ],
+      "announced": "2026-06-05",
+      "shutdown": "2026-08-05",
+      "replacement": "claude-opus-4-8"
+    },
+    {
+      "id": "claude-3-5-sonnet-20240620",
+      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
+      "distributions": [
+        {
+          "via": "aws-bedrock",
+          "announced": "2026-01-30",
+          "shutdown": "2026-07-30",
+          "source": "https://docs.aws.amazon.com/bedrock/latest/userguide/model-lifecycle.html"
+        }
+      ],
+      "announced": "2025-08-13",
+      "shutdown": "2025-10-28",
+      "replacement": "claude-sonnet-4-6"
+    },
+    {
+      "id": "claude-3-5-sonnet-20241022",
+      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
+      "distributions": [
+        {
+          "via": "aws-bedrock",
+          "announced": "2026-01-30",
+          "shutdown": "2026-07-30",
+          "source": "https://docs.aws.amazon.com/bedrock/latest/userguide/model-lifecycle.html"
+        }
+      ],
+      "announced": "2025-08-13",
+      "shutdown": "2025-10-28",
+      "replacement": "claude-sonnet-4-6"
+    },
+    {
+      "id": "claude-2.0",
+      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
+      "announced": "2025-01-21",
+      "shutdown": "2025-07-21",
+      "replacement": "claude-opus-4-8"
+    },
+    {
+      "id": "claude-2.1",
+      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
+      "announced": "2025-01-21",
+      "shutdown": "2025-07-21",
+      "replacement": "claude-opus-4-8"
+    },
+    {
+      "id": "claude-3-sonnet-20240229",
+      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
+      "distributions": [
+        {
+          "via": "aws-bedrock",
+          "announced": "2026-01-30",
+          "shutdown": "2026-07-30",
+          "source": "https://docs.aws.amazon.com/bedrock/latest/userguide/model-lifecycle.html"
+        }
+      ],
+      "announced": "2025-01-21",
+      "shutdown": "2025-07-21",
+      "replacement": "claude-sonnet-4-6"
+    },
+    {
+      "id": "claude-1.0",
+      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
+      "announced": "2024-09-04",
+      "shutdown": "2024-11-06",
+      "replacement": "claude-haiku-4-5-20251001"
+    },
+    {
+      "id": "claude-1.1",
+      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
+      "announced": "2024-09-04",
+      "shutdown": "2024-11-06",
+      "replacement": "claude-haiku-4-5-20251001"
+    },
+    {
+      "id": "claude-1.2",
+      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
+      "announced": "2024-09-04",
+      "shutdown": "2024-11-06",
+      "replacement": "claude-haiku-4-5-20251001"
+    },
+    {
+      "id": "claude-1.3",
+      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
+      "announced": "2024-09-04",
+      "shutdown": "2024-11-06",
+      "replacement": "claude-haiku-4-5-20251001"
+    },
+    {
+      "id": "claude-instant-1.0",
+      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
+      "announced": "2024-09-04",
+      "shutdown": "2024-11-06",
+      "replacement": "claude-haiku-4-5-20251001"
+    },
+    {
+      "id": "claude-instant-1.1",
+      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
+      "announced": "2024-09-04",
+      "shutdown": "2024-11-06",
+      "replacement": "claude-haiku-4-5-20251001"
+    },
+    {
+      "id": "claude-instant-1.2",
+      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
+      "announced": "2024-09-04",
+      "shutdown": "2024-11-06",
+      "replacement": "claude-haiku-4-5-20251001"
+    },
+    {
+      "id": "claude-opus-5"
+    },
+    {
+      "id": "claude-sonnet-5"
+    },
+    {
+      "id": "claude-fable-5"
+    },
+    {
+      "id": "claude-opus-4-8"
+    },
+    {
+      "id": "claude-opus-4-7"
+    },
+    {
+      "id": "claude-sonnet-4-6"
+    },
+    {
+      "id": "claude-opus-4-6"
+    },
+    {
+      "id": "claude-opus-4-5-20251101"
+    },
+    {
+      "id": "claude-haiku-4-5-20251001"
+    },
+    {
+      "id": "claude-sonnet-4-5-20250929"
+    }
+  ]
+}