@danceiny/gotry 0.0.1-rc.8 → 0.2.0-rc.27

package/dist/capabilities/visa-policy.js

@@ -0,0 +1,140 @@
+/**
+ * 政策事实生产端 v1(issue #141,D-26 收口切片)——C 档数据源:中国领事服务网
+ * (cs.mfa.gov.cn,外交部一手口径,免费权威)的「了解目的地」国家指南树。
+ *
+ * 形态:VISA_POLICY_FETCH 效应(effect 注册表行,礼貌抓取:UA 标识 + 超时 +
+ * 永不重试 + 断路器护站)→ 国家页 HTML → 「签证入境」章节文本 → PolicyFact[]
+ * (as_of + review_by + cs.mfa.gov.cn 来源证据链)。
+ *
+ * 纪律(ADR-19 + 抓取红线):
+ *   - 永不抛错(永不抛错能力层契约);传输失败 → {ok:false, via:'visa-policy-error'},
+ *     **不落负事实**(无结论不是证据);
+ *   - 抓取失败/页面缺失 → 结构化降级,不猜不填;
+ *   - 政策事实恒带 review_by 复核 gate(默认 D-30);
+ *   - 礼貌抓取:单站点串行 + 调用方控制频率;站点不可达不重试(策略表 null)。
+ *
+ * 升级路径:D-31 后可切 B 档 Sherpa° 商业源(effect 注册表行可插拔替换)。
+ *
+ * @module capabilities/visa-policy
+ */
+import { readFileSync } from 'node:fs';
+import { BOOKABLE_FACT_SCHEMA, makeFactId } from '../src/bookable-facts.js';
+const SOURCE_HOST = 'https://cs.mfa.gov.cn';
+const SOURCE_ID = 'cs-mfa';
+const USER_AGENT = 'GoTry/0.0.1 (+https://github.com/Danceiny/gotry; polite policy reader)';
+const CONTINENTS = [
+    'yz_645708', // 亚洲
+    'feizhou_645714', // 非洲
+    'ouzhou_645711', // 欧洲
+    'bz_645718', // 美洲(北/南)
+    'dyz_645717', // 大洋洲
+];
+/** 国家路径 → 政策页 URL(抓取纪律:仅此两种 URL 形态,不拼接任意输入) */
+export function countryPageUrl(continent, country) {
+    if (!/^[a-z0-9_]+$/.test(continent) || !/^[a-z0-9_]+$/.test(country))
+        return null;
+    return `${SOURCE_HOST}/zggmcg/ljmdd/${continent}/${country}/`;
+}
+/** 剥 HTML 标签 → 纯文本(保守:不执行任何内嵌脚本/样式) */
+function stripTags(html) {
+    return html
+        .replace(/<(script|style)[\s\S]*?<\/\1>/gi, ' ')
+        .replace(/<[^>]+>/g, ' ')
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&amp;/g, '&')
+        .replace(/\s+/g, ' ');
+}
+/**
+ * 从国家页文本抽取「签证入境」章节(到下一个同级标题为止)。
+ * 页面为 MFA 编辑器产出的散文(如中泰互免协定生效日期/停留期限条款),逐段保留原句。
+ */
+export function extractVisaSection(pageText) {
+    const text = stripTags(pageText);
+    const start = text.indexOf('签证入境');
+    if (start < 0)
+        return null;
+    const rest = text.slice(start + '签证入境'.length);
+    // 下一大节标题探测:中文数字编号(非签证词)+已知下一节名(不用正文高频词做边界)
+    const sectionEnds = ['海关检查', '海关申报', '医疗条件', '交通出行', '实用信息', '领事保护', '国家安全', '特别提醒']
+        .map(kw => rest.indexOf(kw))
+        .filter(i => i > 0);
+    const numHeaders = Array.from(rest.matchAll(/[一二三四五六七八九十]+、(?!免签|落地签|签证|入境规定)/g)).map(m => m.index).filter(i => i > 0);
+    const allEnds = [...sectionEnds, ...numHeaders].sort((a, b) => a - b);
+    const end = allEnds.length > 0 ? allEnds[0] : Math.min(rest.length, 4_000);
+    const section = rest.slice(0, end).trim();
+    return section.length > 20 ? section : null;
+}
+/**
+ * 章节 → 政策陈述条目:按中文序号段落切分(一、二、…),每段一条 PolicyFact 原料。
+ * 免签/落地签/签证要求各成一条,供闸侧逐条回溯。
+ */
+export function splitPolicyEntries(section) {
+    const parts = section.split(/(?:[一二三四五六七八九十]+、|[（(]\s*[一二三四五六七八九十]+\s*[）)])\s*/).map(p => p.trim());
+    return parts.filter(p => p.length > 30);
+}
+export function policyFactsFromMfa(input) {
+    const entries = splitPolicyEntries(input.section);
+    const asOf = input.fetchedAt.slice(0, 10);
+    const queryId = `visa-policy:${SOURCE_ID}:${input.countryPath}:${asOf}`;
+    return entries.map((entry, i) => ({
+        schema: BOOKABLE_FACT_SCHEMA,
+        fact_id: makeFactId([input.countryPath, String(i), entry.slice(0, 64), queryId]),
+        kind: 'policy',
+        subject: `${input.countryLabel} 签证入境(条款 ${i + 1})`,
+        statement: entry,
+        source: `${SOURCE_ID}@${input.fetchedAt}`,
+        query_id: queryId,
+        fetched_at: input.fetchedAt,
+        as_of: asOf,
+        review_by: defaultReviewBy(input.fetchedAt),
+    }));
+}
+/** 政策复核 gate:抓取日 +30 天(D-30 族) */
+export function defaultReviewBy(fetchedAt) {
+    const d = new Date(fetchedAt);
+    d.setDate(d.getDate() + 30);
+    return d.toISOString().slice(0, 10);
+}
+/** 从洲列表页 HTML 提取国家路径段(相对形态 ./tg_647570/ → tg_647570;仅收本站链接) */
+export function listCountryPaths(continentListHtml, continent) {
+    const hits = continentListHtml.matchAll(new RegExp(`href="(\\./([a-z0-9_]+)/)"[^>]*>([^<]{2,20})<`, 'g'));
+    const out = [];
+    for (const m of hits) {
+        if (!m[2] || !m[3])
+            continue;
+        out.push({ path: m[2], label: m[3].trim() });
+    }
+    return out.map(x => x.path).filter(p => /^[a-z0-9_]+$/.test(p));
+}
+/** 洲路径段 → 洲列表页 URL(形态受控,不拼接任意输入) */
+export function continentListUrl(continent) {
+    if (!/^[a-z0-9_]+$/.test(continent))
+        return null;
+    return `${SOURCE_HOST}/zggmcg/ljmdd/${continent}/`;
+}
+/** 从本地 fixture 读页面(测试确定性;生产走 fetchVisaPolicyPage) */
+export function readPageFixture(path) {
+    return readFileSync(path, 'utf-8');
+}
+/** 礼貌抓取国家页(永不抛错;失败 = 结构化降级,不落负事实) */
+export async function fetchVisaPolicyPage(url, timeoutMs = 20_000) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetch(url, {
+            headers: { 'user-agent': USER_AGENT, 'accept-language': 'zh-CN,zh' },
+            signal: controller.signal,
+            redirect: 'follow',
+        });
+        if (!res.ok)
+            return { ok: false, error: `HTTP ${res.status}` };
+        return { ok: true, html: await res.text() };
+    }
+    catch (e) {
+        const msg = controller.signal.aborted ? `timeout after ${timeoutMs}ms` : String(e.message ?? e);
+        return { ok: false, error: msg };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}

package/dist/capabilities/weather.js

@@ -1,180 +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}`;
 }
-async function fetchJson(url, timeoutMs) {
+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;
+/** 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 {
+        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 };
     const ctrl = new AbortController();
-    const timer = setTimeout(()=>ctrl.abort(), timeoutMs);
+    const timerDelay = Math.floor(timeoutMs);
+    if (timerDelay < MIN_TIMER_MS)
+        return { ok: false, error: BUDGET_EXHAUSTED_ERROR };
+    let timer;
+    let timedOut = false;
+    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() };
+    })();
     try {
-        const res = await fetch(url, {
-            signal: ctrl.signal,
-            headers: {
-                Accept: 'application/json'
-            }
-        });
-        if (!res.ok) return {
-            ok: false,
-            error: `HTTP ${res.status}`
-        };
-        return {
-            ok: true,
-            data: await res.json()
-        };
-    } catch (e) {
-        return {
-            ok: false,
-            error: e.message.slice(0, 200)
-        };
-    } finally{
-        clearTimeout(timer);
+        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);
+function stripHits(hits) {
+    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 url = `${GEOCODE_BASE}?name=${encodeURIComponent(name)}&count=${count}&language=zh&format=json`;
-    const r = await fetchJson(url, opts.timeoutMs ?? 15_000);
-    if (!r.ok) {
-        return {
-            ok: false,
-            evidence: `[实时API:open-meteo-geo@error@${ts}]`,
-            results: [],
-            error: r.error
-        };
+    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 };
+    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 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 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 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) };
+    }
+    // 弱命中/零结果/主源请求失败: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 nomResults = [];
+    if (nom.ok && Array.isArray(nom.data)) {
+        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));
+        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 };
+    }
+    // 双源皆空/兜底失败:open-meteo 有弱结果仍返回(同构「降级不阻塞」契约),否则维持失败终态
+    if (omResults.length) {
+        return { ok: true, evidence: `[实时API:open-meteo-geo@${ts}]`, via: 'open-meteo', results: stripHits(omResults) };
     }
-    const results = (r.data?.results ?? []).map((item)=>{
-        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
-        };
-    });
     return {
-        ok: true,
-        evidence: `[实时API:open-meteo-geo@${ts}]`,
-        results
+        ok: false,
+        evidence: `[实时API:open-meteo-geo@error@${ts}];[实时API:nominatim@error@${nomTs}]`,
+        results: [],
+        error: r.ok ? `双源无结果:${nom.error ?? 'nominatim empty'}` : (r.error),
     };
 }
+/** 未来天气预报(≤16 天) */
 export async function getForecast(point, opts = {}) {
-    const started = Date.now();
+    const started = monotonicNow();
     const ts = new Date().toISOString();
-    const days = Math.min(opts.days ?? 7, 16);
-    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, opts.timeoutMs ?? 15_000);
-    const latencyMs = Date.now() - started;
+    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`;
+    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 daily = r.data.daily;
-    if (!daily) {
-        return {
-            ok: false,
-            via: 'open-meteo-error',
-            evidence: `[实时API:open-meteo@error@${ts}]`,
-            latencyMs,
-            error: 'empty daily payload'
-        };
+    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' };
     }
-    const rows = daily.time.map((date, i)=>({
-            date,
-            tempMaxC: daily.temperature_2m_max[i] ?? NaN,
-            tempMinC: daily.temperature_2m_min[i] ?? NaN,
-            precipProbMaxPct: daily.precipitation_probability_max?.[i] ?? null,
-            weatherCode: daily.weathercode[i] ?? -1
-        }));
+    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],
+    }));
     return {
-        ok: true,
-        via: 'open-meteo',
+        ok: true, via: 'open-meteo',
         evidence: `[实时API:open-meteo@${ts}]`,
         latencyMs,
-        timezone: r.data.timezone,
-        daily: rows
+        timezone: typeof payload?.['timezone'] === 'string' ? payload['timezone'] : undefined,
+        daily: rows,
     };
 }
+/** 历史气候(季节性推荐底座:去年同期日均温/降雨概率) */
 export async function getClimate(point, month, opts = {}) {
-    const started = Date.now();
+    const started = monotonicNow();
     const ts = new Date().toISOString();
-    const year = opts.year ?? new Date().getFullYear() - 1;
+    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 (!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' };
+    }
     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 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 r = await fetchJson(url, opts.timeoutMs ?? 15_000);
-    const latencyMs = Date.now() - started;
+    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 daily = r.data.daily;
-    if (!daily) {
-        return {
-            ok: false,
-            via: 'open-meteo-error',
-            evidence: `[实时API:open-meteo-climate@error@${ts}]`,
-            latencyMs,
-            error: 'empty daily payload'
-        };
+    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' };
     }
-    const rows = daily.time.map((date, i)=>({
-            date,
-            tempMaxC: daily.temperature_2m_max[i] ?? NaN,
-            tempMinC: daily.temperature_2m_min[i] ?? NaN,
-            precipProbMaxPct: null,
-            weatherCode: daily.weathercode[i] ?? -1
-        }));
+    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, // archive 端点没有概率,用降水量另行估算
+        weatherCode: codes[i],
+    }));
     return {
-        ok: true,
-        via: 'open-meteo',
+        ok: true, via: 'open-meteo',
         evidence: `[实时API:open-meteo-climate@${ts}]`,
         latencyMs,
-        timezone: r.data.timezone,
-        daily: rows
+        timezone: typeof payload?.['timezone'] === 'string' ? payload['timezone'] : undefined,
+        daily: rows,
     };
 }
-
-
-//# sourceURL=/Users/bytedance/work/gotry/ts/capabilities/weather.ts

package/dist/data/session-golden-20.json

@@ -0,0 +1,25 @@
+{
+  "comment": "会话数据面金标准查询集(RFC P2 监控面输入;只增不改语义,对齐 time-slot-eval 惯例)。city 字段约束:from/to 必须同时命中 ctrip 城市码表与美团拼音表(双适配器通用)。",
+  "queries": [
+    { "id": "sf-01", "kind": "flight", "from": "上海", "to": "丽江", "date": "2026-10-01" },
+    { "id": "sf-02", "kind": "flight", "from": "北京", "to": "大理", "date": "2026-10-02" },
+    { "id": "sf-03", "kind": "flight", "from": "上海", "to": "三亚", "date": "2026-11-11" },
+    { "id": "sf-04", "kind": "flight", "from": "广州", "to": "昆明", "date": "2026-12-20" },
+    { "id": "sf-05", "kind": "flight", "from": "深圳", "to": "成都", "date": "2026-10-05" },
+    { "id": "sf-06", "kind": "flight", "from": "杭州", "to": "厦门", "date": "2026-10-06" },
+    { "id": "sf-07", "kind": "flight", "from": "西安", "to": "桂林", "date": "2026-10-07" },
+    { "id": "sf-08", "kind": "flight", "from": "重庆", "to": "贵阳", "date": "2026-10-08" },
+    { "id": "mt-01", "kind": "meituan-hotel", "city": "上海", "keyword": "陆家嘴" },
+    { "id": "mt-02", "kind": "meituan-hotel", "city": "大理", "keyword": "洱海" },
+    { "id": "mt-03", "kind": "meituan-hotel", "city": "成都", "keyword": "太古里" },
+    { "id": "mt-04", "kind": "meituan-hotel", "city": "北京", "keyword": "故宫" },
+    { "id": "mt-05", "kind": "meituan-minsu", "city": "丽江", "keyword": "古城" },
+    { "id": "mt-06", "kind": "meituan-minsu", "city": "厦门", "keyword": "鼓浪屿" },
+    { "id": "mt-07", "kind": "meituan-minsu", "city": "杭州", "keyword": "西湖" },
+    { "id": "mt-08", "kind": "meituan-minsu", "city": "三亚", "keyword": "亚龙湾" },
+    { "id": "fa-01", "kind": "flyai-flight", "from": "上海", "to": "丽江", "date": "2026-10-01" },
+    { "id": "fa-02", "kind": "flyai-flight", "from": "北京", "to": "大理", "date": "2026-10-02" },
+    { "id": "fa-03", "kind": "flyai-train", "from": "上海", "to": "大理", "date": "2026-10-01" },
+    { "id": "fa-04", "kind": "flyai-train", "from": "北京", "to": "昆明", "date": "2026-10-03" }
+  ]
+}