Add plain-language summary + umbrella tip for today

Neither Met Office's Global Spot API nor Open-Meteo return a narrative text
summary -- both are purely numeric/coded. New lib/summary.js derives one
rule-based from today's already-fetched hourly points (icon + precip_prob),
no extra API call, no LLM:
- Headline: "Scattered showers today", "Rain likely later", "Heavy rain
  today", "Dry today", etc. -- compares rain distribution across the whole
  day vs specifically the hours still ahead of "now".
- Note: "Thunderstorms possible", appended when a thunder icon shows up.
- Umbrella nudge: shown when there's a real rain chance now or later today.

Computed fresh per-request (not cached at fetch time), since "later" means
later than whoever's looking at the screen right now, not later than the
last hourly refresh.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
jtricerolph 2026-08-25 13:03:24 +00:00
parent 3beac76ae6
commit 435b59b3fe
5 changed files with 114 additions and 4 deletions

View file

@ -0,0 +1,68 @@
// Plain-language summary of today's forecast ("Scattered showers today",
// "Rain likely later", "Don't forget your umbrella"...). Neither Met Office's Global
// Spot API nor Open-Meteo return anything like this — both are purely numeric/coded
// (temps, weather codes, precip%) — so this is generated from today's already-fetched
// hourly points (icon + precip_prob), rule-based, no extra API call and no LLM.
//
// Computed fresh per-request in routes/forecast.js (not stored/cached at fetch time),
// since "later" is relative to whoever's looking at the screen right now, not to when
// the hourly data was last fetched.
const RAIN_ICONS = new Set(['drizzle', 'rain-light', 'rain-heavy', 'sleet', 'hail'])
const SNOW_ICONS = new Set(['snow-light', 'snow-heavy'])
// summarizeToday(points, nowHour) — `points` is today's hourly forecast_points rows
// (already icon-normalized), `nowHour` is 0-23 in Europe/London. Returns null if
// there's nothing to summarize (no data yet).
export function summarizeToday(points, nowHour) {
if (!points.length) return null
const isRain = p => RAIN_ICONS.has(p.icon)
const isSnow = p => SNOW_ICONS.has(p.icon)
const isThunder = p => p.icon === 'thunder'
const isHeavyRain = p => p.icon === 'rain-heavy'
const rainPoints = points.filter(isRain)
const snowPoints = points.filter(isSnow)
const thunderPoints = points.filter(isThunder)
const rainFraction = rainPoints.length / points.length
const snowFraction = snowPoints.length / points.length
const laterPoints = points.filter(p => hourOf(p) >= nowHour)
const earlierPoints = points.filter(p => hourOf(p) < nowHour)
const laterWetFraction = laterPoints.length
? laterPoints.filter(p => isRain(p) || isThunder(p)).length / laterPoints.length
: 0
const earlierWetCount = earlierPoints.filter(p => isRain(p) || isThunder(p)).length
let headline
if (snowFraction > 0.3) {
headline = 'Snow expected today'
} else if (rainPoints.length === 0 && thunderPoints.length === 0) {
headline = 'Dry today'
} else if (rainPoints.some(isHeavyRain) && rainFraction > 0.5) {
headline = 'Heavy rain today'
} else if (rainFraction > 0.6) {
headline = 'Rain likely for much of the day'
} else if (laterWetFraction > 0.4 && earlierWetCount === 0) {
headline = 'Rain likely later'
} else if (rainFraction > 0) {
headline = 'Scattered showers today'
} else {
headline = 'Thunderstorms possible'
}
// Append rather than replace the headline when thunder shows up alongside a
// rain pattern that already earned its own headline above.
const note = thunderPoints.length > 0 && headline !== 'Thunderstorms possible'
? 'Thunderstorms possible'
: null
// Umbrella nudge: real rain chance either right now or coming up later today.
const umbrella = laterWetFraction > 0.25 || rainFraction > 0.25
return { headline, note, umbrella }
}
function hourOf(point) {
return parseInt(new Date(point.ts).toLocaleString('en-GB', { timeZone: 'Europe/London', hour: '2-digit', hour12: false }))
}

View file

@ -1,6 +1,7 @@
import { pool, getStatus } from '../db.js'
import { requireAuth, requireCap } from '../auth.js'
import { refreshForecast } from '../lib/weather-fetch.js'
import { summarizeToday } from '../lib/summary.js'
function rowToPoint(r) {
return {
@ -23,13 +24,19 @@ async function buildPayload() {
`SELECT date, sunrise, sunset FROM forecast_astro ORDER BY date ASC`
)
const status = await getStatus()
const hourly = rows.filter(r => r.resolution === 'hourly').map(rowToPoint)
// "Later" is relative to whoever's looking at the screen right now, not to when
// the hourly data was last fetched — compute this fresh per-request, not at
// refresh time (see lib/summary.js).
const nowHour = parseInt(new Date().toLocaleString('en-GB', { timeZone: 'Europe/London', hour: '2-digit', hour12: false }))
return {
hourly: rows.filter(r => r.resolution === 'hourly').map(rowToPoint),
hourly,
threeHourly: rows.filter(r => r.resolution === '3hourly').map(rowToPoint),
daily: rows.filter(r => r.resolution === 'daily').map(rowToPoint),
// Keyed by date (YYYY-MM-DD, London-local) so the frontend can look up
// today/tomorrow/day-after's sunrise+sunset next to each section's label.
astro: Object.fromEntries(astroRows.map(r => [r.date, { sunrise: r.sunrise, sunset: r.sunset }])),
summary: summarizeToday(hourly, nowHour),
meta: {
fetched_at: status.last_fetch_at ?? null,
provider: status.last_provider ?? null,