@spacefast/common 0.0.23 → 0.0.26

package/dist/docs/error-docs.js

@@ -1,8 +1,8 @@
-// Error reference content (internal-docs/platform.md "Global API Conventions"):
+// Error reference content (the platform spec "Global API Conventions"):
 // every problem document `type` points at `https://spacefast.com/docs/errors/{code}`,
 // and those pages are GENERATED from this table — one entry per member of
 // `ERROR_CODES`, asserted complete by the conformance suite so links never rot
-// and pages never go missing. apps/www renders the HTML pages and writes the
+// and pages never go missing. The standalone website renders the HTML pages and writes the
 // `.md` twins from the same entries.
 import { BRAND } from "../brand.js";
 import { serviceOrigin } from "../config/domains.js";
@@ -15,7 +15,7 @@ export const ERROR_DOCS = {
     },
     account_suspended: {
         summary: "This account is suspended for a policy or abuse violation and cannot be used.",
-        fix: "Contact support to review the suspension if you believe it is a mistake.",
+        fix: "If you believe the suspension is a mistake, contact support to review it.",
     },
     abuse_report_rate_limited: {
         summary: "Too many abuse reports were submitted from this client in a short window.",
@@ -23,7 +23,7 @@ export const ERROR_DOCS = {
     },
     abuse_takedown: {
         summary: "This space was disabled by an abuse takedown and cannot be served or modified.",
-        fix: "If you believe this is a mistake, contact support with the space id.",
+        fix: "If you believe the takedown is a mistake, contact support with the space id.",
     },
     access_denied: {
         summary: "The authorization request was denied by the user.",
@@ -39,7 +39,7 @@ export const ERROR_DOCS = {
     },
     agent_handoff_origin_unsupported: {
         summary: "The dashboard origin this deployment is configured with cannot mint canonical agent handoff links.",
-        fix: "Point SPACEFAST_DASHBOARD_URL at a valid HTTP(S) origin. If you cannot change it, contact support.",
+        fix: "Point SPACEFAST_DASHBOARD_URL at a valid HTTP or HTTPS origin. If you cannot change it, contact support.",
     },
     ambiguous_space_slug: {
         summary: "The slug matches spaces in more than one of your teams, so it cannot be resolved.",
@@ -49,26 +49,18 @@ export const ERROR_DOCS = {
         summary: "This anonymous space expired before it was claimed.",
         fix: "Publish a fresh space and share its claim link right away this time. If you meant to update a live space, check .spacefast/ (or your saved receipt) for its spaceId. Publish to that space with its credential instead of creating a new space.",
     },
-    anonymous_pool_unavailable: {
-        summary: "No pooled capacity is available for anonymous publishes right now.",
-        fix: "Retry shortly. Capacity replenishes automatically.",
-    },
     anonymous_publish_rate_limited: {
         summary: "Too many anonymous publishes came from this network in a short window.",
         fix: "Wait for the window to pass, or sign in with an API key for higher limits.",
     },
     anonymous_space_limit_reached: {
-        summary: "Too many unclaimed anonymous spaces are already active for this client.",
-        fix: "Log in to publish into an authenticated space, or claim/delete an existing anonymous space before creating another.",
+        summary: "This client already holds the maximum number of unclaimed spaces.",
+        fix: "Sign in and publish into your account, or claim or delete one of the unclaimed spaces you already have.",
     },
     api_key_scope_underivable: {
         summary: "A concrete access policy cannot be derived from the requested scope and permissions.",
         fix: "Point scope at a resource you can already reach (an existing space owned by a team). Request only permissions your credential already has.",
     },
-    archive_body_required: {
-        summary: "This request must carry an archive body but none was provided.",
-        fix: "Send the zip bytes as the request body with the matching content-type header.",
-    },
     archive_too_large: {
         summary: "The uploaded archive exceeds the maximum allowed size.",
         fix: "Reduce the archive size or upload files individually through a version upload session.",
@@ -81,33 +73,13 @@ export const ERROR_DOCS = {
         summary: "The device login is not approved yet.",
         fix: "Keep polling at the advised interval until the user approves the request.",
     },
-    billing_receipt_invalid: {
-        summary: "The store receipt or notification cannot be verified with the payment provider.",
-        fix: "Re-check the transaction id or purchase token and retry. Contact support if it persists.",
-    },
-    billing_receipt_not_bound_to_team: {
-        summary: "The store purchase was made under a different account token than this team's.",
-        fix: "Verify the purchase from the team that initiated it, or contact support to rebind it.",
-    },
-    billing_store_not_configured: {
-        summary: "App Store or Google Play billing is not configured on this deployment.",
-        fix: "Use another billing method, or configure the store credentials on the server.",
-    },
-    billing_subscription_conflict: {
-        summary: "The team already has an active subscription with another payment provider.",
-        fix: "Cancel the existing subscription before subscribing through a different provider.",
-    },
-    billing_unknown_product: {
-        summary: "The purchased store product does not map to any plan sold by this deployment.",
-        fix: "Check the product id against the store catalog returned by the billing endpoints.",
-    },
     build_command_missing: {
         summary: "A build or install command cannot be found during the build run.",
         fix: "Check the command spelling and ensure its tool is declared in package.json or available in the build image.",
     },
     build_execution_unavailable: {
         summary: "Build execution is not available on this deployment.",
-        fix: "Publish prebuilt static output instead, or wait for builds to become available.",
+        fix: "Publish prebuilt output instead.",
     },
     build_failed: {
         summary: "The build run failed before producing a version.",
@@ -129,6 +101,10 @@ export const ERROR_DOCS = {
         summary: "The build process was killed, most likely after running out of memory.",
         fix: "Reduce the build's memory usage or concurrency, then start a new build.",
     },
+    build_output_contains_server_bundle: {
+        summary: "The build output contains a compiled server bundle (an OpenNext worker.js), which a file-only publish would expose as a public download.",
+        fix: "This app needs the Spacefast Functions pipeline: run `sf publish` in the project with the Spacefast CLI so the worker deploys as a Function, or point the output directory at a browser-ready export.",
+    },
     build_output_dir_missing: {
         summary: "The build finished but its output directory was not produced.",
         fix: "Point the output directory setting at the folder your build writes (for example dist, build, out, or public).",
@@ -137,6 +113,14 @@ export const ERROR_DOCS = {
         summary: "The build exceeded its time limit before producing a version.",
         fix: "Speed up the build or raise the build timeout in the build settings, then start a new build.",
     },
+    blob_gate_record_missing: {
+        summary: "The file behind this download link no longer exists.",
+        fix: "The underlying object was deleted. Ask the owner for a fresh link.",
+    },
+    blob_gate_token_invalid: {
+        summary: "The download token is invalid or expired.",
+        fix: "Request a fresh download link and use it within its lifetime.",
+    },
     cache_purge_domain_required: {
         summary: "A purge request must name the domain to purge.",
         fix: "Pass the domain to purge in the request.",
@@ -159,7 +143,7 @@ export const ERROR_DOCS = {
     },
     claim_blocked_takedown: {
         summary: "This space is under an abuse takedown and cannot be claimed.",
-        fix: "Contact support if you believe the takedown is a mistake.",
+        fix: "If you believe the takedown is a mistake, contact support.",
     },
     claim_target_not_found: {
         summary: "The team or account to claim the space into was not found.",
@@ -167,19 +151,15 @@ export const ERROR_DOCS = {
     },
     claimed_space_quota_exceeded: {
         summary: "Claiming this space would exceed the target team's space quota.",
-        fix: "Delete unused spaces, then claim again. Still stuck? POST /v1/feedback with the error code and request id.",
+        fix: "Delete unused spaces, then claim again. If you are still stuck, POST /v1/feedback with the error code and requestId.",
     },
     cli_upgrade_required: {
         summary: "This CLI version is too old to talk to the API safely.",
         fix: "Upgrade the CLI to the latest release and retry.",
     },
-    comment_screenshot_rate_limited: {
-        summary: "Too many comment screenshot uploads were attempted.",
-        fix: "Wait for the one-minute window to reset, then retry the screenshot upload.",
-    },
     config_file_too_large: {
         summary: "The sf.jsonc configuration file exceeds the maximum size.",
-        fix: "Keep the configuration file under the documented size limit (256 KB).",
+        fix: "Keep the configuration file at or under 256 KB.",
     },
     config_functions_key_removed: {
         summary: "The sf.jsonc configuration still uses the removed top-level functions key.",
@@ -199,7 +179,7 @@ export const ERROR_DOCS = {
     },
     config_runtime_entry_missing: {
         summary: "The declared runtime has no entry module to compile.",
-        fix: "Name the entry in sf.jsonc: runtime.entry for functions, runtime.server and runtime.client for zero. Remove the runtime block to publish static files instead.",
+        fix: "Name the entry in sf.jsonc: runtime.entry for functions, runtime.server and runtime.client for zero. Remove the runtime block to publish files without a runtime instead.",
     },
     config_runtime_invalid_kind: {
         summary: "The runtime block in the space configuration declares an unknown kind.",
@@ -207,14 +187,14 @@ export const ERROR_DOCS = {
     },
     config_templates_over_limit: {
         summary: "The configuration declares more template files than the plan allows.",
-        fix: "Reduce the number of template entries in sf.jsonc. Still stuck? POST /v1/feedback with the error code and request id.",
+        fix: "Reduce the number of template entries in sf.jsonc. If you are still stuck, POST /v1/feedback with the error code and requestId.",
     },
     continuation_unavailable: {
-        summary: "This claim token can no longer be exchanged for an API key.",
-        fix: "If the space is claimed, ask its owner for an API key (dashboard: Account → API keys). If it is still unclaimed, keep using the claim token as bearer auth instead of exchanging it. Still stuck? POST /v1/feedback with the error code and request id.",
+        summary: "This space key can no longer be exchanged for an API key.",
+        fix: "If the space is claimed, ask its owner for an API key (dashboard: Account → API keys). If it is still unclaimed, keep using the space key as bearer auth instead of exchanging it. If you are still stuck, POST /v1/feedback with the error code and requestId.",
     },
     continuation_used: {
-        summary: "This claim token was already exchanged for a durable API key.",
+        summary: "This space key was already exchanged for a durable API key.",
         fix: "Authenticate with the exchanged API key (check .spacefast/state.json or wherever it was saved). If it was lost, ask the space owner to create a new API key.",
     },
     credential_expired: {
@@ -223,7 +203,7 @@ export const ERROR_DOCS = {
     },
     credential_not_yet_valid: {
         summary: "The credential is not valid yet because its start time is in the future.",
-        fix: "Wait until the credential's notBefore time, or adjust it.",
+        fix: "Wait until the credential's notBefore time, or adjust the notBefore value.",
     },
     credential_retired: {
         summary: "This request used a retired Spacefast token format or authentication header.",
@@ -241,10 +221,6 @@ export const ERROR_DOCS = {
         summary: "CSAM enforcement policy cannot be set below the mandatory account-suspend floor.",
         fix: "Set the CSAM category enforcement tier to account suspension.",
     },
-    custom_certificates_require_dedicated_site: {
-        summary: "Custom certificates are unavailable while this space uses shared placement.",
-        fix: "Move the space to dedicated placement before managing custom certificates.",
-    },
     data_location_immutable: {
         summary: "This request tried to change data location through an immutable path.",
         fix: "Data location is fixed when the space is created and cannot be changed afterwards. Create a new space in the region you want.",
@@ -259,7 +235,7 @@ export const ERROR_DOCS = {
     },
     device_verification_rate_limited: {
         summary: "Too many incorrect device codes were entered in a short window.",
-        fix: "Wait for the lockout to pass, then enter the code shown by your CLI exactly.",
+        fix: "Wait for the lockout to pass, then enter the code exactly as your CLI shows it.",
     },
     dns_export_required: {
         summary: "This operation requires exporting the current DNS records first.",
@@ -271,7 +247,7 @@ export const ERROR_DOCS = {
     },
     dns_import_partial_visibility: {
         summary: "The DNS import cannot see the full zone, so importing would lose records.",
-        fix: "Verify delegation and retry once the full zone is visible.",
+        fix: "Verify delegation. Once the full zone is visible, retry the import.",
     },
     dns_provider_auth_expired: {
         summary: "The connected DNS provider authorization expired or was revoked.",
@@ -279,7 +255,7 @@ export const ERROR_DOCS = {
     },
     dns_provider_batch_unsupported: {
         summary: "The connected DNS provider cannot apply this batch with the required semantics.",
-        fix: "Split the change or use a provider/zone that supports atomic batch writes.",
+        fix: "Split the change, or use a provider or zone that supports atomic batch writes.",
     },
     dns_provider_change_pending: {
         summary: "The DNS provider accepted the change but propagation or provider completion is still pending.",
@@ -351,7 +327,7 @@ export const ERROR_DOCS = {
     },
     dns_provider_replace_all_write_strategy: {
         summary: "This provider applies DNS changes with a replace-all write strategy.",
-        fix: "Review the full-zone diff carefully so unrelated MX, TXT, CAA, NS, and wildcard records are preserved.",
+        fix: "To preserve unrelated MX, TXT, CAA, NS, and wildcard records, review the full-zone diff carefully.",
     },
     dns_provider_snapshot_stale: {
         summary: "The cached DNS provider snapshot is stale.",
@@ -359,7 +335,7 @@ export const ERROR_DOCS = {
     },
     dns_provider_snapshot_unavailable: {
         summary: `${BRAND.productName} cannot cache the latest DNS provider snapshot.`,
-        fix: "Retry refresh after the cache or provider recovers. Do not edit connected-provider records from stale data.",
+        fix: "Retry the refresh after the cache or provider recovers. Do not edit connected-provider records from stale data.",
     },
     dns_provider_temporarily_unavailable: {
         summary: "The DNS provider is rate-limited, degraded, or temporarily unavailable.",
@@ -431,7 +407,7 @@ export const ERROR_DOCS = {
     },
     domain_quota_exceeded: {
         summary: "Adding this domain would exceed the plan's external domain allowance.",
-        fix: "Remove unused domains. Still stuck? POST /v1/feedback with the error code and request id.",
+        fix: "Remove unused domains. If you are still stuck, POST /v1/feedback with the error code and requestId.",
     },
     domain_registration_active: {
         summary: "The domain has an active registration, which blocks this operation.",
@@ -467,23 +443,15 @@ export const ERROR_DOCS = {
     },
     enforcement_policy_overlap: {
         summary: "Enforcement policy severity ranges overlap within a category.",
-        fix: "Adjust the category ranges so each severity is covered by at most one policy.",
+        fix: "Adjust the category ranges so at most one policy covers each severity.",
     },
     expired_token: {
         summary: "The token is expired.",
         fix: "Request a new token and retry.",
     },
-    export_archive_not_ready: {
-        summary: "The export archive is still being prepared.",
-        fix: "Poll the export until its status is ready, then download the archive.",
-    },
-    export_version_not_found: {
-        summary: "The version requested for export was not found.",
-        fix: "List the space's versions and export an existing version id.",
-    },
     feature_unavailable: {
         summary: "This feature is not available on this deployment or plan.",
-        fix: "Check the feature's availability and try again when it is enabled for your team.",
+        fix: "Check the feature's availability. When the feature is enabled for your team, try again.",
     },
     files_mode_does_not_support_spa: {
         summary: "SPA fallback cannot be combined with files-listing mode.",
@@ -495,39 +463,23 @@ export const ERROR_DOCS = {
     },
     free_external_proxy_disabled: {
         summary: "Proxy routes to external upstreams are not available on the Free plan.",
-        fix: "Remove the proxy rules before publishing. Still stuck? POST /v1/feedback with the error code and request id.",
-    },
-    google_play_webhook_identity_not_configured: {
-        summary: "Google Play Pub/Sub push authentication is not configured on this deployment.",
-        fix: "Configure the exact push audience and dedicated Pub/Sub service-account email before enabling RTDN delivery.",
+        fix: "Remove the proxy rules before publishing. If you are still stuck, POST /v1/feedback with the error code and requestId.",
     },
     idempotency_conflict_in_progress: {
         summary: "Another request with the same Idempotency-Key is still in flight.",
-        fix: "Wait for the original request to finish. Its response will be replayed.",
+        fix: "Wait for the original request to finish. The API will replay that request's response.",
     },
     idempotency_key_reused: {
         summary: "The Idempotency-Key was reused with a different request body.",
         fix: "Use a fresh key for new requests. Keys bind to one exact request body.",
     },
-    import_archive_not_uploaded: {
-        summary: "The import has no uploaded archive yet.",
-        fix: "Upload the archive to the import's upload target, then finalize.",
-    },
-    import_not_cancelable: {
-        summary: "The import is past the point where it can be canceled.",
-        fix: "Wait for the import to finish. Completed imports can be deleted as versions.",
-    },
-    import_not_waiting_for_archive: {
-        summary: "The import is not waiting for an archive upload.",
-        fix: "Check the import status. If the archive step is complete, continue to the next step.",
-    },
     incumbent_controls_dns: {
         summary: "Another team controls this domain's DNS, so the operation is blocked.",
         fix: "Prove control by completing domain verification, or coordinate with the incumbent.",
     },
     inject_invalid: {
         summary: "The inject config key is malformed.",
-        fix: "Make inject an object whose head/bodyStart/bodyEnd/noscript entries are arrays of up to 16 strings.",
+        fix: "Make `inject` an object whose `head`, `bodyStart`, `bodyEnd`, and `noscript` entries are arrays of up to 16 strings.",
     },
     inject_snippet_too_large: {
         summary: "An inject snippet exceeds the per-snippet size limit.",
@@ -535,11 +487,11 @@ export const ERROR_DOCS = {
     },
     internal_error: {
         summary: "Something went wrong on our side.",
-        fix: "Retry the request. If it persists, contact support with the requestId.",
+        fix: "Retry the request. If the error persists, contact support with the requestId.",
     },
     invalid_claim_token: {
-        summary: "The claim token is invalid or does not match this space.",
-        fix: "Use the exact claim URL returned by the publish that created the space.",
+        summary: "The space key is invalid or does not match this space.",
+        fix: "Use the exact space key or claim link returned by the publish that created the space.",
     },
     invalid_continuation_token: {
         summary: "The continuation token is invalid, expired, or already finished.",
@@ -559,16 +511,12 @@ export const ERROR_DOCS = {
     },
     invalid_domain_name: {
         summary: "The domain name is not a valid registrable hostname.",
-        fix: "Check the spelling and use a fully-qualified domain name.",
+        fix: "Check the spelling and use a fully qualified domain name.",
     },
     invalid_file_path: {
         summary: "A file path in the request is not a valid space path.",
         fix: "Use forward-slash relative paths without traversal segments.",
     },
-    invalid_google_play_webhook_identity: {
-        summary: "The Google Play notification did not carry a valid Pub/Sub push identity.",
-        fix: "Send the notification through the configured authenticated Pub/Sub push subscription.",
-    },
     invalid_grant: {
         summary: "The authorization grant is invalid or was already used.",
         fix: "Restart the login flow to obtain a new grant.",
@@ -607,7 +555,7 @@ export const ERROR_DOCS = {
     },
     invalid_user_code: {
         summary: "The user code does not match a pending device login.",
-        fix: "Enter the code exactly as shown by your CLI. Codes expire after a few minutes.",
+        fix: "Enter the code exactly as your CLI shows it. Codes expire after a few minutes.",
     },
     invalid_version_path: {
         summary: "A file path in the version is not a valid space path.",
@@ -651,15 +599,15 @@ export const ERROR_DOCS = {
     },
     invitation_not_pending: {
         summary: "The invitation is no longer pending.",
-        fix: "Create a new invitation if the member still needs to join.",
+        fix: "If the member still needs to join, create a new invitation.",
     },
     ip_blocked: {
         summary: "Requests from this IP address are blocked for abuse or policy reasons.",
-        fix: "Contact support with your IP address if you believe this block is in error.",
+        fix: "If you believe this block is a mistake, contact support with your IP address.",
     },
     job_not_found: {
         summary: "The background job was not found.",
-        fix: "Verify the job id. Completed jobs are eventually pruned.",
+        fix: "Verify the job id. Spacefast eventually prunes completed jobs.",
     },
     job_not_promotable: {
         summary: "The job cannot be promoted in its current state.",
@@ -691,11 +639,11 @@ export const ERROR_DOCS = {
     },
     malware_detected: {
         summary: "Malware was detected in the uploaded content.",
-        fix: "Remove the flagged files. Contact support if you believe this is a false positive.",
+        fix: "Remove the flagged files. If you believe the detection is a false positive, contact support.",
     },
     managed_domain_protected: {
         summary: "This is a system-managed view.fast hostname and cannot be mutated like a custom domain.",
-        fix: "Use it as a read-only managed hostname, or add a custom domain if you need editable DNS and binding controls.",
+        fix: "Use the hostname as a read-only managed hostname. If you need editable DNS and binding controls, add a custom domain.",
     },
     manifest_body_too_large: {
         summary: "The upload manifest body exceeds the maximum size.",
@@ -703,7 +651,7 @@ export const ERROR_DOCS = {
     },
     manifest_duplicate_path: {
         summary: "The upload manifest declares the same path more than once.",
-        fix: "Deduplicate paths. Comparisons use the canonical (decoded, NFC) form.",
+        fix: "Deduplicate paths. Comparisons use the canonical form: decoded and NFC-normalized.",
     },
     manifest_too_many_files: {
         summary: "The upload manifest declares more files than the allowed ceiling.",
@@ -723,15 +671,15 @@ export const ERROR_DOCS = {
     },
     move_target_capacity_lost: {
         summary: "The selected move target no longer has capacity for the space.",
-        fix: "Retry the move with a different target or after capacity is freed.",
+        fix: "Retry the move with a different target, or retry after capacity is freed.",
     },
     name_managed_by_config: {
         summary: "The space name is managed by sf.jsonc while its live version declares one.",
-        fix: "Change name in sf.jsonc and publish, or remove name from the file to rename the space through the API.",
+        fix: "Change `name` in `sf.jsonc` and publish, or remove `name` from the file to rename the space through the API.",
     },
     nameserver_delegation_required: {
         summary: `This operation requires the domain to be delegated to ${BRAND.productName} nameservers.`,
-        fix: "Update the domain's nameservers at the registrar, then retry once delegation propagates.",
+        fix: "Update the domain's nameservers at the registrar. After delegation propagates, retry.",
     },
     nameserver_divergence: {
         summary: "The domain's observed nameservers diverge from the expected set.",
@@ -739,7 +687,7 @@ export const ERROR_DOCS = {
     },
     noop_publish: {
         summary: "The publish matched the live version exactly, so nothing changed.",
-        fix: "No action needed. The existing live version already serves this content.",
+        fix: "No action is needed. The existing live version already serves this content.",
     },
     not_enrolled: {
         summary: "This account is not enrolled in the private beta, so the API cannot be used yet.",
@@ -747,11 +695,11 @@ export const ERROR_DOCS = {
     },
     not_found: {
         summary: "The requested resource was not found.",
-        fix: "Verify the id and that your credential can access the resource.",
+        fix: "Verify that the id is correct and that your credential can access the resource.",
     },
     path_case_collision: {
         summary: "Two file paths differ only by letter case, which collides on serving.",
-        fix: "Rename one of the files so paths are unique case-insensitively.",
+        fix: "Rename one of the files so that paths are unique case-insensitively.",
     },
     path_too_long: {
         summary: "A file path exceeds the maximum length.",
@@ -763,15 +711,11 @@ export const ERROR_DOCS = {
     },
     plan_grant_already_revoked: {
         summary: "This plan grant was already revoked.",
-        fix: "Nothing to do. Create a new grant if the team should regain the plan.",
+        fix: "No action is needed. If the team should regain the plan, create a new grant.",
     },
     placement_invalid_burstable: {
         summary: "The placement burstable option was used with an unsupported placement mode.",
-        fix: 'Set placement.mode to "dedicated" before setting placement.burstable, or remove the burstable option.',
-    },
-    placement_mode_requires_plan: {
-        summary: "The requested placement mode requires a plan entitlement.",
-        fix: "Upgrade the team plan or choose shared placement.",
+        fix: 'Set `placement.mode` to `"dedicated"` before setting `placement.burstable`, or remove the burstable option.',
     },
     platform_tenant_immutable_client: {
         summary: "The tenant's provider client cannot be changed.",
@@ -781,13 +725,25 @@ export const ERROR_DOCS = {
         summary: "The requested key policy grants more than your own credential allows.",
         fix: "Request a policy that is a subset of the credential creating the key.",
     },
+    prebuilt_metadata_invalid: {
+        summary: "The metadata file next to the prebuilt archive exists but cannot be read or parsed, so the build's runtime shape is unknown.",
+        fix: "Re-run `sf build` to regenerate the archive and its metadata together. If the archive contains plain files, delete the metadata file.",
+    },
+    ingest_admission_exceeded: {
+        summary: "Too many concurrent uploads for this space.",
+        fix: "Wait for the Retry-After window, then resume. At most 4 uploads run per space at once.",
+    },
     principal_space_mismatch: {
         summary: "The space does not belong to the principal in the request.",
         fix: "Use the space's owning team or account in the request path.",
     },
+    promote_admission_exceeded: {
+        summary: "Too many archived files are being restored for this space right now.",
+        fix: "Retry shortly. Spacefast limits restores to protect the host.",
+    },
     provider_error: {
-        summary: "The hosting provider reported an error.",
-        fix: "Retry. If the error persists, contact support with the requestId.",
+        summary: "WP Cloud reported an error.",
+        fix: "Retry. If the error persists, contact support with the `requestId`.",
     },
     provider_job_failed: {
         summary: "A hosting-provider job failed while processing this operation.",
@@ -795,27 +751,35 @@ export const ERROR_DOCS = {
     },
     provider_job_timeout: {
         summary: "A hosting-provider job timed out while processing this operation.",
-        fix: "Retry the operation. If the provider is slow right now, wait and retry again.",
+        fix: "Retry the operation. If the provider is slow, wait and retry again.",
+    },
+    provider_privilege: {
+        summary: "WP Cloud does not grant this client permission to change the setting.",
+        fix: "Leave the provider-owned setting unchanged or contact support to request the required provider capability.",
     },
     provider_runtime_feature_unsupported: {
-        summary: "The hosting provider does not support this runtime feature.",
+        summary: "WP Cloud does not support this runtime feature.",
         fix: "Check the feature's availability for this site's runtime.",
     },
     provider_site_id_required: {
         summary: "A provider site id is required for this internal operation.",
-        fix: "Pass the provider site reference.",
+        fix: "Pass the provider site id.",
     },
     proxy_upstream_denied: {
         summary: "The proxy upstream is on a denied network and cannot be used.",
-        fix: "Proxy only to public HTTPS upstreams. Private and internal addresses are blocked.",
+        fix: "Proxy only to public HTTPS upstreams. Spacefast blocks private and internal addresses.",
     },
     proxy_upstream_unresolved: {
         summary: "The proxy upstream hostname cannot be resolved.",
-        fix: "Verify the upstream DNS name resolves publicly, then publish again.",
+        fix: "Verify that the upstream DNS name resolves publicly, then publish again.",
+    },
+    publish_session_expired: {
+        summary: "This publish session expired before it was finalized.",
+        fix: "Start a new publish. Spacefast keeps declared uploads for 24 hours only.",
     },
     publish_archive_compression_ratio_exceeded: {
         summary: "The archive's compression ratio is suspiciously high and was rejected.",
-        fix: "Repackage the content without highly-compressible filler data.",
+        fix: "Repackage the content without highly compressible filler data.",
     },
     publish_archive_expanded_size_exceeded: {
         summary: "The archive expands beyond the maximum allowed total size.",
@@ -831,7 +795,7 @@ export const ERROR_DOCS = {
     },
     publish_base_changed: {
         summary: "Someone published new space settings after the base you loaded, so saving would overwrite their change.",
-        fix: "Reload the latest settings, review the difference, and save again. Pass force only to overwrite deliberately.",
+        fix: "Reload the latest settings, review the difference, and save again. Pass `force` only to overwrite deliberately.",
     },
     publish_bytes_missing: {
         summary: "The publish has no complete staged content to materialize.",
@@ -839,7 +803,7 @@ export const ERROR_DOCS = {
     },
     publish_config_unsupported: {
         summary: "The publish carries configuration this endpoint does not support.",
-        fix: "Move the configuration into sf.jsonc or the space settings.",
+        fix: "Move the configuration into `sf.jsonc` or the space settings.",
     },
     publish_failed: {
         summary: "The publish failed before going live.",
@@ -859,11 +823,11 @@ export const ERROR_DOCS = {
     },
     publish_not_cancelable: {
         summary: "The publish is past the point where it can be canceled.",
-        fix: "Wait for the publish to finish, then roll back by promoting a previous version if needed.",
+        fix: "Wait for the publish to finish. To roll back, promote a previous version.",
     },
     publish_path_collision: {
         summary: "Two different artifacts would serve the same URL after directory-index or clean-URL resolution.",
-        fix: "Rename or remove one artifact so every request route has one owner.",
+        fix: "Rename or remove one artifact so that every request route has one owner.",
     },
     publish_path_invalid: {
         summary: "A publish path is not a relative, normalized POSIX path.",
@@ -871,7 +835,7 @@ export const ERROR_DOCS = {
     },
     publish_setup_failed: {
         summary: "Provisioning for this publish failed.",
-        fix: "Retry the publish. If it persists, contact support with the requestId.",
+        fix: "Retry the publish. If the error persists, contact support with the `requestId`.",
     },
     publish_snapshot_empty: {
         summary: "An empty snapshot was sent without an explicit base version.",
@@ -889,6 +853,14 @@ export const ERROR_DOCS = {
         summary: "The named job queue does not exist.",
         fix: "Check the queue name against the operator queue list.",
     },
+    response_headers_unservable: {
+        summary: "A file needs a response header that the platform cannot deliver for large files.",
+        fix: "Reduce the file below 100 MiB or drop the custom header.",
+    },
+    response_table_too_large: {
+        summary: "A compiled response table exceeded the 1 MiB per-file limit.",
+        fix: "This version has an unusually dense path set. Contact support with the `requestId`.",
+    },
     rate_limited: {
         summary: "Too many requests were made in a short window.",
         fix: "Wait for the window in the Retry-After header to pass, then retry.",
@@ -903,11 +875,15 @@ export const ERROR_DOCS = {
     },
     resource_revision_changed: {
         summary: "The resource changed after you loaded it, so the stale write was rejected.",
-        fix: "Use the current resource returned in error.details.current, reapply the intended fields, and send its revision as expectedRevision.",
+        fix: "Use the current resource returned in `error.details.current`, reapply the intended fields, and send its revision as `expectedRevision`.",
+    },
+    review_item_claimed: {
+        summary: "Another reviewer already claimed this review item.",
+        fix: "Pick a different item, or ask the current assignee to release it. The assignee's id is in `error.details.assignedToUserId`.",
     },
     routing_rules_over_plan: {
         summary: "The published _redirects and _headers exceed the plan's routing-rule allowance.",
-        fix: "Reduce the rule count. Still stuck? POST /v1/feedback with the error code and request id.",
+        fix: "Reduce the rule count. If you still need more rules, POST to `/v1/feedback` with the error code and the `requestId`.",
     },
     runtime_action_forbidden: {
         summary: "The runtime credential does not allow this action.",
@@ -915,7 +891,7 @@ export const ERROR_DOCS = {
     },
     runtime_api_not_found: {
         summary: "The runtime management endpoint was not found.",
-        fix: "Send the request with the management hostname as the Host header. Management routes are not served on public hostnames.",
+        fix: "Send the request with the management hostname as the Host header. Spacefast does not serve management routes on public hostnames.",
     },
     runtime_callback_forbidden: {
         summary: "The runtime callback cannot be authenticated.",
@@ -923,23 +899,19 @@ export const ERROR_DOCS = {
     },
     runtime_dev_unsupported: {
         summary: "`sf dev` cannot run this runtime locally yet.",
-        fix: "Run your framework's own dev server (`next dev`, `vite`, …) and publish with `sf publish` when you are ready.",
-    },
-    runtime_engine_zip_missing: {
-        summary: "The runtime engine artifact is missing from this deployment.",
-        fix: "Rebuild the control plane so dist/runtime-engine.zip exists.",
+        fix: "Run your framework's own dev server, such as `next dev` or `vite`. When you are ready, publish with `sf publish`.",
     },
     runtime_hostname_unassigned: {
         summary: "The hostname is not assigned to a runtime, so the request cannot be routed.",
-        fix: `Verify the binding is active and DNS points at ${BRAND.productName}.`,
+        fix: `Verify that the binding is active and that DNS points at ${BRAND.productName}.`,
     },
     runtime_instance_mismatch: {
         summary: "The request reached a different runtime instance than the one it was issued for.",
-        fix: "Re-request instructions. The space is on another instance now.",
+        fix: "Re-request instructions. The space is on another instance.",
     },
     runtime_jti_missing: {
         summary: "The runtime token is missing its replay-protection id.",
-        fix: "Mint a fresh runtime token. Tokens must carry a jti claim.",
+        fix: "Mint a fresh runtime token. Tokens must carry a `jti` claim.",
     },
     runtime_jti_replayed: {
         summary: "The runtime token was already used. Replays are rejected.",
@@ -951,7 +923,7 @@ export const ERROR_DOCS = {
     },
     runtime_kind_mismatch: {
         summary: "This operation is only available for a different runtime kind.",
-        fix: "Check `sf runtime status` for what the live version actually runs, then use the surface that runtime supports.",
+        fix: "Check `sf runtime status` for what the live version actually runs, then use the operations that runtime supports.",
     },
     runtime_management_unavailable: {
         summary: "The runtime management surface is unavailable for this site.",
@@ -959,19 +931,27 @@ export const ERROR_DOCS = {
     },
     runtime_not_provisioned: {
         summary: "The space does not serve a published version yet, so it has no runtime data to read.",
-        fix: "Publish a version first. If a publish is already running, wait for it — the operation receipt reports progress.",
+        fix: "Publish a version first. If a publish is already running, wait for it. The operation receipt reports progress.",
     },
     runtime_operation_missing: {
         summary: "The runtime operation referenced by this request was not found.",
         fix: "Re-request instructions and retry with a current operation id.",
     },
+    runtime_purge_failed: {
+        summary: "Content updated but the edge cache purge did not confirm.",
+        fix: "The runtime retries automatically. Recent visitors may briefly see the previous version.",
+    },
+    runtime_release_unverifiable: {
+        summary: "The requested platform release could not be verified at its origin.",
+        fix: "Check that the release exists and published its full set of artifacts, then request it again.",
+    },
     runtime_scope_forbidden: {
         summary: "The runtime token's scope does not cover this path or action.",
         fix: "Use the token minted for this exact session, space, and step.",
     },
     runtime_token_bad_signature: {
         summary: "The runtime token signature did not verify.",
-        fix: "Mint a fresh token. Verify clocks and JWKS freshness if it persists.",
+        fix: "Mint a fresh runtime token. If the error persists, verify clocks and JWKS freshness.",
     },
     runtime_token_expired: {
         summary: "The runtime token is expired.",
@@ -983,7 +963,7 @@ export const ERROR_DOCS = {
     },
     runtime_unauthorized: {
         summary: "The request to the runtime carried no valid credential.",
-        fix: "Send the runtime JWT in the Authorization header.",
+        fix: "Send the runtime token in the Authorization header.",
     },
     runtime_upload_operation_not_supported: {
         summary: "The runtime upload session does not support this operation.",
@@ -995,7 +975,7 @@ export const ERROR_DOCS = {
     },
     scan_pending: {
         summary: "The content is still being scanned for safety and cannot be served yet.",
-        fix: "Wait for the scan to finish. Serving resumes automatically once it clears.",
+        fix: "Wait for the scan to finish. Serving resumes automatically once the scan clears.",
     },
     secret_variable_in_template: {
         summary: "A secret variable was referenced in a template, which is blocked.",
@@ -1003,7 +983,7 @@ export const ERROR_DOCS = {
     },
     service_booting: {
         summary: "The process that received this request is still starting and cannot serve it yet.",
-        fix: "Wait for the Retry-After window, then send the same request again.",
+        fix: "Wait for the `Retry-After` window, then send the same request again.",
     },
     service_signature_invalid: {
         summary: "The service request signature cannot be verified.",
@@ -1011,7 +991,7 @@ export const ERROR_DOCS = {
     },
     site_already_deleted: {
         summary: "The site was already deleted.",
-        fix: "No action needed. The site is gone.",
+        fix: "No action is needed. The site is gone.",
     },
     site_has_live_spaces: {
         summary: "The site still has live spaces assigned to it, so it cannot be deleted.",
@@ -1059,27 +1039,23 @@ export const ERROR_DOCS = {
     },
     space_already_claimed: {
         summary: "The space was already claimed. A claim can only succeed once.",
-        fix: "If you published this space, exchange your claim token once at POST /v1/anonymous-claim/exchange. Keep publishing to the same spaceId with that durable API key. Otherwise ask the owner for access — do not publish a duplicate space.",
-    },
-    space_capacity_warming: {
-        summary: "This space is waiting on serving capacity that is being provisioned in the background.",
-        fix: "Wait for the Retry-After window, then send the same publish again. No version was created and no files were uploaded.",
+        fix: "If you published this space, exchange your space key once at `POST /v1/claim/exchange`. Keep publishing to the same `spaceId` with that durable API key. Otherwise ask the owner for access. Do not publish a duplicate space.",
     },
     space_claim_unavailable: {
         summary: "This space cannot be claimed.",
-        fix: "Only anonymous, unexpired spaces with a valid claim token can be claimed.",
+        fix: "Only anonymous, unexpired spaces with a valid space key can be claimed.",
     },
     space_claimed_credential_available: {
-        summary: "The space was claimed and its owner kept agent publishing enabled; this claim token now works exactly once as an exchange voucher.",
-        fix: "POST /v1/anonymous-claim/exchange with this claim token as bearer auth. Save the returned API key (e.g. .spacefast/state.json), then retry the request with it as Authorization: Bearer. Do not publish a new space.",
+        summary: "The space was claimed and its owner kept agent publishing enabled; this space key now works exactly once as an exchange voucher.",
+        fix: "`POST /v1/claim/exchange` with this space key as bearer auth. Save the returned API key (for example in `.spacefast/state.json`), then retry the request with that key as `Authorization: Bearer`. Do not publish a new space.",
     },
     space_disabled: {
         summary: "The space is disabled and cannot be served or modified.",
-        fix: "Check the disabled reason on the space. It explains the path to restore it.",
+        fix: "Check the disabled reason on the space. The reason explains how to restore the space.",
     },
     space_expired: {
         summary: "The space expired and is no longer served.",
-        fix: "If it is within the recovery window, claim or restore it. Otherwise publish again.",
+        fix: "If the space is within the recovery window, claim or restore it. Otherwise publish again.",
     },
     space_has_active_publish: {
         summary: "The space has a publish in progress, which blocks this operation.",
@@ -1093,37 +1069,13 @@ export const ERROR_DOCS = {
         summary: "The space is missing its persisted default hostname identity.",
         fix: "Contact support. Retrying cannot safely recreate a permanent hostname identity.",
     },
-    space_import_archive_invalid: {
-        summary: `The import archive is not a valid ${BRAND.productName} export.`,
-        fix: "Export the source space again and upload the unmodified archive.",
-    },
-    space_import_archive_too_large: {
-        summary: "The import archive exceeds the maximum allowed size.",
-        fix: "Reduce the export size, or import versions individually.",
-    },
-    space_import_config_only_archive: {
-        summary: "The archive contains only configuration and cannot be imported as content.",
-        fix: "Include files in the export, or apply the configuration directly.",
-    },
-    space_import_runtime_schema_unsupported: {
-        summary: "The export was produced by an unsupported runtime schema version.",
-        fix: "Re-export from a current runtime, or upgrade before exporting.",
-    },
-    space_move_would_strand_zero_data: {
-        summary: "The Space runs Zero, whose database and object storage live on the site the Space is placed on. Relocating it would strand that data on the old site, so the move is refused.",
-        fix: "Nothing was moved and no data was lost. Migrating Zero data between sites is not implemented. Contact support if the space genuinely has to be relocated.",
-    },
-    space_moving: {
-        summary: "The space is moving between sites, which blocks this operation.",
-        fix: "Wait for the move to finish, then retry.",
-    },
     space_no_live_version: {
         summary: "The space has no live version, so this operation has nothing to act on.",
         fix: "Publish a version to the space, then retry.",
     },
     space_not_disabled: {
         summary: "The space is not disabled, so it cannot be restored.",
-        fix: "No action needed. The space is already active.",
+        fix: "No action is needed. The space is already active.",
     },
     space_not_restorable: {
         summary: "The space is past its recovery window and cannot be restored.",
@@ -1143,11 +1095,11 @@ export const ERROR_DOCS = {
     },
     space_ref_ambiguous: {
         summary: "The space reference matches more than one accessible space.",
-        fix: "Use the spc_ id, or scope the reference with a teamRef.",
+        fix: "Use the `spc_` id, or scope the reference with a `teamRef`.",
     },
     space_ref_required: {
         summary: "A space reference is required for this operation.",
-        fix: "Pass a spc_ id, slug, or hostname.",
+        fix: "Pass a `spc_` id, slug, or hostname.",
     },
     space_transferring: {
         summary: "The space has a transfer in progress, which blocks this operation.",
@@ -1174,36 +1126,36 @@ export const ERROR_DOCS = {
         fix: "Target a static-runtime space.",
     },
     storage_auth_required: {
-        summary: "This storage operation requires an authenticated Zero user.",
-        fix: "Sign in to the hosted Zero app, then retry the storage operation.",
+        summary: "This storage operation requires an authenticated visitor.",
+        fix: "Sign in to the space, then retry the storage operation.",
     },
     storage_bucket_unavailable: {
         summary: "No usable internal storage bucket is configured for this operation.",
         fix: "Check the storage bucket registry and credential environment references, then retry.",
     },
     storage_content_blocked: {
-        summary: "The object contains executable or active web content that Zero storage does not serve.",
+        summary: "The object contains executable or active web content that Spacefast storage does not serve.",
         fix: "Upload a passive file type without HTML, script, SVG, PHP, or executable bytes.",
     },
     storage_delete_forbidden: {
-        summary: "The current Zero user did not upload this object.",
+        summary: "The current visitor did not upload this object.",
         fix: "Sign in as the original uploader before deleting the object.",
     },
     storage_empty_file: {
-        summary: "The Zero storage upload is empty.",
+        summary: "The storage upload is empty.",
         fix: "Upload a file containing at least 1 byte.",
     },
     storage_file_too_large: {
-        summary: "The Zero storage object exceeds the 5 MiB file limit.",
+        summary: "The storage object exceeds the 5 MiB file limit.",
         fix: "Upload a smaller object.",
     },
     storage_key_invalid: {
-        summary: "The Zero storage key is malformed.",
-        fix: "Use the public or private object key returned by storage.upload.",
+        summary: "The storage object id is malformed.",
+        fix: "Use the 32-character object id returned by `storage.upload`.",
     },
     storage_object_not_found: {
-        summary: "The requested Zero storage object does not exist.",
-        fix: "Check the object key or upload the object again.",
+        summary: "The requested storage object does not exist.",
+        fix: "Check the object id or upload the object again.",
     },
     storage_quota_already_unlimited: {
         summary: "The team already has unlimited storage.",
@@ -1215,23 +1167,19 @@ export const ERROR_DOCS = {
     },
     storage_quota_exceeded: {
         summary: "The operation would exceed its storage allowance.",
-        fix: "Delete unused Zero objects or old versions, reduce the upload size, then retry.",
+        fix: "Delete unused storage objects or old versions, reduce the upload size, then retry.",
     },
     storage_unavailable: {
-        summary: "The Zero runtime cannot read or persist object storage.",
-        fix: "Retry on a healthy runtime. Contact support if the failure persists.",
-    },
-    storage_usage_unavailable: {
-        summary: "Storage usage cannot be computed right now.",
-        fix: "Retry shortly.",
+        summary: "The runtime cannot read or persist object storage.",
+        fix: "Retry on a healthy runtime. If the failure persists, contact support.",
     },
     stripe_error: {
         summary: "The billing provider reported an error.",
-        fix: "Retry. If it persists, check the team's billing settings.",
+        fix: "Retry. If the error persists, check the team's billing settings.",
     },
     superseded_by_publish: {
         summary: "A newer publish superseded this operation, so it was skipped.",
-        fix: "No action needed. The newer publish already carries the change.",
+        fix: "No action is needed. The newer publish already carries the change.",
     },
     takeover_notice_window: {
         summary: "The hostname was recently bound elsewhere. A takeover notice window applies.",
@@ -1263,11 +1211,11 @@ export const ERROR_DOCS = {
     },
     template_file_too_large: {
         summary: "A template file exceeds the maximum size for substitution.",
-        fix: "Keep template files under the documented size limit (16 KB).",
+        fix: "Keep template files at or under 16 KB.",
     },
     template_not_in_version: {
         summary: "The configuration names a template file the version does not contain.",
-        fix: "Upload the file or remove its templates entry from sf.jsonc.",
+        fix: "Upload the file or remove its `templates` entry from `sf.jsonc`.",
     },
     template_variable_unresolved: {
         summary: "A template references a variable that has no value.",
@@ -1299,23 +1247,19 @@ export const ERROR_DOCS = {
     },
     theme_value_invalid: {
         summary: "A theme value in the configuration is outside the allowed grammar.",
-        fix: "Use allowed CSS values. The offending key is dropped with a warning otherwise.",
+        fix: "Use allowed CSS values. Otherwise the offending key is dropped with a warning.",
     },
     transfer_cross_tenant_unsupported: {
         summary: "Spaces cannot be transferred across tenants.",
         fix: "Export the space and import it under the target tenant instead.",
     },
-    transfer_move_failed: {
-        summary: "The space move backing this transfer failed.",
-        fix: "Retry the transfer. If it persists, contact support with the transfer id.",
-    },
     transfer_not_cancelable: {
         summary: "The transfer is past the point where it can be canceled.",
         fix: "Wait for the transfer to finish.",
     },
     transfer_push_failed: {
         summary: "The source runtime cannot push the space blobs into the transfer bucket.",
-        fix: "Retry the move. If it persists, check the source runtime and bucket configuration.",
+        fix: "Retry the move. If the failure persists, check the source runtime and bucket configuration.",
     },
     transfer_source_changed: {
         summary: "The space changed since the transfer was created, so it must be re-confirmed.",
@@ -1327,7 +1271,7 @@ export const ERROR_DOCS = {
     },
     transfer_verify_failed: {
         summary: "The target runtime cannot verify transferred blob content.",
-        fix: "Retry the move. If it persists, check the target runtime and bucket integrity.",
+        fix: "Retry the move. If the failure persists, check the target runtime and bucket integrity.",
     },
     unauthorized: {
         summary: "The request carried no valid credential.",
@@ -1355,15 +1299,11 @@ export const ERROR_DOCS = {
     },
     user_banned: {
         summary: "This user is banned for a policy or abuse violation and cannot perform this action.",
-        fix: "Contact support to appeal the ban if you believe it is a mistake.",
+        fix: "If you believe the ban is a mistake, contact support to appeal it.",
     },
     validation_error: {
         summary: "A request field failed validation.",
-        fix: "Fix the field referenced by pointer and details, then retry.",
-    },
-    variable_cascade_failed: {
-        summary: "Republishing spaces after a variable change failed.",
-        fix: "Check the operation's diagnostics. Live content keeps serving the previous values.",
+        fix: "Fix the field referenced by `pointer` and `details`, then retry.",
     },
     verification_required: {
         summary: "Domain verification is required before this operation.",
@@ -1371,7 +1311,7 @@ export const ERROR_DOCS = {
     },
     version_already_live: {
         summary: "The version is already live on this channel.",
-        fix: "No action needed.",
+        fix: "No action is needed.",
     },
     version_artifact_not_found: {
         summary: "The requested version artifact was not found.",
@@ -1415,7 +1355,7 @@ export const ERROR_DOCS = {
     },
     version_in_use: {
         summary: "The version is referenced by one or more channels and cannot be deleted.",
-        fix: "Promote another version on those channels first. Details lists them.",
+        fix: "Promote another version on those channels first. The `details` field lists them.",
     },
     version_live: {
         summary: "The version is live and cannot be deleted.",
@@ -1447,7 +1387,7 @@ export const ERROR_DOCS = {
     },
     version_quota_exceeded: {
         summary: "The space is at its version quota.",
-        fix: "Delete old versions. Still stuck? POST /v1/feedback with the error code and request id.",
+        fix: "Delete old versions. If the quota error persists, `POST /v1/feedback` with the error code and request id.",
     },
     version_total_bytes_exceeded: {
         summary: "The version exceeds the maximum total size.",
@@ -1461,17 +1401,13 @@ export const ERROR_DOCS = {
         summary: "WHOIS data is unavailable for this domain right now.",
         fix: "Retry later.",
     },
-    zero_activating: {
-        summary: "Zero endpoints are activating.",
-        fix: "Wait for the dedicated runtime move to complete, then retry the request.",
-    },
     zero_ai_unavailable: {
         summary: "The local Zero AI service is not configured.",
         fix: "Configure an AI handler in the project, then restart `sf dev` before calling the AI service.",
     },
     zero_artifact_abi_mismatch: {
         summary: "The Zero endpoint artifact was built for a different runner ABI.",
-        fix: `Rebuild and republish the Zero project with the current ${BRAND.productName} CLI and runtime.`,
+        fix: `Rebuild the Zero project with the current ${BRAND.productName} CLI and runtime, then publish it again.`,
     },
     zero_artifact_invalid: {
         summary: "The Zero endpoint artifact is missing required runtime metadata.",
@@ -1491,7 +1427,7 @@ export const ERROR_DOCS = {
     },
     zero_auth_unavailable: {
         summary: "Hosted Zero auth is not configured for this deployment.",
-        fix: "Finalize the Zero version with hosted auth URLs or use guest/local auth.",
+        fix: "Finalize the Zero version with hosted auth URLs, or use guest or local auth.",
     },
     zero_blob_key_invalid: {
         summary: "The local Zero blob key is invalid.",
@@ -1511,15 +1447,15 @@ export const ERROR_DOCS = {
     },
     zero_bootstrap_encode_failed: {
         summary: "The Zero runner cannot encode the JavaScript bootstrap data.",
-        fix: "Retry with valid request metadata. Report the issue if it persists.",
+        fix: "Retry with valid request metadata. If the issue persists, report it.",
     },
     zero_bytecode_hash_mismatch: {
         summary: "The Zero endpoint bytecode hash does not match its artifact metadata.",
-        fix: "Rebuild and republish so bytecode and endpoint metadata are from the same build.",
+        fix: "Rebuild and publish again so bytecode and endpoint metadata are from the same build.",
     },
     zero_bytecode_invalid: {
         summary: "The Zero endpoint bytecode cannot be loaded by QuickJS.",
-        fix: "Rebuild the project with the current Zero runner and redeploy.",
+        fix: "Rebuild the project with the current Zero runner and publish again.",
     },
     zero_bytecode_path_invalid: {
         summary: "The Zero endpoint bytecode path is invalid.",
@@ -1531,7 +1467,7 @@ export const ERROR_DOCS = {
     },
     zero_capabilities_encode_failed: {
         summary: "The runtime cannot encode the Zero endpoint capabilities.",
-        fix: "Rebuild with valid capability metadata. Report the failure if it persists.",
+        fix: "Rebuild with valid capability metadata. If the failure persists, report it.",
     },
     zero_client_bundle_not_loaded: {
         summary: "The local Zero dev client bundle is not generated or loaded.",
@@ -1539,11 +1475,11 @@ export const ERROR_DOCS = {
     },
     zero_db_connect_failed: {
         summary: "The Zero runner cannot connect to the configured database.",
-        fix: "Verify DATABASE_URL or the generated MySQL connection variables and retry.",
+        fix: "Verify `DATABASE_URL` or the generated MySQL connection variables and retry.",
     },
     zero_db_execute_failed: {
         summary: "A Zero database write failed.",
-        fix: "Inspect the mutation, schema, and database logs, then retry after fixing the SQL issue.",
+        fix: "Inspect the mutation, schema, and database logs. Fix the SQL issue, then retry.",
     },
     zero_db_export_cursor_invalid: {
         summary: "The local database export cursor is invalid or belongs to another export.",
@@ -1571,7 +1507,7 @@ export const ERROR_DOCS = {
     },
     zero_db_host_install_failed: {
         summary: "The Zero runner cannot install the database host bridge.",
-        fix: "Rebuild with a current runner and report the failure if it repeats.",
+        fix: "Rebuild with a current runner. If the failure repeats, report it.",
     },
     zero_db_operation_invalid: {
         summary: "The Zero database bridge received an invalid operation payload.",
@@ -1587,7 +1523,7 @@ export const ERROR_DOCS = {
     },
     zero_db_query_failed: {
         summary: "A Zero database read failed.",
-        fix: "Inspect the query, schema, and database logs, then retry after fixing the SQL issue.",
+        fix: "Inspect the query, schema, and database logs. Fix the SQL issue, then retry.",
     },
     zero_db_row_invalid: {
         summary: "A database row cannot be converted into a Zero response value.",
@@ -1603,7 +1539,7 @@ export const ERROR_DOCS = {
     },
     zero_db_transaction_active: {
         summary: "The Zero runner tried to start a database transaction while one was already active.",
-        fix: "Rebuild with the current Zero runner and report the failure if it repeats.",
+        fix: "Rebuild with the current Zero runner. If the failure repeats, report it.",
     },
     zero_db_transaction_commit_failed: {
         summary: "The Zero database transaction cannot be committed.",
@@ -1615,7 +1551,7 @@ export const ERROR_DOCS = {
     },
     zero_db_transaction_missing: {
         summary: "The Zero runner tried to finish a database transaction that was not active.",
-        fix: "Rebuild with the current Zero runner and report the failure if it repeats.",
+        fix: "Rebuild with the current Zero runner. If the failure repeats, report it.",
     },
     zero_db_transaction_rollback_failed: {
         summary: "The Zero database transaction cannot be rolled back cleanly.",
@@ -1635,11 +1571,11 @@ export const ERROR_DOCS = {
     },
     zero_db_url_invalid: {
         summary: "The Zero database URL is malformed.",
-        fix: "Set DATABASE_URL or the generated database variables to a valid MySQL connection URL.",
+        fix: "Set `DATABASE_URL` or the generated database variables to a valid MySQL connection URL.",
     },
     zero_db_url_missing: {
         summary: "No Zero database URL is configured.",
-        fix: "Configure DATABASE_URL or finalize the version with database connection variables.",
+        fix: "Configure `DATABASE_URL` or finalize the version with database connection variables.",
     },
     zero_dev_endpoint_failed: {
         summary: "A local Zero dev endpoint failed while handling the request.",
@@ -1647,7 +1583,7 @@ export const ERROR_DOCS = {
     },
     zero_dump_query_invalid: {
         summary: "The Zero database dump query parameters are invalid.",
-        fix: "Use valid table, limit, and cursor parameters.",
+        fix: "Use valid `table`, `limit`, and `cursor` parameters.",
     },
     zero_endpoint_compile_failed: {
         summary: "The runtime cannot compile the Zero endpoint bytecode.",
@@ -1667,11 +1603,11 @@ export const ERROR_DOCS = {
     },
     zero_endpoint_index_invalid: {
         summary: "The Zero endpoint index does not contain valid endpoint mappings.",
-        fix: "Rebuild and republish the Zero project.",
+        fix: "Rebuild the Zero project and publish it again.",
     },
     zero_endpoint_index_malformed: {
         summary: "The Zero endpoint index cannot be parsed.",
-        fix: "Rebuild the generated endpoint index and redeploy.",
+        fix: "Rebuild the generated endpoint index and publish again.",
     },
     zero_endpoint_index_path_invalid: {
         summary: "The Zero endpoint index path is invalid.",
@@ -1679,7 +1615,7 @@ export const ERROR_DOCS = {
     },
     zero_endpoint_index_unreadable: {
         summary: "The Zero endpoint index cannot be read.",
-        fix: "Verify the version finalized with zero/endpoints-index.json present.",
+        fix: "Verify the version finalized with `zero/endpoints-index.json` present.",
     },
     zero_endpoint_invalid: {
         summary: "A Zero endpoint definition or its database metadata is invalid.",
@@ -1687,7 +1623,7 @@ export const ERROR_DOCS = {
     },
     zero_endpoint_mismatch: {
         summary: "The requested Zero endpoint does not match the endpoint artifact.",
-        fix: "Rebuild routes and artifacts together and redeploy the version.",
+        fix: "Rebuild routes and artifacts together, then publish the version again.",
     },
     zero_endpoint_not_found: {
         summary: "No Zero endpoint artifact exists for this endpoint id.",
@@ -1701,13 +1637,9 @@ export const ERROR_DOCS = {
         summary: "The Zero endpoints payload exceeds the supported endpoint count.",
         fix: "Reduce the project to at most 128 Zero endpoints, then publish again.",
     },
-    zero_requires_dedicated_plan: {
-        summary: "Zero endpoints require a plan with dedicated runtime isolation.",
-        fix: "Upgrade the team to a plan that includes Zero and dedicated runtime, then publish again.",
-    },
     zero_envelope_encode_failed: {
         summary: "The PHP bridge cannot encode the Zero runner request envelope.",
-        fix: "Retry with valid request data. Report the issue if it persists.",
+        fix: "Retry with valid request data. If the issue persists, report it.",
     },
     zero_js_context_init_failed: {
         summary: "The Zero runner cannot initialize a QuickJS context.",
@@ -1723,11 +1655,11 @@ export const ERROR_DOCS = {
     },
     zero_js_globals_failed: {
         summary: "The Zero runner cannot install runtime globals for the endpoint.",
-        fix: "Rebuild with a current runner and report the failure if it repeats.",
+        fix: "Rebuild with a current runner. If the failure repeats, report it.",
     },
     zero_js_response_malformed: {
         summary: "The Zero endpoint returned a malformed runner response.",
-        fix: "Return a valid Response or supported Zero handler result.",
+        fix: "Return a valid `Response` or supported Zero handler result.",
     },
     zero_js_runtime_init_failed: {
         summary: "The Zero runner cannot initialize QuickJS.",
@@ -1735,7 +1667,7 @@ export const ERROR_DOCS = {
     },
     zero_log_query_invalid: {
         summary: "The Zero log query parameters are invalid.",
-        fix: "Use valid cursor, limit, handlerName, and requestId parameters.",
+        fix: "Pass `cursor` exactly as the previous page's `nextCursor`, keep `limit` between 1 and 100, and send `since` and `until` as ISO timestamps.",
     },
     zero_method_not_allowed: {
         summary: "The request method is not allowed for this Zero endpoint.",
@@ -1747,7 +1679,7 @@ export const ERROR_DOCS = {
     },
     zero_query_name_missing: {
         summary: "A Zero realtime query subscription did not include a query name.",
-        fix: "Send a query.subscribe frame with a valid query name.",
+        fix: "Send a `query.subscribe` frame with a valid query name.",
     },
     zero_realtime_forbidden: {
         summary: "The Zero realtime event intake credential is invalid.",
@@ -1759,7 +1691,7 @@ export const ERROR_DOCS = {
     },
     zero_realtime_operation_unsupported: {
         summary: "The Zero realtime websocket operation is unsupported.",
-        fix: "Use a supported Zero realtime operation such as query.subscribe or query.unsubscribe.",
+        fix: "Use a supported Zero realtime operation such as `query.subscribe` or `query.unsubscribe`.",
     },
     zero_realtime_query_invalid: {
         summary: "The Zero realtime query subscription payload is invalid.",
@@ -1767,7 +1699,7 @@ export const ERROR_DOCS = {
     },
     zero_realtime_space_required: {
         summary: "The Zero realtime request does not identify a space.",
-        fix: "Use a /spaces/{spaceId} realtime URL or include a valid spaceId query parameter.",
+        fix: "Use a `/spaces/{spaceId}` realtime URL or include a valid `spaceId` query parameter.",
     },
     zero_realtime_unavailable: {
         summary: "Zero realtime helpers are unavailable for this endpoint.",
@@ -1779,11 +1711,11 @@ export const ERROR_DOCS = {
     },
     zero_replay_failed: {
         summary: "The hosted Zero runtime cannot fetch realtime replay events.",
-        fix: "Retry shortly. Check the central realtime and control-plane logs if it persists.",
+        fix: "Retry shortly. If the failure persists, check the central realtime and control-plane logs.",
     },
     zero_replay_query_invalid: {
         summary: "The hosted Zero realtime replay query is invalid.",
-        fix: "Use a valid afterEventId cursor and numeric limit.",
+        fix: "Use a valid `afterEventId` cursor and numeric limit.",
     },
     zero_replay_unavailable: {
         summary: "Realtime replay is not configured for this Zero version.",
@@ -1791,7 +1723,7 @@ export const ERROR_DOCS = {
     },
     zero_request_body_too_large: {
         summary: "The Zero request body exceeds the runtime size limit.",
-        fix: "Send a smaller request body or move large payloads to blob/object storage.",
+        fix: "Send a smaller request body or move large payloads to blob or object storage.",
     },
     zero_response_header_forbidden: {
         summary: "A Zero endpoint attempted to set a platform-managed response header.",
@@ -1827,7 +1759,7 @@ export const ERROR_DOCS = {
     },
     zero_runner_envelope_invalid: {
         summary: "The Zero runner request envelope is malformed.",
-        fix: "Use the generated runtime bridge and redeploy if generated files are stale.",
+        fix: "Use the generated runtime bridge. If generated files are stale, publish again.",
     },
     zero_runner_failed: {
         summary: "The Zero runner process exited without a valid response.",
@@ -1839,15 +1771,15 @@ export const ERROR_DOCS = {
     },
     zero_runner_invalid_response: {
         summary: "The Zero runner output was not valid JSON.",
-        fix: "Inspect runner stderr and rebuild the runner if the failure persists.",
+        fix: "Inspect runner stderr. If the failure persists, rebuild the runner.",
     },
     zero_runner_invalid_status: {
         summary: "The Zero runner returned an invalid HTTP status.",
-        fix: "Ensure endpoint handlers return a status between 100 and 599.",
+        fix: "Return a status between 100 and 599 from endpoint handlers.",
     },
     zero_runner_protocol_unsupported: {
         summary: "The Zero runner received an unsupported invoke protocol.",
-        fix: "Rebuild and redeploy so the PHP bridge and Rust runner versions match.",
+        fix: "Rebuild and publish again so the PHP bridge and Rust runner versions match.",
     },
     zero_runner_response_encode_failed: {
         summary: "The Zero runner cannot encode its response.",
@@ -1855,7 +1787,7 @@ export const ERROR_DOCS = {
     },
     zero_runner_stdin_invalid: {
         summary: "The Zero runner cannot read its request envelope.",
-        fix: "Retry. Report the runtime bridge failure if it persists.",
+        fix: "Retry. If the runtime bridge failure persists, report it.",
     },
     zero_runner_stdin_too_large: {
         summary: "The Zero runner request envelope is too large.",
@@ -1877,14 +1809,6 @@ export const ERROR_DOCS = {
         summary: "The Zero run-handler payload exceeds the supported handler count.",
         fix: "Reduce the project to at most 128 Zero run handlers, then publish again.",
     },
-    zero_shopify_unavailable: {
-        summary: "The local Zero Shopify service is not configured.",
-        fix: "Configure a Shopify handler in the project, then restart `sf dev` before calling the Shopify service.",
-    },
-    wp_cloud_anonymous_pool_required: {
-        summary: "This operation requires an anonymous pool site.",
-        fix: "Target a pool-class site.",
-    },
     wp_cloud_assignment_kind_mismatch: {
         summary: "The domain assignment's kind does not match the site.",
         fix: "Verify the assignment against the site's hosting kind.",