On this page
Troubleshooting by symptom๏
Start with the operation that refused and the boundary named by its error. Keep the complete exception or report while diagnosing; an empty result, unavailable surface, and denied operation can mean different things.
Symptom |
Check |
Next step |
|---|---|---|
Import warns about Python or the GIL |
The interpreter selected by your shell or environment |
|
A meld cannot find a named registration |
Spellframe, binding name, and whether the target is a human name or explicit ID |
|
A second bind or conjure is refused |
Existing registration and the one-root-per-book rule |
|
Identical bindings collide across worlds |
Process-wide spell identity; the frame is not part of that distinction |
|
Constructor configuration seems ignored |
Bind parameters versus meld overrides or a configured factory |
|
Configuration edits fail |
Defaults/set-once properties and whether conjure froze the object |
|
A child scope retains memory |
The actual owner and whether its cleanup ran |
|
A linked borrower cannot resolve a spell |
Both roots exist, the borrower pulled from the actual owner, and permissions fit |
|
A late-bound constructor still has a descriptor |
Complete provider โ consumer โ link โ pull โ meld for each edge |
|
A cluster reports no creations store |
Linking, membership, and leader election order |
|
An override is refused or affects later calls |
Match count/path grammar and the target's lifetime |
|
A Rift cannot attach to a frame |
Observer policy, frame posture, descriptor publication, and target budget |
|
Viewer fields seem missing |
Selected frame and visible versus withheld sections |
|
Codegen returns a rejected result |
Validation issues, execution errors, and the explicit target frame |
|
Research appears unavailable |
Root activation, custody setup, and the selected record/set |
|
A clean flush has no remote copy |
Store wiring, failure counters, and remote delivery policy |
|
Restore refuses before building |
Complete chain, source drift, collisions, and the admission report |
|
A research join refuses |
Anchor, receiver tip, and whether a supersede is actually intended |
The public error reference describes catchable exception types. Use the complete examples to compare your setup with a small runnable case before changing a larger application.