signalk-chiplog 2.6.0 → 2.8.0

package/CHANGELOG.md

@@ -6,6 +6,57 @@ All notable changes to Chiplog are documented here. The format follows
 
 ## [Unreleased]
 
+## [2.8.0] - 2026-10-01
+
+### Added
+
+- **A manual entry's time can be typed in or corrected.** A note can be written up after the fact with the time it
+  happened, and any manoeuvre, note or sketch the crew logged can be redated later from the logbook's timeline or from
+  the tablet — an entry still waiting for the connection included. Since such an entry was not made where it happened,
+  its position is read back from the track at that time and left empty when the track has nothing within 2 minutes of
+  it, along with the instrument readings taken when the button was pressed. A time outside the passage or in the future
+  is refused, and the departure manoeuvre that opened a passage is still moved through that passage's departure time.
+
+### Changed
+
+- **The tablet's confirmation banner no longer reads as a question.** Logging an entry put up two buttons the size of
+  the app's primary actions, "Add a comment" and "Undo", which looked like a dialog waiting for an answer — it was not
+  clear the entry was already in, nor that "Undo" deleted it rather than dismissing the banner. The banner now confirms
+  first (a check mark, or a clock for an entry held on the tablet), carries a close button and a bar draining over the
+  ten seconds it stays, and puts the two follow-ups below the message at a smaller size, the undo in red and labelled
+  with what it undoes.
+
+## [2.7.0] - 2026-09-22
+
+### Added
+
+- **Heading changes are logged automatically.** A turn of 30° or more (configurable), held steady for a minute above 2
+  knots, is added to the timeline as the average heading it settled on. Can be turned off in settings.
+
+- **The retrospective analysis can read the Signal K History API.** Instead of connecting to an InfluxDB 1.x database
+  itself, Chiplog can now read whichever history provider the server has registered — signalk-to-influxdb2, QuestDB,
+  TimescaleDB — with no database credentials to set. Pick it with **History source** in the settings; InfluxDB 1.x stays
+  the default, so an existing installation is untouched.
+- **Engine and sail segments are reconstructed from an InfluxDB 1.x history too.** The retrospective analysis read the
+  engine RPMs but never listed the boat's engines, so a reconstructed passage carried no propulsion segment and no
+  engine hours.
+
+### Changed
+
+- **The 3D animation starts on the medium boat size.** The 3D view opened with the smallest of the three; it now opens
+  on the middle one, where the boat is large enough to be read. **Boat size** still offers all three.
+
+- **The 3D animation's boat is drawn as a cartoon.** The generated sailboat has been rebuilt: a fuller hull with a
+  proper sheer and overhangs, a planked deck with a covering board, a coachroof with portholes, a cockpit with a crew on
+  the weather rail, a roached mainsail with a stripe and a burgee at the masthead — all in flat colours with an inked
+  silhouette, so it still reads when the boat is only a hundred pixels long. Nothing changes for a crew who load their
+  own `.glb`.
+
+- **`navigation.state` is followed whatever its source.** Chiplog no longer prefers signalk-autostate's value over
+  another source of the same path: it uses the one Signal K resolves the path to. On a boat where the AIS transponder
+  and signalk-autostate both publish it, which one wins is settled in the server's source priorities — that is also
+  where a transponder left at "under way using engine" while moored is corrected.
+
 ## [2.6.0] - 2026-09-20
 
 ### Changed
@@ -352,7 +403,9 @@ First release.
 - REST API under `/plugins/signalk-chiplog/api`, documented in [docs/API.md](docs/API.md).
 - Single SQLite database through Node's built-in `node:sqlite`: no native module to build.
 
-[Unreleased]: https://github.com/ricard33/signalk-chiplog/compare/v2.6.0...HEAD
+[Unreleased]: https://github.com/ricard33/signalk-chiplog/compare/v2.8.0...HEAD
+[2.8.0]: https://github.com/ricard33/signalk-chiplog/compare/v2.7.0...v2.8.0
+[2.7.0]: https://github.com/ricard33/signalk-chiplog/compare/v2.6.0...v2.7.0
 [2.6.0]: https://github.com/ricard33/signalk-chiplog/compare/v2.5.1...v2.6.0
 [2.5.1]: https://github.com/ricard33/signalk-chiplog/compare/v2.5.0...v2.5.1
 [2.5.0]: https://github.com/ricard33/signalk-chiplog/compare/v2.4.0...v2.5.0

package/README.md

@@ -8,7 +8,7 @@ sensors cannot know from a tablet at the helm: manoeuvres, notes and handwriting
   such as a lock or a lunch anchorage.
 - **GPS track**, distance, time under engine and under sail.
 - **Hourly instrument readings**, as on a paper log, plus readings at departure, arrival and each manoeuvre.
-- **Automatic events**: alarms, autopilot changes, strong wind, falling barometer.
+- **Automatic events**: alarms, autopilot changes, strong wind, falling barometer, held heading changes.
 - **Departure and arrival names**, looked up online and corrected once for good.
 - **Consultation webapp**: logbook by day, map, timeline, corrections, export.
 - **Replay a range of passages** on the map — an hour of sailing per second — and save it as an MP4 for a phone, a
@@ -87,9 +87,9 @@ A **passage** is one logbook entry: from leaving a berth or anchorage to arrivin
   which carries on once the boat moves.
 - **Power cuts and restarts.** If the server comes back after the boat has been still for longer than the tolerance, the
   passage is closed at its last movement. A short restart carries on with the same passage.
-- **Under way or stopped** comes from `navigation.state` when signalk-autostate provides it. Otherwise Chiplog averages
-  speed over ground over 3 minutes: under way above 1 knot, stopped below half a knot. This keeps a boat swinging at
-  anchor from starting passages.
+- **Under way or stopped** comes from `navigation.state` when something publishes it — signalk-autostate, typically.
+  Otherwise Chiplog averages speed over ground over 3 minutes: under way above 1 knot, stopped below half a knot. This
+  keeps a boat swinging at anchor from starting passages.
 
 A passage that was split in two — a stop just longer than the tolerance, for instance — can be merged back from the
 logbook webapp. The stop the merge folds away is kept on the timeline as its own line, naming the place, since it would
@@ -131,6 +131,8 @@ Added to the timeline without anyone touching anything:
 - **Wind** — true wind, averaged over 2 minutes, rising above 20 and 30 knots and falling back below them
   (configurable).
 - **Barometer** — a fall of 4 hPa or more over 3 hours (configurable).
+- **Heading changes** — a turn of 30° or more, held steady for a minute, above 2 knots (configurable, and can be turned
+  off).
 
 An alarm at anchor between two passages goes to the passage that ended there, as long as the boat is within 1 nautical
 mile of that arrival.
@@ -212,8 +214,12 @@ Open **Chiplog** from the Signal K webapps, or `/signalk-chiplog/`. Reading need
   counter at departure and arrival and the hours run, and the tank levels and battery charge, voltage and current noted
   at departure), and the log: every reading and event in order, including handwritten notes. A passage in progress
   refreshes every minute. Each line's comment can be edited (read/write access); a manoeuvre or note the crew logged
-  themselves can also be deleted — automatic lines (alarms, autopilot, weather, corrections) can only be annotated.
-  Under each position, in grey, its bearing and distance from the nearest landmark.
+  themselves can also be **redated** and deleted — automatic lines (alarms, autopilot, weather, corrections) can only be
+  annotated. Correcting a time reads the position back from the track at that time, and leaves it empty when the track
+  has nothing within 2 minutes of it, since the entry was not made where it happened. A time outside the passage, or in
+  the future, is refused, and the departure manoeuvre that opened a passage is moved by changing that passage's
+  departure time in **Corrections** below. Under each position, in grey, its bearing and distance from the nearest
+  landmark.
 - **Corrections** (read/write access):
   - rename the departure, or the arrival once the passage is closed — a passage in progress has none yet to rename;
   - switch an engine period to sail or back;
@@ -236,9 +242,9 @@ Open **Chiplog** from the Signal K webapps, or `/signalk-chiplog/`. Reading need
   saves it as a video in one of five shapes (Mobile 9:16, Portrait 3:4, Square 1:1, Landscape 4:3, Widescreen 16:9).
   Everything happens in the browser: nothing is rendered or encoded on the Signal K server, and the map tiles are the
   only thing downloaded. **View → 3D** shows the same film, at the map's own scale and with north still at the top, as a
-  camera tilted down onto a 3D sailboat that heels and trims its sails to the wind and rides the waves, with the map
-  laid flat under it; frame it closer or wider than the map and pick the boat's size if you like, and load your own boat
-  as a `.glb` file — sails included — if you would rather see it (see
+  camera tilted down onto a cartoon sailboat that heels and trims its sails to the wind and rides the waves, with the
+  map laid flat under it; frame it closer or wider than the map and pick the boat's size if you like, and load your own
+  boat as a `.glb` file — sails included — if you would rather see it (see
   [Your own boat](#your-own-boat-in-the-3d-animation-)). The MP4 export then films the 3D view.
 - **Export** — download the whole logbook or a date range as a PDF logbook to print, JSON, CSV or GPX, and write the
   abandon-ship copy to the USB drive now (admin). The PDF is written in the webapp's language and the device's time
@@ -254,7 +260,7 @@ shortcuts beside it; where any date is allowed, the calendar has an _Any date_ b
 
 ### Your own boat in the 3D animation ⛵
 
-The 3D view draws a generic sailboat. To see yours instead, use **Boat → Use my own boat…** under the animation and pick
+The 3D view draws a cartoon sailboat. To see yours instead, use **Boat → Use my own boat…** under the animation and pick
 a `.glb` file. The model is kept in **that browser only** (it is never sent to the logbook or the Signal K server), so
 it has to be loaded again on another device; **Use the default boat** puts the generic one back.
 
@@ -353,9 +359,11 @@ change. One tap logs it with the time, the position and an instrument reading.
 
 - **Sail change** asks which sail went up: mainsail, genoa, jib, staysail, spinnaker, gennaker, code 0, storm jib, or
   any name you type.
-- A banner then confirms it for 10 seconds, with two big buttons:
-  - **Undo**, for a mistaken tap;
-  - **Add a comment**, e.g. "25 kn, second reef".
+- A banner then confirms it: a check mark, what was logged and at what time, and a bar along the bottom draining over
+  the 10 seconds it stays. Nothing is waiting on you — it goes on its own, or at once with the **×**. Under the message
+  sit two optional follow-ups:
+  - **Add a comment**, e.g. "25 kn, second reef";
+  - **Undo this entry**, in red, for a mistaken tap — it deletes the entry just logged.
 
 ### Departures open the passage
 
@@ -370,7 +378,8 @@ note once moored belongs to the passage that brought you there. Anywhere else, t
 
 ### Notes and handwriting
 
-- **Note** — type and tap **Log it**.
+- **Note** — type and tap **Log it**. Leave **Time** empty for now, or fill it in to write up something that happened
+  earlier; a note dated by hand takes its position from the track rather than from where you are standing.
 - **Handwriting** — takes over the whole screen, with a toolbar above the pad: fine pen, thick pen, highlighter, eraser,
   undo, and a choice of colour (kept to the theme's colour in night mode, to spare night vision). Pen pressure also sets
   the line width. The eraser removes only what it actually touches, splitting a stroke rather than deleting all of it;
@@ -383,7 +392,8 @@ export, not just on the tablet.
 ### Latest entries
 
 Below, the latest entries of the current passage (or of the last one) are listed with their time. Each can take a
-comment, and your own entries can be deleted; a note's text can be edited.
+comment, and your own entries can be redated and deleted; a note's text can be edited. An entry still waiting for the
+connection can be corrected too — the change travels with it.
 
 ### Night mode
 
@@ -418,36 +428,43 @@ a regular Signal K user account.
 
 In the Signal K admin, **Apps & Plugins → Configuration → Chiplog**.
 
-| Setting                                                          | Default                                       | What it does                                                                                                                                                                     |
-| ---------------------------------------------------------------- | --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Stop duration within which a new departure continues the passage | 30 min                                        | A passage closes when the boat stops; leaving again sooner reopens it, the stop kept as a stopover.                                                                              |
-| Under-way speed without navigation.state                         | 1 kn                                          | Used only without signalk-autostate: under way above it, stopped below half of it.                                                                                               |
-| Propulsion assumed without engine data                           | sail                                          | When nothing says whether the engine is running. Set to engine on a motorboat.                                                                                                   |
-| Instrument snapshot interval                                     | 60 min                                        | Readings on this clock boundary during a passage.                                                                                                                                |
-| Track point interval                                             | 15 s                                          | A track point at least this often while moving.                                                                                                                                  |
-| Place matching radius                                            | 200 m                                         | A departure or arrival this close to a known place takes its name.                                                                                                               |
-| Name departures and arrivals with online geocoding               | on                                            | Turn off to never send positions online; places are then named after their coordinates until corrected.                                                                          |
-| Geocoding service                                                | `https://nominatim.openstreetmap.org`         | Any Nominatim-compatible service, e.g. a self-hosted one.                                                                                                                        |
-| Read each journal line against the nearest landmark              | on                                            | Fetches the landmarks of the areas sailed through from OpenStreetMap, so each position is also given as a bearing and distance from one. Turn off to keep the coordinates alone. |
-| Landmark service (Overpass API)                                  | `https://overpass-api.de/api/interpreter`     | Any Overpass-compatible service, e.g. a self-hosted one.                                                                                                                         |
-| Fetch the tide forecast at departure                             | on                                            | Turn off to never send the departure position online; the passage page then shows no tide.                                                                                       |
-| Marine service                                                   | `https://marine-api.open-meteo.com/v1/marine` | Any Open-Meteo Marine-compatible service, e.g. a self-hosted one. Serves the tide, and the sea state and current of the weather forecast.                                        |
-| Fetch the marine weather forecast at departure                   | on                                            | Turn off to never send the departure position to the weather services; the passage page and the PDF then show no forecast.                                                       |
-| Weather service                                                  | `https://api.open-meteo.com/v1/forecast`      | Any Open-Meteo-compatible forecast service, e.g. a self-hosted one.                                                                                                              |
-| USB export directory                                             | —                                             | Where the abandon-ship copy is written, e.g. `/media/usb`. Empty turns the USB copy off.                                                                                         |
-| Automatic USB copy interval                                      | 15 min                                        | How often the USB copy is brought up to date. 0 turns the periodic copy off.                                                                                                     |
-| Copy to the USB drive at each arrival                            | on                                            | Brings the USB copy up to date as soon as a passage ends.                                                                                                                        |
-| Logbook language (PDF)                                           | en                                            | Language of the PDF logbooks on the USB drive (English or French).                                                                                                               |
-| Ship's time zone (PDF)                                           | the server's                                  | Time zone of the PDF logbooks on the USB drive, e.g. `Europe/Paris`.                                                                                                             |
-| Wind speed thresholds                                            | 20, 30 kn                                     | Logged when the 2-minute average true wind crosses them.                                                                                                                         |
-| Barometric drop warning                                          | 4 hPa / 3 h                                   | 0 turns it off.                                                                                                                                                                  |
-| InfluxDB host (retrospective analysis)                           | —                                             | Local or remote host of the InfluxDB 1.x database signalk-to-influxdb writes to. Empty turns the retrospective analysis page off.                                                |
-| InfluxDB port                                                    | 8086                                          |                                                                                                                                                                                  |
-| InfluxDB database                                                | —                                             |                                                                                                                                                                                  |
-| InfluxDB username / password                                     | —                                             | Leave empty if the database needs none.                                                                                                                                          |
-| InfluxDB protocol                                                | http                                          | `http` or `https`.                                                                                                                                                               |
-| InfluxDB query timeout                                           | 30 s                                          | Each retrospective query gives up and reports an error past this, instead of hanging against an unreachable or overloaded database.                                              |
-| InfluxDB vessel context                                          | this server's own                             | Only needed running the replay from a different Signal K server than the one that wrote the history, e.g. development pointed at a production database.                          |
+| Setting                                                          | Default                                       | What it does                                                                                                                                                                                                 |
+| ---------------------------------------------------------------- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| Stop duration within which a new departure continues the passage | 30 min                                        | A passage closes when the boat stops; leaving again sooner reopens it, the stop kept as a stopover.                                                                                                          |
+| Under-way speed without navigation.state                         | 1 kn                                          | Used only without signalk-autostate: under way above it, stopped below half of it.                                                                                                                           |
+| Propulsion assumed without engine data                           | sail                                          | When nothing says whether the engine is running. Set to engine on a motorboat.                                                                                                                               |
+| Instrument snapshot interval                                     | 60 min                                        | Readings on this clock boundary during a passage.                                                                                                                                                            |
+| Track point interval                                             | 15 s                                          | A track point at least this often while moving.                                                                                                                                                              |
+| Place matching radius                                            | 200 m                                         | A departure or arrival this close to a known place takes its name.                                                                                                                                           |
+| Name departures and arrivals with online geocoding               | on                                            | Turn off to never send positions online; places are then named after their coordinates until corrected.                                                                                                      |
+| Geocoding service                                                | `https://nominatim.openstreetmap.org`         | Any Nominatim-compatible service, e.g. a self-hosted one.                                                                                                                                                    |
+| Read each journal line against the nearest landmark              | on                                            | Fetches the landmarks of the areas sailed through from OpenStreetMap, so each position is also given as a bearing and distance from one. Turn off to keep the coordinates alone.                             |
+| Landmark service (Overpass API)                                  | `https://overpass-api.de/api/interpreter`     | Any Overpass-compatible service, e.g. a self-hosted one.                                                                                                                                                     |
+| Fetch the tide forecast at departure                             | on                                            | Turn off to never send the departure position online; the passage page then shows no tide.                                                                                                                   |
+| Marine service                                                   | `https://marine-api.open-meteo.com/v1/marine` | Any Open-Meteo Marine-compatible service, e.g. a self-hosted one. Serves the tide, and the sea state and current of the weather forecast.                                                                    |
+| Fetch the marine weather forecast at departure                   | on                                            | Turn off to never send the departure position to the weather services; the passage page and the PDF then show no forecast.                                                                                   |
+| Weather service                                                  | `https://api.open-meteo.com/v1/forecast`      | Any Open-Meteo-compatible forecast service, e.g. a self-hosted one.                                                                                                                                          |
+| USB export directory                                             | —                                             | Where the abandon-ship copy is written, e.g. `/media/usb`. Empty turns the USB copy off.                                                                                                                     |
+| Automatic USB copy interval                                      | 15 min                                        | How often the USB copy is brought up to date. 0 turns the periodic copy off.                                                                                                                                 |
+| Copy to the USB drive at each arrival                            | on                                            | Brings the USB copy up to date as soon as a passage ends.                                                                                                                                                    |
+| Logbook language (PDF)                                           | en                                            | Language of the PDF logbooks on the USB drive (English or French).                                                                                                                                           |
+| Ship's time zone (PDF)                                           | the server's                                  | Time zone of the PDF logbooks on the USB drive, e.g. `Europe/Paris`.                                                                                                                                         |
+| Wind speed thresholds                                            | 20, 30 kn                                     | Logged when the 2-minute average true wind crosses them.                                                                                                                                                     |
+| Barometric drop warning                                          | 4 hPa / 3 h                                   | 0 turns it off.                                                                                                                                                                                              |
+| Log heading changes                                              | on                                            | Turn off to leave heading changes out of the log.                                                                                                                                                            |
+| Heading change threshold                                         | 30°                                           | A change must be at least this large to be logged.                                                                                                                                                           |
+| Heading change tolerance                                         | 10°                                           | How much the new heading may wander while holding and still count as steady.                                                                                                                                 |
+| Heading change hold time                                         | 60 s                                          | How long the new heading must hold before it is logged.                                                                                                                                                      |
+| Heading change minimum speed                                     | 2 kn                                          | Below this speed over ground, the course is too noisy to log a change.                                                                                                                                       |
+| Heading change cooldown                                          | 5 min                                         | A new change is logged only once the last one is at least this old.                                                                                                                                          |
+| History source (retrospective analysis)                          | InfluxDB 1.x                                  | Select Signal K History API to read the server's own history provider, such as signalk-to-influxdb2 — no database connection needed. InfluxDB 1.x stays the default so existing installations are untouched. |
+| InfluxDB host (retrospective analysis)                           | —                                             | Shown only for the InfluxDB 1.x legacy source. Local or remote host of the database signalk-to-influxdb writes to. Empty turns the retrospective analysis page off.                                          |
+| InfluxDB port                                                    | 8086                                          |                                                                                                                                                                                                              |
+| InfluxDB database                                                | —                                             |                                                                                                                                                                                                              |
+| InfluxDB username / password                                     | —                                             | Leave empty if the database needs none.                                                                                                                                                                      |
+| InfluxDB protocol                                                | http                                          | `http` or `https`.                                                                                                                                                                                           |
+| Retrospective query timeout                                      | 30 s                                          | Each retrospective query gives up and reports an error past this, instead of hanging against an unreachable or overloaded history. Applies to either source.                                                 |
+| Vessel context (retrospective analysis)                          | this server's own                             | Only needed running the replay from a different Signal K server than the one that wrote the history, e.g. development pointed at a production database. Applies to either source.                            |
 
 ## Signal K data used 🔌
 
@@ -459,7 +476,7 @@ None of these is required except position and speed over ground; each feature us
 | Engine or sail            | `propulsion.*.revolutions`, `propulsion.*.state`, `navigation.state`                                                                                                                                                                                                                                                               |
 | Readings                  | `navigation.headingTrue` (or `headingMagnetic` + `magneticVariation`), `navigation.speedThroughWater`, `environment.wind.*`, `environment.depth.belowSurface` (or `belowTransducer`), `environment.outside.pressure`, `environment.outside.temperature`, `environment.water.temperature`, `navigation.log`, `propulsion.*.runTime` |
 | Boat status               | `tanks.*.*.currentLevel`, `.currentVolume`, `.capacity`, `.name`, `electrical.batteries.*.voltage`, `.current`, `.capacity.stateOfCharge`, `.temperature`, `.name`                                                                                                                                                                 |
-| Events                    | `notifications.*`, `steering.autopilot.state`, `.mode`, `.engaged`, `.target`, `environment.wind.speedTrue`, `environment.outside.pressure`                                                                                                                                                                                        |
+| Events                    | `notifications.*`, `steering.autopilot.state`, `.mode`, `.engaged`, `.target`, `environment.wind.speedTrue`, `environment.outside.pressure`, `navigation.headingTrue` (or `headingMagnetic` + `magneticVariation`)                                                                                                                 |
 
 ## Backups and abandon ship 🛟
 
@@ -485,9 +502,13 @@ stopped? The **Retrospective** page (admin access) reconstructs those passages f
 Chiplog runs live — the same thresholds, so a reconstructed passage is one Chiplog would have logged had it been running
 at the time.
 
-- **Requires [signalk-to-influxdb](https://github.com/tkurki/signalk-to-influxdb)** (a recommended companion plugin)
-  already having written the boat's data into an InfluxDB 1.x database — local or on another machine, set in **Apps &
-  Plugins → Configuration**: host, port, database, and a username/password if it needs one.
+- Choose a history source in **Apps & Plugins → Configuration**:
+  - **Signal K History API** (recommended) reads the server's active history provider, such as
+    [signalk-to-influxdb2](https://github.com/tkurki/signalk-to-influxdb2), without database credentials or storage
+    schema assumptions.
+  - **InfluxDB 1.x (legacy)** requires [signalk-to-influxdb](https://github.com/tkurki/signalk-to-influxdb) to have
+    written the boat's data into an InfluxDB 1.x database — local or on another machine — set with host, port, database,
+    and a username/password if it needs one.
 - Pick a **from** and **to** date on the Retrospective page and start it. It runs in the background — the page shows its
   progress — and can be cancelled at any point; a first quick pass finds when the boat moved, and only those stretches
   are then fetched and reconstructed, so weeks in port take next to no time. Once done, the page sums up what it added:
@@ -567,9 +588,10 @@ Chiplog works, but departures and arrivals are decided from speed only. The mess
 - **"has not been updated since…"** — the source named stopped publishing. signalk-autostate republishes every 10
   minutes while it receives position and speed: check that the GPS data reaches the server, and that the plugin is
   enabled.
-- **"is “default” (from nmea0183.AI)"** — another device publishes a navigational status Chiplog does not use, typically
-  the boat's own AIS transponder, and signalk-autostate's value is not there to take over. Check that signalk-autostate
-  is enabled; Chiplog prefers its value over any other source.
+- **"is “default” (from nmea0183.AI)"** — the source Signal K resolved `navigation.state` to publishes a navigational
+  status Chiplog does not use, typically the boat's own AIS transponder. Chiplog follows whichever source the server
+  picks, so the fix is on the server: check that signalk-autostate is enabled, and give it priority over the transponder
+  in Signal K's source priorities.
 
 ### Passages are not opening
 
@@ -624,10 +646,10 @@ context** in the plugin configuration.
 ### A retrospective analysis takes minutes then fails with no clear reason
 
 The InfluxDB server did not answer — unreachable, overloaded, a firewall or a VPN not connected. Each query now gives up
-after **InfluxDB query timeout** (30 seconds by default) with the connection problem it ran into, rather than hanging
-until some far longer, less informative failure; check that the server named in the plugin configuration is reachable
-from wherever Signal K runs, and that it is not overloaded — or raise the timeout if it is simply slow to answer a
-six-hour chunk.
+after **Retrospective query timeout** (30 seconds by default) with the connection problem it ran into, rather than
+hanging until some far longer, less informative failure; check that the server named in the plugin configuration is
+reachable from wherever Signal K runs, and that it is not overloaded — or raise the timeout if it is simply slow to
+answer a six-hour chunk.
 
 ### A retrospective analysis over several days makes the InfluxDB server unresponsive
 

package/index.js

@@ -225,50 +225,121 @@ module.exports = function (app) {
         default: EVENT_DEFAULTS.pressureDropThreshold,
         minimum: 0
       },
-      influxHost: {
-        type: 'string',
-        title: 'InfluxDB host (retrospective analysis)',
+      headingChangeEnabled: {
+        type: 'boolean',
+        title: 'Log heading changes',
         description:
-          'For reconstructing past passages from a signalk-to-influxdb history (InfluxDB 1.x), local or remote. Leave empty to turn that feature off'
+          'Records a course change once it is held; turn off to leave heading changes out of the log',
+        default: EVENT_DEFAULTS.headingChangeEnabled
       },
-      influxPort: {
+      headingChangeThreshold: {
         type: 'number',
-        title: 'InfluxDB port',
-        default: INFLUX_DEFAULTS.influxPort
+        title: 'Heading change threshold (degrees)',
+        description: 'A change must be at least this large to be logged',
+        default: EVENT_DEFAULTS.headingChangeThreshold,
+        minimum: 1,
+        maximum: 180
       },
-      influxDatabase: {
-        type: 'string',
-        title: 'InfluxDB database'
+      headingChangeTolerance: {
+        type: 'number',
+        title: 'Heading change tolerance (degrees)',
+        description: 'How much the new heading may wander while holding and still count as steady',
+        default: EVENT_DEFAULTS.headingChangeTolerance,
+        minimum: 0
       },
-      influxUsername: {
-        type: 'string',
-        title: 'InfluxDB username',
-        description: 'Leave empty if the database needs none'
+      headingChangeHoldSeconds: {
+        type: 'number',
+        title: 'Heading change hold time (seconds)',
+        description: 'How long the new heading must hold before it is logged',
+        default: EVENT_DEFAULTS.headingChangeHoldSeconds,
+        minimum: 1
       },
-      influxPassword: {
-        type: 'string',
-        title: 'InfluxDB password',
-        format: 'password'
+      headingChangeMinSpeed: {
+        type: 'number',
+        title: 'Heading change minimum speed (knots)',
+        description: 'Below this speed over ground, the course is too noisy to log a change',
+        default: EVENT_DEFAULTS.headingChangeMinSpeed,
+        minimum: 0
+      },
+      headingChangeCooldownMinutes: {
+        type: 'number',
+        title: 'Heading change cooldown (minutes)',
+        description: 'A new change is logged only once the last one is at least this old',
+        default: EVENT_DEFAULTS.headingChangeCooldownMinutes,
+        minimum: 0
       },
-      influxProtocol: {
+      retrospectiveHistorySource: {
         type: 'string',
-        title: 'InfluxDB protocol',
-        enum: ['http', 'https'],
-        default: INFLUX_DEFAULTS.influxProtocol
+        title: 'History source for retrospective analysis',
+        description:
+          'Signal K reads the server’s own History API provider (signalk-to-influxdb2, for example), needing no database connection of its own — the better choice on a new installation. InfluxDB 1.x keeps the legacy direct database reader, and stays the default so installations already set up that way go on working untouched.',
+        enum: ['influxdb1', 'signalk'],
+        enumNames: ['InfluxDB 1.x (legacy)', 'Signal K History API'],
+        default: 'influxdb1'
       },
       influxQueryTimeoutSeconds: {
         type: 'number',
-        title: 'InfluxDB query timeout (seconds)',
+        title: 'Retrospective query timeout (seconds)',
         description:
-          'Each retrospective query is given up on and reported as an error past this, rather than hanging indefinitely against an unreachable or overloaded database',
+          'Each retrospective query is given up on and reported as an error past this, rather than hanging indefinitely against an unreachable or overloaded history. Applies to either history source',
         default: INFLUX_DEFAULTS.influxQueryTimeoutSeconds,
         minimum: 1
       },
       influxSelfContext: {
         type: 'string',
-        title: 'InfluxDB vessel context',
+        title: 'Vessel context (retrospective analysis)',
         description:
-          'Only needed running the replay from a different Signal K server than the one that wrote the history — e.g. a development instance pointed at a boat’s production database. The vessel context the data was tagged with, such as "vessels.urn:mrn:imo:mmsi:123456789"; a failed replay names the contexts actually found. Leave empty to use this server’s own (Signal K → Server → Vessel Identity)'
+          'Only needed running the replay from a different Signal K server than the one that wrote the history — e.g. a development instance pointed at a boat’s production database. The vessel context the data was tagged with, such as "vessels.urn:mrn:imo:mmsi:123456789"; a failed replay names the contexts actually found. Leave empty to use this server’s own (Signal K → Server → Vessel Identity). Applies to either history source'
+      }
+    },
+    // RJSF evaluates dependencies each time the selector changes. Keeping the
+    // InfluxDB fields out of the top-level properties hides them in History
+    // API mode and inserts them immediately after the source selector.
+    dependencies: {
+      retrospectiveHistorySource: {
+        oneOf: [
+          {
+            properties: {
+              retrospectiveHistorySource: { const: 'influxdb1' },
+              influxHost: {
+                type: 'string',
+                title: 'InfluxDB host (retrospective analysis)',
+                description:
+                  'For reconstructing past passages from a signalk-to-influxdb history (InfluxDB 1.x), local or remote. Leave empty to turn that feature off'
+              },
+              influxPort: {
+                type: 'number',
+                title: 'InfluxDB port',
+                default: INFLUX_DEFAULTS.influxPort
+              },
+              influxDatabase: {
+                type: 'string',
+                title: 'InfluxDB database'
+              },
+              influxUsername: {
+                type: 'string',
+                title: 'InfluxDB username',
+                description: 'Leave empty if the database needs none'
+              },
+              influxPassword: {
+                type: 'string',
+                title: 'InfluxDB password',
+                format: 'password'
+              },
+              influxProtocol: {
+                type: 'string',
+                title: 'InfluxDB protocol',
+                enum: ['http', 'https'],
+                default: INFLUX_DEFAULTS.influxProtocol
+              }
+            }
+          },
+          {
+            properties: {
+              retrospectiveHistorySource: { const: 'signalk' }
+            }
+          }
+        ]
       }
     }
   };
@@ -400,6 +471,16 @@ module.exports = function (app) {
         logbookTimeZone: config.logbookTimeZone || null,
         windSpeedThresholds: config.windSpeedThresholds ?? EVENT_DEFAULTS.windSpeedThresholds,
         pressureDropThreshold: config.pressureDropThreshold ?? EVENT_DEFAULTS.pressureDropThreshold,
+        headingChangeEnabled: config.headingChangeEnabled ?? EVENT_DEFAULTS.headingChangeEnabled,
+        headingChangeThreshold:
+          config.headingChangeThreshold ?? EVENT_DEFAULTS.headingChangeThreshold,
+        headingChangeTolerance:
+          config.headingChangeTolerance ?? EVENT_DEFAULTS.headingChangeTolerance,
+        headingChangeHoldSeconds:
+          config.headingChangeHoldSeconds ?? EVENT_DEFAULTS.headingChangeHoldSeconds,
+        headingChangeMinSpeed: config.headingChangeMinSpeed ?? EVENT_DEFAULTS.headingChangeMinSpeed,
+        headingChangeCooldownMinutes:
+          config.headingChangeCooldownMinutes ?? EVENT_DEFAULTS.headingChangeCooldownMinutes,
         influxHost: config.influxHost || null,
         influxPort: config.influxPort ?? INFLUX_DEFAULTS.influxPort,
         influxDatabase: config.influxDatabase || null,
@@ -408,7 +489,9 @@ module.exports = function (app) {
         influxProtocol: config.influxProtocol || INFLUX_DEFAULTS.influxProtocol,
         influxQueryTimeoutSeconds:
           config.influxQueryTimeoutSeconds ?? INFLUX_DEFAULTS.influxQueryTimeoutSeconds,
-        influxSelfContext: config.influxSelfContext || null
+        influxSelfContext: config.influxSelfContext || null,
+        retrospectiveHistorySource:
+          config.retrospectiveHistorySource === 'signalk' ? 'signalk' : 'influxdb1'
       };
 
       if (settings.logbookTimeZone && !isTimeZone(settings.logbookTimeZone)) {

package/lib/api.js

@@ -499,7 +499,7 @@ function registerRoutes(router, { getContext, logError }) {
 
   readwrite.patch(
     '/api/events/:id',
-    handle(({ db }, req) => {
+    handle(({ db, now }, req) => {
       const id = v.parseId(req.params.id);
       const body = v.requireBody(req.body, ['time', 'comment', 'subtype', 'payload']);
       const patch = withoutUndefined({
@@ -508,7 +508,7 @@ function registerRoutes(router, { getContext, logError }) {
         subtype: optional(body, 'subtype', nullableString(200)),
         payload: optional(body, 'payload', parsePayload)
       });
-      return events.updateEvent(db, id, patch);
+      return events.updateEvent(db, id, patch, { now: now() });
     })
   );
 

package/lib/database.js

@@ -371,7 +371,10 @@ const MIGRATIONS = [
   ALTER TABLE places ADD COLUMN country_code TEXT;
   ALTER TABLE places ADD COLUMN country_checked INTEGER NOT NULL DEFAULT 0
     CHECK (country_checked IN (0, 1));
-  `
+  `,
+  // Another CHECK-widening rebuild, same reason and same shape as
+  // addPropulsionChangeEventType.
+  addHeadingChangeEventType
 ];
 
 function addPropulsionChangeEventType(db, version) {
@@ -472,6 +475,56 @@ function addStopoverEventType(db, version) {
   db.exec('PRAGMA foreign_keys = ON');
 }
 
+function addHeadingChangeEventType(db, version) {
+  db.exec('PRAGMA foreign_keys = OFF');
+  withTransaction(db, () => {
+    db.exec(`
+      -- The event-watcher logs a held course change (SPEC §4.6) the same way
+      -- as the other automatic events.
+      CREATE TABLE events_new (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        entry_id INTEGER NOT NULL REFERENCES log_entries (id) ON DELETE CASCADE,
+        time TEXT NOT NULL,
+        type TEXT NOT NULL CHECK (
+          type IN (
+            'manoeuvre',
+            'text_annotation',
+            'handwritten_annotation',
+            'sk_alarm',
+            'autopilot',
+            'weather_threshold',
+            'manual_correction',
+            'propulsion_change',
+            'stopover',
+            'heading_change'
+          )
+        ),
+        subtype TEXT,
+        lat REAL,
+        lon REAL,
+        comment TEXT,
+        payload TEXT,
+        source TEXT NOT NULL DEFAULT 'manual' CHECK (source IN ('auto', 'manual')),
+        created_at TEXT NOT NULL,
+        client_ref TEXT
+      );
+      INSERT INTO events_new (
+        id, entry_id, time, type, subtype, lat, lon, comment, payload, source, created_at, client_ref
+      )
+      SELECT id, entry_id, time, type, subtype, lat, lon, comment, payload, source, created_at, client_ref
+      FROM events;
+      DROP TABLE events;
+      ALTER TABLE events_new RENAME TO events;
+      CREATE INDEX idx_events_entry_time ON events (entry_id, time);
+      CREATE INDEX idx_events_type ON events (type);
+      CREATE UNIQUE INDEX idx_events_client_ref ON events (client_ref)
+        WHERE client_ref IS NOT NULL;
+    `);
+    db.exec(`PRAGMA user_version = ${version + 1}`);
+  });
+  db.exec('PRAGMA foreign_keys = ON');
+}
+
 function seedBuiltinManoeuvreTypes(db) {
   const insert = db.prepare(
     `INSERT INTO manoeuvre_types (key, label, sort_order, builtin)