docs(deploy): document live-error recovery paths and add changeset

Author: wyattjoh

.changeset/deploy-error-recovery.md

@@ -0,0 +1,5 @@
+---
+"clerk": minor
+---
+
+Surface Clerk API error codes and metadata as structured fields on `PlapiError` / `BapiError` / `FapiError`, and use them to add two recovery paths in `clerk deploy`: resume from server state when a production instance already exists, and present a friendly upgrade hint when the development instance uses features the current subscription plan doesn't allow.

packages/cli-core/src/commands/deploy/README.md

@@ -176,3 +176,12 @@ When the user chooses the guided walkthrough, these values are derived from thei
 | ----------------------------- | --------------------------------------------- |
 | Authorized JavaScript origins | `https://{domain}`, `https://www.{domain}`    |
 | Authorized redirect URI       | `https://accounts.{domain}/v1/oauth_callback` |
+
+### Recovery paths
+
+- **`production_instance_exists`** (HTTP 400) on production-instance creation —
+  the wizard refetches the application, persists the existing instance ID, and
+  jumps into the reconcile flow as if local state had been intact.
+- **`unsupported_subscription_plan_features`** (HTTP 402) on cloning validation —
+  the wizard rethrows a `CliError` listing the unsupported features and pointing
+  at `https://clerk.com/docs/billing/plans`.