CAR-1374 + CAR-1365: deploy-dev/uat checkout ref match base + alembic version_num widen — dev → uat

Co-authored-by: Savannah Savings <31+cs_savannah@noreply.git.farh.net>
Co-committed-by: Savannah Savings <31+cs_savannah@noreply.git.farh.net>

api/alembic/env.py

@@ -31,7 +31,6 @@ def run_migrations_offline() -> None:
         target_metadata=target_metadata,
         literal_binds=True,
         dialect_opts={"paramstyle": "named"},
-        version_table_column_width=128,
     )
     with context.begin_transaction():
         context.run_migrations()
@@ -45,7 +44,7 @@ def run_migrations_online() -> None:
         poolclass=pool.NullPool,
     )
     with connectable.connect() as connection:
-        context.configure(connection=connection, target_metadata=target_metadata, version_table_column_width=128)
+        context.configure(connection=connection, target_metadata=target_metadata)
         with context.begin_transaction():
             context.run_migrations()
         # Create any tables defined in models but not yet created by migrations.

api/alembic/versions/001_encrypt_session_data.py

@@ -33,6 +33,15 @@ def _is_fernet_token(value: str) -> bool:
 
 
 def upgrade() -> None:
+    # Alembic hardcodes alembic_version.version_num to VARCHAR(32)
+    # (DefaultImpl.version_table_impl) and exposes no option to widen it
+    # (version_table_column_width is NOT a real kwarg — it is silently ignored).
+    # Our descriptive revision ids exceed 32 chars (e.g.
+    # 003_make_users_hashed_password_nullable = 39), so widen the column as the
+    # very first migration statement, before any early-return path below.
+    # Idempotent: a no-op when already wider (e.g. pre-created by the CAR-1298 Job).
+    op.execute("ALTER TABLE alembic_version ALTER COLUMN version_num TYPE VARCHAR(128)")
+
     conn = op.get_bind()
     inspector = sa.inspect(conn)