feat: add auto-compilation and worker management with improved documentation

[jumski]

Reorganize Documentation for Worker Management and Auto-Compilation

This PR reorganizes the documentation to introduce two major features:

1. Auto-Compilation - Workers now automatically verify and compile flows at startup
2. Worker Management - Built-in cron system that keeps workers running reliably

Key changes:

• Added new /deploy/worker-management/ page replacing the old "Keep Workers Up" guide
• Added new /concepts/worker-lifecycle/ page explaining how workers poll and restart
• Added new /build/local-development/ page with tips for better dev experience
• Updated navigation to organize content under "Workers" and "Runs" sections
• Simplified deployment guides to leverage the new automatic worker management
• Added release notes for pgflow 0.10.0 highlighting these features
• Updated quickstart to remove manual compilation steps (now automatic)

The PR also updates redirects to ensure old links continue working and fixes references to the deprecated "Keep Workers Running" guide throughout the documentation.

[changeset-bot]

⚠️ No Changeset found

Latest commit: 081f8a9

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]

• docs: split compilation docs into startup and manual compilation pages #537
• feat: add auto-compilation and worker management with improved documentation #536 👈 (View in Graphite)
• main

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

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 081f8a9

Command	Status	Duration	Result
nx affected -t verify-exports --base=origin/mai...	✅ Succeeded	<1s	View ↗
nx affected -t build --configuration=production...	✅ Succeeded	<1s	View ↗
nx affected -t lint typecheck test --parallel -...	✅ Succeeded	1s	View ↗

---

☁️ Nx Cloud last updated this comment at 2025-12-10 16:53:47 UTC

[jumski]

Merge activity

• Dec 10, 4:51 PM UTC: A user started a stack merge that includes this pull request via Graphite.
• Dec 10, 4:52 PM UTC: Graphite rebased this pull request as part of a merge.
• Dec 10, 4:54 PM UTC: @jumski merged this pull request with Graphite.

[github-actions]

🔍 Preview Deployment: Website

✅ Deployment successful!

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

📝 Details:

• Branch: 12-10-docs_update_for_auto-compilation_and_automatic_worker_management
• Commit: 9fd45edfb5ff2ab568ec857c08a2500255e0573c
• View Logs

_Last updated: _

[github-actions]

🚀 Production Deployment: Website

✅ Successfully deployed to production!

🔗 Production URL: https://pgflow.dev

📝 Details:

• Commit: be2d4c6055582c1527230ed624020efe01911c50
• View Logs

Deployed at: 2025-12-10T17:54:24+01:00