docs: add Node and Bun process worker deployment guide

[jumski]

Adds documentation and navigation for deploying pgflow workers as long-running Node or Bun processes on hosts like Railway, Fly, Docker, or VMs.

The new guide covers installing the npm package, writing a worker script, required environment variables (DATABASE_URL, SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY), running the worker under Node or Bun, graceful shutdown behavior on SIGTERM/SIGINT/SIGQUIT, health monitoring via database queries, and how process workers differ from HTTP-started workers in that ensure_workers() does not restart them.

The deploy overview page and sidebar navigation are updated to include the new guide, the Supabase deployment page gains a callout pointing process-hosted deployments to the new guide, and the edge-worker README replaces its JSR-only warning with a note that the package is published to both JSR and npm with guidance on which to use for each runtime.

[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

• feat: add portable runtime e2e tests and worker replacement on deprecation #631
• docs: add Node and Bun process worker deployment guide #630 👈 (View in Graphite)
• ci: add edge-worker Bun smoke test job #629
• feat: publish @pgflow/edge-worker to npm with Node/Bun process runtime support #628
• feat: add ProcessPlatformAdapter for Node.js process environments #627
• feat: add start_mode to worker functions to skip HTTP pings for process workers #626
• main

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

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 34377ec

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

💡 Verify your cache is correct by running tasks in a sandbox. Read docs ↗

---

☁️ Nx Cloud last updated this comment at 2026-06-08 19:30:02 UTC

[changeset-bot]

⚠️ No Changeset found

Latest commit: 34377ec

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

[changeset-bot]

⚠️ No Changeset found

Latest commit: 475fe79

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

[github-actions]

🔍 Preview Deployment: Website

✅ Deployment successful!

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

📝 Details:

• Branch: portable-worker-docs
• Commit: 46e6d49b6100b56159680396189e0c4b99ac6774
• View Logs

_Last updated: _