@danceiny/gotry 0.0.1-rc.21 → 0.0.1-rc.24

package/dist/capabilities/weather.js

@@ -1,357 +1,285 @@
+/**
+ * Open-Meteo 天气能力层(免费无 key):预报 + 历史气候回退。
+ *
+ * 产品定位:替代 LLM 的「雨季常识」——季节性建议、窗口内降雨概率、
+ * 体感温度范围,全部走真实数据并带证据标注 [实时API:open-meteo@ts]。
+ *
+ * 契约(与 hbcli.ts 同构,能力层不变量):
+ *   - 永不抛错:网络失败/超时/解析失败一律降级返回,不穿透到调用方;
+ *   - 证据链标注:成功带 [实时API:open-meteo@ts],失败带 [实时API:open-meteo@error@ts];
+ *   - 免费源无配额概念,但仍记录 latency(供 L5 成本工程度量)。
+ *
+ * 端点(全部免费,无 key):
+ *   预报: https://api.open-meteo.com/v1/forecast (≤16 天)
+ *   历史气候: https://archive-api.open-meteo.com/v1/archive (1940→,做季节性)
+ *   地理编码: https://geocoding-api.open-meteo.com/v1/search (地名→坐标)
+ */
 const FORECAST_BASE = 'https://api.open-meteo.com/v1/forecast';
 const ARCHIVE_BASE = 'https://archive-api.open-meteo.com/v1/archive';
 const GEOCODE_BASE = 'https://geocoding-api.open-meteo.com/v1/search';
+/** WMO weather code → 中文描述(节选最常用的码) */
 const WMO_ZH = {
-    0: '晴',
-    1: '大致晴',
-    2: '多云',
-    3: '阴',
-    45: '雾',
-    48: '冻雾',
-    51: '毛毛雨',
-    53: '毛毛雨',
-    55: '密集毛毛雨',
-    61: '小雨',
-    63: '中雨',
-    65: '大雨',
-    66: '冻雨',
-    67: '强冻雨',
-    71: '小雪',
-    73: '中雪',
-    75: '大雪',
-    77: '雪粒',
-    80: '阵雨',
-    81: '强阵雨',
-    82: '暴雨',
-    85: '阵雪',
-    86: '强阵雪',
-    95: '雷暴',
-    96: '雷暴伴小冰雹',
-    99: '雷暴伴大冰雹'
+    0: '晴', 1: '大致晴', 2: '多云', 3: '阴',
+    45: '雾', 48: '冻雾',
+    51: '毛毛雨', 53: '毛毛雨', 55: '密集毛毛雨',
+    61: '小雨', 63: '中雨', 65: '大雨',
+    66: '冻雨', 67: '强冻雨',
+    71: '小雪', 73: '中雪', 75: '大雪', 77: '雪粒',
+    80: '阵雨', 81: '强阵雨', 82: '暴雨',
+    85: '阵雪', 86: '强阵雪',
+    95: '雷暴', 96: '雷暴伴小冰雹', 99: '雷暴伴大冰雹',
 };
 export function wmoLabel(code) {
     return WMO_ZH[code] ?? `天气码${code}`;
 }
-const monotonicNow = ()=>performance.now();
+const monotonicNow = () => performance.now();
 const MIN_TIMER_MS = 1;
 const TIMEOUT_ERROR = 'timeoutMs must be a finite positive integer';
 const BUDGET_EXHAUSTED_ERROR = 'total timeout budget exhausted';
 const REQUEST_ERROR = 'request failed';
-const normalizeTimeout = (value)=>Number.isInteger(value) && value > 0 ? value : null;
-const normalizeError = (value)=>{
+const normalizeTimeout = (value) => Number.isInteger(value) && value > 0 ? value : null;
+/** Rejection values are untrusted: only a real string message is safe to expose. */
+const normalizeError = (value) => {
     try {
         if (value instanceof Error && typeof value.message === 'string' && value.message.length > 0) {
             return value.message.slice(0, 200);
         }
-        if (typeof value === 'string' && value.length > 0) return value.slice(0, 200);
-    } catch  {
+        if (typeof value === 'string' && value.length > 0)
+            return value.slice(0, 200);
+    }
+    catch {
         return REQUEST_ERROR;
     }
     return REQUEST_ERROR;
 };
 async function fetchJson(url, timeoutMs, headers = {}, fetchImpl = globalThis.fetch) {
-    if (!Number.isFinite(timeoutMs) || timeoutMs < MIN_TIMER_MS) return {
-        ok: false,
-        error: BUDGET_EXHAUSTED_ERROR
-    };
+    if (!Number.isFinite(timeoutMs) || timeoutMs < MIN_TIMER_MS)
+        return { ok: false, error: BUDGET_EXHAUSTED_ERROR };
     const ctrl = new AbortController();
     const timerDelay = Math.floor(timeoutMs);
-    if (timerDelay < MIN_TIMER_MS) return {
-        ok: false,
-        error: BUDGET_EXHAUSTED_ERROR
-    };
+    if (timerDelay < MIN_TIMER_MS)
+        return { ok: false, error: BUDGET_EXHAUSTED_ERROR };
     let timer;
     let timedOut = false;
-    const timeout = new Promise((_, reject)=>{
-        timer = setTimeout(()=>{
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => {
             timedOut = true;
             ctrl.abort();
             reject(new Error(`timeout after ${timeoutMs}ms`));
         }, timerDelay);
     });
-    const operation = (async ()=>{
-        const res = await fetchImpl(url, {
-            signal: ctrl.signal,
-            headers: {
-                Accept: 'application/json',
-                ...headers
-            }
-        });
-        if (!res.ok) return {
-            ok: false,
-            error: `HTTP ${res.status}`
-        };
-        return {
-            ok: true,
-            data: await res.json()
-        };
+    const operation = (async () => {
+        const res = await fetchImpl(url, { signal: ctrl.signal, headers: { Accept: 'application/json', ...headers } });
+        if (!res.ok)
+            return { ok: false, error: `HTTP ${res.status}` };
+        return { ok: true, data: await res.json() };
     })();
     try {
-        return await Promise.race([
-            operation,
-            timeout
-        ]);
-    } catch (e) {
-        return {
-            ok: false,
-            error: normalizeError(e),
-            ...timedOut ? {
-                timedOut: true
-            } : {}
-        };
-    } finally{
-        if (timer !== undefined) clearTimeout(timer);
-        void operation.catch(()=>undefined);
+        return await Promise.race([operation, timeout]);
+    }
+    catch (e) {
+        return { ok: false, error: normalizeError(e), ...(timedOut ? { timedOut: true } : {}) };
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+        void operation.catch(() => undefined);
     }
 }
 const NOMINATIM_BASE = 'https://nominatim.openstreetmap.org/search';
+/** 行政级/人口重镇 feature_code(open-meteo 命名惯例):PPLC=首都 PPLA*=首府 PPLB=城镇 PPLX=区片 */
 const MAJOR_FEATURE = /^(PPLC|PPLA|PPLB|PPLX)/;
-const isRecord = (value)=>value !== null && typeof value === 'object' && !Array.isArray(value);
+const isRecord = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
 function stripHits(hits) {
-    return hits.map(({ name, latitude, longitude, country, admin1 })=>({
-            ...country ? {
-                country
-            } : {},
-            ...admin1 ? {
-                admin1
-            } : {},
-            name,
-            latitude,
-            longitude
-        }));
+    return hits.map(({ name, latitude, longitude, country, admin1 }) => ({ ...(country ? { country } : {}), ...(admin1 ? { admin1 } : {}), name, latitude, longitude }));
 }
+/** 地名 → 坐标(双源,供 dsh 工具把「大理」转成经纬度):
+ *  1. Open-Meteo(主源):命中按人口/行政级降序——「大理」会同时命中云南州府与四川同名乡,不能盲信次序;
+ *  2. Nominatim(兜底):open-meteo 的中文名覆盖有洞(实测(issue #24)「普吉岛」0 结果、
+ *     裸词「普吉」错配西藏林芝同名村),弱命中/零结果时走 Nominatim 拿正确目标,
+ *     兜底仍空则回退 open-meteo 弱结果(不比此前更差)。 */
 export async function geocodePlace(name, opts = {}) {
     const ts = new Date().toISOString();
     const count = opts.count ?? 5;
     const query = name.trim();
     const timeoutMs = normalizeTimeout(opts.timeoutMs ?? 15_000);
-    if (timeoutMs === null) return {
-        ok: false,
-        evidence: `[实时API:open-meteo-geo@error@${ts}]`,
-        results: [],
-        error: TIMEOUT_ERROR
-    };
+    if (timeoutMs === null)
+        return { ok: false, evidence: `[实时API:open-meteo-geo@error@${ts}]`, results: [], error: TIMEOUT_ERROR };
     const omUrl = `${GEOCODE_BASE}?name=${encodeURIComponent(query)}&count=${count}&language=zh&format=json`;
+    // timeoutMs is a budget for the complete primary→fallback chain, not per request.
     const deadline = monotonicNow() + timeoutMs;
-    const remaining = ()=>{
+    const remaining = () => {
         const value = deadline - monotonicNow();
         return Number.isFinite(value) && value >= MIN_TIMER_MS ? value : null;
     };
     const primaryRemaining = remaining();
-    const r = primaryRemaining === null ? {
-        ok: false,
-        error: BUDGET_EXHAUSTED_ERROR
-    } : await fetchJson(omUrl, primaryRemaining, {}, opts.fetchImpl);
+    const r = primaryRemaining === null
+        ? { ok: false, error: BUDGET_EXHAUSTED_ERROR }
+        : await fetchJson(omUrl, primaryRemaining, {}, opts.fetchImpl);
     const primaryPayload = r.ok && isRecord(r.data) && Array.isArray(r.data['results']) ? r.data['results'] : null;
-    const omResults = primaryPayload ? primaryPayload.map((item)=>{
-        if (!isRecord(item)) return null;
-        const it = item;
-        return {
-            name: String(it['name'] ?? ''),
-            latitude: Number(it['latitude']),
-            longitude: Number(it['longitude']),
-            country: it['country'] ? String(it['country']) : undefined,
-            admin1: it['admin1'] ? String(it['admin1']) : undefined,
-            population: Number(it['population'] ?? 0) || 0,
-            featureCode: String(it['feature_code'] ?? '')
-        };
-    }).filter((h)=>!!h && !!h.name && Number.isFinite(h.latitude) && Number.isFinite(h.longitude)) : [];
-    omResults.sort((a, b)=>b.population - a.population || Number(MAJOR_FEATURE.test(b.featureCode)) - Number(MAJOR_FEATURE.test(a.featureCode)));
+    const omResults = primaryPayload
+        ? primaryPayload.map((item) => {
+            if (!isRecord(item))
+                return null;
+            const it = item;
+            return {
+                name: String(it['name'] ?? ''),
+                latitude: Number(it['latitude']),
+                longitude: Number(it['longitude']),
+                country: it['country'] ? String(it['country']) : undefined,
+                admin1: it['admin1'] ? String(it['admin1']) : undefined,
+                population: Number(it['population'] ?? 0) || 0,
+                featureCode: String(it['feature_code'] ?? ''),
+            };
+        }).filter((h) => !!h && !!h.name && Number.isFinite(h.latitude) && Number.isFinite(h.longitude))
+        : [];
+    omResults.sort((a, b) => (b.population - a.population) || (Number(MAJOR_FEATURE.test(b.featureCode)) - Number(MAJOR_FEATURE.test(a.featureCode))));
     const top = omResults[0];
+    // 强命中:有人口规模或主要行政级,直接采信(「深圳市」「曼谷」路径不变)
     if (top && (top.population > 0 || MAJOR_FEATURE.test(top.featureCode))) {
-        return {
-            ok: true,
-            evidence: `[实时API:open-meteo-geo@${ts}]`,
-            via: 'open-meteo',
-            results: stripHits(omResults)
-        };
+        return { ok: true, evidence: `[实时API:open-meteo-geo@${ts}]`, via: 'open-meteo', results: stripHits(omResults) };
     }
+    // 弱命中/零结果/主源请求失败:Nominatim 兜底(免费无 key;中文 accept-language)
     const nomTs = new Date().toISOString();
     const nomUrl = `${NOMINATIM_BASE}?q=${encodeURIComponent(query)}&format=jsonv2&limit=${count}&accept-language=zh&addressdetails=1`;
     const fallbackRemaining = primaryRemaining === null || r.timedOut ? null : remaining();
-    const nom = fallbackRemaining === null ? {
-        ok: false,
-        error: BUDGET_EXHAUSTED_ERROR
-    } : await fetchJson(nomUrl, fallbackRemaining, {
-        'User-Agent': 'gotry-travel-agent/0.1 (+https://github.com/Danceiny/gotry)'
-    }, opts.fetchImpl);
+    const nom = fallbackRemaining === null
+        ? { ok: false, error: BUDGET_EXHAUSTED_ERROR }
+        : await fetchJson(nomUrl, fallbackRemaining, { 'User-Agent': 'gotry-travel-agent/0.1 (+https://github.com/Danceiny/gotry)' }, opts.fetchImpl);
     const nomResults = [];
     if (nom.ok && Array.isArray(nom.data)) {
-        const parsedNom = nom.data.map((item)=>{
-            if (!isRecord(item)) return null;
+        const parsedNom = nom.data.map((item) => {
+            if (!isRecord(item))
+                return null;
             const it = item;
             const addr = isRecord(it['address']) ? it['address'] : {};
             const country = typeof addr['country'] === 'string' ? addr['country'] : undefined;
-            const admin1 = [
-                addr['province'],
-                addr['state'],
-                addr['county']
-            ].find((v)=>typeof v === 'string');
-            return {
-                name: String(it['name'] ?? ''),
-                latitude: Number(it['lat']),
-                longitude: Number(it['lon']),
-                ...country ? {
-                    country
-                } : {},
-                ...admin1 ? {
-                    admin1
-                } : {}
-            };
-        }).filter((h)=>!!h && !!h.name && Number.isFinite(h.latitude) && Number.isFinite(h.longitude));
+            const admin1 = [addr['province'], addr['state'], addr['county']].find(v => typeof v === 'string');
+            return { name: String(it['name'] ?? ''), latitude: Number(it['lat']), longitude: Number(it['lon']), ...(country ? { country } : {}), ...(admin1 ? { admin1 } : {}) };
+        }).filter((h) => !!h && !!h.name && Number.isFinite(h.latitude) && Number.isFinite(h.longitude));
         nomResults.push(...parsedNom);
     }
     if (nomResults.length) {
-        const omNote = r.ok ? `open-meteo ${omResults.length} 条弱命中(无人口/行政级,不足采信)` : `open-meteo 失败:${r.error ?? 'HTTP error'}`;
-        return {
-            ok: true,
-            evidence: `[实时API:nominatim@${nomTs}](兜底层: ${omNote})`,
-            via: 'nominatim',
-            results: nomResults
-        };
+        const omNote = r.ok
+            ? `open-meteo ${omResults.length} 条弱命中(无人口/行政级,不足采信)`
+            : `open-meteo 失败:${r.error ?? 'HTTP error'}`;
+        return { ok: true, evidence: `[实时API:nominatim@${nomTs}](兜底层: ${omNote})`, via: 'nominatim', results: nomResults };
     }
+    // 双源皆空/兜底失败:open-meteo 有弱结果仍返回(同构「降级不阻塞」契约),否则维持失败终态
     if (omResults.length) {
-        return {
-            ok: true,
-            evidence: `[实时API:open-meteo-geo@${ts}]`,
-            via: 'open-meteo',
-            results: stripHits(omResults)
-        };
+        return { ok: true, evidence: `[实时API:open-meteo-geo@${ts}]`, via: 'open-meteo', results: stripHits(omResults) };
     }
     return {
         ok: false,
         evidence: `[实时API:open-meteo-geo@error@${ts}];[实时API:nominatim@error@${nomTs}]`,
         results: [],
-        error: r.ok ? `双源无结果:${nom.error ?? 'nominatim empty'}` : r.error
+        error: r.ok ? `双源无结果:${nom.error ?? 'nominatim empty'}` : (r.error),
     };
 }
+/** 未来天气预报(≤16 天) */
 export async function getForecast(point, opts = {}) {
     const started = monotonicNow();
     const ts = new Date().toISOString();
     const requestedDays = opts.days ?? 7;
     const days = Number.isInteger(requestedDays) && requestedDays > 0 ? Math.min(requestedDays, 16) : 0;
     const timeoutMs = normalizeTimeout(opts.timeoutMs ?? 15_000);
-    if (days < 1 || timeoutMs === null) return {
-        ok: false,
-        via: 'open-meteo-error',
-        evidence: `[实时API:open-meteo@error@${ts}]`,
-        latencyMs: monotonicNow() - started,
-        error: days < 1 ? 'days must be valid positive values' : TIMEOUT_ERROR
-    };
-    const url = `${FORECAST_BASE}?latitude=${point.latitude}&longitude=${point.longitude}` + `&daily=temperature_2m_max,temperature_2m_min,precipitation_probability_max,weathercode` + `&forecast_days=${days}&timezone=auto`;
+    if (days < 1 || timeoutMs === null)
+        return { ok: false, via: 'open-meteo-error', evidence: `[实时API:open-meteo@error@${ts}]`, latencyMs: monotonicNow() - started, error: days < 1 ? 'days must be valid positive values' : TIMEOUT_ERROR };
+    const url = `${FORECAST_BASE}?latitude=${point.latitude}&longitude=${point.longitude}`
+        + `&daily=temperature_2m_max,temperature_2m_min,precipitation_probability_max,weathercode`
+        + `&forecast_days=${days}&timezone=auto`;
     const r = await fetchJson(url, timeoutMs, {}, opts.fetchImpl);
     const latencyMs = monotonicNow() - started;
     if (!r.ok) {
-        return {
-            ok: false,
-            via: 'open-meteo-error',
-            evidence: `[实时API:open-meteo@error@${ts}]`,
-            latencyMs,
-            error: r.error
-        };
+        return { ok: false, via: 'open-meteo-error', evidence: `[实时API:open-meteo@error@${ts}]`, latencyMs, error: r.error };
     }
     const payload = isRecord(r.data) ? r.data : null;
     const daily = isRecord(payload?.['daily']) ? payload['daily'] : null;
-    if (!daily || !Array.isArray(daily.time) || !Array.isArray(daily.temperature_2m_max) || !Array.isArray(daily.temperature_2m_min) || !Array.isArray(daily.weathercode) || daily.time.length !== days || daily.temperature_2m_max.length !== days || daily.temperature_2m_min.length !== days || daily.weathercode.length !== days || daily.time.some((v)=>typeof v !== 'string') || daily.temperature_2m_max.some((v)=>typeof v !== 'number' || !Number.isFinite(v)) || daily.temperature_2m_min.some((v)=>typeof v !== 'number' || !Number.isFinite(v)) || daily.weathercode.some((v)=>typeof v !== 'number' || !Number.isFinite(v)) || daily.precipitation_probability_max !== undefined && daily.precipitation_probability_max !== null && !Array.isArray(daily.precipitation_probability_max) || Array.isArray(daily.precipitation_probability_max) && (daily.precipitation_probability_max.length !== days || daily.precipitation_probability_max.some((v)=>v !== null && (typeof v !== 'number' || !Number.isFinite(v))))) {
-        return {
-            ok: false,
-            via: 'open-meteo-error',
-            evidence: `[实时API:open-meteo@error@${ts}]`,
-            latencyMs,
-            error: 'empty daily payload'
-        };
+    if (!daily || !Array.isArray(daily.time) || !Array.isArray(daily.temperature_2m_max)
+        || !Array.isArray(daily.temperature_2m_min) || !Array.isArray(daily.weathercode)
+        || daily.time.length !== days || daily.temperature_2m_max.length !== days
+        || daily.temperature_2m_min.length !== days || daily.weathercode.length !== days
+        || daily.time.some(v => typeof v !== 'string')
+        || daily.temperature_2m_max.some(v => typeof v !== 'number' || !Number.isFinite(v))
+        || daily.temperature_2m_min.some(v => typeof v !== 'number' || !Number.isFinite(v))
+        || daily.weathercode.some(v => typeof v !== 'number' || !Number.isFinite(v))
+        || (daily.precipitation_probability_max !== undefined && daily.precipitation_probability_max !== null
+            && !Array.isArray(daily.precipitation_probability_max))
+        || (Array.isArray(daily.precipitation_probability_max)
+            && (daily.precipitation_probability_max.length !== days
+                || daily.precipitation_probability_max.some(v => v !== null && (typeof v !== 'number' || !Number.isFinite(v)))))) {
+        return { ok: false, via: 'open-meteo-error', evidence: `[实时API:open-meteo@error@${ts}]`, latencyMs, error: 'empty daily payload' };
     }
     const times = daily.time;
     const maxes = daily.temperature_2m_max;
     const mins = daily.temperature_2m_min;
     const codes = daily.weathercode;
-    const precip = Array.isArray(daily.precipitation_probability_max) ? daily.precipitation_probability_max : undefined;
-    const rows = times.map((date, i)=>({
-            date,
-            tempMaxC: maxes[i],
-            tempMinC: mins[i],
-            precipProbMaxPct: precip?.[i] ?? null,
-            weatherCode: codes[i]
-        }));
+    const precip = Array.isArray(daily.precipitation_probability_max)
+        ? daily.precipitation_probability_max
+        : undefined;
+    const rows = times.map((date, i) => ({
+        date, tempMaxC: maxes[i], tempMinC: mins[i], precipProbMaxPct: precip?.[i] ?? null, weatherCode: codes[i],
+    }));
     return {
-        ok: true,
-        via: 'open-meteo',
+        ok: true, via: 'open-meteo',
         evidence: `[实时API:open-meteo@${ts}]`,
         latencyMs,
         timezone: typeof payload?.['timezone'] === 'string' ? payload['timezone'] : undefined,
-        daily: rows
+        daily: rows,
     };
 }
+/** 历史气候(季节性推荐底座:去年同期日均温/降雨概率) */
 export async function getClimate(point, month, opts = {}) {
     const started = monotonicNow();
     const ts = new Date().toISOString();
     const timeoutMs = normalizeTimeout(opts.timeoutMs ?? 15_000);
-    if (timeoutMs === null) return {
-        ok: false,
-        via: 'open-meteo-error',
-        evidence: `[实时API:open-meteo-climate@error@${ts}]`,
-        latencyMs: monotonicNow() - started,
-        error: TIMEOUT_ERROR
-    };
-    const year = opts.year ?? new Date().getUTCFullYear() - 1;
+    if (timeoutMs === null)
+        return { ok: false, via: 'open-meteo-error', evidence: `[实时API:open-meteo-climate@error@${ts}]`, latencyMs: monotonicNow() - started, error: TIMEOUT_ERROR };
+    // 默认取去年同月做气候基线
+    const year = opts.year ?? (new Date().getUTCFullYear() - 1);
     if (!Number.isInteger(month) || month < 1 || month > 12 || !Number.isInteger(year) || year < 1940 || year > new Date().getUTCFullYear()) {
-        return {
-            ok: false,
-            via: 'open-meteo-error',
-            evidence: `[实时API:open-meteo-climate@error@${ts}]`,
-            latencyMs: monotonicNow() - started,
-            error: 'month/year must be valid historical calendar values'
-        };
+        return { ok: false, via: 'open-meteo-error', evidence: `[实时API:open-meteo-climate@error@${ts}]`, latencyMs: monotonicNow() - started, error: 'month/year must be valid historical calendar values' };
     }
     const lastDay = new Date(Date.UTC(year, month, 0)).getUTCDate();
-    const expectedDates = Array.from({
-        length: lastDay
-    }, (_, i)=>`${year}-${String(month).padStart(2, '0')}-${String(i + 1).padStart(2, '0')}`);
+    const expectedDates = Array.from({ length: lastDay }, (_, i) => `${year}-${String(month).padStart(2, '0')}-${String(i + 1).padStart(2, '0')}`);
     const start = `${year}-${String(month).padStart(2, '0')}-01`;
     const end = `${year}-${String(month).padStart(2, '0')}-${String(lastDay).padStart(2, '0')}`;
-    const url = `${ARCHIVE_BASE}?latitude=${point.latitude}&longitude=${point.longitude}` + `&start_date=${start}&end_date=${end}` + `&daily=temperature_2m_max,temperature_2m_min,precipitation_sum,weathercode&timezone=auto`;
+    const url = `${ARCHIVE_BASE}?latitude=${point.latitude}&longitude=${point.longitude}`
+        + `&start_date=${start}&end_date=${end}`
+        + `&daily=temperature_2m_max,temperature_2m_min,precipitation_sum,weathercode&timezone=auto`;
     const r = await fetchJson(url, timeoutMs, {}, opts.fetchImpl);
     const latencyMs = monotonicNow() - started;
     if (!r.ok) {
-        return {
-            ok: false,
-            via: 'open-meteo-error',
-            evidence: `[实时API:open-meteo-climate@error@${ts}]`,
-            latencyMs,
-            error: r.error
-        };
+        return { ok: false, via: 'open-meteo-error', evidence: `[实时API:open-meteo-climate@error@${ts}]`, latencyMs, error: r.error };
     }
     const payload = isRecord(r.data) ? r.data : null;
     const daily = isRecord(payload?.['daily']) ? payload['daily'] : null;
-    if (!daily || !Array.isArray(daily.time) || !Array.isArray(daily.temperature_2m_max) || !Array.isArray(daily.temperature_2m_min) || !Array.isArray(daily.weathercode) || daily.time.length !== lastDay || daily.time.length !== daily.temperature_2m_max.length || daily.time.length !== daily.temperature_2m_min.length || daily.time.length !== daily.weathercode.length || daily.time.some((v)=>typeof v !== 'string') || daily.time.some((v, i)=>v !== expectedDates[i]) || daily.temperature_2m_max.some((v)=>typeof v !== 'number' || !Number.isFinite(v)) || daily.temperature_2m_min.some((v)=>typeof v !== 'number' || !Number.isFinite(v)) || daily.weathercode.some((v)=>typeof v !== 'number' || !Number.isFinite(v))) {
-        return {
-            ok: false,
-            via: 'open-meteo-error',
-            evidence: `[实时API:open-meteo-climate@error@${ts}]`,
-            latencyMs,
-            error: 'empty daily payload'
-        };
+    if (!daily || !Array.isArray(daily.time) || !Array.isArray(daily.temperature_2m_max)
+        || !Array.isArray(daily.temperature_2m_min) || !Array.isArray(daily.weathercode)
+        || daily.time.length !== lastDay
+        || daily.time.length !== daily.temperature_2m_max.length
+        || daily.time.length !== daily.temperature_2m_min.length
+        || daily.time.length !== daily.weathercode.length
+        || daily.time.some(v => typeof v !== 'string')
+        || daily.time.some((v, i) => v !== expectedDates[i])
+        || daily.temperature_2m_max.some(v => typeof v !== 'number' || !Number.isFinite(v))
+        || daily.temperature_2m_min.some(v => typeof v !== 'number' || !Number.isFinite(v))
+        || daily.weathercode.some(v => typeof v !== 'number' || !Number.isFinite(v))) {
+        return { ok: false, via: 'open-meteo-error', evidence: `[实时API:open-meteo-climate@error@${ts}]`, latencyMs, error: 'empty daily payload' };
     }
     const times = daily.time;
     const maxes = daily.temperature_2m_max;
     const mins = daily.temperature_2m_min;
     const codes = daily.weathercode;
-    const rows = times.map((date, i)=>({
-            date,
-            tempMaxC: maxes[i],
-            tempMinC: mins[i],
-            precipProbMaxPct: null,
-            weatherCode: codes[i]
-        }));
+    const rows = times.map((date, i) => ({
+        date, tempMaxC: maxes[i], tempMinC: mins[i], precipProbMaxPct: null, // archive 端点没有概率,用降水量另行估算
+        weatherCode: codes[i],
+    }));
     return {
-        ok: true,
-        via: 'open-meteo',
+        ok: true, via: 'open-meteo',
         evidence: `[实时API:open-meteo-climate@${ts}]`,
         latencyMs,
         timezone: typeof payload?.['timezone'] === 'string' ? payload['timezone'] : undefined,
-        daily: rows
+        daily: rows,
     };
 }
-
-
-//# sourceURL=ts/capabilities/weather.ts

package/dist/scripts/action-cache-tests.js

@@ -1,3 +1,8 @@
+/**
+ * action-cache 自愈层确定性测试(RFC P2;run-all §25):
+ * 命中/指纹失配/TTL 过期/变量化 key/LRU 淘汰/损坏文件容错/持久化跨实例/幂等回写。
+ * 全纯函数 + 临时目录,零浏览器零网络。
+ */
 import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
@@ -8,7 +13,8 @@ function assert(cond, label, detail) {
     if (cond) {
         pass += 1;
         console.log(`  ok - ${label}`);
-    } else {
+    }
+    else {
         fail += 1;
         console.log(`  FAIL - ${label}${detail !== undefined ? ' :: ' + String(detail) : ''}`);
     }
@@ -17,91 +23,50 @@ const iso = mkdtempSync(join(tmpdir(), 'gotry-actioncache-'));
 const path = actionCachePath(iso);
 const T0 = new Date('2026-08-28T10:00:00Z');
 let clock = T0.getTime();
-const now = ()=>new Date(clock);
+const now = () => new Date(clock);
 const site = 'ctrip-flight';
 console.log('A. templateKey(参数变量化)');
-const k1 = templateKey(site, 'search', {
-    from: '上海',
-    to: '丽江',
-    date: '2026-10-01'
-});
-const k2 = templateKey(site, 'search', {
-    from: '上海',
-    to: '丽江',
-    date: '2026-11-11'
-});
+const k1 = templateKey(site, 'search', { from: '上海', to: '丽江', date: '2026-10-01' });
+const k2 = templateKey(site, 'search', { from: '上海', to: '丽江', date: '2026-11-11' });
 assert(k1 === k2 && k1 === 'ctrip-flight:search:上海|丽江|%date%', '同型查询共享模板 key(日期变量化),跨日期复用');
 console.log('B. 命中与指纹失配(被动失效)');
-const c = new ActionCache(path, {
-    now
-});
+const c = new ActionCache(path, { now });
 const fpA = fingerprint('batchSearch v1 shape {"flightItineraryList":[]}');
-const fpB = fingerprint('batchSearch v2 shape {"itineraries":[]}');
-c.record(k1, fpA, {
-    entryUrl: 'https://flights.ctrip.com/online/list/oneway-sha-ljg?depdate=%date%',
-    parser: 'batchSearch.v1'
-}, site);
+const fpB = fingerprint('batchSearch v2 shape {"itineraries":[]}'); // 接口改版
+c.record(k1, fpA, { entryUrl: 'https://flights.ctrip.com/online/list/oneway-sha-ljg?depdate=%date%', parser: 'batchSearch.v1' }, site);
 clock += 60_000;
 assert(c.lookup(k1, fpA, site)?.locator.parser === 'batchSearch.v1', '指纹一致 → 命中并回放确定性载荷');
 assert(c.lookup(k1, fpA, site)?.hits === 2, '命中计 hits');
 assert(c.lookup(k1, fpB, site) === null, '接口改版(指纹失配)→ miss 不误放(错误的缓存点击比慢更糟)');
-assert(c.lookup(templateKey(site, 'search', {
-    from: '北京',
-    to: '大理',
-    date: '2026-10-01'
-}), fpA, site) === null, 'key 不同 → miss');
+assert(c.lookup(templateKey(site, 'search', { from: '北京', to: '大理', date: '2026-10-01' }), fpA, site) === null, 'key 不同 → miss');
 console.log('C. miss 回写与幂等');
-c.record(k1, fpB, {
-    entryUrl: 'oneway-bjs-dlu?depdate=%date%',
-    parser: 'batchSearch.v2'
-}, site);
+c.record(k1, fpB, { entryUrl: 'oneway-bjs-dlu?depdate=%date%', parser: 'batchSearch.v2' }, site);
 assert(c.lookup(k1, fpB, site)?.locator.parser === 'batchSearch.v2', '改版后回写新载荷,下次命中');
 const hitsBefore = c.lookup(k1, fpB, site).hits;
-c.record(k1, fpB, {
-    parser: 'batchSearch.v2'
-}, site);
+c.record(k1, fpB, { parser: 'batchSearch.v2' }, site);
 assert(c.lookup(k1, fpB, site).hits === hitsBefore + 1, '重复 record 幂等(hits/createdAt 保留,不重置)');
 console.log('D. TTL 过期(48h 默认;注入时钟)');
 clock += 49 * 3600_000;
 assert(c.lookup(k1, fpB, site) === null && c.size(site) === 0, '超 48h → 过期删除条目');
 console.log('E. LRU 淘汰(每站点上限)');
-const c2 = new ActionCache(path + '.lru', {
-    now,
-    maxEntriesPerSite: 3
-});
-for(let i = 0; i < 5; i++){
+const c2 = new ActionCache(path + '.lru', { now, maxEntriesPerSite: 3 });
+for (let i = 0; i < 5; i++) {
     const key = `ctrip-flight:search:城${i}|丽江|%date%`;
-    c2.record(key, fingerprint(`shape-${i}`), {
-        i: String(i)
-    }, site);
+    c2.record(key, fingerprint(`shape-${i}`), { i: String(i) }, site);
     clock += 1_000;
 }
 assert(c2.size(site) === 3, '超容 LRU 淘汰至 3 条');
 console.log('F. 持久化跨实例 + 损坏文件容错');
-const c3 = new ActionCache(path + '.p', {
-    now
-});
-c3.record('meituan:search:大理|民宿|%date%', fingerprint('mt-shape'), {
-    url: 'https://www.meituan.com/...'
-}, 'meituan');
+const c3 = new ActionCache(path + '.p', { now });
+c3.record('meituan:search:大理|民宿|%date%', fingerprint('mt-shape'), { url: 'https://www.meituan.com/...' }, 'meituan');
 clock += 5_000;
-const c4 = new ActionCache(path + '.p', {
-    now
-});
+const c4 = new ActionCache(path + '.p', { now });
 assert(c4.lookup('meituan:search:大理|民宿|%date%', fingerprint('mt-shape'), 'meituan') !== null, '跨实例:落盘后新实例可命中');
 writeFileSync(path + '.broken', '{not json', 'utf8');
-const c5 = new ActionCache(path + '.broken', {
-    now
-});
+const c5 = new ActionCache(path + '.broken', { now });
 assert(c5.size() === 0 && c5.lookup('any', 'any', site) === null, '损坏 JSON 按空缓存,不抛错');
 console.log('G. fingerprint 敏感度');
 assert(fingerprint('abc') !== fingerprint('abd') && fingerprint('abc') === fingerprint('abc'), '微改即变,同文稳定');
-rmSync(iso, {
-    recursive: true,
-    force: true
-});
+rmSync(iso, { recursive: true, force: true });
 console.log(`\nACTION-CACHE: ${pass} pass, ${fail} fail`);
 process.exit(fail > 0 ? 1 : 0);
-
-
-//# sourceURL=ts/scripts/action-cache-tests.ts