From 41d921a42a6abf707efcf91ea9f449b384488146 Mon Sep 17 00:00:00 2001
From: jonathan <webmaster@jonathan859.com>
Date: Fri, 12 Jun 2026 11:49:59 +0200
Subject: [PATCH] feat: remove decorative day-timeline SVG, linear highlights
 panel

The user is blind; the day activity timeline (and its hour labels) was
purely visual, non-interactive, and carried no information not already
in the chips/summary. The highlights panel is now linear text and
buttons in reading order: summary line ("N files analysed - M loud
sections"), key-hint note (now always shown, J/K/U/I is the primary
interface), chips toggle, chips.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 CLAUDE.md  |   2 +-
 README.md  |   2 +-
 webui.html | 112 ++++++-----------------------------------------------
 3 files changed, 14 insertions(+), 102 deletions(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index 60cfad9..5cd445e 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -39,7 +39,7 @@ Dependencies: `requests` (streams), `numpy` + `soundfile` (FLAC output and FLAC
 
 `webui.html` (one `<script>` block):
 - Clip review: `clipQueue`/`clipCursor` globals, `playClip()`, `playFileSection()`, `hideClipBar()`; markup is the `#clip-bar` div. The clip label shows the wall-clock occurrence time + queue position (`03:46:20 to 03:46:22 (73 / 187)`): queue entries carry `absStart` (epoch s), derived from `fileStartEpoch(f.date)` — the filename clock — with in-file offsets as fallback for non-standard names; filename/score live in the label tooltip.
-- Day review: `dayHighlights()` builds `dayActiveSections` (chronological); `jumpToDaySection()` arms the queue. The day timeline positions files by `fileStartEpoch(f.date)` (filename clock), mtime−duration only as fallback. Axis labels are round wall-clock hours (absolutely-positioned spans in `.day-tl-labels`, tick rects in the SVG; falls back to start/end when <2 round hours fit) — not start/mid/end, which read as arbitrary. Chip lists longer than 12 are collapsed behind an `aria-expanded` toggle button (the `.chips[hidden]{display:none}` rule is required — the author-level `display:flex` on `.chips` would otherwise override the UA `[hidden]` rule). Group `aria-label`s stay short ("Day loud sections") — the J/K/U/I key explanation lives only in the visible note, per user feedback against repeating info text in labels. The Highlights button is a collapse/expand toggle (`setHlExpanded()` keeps arrow + `aria-expanded` in sync, also from the day-collapse path): a built panel is kept and re-armed from `dayHlSections` instead of recomputing, keyed by `hlRow.dataset.loaded = hlParams()` (margin|gap|minDur string) so changed params force a re-run. The `#dayhls-<dayId>` "· analysed" suffix appears when every file's `cached_analysis` passes `cachedParamsMatch()`; `fetchAnalysis()` updates `f.cached_analysis` client-side so the marker survives re-renders without refetching `/api/files`.
+- Day review: `dayHighlights()` builds `dayActiveSections` (chronological); `jumpToDaySection()` arms the queue. Section `absStart` comes from `fileStartEpoch(f.date)` (filename clock), mtime−duration only as fallback. **The user is blind and uses a screen reader — there is deliberately no day-timeline SVG** (one existed and was removed on request as useless); the highlights panel is linear text/buttons: summary line → key-hint note → chips toggle → chips. Do not add decorative visualizations; any future graphic must be aria-hidden and must not be the only carrier of information. Chip lists longer than 12 are collapsed behind an `aria-expanded` toggle button (the `.chips[hidden]{display:none}` rule is required — the author-level `display:flex` on `.chips` would otherwise override the UA `[hidden]` rule). Group `aria-label`s stay short ("Day loud sections") — the J/K/U/I key explanation lives only in the visible note, per user feedback against repeating info text in labels. The Highlights button is a collapse/expand toggle (`setHlExpanded()` keeps arrow + `aria-expanded` in sync, also from the day-collapse path): a built panel is kept and re-armed from `dayHlSections` instead of recomputing, keyed by `hlRow.dataset.loaded = hlParams()` (margin|gap|minDur string) so changed params force a re-run. The `#dayhls-<dayId>` "· analysed" suffix appears when every file's `cached_analysis` passes `cachedParamsMatch()`; `fetchAnalysis()` updates `f.cached_analysis` client-side so the marker survives re-renders without refetching `/api/files`.
 - J/K/U/I/O: single document-level `keydown` listener — clip queue takes priority, in-player `currentTime` stepping is the fallback when no queue is armed; O calls `openClipInFile()` (shared with the "Open in file" button). J/K (and Prev/Next) always step in time order; U/I walk the loudest-first ranking from `scoreOrder()` — no top-N cutoff (the `#clip-top` input and `#clip-hl-only` checkbox were removed deliberately; J/K must never be affected by an auto-advance/highlights setting). Auto-advance is the `input[name="clip-adv"]` radio (off / next in time / next by loudness), read by `advanceMode()`; `stepClip(dir, byScore)` is the shared queue-stepping path. In-player U/I anchor the ranking on the section under the playhead, else start at the loudest.
 - Analysis: `fetchAnalysis()` (session `analysisCache`), `analyse()` (per-row render), `cachedParamsMatch()` (autoload guard).
 
diff --git a/README.md b/README.md
index 5d41249..f101b18 100644
--- a/README.md
+++ b/README.md
@@ -154,7 +154,7 @@ The browser UI (HTML/CSS/JS) lives in `webui.html`, which `web.py` loads at star
 Shows recordings grouped by day with collapsible sections. Features:
 
 - **Day groups** — recordings are grouped under a collapsible day heading showing date, file count, total duration, and total size. The most recent day is expanded by default; older days start collapsed. Expanded state is preserved across filter changes.
-- **Day highlights** — click **Highlights** on any day heading to run loudness analysis across all WAV/FLAC files in that day and display a combined activity timeline SVG. The button is a toggle: clicking again collapses the panel, and re-expanding it reuses the already-computed results (they are only recomputed when the analysis parameters change). A **· analysed** suffix on the button marks days where every file already has a cached analysis for the current parameters, i.e. highlights open instantly. Orange segments show when loud sections occurred relative to the day's time span; blue shows the file extents. The timeline axis is labelled at round wall-clock hours, with matching tick marks on the bar. When a day has more sections than fit as chips, the chips are the top 50 by score (loudest-above-background first) so the most promising events are reviewed first; long chip lists are collapsed behind a toggle button so the panel stays compact. J/K still steps through all sections in time order, and U/I steps through them by loudness.
+- **Day highlights** — click **Highlights** on any day heading to run loudness analysis across all WAV/FLAC files in that day. The button is a toggle: clicking again collapses the panel, and re-expanding it reuses the already-computed results (they are only recomputed when the analysis parameters change). A **· analysed** suffix on the button marks days where every file already has a cached analysis for the current parameters, i.e. highlights open instantly. The panel is plain text and buttons in linear reading order (screen-reader friendly): files-analysed/section totals, a key hint, then the section chips. When a day has more sections than fit as chips, the chips are the top 50 by score (loudest-above-background first) so the most promising events are reviewed first; long chip lists are collapsed behind a toggle button so the panel stays compact. J/K still steps through all sections in time order, and U/I steps through them by loudness.
 - **Inline playback** — collapsible `Play` button per row; audio loads lazily via a seekable `/stream/` endpoint with HTTP Range support. Metadata is fetched immediately so the duration is visible without pressing play.
 - **Waveform analysis** — on demand per file; computes RMS per 100 ms window and marks sections that stand out above the background. Detection is **adaptive**: a rolling noise floor (20th percentile per 30 s block) is estimated across the file, and a section is flagged when the level rises at least *margin* dB (default 12) above that floor. Slow ambience changes — rain setting in, day/night traffic hum — move the floor instead of producing false positives. Each section gets a **score** used to rank it: its peak dB above the floor, capped by the sharpest rise within 0.5 s. Abrupt events — voices, impacts, barks — rise fast, so their score is their full prominence; a gradual swell (a gust, a distant approaching car) that drifts up faster than the floor can track still gets flagged, but scores near zero and sinks to the bottom of the highlight ranking. Supported for WAV and FLAC (FLAC requires `numpy` + `soundfile`). Pure-Python fallback for WAV when numpy is absent. Results are cached in `recordings/analyses/<filename>.analysis.json`; subsequent requests at the same margin, min-gap, and min-duration settings return instantly without re-reading the audio. The cache file is deleted automatically when the audio file is deleted. Orphaned cache files (audio deleted outside the UI) are pruned on startup.
 - **Grace period** — configurable in the controls bar (default 2 s). Loud sections separated by less than this gap are merged into one. Raise this (e.g. to 15–30 s) when a single event generates many timestamps due to brief quiet gaps within it.
diff --git a/webui.html b/webui.html
index d27d2f3..6e04d7a 100644
--- a/webui.html
+++ b/webui.html
@@ -121,10 +121,6 @@ button.day-hl .day-arrow{font-size:9px}
 h2.day-heading{margin:0;font-size:inherit;font-weight:inherit;line-height:inherit;flex:1 1 auto}
 .day-hl-container{background:var(--bg);border:1px solid var(--brd);border-top:none;padding:8px 12px 12px}
 table.day-table{width:100%;border-collapse:collapse;border:1px solid var(--brd);border-top:none}
-svg.day-timeline{display:block;width:100%;height:22px}
-.day-tl-labels{position:relative;height:13px;font-size:10px;
-  color:var(--muted);font-family:ui-monospace,monospace;margin-top:2px}
-.day-tl-labels span{position:absolute;top:0;white-space:nowrap}
 /* clip player bar */
 #clip-bar{position:fixed;bottom:0;left:0;right:0;z-index:20;background:var(--surf);
   border-top:1px solid var(--brd);padding:8px 28px;display:flex;align-items:center;
@@ -1016,78 +1012,7 @@ async function dayHighlights(dayId, analyzableFiles) {
     return;
   }
 
-  const minT  = Math.min(...positioned.map(r => r.fileStart));
-  const maxT  = Math.max(...positioned.map(r => r.fileEnd));
-  const spanT = maxT - minT || 1;
-
-  // Axis ticks at round hours (aligned to the day, widest step that yields
-  // at most ~7 labels) instead of the arbitrary start/midpoint/end times
-  const stepH = [1, 2, 3, 6, 12].find(h => spanT / (h * 3600) <= 7) || 24;
-  const step  = stepH * 3600;
-  const d0 = new Date(minT * 1000);
-  const dayStart = new Date(d0.getFullYear(), d0.getMonth(), d0.getDate()).getTime() / 1000;
-  const ticks = [];
-  for (let t = dayStart + Math.ceil((minT - dayStart) / step) * step; t <= maxT; t += step)
-    ticks.push(t);
-
-  const W = 800, H = 22;
-  const ns = 'http://www.w3.org/2000/svg';
-
-  const svg = document.createElementNS(ns, 'svg');
-  svg.setAttribute('class', 'wave day-timeline');
-  svg.setAttribute('viewBox', `0 0 ${W} ${H}`);
-  svg.setAttribute('preserveAspectRatio', 'none');
-  svg.setAttribute('role', 'img');
   const totalSecs = positioned.reduce((a, r) => a + r.data.sections.length, 0);
-  svg.setAttribute('aria-label', `Day activity: ${results.length} file${results.length!==1?'s':''}, ${totalSecs} loud section${totalSecs!==1?'s':''}`);
-
-  // Background track
-  const bgR = document.createElementNS(ns, 'rect');
-  bgR.setAttribute('x', 0); bgR.setAttribute('y', 7);
-  bgR.setAttribute('width', W); bgR.setAttribute('height', 8);
-  bgR.setAttribute('fill', '#1e2535');
-  svg.appendChild(bgR);
-
-  // Hour tick marks (drawn under the file spans and sections)
-  ticks.forEach(t => {
-    const tl = document.createElementNS(ns, 'rect');
-    tl.setAttribute('x', ((t - minT) / spanT) * W); tl.setAttribute('y', 4);
-    tl.setAttribute('width', 1); tl.setAttribute('height', 14);
-    tl.setAttribute('fill', '#2e3950');
-    tl.setAttribute('aria-hidden', 'true');
-    svg.appendChild(tl);
-  });
-
-  positioned.forEach(({ f, data, fileStart, fileEnd, fileDur }) => {
-    const fx = ((fileStart - minT) / spanT) * W;
-    const fw = Math.max(1, ((fileEnd - fileStart) / spanT) * W);
-
-    // File span (dim blue)
-    const fr = document.createElementNS(ns, 'rect');
-    fr.setAttribute('x', fx); fr.setAttribute('y', 8);
-    fr.setAttribute('width', fw); fr.setAttribute('height', 6);
-    fr.setAttribute('fill', '#1e3a5f');
-    fr.setAttribute('aria-hidden', 'true');
-    svg.appendChild(fr);
-
-    // Loud sections (orange)
-    (data.sections || []).forEach(s => {
-      const sx = fx + (s.start / fileDur) * fw;
-      const sw = Math.max(1, ((s.end - s.start) / fileDur) * fw);
-      const sr = document.createElementNS(ns, 'rect');
-      sr.setAttribute('x', sx); sr.setAttribute('y', 4);
-      sr.setAttribute('width', sw); sr.setAttribute('height', 14);
-      sr.setAttribute('fill', '#f97316');
-      sr.setAttribute('rx', '1');
-      sr.setAttribute('aria-hidden', 'true');
-      svg.appendChild(sr);
-    });
-  });
-
-  const fmtHM = ts => {
-    const d = new Date(ts * 1000);
-    return d.getHours().toString().padStart(2,'0') + ':' + d.getMinutes().toString().padStart(2,'0');
-  };
 
   // Build cross-file section list for J/K navigation and chips
   dayActiveSections = [];
@@ -1112,23 +1037,21 @@ async function dayHighlights(dayId, analyzableFiles) {
   const box = document.createElement('div');
   box.className = 'wbox';
   box.style.marginBottom = '4px';
-  box.appendChild(svg);
 
-  const labels = document.createElement('div');
-  labels.className = 'day-tl-labels';
-  // Fewer than two round hours in the span: fall back to start/end times
-  (ticks.length >= 2 ? ticks : [minT, maxT]).forEach(t => {
-    const s = document.createElement('span');
-    s.textContent = fmtHM(t);
-    const pct = ((t - minT) / spanT) * 100;
-    if (pct < 4)       s.style.left = '0';
-    else if (pct > 96) s.style.right = '0';
-    else { s.style.left = pct + '%'; s.style.transform = 'translateX(-50%)'; }
-    labels.appendChild(s);
-  });
-  box.appendChild(labels);
+  // Totals first, then the key hint, then the chips: linear reading order
+  const summary = document.createElement('div');
+  summary.className = 'quiet';
+  summary.style.marginTop = '0';
+  summary.textContent = `${results.length} file${results.length!==1?'s':''} analysed · ${totalSecs} loud section${totalSecs!==1?'s':''}`;
+  box.appendChild(summary);
 
   if (dayActiveSections.length) {
+    const note = document.createElement('p');
+    note.className = 'quiet';
+    note.style.marginTop = '6px';
+    note.textContent = 'J / K plays through all sections in time order, U / I by loudness (loudest first)';
+    box.appendChild(note);
+
     const MAX_DAY_CHIPS = 50;
     // When there are too many sections to show them all, show the ones most
     // worth reviewing: the top MAX_DAY_CHIPS by score, loudest first.
@@ -1138,11 +1061,6 @@ async function dayHighlights(dayId, analyzableFiles) {
       chipList = chipList
         .sort((a, b) => (b.sec.score || 0) - (a.sec.score || 0))
         .slice(0, MAX_DAY_CHIPS);
-      const note = document.createElement('p');
-      note.className = 'quiet';
-      note.style.marginTop = '6px';
-      note.textContent = `${dayActiveSections.length} sections — J / K steps through all in time order, U / I by loudness (loudest first)`;
-      box.appendChild(note);
     }
     const chips = document.createElement('div');
     chips.className = 'chips';
@@ -1181,12 +1099,6 @@ async function dayHighlights(dayId, analyzableFiles) {
     box.appendChild(chips);
   }
 
-  const summary = document.createElement('div');
-  summary.className = 'quiet';
-  summary.style.marginTop = '4px';
-  summary.textContent = `${results.length} file${results.length!==1?'s':''} analysed · ${totalSecs} loud section${totalSecs!==1?'s':''}`;
-  box.appendChild(summary);
-
   contentEl.innerHTML = '';
   contentEl.appendChild(box);
   hlRow.dataset.loaded = hlParams();