If ns doctor reports a clean environment and you encounter a runtime exception, consult the common triage patterns below.
Fingerprint Mismatch (E001)
Two objects that should carry identical fingerprints produced different digests. Common cause: In-place model state mutations or variable modifications after initializing the scope.
terminal
bash
$python -c 'import neuronscope as ns; ns.fingerprint_diff(a, b).print()'model.layers.0.bias: weights differUnknown Adapter (E002)
An unsupported framework object was passed into ns.Scope without installing matching platform extras.
terminal
bash
$pip install "neuronscope[all]==0.9.2"Probe Glob Mismatch (E003)
Probe selector expression resolved to 0 matching layers. Verify active module paths:
terminal
bash
$python -c 'import neuronscope as ns; scope=ns.Scope("test"); print(scope.selected_modules())'Hallucination / Policy Error (E4002)
An evaluation pipeline or CI deployment gate failed due to hallucination rate exceeding governance policy limits (>2%). Inspect retrieved context and prompt variables.