feat: add mark_worker_stopped function for graceful worker shutdown

[jumski]

Add mark_worker_stopped function for graceful worker shutdown

This PR adds a new SQL function pgflow.mark_worker_stopped(worker_id) that sets the stopped_at timestamp on a worker row to signal a graceful shutdown. This function will be called by workers during the beforeunload event.

The changes include:

• New SQL function definition in pkgs/core/schemas/0058_function_mark_worker_stopped.sql
• Migration file to add the function to the database
• TypeScript type definition for the function in database-types.ts
• Test case to verify the function correctly sets the stopped_at timestamp

This functionality enables workers to signal when they're shutting down, which will help with proper resource cleanup and task reassignment.

[changeset-bot]

⚠️ No Changeset found

Latest commit: 5813d23

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

[jumski]

• fix: clear worker_functions table in reset and enhance worker credential tests #521
• refactor: remove last_invoked_at from track_worker_function to fix debounce handling #520
• feat: add automatic worker restart via cron job and worker health tracking #517
• refactor: add handler spy utilities for queue worker tests #514
• feat: add worker tracking and graceful shutdown for edge functions #513
• feat: add setup_ensure_workers_cron function for worker management #512
• feat: add cleanup function for cron job run details #511
• feat: add ensure_workers function to automatically restart dead workers #510
• feat: add pg_cron, pg_net, pgsodium, and supabase_vault extensions to Atlas database #508
• feat: add mark_worker_stopped function for graceful worker shutdown #506 👈 (View in Graphite)
• feat: add track_worker_function for edge function monitoring #505
• feat: add worker_functions table and stopped_at column to workers #504
• refactor: auto-detect environment in ensure_flow_compiled instead of requiring mode parameter #503
• feat: add is_local() function to detect Supabase CLI environment #502
• refactor: improve Atlas migration management with better baseline handling #507
• main

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

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 5813d23

Command	Status	Duration	Result
nx run edge-worker:test:integration	✅ Succeeded	3m 44s	View ↗
nx affected -t verify-exports --base=origin/mai...	✅ Succeeded	3s	View ↗
nx affected -t build --configuration=production...	✅ Succeeded	22s	View ↗
nx affected -t lint typecheck test --parallel -...	✅ Succeeded	1m 38s	View ↗
nx run client:e2e	✅ Succeeded	1m 9s	View ↗
nx run cli:e2e	✅ Succeeded	3s	View ↗
nx run edge-worker:e2e	✅ Succeeded	44s	View ↗
nx run core:pgtap	✅ Succeeded	1s	View ↗

---

☁️ Nx Cloud last updated this comment at 2025-12-08 08:49:54 UTC

[github-actions]

🔍 Preview Deployment: Website

✅ Deployment successful!

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

📝 Details:

• Branch: 12-04-add_mark_worker_stopped_sql_function_for_graceful_shutdown_signaling
• Commit: 9ac7e12859edfcc347c19ed3102aceee4bf67481
• View Logs

_Last updated: _

[jumski]

Merge activity

• Dec 8, 8:07 AM UTC: A user started a stack merge that includes this pull request via Graphite.
• Dec 8, 8:43 AM UTC: Graphite rebased this pull request as part of a merge.
• Dec 8, 8:50 AM UTC: @jumski merged this pull request with Graphite.

[github-actions]

🚀 Production Deployment: Website

✅ Successfully deployed to production!

🔗 Production URL: https://pgflow.dev

📝 Details:

• Commit: b3885786a2acc6f4f0cd99cc9f6bb7e0e14d8a5e
• View Logs

Deployed at: 2025-12-08T09:50:32+01:00