Roadmap

Moved from the README so it can evolve without commits. Roughly ordered.

Near term

State-resolved descriptors — split multi-state sessions (machine on/off, day/night) before computing summary rows, so a night under a drone and a quiet morning stop averaging into one number.
Catalog aggregation — a catalog command collecting all summary.json files in a corpus into one CSV for cross-session statistics.
Tests + CI — 26 pytest tests over a synthetic AmbiX fixture (BWF writer, plane waves, diffuse noise, phase-locked synthetic swinging bells); GitHub Actions on Python 3.10/3.12 (v0.2.0).

Cyclic-machine detector — landed in v0.3.0 as the states module (band_level, state_segments, switch_points, duty_cycle) plus background.source_fingerprint for the on-state spectrum. Field validation: the Haarlem-loft case study (air-pump night states, fridge ~24 min duty cycle).
Tonal-event finder — landed as the rhythm module (strike detection from partial envelopes, point-process periodicity, phase clusters, repetition-vs-variation stats). Civic-schedule matching landed in v0.3.0 as schedule.grid_scan (targeted per-tick scans) alongside schedule.match_periods.
Wind/handling detector for outdoor takes (LF coherence between channels is the usual tell).
Environmental-rhythm metric — a defensible single figure (or small vector) built from envelope power spectra at minute-to-hour scales, duty cycles, and state-alternation periods. Research question as much as feature.

AEM export adapter — write ambiviz-compatible AEM .npz for a selected excerpt so the hand-off needs no glue code.
BirdNET hook — species-level biophony on hi-fi windows, as an optional [ml] companion to PANNs.
CLAP zero-shot search — free-text queries ("compressor hum", "door slam") across a corpus's cached features/excerpts.