[rt87]

The proposal's plan was to open an Ideas discussion in sqlalchemy/alembic asking whether this belongs
upstream, and — as a smaller fallback — whether the alembic.plugins entry point is meant to carry an
extension like this. I searched the project's discussions before posting anything. Both questions are
already answered in public, so the plan rested on a gap that is not there.

What is on the record

• #950 (2021) asks this exact question, with a
  link to Flyway's repeatable migrations. Answered the same day: "this is not a first class feature of
  Alembic", pointing at the replaceable-objects recipe and at alembic-utils as the third-party
  implementation. With #620 that is the same answer
  twice.
• #972, "Document how to do data migrations",
  is still open and carries an explicit, unfulfilled invitation to contribute documentation content. It
  is the one channel where this is asked for rather than unsolicited.
• #1872 (September 2026) states what the plugin
  entry point is for: "things that extend Alembic itself, typically though not necessarily in a dialect
  agnostic way." That is precisely this plugin, so the narrower question needed no asking. The same answer
  calls the plugin system "useless cruft in the codebase that nobody uses" — our ground is intended, but
  unloved and barely exercised.
• #1873 reported the iterate-the-entry-point
  behaviour as a bug; it was fixed in 1.20.1 within two days. Supporting 1.18–1.20 anyway is our own choice,
  not an open upstream question.

What changes here

docs/proposal.md gains a What the maintainers have already said section with those four sources, and the
conclusions follow from them: no fifth feature request; offer content to #972 instead, and only once there
is a real PyPI release, since a TestPyPI link gives readers nothing they can install.

Also fixed along the way:

• the status line still claimed a private repository, nothing published — it is public, and 0.1.0a1 is on
  TestPyPI;
• the prior-art table cited only the 2020 issue;
• the decision list ran 4, 5a, 5.

Docs only — no code, no tests touched.

🤖 Generated with Claude Code

https://claude.ai/code/session_017D7FmgZ7gdsg5dKbQWBiN7