@spacefast/common 0.0.24 → 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.",
@@ -54,8 +54,8 @@ export const ERROR_DOCS = {
         fix: "Wait for the window to pass, or sign in with an API key for higher limits.",
     },
     anonymous_space_limit_reached: {
-        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.",
+        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.",
@@ -79,7 +79,7 @@ export const ERROR_DOCS = {
     },
     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.",
@@ -101,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).",
@@ -111,7 +115,7 @@ export const ERROR_DOCS = {
     },
     blob_gate_record_missing: {
         summary: "The file behind this download link no longer exists.",
-        fix: "Ask the owner for a fresh link; the underlying object was deleted.",
+        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.",
@@ -139,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.",
@@ -147,7 +151,7 @@ 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.",
@@ -155,7 +159,7 @@ export const ERROR_DOCS = {
     },
     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.",
@@ -175,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.",
@@ -183,11 +187,11 @@ 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 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. Still stuck? POST /v1/feedback with the error code and request id.",
+        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 space key was already exchanged for a durable API key.",
@@ -199,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.",
@@ -231,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.",
@@ -243,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.",
@@ -251,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.",
@@ -323,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.",
@@ -331,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.",
@@ -403,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.",
@@ -439,7 +443,7 @@ 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.",
@@ -447,7 +451,7 @@ export const ERROR_DOCS = {
     },
     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.",
@@ -459,11 +463,11 @@ 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.",
+        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.",
@@ -475,7 +479,7 @@ export const ERROR_DOCS = {
     },
     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.",
@@ -483,7 +487,7 @@ 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 space key is invalid or does not match this space.",
@@ -507,7 +511,7 @@ 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.",
@@ -551,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.",
@@ -595,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.",
@@ -635,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.",
@@ -647,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.",
@@ -667,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.",
@@ -683,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.",
@@ -691,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.",
@@ -707,11 +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.',
+        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.",
@@ -721,9 +725,13 @@ 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.",
+        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.",
@@ -731,11 +739,11 @@ export const ERROR_DOCS = {
     },
     promote_admission_exceeded: {
         summary: "Too many archived files are being restored for this space right now.",
-        fix: "Retry shortly; restores are limited to protect the host.",
+        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.",
@@ -743,35 +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: "The hosting provider does not grant this client permission to change the setting.",
+        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; declared uploads are kept for 24 hours only.",
+        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.",
@@ -787,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.",
@@ -795,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.",
@@ -815,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.",
@@ -827,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.",
@@ -851,7 +859,7 @@ export const ERROR_DOCS = {
     },
     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.",
+        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.",
@@ -867,15 +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 (error.details.assignedToUserId) to release it.",
+        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.",
@@ -883,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.",
@@ -891,19 +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.",
+        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.",
@@ -915,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.",
@@ -923,7 +931,7 @@ 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.",
@@ -931,7 +939,11 @@ export const ERROR_DOCS = {
     },
     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.",
+        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.",
@@ -939,7 +951,7 @@ export const ERROR_DOCS = {
     },
     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.",
@@ -951,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.",
@@ -963,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.",
@@ -971,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.",
@@ -979,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.",
@@ -1027,7 +1039,7 @@ 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 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.",
+        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.",
@@ -1035,15 +1047,15 @@ export const ERROR_DOCS = {
     },
     space_claimed_credential_available: {
         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 (e.g. .spacefast/state.json), then retry the request with it as Authorization: Bearer. Do not publish a new space.",
+        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.",
@@ -1063,7 +1075,7 @@ export const ERROR_DOCS = {
     },
     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.",
@@ -1083,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.",
@@ -1139,7 +1151,7 @@ export const ERROR_DOCS = {
     },
     storage_key_invalid: {
         summary: "The storage object id is malformed.",
-        fix: "Use the 32-character object id returned by storage.upload.",
+        fix: "Use the 32-character object id returned by `storage.upload`.",
     },
     storage_object_not_found: {
         summary: "The requested storage object does not exist.",
@@ -1159,15 +1171,15 @@ export const ERROR_DOCS = {
     },
     storage_unavailable: {
         summary: "The runtime cannot read or persist object storage.",
-        fix: "Retry on a healthy runtime. Contact support if the failure persists.",
+        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.",
@@ -1199,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.",
@@ -1235,7 +1247,7 @@ 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.",
@@ -1247,7 +1259,7 @@ export const ERROR_DOCS = {
     },
     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.",
@@ -1259,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.",
@@ -1287,11 +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.",
+        fix: "Fix the field referenced by `pointer` and `details`, then retry.",
     },
     verification_required: {
         summary: "Domain verification is required before this operation.",
@@ -1299,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.",
@@ -1343,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.",
@@ -1375,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.",
@@ -1395,7 +1407,7 @@ export const ERROR_DOCS = {
     },
     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.",
@@ -1415,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.",
@@ -1435,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.",
@@ -1455,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.",
@@ -1463,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.",
@@ -1495,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.",
@@ -1511,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.",
@@ -1527,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.",
@@ -1539,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.",
@@ -1559,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.",
@@ -1571,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.",
@@ -1591,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.",
@@ -1603,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.",
@@ -1611,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.",
@@ -1627,7 +1639,7 @@ export const ERROR_DOCS = {
     },
     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.",
@@ -1643,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.",
@@ -1655,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.",
@@ -1667,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.",
@@ -1679,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.",
@@ -1687,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.",
@@ -1699,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.",
@@ -1711,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.",
@@ -1747,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.",
@@ -1759,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.",
@@ -1775,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.",