circagraph
Sign inSign up

openchronology/timeline-app on GitHub

The OpenChronology repository on GitHub, mirrored by och-import-github: issues and pull requests as durations (ongoing while open), what happened to them as moments, plus releases, milestones, commits and branches. The Branches view shows the most recently active branches each in a track of its own.

Source: https://github.com/openchronology/timeline-app

3,131 moments · 2026-10-05 CE 20:21:49 UTC – 2026-11-16 CE 12:10:45 UTC · by @athan · @athan

#438 Background chart series, and a Log severity chart (#434)

–

  • github
  • github/openchronology/timeline-app
  • github/openchronology/timeline-app#438
  • pull request
  • state:merged

Closes #434. A background chart can now draw **series** beneath its total: each series is the moments carrying any of its tags, drawn as a curve in its own color. The new built-in **Log severity chart** plugin uses this for imported logs: all entries, plus errors in red (`severity:err` and anything more severe), warnings in yellow and information in blue (`severity:notice`, `severity:info`). These match the colors Log severity colors gives the entries themselves, and each can be changed in the plugin list. ## The issue's open questions - **How a plugin names its series:** `chart.series` is a list of `{label, tags, color, setting?}`. A series is a tag filter, the same kind a separation by tags uses, so all three backends could already count it. Severity in a log format's own metadata (without a tag) isn't counted, but the importers tag every entry they can. - **What bounds the number of series:** one to eight series, with one to forty tags each. - **How counting stays cheap:** a series counts only what the browser already knows, and asks the server or desktop for nothing more. - **Timelines held in the browser:** the browser knows every moment. `TimelineIndex.chartSeriesGroups` keeps a count per series by time, built when first read and then updated as moments are added, edited or deleted, so a series includes unsaved edits. - **Server and desktop timelines:** a series counts the view's moments shown one by one, taken from the frame the view already loaded. Summaries of many are counted in the total alone, so zooming in colors more of the total. To make this work, the server's overview projection (`pluginMetadata`) includes a moment's tags that a chart series names, and the desktop asks for `tags` when a chart has series. ## Drawing - **Stacked:** series add up, in the plugin's order, each on the total's scale. Two moments together, one of each of two series, put the first series' line at 1 and the second's at 2. The band between the lines is the "one more, of its kind". - **No double counting:** a moment carrying the tags of two series counts once, in the first. This holds in the browser's index (`TimelineIndex.chartSeriesGroups` counts a chart's series together) and when splitting the view's moments. - **What the gap means:** where every moment is in a series, the last series meets the total. Any gap left is moments in no series, or ones the browser only knows as a count. - **Look:** each series is a lighter band in its color, from the line beneath to its own line, between the total's area and its line. - **Comparisons and separations:** these draw the total only. ## Tests - **Unit tests:** `test/plugins.test.mjs` covers manifest validation, `pluginChart` colors and settings, `stackedCurves` (stacking, the floor of each band, capping at the total), and `chartSeriesGroups` counting each moment in its first series, kept up to date through put/delete. The catalogue's page order is updated. All 431 unit tests pass. - **Browser check:** `test/background-chart-browser.mjs` checks three severity curves in their colors, beneath the total line, stacked: over an all-error cluster the errors reach the total and the others add nothing, and over a warning between two notices each line lies on the one before and the last meets the total. It passes in the Playwright image. - **Visual:** I checked a 2,000-entry sample log in light and dark: the burst of errors and warnings rises beneath the total, and information runs along the rest. - **Projection:** a unit test checks that `pluginMetadata` passes on a moment's series tags and nothing else. - **Not run locally:** the server and desktop paths, because there's no space left on this machine for PostgreSQL. CI runs them. Docs: `docs/plugins.md` (Series), `docs/guide.md`. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_011fFY8eruEi1xAkkMBni13B https://github.com/openchronology/timeline-app/pull/438

Related

Open #438 Background chart series, and a Log severity chart (#434) in the timeline

#438 Background chart series, and a Log severity chart…