feat(tools): add test-migration tool

Author: hakalb

apps/cms/.env.local

@@ -81,3 +81,12 @@ ETHEREAL_PASSWORD=
 # This is required when serving the app after running migrations locally.
 # Otherwise we'll probably run into race condition sync issues.
 DISABLE_DB_PUSH=false
+
+
+# Uncomment to run production backup locally after testing latest migration
+# (start the container via: pnpm cdwr → test-migration, choose to keep it running)
+# DATABASE_URL=postgresql://postgres:postgres@localhost:5435/cms
+# DEPLOY_ENV=production
+# DISABLE_DB_PUSH=true
+# SEED_SOURCE=off
+# TENANT_ID=

tools/cdwr-cli.ts

@@ -6,6 +6,7 @@ import { backupCmsDatabase } from './db-tools/lib/backup-db.js';
 import { dropDatabase } from './db-tools/lib/drop-db.js';
 import { restoreCmsDatabase } from './db-tools/lib/restore-db.js';
 import { syncCmsStorage } from './db-tools/lib/sync-storage.js';
+import { testMigration } from './db-tools/lib/test-migration.js';
 import { showAppInfo } from './fly-tools/lib/app-info.js';
 import { patchFlyConfig } from './fly-tools/lib/patch-config.js';
 import { restartApp } from './fly-tools/lib/restart-app.js';
@@ -30,6 +31,11 @@ const tools: Tool[] = [
     description: 'Restore CMS database to Supabase',
     action: restoreCmsDatabase
   },
+  {
+    name: 'test-migration',
+    description: 'Test latest migration against a production backup in Docker',
+    action: testMigration
+  },
   {
     name: 'sync-storage',
     description: 'Sync CMS media storage from Supabase S3',