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

Install and first run

A meld cannot find a named registration

Spellframe, binding name, and whether the target is a human name or explicit ID

Address law

A second bind or conjure is refused

Existing registration and the one-root-per-book rule

Errors

Identical bindings collide across worlds

Process-wide spell identity; the frame is not part of that distinction

World boundaries

Constructor configuration seems ignored

Bind parameters versus meld overrides or a configured factory

Flat overrides

Configuration edits fail

Defaults/set-once properties and whether conjure froze the object

Configuration

A child scope retains memory

The actual owner and whether its cleanup ran

Scopes that end

A linked borrower cannot resolve a spell

Both roots exist, the borrower pulled from the actual owner, and permissions fit

Links and permissions

A late-bound constructor still has a descriptor

Complete provider โ†’ consumer โ†’ link โ†’ pull โ†’ meld for each edge

Connected systems

A cluster reports no creations store

Linking, membership, and leader election order

Clusters

An override is refused or affects later calls

Match count/path grammar and the target's lifetime

Deep overrides

A Rift cannot attach to a frame

Observer policy, frame posture, descriptor publication, and target budget

Agent room setup

Viewer fields seem missing

Selected frame and visible versus withheld sections

Viewer reads

Codegen returns a rejected result

Validation issues, execution errors, and the explicit target frame

Codegen

Research appears unavailable

Root activation, custody setup, and the selected record/set

Research

A clean flush has no remote copy

Store wiring, failure counters, and remote delivery policy

External storage

Restore refuses before building

Complete chain, source drift, collisions, and the admission report

Restore

A research join refuses

Anchor, receiver tip, and whether a supersede is actually intended

Governed change

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.