Operator manual · diagnostics
Troubleshooting
| Symptom | Check |
|---|---|
| Manifest signature verification failed | Confirm exact manifest bytes/schema, active verification method, key status, canonicalization and whether the manifest belongs to the intended Entity state. |
| BTDU mutation denied | Verify the authorization receipt is signed by the configured sovereign Entity and has BTDU_WRITE scope. |
| BTDU/ADAM import error | Confirm --adam-root/ENTITY_ADAM_V1_ROOT points to the qualified ADAM runtime and its dependencies are present. |
| Different reconstruction hash | Stop. Compare object reference, exact compound, chunk/order metadata and source SHA-256. Do not continue qualification with unexplained mismatch. |
| Repository manifest differs | Confirm the same immutable Git commit/tree, tracked-file set, line-ending state and exclusion rules were used. |
| Passport fails after profile update | Resolve the exact historical profile version referenced by the passport; do not apply current profile semantics retroactively. |
| Recovery produced a new Entity ID | The operation did not preserve identity continuity. Restore the correct manifest/recovery material rather than accepting a newly created root. |
| Tests skipped | Read the skip reason. Environment-gated tests are not passes; supply the required ADAM/hardware/multi-host/external environment where applicable. |
Report reproducibly
Include release/tag, commit, OS/runtime, exact command, expected result, actual result, relevant hashes/roots and sanitized logs. Never attach private keys, recovery secrets or unredacted production data.