add watch option

[gabcoyne]

Title: Add --watch Command to Monitor Flow Runs in CLI

Overview:

This pull request introduces the --watch command to the CLI, enhancing the user experience by allowing real-time monitoring of flow runs. This feature is particularly useful for users who need to track the progress of their flows and get immediate feedback upon completion.

Example:

With the --watch option, users can now initiate a flow run and actively monitor its progress. Upon completion, the command outputs the final state of the flow run to stderr, providing immediate visibility into the success or failure of the execution. Here's a simple example:

prefect deployment run --watch <slugified-flow-name>/<slugified-deployment-name>

This command will initiate the monitoring of the specified flow run and display updates until the run is completed.

Checklist:

• [ N/A] References any related issue (N/A if not applicable).
• Includes tests covering the new functionality.
• Labeled appropriately, e.g., feature.
• For new functions or classes: includes helpful docstrings.
• [N/A ] For documentation changes: if applicable, includes redirect settings in netlify.toml.

[netlify]

✅ Deploy Preview for prefect-docs-preview ready!

Name	Link
🔨 Latest commit	baf2332
🔍 Latest deploy log	https://app.netlify.com/sites/prefect-docs-preview/deploys/65c66107a31cf40009b5ef6c
😎 Deploy Preview	https://deploy-preview-11702--prefect-docs-preview.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[abrookins]

Oooo, nice one

[abrookins]

We could expand this later to stream events and logs in real-time, I think:

prefect/src/prefect/events/clients.py

Line 250 in 5f570d2

class PrefectCloudEventSubscriber:

[serinamarie]

Cool! I left some initial comments. Around line 560 is where it would be good to exit_with_error early if a user provides a watch_interval but no --watch flag, etc. etc.