breakpoint-kcl

Point Breakpoint at a parametric KCL part. It probes Zoo's cloud geometry engine to map where each numeric parameter builds correctly, where the engine errors, and where it silently produces wrong geometry. It bisects observed transitions between those zones and exports a self-contained side-by-side failing/passing repro bundle for confirmed findings. It does not exhaustively prove every value in a range.

npm install -g breakpoint-kcl
breakpoint doctor                 # check zoo CLI, auth, credits (free)
breakpoint probe part.kcl         # sweep the first parameter
breakpoint probe part.kcl --mesh-samples 3  # include capped topology checks
breakpoint repro part.kcl --param radius --at 10.005  # control + confirm + reduce
breakpoint bundle runs/<run-id>   # list confirmed finding ids
breakpoint reduce runs/<run-id> <id> --max-probes 80
breakpoint ui                     # the browser workbench

reduce repeatedly checks the nearest passing value and the failing value against the live engine. A completed reduction is 1-minimal at top-level-unit granularity; budget-limited reductions are explicitly labeled partial.

repro is the direct path for a value you already know is bad. It keeps that value in the scan, finds or accepts (--control) a passing side, confirms the A/B predicate, samples mesh closure with a cap of 3 by default, and writes the reduced bundle. A general probe only samples meshes when --mesh-samples <n> is supplied. Topology bundles include probe-bound, SHA-verified pass.glb and fail.glb evidence. An export that produces no artifact is reported as inconclusive rather than guessed.

Requires Node 20+ and the Zoo CLI on PATH. breakpoint doctor prints the install command for your platform. Breakpoint never reads ZOO_API_TOKEN; the spawned zoo CLI authenticates itself.

Full documentation, the user guide, and the proof transcripts live in the repository.