signalk-ships-barometer 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changes
+
+## 0.1.0
+
+Independent Ship's Barometer release, derived from oyve/signalk-barometer-trend v2.3.4.
+
+- Convert Signal K true-wind angles from radians to normalized degrees; migrate legacy saved angles once without changing pressure history.
+- Add opt-in, offline pressure/wind/moisture assessment with source IDs, original timestamps, history continuity and missing-data flags.
+- Add transducer-depth water temperature context and conservative moisture-consistency checks.
+- Keep all 21 legacy forecast paths; add one structured assessment path.
+- Retain Derived Data as an optional dew-point provider and use synchronized local temperature/humidity as fallback.
+- Add maritime barometer artwork, an independent package/plugin ID, explicit source/depth settings and install guidance.
+- Guard malformed/irrelevant deltas and invalid pressure inputs.
+
+Modified inherited files: index.js, barometer.js, package.json, schema.json, meta.json, README.md; new assessment.js and assessment/wind/water/lifecycle tests. The upstream mapping file and original LICENSE are retained. No forecast probability or new automatic alarm is introduced.

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2020-2021 github.com/oyve
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,14 @@
+Ship's Barometer
+
+This project derives from signalk-barometer-trend v2.3.4 by oyve.
+Original project: https://github.com/oyve/signalk-barometer-trend
+The barometer-trend forecasting library is also by oyve:
+https://github.com/oyve/barometer-trend
+Original Apache License 2.0 terms and notices are retained in LICENSE.
+
+Modifications maintained by SCarns (2026): corrected wind-angle units and saved-history migration; optional offline local assessment; source/timestamp/quality checks; water-temperature context; independent packaging, documentation and tests.
+This independent project is not endorsed by the original author.
+
+The nautical barometer artwork was generated with OpenAI image generation at SCarns' direction and is included under this project's Apache-2.0 distribution terms.
+Bundled dependencies retain their own license notices in their packages.
+Modified JSON configuration/metadata/package files and modified tests are identified in CHANGELOG.md.

package/README.md

@@ -0,0 +1,69 @@
+<!-- Independent modifications by SCarns, 2026. Derived from oyve/signalk-barometer-trend v2.3.4; see NOTICE. -->
+# Ship's Barometer
+
+<img src="assets/ships-barometer.png" width="180" alt="A traditional brass ship's barometer against a misty sea">
+
+**Offline weather interpretation from the boat's own sensors.** Ship's Barometer combines traditional barometric forecasts with an optional assessment of measured pressure changes, wind strengthening/easing, moisture conditions and water-temperature context.
+
+This is an independent continuation of [signalk-barometer-trend v2.3.4](https://github.com/oyve/signalk-barometer-trend/tree/v2.3.4), created by **[oyve](https://github.com/oyve)**. The underlying [barometer-trend](https://github.com/oyve/barometer-trend) library is also by oyve. Their work supplies the original pressure analysis and forecast models; this project adds integration corrections, local observations, quality checks and independent packaging. It is maintained by [SCarns](https://github.com/SCarns) and is not endorsed by the original author.
+
+## What it does
+
+- Converts Signal K true-wind direction from radians to the degrees required by the forecasting library, including a one-time conversion of legacy saved history.
+- Retains all 21 pressure/forecast paths used by the original 2.3.4 plugin and existing dashboards.
+- Optionally publishes `environment.outside.weather.assessment`: measured changes, short reasons, SI units, source IDs, original timestamps, missing inputs and quality flags.
+- Uses local humidity/temperature or a supplied Derived Data dew point, with checks for disagreement and observation-time mismatch.
+- Compares air and dew point with local water temperature while explicitly distinguishing transducer-depth water from a measured surface temperature.
+- Preserves separate pressure and assessment history across restarts. Runs without any weather API or internet connection after installation.
+
+The assessment is **descriptive and experimental**. It does not provide a calibrated rain probability, future wind speed, confirmed fog, gust forecast or new automatic alarm. Heat index and wind chill remain with Derived Data. The optional assessment is off by default.
+
+## Install
+
+Download `signalk-ships-barometer-0.1.0.tgz` from [GitHub Releases](https://github.com/SCarns/signalk-ships-barometer/releases/latest) and copy it into your Signal K user directory, normally `~/.signalk`:
+
+```sh
+cd ~/.signalk
+npm install --save ./signalk-ships-barometer-0.1.0.tgz
+```
+
+**Disable Barometer Trend before enabling Ship's Barometer.** The plugins share the original forecast output paths; running both would create competing publishers. You can keep the old package installed for rollback.
+
+Restart Signal K and enable **Ship's Barometer** in plugin settings. To use the extra assessment, enable **Local weather assessment**. Check [installation and migration](docs/installation.md) for source/depth settings and history handling.
+
+This release is distributed on GitHub. See [publishing to the Signal K store](docs/publishing.md). npm/store availability is a separate publishing step; do not assume `npm install signalk-ships-barometer` or store search will work until it has been published there.
+
+## Local inputs and output
+
+| Input | Signal K path | Units |
+|---|---|---|
+| Pressure | `environment.outside.pressure` | Pa |
+| Air temperature | `environment.outside.temperature` | K |
+| True wind direction | `environment.wind.directionTrue` | rad |
+| True wind speed | `environment.wind.speedTrue` | m/s |
+| Humidity | `environment.outside.humidity` or `environment.outside.relativeHumidity` | ratio |
+| Optional supplied dew point | `environment.outside.dewPointTemperature` | K |
+| Optional water temperature | `environment.water.temperature` | K |
+
+Set the assessment source IDs explicitly when multiple local sources share a path. Blank source fields retain the first valid local source. Sources identified as Open-Meteo, NOAA or WeatherAPI are excluded from the assessment. Only this vessel's timestamped observations are accepted. The source IDs and timestamps used remain visible in the assessment.
+
+The new assessment contains `pressureState`, `windState`, `moistureState`, `waterContext`, `fogContext`, `qualityFlags`, `measurements`, `units`, `inputs`, `missing` and `reasons`. `windOutlook` is explicitly `uncalibrated`.
+
+## Evidence and development
+
+The first release comes from a local archive study and installation testing. The wind-angle fix corrects a unit-contract error; it does **not** establish improved rain accuracy. The pressure-to-future-wind association was inconsistent across periods and decision-window timings, so the new assessment reports observed changes rather than an automatic wind warning. Water context has software tests, but no boat-fog accuracy score.
+
+The release is based on the working **2.3.4** lineage. Upstream's newer main branch uses a different library interface and path layout; this project intentionally retains the installed 2.3.4 output contract. See [validation and limits](docs/validation.md).
+
+Requires Node.js 18 or newer. For development:
+
+```sh
+npm ci
+npm test
+```
+
+Runtime dependencies are bundled in the release tarball; development dependencies are not. Contributions should include meaningful tests and retain the distinction between measured conditions, hypotheses and verified forecast outcomes.
+
+## License and credits
+
+[Apache License 2.0](LICENSE). Original license text is retained; modified-file attribution and additions are recorded in [NOTICE](NOTICE) and [CHANGELOG.md](CHANGELOG.md). Runtime dependencies retain their own license notices. The nautical artwork was generated with OpenAI image generation at SCarns' direction.

package/assessment.js

@@ -0,0 +1,99 @@
+// Ship's Barometer modifications by SCarns, 2026. Derived from oyve/signalk-barometer-trend v2.3.4; see NOTICE and CHANGELOG.md.
+'use strict';
+const PATHS={pressure:'environment.outside.pressure',wind:'environment.wind.speedTrue',temperature:'environment.outside.temperature',humidity:'environment.outside.humidity',dewpoint:'environment.outside.dewPointTemperature',water:'environment.water.temperature'};
+const MAX_AGE={pressure:25*60000,wind:5*60000,temperature:10*60000,humidity:10*60000,dewpoint:10*60000,water:30*60000};
+const median=a=>{a=a.slice().sort((x,y)=>x-y);return a.length%2?a[(a.length-1)/2]:(a[a.length/2-1]+a[a.length/2])/2;};
+class Assessment {
+ constructor(preferred={}, waterDepthM=null){this.history={};this.sources={};this.latest={};this.preferred=preferred;this.waterDepthM=waterDepthM;}
+ ingest(delta,now=Date.now()){
+  if(delta.context && delta.context!=='vessels.self' && delta.context!==this.context)return;
+  for(const u of delta.updates||[]){
+   // Original timestamps are mandatory; receipt time must not refresh stale data.
+   const time=Date.parse(u.timestamp),source=u.$source || (u.source && (u.source.label || u.source.src));
+   if(!Number.isFinite(time)||time>now||now-time>25*60000||typeof source!=='string'||!source)continue;
+   for(const item of u.values||[]){
+    const key=Object.keys(PATHS).find(k=>PATHS[k]===item.path || (k==='humidity'&&item.path==='environment.outside.relativeHumidity'));if(!key)continue;
+    if(this.preferred[key] && source!==this.preferred[key])continue;
+    if(/open-meteo|noaa|weatherapi/i.test(source))continue;
+    if(this.sources[key] && this.sources[key]!==source)continue;
+    const v=item.value;
+    if(this.latest[key] && time<=this.latest[key].time)continue;
+    if(!Number.isFinite(v)|| (key==='pressure'&&(v<80000||v>110000)) || (key==='wind'&&(v<0||v>100)) || ((key==='temperature'||key==='dewpoint')&&(v<193.15||v>333.15)) || (key==='humidity'&&(v<=0||v>1)) || (key==='water'&&(v<270.15||v>323.15))){delete this.latest[key];continue;}
+    this.sources[key]=source;this.latest[key]={time,value:v,source};
+    if(key==='pressure'||key==='wind'){
+     const h=this.history[key]||(this.history[key]=[]),record={time,value:v,source};
+     if(h.length && Math.floor(h[h.length-1].time/60000)===Math.floor(time/60000))h[h.length-1]=record;else h.push(record);
+     this.history[key]=h.filter(x=>x.time>=now-4*3600000);
+    }
+   }
+  }
+ }
+ fresh(key,now){const v=this.latest[key];return v&&now>=v.time&&now-v.time<=MAX_AGE[key]?v:null;}
+ window(key,end){
+  const h=(this.history[key]||[]).filter(x=>x.time<=end&&x.time>=end-30*60000);
+  if(h.length<3 || h[0].time>end-20*60000 || h[h.length-1].time<end-5*60000)return null;
+  for(let i=1;i<h.length;i++)if(h[i].time-h[i-1].time>10*60000)return null;
+  return median(h.map(x=>x.value));
+ }
+ evaluate(now=Date.now()){
+  const inputs={},missing=[];
+  for(const k of Object.keys(PATHS)){const v=this.fresh(k,now);if(v)inputs[k]=v;else missing.push(k);}
+  const pressureNow=inputs.pressure?this.window('pressure',now):null;
+  const pressurePast=inputs.pressure?this.window('pressure',now-3*3600000):null;
+  const windNow=inputs.wind?this.window('wind',now):null;
+  const windPast=inputs.wind?this.window('wind',now-3600000):null;
+  // Full pressure/wind baseline intervals must be continuous, not just their endpoints.
+  const continuous=(key,hours)=>{const h=(this.history[key]||[]).filter(x=>x.time>=now-(hours+.5)*3600000&&x.time<=now);return h.every((x,i)=>i===0||x.time-h[i-1].time<=10*60000);};
+  const dp=pressureNow!==null&&pressurePast!==null&&continuous('pressure',3)?pressureNow-pressurePast:null;
+  const dw=windNow!==null&&windPast!==null&&continuous('wind',1)?windNow-windPast:null;
+  let dewpoint=null,dewpointMethod=null;
+  const qualityFlags=[];
+  const coherent=keys=>{
+   const times=keys.filter(k=>inputs[k]).map(k=>inputs[k].time);
+   return times.length>0 && Math.max(...times)-Math.min(...times)<=2*60000;
+  };
+  let calculated=null;
+  if(inputs.temperature&&inputs.humidity){
+   if(coherent(['temperature','humidity'])){
+    const t=inputs.temperature.value-273.15,g=Math.log(inputs.humidity.value)+17.625*t/(243.04+t);
+    calculated=243.04*g/(17.625-g)+273.15;
+   } else qualityFlags.push('temperature_humidity_time_mismatch');
+  }
+  if(inputs.temperature&&inputs.dewpoint){
+   if(!coherent(['temperature','dewpoint']))qualityFlags.push('temperature_dewpoint_time_mismatch');
+   else if(inputs.dewpoint.value>inputs.temperature.value+.5)qualityFlags.push('dewpoint_above_air_temperature');
+   else if(calculated!==null && coherent(['temperature','humidity','dewpoint']) && Math.abs(calculated-inputs.dewpoint.value)>2)qualityFlags.push('dewpoint_humidity_disagreement');
+   else {dewpoint=inputs.dewpoint.value;dewpointMethod='supplied';}
+  } else if(calculated!==null){dewpoint=calculated;dewpointMethod='local_temperature_humidity';}
+  // Contradictory supplied moisture evidence is not silently replaced by a calculation.
+  if(qualityFlags.length){dewpoint=null;dewpointMethod=null;}
+  const spread=dewpoint!==null?inputs.temperature.value-dewpoint:null;
+  const airWater=inputs.water&&inputs.temperature?inputs.temperature.value-inputs.water.value:null;
+  const dewWater=inputs.water&&dewpoint!==null?dewpoint-inputs.water.value:null;
+  const waterContext=airWater===null?'unknown':airWater>0.5?'air_warmer_than_water':airWater<-.5?'water_warmer_than_air':'similar_temperatures';
+  const fogContext=dewWater===null||airWater===null?'unknown':airWater>0 && dewWater>=0?'cooling_to_saturation_possible':'cooling_to_saturation_not_indicated';
+  const reasons=[];
+  if(dp!==null)reasons.push(`Pressure ${dp>=0?'rose':'fell'} ${(Math.abs(dp)/100).toFixed(2)} hPa over three hours.`);
+  if(dw!==null)reasons.push(`Measured wind ${dw>=0?'increased':'decreased'} ${(Math.abs(dw)*1.943844).toFixed(1)} knots over one hour.`);
+  if(spread!==null)reasons.push(`Air temperature is ${spread.toFixed(1)} °C above dew point.`);
+  if(dp===null)missing.push('pressureHistory3h');if(dw===null)missing.push('windHistory1h');
+  if(airWater!==null)reasons.push(`Air is ${Math.abs(airWater).toFixed(1)} °C ${airWater>=0?'warmer':'cooler'} than the water measured at transducer depth.`);
+  if(fogContext==='cooling_to_saturation_possible')reasons.push('Water at transducer depth is at or below the air dew point; cooling toward saturation is possible if the surface is similar. Fog is not confirmed.');
+  if(qualityFlags.length)reasons.push('Moisture inputs disagree or differ in observation time; moisture and fog context are unknown.');
+  return {issuedAt:new Date(now).toISOString(),model:'local-assessment-2',mode:'local_observations',pressureState:dp===null?'unknown':dp<=-100?'falling':dp>=100?'rising':'small_change',windState:dw===null?'unknown':dw>=2/1.943844?'strengthening_observed':dw<=-2/1.943844?'easing_observed':'small_change',moistureState:spread===null?'unknown':spread<=2?'near_saturation':'larger_dewpoint_gap',windOutlook:'uncalibrated',waterContext,fogContext,qualityFlags,waterMeasurement:{depthM:this.waterDepthM,location:'water temperature sensor',surfaceTemperatureMeasured:false},measurements:{pressureChange3h:dp,windMedian30m:windNow,windChange1h:dw,dewpoint,dewpointSpread:spread,airWaterTemperatureDifference:airWater,dewpointWaterTemperatureDifference:dewWater},units:{pressureChange3h:'Pa',windMedian30m:'m/s',windChange1h:'m/s',dewpoint:'K',dewpointSpread:'K',airWaterTemperatureDifference:'K',dewpointWaterTemperatureDifference:'K'},dewpointMethod,inputs,missing,reasons};
+ }
+ save(){return {version:1,history:this.history,sources:this.sources,latest:this.latest};}
+ restore(data,now=Date.now()){
+  if(!data||data.version!==1)return;
+  // Replay persisted data through the same validation without inventing timestamps.
+  for(const key of Object.keys(PATHS)){
+   const h=(data.history&&data.history[key])||[];
+   const recent=data.latest&&data.latest[key];
+   for(const x of [...h,...(recent?[recent]:[])].sort((a,b)=>a.time-b.time)){
+    if(!Number.isFinite(x.time)||x.time>now||now-x.time>4*3600000)continue;
+    this.ingest({updates:[{timestamp:new Date(x.time).toISOString(),$source:x.source,values:[{path:PATHS[key],value:x.value}]}]},x.time);
+   }
+  }
+ }
+}
+module.exports={Assessment,PATHS};

package/barometer.js

@@ -0,0 +1,221 @@
+// Ship's Barometer modifications by SCarns, 2026. Derived from oyve/signalk-barometer-trend v2.3.4; see NOTICE and CHANGELOG.md.
+'use strict'
+const barometerTrend = require('barometer-trend');
+const map = require('./map');
+const lodash = require('lodash');
+
+const secondsToMilliseconds = (seconds) => seconds * 1000;
+const DEFAULT_SAMPLE_RATE = secondsToMilliseconds(60);
+const DEFAULT_ALTITUDE_CORRECTION = 0;
+
+let sampleRate = DEFAULT_SAMPLE_RATE; //default
+let altitudeCorrection = DEFAULT_ALTITUDE_CORRECTION;
+
+/**
+ * 
+ * @param {number} rate Pressure sample rate in milliseconds
+ */
+function setSampleRate(rate) {
+    if (!rate) return;
+    if (rate > 1200) rate = 1200;
+    if (rate < 60) rate = 60;
+
+    sampleRate = rate * 1000;
+    return sampleRate;
+}
+
+/**
+ * 
+ * @param {number} altitude Set Altitude correction in meters
+ * @returns 
+ */
+function setAltitudeCorrection(altitude = DEFAULT_ALTITUDE_CORRECTION) {
+    if (altitude === null && altitude === undefined) return;
+    altitudeCorrection = altitude
+}
+
+const SUBSCRIPTIONS = [
+    { path: 'environment.wind.directionTrue', period: secondsToMilliseconds(30), policy: "instant", minPeriod: secondsToMilliseconds(60), handle: (value) => onTrueWindUpdated(value) },
+    { path: 'navigation.position', period: secondsToMilliseconds(30), policy: "instant", minPeriod: secondsToMilliseconds(60), handle: (value) => onPositionUpdated(value) },
+    { path: 'navigation.gnss.antennaAltitude', period: secondsToMilliseconds(30), policy: "instant", minPeriod: secondsToMilliseconds(60), handle: (value) => onAltitudeUpdated(value) },
+    { path: 'environment.outside.temperature', period: secondsToMilliseconds(30), policy: "instant", minPeriod: secondsToMilliseconds(60), handle: (value) => onTemperatureUpdated(value) },
+    { path: 'environment.outside.pressure', period: sampleRate, handle: (value) => onPressureUpdated(value) }
+];
+
+const TEMPLATE_LATEST = {
+    twd: {
+        time: null,
+        value: null
+    },
+    position: {
+        time: null,
+        value: null
+    },
+    altitude: {
+        value: null
+    },
+    temperature: {
+        value: null
+    }
+}
+
+let latest = null;
+latest = lodash.cloneDeep(TEMPLATE_LATEST);
+
+/**
+ * 
+ * @param {Array<Object>} deltas Delta array of updates from SignalK
+ * @returns {Array<Object>} Delta array of message updates
+ */
+function onDeltasUpdate(deltas) {
+    if (!deltas || !Array.isArray(deltas.updates)) {
+        throw new Error("Deltas must contain an updates array");
+    }
+
+    let deltaValues = [];
+
+    deltas.updates.forEach(u => {
+        if (!u.values) {
+            return;
+        }
+        u.values.forEach((value) => {
+            let onDeltaUpdated = SUBSCRIPTIONS.find((d) => d.path === value.path);
+
+            if (onDeltaUpdated) {
+                let updates = onDeltaUpdated.handle(value.value);
+                //console.debug("Handle: " + JSON.stringify(value));
+
+                if (updates && updates.length > 0) {
+                    //console.debug(JSON.stringify(updates));
+                    updates.forEach((update) => deltaValues.push(update));
+                }
+            }
+        });
+    });
+
+    return deltaValues;
+}
+
+function onPositionUpdated(value) {
+    latest.position.time = Date.now();
+    latest.position.value = value;
+}
+
+function onTemperatureUpdated(value) {
+    latest.temperature.value = value;
+}
+
+function onAltitudeUpdated(value) {
+    latest.altitude.value = value + altitudeCorrection;
+}
+
+function radiansToDegrees(value) {
+    if (!Number.isFinite(value)) return null;
+    return ((value * 180 / Math.PI) % 360 + 360) % 360;
+}
+
+function onTrueWindUpdated(value) {
+    const direction = radiansToDegrees(value);
+    latest.twd.time = direction !== null ? Date.now() : null;
+    latest.twd.value = direction;
+}
+
+/**
+ * 
+ * @param {number} value Pressure value in (Pa) Pascal.
+ * @returns {Array<[{path:path, value:value}]>} Delta JSON-array of updates
+ */
+function onPressureUpdated(value) {
+    if (!Number.isFinite(value) || value <= 0) return;
+
+    addPressure(
+        new Date(),
+        value,
+        latest.altitude.value,
+        latest.temperature.value,
+        hasTWDWithinOneMinute() ? latest.twd.value : null);
+
+    let json = barometerTrend.getPredictions(isNorthernHemisphere());
+
+    return map.mapProperties(json);
+}
+
+function addPressure(datetime, value, altitude, temperature, twd) {
+    barometerTrend.addPressure(datetime, value, altitude, temperature, twd);
+
+    // Keep the existing history array, marking angles to avoid conversion on restart.
+    const readings = barometerTrend.getAll();
+    const reading = readings[readings.length - 1];
+    if (reading) reading.meta.twdUnits = 'deg';
+}
+
+function clear() {
+    barometerTrend.clear();
+    latest = lodash.cloneDeep(TEMPLATE_LATEST);
+    setAltitudeCorrection(DEFAULT_ALTITUDE_CORRECTION);
+    setSampleRate(DEFAULT_SAMPLE_RATE);
+}
+
+function hasTWDWithinOneMinute() {
+    return latest.twd.time !== null ? (Date.now() - latest.twd.time) <= secondsToMilliseconds(60) : false;
+}
+
+function hasPositionWithinOneMinute() {
+    return latest.position.time !== null ? (Date.now() - latest.position.time) <= secondsToMilliseconds(60) : false;
+}
+
+function isNorthernHemisphere() {
+    let position = hasPositionWithinOneMinute() ? latest.position.value : null;
+    if (position === null) return true; //default to northern hemisphere
+
+    return position.latitude < 0 ? false : true;
+}
+
+function getAll() {
+    return barometerTrend.getAll();
+}
+
+function persist(persistCallback) {
+    let json = getAll();
+    persistCallback(json);
+}
+
+function populate(populateCallback) {
+    let barometerData = populateCallback();
+
+    if (barometerData) {
+        barometerData.forEach((bd) => {
+            // Stock 2.3.4 history stored Signal K radians; this build stores degrees.
+            const direction = bd.meta.twdUnits === 'deg'
+                ? bd.meta.twd
+                : radiansToDegrees(bd.meta.twd);
+            addPressure(bd.datetime, bd.meta.value, bd.meta.altitude, bd.meta.temperature, direction);
+        });
+    }
+}
+
+function JSONParser(content) {
+    return JSON.parse(content, (key, value) => {
+        if (key == "datetime") {
+            return new Date(value);
+        } else {
+            return value;
+        }
+    })
+};
+
+module.exports = {
+    SUBSCRIPTIONS,
+    hasTWDWithinOneMinute,
+    isNortherHemisphere: isNorthernHemisphere,
+    hasPositionWithinOneMinute,
+    onDeltasUpdate,
+    clear,
+    getLatest: () => latest,
+    setSampleRate,
+    setAltitudeCorrection,
+    persist,
+    populate,
+    getAll,
+    JSONParser
+}

package/docs/installation.md

@@ -0,0 +1,29 @@
+# Installation and migration
+
+Ship's Barometer is a separate plugin (`signalk-ships-barometer`) with a separate settings/data directory. The release tarball contains its runtime dependencies. It preserves the old forecast paths for existing displays, not the old plugin ID.
+
+1. Keep your normal Signal K settings/data backup.
+2. Install the release tarball from the Signal K user directory.
+3. Disable the original **Barometer Trend** plugin; both must not publish concurrently.
+4. Restart Signal K and enable **Ship's Barometer**. Re-enter the desired pressure sample rate and altitude correction because settings belong to the new plugin ID.
+5. Enable **Local weather assessment** if wanted. Inspect `environment.outside.weather.assessment` in Data Browser; new fields do not automatically create dashboard widgets.
+
+The old plugin's history/configuration are not deleted or silently copied. With a new data directory, forecast history and the optional assessment start filling from new observations. If retaining history is important, stop both plugins and copy the old plugin data directory's `offline.json` into the new plugin's data directory; optional assessment history is `local-assessment.json`. Locate the actual directories from your Signal K installation instead of assuming a path. Only copy your own local history, not a package's empty `offline.json`. The saved file formats remain compatible with the tested local `2.3.4-tbd.3` build; legacy radians are converted once on loading.
+
+## Assessment sources
+
+Use exact IDs from Data Browser. In the development boat's archive, useful IDs were pressure/temperature **Outside**, true wind **AdvancedWind**, and humidity **signalk-node-red**. These are installation-specific suggestions, not defaults or proof of current IDs.
+
+The water input is `environment.water.temperature`. Select the speed transducer's source if several local water sources exist. For a sensor two feet below the surface, enter **0.6096** in the water-depth field. Leave depth unset when unknown; the assessment does not claim to measure surface temperature.
+
+Freshness limits: wind five minutes; air temperature, humidity and supplied dew point ten minutes; pressure twenty-five minutes; water thirty minutes. Original timestamps/source IDs are required. Pressure/wind comparisons use trailing thirty-minute medians and require continuity with no gaps over ten minutes. Expect roughly ninety minutes for wind-change history and three and a half hours for pressure-change history.
+
+Temperature/humidity and supplied dew point must agree in time within two minutes. A supplied dew point above air temperature by over 0.5 °C, or disagreeing with the synchronized local temperature/humidity estimate by over 2 °C, is flagged. Moisture/fog context then becomes unknown. These are experimental quality thresholds, not calibrated sensor specifications.
+
+`fogContext: cooling_to_saturation_possible` means air is warmer than measured water and measured water is at/below the usable air dew point. It depends on surface water being similar to the transducer measurement. Fog is not confirmed. `cooling_to_saturation_not_indicated` concerns only this mechanism, not all possible fog types.
+
+## Rollback
+
+Disable Ship's Barometer and re-enable the old plugin. Its original settings/data remain in its separate directory. Do not enable both simultaneously. Returning to stock 2.3.4 after using corrected degree history requires restoring the old pre-correction history or waiting for that mixed history to expire; a corrected `2.3.4-tbd.*` version is the cleaner rollback baseline.
+
+If npm reports a missing tarball for another installed plugin, restore that plugin's referenced tarball or repair its dependency reference first. npm resolves the shared dependency list during installation even when installing a different plugin.