signalk-pypilot-newui 2.0.4 → 2.2.0

package/CHANGELOG.md

@@ -1,5 +1,456 @@
 # Changelog
 
+## 2.2.0 — 2026-08-31 — Rev88..Rev127
+
+Forty in-session Revs of navigation-oriented features on top of the
+2.1.0 visual foundation. Themes: turn the plugin into an intelligence
+layer over pypilot (historian → KPIs → alarms → Doctor → pre-departure
+check), give sail-raising its own AP mode ("Aproado"), and rebuild the
+Setup tab as an app-launcher grid of fullscreen tiles.
+
+### English
+
+**Added**
+
+- **Aproado pseudo-mode** (Rev87-92) — a new "raise the sails"
+  autopilot mode not in pypilot upstream. Pick BY BOW / BY STERN
+  via a 5 s modal, the plugin switches pypilot to wind mode with
+  target 0° (head to wind), and a floating HUD over the boat shows
+  elapsed time, straight-line distance from the start and the
+  compass heading captured at activation. SALIR restores the
+  previous mode + target + engaged state. The BY STERN branch
+  forces a stern-through swing by walking a chain of intermediate
+  targets 60° apart so pypilot cannot shortcut through the bow.
+- **Telemetry historian + Chart tab** (Rev93-96) — RAM ring buffer
+  at 1 Hz for the last 30 min (backend, Pi 5 friendly). New Chart
+  tab shows nine Trip Stats cards (AP engaged time, distance,
+  energy, mean/RMS/p95 heading error, servo runtime, tacks/gybes,
+  peak servo A) all fed live via SK paths, plus a canvas history
+  with 30 s / 2 min / 10 min windows and per-path chips.
+- **Sensor Quality panel** (Rev97-98) — age / observed Hz / jitter /
+  source for every critical SK path the AP depends on, with a
+  green / amber / red pill. Endpoint `/quality` and a poll while
+  Setup is visible.
+- **Servo Health card** (Rev99) — baseline current learned from
+  the first ~10 min of engaged navigation, then a live deviation
+  ratio flags "elevated" (>1.20×) or "high" (>1.65×) — early
+  warning for a hard rudder, fouling, or a stiffened linkage. Six
+  new SK paths under `steering.autopilot.pypilot.servo.health.*`.
+- **Alarm engine** (Rev100-101) — seven built-in rules (heading
+  deviation, unable to steer, servo overcurrent / temp, low
+  voltage, sensor lost, pypilot disconnected) publishing
+  canonical SK notifications `notifications.autopilot.*`. Sticky
+  banner in the visor with ACK + close, WebAudio beeps +
+  speech-synthesis of the message, and a full config panel in
+  Setup (enable / mute / status per rule).
+- **Pre-departure check** (Rev102) — a single verdict card
+  (READY / READY-WITH-CAVEATS / DO-NOT-ENGAGE) that aggregates
+  connectivity, sensor quality, servo health and voltage into one
+  answer before you leave the dock.
+- **Pypilot Doctor** (Rev103-104, Rev120-121) — press DIAGNOSE,
+  the plugin records 2-3 min with the AP engaged, runs heuristic
+  rules on the heading error stream (bias / oscillation / low
+  authority) and proposes P / I / D adjustments with a plain
+  explanation of why and what to expect. Nothing is applied
+  automatically — each suggestion has Apply and Discard buttons.
+  Rev120: the first Apply of a session forks the current pypilot
+  profile into a new `doctor-YYYYMMDD-HHMM` profile so the
+  previous gains stay one profile-select away.
+- **Setup as a launcher grid** (Rev105-119, 124) — every setup
+  block is now a square tile in a 2 / 3 / 4-column grid. Tap
+  opens fullscreen with a small X to close and ESC support.
+  Body scroll is locked while a tile is fullscreen. Live summary
+  pill on every tile so the state reads at a glance without
+  expanding. Connection consolidated (status + LAN scan + manual
+  host + Autopilot Provider in one card). "Emergency" renamed to
+  "Remote Control Console".
+- **Interactive SSH console** (Rev113-115) — free-form command
+  input with on-screen arrow buttons for mobile history
+  navigation, accumulative output textarea, clipboard fallback
+  for HTTP LAN, and 14 preset buttons with plain human labels
+  (Memory / IP table / WiFi / Temperature / Who is connected /
+  ...). BusyBox / piCore-safe fallbacks for every command.
+- **Full RangeSetting sliders in Calibration** (Rev116-119) —
+  every pypilot `RangeSetting` grouped by category (rudder /
+  servo / imu / ap / other) with the same look as the Tune tab,
+  a lock checkbox with the padlock emoji, a frozen "before:"
+  baseline that never moves as you drag, and a per-slider ↺
+  restore button that snaps back to the baseline.
+- **Nudge steps moved inside Calibration** (Rev124) — one card
+  less in the launcher grid; heading trim buttons live where
+  they belong conceptually.
+
+**Changed**
+
+- **Gota Chain shapes SWAP** (Rev122-126) — after several iterations
+  with Carlos on Tunatunes: the AMBER "A" arrow (apparent wind) is
+  now the LARGE piece (its tip reaches deep into the rose), and
+  the TEAL "T" arrow (true wind) is the SMALL outer one. Colors
+  and letters kept their canonical meaning; only the SVG paths
+  moved so the amber piece is visually the dominant one.
+- **Alarm summary semantics** (Rev107-108) — "activa" (fired) was
+  ambiguous with "activada" (enabled). New wording separates
+  `firing / sonando` (fired now) from `watching / vigilando`
+  (enabled and healthy). Summary always shows both counts.
+- **i18n audit** (Rev105, Rev112, Rev121) — every hard-coded
+  English string in the ES bundle purged ("engagear" → "activar",
+  KIP paths table fully translated, alarm messages), backend
+  suggestion reason / effect exposed as i18n keys + args so the
+  frontend renders in the user's language.
+- **Sensor Quality thresholds** (Rev98) — dropped `minHz` from the
+  defaults; the 1 Hz sampler capped observed Hz, so the threshold
+  produced spurious "degraded" flags. Freshness (`age`) is now
+  the only signal that penalises status.
+
+**Fixed**
+
+- **Fullscreen tile portal** (Rev110-111) — Setup fullscreen tiles
+  are now portaled to `<body>` so the `.tab-panel` transform
+  (used by the tab animation) cannot break `position: fixed`.
+  Fullscreen always covers the viewport now, no matter which
+  card was scrolled into.
+- **Copy button on HTTP** (Rev114) — `navigator.clipboard` is a
+  secure-context API; on plain http://192.168.x.y it silently
+  no-ops. Compat helper falls back to `document.execCommand("copy")`.
+- **Doctor `elapsedSec`** (Rev104) — was counting past the target
+  duration once the session completed. Now freezes at the target.
+- **Sliders baseline eaten by refresh** (Rev117-118) — the
+  Calibration "before:" value used to reset to the just-edited
+  number on every `/values` poll. Now captured once per name and
+  kept frozen across renders.
+- **Aproado restore** (Rev90) — mode / target / engaged restore on
+  SALIR was skipping steps after one failure. Now each step is
+  guarded independently and logged in the console.
+- **Sensor Quality parsing** (Rev94) — `navigation.attitude` is a
+  composite `{pitch, roll, yaw}` object, not a scalar path.
+  Custom subfield reader added for heel.
+- Cosmetic Firefox warnings (`::-moz-focus-inner`, comment-nested
+  `*/`) purged (Rev95-106).
+
+### Español
+
+**Nuevo**
+
+- **Modo Aproado** (Rev87-92): pseudo-modo AP para subir velas.
+  Elige POR PROA / POR POPA en un modal de 5 s, el plugin pasa
+  pypilot a modo viento con objetivo 0° (proa al viento), y un
+  HUD flotante sobre el barco muestra tiempo transcurrido,
+  distancia lineal desde el arranque y el rumbo compás capturado
+  al activar. SALIR restaura modo + objetivo + engaged previos.
+  POR POPA fuerza el swing por popa con una cadena de objetivos
+  intermedios cada 60° para que pypilot no atajaje por proa.
+- **Historian de telemetría + pestaña Gráfica** (Rev93-96):
+  buffer circular en RAM a 1 Hz durante 30 min (backend, Pi 5).
+  Nueva pestaña Gráfica con 9 tarjetas de estadísticas de sesión
+  (tiempo activo, distancia, energía, error medio / RMS / p95,
+  servo activo, viradas / trasluchadas, pico servo A) y canvas
+  con ventanas 30 s / 2 min / 10 min.
+- **Panel Calidad de sensores** (Rev97-98): edad / Hz / jitter /
+  fuente por cada ruta SK crítica con semáforo verde / ámbar /
+  rojo.
+- **Tarjeta Salud del servo** (Rev99): baseline aprendido de los
+  primeros ~10 min de navegación activa, luego ratio de
+  desviación marca "elevated" (>1.20×) o "high" (>1.65×) —
+  alerta temprana de timón duro, incrustaciones o rozamientos.
+- **Motor de alarmas** (Rev100-101): 7 reglas built-in
+  (desviación de rumbo, incapaz de gobernar, sobrecorriente
+  servo, temperatura servo, batería baja, sensor perdido,
+  pypilot desconectado) publicando notifications SK canónicas.
+  Banner sticky en el visor con ACK y cierre X, beeps WebAudio
+  + speechSynthesis del mensaje, panel de configuración en
+  Setup (enable / mute / estado por regla).
+- **Comprobación del piloto** (Rev102): tarjeta única con
+  veredicto (LISTO / LISTO CON RESERVAS / NO ACTIVAR) que
+  agrega conectividad, calidad de sensores, salud del servo y
+  voltaje.
+- **Asesoramiento y diagnóstico** (Rev103-104, Rev120-121):
+  botón DIAGNOSTICAR, el plugin graba 2-3 min con el AP activo,
+  aplica reglas heurísticas (sesgo / oscilación / autoridad) y
+  propone ajustes P / I / D con explicación clara del porqué y
+  del efecto esperado. Nada se aplica automáticamente — cada
+  sugerencia tiene botones Aplicar y Descartar. Rev120: el
+  primer Aplicar de la sesión duplica el perfil actual en uno
+  nuevo `doctor-AAAAMMDD-HHMM` para que el original quede
+  intacto a un toque en Ajustes → Perfil.
+- **Setup como launcher grid** (Rev105-119, 124): cada bloque
+  de Setup es un tile cuadrado en un grid 2 / 3 / 4 columnas.
+  Tap abre pantalla completa con X para cerrar, header sticky
+  y bloqueo de scroll de fondo. Etiqueta resumen en vivo en
+  cada tile. Conexión pypilot une 4 secciones. "Emergencia"
+  renombrada a "Consola control remoto".
+- **Consola SSH interactiva** (Rev113-115): input libre con
+  botones ↑▲ ↓▼ para navegar el historial en móvil, textarea
+  acumulativo, fallback de portapapeles para LAN HTTP y 14
+  presets con etiquetas humanas (Memoria RAM / Tabla IP / WiFi
+  / Temperatura / Quien está conectado / ...). Todos los
+  comandos con fallbacks BusyBox / piCore.
+- **Sliders completos de calibración** (Rev116-119): todos los
+  `RangeSetting` de pypilot agrupados por categoría (timón /
+  servo / imu / piloto / otros) con la misma apariencia que
+  Ajustes, candado azul con emoji, valor "antes:" congelado
+  que NUNCA se mueve al arrastrar, y un botón ↺ por slider
+  para restaurar el valor original.
+- **Botones corrección rumbo dentro de Calibración** (Rev124):
+  una tarjeta menos en el grid; los pasos ±1 / ±10 quedan
+  donde corresponde conceptualmente.
+
+**Cambiado**
+
+- **Swap de formas en la Gota Chain** (Rev122-126): tras varias
+  iteraciones con Carlos en Tunatunes, la flecha AMARILLA "A"
+  (viento aparente) es ahora la GRANDE (su punta llega hasta
+  el centro de la rosa) y la flecha VERDE "T" (viento real)
+  es la PEQUEÑA externa. Colores y letras mantienen su
+  significado canónico; solo se movieron los paths SVG para
+  que la amarilla domine visualmente.
+- **Semántica de alarmas** (Rev107-108): "activa" era ambiguo.
+  Nueva jerga separa `sonando` (disparada ahora) de `vigilando`
+  (habilitada y OK). El resumen muestra siempre ambos contadores.
+- **Auditoría i18n** (Rev105, Rev112, Rev121): purga de cadenas
+  inglesas hardcoded en el bundle ES ("engagear" → "activar",
+  tabla de KIP totalmente traducida, mensajes de alarma).
+  Reason / effect de las sugerencias del Doctor expuestos como
+  claves i18n para render en el idioma del visor.
+- **Umbrales Calidad de sensores** (Rev98): quitado `minHz` de
+  los defaults; el sampler a 1 Hz capaba la Hz observada y
+  generaba "degraded" falsos.
+
+**Corregido**
+
+- **Portal de tile fullscreen** (Rev110-111): tiles fullscreen
+  ahora se mueven al `<body>` para que el `transform` de
+  `.tab-panel` (animación entre pestañas) no rompa `position:
+  fixed`.
+- **Botón Copiar en HTTP** (Rev114): `navigator.clipboard`
+  requiere secure context. Fallback a `document.execCommand("copy")`.
+- **Doctor `elapsedSec`** (Rev104): contaba pasado el objetivo.
+  Ahora congela al final.
+- **Baseline de sliders comido por refresh** (Rev117-118): el
+  valor "antes" se reseteaba a lo recién editado en cada poll.
+  Ahora se captura una vez y no se toca.
+- **Restore de Aproado** (Rev90): SALIR saltaba pasos tras un
+  fallo. Ahora cada paso protegido por su try/catch.
+- **Parsing Calidad de sensores** (Rev94): `navigation.attitude`
+  es objeto compuesto, no path escalar. Fix del subfield heel.
+- Warnings cosméticos Firefox (`::-moz-focus-inner`, `*/` en
+  comentarios) purgados (Rev95-106).
+
+### Français
+
+**Ajouté**
+
+- **Mode Aproado** (Rev87-92) : pseudo-mode AP pour hisser les
+  voiles. PAR AVANT / PAR ARRIÈRE, l'AP passe en mode vent avec
+  cible 0° (nez au vent), HUD flottant avec temps, distance et
+  cap boussole capturé. SORTIR restaure mode / cible / engagé
+  précédents. PAR ARRIÈRE force le virage par l'arrière avec
+  une chaîne d'objectifs intermédiaires de 60°.
+- **Historian de télémétrie + onglet Graphique** (Rev93-96) :
+  buffer 30 min en RAM à 1 Hz, canvas d'historique et 9 cartes
+  Trip Stats.
+- **Panneau Qualité des capteurs** (Rev97-98) : âge / Hz /
+  jitter / source par chaque chemin SK critique.
+- **Carte Santé du servo** (Rev99) : baseline appris + ratio de
+  déviation avec alertes "elevated" et "high".
+- **Moteur d'alarmes** (Rev100-101) : 7 règles built-in,
+  notifications SK canoniques, banner avec ACK et fermeture,
+  audio WebAudio + parole synthétique, config par règle.
+- **Vérification pré-départ** (Rev102) : verdict READY / avec
+  caveats / NE PAS ENGAGER.
+- **Docteur pypilot** (Rev103-104, Rev120-121) : 2-3 min
+  d'enregistrement, règles heuristiques, propositions P / I / D
+  avec Appliquer et Rejeter. Le premier Appliquer crée un
+  nouveau profil `doctor-AAAAMMJJ-HHMM`.
+- **Setup en grille launcher** (Rev105-119, 124) : tiles carrés,
+  fullscreen par tap, résumé en direct, connexion consolidée,
+  "Consola contrôle remote" (renommé).
+- **Console SSH interactive** (Rev113-115) : entrée libre,
+  historique navigable au mobile, 14 presets aux noms humains,
+  fallbacks BusyBox / piCore.
+- **Sliders complets de calibration** (Rev116-119) : chaque
+  RangeSetting groupé, cadenas, baseline gelée, bouton restaurer.
+- **Boutons correction cap dans Calibration** (Rev124).
+
+**Modifié**
+
+- **Swap des formes Gota Chain** (Rev122-126) : la flèche AMBRE
+  "A" (vent apparent) est maintenant la GRANDE, la TEAL "T"
+  (vent réel) la petite. Couleurs et lettres conservent leur
+  sens canonique.
+- **Sémantique alarmes** (Rev107-108) : `sonando` vs
+  `vigilando`, résumé affiche les deux compteurs.
+- **Audit i18n** (Rev105, Rev112, Rev121) : purge de l'anglais
+  dans les bundles ES / FR / DE.
+- **Seuils Qualité capteurs** (Rev98) : `minHz` supprimé.
+
+**Corrigé**
+
+- Portal du tile fullscreen (Rev110-111).
+- Bouton Copier en HTTP (Rev114).
+- Doctor `elapsedSec` gelé au final (Rev104).
+- Baseline des sliders congelée (Rev117-118).
+- Restore Aproado protégé par try/catch (Rev90).
+- Lecture composite de `navigation.attitude` (Rev94).
+- Warnings cosmétiques Firefox purgés (Rev95-106).
+
+### Deutsch
+
+**Neu**
+
+- **Aproado-Pseudomodus** (Rev87-92) — AP-Modus zum Segelhissen.
+  ÜBER BUG / ÜBER HECK, AP schaltet in Wind-Modus mit Ziel 0°,
+  HUD über dem Boot mit Zeit / Distanz / Kompass-Kurs. AUS
+  stellt Modus / Ziel / Engaged wieder her. ÜBER HECK erzwingt
+  den langen Schwenk mit Zwischen-Zielen alle 60°.
+- **Telemetrie-Historian + Chart-Tab** (Rev93-96) — Ringpuffer
+  30 min RAM bei 1 Hz, 9 Trip-Stats-Karten, Canvas mit Fenstern
+  30 s / 2 min / 10 min.
+- **Sensor-Qualität-Panel** (Rev97-98).
+- **Servo-Health-Karte** (Rev99) — gelernter Baseline mit
+  Alarmen "elevated" / "high".
+- **Alarm-Engine** (Rev100-101) — 7 built-in Regeln, SK
+  Notifications, Banner mit ACK und X, WebAudio + Sprache,
+  Config-Panel.
+- **Pre-Departure-Check** (Rev102).
+- **Pypilot Doctor** (Rev103-104, Rev120-121) — Diagnose-
+  Sitzung, Heuristik-Regeln, P/I/D-Vorschläge mit Anwenden /
+  Verwerfen. Erstes Anwenden erzeugt neues Profil.
+- **Setup als Launcher-Grid** (Rev105-119, 124) — quadratische
+  Tiles, Vollbild-Tap, Live-Zusammenfassung.
+- **Interaktive SSH-Konsole** (Rev113-115) — freie Eingabe,
+  Pfeil-Buttons mobil, 14 Presets mit menschlichen Labels.
+- **Vollständige RangeSetting-Slider in Kalibrierung**
+  (Rev116-119) — Schloss, eingefrorene Baseline,
+  Wiederherstellen-Knopf pro Slider.
+- **Nudge-Buttons in Kalibrierung** (Rev124).
+
+**Geändert**
+
+- **Gota-Chain-Form-SWAP** (Rev122-126).
+- **Alarm-Semantik** (Rev107-108) — `sonando` / `vigilando`.
+- **i18n-Audit** (Rev105, Rev112, Rev121).
+- **Sensor-Qualität-Schwellen** (Rev98) — `minHz` entfernt.
+
+**Behoben**
+
+- Fullscreen-Tile-Portal (Rev110-111).
+- Copy-Button auf HTTP (Rev114).
+- Doctor `elapsedSec` (Rev104).
+- Slider-Baseline eingefroren (Rev117-118).
+- Aproado-Restore geschützt (Rev90).
+- `navigation.attitude`-Zusammensetzung (Rev94).
+- Kosmetische Firefox-Warnungen (Rev95-106).
+
+## 2.1.0 — 2026-08-25 — Rev68..Rev87
+
+Twenty in-session Revs of iterative visual + reliability work rolled up
+into a proper minor release. Themes: a full redesign of the compass-rose
+autopilot overlays ("Gota Chain"), a hard-earned fix for AP mutations
+racing each other across the SignalK bus, and a permanent seamless-auth
+story so a Signal K restart never again silently disables the visor's
+mutation buttons.
+
+### Added
+
+- **Gota Chain overlay** — the target diamond and the AWA/TWA wind
+  arrows are now three concentric SVG pieces that interlock into one
+  clean droplet when `target ≡ AWA ≡ TWA`. Each piece carries its own
+  letter (A / T) and its own color ring-tick that marks the exact
+  angle on the compass. When any of the three drifts, its V-hembra
+  opens as a visible hollow. Iterated over 12 Revs (Rev68..Rev82)
+  with Carlos on Tunatunes.
+- **COG line** — chain of yellow chevrons from the bow toward the
+  course-over-ground direction. Visible only when `SOG > 0.15 kn`.
+- **Current vector** — two parallel wavy blue lines with three
+  triangles pointing at the boat. Computed as `SOG − SOW` (added
+  new `navigation.speedThroughWater` subscription). Visible when
+  `|current| > 0.2 kn`.
+- **4-card overlay selector** — long-press any rose corner OR the
+  boat sprite to open the popup with the four toggle cards (AWA,
+  TWA, COG, Current), each with a large preview and a data-
+  requirement line ("Needs a wind sensor", "Only shows when SOG >
+  0.15 kn", etc). Toggles persist in `localStorage`.
+- **Rose cardinals colour-coded**: N orange, E green, S blue, W red.
+  All at the same radius `r = 70`. Thin black stroke around each
+  letter for legibility on any background.
+- **Seamless auth via SK Access Request** — the visor now uses a
+  device-scoped, permanent SK token instead of a short-lived JWT.
+  On first install the user approves once from `SK admin → Security
+  → Access Requests`; from then on the token survives every SK
+  server restart, every plugin redeploy, and every browser reload,
+  so mutations (engage / mode / target) NEVER silently 401 again.
+- **`.\deploy.ps1 -FrontOnly`** — new script flag that syncs
+  `public/` only (no build, no npm install, no `systemctl restart
+  signalk`). Use it when the diff is HTML / CSS / JS only —
+  `Ctrl+F5` in the browser picks it up. Avoids the plugin-socket
+  reconnect to `pypilot_web` on the Pi Zero W that pushed the
+  TinyPilot to hang after a big batch of deploys.
+
+### Fixed
+
+- **AP mutation race (`DIA jumps to a stale target for a beat`).**
+  Frontend used to `Promise.all([engage, target])` and the backend's
+  `pushAutopilotUpdate` published ALL SK autopilot fields on every
+  notify — so whichever POST landed first emitted a delta that
+  carried the OTHER field's STALE value (typically an old target
+  from the previous session, e.g. `115°` when the intent was `75°`).
+  Fixed by refactoring `AutopilotProvider.notifyChanged(fields)` to
+  accept `"engaged" | "target" | "all"` and `pushAutopilotUpdate` to
+  only emit the paths that actually changed. Parallel POSTs no
+  longer clobber each other with stale copies.
+- **Wind-mode target capture on engage.** `doEngage` always sent
+  `state.heading` as the target regardless of mode; pypilot in wind
+  mode interpreted that compass value as a wind angle and steered
+  the boat toward nonsense. Now captures `state.windAngle` (apparent)
+  or `state.windAngleTrue` (true wind) when the active mode contains
+  "wind"; falls back to heading only for compass / gps / nav.
+- **AP button "click missed" and engage / disengage bounce**
+  hardened: switched from `click` to `pointerdown` (fires once per
+  press on both touch and mouse without waiting for the
+  browser-synthesised `click`), swallow the trailing `click` with
+  `preventDefault + stopPropagation`, `touch-action: manipulation`
+  on the button, plus an 800 ms cooldown gate that survives the
+  ~200 ms POST round-trip. Ghost taps from `touchend` no longer
+  produce a phantom second engage.
+- **Wind speed chip tap regressions.** Chip was picked up by the
+  corner-selector `forEach` (auto-attached its 500 ms long-press
+  timer → opened the wrong popup) AND the `<main>` tab-swipe
+  handler treated any tap-with-drift on it as a horizontal swipe
+  → the chip appeared to slide right. Renamed the chip class to
+  `.wind-chip` so the forEach ignores it and replaced the shared
+  handler with a bespoke `pointerdown/up` short-tap detector that
+  stops touch propagation.
+- **HDG chip / compass labels covered by DIA** on engage: reordered
+  the SVG stack so the compass card and HDG chip render AFTER the
+  gota pieces, never behind them.
+- **DIA arc rendering asymmetry** ("bump on one side") when
+  rotated: `stroke-linejoin` switched from `round` to `miter`,
+  raya `stroke-linecap` switched from `round` to `butt` to remove
+  the semi-circle that overshot the ring line.
+
+### Changed
+
+- **Wind speed chip moved from an SVG group to a positioned HTML
+  `.wind-chip` div** overlaid on the rose bottom-center. Text
+  baseline now aligns with the two bottom corner cells so all
+  three values (BL / BC / BR) read as one row.
+- **SVG stacking order** finalised (bottom → top): ring · wind
+  sectors · boat sprite · TWA · AWA · DIA · raya · AWA / TWA
+  colour ring-ticks · COG line · current vector · compass card ·
+  HDG chip. Wind chip is a separate HTML overlay above the SVG.
+- **Restart engine** already switched to `sv restart` (piCore
+  runit) in 2.0.4; the docs, i18n text and Info-tab quick-start
+  now match — the earlier "three escalated restarts" wording was
+  outdated (Emergency section has been 2 buttons since Rev66:
+  `RESTART pypilot` + `reboot Pi`; the safe `restart pypilot_web`
+  lives in the Debug console).
+- **Info-tab quick-start** rewritten in EN + ES to describe the
+  Gota Chain, the 4-card overlay selector, the new cardinal
+  colors, and boat-long-press as an alternative selector opener.
+- **README** overview and "Remote restart / reboot" section
+  rewritten to match the current 2-button + Debug-console layout,
+  and to describe the Gota Chain + optional overlays.
+
 ## 2.0.4 — 2026-08-21 — Rev67
 
 Reintroduces (with proper QA) the UI polish + reliability work that was

package/README.md

@@ -22,18 +22,28 @@ dashboards wired to 1.0.0 paths, see the full migration table in
 - `.calibration.rudderRange` (rad) -> `.rudder.range` (deg)
 - `.gains.<pilot>.<gain>` -> `.ap.pilot.<pilot>.<gain>`
 
-Also new in 2.0.0: three escalated **restart / reboot levels** in
-Setup -> Emergency, all guarded by a helm-manned confirmation modal, and
-a **Debug console** with an SSH-based whitelist of preset diagnostic
-commands (logs, dmesg, top, uptime, df, pypilot version).
+Setup -> Emergency ships **two remote restart buttons** (`RESTART pypilot`
+and `reboot Pi`), both guarded by a helm-manned confirmation modal.
+`restart pypilot_web` (the safe web-only restart that does not interrupt
+steering) lives as a preset in the **Debug console** — an SSH-based
+whitelist of preset diagnostic commands (logs, dmesg, top, uptime, df,
+pypilot version, restart pypilot_web).
 
 ## What it does
 
 **Touch webapp** (mobile / tablet / chart-plotter, dark theme):
 
-- Compass rose with heading readout, cardinals + degree ticks, hull-fixed
-  green/red sailing wedges, AWA + TWA arrows (independent, toggleable), cyan
-  target diamond, and 4 configurable corner tiles (long-press to reconfigure).
+- Compass rose with HDG readout, colour-coded cardinals (N orange, E green,
+  S blue, W red) + degree ticks, hull-fixed green/red sailing wedges, and 4
+  configurable corner tiles (long-press to reconfigure).
+- **Gota Chain** overlay: three concentric arrow pieces on the rose — cyan
+  target diamond, amber `A` (AWA), sea-green `T` (TWA). Interlock into one
+  clean droplet when all three angles coincide; the V-hembra of any piece
+  that drifts opens up as a visible hollow, and a colour ring-tick marks
+  the exact angle on the compass. Optional **COG line** from the bow
+  (yellow chevrons) and **current vector** (SOG − SOW, blue wavy arrow)
+  can be toggled from a 4-card selector opened by long-press on any
+  corner or on the boat sprite.
 - Big-touch AP engage / disengage with optimistic UI + auto-retry over
   flaky links (Tailscale-safe).
 - Tack port / starboard, mode selector (compass / GPS / wind / true wind / nav),
@@ -116,28 +126,29 @@ register the same ID and behaviour is undefined). Valid setups:
 
 Absorb mode lives in **Setup → Autopilot Provider (one-socket mode)**.
 
-## Remote restart / reboot triad + Debug console
-
-When the autopilot process on the TinyPilot gets wedged you don't need to open
-an SSH session by hand. In **Setup → Emergency**, save the TinyPilot's SSH user
-+ password once. From then on you get three escalated actions, colour-coded
-from safest to loudest, each guarded by a helm-manned confirmation modal that
-asks whether someone is at the helm before executing:
-
-1. **restart pypilot_web** (~3-5 s) - only the web server restarts. The AP
-   core keeps steering. Use when the visor gets stuck but the pilot is fine.
-2. **RESTART pypilot** (~10-15 s) - restarts pypilot core + web. The AP drops
-   the heading briefly and re-engages when it comes back up.
-3. **reboot Pi** (~35-60 s) - full `sudo reboot` of the Raspberry Pi. No
-   autopilot for almost a minute. Last-resort when the box is in a bad state.
-
-Underneath the triad there is a **Debug console** that runs a closed
-whitelist of preset diagnostic commands over the same SSH session:
-`logs pypilot`, `logs pypilot_web`, `dmesg`, `top`, `uptime`, `df`,
-`pypilot --version`. Output goes into a scrollable textarea, a "Follow
-logs" toggle polls `journalctl --since '30 s ago'` every 3 seconds, and
-Copy / Share buttons let you paste the dump straight into a GitHub
-issue or a WhatsApp / email conversation with your friendly rigger.
+## Remote restart / reboot + Debug console
+
+When the autopilot process on the TinyPilot gets wedged you don't need to
+open an SSH session by hand. In **Setup → Emergency**, save the TinyPilot's
+SSH user + password once. From then on you get **two big restart buttons**,
+each guarded by a helm-manned confirmation modal that asks whether someone
+is at the helm before executing:
+
+1. **RESTART pypilot** (~10-15 s) — `sv restart` of the pypilot core + web
+   (runit under piCore). The AP drops the heading briefly and re-engages
+   when it comes back up.
+2. **reboot Pi** (~35-60 s) — full `sudo reboot` of the Raspberry Pi. No
+   autopilot for almost a minute. Last-resort when the box is in a bad
+   state.
+
+The safe **restart pypilot_web** (web server only, does not interrupt
+steering) lives as a preset button in the **Debug console** below,
+alongside a closed whitelist of preset diagnostic commands over the same
+SSH session: `logs pypilot`, `logs pypilot_web`, `dmesg`, `top`, `uptime`,
+`df`, `pypilot --version`. Output goes into a scrollable textarea, a
+"Follow logs" toggle polls `journalctl --since '30 s ago'` every 3
+seconds, and Copy / Share buttons let you paste the dump straight into a
+GitHub issue or a WhatsApp / email conversation with your friendly rigger.
 
 The endpoint (`POST /plugins/*/debug-cmd`) refuses any command that is
 not in the whitelist, so a leaked JWT cannot be used to run arbitrary
@@ -156,8 +167,8 @@ that isolated TinyPilot.
 | `GET`  | `/plugins/signalk-pypilot-newui/paths`         | Live list of published SK paths with GET / PUT URLs and units |
 | `GET`  | `/plugins/signalk-pypilot-newui/catalog`       | Raw pypilot catalog (all values + metadata) |
 | `PUT`  | `/plugins/signalk-pypilot-newui/raw`           | Send raw `name=value` to pypilot (protected by `allowWrites`) |
-| `POST` | `/plugins/signalk-pypilot-newui/restart-pypilot` | SSH remote restart (level 2 of the triad), uses `sshUser` + `sshPassword` from plugin config |
-| `POST` | `/plugins/signalk-pypilot-newui/debug-cmd`     | Run one of a closed whitelist of preset diagnostic / restart commands over SSH (levels 1 and 3 of the triad + logs / dmesg / top / etc). Body: `{ "preset": "<name>" }` |
+| `POST` | `/plugins/signalk-pypilot-newui/restart-pypilot` | SSH `sv restart` of pypilot core+web on the TinyPilot, uses `sshUser` + `sshPassword` from plugin config |
+| `POST` | `/plugins/signalk-pypilot-newui/debug-cmd`     | Run one of a closed whitelist of preset diagnostic / restart commands over SSH (`restart.web`, `reboot.pi`, `logs.pypilot`, `logs.web`, `dmesg`, `top`, `uptime`, `df`, `pypilot.version`). Body: `{ "preset": "<name>" }` |
 | `POST` | `/plugins/signalk-pypilot-newui/pause`         | Disconnect local socket (for scripts) |
 | `POST` | `/plugins/signalk-pypilot-newui/resume`        | Reconnect local socket (for scripts) |