code-realign

What problem does it solve?

It helps you safely rename or remap a domain model’s persisted enum/state vocabulary when the meaning changes, preventing corrupted data and inconsistent behavior across code and stored rows.

Core Features & Use Cases

• Scope verification: Distinguishes a realignment (meaning change + persisted data migration) from a refactor (behavior preserved) or cleanup (no requirement change).
• Explicit value mapping: Produces an old_value → new_value table with support for collapsed mappings, dropped values, and newly introduced states.
• Migration-first execution plan: Guides you through renaming at the type root, sweeping via type checking, hunting non-typed string leaks, and migrating persisted data using the project’s migration conventions.
• Safety guardrails: Enforces “never inline data migrations” and “never start editing before the mapping is agreed” to avoid hybrid vocabularies and untracked rewrites.

Quick Start

Ask the AI to realign your domain enum/state by mapping the old persisted values to the new business meanings, then updating types, sweeping string leaks, and creating a versioned migration to remap stored rows.