LightStim known pitfalls, bugs, and non-obvious API contracts. Read this whenever a build produces unexpected results, the tracker raises a RuntimeError, noiseless-check detections appear, LER is suspiciously high, or the user reports "it was working and now it isn't." Each entry states the symptom, the root cause, and the fix pattern.
