model-eol 0.2.4 → 0.4.0

package/bot.yml.example

@@ -0,0 +1,145 @@
+name: model-eol bot
+
+on:
+  schedule:
+    - cron: '17 4 * * 1'
+  workflow_dispatch:
+
+concurrency:
+  group: model-eol-bot
+  cancel-in-progress: false
+
+env:
+  # Major-line pin: receives compatible fixes and refreshed bundled feeds.
+  MODEL_EOL_PACKAGE: model-eol@0
+
+jobs:
+  plan:
+    name: build trusted plan
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - name: Build the versioned plan
+        run: |
+          mkdir -p "$RUNNER_TEMP/model-eol-plan"
+          MODEL_EOL_VERSION="$(npm view "$MODEL_EOL_PACKAGE" version --json | node -e 'let s="";process.stdin.on("data",c=>s+=c).on("end",()=>{const v=JSON.parse(s);const r=Array.isArray(v)?v.at(-1):v;if(typeof r!=="string")process.exit(1);process.stdout.write(r)})')"
+          if [[ ! "$MODEL_EOL_VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "refusing invalid resolved model-eol version: $MODEL_EOL_VERSION" >&2
+            exit 1
+          fi
+          printf '%s\n' "$MODEL_EOL_VERSION" > "$RUNNER_TEMP/model-eol-plan/model-eol-version"
+          PLAN_ARGS=(plan .)
+          if [ ! -f .model-eol.json ]; then PLAN_ARGS+=(--days 90 --scope direct); fi
+          npx --yes --package="model-eol@$MODEL_EOL_VERSION" model-eol "${PLAN_ARGS[@]}" > "$RUNNER_TEMP/model-eol-plan/model-eol-plan.json"
+      - name: Upload plan
+        uses: actions/upload-artifact@v4
+        with:
+          name: model-eol-plan
+          path: |
+            ${{ runner.temp }}/model-eol-plan/model-eol-plan.json
+            ${{ runner.temp }}/model-eol-plan/model-eol-version
+          if-no-files-found: error
+
+  evaluate:
+    name: evaluate isolated migrations
+    needs: plan
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      # Provider credentials exist only in this read-only job. The evaluator
+      # forwards only names explicitly allowed by eval.pass_env.
+      - uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - name: Download trusted plan
+        uses: actions/download-artifact@v4
+        with:
+          name: model-eol-plan
+          path: ${{ runner.temp }}/model-eol-plan
+      - name: Apply and evaluate each migration independently
+        env:
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+          GOOGLE_API_KEY: ${{ secrets.GOOGLE_API_KEY }}
+          GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
+          # A non-empty repository variable overrides eval.command. Otherwise
+          # the strictly validated command in .model-eol.json is used.
+          MODEL_EOL_EVAL_COMMAND: ${{ vars.MODEL_EOL_EVAL_COMMAND }}
+        run: |
+          mkdir -p "$RUNNER_TEMP/model-eol-eval"
+          MODEL_EOL_VERSION="$(cat "$RUNNER_TEMP/model-eol-plan/model-eol-version")"
+          if [[ ! "$MODEL_EOL_VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "refusing invalid resolved model-eol version: $MODEL_EOL_VERSION" >&2
+            exit 1
+          fi
+          npx --yes --package="model-eol@$MODEL_EOL_VERSION" model-eol-bot evaluate \
+            --target-dir . \
+            --plan-file "$RUNNER_TEMP/model-eol-plan/model-eol-plan.json" \
+            --output-file "$RUNNER_TEMP/model-eol-eval/model-eol-eval-results.json"
+      - name: Upload bounded eval results
+        uses: actions/upload-artifact@v4
+        with:
+          name: model-eol-eval-results
+          path: ${{ runner.temp }}/model-eol-eval/model-eol-eval-results.json
+          if-no-files-found: error
+
+  publish:
+    name: reconcile migration work
+    needs: [plan, evaluate]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+      issues: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          # model-eol-bot authenticates its own temporary HTTPS clones and
+          # pushes with GITHUB_TOKEN; no checkout credential is persisted.
+          persist-credentials: false
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - name: Download trusted plan
+        uses: actions/download-artifact@v4
+        with:
+          name: model-eol-plan
+          path: ${{ runner.temp }}/model-eol-plan
+      - name: Download eval results
+        uses: actions/download-artifact@v4
+        with:
+          name: model-eol-eval-results
+          path: ${{ runner.temp }}/model-eol-eval
+      - name: Publish and reconcile model-eol work
+        env:
+          GITHUB_TOKEN: ${{ secrets.MODEL_EOL_BOT_TOKEN || secrets.GITHUB_TOKEN }}
+          MODEL_EOL_PLAN_FILE: ${{ runner.temp }}/model-eol-plan/model-eol-plan.json
+          MODEL_EOL_EVAL_RESULTS_FILE: ${{ runner.temp }}/model-eol-eval/model-eol-eval-results.json
+          # The write job receives the non-secret command text only so it can
+          # verify the eval configuration digest. It receives no provider keys.
+          MODEL_EOL_EVAL_COMMAND: ${{ vars.MODEL_EOL_EVAL_COMMAND }}
+          MODEL_EOL_TOKEN_KIND: ${{ secrets.MODEL_EOL_BOT_TOKEN && 'external-token' || 'github-token' }}
+        run: |
+          MODEL_EOL_VERSION="$(cat "$RUNNER_TEMP/model-eol-plan/model-eol-version")"
+          if [[ ! "$MODEL_EOL_VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "refusing invalid resolved model-eol version: $MODEL_EOL_VERSION" >&2
+            exit 1
+          fi
+          npx --yes --package="model-eol@$MODEL_EOL_VERSION" model-eol-bot --repo "${{ github.repository }}" --target-dir .
+
+# A PR made with GITHUB_TOKEN does not trigger pull_request workflows. For
+# required checks, store a narrowly scoped fine-grained PAT or GitHub App token
+# as MODEL_EOL_BOT_TOKEN. Keep provider keys out of the publish job.
+# Set feeds.allow_vendored_fallback: true only for degraded report-only runs.
+# Independent concurrent invocations need external mutual exclusion.

package/check.mjs

@@ -2,7 +2,7 @@
 // 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]
+//   node check.mjs [paths...] [--config FILE] [--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]
@@ -14,11 +14,23 @@
 // 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 fs from 'node:fs'
 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 {
+  CLI_DEFAULT_CONFIG,
+  DEFAULT_CONFIG,
+  configForRepoPath,
+  configuredVias,
+  loadConfig,
+  mappedRoutesForRepoPath,
+  normalizeConfig,
+  routeForRepoReference,
+} from './lib/config.mjs'
+import { BUILTIN_CHANNELS, findingFromRef, isBad, loadFeeds } from './lib/feeds.mjs'
+import { normalizeRepoPath } from './lib/glob.mjs'
 import { buildPlan } from './lib/plan.mjs'
 import {
   buildAlert,
@@ -32,7 +44,53 @@ import {
   formatInventoryCycloneDX,
   formatSchedule,
 } from './lib/reports.mjs'
-import { addedLinesForTargets, filterFindingsToChanged, incompleteScanNotes, scanTargets } from './lib/scanner.mjs'
+import { addedLinesForTargets, filterFindingsToChanged, gitRootFor, incompleteScanNotes, scanTargets } from './lib/scanner.mjs'
+
+const rootForTarget = target => {
+  const absolute = path.resolve(target)
+  let stat
+  try {
+    stat = fs.lstatSync(absolute)
+  } catch {
+    return null
+  }
+  let resolved = absolute
+  try {
+    resolved = fs.realpathSync(absolute)
+  } catch {
+  }
+  try {
+    const gitRoot = gitRootFor(resolved)
+    if (gitRoot) return gitRoot
+  } catch {
+  }
+  return stat.isDirectory() ? resolved : path.dirname(resolved)
+}
+
+const configForTargets = ({ targets, explicit }) => {
+  const roots = [...new Set(targets.map(rootForTarget).filter(Boolean))]
+  if (explicit !== null) {
+    if (!explicit) throw new Error('--config must be a non-empty path')
+    return { file: path.resolve(explicit), roots }
+  }
+
+  const files = [...new Set(roots
+    .map(root => path.join(root, '.model-eol.json'))
+    .filter(file => fs.existsSync(file)))]
+  if (files.length > 1) {
+    throw new Error(`multiple .model-eol.json files found (${files.join(', ')}); use --config FILE to choose one`)
+  }
+  return { file: files[0] ?? null, roots }
+}
+
+const repoPathForFile = (file, roots) => {
+  const absolute = path.resolve(file)
+  const candidates = roots
+    .map(root => ({ root, relative: path.relative(root, absolute) }))
+    .filter(({ relative }) => relative !== '..' && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative))
+    .sort((a, b) => b.root.length - a.root.length)
+  return normalizeRepoPath(candidates[0]?.relative ?? absolute)
+}
 
 const main = () => {
 const COMMANDS = new Set(['check', 'inventory', 'schedule', 'alert', 'plan', 'apply', 'help'])
@@ -46,6 +104,7 @@ try {
     args,
     options: {
       days: { type: 'string' },
+      config: { type: 'string' },
       feeds: { type: 'string' },
       via: { type: 'string' },
       scope: { type: 'string' },
@@ -69,10 +128,6 @@ try {
 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
@@ -86,12 +141,12 @@ 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 [paths...] [--config FILE] [--days N] [--feeds DIR] [--via DISTRIBUTOR] [--scope all|direct] [--json] [--include-docs] [--allow-incomplete]
+  node check.mjs check [paths...] [--config FILE] [--days N] [--scope all|direct] [--json] [--changed BASE_REF] [--allow-incomplete]
+  node check.mjs inventory [paths...] [--config FILE] [--json] [--format json|cyclonedx|text]
+  node check.mjs schedule [paths...] [--config FILE] [--days N] [--json]
+  node check.mjs alert [paths...] [--config FILE] [--days N] [--scope all|direct] [--format github|markdown|badge] [--json]
+  node check.mjs plan [paths...] [--config FILE] [--days N] [--scope all|direct] [--via DISTRIBUTOR] [--feeds DIR] [--allow-incomplete]
   node check.mjs apply --plan plan.json [--dry-run]
 
 Commands:
@@ -109,6 +164,10 @@ 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.
 
+Configuration:
+  .model-eol.json is loaded automatically from the target repository root.
+  --config FILE selects an explicit config. Explicit CLI flags override config values.
+
 Exit codes:
   0  Clean, or report generated successfully.
   1  Findings, alert errors, or refused apply items.
@@ -132,6 +191,23 @@ if (command === 'apply') {
   }
 }
 
+let configLocation
+let repositoryConfig
+try {
+  configLocation = configForTargets({ targets, explicit: values.config ?? null })
+  repositoryConfig = configLocation.file
+    ? loadConfig(configLocation.file, { defaults: DEFAULT_CONFIG, allowMissing: false })
+    : normalizeConfig({}, { defaults: CLI_DEFAULT_CONFIG })
+} catch (e) {
+  console.error(`failed to load repository config: ${e.message}`)
+  return 2
+}
+
+const DAYS = Number(values.days ?? repositoryConfig.days)
+const FEEDS_DIR = values.feeds ?? path.join(import.meta.dirname, 'feeds')
+const VIA = values.via ?? repositoryConfig.via // e.g. azure-ai-foundry, aws-bedrock
+const SCOPE = values.scope ?? repositoryConfig.scope
+
 if (!Number.isFinite(DAYS) || !Number.isInteger(DAYS) || DAYS < 0) {
   console.error('--days must be a finite non-negative integer')
   return 2
@@ -165,6 +241,37 @@ if (feedData.entries.size === 0) {
   return 2
 }
 
+const allowedVias = new Set([...BUILTIN_CHANNELS, ...feedData.vias])
+const unknownVia = [values.via, ...configuredVias(repositoryConfig)]
+  .find(via => via && !allowedVias.has(via))
+if (unknownVia) {
+  console.error(`unknown lifecycle channel "${unknownVia}"; known values: ${[...allowedVias].sort().join(', ')}`)
+  return 2
+}
+const unresolvedRoute = repositoryConfig.routes.find(route => route.model && !feedData.entries.has(route.model))
+if (unresolvedRoute) {
+  console.error(`configured route model "${unresolvedRoute.model}" is not present in loaded feeds`)
+  return 2
+}
+
+const policyCache = new Map()
+const policyForFile = file => {
+  const absolute = path.resolve(file)
+  if (!policyCache.has(absolute)) {
+    const repoPath = repoPathForFile(absolute, configLocation.roots)
+    policyCache.set(absolute, { ...configForRepoPath(repositoryConfig, repoPath), repoPath })
+  }
+  return policyCache.get(absolute)
+}
+const routeForReference = ({ file, matched, id }) => {
+  const policy = policyForFile(file)
+  return routeForRepoReference(repositoryConfig, policy.repoPath, { matched, id })
+}
+const mappedRoutesForFile = file => {
+  const policy = policyForFile(file)
+  return mappedRoutesForRepoPath(repositoryConfig, policy.repoPath)
+}
+
 let scan
 try {
   scan = scanTargets({
@@ -172,6 +279,11 @@ try {
     entries: feedData.entries,
     keys: feedData.keys,
     includeDocs: INCLUDE_DOCS,
+    ignoreRoots: configLocation.roots,
+    ignoredFiles: configLocation.file ? [configLocation.file] : [],
+    policyForFile,
+    routeForReference,
+    mappedRoutesForFile,
   })
 } catch (e) {
   console.error(`scan failed: ${e.message}`)
@@ -189,10 +301,32 @@ if (incompleteNotes.length && (command === 'check' || command === 'plan')) {
   if (!ALLOW_INCOMPLETE) return 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 findings = scan.modelRefs.map(ref => {
+  const policy = policyForFile(ref.file)
+  const route = routeForReference({ file: ref.file, matched: ref.matched, id: ref.id })
+  const days = values.days === undefined ? policy.days : DAYS
+  const scope = values.scope === undefined ? policy.scope : SCOPE
+  const via = values.via === undefined ? (route?.via ?? policy.via) : VIA
+  const finding = findingFromRef(ref, { days, via })
+  finding.effective_scope = scope
+  finding.requested_via = via
+  if (policy.override_indexes.length || route) {
+    finding.policy_provenance = {
+      override_indexes: policy.override_indexes,
+      route_index: route?.index ?? null,
+    }
+  }
+  return finding
+})
+for (const candidate of scan.candidateRefs) {
+  const policy = policyForFile(candidate.file)
+  candidate.effective_scope = values.scope === undefined ? policy.scope : SCOPE
+  if (policy.override_indexes.length) {
+    candidate.policy_provenance = { override_indexes: policy.override_indexes, route_index: null }
+  }
+}
+const checkFindings = findings.filter(finding =>
+  finding.effective_scope !== 'direct' || finding.usage === 'direct-api' || finding.usage === 'model-reference')
 let changedFindings = checkFindings
 if (CHANGED_BASE !== null) {
   try {

package/feeds/amazon.json

@@ -1,7 +1,7 @@
 {
   "spec": "model-eol/0.1",
   "publisher": "amazon",
-  "generated": "2026-08-03T21:43:59.800Z",
+  "generated": "2026-08-18T00:47:44.931Z",
   "source": "https://docs.aws.amazon.com/bedrock/latest/userguide/model-lifecycle.html",
   "models": [
     {

package/feeds/anthropic.json

@@ -1,7 +1,7 @@
 {
   "spec": "model-eol/0.1",
   "publisher": "anthropic",
-  "generated": "2026-08-03T21:43:59.800Z",
+  "generated": "2026-08-18T00:47:44.931Z",
   "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
   "policy": {
     "min_notice_days": 60,

package/feeds/google.json

@@ -1,7 +1,7 @@
 {
   "spec": "model-eol/0.1",
   "publisher": "google",
-  "generated": "2026-08-03T21:43:59.800Z",
+  "generated": "2026-08-18T00:47:44.931Z",
   "source": "https://ai.google.dev/gemini-api/docs/deprecations",
   "models": [
     {
@@ -318,7 +318,13 @@
     },
     {
       "id": "gemini-embedding-2",
-      "source": "https://ai.google.dev/gemini-api/docs/deprecations"
+      "source": "https://ai.google.dev/gemini-api/docs/deprecations",
+      "distributions": [
+        {
+          "via": "vertex-ai",
+          "source": "https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions"
+        }
+      ]
     },
     {
       "id": "gemini-embedding-001",
@@ -518,9 +524,7 @@
       "source": "https://ai.google.dev/gemini-api/docs/deprecations",
       "shutdown": "2026-08-31",
       "date_precision": "earliest",
-      "replacement_options": [
-        "gemini-robotics-er-2-preview"
-      ]
+      "replacement": "gemini-robotics-er-2-preview"
     },
     {
       "id": "gemini-robotics-er-1.5-preview",
@@ -528,6 +532,85 @@
       "shutdown": "2026-04-30",
       "date_precision": "earliest",
       "replacement": "gemini-robotics-er-1.6-preview"
+    },
+    {
+      "id": "gemini-3.7-flash",
+      "source": "https://ai.google.dev/gemini-api/docs/deprecations",
+      "distributions": [
+        {
+          "via": "vertex-ai",
+          "source": "https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions"
+        }
+      ]
+    },
+    {
+      "id": "gemma-4-26b-a4b-it"
+    },
+    {
+      "id": "gemma-4-31b-it"
+    },
+    {
+      "id": "gemini-flash-latest"
+    },
+    {
+      "id": "gemini-flash-lite-latest"
+    },
+    {
+      "id": "gemini-pro-latest"
+    },
+    {
+      "id": "gemini-3.1-pro-preview-customtools"
+    },
+    {
+      "id": "nano-banana-pro-preview"
+    },
+    {
+      "id": "gemini-3.1-flash-lite-image",
+      "distributions": [
+        {
+          "via": "vertex-ai",
+          "source": "https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions"
+        }
+      ]
+    },
+    {
+      "id": "gemini-omni-flash-preview"
+    },
+    {
+      "id": "gemini-robotics-er-2-preview"
+    },
+    {
+      "id": "gemini-2.5-computer-use-preview-10-2025"
+    },
+    {
+      "id": "antigravity-preview-05-2026"
+    },
+    {
+      "id": "deep-research-max-preview-04-2026"
+    },
+    {
+      "id": "deep-research-preview-04-2026"
+    },
+    {
+      "id": "deep-research-pro-preview-12-2025"
+    },
+    {
+      "id": "gemini-embedding-2-preview"
+    },
+    {
+      "id": "aqa"
+    },
+    {
+      "id": "gemini-2.5-flash-native-audio-latest"
+    },
+    {
+      "id": "gemini-2.5-flash-native-audio-preview-09-2025"
+    },
+    {
+      "id": "gemini-robotics-er-2-streaming-preview"
+    },
+    {
+      "id": "gemini-3.5-live-translate-preview"
     }
   ]
 }

package/feeds/openai.json

@@ -1,7 +1,7 @@
 {
   "spec": "model-eol/0.1",
   "publisher": "openai",
-  "generated": "2026-08-03T21:43:59.800Z",
+  "generated": "2026-08-18T00:47:44.930Z",
   "source": "https://developers.openai.com/api/docs/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.",
   "models": [
@@ -308,35 +308,35 @@
       "source": "https://developers.openai.com/api/docs/deprecations",
       "announced": "2026-04-22",
       "shutdown": "2026-10-23",
-      "replacement": "gpt-5.4-mini"
+      "replacement": "gpt-5.6-terra"
     },
     {
       "id": "ft-gpt-4",
       "source": "https://developers.openai.com/api/docs/deprecations",
       "announced": "2026-04-22",
       "shutdown": "2026-10-23",
-      "replacement": "gpt-5.5"
+      "replacement": "gpt-5.6-sol"
     },
     {
       "id": "ft-gpt-4.1-nano-2025-04-14",
       "source": "https://developers.openai.com/api/docs/deprecations",
       "announced": "2026-04-22",
       "shutdown": "2026-10-23",
-      "replacement": "gpt-5.4-nano"
+      "replacement": "gpt-5.6-luna"
     },
     {
       "id": "ft-babbage-002",
       "source": "https://developers.openai.com/api/docs/deprecations",
       "announced": "2026-04-22",
       "shutdown": "2026-10-23",
-      "replacement": "gpt-5.4-mini"
+      "replacement": "gpt-5.6-terra"
     },
     {
       "id": "ft-davinci-002",
       "source": "https://developers.openai.com/api/docs/deprecations",
       "announced": "2026-04-22",
       "shutdown": "2026-10-23",
-      "replacement": "gpt-5.4-mini"
+      "replacement": "gpt-5.6-terra"
     },
     {
       "id": "sora-2",
@@ -373,40 +373,28 @@
       "source": "https://developers.openai.com/api/docs/deprecations",
       "announced": "2025-09-26",
       "shutdown": "2026-09-28",
-      "replacement_options": [
-        "gpt-5.4-mini",
-        "gpt-5-mini"
-      ]
+      "replacement": "gpt-5.6-terra"
     },
     {
       "id": "babbage-002",
       "source": "https://developers.openai.com/api/docs/deprecations",
       "announced": "2025-09-26",
       "shutdown": "2026-09-28",
-      "replacement_options": [
-        "gpt-5.4-mini",
-        "gpt-5-mini"
-      ]
+      "replacement": "gpt-5.6-terra"
     },
     {
       "id": "davinci-002",
       "source": "https://developers.openai.com/api/docs/deprecations",
       "announced": "2025-09-26",
       "shutdown": "2026-09-28",
-      "replacement_options": [
-        "gpt-5.4-mini",
-        "gpt-5-mini"
-      ]
+      "replacement": "gpt-5.6-terra"
     },
     {
       "id": "gpt-3.5-turbo-1106",
       "source": "https://developers.openai.com/api/docs/deprecations",
       "announced": "2025-09-26",
       "shutdown": "2026-09-28",
-      "replacement_options": [
-        "gpt-5.4-mini",
-        "gpt-5-mini"
-      ]
+      "replacement": "gpt-5.6-terra"
     },
     {
       "id": "computer-use-preview-2025-03-11",
@@ -427,10 +415,7 @@
     },
     {
       "id": "gpt-4o-mini-tts-2025-03-20",
-      "source": "https://developers.openai.com/api/docs/deprecations",
-      "announced": "2026-04-22",
-      "shutdown": "2026-07-23",
-      "replacement": "gpt-4o-mini-tts-2025-12-15"
+      "source": "https://developers.openai.com/api/docs/deprecations"
     },
     {
       "id": "gpt-4o-search-preview-2025-03-11",