Skip to content

v0.19.0 - Threshold Scan Summary (2026-03-18)

What Changed?

This release adds per-run scan summary recording to get_thresholds.py. After each measurement run, a JSONL record is appended to thresholds_scanned.jsonl in the output directory. The summary format is consistent with the event JSONL format produced by kazunoko measure.

What's New

Main Feature: thresholds_scanned.jsonl output

What it does: Records one JSONL line per measurement run during a threshold scan session. Each record contains the threshold settings, event count, device metadata, and timestamp.

How to use it:

# Run threshold scan (summary file is created automatically)
uv run get_thresholds.py "1:300;2:320;3:310" 100 1 --nsteps 10 --step-size 1

# Overwrite existing summary file
uv run get_thresholds.py "1:300;2:320;3:310" 100 1 --overwrite

Output file: YYYY-MM-DD/thresholds_scanned.jsonl

Record format:

{"type": "threshold", "status": "ok", "timestamp": "2026-03-18T12:00:00+09:00", "file_id": 0, "events": 38, "threshold1": 285, "threshold2": 1000, "threshold3": 1000, "mac_address": "aabbccddeeff", "kurikintons": "1.0.0", "kazunoko": "0.19.0"}

Installation

Quick Start

# Get the release
git checkout v0.19.0

# Setup
task env:setup

# Run CLI
uv run kazunoko --help

What's Different from the Last Version?

✅ Added

  • get_thresholds.py: write per-run scan summary to thresholds_scanned.jsonl after each measurement run
  • get_thresholds.py: --overwrite option to protect existing summary files
  • Summary record fields: type, status, timestamp, file_id, events, threshold1, threshold2, threshold3, mac_address, kurikintons, kazunoko

🔧 Changed

  • get_thresholds.py: scan_serial(), scan_parallel(), _measure_threshold() accept summary_path argument

Is It Safe to Upgrade?

Backward Compatible: Yes

  • Existing scripts and workflows are unaffected
  • thresholds_scanned.jsonl is created automatically; no configuration required

Tests Passed

  • ✅ Builds without errors
  • ✅ --mock mode generates thresholds_scanned.jsonl with correct records
  • ✅ --overwrite prevents accidental overwrite of existing summary files

Release Details

  • Date: 2026-03-18
  • Version: v0.19.0
  • Files Changed: 1
  • Commits: c7bbfab, 80bfd9d, c037a11, efcfc51, 3062c5f

Next Steps

  • fit_thresholds.py support for reading thresholds_scanned.jsonl