v0.20.1 - Fix poll_count defaults for noisy detector (2026-06-01)¶
What Changed?¶
This release fixes the default poll_count values to work correctly with noisy OSECHI detectors during threshold scans.
The previous defaults (100 for CLI, 25000 for MeasureConfig) were too large for reliable threshold scanning under high-noise conditions.
Both defaults are now set to 10.
What's New¶
Fix: Lower poll_count defaults for threshold scanning¶
What it does: Reduces the default number of events polled per cycle to 10, ensuring threshold scans complete reliably even when the detector is noisy.
How to use it:
No changes needed — the fix takes effect automatically when --poll-count is not specified.
Code example(if relevant):
# MeasureConfig now defaults to poll_count=10
config = MeasureConfig(thresholds={1: 300, 2: 300, 3: 300})
print(config.poll_count) # 10
Installation¶
Quick Start¶
# Get the release
git checkout v0.20.1
# Setup
uv sync
# Run CLI
uv run kazunoko --help
What's Different from the Last Version?¶
🐛 Fixed¶
Options.poll_count(): default changed from100to10to prevent threshold scans from stalling on noisy detectorsMeasureConfig.poll_count: default changed from25000to10for the same reason
Is It Safe to Upgrade?¶
Backward Compatible: Yes
- Users who explicitly pass
--poll-countor setpoll_count=inMeasureConfigare unaffected. - Users relying on the previous defaults will see fewer events polled per cycle by default, which is the intended behavior for threshold scanning.
Tests Passed¶
- ✅ Builds without errors
- ✅
Options.poll_count()returns 10 when no default is passed - ✅
MeasureConfig()initializes withpoll_count=10
Release Details¶
- Date: 2026-06-01
- Version: v0.20.1
- Files Changed: 2
- Commits: 8744fee, 380d9dc
Next Steps¶
Continue tuning default parameters for reliable operation with noisy OSECHI detectors.