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

• 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 e05006e

Command	Status	Duration	Result
nx affected -t lint typecheck test --parallel -...	❌ Failed	26s	View ↗
nx run edge-worker:test:integration	✅ Succeeded	5m 58s	View ↗
nx run cli:e2e	✅ Succeeded	3s	View ↗
nx run client:e2e	✅ Succeeded	1m 15s	View ↗
nx run edge-worker:e2e	✅ Succeeded	30s	View ↗
nx run core:pgtap	✅ Succeeded	1s	View ↗
nx run edge-worker:smoke:bun	✅ Succeeded	3s	View ↗

💡 Dealing with memory or CPU issues? See memory and CPU details with the resource usage add-on ↗.

---

☁️ Nx Cloud last updated this comment at 2026-06-07 23:34:38 UTC

[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