hs-xdocs
HS-X on GitHub
Reference · Error codes

HSX_E_LINK_PREFLIGHT_STATE_CORRUPT

Link preflight: tenant install state is corrupt.

What this error means

An owner-meta, binding, or deploy record in the tenant state KV exists but does not parse, or contradicts its own storage key. Link made no changes.

When this error stops a command, hs-x exits with code 10. With --json, the failure is reported as a structured error whose code field is HSX_E_LINK_PREFLIGHT_STATE_CORRUPT — stable to match on in scripts and agents.

Likely causes

  • A tenant-state KV record was hand-edited or truncated
  • A partial write from an interrupted deploy or an older CLI version

How to fix it

  • Inspect the record named in the error in the tenant state KV namespace
  • Re-run hs-x deploy to rewrite the binding records, then re-run hs-x link

Still stuck? Re-run the command with --debug for the wire-level detail, or hs-x doctor to check accounts, link state, and connectivity in one pass.

Keep going