Saphan StudioDocs
Troubleshooting

What is not yet explained

The 145 refusal classes this section names but does not yet resolve, listed in full with a count.

145 of the product's 191 declared refusal classes are named here and not yet resolved. This page is the complete list.

Why this page exists

We would rather publish a short honest section than a long confident one. Every class below is real, deliberate, and named — if you are holding one, you are looking at a check that ran and answered, not at a crash. What is missing is only the written answer to what to do next.

⛔ We will not publish a remedy we cannot support. A wrong instruction on a page like this sends someone to do something harmful and costs the trust the page exists to earn. The classes below are the ones where the honest answer today is "we have not written that down yet".

What to do if you are holding one of these

  1. Read what the refusal itself printed. Many refusals in this product print their own remedy with your values already filled in — the class name is the index, not the whole message.
  2. Check the family page. Each class below has a one-line entry on its family page saying what its name indicates. That is often enough to tell you which of your own settings is in question.
  3. Ask us, and quote the class. A class name is the fastest possible support request: it tells us exactly which check refused. Every request against one of these names is what moves it onto an explained page.

The list

Counts below are not yet explained out of the family's total.

Identity and actors — 24 of 33

actor-registry-absent · actor-registry-unreadable · actor-registry-unwired · actor-retired · ceremony-capture-mismatch · ceremony-intermediate-exists · ceremony-restore-no-presence · ceremony-restore-out-dir · ceremony-restore-pin-mismatch · ceremony-restore-pin-unknown · ceremony-restore-record-mismatch · ceremony-restore-unknown-word · ceremony-restore-word-count · custody-loose-perms · custody-malformed-secret · no-identity · scope-denied · server-cert-key-exists · server-cert-no-san · server-cert-ttl-required · session-actor-key-absent · token-unmapped · trust-key-exists · trust-refused

Machines and seats — 44 of 49

artifact-root-inside-repository · artifact-root-not-declared · artifact-root-unmeasured · machine-account-near-miss · machine-account-not-seated · machine-account-value-refused · machine-already-admitted · machine-already-retired · machine-artifact-root-invalid · machine-cert-expired · machine-device-cert-not-persisted · machine-gomodcache-root-invalid · machine-invalid-csr · machine-not-admitted · machine-pin-not-ssh · machine-pin-operator-entry-missing · machine-pin-revoked · machine-pin-ssh-host-missing · machine-price-invalid · machine-price-no-change · machine-renew-no-change · machine-retire-live-run · machine-retire-seated · machine-seat-backend-not-seatable · machine-seat-backend-unknown · machine-seat-cast-path-invalid · machine-seat-config-dir-on-lane-backend · machine-seat-cross-machine-move · machine-seat-lane-on-config-dir-backend · machine-seat-lane-required · machine-seat-profile-shared · machine-seat-role-unknown · machine-seat-slot-occupied · machine-seat-slot-out-of-range · machine-set-binary-invalid-pair · machine-slots-below-seated · machine-slots-invalid · machine-slots-no-change · machine-ssh-key-required · machine-ssh-key-unverified · machine-transport-required · machine-unseat-live-run · machine-unseat-not-seated-here · machine-worktrees-root-invalid

Dispatch and capacity — 17 of 21

cli-backend-not-interactive · cli-binary-unexecutable · cli-binary-unregistered · cli-interactive-flag-conflict · cli-profile-home-unresolved · cli-registry-unreadable · cli-role-mismatch · cli-seat-not-local · cli-seat-retired · cli-seat-unknown · cli-session-record-unreadable · cli-shell-not-installed · gateway-mtls-listen-not-served · result-too-large · routing-refusal · serverd-already-running · toolchain-unavailable

⚠ The dispatch refusals an operator meets most name a routing rule rather than one of these classes, and those are explained on the family page.

The record and gates — 35 of 37

access-log-unwritable · bridge-commit-refused · capture-invalid · closure-collect-incomplete · closure-collect-unreadable · closure-evidence-not-persisted · closure-persist-uncontained · closure-persist-unverified · closure-place-is-a-main-repository · closure-place-not-a-worktree · closure-place-not-owned · closure-place-unmeasured · closure-removal-incomplete · closure-removal-refused · closure-transport-unreachable · config-init-incomplete · forge-not-configured · gate-is-stale · init-collision · memory-carry-refused · merge-preconditions · merged-tree-does-not-build · pr-merge-act-failed · pr-merge-claimed-by-another-actor · pr-merge-in-flight · pr-merge-preconditions · pr-stale-head · pr-unknown · structural-bounce · teardown-archive · teardown-provisioned-unresolvable · teardown-worktree-unknown · unknown-capture · unknown-stream · unknown-workspace

The network path — 0 of 19

None — every class in this family is explained on its page.

The console — 17 of 21

cert-format-ambiguous · console-act-no-session-actor · console-act-not-a-gate-write · console-batch-duplicate-stream · console-batch-empty · console-batch-ground-absent · console-batch-no-preview · console-batch-unaccounted · console-certificate-absent · console-certificate-issuer-absent · console-certificate-unreadable · console-seat-profile-dir-not-derived · trust-fingerprint-mismatch · trust-host-required · trust-host-unreachable · trust-keychain-refused · trust-not-macos

Documents and contracts — 8 of 11

order-bytes-truncated · order-digest-mismatch · order-expired · order-ref-ambiguous · order-revoked · order-superseded · schema-ahead · schema-behind

The arithmetic

24 + 44 + 17 + 35 + 0 + 17 + 8 = 145, out of 191. The other 46 are explained on the family pages, and all 191 are listed on Every refusal class, A to Z.