chore: improve verify-schemas-synced and regenerate-temp-migration

[jumski]

TL;DR

Improved schema verification and temporary migration regeneration scripts with better error handling, isolation, and user feedback.

What changed?

• Enhanced atlas-verify-schemas-synced script to:

  • Use a temporary directory for migrations to avoid modifying the actual migrations directory
  • Add proper cleanup with trap handlers for temporary files and Docker containers
  • Display the first 50 lines of migration diff when schemas are out of sync
  • Improve error reporting with more context

• Updated regenerate-temp-migration script to:

  • Check if schemas are already in sync before attempting regeneration
  • Skip unnecessary work if schemas are already synchronized
  • Provide clearer user feedback about the state of schemas
  • Update the step numbering in the action plan to reflect the new initial check

How to test?

1. Run pnpm nx verify-schemas-synced core to test the schema verification
2. Make a change to a schema file without updating migrations
3. Run ./scripts/regenerate-temp-migration to see the improved workflow
4. Verify that temporary files are properly cleaned up after script execution
5. Check that the error output provides helpful context when schemas are out of sync

Why make this change?

These improvements make the schema verification and migration regeneration process more robust and developer-friendly by:

1. Preventing accidental modification of actual migration files during verification
2. Ensuring proper cleanup of resources even when scripts fail
3. Providing more helpful feedback when schemas are out of sync
4. Avoiding unnecessary work when schemas are already in sync
5. Making the error messages more informative for faster debugging

[changeset-bot]

⚠️ No Changeset found

Latest commit: a467f00

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches

🧪 Generate unit tests

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch 09-18-chore_improve_verify-schemas-synced_and_regenerate-temp-migration

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[jumski]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• fix: typecheck tests using strict tsc mode #231
• fix: remove temp migrations and prepare stack to be merged #230
• docs: improve documentation and READMEs to explain map/array steps #228
• test: add integration tests for flows with map steps #222
• feat: add task_index attribute to step_task_record and start_tasks function #221
• Fix Orphaned Messages on Run Failure #220
• chore: improve verify-schemas-synced and regenerate-temp-migration #219 👈 (View in Graphite)
• feat: Add .map() Method to Flow DSL for Map Step Support #218
• feat: add Map Step Output Aggregation #217
• feat: enhance start_tasks with conditional input logic and add array handling migration #216
• chore: make initial_tasks NULL by default to indicate 'unknown yet' #215
• feat: implement cascade completion of taskless steps #214
• # 🚀 Task Spawning for Map Steps #213
• feat: add root map step support #209
• feat: add map step type in sql #208
• feat: add map and array steps for parallel processing #207
• main

---

How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

• merge:queue - adds this PR to the back of the merge queue
• hotfix:queue - for urgent hot fixes, skip the queue and merge this PR next

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

[nx-cloud]

View your CI Pipeline Execution ↗ for commit a467f00

Command	Status	Duration	Result
nx run-many -t build --projects client,dsl --co...	✅ Succeeded	4s	View ↗
nx affected -t build --configuration=production...	✅ Succeeded	3s	View ↗
nx affected -t lint typecheck test --parallel -...	✅ Succeeded	5m 33s	View ↗

---

☁️ Nx Cloud last updated this comment at 2025-10-06 15:41:01 UTC

[github-actions]

🔍 Preview Deployment: Website

✅ Deployment successful!

🔗 Preview URL: https://pr-219.pgflow.pages.dev

📝 Details:

• Branch: 09-18-chore_improve_verify-schemas-synced_and_regenerate-temp-migration
• Commit: 71c973e1cea374ebd5985ace1865c6db504aa4e3
• View Logs

_Last updated: _

[github-actions]

🔍 Preview Deployment: Playground

✅ Deployment successful!

🔗 Preview URL: https://pr-219--pgflow-demo.netlify.app

📝 Details:

• Branch: 09-18-chore_improve_verify-schemas-synced_and_regenerate-temp-migration
• Commit: 71c973e1cea374ebd5985ace1865c6db504aa4e3
• View Logs

_Last updated: _