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. (The building blocks landed in v0.3–0.5: states masks + per-mask summaries; the remaining work is plumbing them through analyze.)
Standard ratings & global indices (v0.5.0) — NR/NC/RC room criteria, intermittency ratio + emergence, the ecoacoustic battery (ACI, ADI/AEI, NDSI, BI, entropy H), EDT/C50/C80/D50, and spatial descriptors (directional entropy, horizon fractions, fg/bg direction overlap) appended to every analyze summary.
Catalog aggregation (v0.7.0) — ambiscape catalog collects all summary.json files in a corpus into one CSV + transposed Markdown table, with rank/outliers helpers 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 (v0.6.0) — species-level biophony on hi-fi windows (ml.birdnet_session, gated by diffuseness), optional [ml] companion to PANNs, plus a cache-based biophony module (narrowband activity, temporal entropy, band activity, spatial dispersion) for corpus-wide structural biophony without ML.
CLAP zero-shot search — free-text queries ("compressor hum", "door slam") across a corpus's cached features/excerpts.