Replace an obsolete rule and move its uses
What It Does
An administrator names a replacement for a deprecated rule and requests migration of following consumers and live references.
The Flow
Deprecate the definition and designate an active published replacement. Repoint compatible followers without duplicate replacement uses, republish live following references and retain their drafts; report pins and validation refusals. Discard plans and advance display generations for changed rules. Review remaining pins and archive only when active dependencies are gone.
When Something Fails
An invalid replacement or stale supplied version is refused. Definition standing remains unchanged on refusal. A referencing-rule validation refusal is reported locally; other errors roll back migration. Pins and refused references deliberately remain on the old definition. Optional cache errors receive no durable retry. Earlier display answers may survive for two minutes. Archive rejects surviving dependencies and reports their counts. The old definition remains deprecated.
Open Design Questions
The replacement must be active and published before migration begins.