Skip to content

Prepare for semi-distributed model gauge rename and update dependencies (v1.1.1) - #11

Merged
chriselsen merged 1 commit into
mainfrom
feature/semi-distributed-model-prep
Nov 6, 2026
Merged

chriselsen merged 1 commit into
mainfrom
feature/semi-distributed-model-prep

Conversation

@chriselsen

Copy link
Copy Markdown
Contributor

Why

Google Flood Hub is switching to a semi-distributed riverine model in late November 2026. Gauge IDs change from hybas_<id> to subhybas_<id>, some gauges move between low and high confidence, and data is only available for the new gauges from the launch date.

The ETL treats gauge IDs as opaque and needs no configuration change. The one gap is the gauge cache: thresholds are cached per gauge ID, so after the rename the Thresholds and Forecast sections of the remarks would be empty for up to GAUGE_REFRESH_HOURS (24 h by default).

Changes

  • Refresh the gauge cache early when more than 25% of the current flood status gauges have no cached model, at most once an hour. Behaviour is unchanged while the cached IDs match the API.
  • Document the model change in the README, and mention both ID formats in the gaugeId output schema description.
  • Update @tak-ps/etl to 10.26.0, eslint to 10.14.0 and typescript-eslint to 8.72.1, with package.json ranges raised to match.
  • Replace the stale fast-xml-parser override (the package is no longer in the tree) with a minimatch ^11.0.1 override for GHSA-g3hv-75wg-m249.
  • Bump the version to 1.1.1 and add a CHANGELOG entry.

npm audit went from 17 vulnerabilities (3 high in undici, 14 moderate from minimatch) to 0.

Not included

  • @tak-ps/etl 11.0.0: changes the published output schema format and targets CloudTAK v14.
  • typescript 7.0.2: not supported by typescript-eslint (requires below 6.1.0).

Verification

  • npm run lint, npm run build and npm test pass (5 tests).
  • npm audit and npm audit --omit=dev report 0 vulnerabilities.
  • The early-refresh logic has not been exercised against the live API or a simulated ID rename.

Notes

  • After the rename, the CoT UIDs (floodhub-<gaugeId>) change. Markers for the old gauges should expire at their stale time. This has not been confirmed in CloudTAK.
  • The minimatch override can be removed once eslint and typescript-eslint require a patched release.

…es (v1.1.1)

- Refresh the gauge cache early when over 25% of current gauges have no
  cached model (at most hourly), so thresholds and forecasts return
  quickly after the hybas_ to subhybas_ gauge ID rename
- Document the Flood Hub model change in the README
- Update @tak-ps/etl, eslint and typescript-eslint; add a minimatch
  override and drop the stale fast-xml-parser override so npm audit
  reports 0 vulnerabilities
@chriselsen
chriselsen merged commit d0ef5f2 into main Nov 6, 2026
1 check passed
@chriselsen
chriselsen deleted the feature/semi-distributed-model-prep branch November 6, 2026 02:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant