Retirement registry

Job: answer "is this model ID being retired, and when?"

Code: src/modelbump/registry/ · Data: src/modelbump/registry/data/*.yaml · Decision: ADR 0006

flowchart LR
    pages[Provider deprecation pages] -->|copied by hand, reviewed in a PR| yaml[data/*.yaml]
    yaml --> schema[pydantic schema<br/>validates every field]
    schema --> registry[Registry<br/>lookup by ID or alias]
    registry --> cli[modelbump check]
    registry --> scanner[Scanner, Phase 2]

Data format

provider: anthropic
source_url: https://platform.claude.com/docs/en/about-claude/model-deprecations
retrieved: 2026-10-08
models:
  - id: claude-3-haiku-20240307
    announced: 2026-02-19
    shutdown: 2026-04-20
    replacement: claude-haiku-4-5-20251001

Field	Required	Meaning
id	yes	Model ID exactly as used in API calls
aliases	no	Other IDs that point to the same model
announced	no	Day the deprecation was announced
shutdown	yes	Day API calls stop working
shutdown_is_earliest	no	true if the provider only promises "not before this day"
replacement	no	What the page recommends on the retrieved day
superseded	no	Earlier plans for this model that the provider changed (ADR 0007)
notes	no	Anything odd about this entry

Status rules

On a given day a model is retired from its shutdown day onwards, deprecated from its announcement day until then, and active before that.

Try it

uv run modelbump check claude-3-haiku-20240307

Scope

The registry covers models called through text-generation and embedding APIs, because those are the models ModelBump scans for and tests. Audio, realtime, image, video, moderation and fine-tuning-only entries are left out.

Coverage

Provider	Entries	Source	Quirks
Anthropic	20	Model deprecations	None
OpenAI	85	Deprecations	Aliases such as gpt-4; 4 models listed in two sections
Google	23	Gemini deprecations	No announcement dates; shutdown dates are "earliest possible"