@danceiny/gotry 0.0.1-rc.15 → 0.0.1-rc.17

package/dist/scripts/fact-gate-tests.js

@@ -0,0 +1,318 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { BOOKABLE_FACT_SCHEMA, checkSameDayDeparture, dedupeFacts, detectBacktrack, factsFromFlyai, flightClaimVerdict, itineraryInvariants, latestFactsForRouteDate, negativeFact, renderConnection, renderFlightFact, renderNightsLine, renderPolicyFact } from '../src/bookable-facts.js';
+import { ARTIFACT_GATE_SCHEMA, gateArtifact } from '../src/artifact-gate.js';
+let pass = 0;
+let fail = 0;
+function assert(cond, msg) {
+    if (cond) {
+        pass++;
+        console.log(`  ok - ${msg}`);
+    } else {
+        fail++;
+        console.error(`  FAIL - ${msg}`);
+    }
+}
+const map = JSON.parse(readFileSync(join(import.meta.dirname, '..', '..', 'data', 'airline-airports.json'), 'utf-8'));
+const alias = map.city_alias;
+const fixture = JSON.parse(readFileSync(join(import.meta.dirname, '..', 'data', 'golden-trip-2027-facts.json'), 'utf-8'));
+const FETCHED = '2026-08-29T09:51:00.000Z';
+const registry = dedupeFacts(fixture.queries.flatMap((q)=>factsFromFlyai({
+        kind: q.kind,
+        origin: q.origin,
+        destination: q.destination,
+        date: q.date
+    }, {
+        verdict: q.verdict,
+        options: q.options
+    }, FETCHED, alias)));
+const tripYear = Number(fixture.meta.trip_window[0].slice(0, 4));
+console.log('§1 转换与注册表');
+const hkHkt717 = latestFactsForRouteDate(registry, 'HKG', 'HKT', '2027-07-17');
+assert(registry.every((f)=>f.schema === BOOKABLE_FACT_SCHEMA && f.fact_id.length === 16), 'schema 词唯一且 fact_id 为 16 位语义散列');
+assert(hkHkt717.length === 2 && hkHkt717.every((f)=>f.bookability === 'bookable_exact_date' && f.tier === 'live_inventory'), 'HKG→HKT 2027-07-17 在架两班,均为 exact-date 可下单层');
+const uo724 = hkHkt717.find((f)=>f.flight_no === 'UO724');
+assert(uo724.dep_local === '07:55' && uo724.arr_local === '10:30' && uo724.nonstop === true && uo724.price === 793 && uo724.currency === 'CNY' && uo724.query_id === 'flyai:flight:香港-普吉:2027-07-17' && uo724.fetched_at === FETCHED && uo724.as_of === '2026-08-29', '事实字段齐全:时刻/直飞/价格/币种/query_id/fetched_at/as_of(issue 期望①的字段面)');
+assert(uo724.marketing_carrier === '香港快运航空' && uo724.operating_carrier === undefined, '营销承运在案;实际承运上游未给 = 留空不猜(未知 ≠ 相同)');
+const misses = registry.filter((f)=>f.bookability === 'unavailable_exact_date');
+assert(misses.length === 1 && misses[0].route.origin === 'SZX' && misses[0].route.destination === 'HKT' && misses[0].date === '2027-07-17', 'miss → 负事实(route+date 级「当前不可售」记录,非空缺)');
+assert(factsFromFlyai({
+    kind: 'flight',
+    origin: '香港',
+    destination: '普吉',
+    date: '2027-07-17'
+}, {
+    verdict: 'error'
+}, FETCHED, alias).length === 0, 'error 不落事实——通道无结论不是证据');
+const dup = dedupeFacts([
+    ...registry,
+    {
+        ...uo724,
+        fetched_at: '2026-08-30T00:00:00.000Z',
+        price: 900
+    }
+]);
+const reFetched = dup.filter((f)=>f.fact_id === uo724.fact_id);
+assert(reFetched.length === 1 && reFetched[0].price === 900, '同 fact_id 重查去重,保留最新 fetched_at(旧快照 append-only 在持久层)');
+const stale = negativeFact('flyai:flight:香港-普吉:2027-07-17', 'flight', '香港', '普吉', '2027-07-17', 'flyai', '2026-08-28T00:00:00.000Z', alias);
+const mixed = dedupeFacts([
+    stale,
+    ...hkHkt717
+]);
+assert(latestFactsForRouteDate(mixed, 'HKG', 'HKT', '2027-07-17').every((f)=>f.bookability === 'bookable_exact_date'), '同 route+date 陈旧 miss 不遮蔽更新查询的 hit(最新批次优先)');
+console.log('§2 UO784 与同日衔接硬约束');
+const claim = flightClaimVerdict(registry, {
+    flight_no: 'UO784',
+    origin: 'HKG',
+    destination: 'HKT',
+    date: '2027-07-17'
+});
+assert(claim.verdict === 'not_in_source' && /UO724|CX771/.test(claim.reason), 'UO784 在 HKG→HKT 2027-07-17 被判 not_in_source(源内在架 UO724/CX771)');
+const conn = checkSameDayDeparture(registry, {
+    origin: 'HKG',
+    destination: 'HKT',
+    date: '2027-07-17'
+}, {
+    errand_end_local: '13:00',
+    airport_transit_min: 45,
+    checkin_deadline_min: 120
+});
+assert(!conn.feasible && conn.feasible_flights.length === 0, '「上午办事(13:00 结束)+ 当天下午直飞普吉」判定不可行');
+assert(conn.earliest_departure_local === '15:45' && conn.excluded.length === 2 && conn.excluded.every((e)=>/最早可接时刻 15:45/.test(e.reason)), '最早可接 15:45(13:00+45m 门到机场+120m 值机);在架两班早班均被硬约束排除并带原因');
+assert(conn.suggestions.some((s)=>s.includes('增加 1 个HKG住宿夜')) && conn.suggestions.some((s)=>s.includes('提前一天')), '不可行建议:增加 1 个香港住宿夜 / 提前一天完成事务或出发(issue 验收②原话面)');
+console.log('§3 航司→机场映射');
+assert(map.carrier_airport['BKK']?.['FD'] === 'DMK' && map.carrier_airport['BKK']?.['VZ'] === 'BKK', '映射快照:FD→DMK、VZ→BKK(as_of 2026-08-29)');
+const mapGate = gateArtifact('### 段｜普吉→曼谷(7.30)\n| FD/VZ(亚航/越捷) | 廊曼DMK |', registry, map, {
+    trip_year: tripYear
+});
+assert(mapGate.violations.some((v)=>v.kind === 'airport_mapping_conflict' && /VZ 在BKK落 BKK/.test(v.detail)) && !mapGate.violations.some((v)=>v.kind === 'airport_mapping_conflict' && /FD 在/.test(v.detail)), '「FD/VZ 均落 DMK」合并映射:VZ 被抓、FD 不误伤');
+const mapOk = gateArtifact('### 段｜普吉→曼谷(7.30)\n| FD(亚航) | 廊曼DMK |', registry, map, {
+    trip_year: tripYear
+});
+assert(!mapOk.violations.some((v)=>v.kind === 'airport_mapping_conflict'), 'FD→DMK 与映射一致不误报');
+console.log('§4 SZX→DXB 与承运分离');
+const szxDxb = latestFactsForRouteDate(registry, 'SZX', 'DXB', '2027-08-09');
+assert(szxDxb.length === 1 && szxDxb[0].flight_no === 'EK329', 'SZX→DXB 2027-08-09 exact-date 班次 = EK329(快照原值,不是旧班 EK327)');
+const ekLine = renderFlightFact(szxDxb[0]);
+assert(ekLine.includes('EK329') && ekLine.includes('00:30→04:55') && ekLine.includes('[flyai@') && ekLine.includes('#flyai:flight:深圳-迪拜:2027-08-09'), '渲染行:班次/时刻/证据链(source@fetched_at #query_id)全部来自结构化事实');
+const codeshare = {
+    ...szxDxb[0],
+    fact_id: 'cs-demo000000000',
+    flight_no: 'EK8582',
+    marketing_carrier: '阿联酋航空',
+    operating_carrier: '中国南方航空'
+};
+const csLine = renderFlightFact(codeshare);
+assert(csLine.includes('营销 阿联酋航空') && csLine.includes('实际承运 中国南方航空'), 'codeshare 渲染同时输出营销与实际承运(不混用)');
+console.log('§5 protected_connection 与联程措辞');
+const fd597 = {
+    schema: BOOKABLE_FACT_SCHEMA,
+    fact_id: 'fd597-demo0000000',
+    kind: 'flight',
+    route: {
+        origin: 'SZX',
+        destination: 'BKK'
+    },
+    date: '2027-08-08',
+    flight_no: 'FD597',
+    marketing_carrier: '泰国亚洲航空',
+    dep_local: '18:30',
+    arr_local: '20:15',
+    nonstop: true,
+    price: 700,
+    currency: 'CNY',
+    tier: 'live_inventory',
+    bookability: 'bookable_exact_date',
+    source: 'flyai',
+    query_id: 'flyai:flight:深圳-曼谷:2027-08-08',
+    fetched_at: FETCHED,
+    as_of: '2026-08-29'
+};
+const selfTransfer = renderConnection(fd597, szxDxb[0]);
+assert(selfTransfer.includes('分票/自助转机') && selfTransfer.includes('误机无保护') && !/联程\(/.test(selfTransfer), '两段接得上 ≠ 联程:缺 protected_connection 渲染为分票/自助转机并标红风险');
+const throughA = {
+    ...fd597,
+    fact_id: 'fd597-protected00',
+    protected_connection: true
+};
+const throughB = {
+    ...szxDxb[0],
+    fact_id: 'ek329-protected00',
+    protected_connection: true
+};
+assert(/联程\(同一票号/.test(renderConnection(throughA, throughB)), '双腿 protected_connection=true 才允许渲染「联程(同一票号/行李直挂/误机保护)」');
+const throughGate = gateArtifact(`- 深圳→曼谷 FD597 + 曼谷→迪拜 EK329:联程(同一票号)`, [
+    throughA,
+    throughB
+], map, {
+    trip_year: tripYear
+});
+assert(!throughGate.violations.some((v)=>v.kind === 'self_transfer_called_through'), 'protected_connection=true 的联程行过闸');
+const stGate = gateArtifact(`- FD597 深圳→曼谷 + EK 曼谷→迪拜,建议买联程更稳`, [
+    fd597,
+    szxDxb[0]
+], map, {
+    trip_year: tripYear
+});
+assert(stGate.violations.some((v)=>v.kind === 'self_transfer_called_through'), '「建议买联程」无 protected_connection 证据 → 违例');
+console.log('§6 行程统计不变量');
+assert(itineraryInvariants(fixture.good_itinerary).length === 0, 'good itinerary 全绿:23 酒店夜 + 1 机上夜 = 24 夜;O&D/legs/预算自洽');
+const goodNights = renderNightsLine(fixture.good_itinerary);
+assert(goodNights.includes('24 晚 = 23 个酒店夜 + 1 个机上夜') && goodNights.includes('O&D 6 段(共 6 个 flight legs)'), '夜数口径机器反算:「24 晚 = 23 酒店夜 + 1 机上夜」;航班 O&D 6 段(issue:不是 7 段)');
+const badViol = itineraryInvariants(fixture.bad_itinerary);
+assert(badViol.some((v)=>v.kind === 'nights_inconsistent' && /酒店夜 23 \+ 机上夜 0 = 23 ≠ 行程总夜数 24/.test(v.detail)), 'bad itinerary:23 酒店夜 + 0 机上夜 ≠ 24 总夜被抓(机上夜被吞,「24 天 23 晚」口径混用)');
+assert(badViol.some((v)=>v.kind === 'budget_floor_inconsistent' && /35,500/.test(v.detail) && /30,000/.test(v.detail)), 'bad itinerary:分项最低合计 ¥35,500 > 声称可压到 ¥30,000 被抓(issue 预算行原值)');
+console.log('§7 政策 as_of 与复核 gate');
+const policy = {
+    schema: BOOKABLE_FACT_SCHEMA,
+    fact_id: 'policy-th-00000000',
+    kind: 'policy',
+    subject: '泰国入境(中国护照)',
+    statement: '免签停留(口径以泰方公告为准);UAE 居民返程应优先校验 residence visa / Emirates ID 而非游客免签口径',
+    source: 'web:official',
+    query_id: 'web:policy:泰国免签',
+    fetched_at: FETCHED,
+    as_of: '2026-08-29'
+};
+const policyLine = renderPolicyFact(policy, fixture.meta.trip_window[0]);
+assert(policyLine.includes('截至 2026-08-29 的现行政策') && policyLine.includes('2027-06-16') && !/[✓✅]/.test(policyLine), '政策行恒带「截至 as_of」+ D-30 复核日期(2027-06-16),永不用无条件 ✓');
+const policyBad = gateArtifact('| 泰国 | 中国护照免签(现行60天/次),停留2周无问题 |', registry, map, {
+    trip_year: tripYear
+});
+assert(policyBad.violations.some((v)=>v.kind === 'policy_without_as_of'), '「现行60天」无具体 as_of 日期 = policy_without_as_of(现行 ≠ 时间边界)');
+const policyGood = gateArtifact(policyLine, registry, map, {
+    trip_year: tripYear
+});
+assert(!policyGood.violations.some((v)=>v.kind === 'policy_without_as_of'), '带「截至 YYYY-MM-DD」的政策行过闸');
+console.log('§8 回头路检测');
+const bt = detectBacktrack([
+    'HKT',
+    'KBV',
+    'HKT',
+    'BKK'
+], new Set([
+    'KBV-BKK'
+]));
+assert(bt.length === 1 && bt[0].path.join('→') === 'HKT→KBV→HKT' && (bt[0].suggestion ?? '').includes('KBV→BKK'), 'Phuket→Krabi→Phuket 回头路被抓;KBV→BKK 直飞存在 → 最小改动建议');
+assert(detectBacktrack([
+    'HKT',
+    'KBV',
+    'BKK'
+], new Set([
+    'KBV-BKK'
+])).length === 0, 'good route(普吉→甲米→曼谷)无回头路不误报');
+console.log('§9 全产物闸 golden E2E(bad blocked / good pass)');
+const badArtifact = `# 2027年7-8月 迪拜→深圳/香港→普吉/甲米→曼谷→云南→迪拜 24天行程规划(v2)
+
+## 一、行程总览
+| 日期 | 星期 | 行程 | 交通 | 住宿 |
+|---|---|---|---|---|
+| 07-16 | 周五 | 迪拜 → 深圳或香港(晚间到) | EK328/FZ/QR(见段1) | 香港尖沙咀 |
+| 07-17 | 周六 | 上午香港办银行开户+保险签约 → 下午飞普吉 | UO784 香港15:35→普吉18:10 ✓ | 普吉·查龙 |
+| 08-08 | 周日 | 丽江→深圳 → 深夜红眼回迪拜 | MF1538/8L + EK327 | 机上/钟点房 |
+
+**共 24 天 23 晚** ✓
+
+## 二、机票
+### 段1|迪拜→香港/深圳(7.16 周五)
+| 方案 | 航班 | 时长 | 说明 |
+|---|---|---|---|
+| 快+顺(推荐) | EK328 直飞深圳 | 迪拜10:05→深圳约22:50 | 原方案 |
+| 省钱版(落香港) | flydubai FZ 直飞香港 | 约7h15m | 廉航直飞 |
+
+### 段2|香港→普吉(7.17 周六)
+| 方案 | 航班 | 时刻 |
+|---|---|---|
+| 首选 | UO784 香港快运直飞 | 香港15:35→普吉18:10 |
+| 舒适 | CX787 国泰直飞 | 香港约08:40→普吉约12:20 |
+
+### 段3|普吉→曼谷(7.30 周五晚)
+| 航班 | 落点 |
+|---|---|
+| FD/VZ(亚航/越捷) | 廊曼DMK |
+
+### 段4|曼谷→昆明(8.1 周日晚)
+| 航班 | 说明 |
+|---|---|
+| MU 东航直飞(每日4-5班) | 提前出票 |
+| 8L 祥鹏直飞(若有当日班) | 备选比价 |
+
+### 段6|丽江→深圳(8.8 周日)
+| 方案 | 说明 |
+|---|---|
+| MF1538 厦航直飞 11:13→13:19 | 首选 |
+
+### 段7|深圳→迪拜(8.8 深夜 / 8.9 凌晨)
+| 方案 | 时刻 |
+|---|---|
+| EK327 直飞(推荐) | 深圳约00:30→迪拜约04:30 |
+| 省钱:FD597 深圳→曼谷 + EK 曼谷→迪拜,建议买 EK 联程 | 到迪拜约04:30 |
+
+### 段8|女友去程:南京→普吉(7.17)
+直飞:东航 南京→普吉(白天班,约17:00到)
+
+## 五、证件与政策
+| 目的地 | 政策 |
+|---|---|
+| 泰国 | 中国护照免签(现行60天/次),停留2周无问题 |
+| 迪拜 | 中国护照免签30天 |
+
+预算可压到 ¥30,000
+`;
+const badReport = gateArtifact(badArtifact, registry, map, {
+    trip_year: tripYear,
+    itinerary: fixture.bad_itinerary
+});
+const badKinds = new Set(badReport.violations.map((v)=>v.kind));
+const expectedKinds = [
+    'not_in_source',
+    'contradicted',
+    'airport_mapping_conflict',
+    'self_transfer_called_through',
+    'policy_without_as_of',
+    'unconditional_check',
+    'nights_inconsistent',
+    'budget_floor_inconsistent'
+];
+assert(badReport.schema === ARTIFACT_GATE_SCHEMA && badReport.verdict === 'blocked' && badReport.presentation === 'verified_label_forbidden', 'bad artifact:闸 blocked 且禁止「已验证方案」措辞');
+for (const k of expectedKinds){
+    assert(badKinds.has(k), `bad artifact 违例类别覆盖:${k}`);
+}
+assert(badReport.violations.filter((v)=>v.kind === 'not_in_source').some((v)=>v.detail.startsWith('UO784')), 'UO784 被逐条点名(验收②:任何产物中不得出现该班次)');
+assert(!badReport.violations.some((v)=>v.detail.startsWith('MU9626') || /MU 东航直飞/.test(v.detail) && v.kind === 'not_in_source'), '已核验的 MU 东航直飞(BKK→KMG 在架)不误伤');
+const goodFlights = [
+    latestFactsForRouteDate(registry, 'DXB', 'HKG', '2027-07-16')[0],
+    latestFactsForRouteDate(registry, 'HKG', 'HKT', '2027-07-18')[0],
+    latestFactsForRouteDate(registry, 'KBV', 'BKK', '2027-07-30')[0],
+    latestFactsForRouteDate(registry, 'BKK', 'KMG', '2027-08-01')[0],
+    latestFactsForRouteDate(registry, 'LJG', 'SZX', '2027-08-08')[0],
+    szxDxb[0]
+];
+const goodArtifact = [
+    `# 2027-07-16 → 2027-08-09 行程(事实闸渲染面)`,
+    '',
+    renderNightsLine(fixture.good_itinerary),
+    '',
+    '## 航班(逐条可回溯)',
+    ...goodFlights.map(renderFlightFact),
+    '',
+    '## 政策',
+    renderPolicyFact(policy, fixture.meta.trip_window[0]),
+    renderPolicyFact({
+        ...policy,
+        fact_id: 'policy-uae-0000000',
+        subject: '迪拜入境(UAE 居民返程)',
+        statement: '优先校验 residence visa / Emirates ID;游客免签口径不适用居民返程'
+    }, fixture.meta.trip_window[0])
+].join('\n');
+const goodReport = gateArtifact(goodArtifact, registry, map, {
+    trip_year: tripYear,
+    itinerary: fixture.good_itinerary
+});
+assert(goodReport.verdict === 'pass' && goodReport.presentation === 'verified_itinerary_allowed' && goodReport.traceable === 6 && goodReport.violations.length === 0, `good artifact:6/6 航班 claim 全回溯,闸 pass(违例 ${goodReport.violations.length})`);
+assert(goodFlights.every((f)=>f.bookability === 'bookable_exact_date' && f.query_id.includes('flyai:flight:')), 'good artifact 的每个可下单事实均可回溯到 tool result/query id(验收⑧)');
+console.log(`\nFACT GATE TESTS: ${pass} pass, ${fail} fail`);
+if (fail > 0) process.exit(1);
+
+
+//# sourceURL=ts/scripts/fact-gate-tests.ts

package/dist/scripts/flyai-tests.js

@@ -92,4 +92,4 @@ await rm(tmp, {
 console.log('FLYAI TESTS: 4/4 OK(离线假 CLI:Sentinel→error / 空 itemList→miss / 命中→hit / exit≠0→error)');
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/scripts/flyai-tests.ts
+//# sourceURL=ts/scripts/flyai-tests.ts

package/dist/scripts/hbcli-e2e-tests.js

@@ -0,0 +1,180 @@
+import { spawnSync } from 'node:child_process';
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import assert from 'node:assert/strict';
+import { listDestinations, searchHotels, hbcliBinCandidates } from '../capabilities/hbcli.js';
+import { makeProductionInterpreter } from '../capabilities/effect.js';
+const UAT = 'https://api-test.hotelbyte.com';
+const SANDBOX_APP_KEY = 'hotelbyte_api_demo';
+const SANDBOX_APP_SECRET = 'hotelbyte_api_demo';
+const GUIDANCE = [
+    'staicli(hbcli)账号配置指引:',
+    '  1. 安装 CLI(若缺):npx gotry setup(官方 install.sh → ~/.local/bin/hbcli)',
+    '  2. 快速试用(沙箱演示账号,来自 hotel-be 种子,user/domain/predefined_user_demo.go):',
+    '     hbcli auth set-credentials --app-key hotelbyte_api_demo --app-secret hotelbyte_api_demo',
+    '  3. 正式接入:向 HotelByte 申请专属 appKey/appSecret(hbk_*/hbs_*),替换第 2 步凭证;',
+    '     门户模式则 hbcli auth login --username <email>(权限更大,搜索场景无必要)',
+    '  4. 自检:hbcli auth whoami(api_key.configured=true 即凭证就位;has_ticket 首次查询后为 true)'
+];
+function probeBin() {
+    for (const bin of hbcliBinCandidates('hbcli')){
+        const r = spawnSync(bin, [
+            'version'
+        ], {
+            timeout: 10_000,
+            stdio: 'ignore'
+        });
+        if (!r.error && r.status === 0) return bin;
+    }
+    return null;
+}
+async function uatReachable() {
+    try {
+        await fetch(`${UAT}/api/search/destinations`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: '{}',
+            signal: AbortSignal.timeout(8_000)
+        });
+        return true;
+    } catch  {
+        return false;
+    }
+}
+async function main() {
+    console.log(GUIDANCE.join('\n'));
+    const bin = probeBin();
+    if (!bin) {
+        console.log(`SKIP: 未安装 hbcli(候选 ${hbcliBinCandidates('hbcli').join(' / ')} 均不可执行)——npx gotry setup 可按官方脚本安装`);
+        return;
+    }
+    if (!await uatReachable()) {
+        console.log(`SKIP: UAT(${UAT})不可达——全流程端到端在有网环境跑,离线降级面已由 hbcli-tests.ts(§7)覆盖`);
+        return;
+    }
+    const staicliHome = mkdtempSync(join(tmpdir(), 'gotry-hbcli-e2e-'));
+    const stateRoot = mkdtempSync(join(tmpdir(), 'gotry-hbcli-e2e-state-'));
+    process.env.STAICLI_HOME = staicliHome;
+    const fallbackPath = join(import.meta.dirname, '..', '..', 'data', 'hotels_2026.json');
+    try {
+        const set = spawnSync(bin, [
+            'auth',
+            'set-credentials',
+            '--app-key',
+            SANDBOX_APP_KEY,
+            '--app-secret',
+            SANDBOX_APP_SECRET
+        ], {
+            timeout: 30_000,
+            encoding: 'utf-8'
+        });
+        assert.equal(set.status, 0, `auth set-credentials 应成功,实际 ${set.status}: ${set.stderr?.slice(0, 200)}`);
+        console.log(`1. 沙箱账号写入隔离 STAICLI_HOME(${staicliHome.replace(tmpdir(), '$TMPDIR')})OK`);
+        const who = spawnSync(bin, [
+            'auth',
+            'whoami'
+        ], {
+            timeout: 30_000,
+            encoding: 'utf-8'
+        });
+        assert.equal(who.status, 0, 'whoami 应 exit 0');
+        assert.match(who.stdout, /"configured": true/, 'whoami 应报 api_key.configured=true');
+        console.log('1b. hbcli auth whoami 自检(api_key.configured=true)OK');
+        const dest = await listDestinations({
+            timeoutMs: 30_000
+        });
+        assert.equal(dest.via, 'hbcli-realtime', `destinations 应走实时通道,实际 ${dest.via}(${dest.error ?? ''})`);
+        assert.equal(dest.exitCode, 0, 'destinations 应 exit 0');
+        assert.match(dest.evidence, /\[实时API:hbcli@\d{4}-/, '证据链应带实时时间戳标注(L4 不变量)');
+        assert.ok(dest.result !== null && typeof dest.result === 'object', '实时返回应可解析为 JSON');
+        console.log(`2. 能力层实时通道(listDestinations → ${UAT})via=hbcli-realtime,证据链 OK`);
+        const hotels = await searchHotels({
+            destination: '深圳',
+            checkIn: '2026-09-18',
+            checkOut: '2026-09-20',
+            adults: 2
+        }, {
+            timeoutMs: 30_000,
+            fallbackPath
+        });
+        if (hotels.via === 'hbcli-error') {
+            assert.ok(hotels.error, '降级结果应携带上游原话原因');
+            assert.match(hotels.summary, /降级/, 'summary 应显式声明降级(不伪装成实时)');
+            assert.match(hotels.summary, /静态包/, '降级路径应指明静态包来源');
+            assert.ok(hotels.hotels !== null, '静态包深圳块应命中');
+            assert.match(hotels.summary, /非实时/, '降级产物必须显式标注非实时(L4 反伪装红线)');
+            console.log(`3. hotel-list 真实降级链(via=hbcli-error,原因:${String(hotels.error).slice(0, 60)}…;静态包命中+非实时标注)OK`);
+        } else {
+            assert.equal(hotels.via, 'hbcli-realtime');
+            assert.match(hotels.evidence, /\[实时API:hbcli@\d{4}-/);
+            console.log('3. hotel-list 实时返回(UAT 已有目的地数据)证据链 OK');
+        }
+        const itp = await makeProductionInterpreter({
+            breakers: new Map()
+        })({
+            effect: 'HBCLI_HOTEL_SEARCH',
+            params: {
+                destination: '深圳',
+                fallbackPath,
+                timeoutMs: 30_000
+            }
+        });
+        assert.equal(itp.trace.attempts, 1, `hbcli 策略永不重试,实际 attempts=${itp.trace.attempts}`);
+        assert.equal(itp.trace.channel, 'cli');
+        assert.ok(itp.trace.evidence[0]?.startsWith('[效应:HBCLI_HOTEL_SEARCH@'), 'trace 应带解译层横切证据');
+        assert.ok(itp.result !== null, '解译产物应原样透传渠道 observation(含降级形态)');
+        const viaAfter = itp.result.via;
+        assert.ok(viaAfter === 'hbcli-error' || viaAfter === 'hbcli-realtime', `渠道 via 应保真,实际 ${viaAfter}`);
+        console.log(`4. 效应解译层(attempts=1 永不重试,breaker=${itp.trace.breaker},via=${viaAfter})OK`);
+        const { apply } = await import('../src/index.js');
+        const registered = [];
+        apply({
+            tools: {
+                register: (t)=>registered.push(t)
+            }
+        }, {
+            stateRoot,
+            timeoutMs: 30_000,
+            hbcliBin: 'hbcli',
+            sessionAccess: 'ask'
+        });
+        const tool = registered.find((t)=>t.name === 'gotry_hotel_search');
+        assert.ok(tool, 'gotry_hotel_search 应已注册');
+        const obs = await tool.execute({
+            query: {
+                destination: '深圳'
+            }
+        }, null);
+        assert.equal(obs.ok, true, '工具面应返回 ok 包络(永不抛错契约)');
+        assert.ok(obs.via === 'hbcli-error' || obs.via === 'hbcli-realtime', `工具面 via 应与渠道一致,实际 ${obs.via}`);
+        const ev = String(obs.evidence);
+        if (obs.via === 'hbcli-error') {
+            assert.match(ev, /静态包/, '降级时证据链应标注静态包(估算必须显式)');
+        } else {
+            assert.match(ev, /实时API:hbcli/, '实时时证据链应标注 hbcli 时间戳');
+        }
+        assert.ok(String(obs.summary).length > 0, 'summary 应存在');
+        console.log(`5. 工具层端到端(gotry_hotel_search → 效应解译器 → ${UAT})via=${obs.via},evidence=${ev.slice(0, 46)}… OK`);
+        console.log('HBCLI E2E TESTS: 5/5 OK(隔离凭证面/实时通道/降级诚实/解译策略/工具面全链)');
+    } finally{
+        process.env.STAICLI_HOME = undefined;
+        rmSync(staicliHome, {
+            recursive: true,
+            force: true
+        });
+        rmSync(stateRoot, {
+            recursive: true,
+            force: true
+        });
+    }
+}
+main().catch((e)=>{
+    console.error(e);
+    process.exitCode = 1;
+});
+
+
+//# sourceURL=ts/scripts/hbcli-e2e-tests.ts

package/dist/scripts/hbcli-tests.js

@@ -144,4 +144,4 @@ console.log(`6. ENOENT 人话化 OK:${r6.summary}`);
 console.log('HBCLI TESTS: 8/8 OK (happy / error / no-binary / fallback-filter / fallback-no-match / v0.3.0 旗标回归 / ENOENT 人话化 / 候选路径)');
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/scripts/hbcli-tests.ts
+//# sourceURL=ts/scripts/hbcli-tests.ts

package/dist/scripts/health-watch-cli.js

@@ -0,0 +1,51 @@
+import process from 'node:process';
+import { startExtensionHealthWatch } from '../capabilities/session/health-watch.js';
+function parseArgs(argv) {
+    const args = {
+        timeoutMs: 120_000,
+        intervalMs: 5_000,
+        json: true
+    };
+    for(let i = 0; i < argv.length; i += 1){
+        const cur = argv[i];
+        if (cur === '--timeout') args.timeoutMs = parseInt(argv[++i] ?? '120000', 10);
+        else if (cur === '--interval') args.intervalMs = parseInt(argv[++i] ?? '5000', 10);
+        else if (cur === '--json') args.json = true;
+        else if (cur === '--no-json') args.json = false;
+    }
+    if (Number.isNaN(args.timeoutMs) || args.timeoutMs < 0) args.timeoutMs = 120_000;
+    if (Number.isNaN(args.intervalMs) || args.intervalMs < 1_000) args.intervalMs = 5_000;
+    return args;
+}
+async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    const businessProbe = process.argv.includes('--business-probe');
+    const watch = startExtensionHealthWatch({
+        timeoutMs: args.timeoutMs,
+        intervalMs: args.intervalMs,
+        keepBridge: true,
+        businessProbe
+    });
+    process.on('SIGINT', ()=>{
+        watch.cancel('SIGINT');
+        process.exit(0);
+    });
+    process.on('SIGTERM', ()=>{
+        watch.cancel('SIGTERM');
+        process.exit(0);
+    });
+    const outcome = await watch.waitReady();
+    if (args.json) {
+        process.stdout.write(JSON.stringify(outcome) + '\n');
+    } else {
+        process.stdout.write(`ready=${outcome.ready} attempts=${outcome.attempts} waitedMs=${outcome.waitedMs} reason=${'reason' in outcome ? outcome.reason : 'ok'}\n`);
+    }
+    process.exit(0);
+}
+main().catch((e)=>{
+    process.stderr.write(`[health-watch-cli] error: ${e instanceof Error ? e.message : String(e)}\n`);
+    process.exit(2);
+});
+
+
+//# sourceURL=ts/scripts/health-watch-cli.ts

package/dist/scripts/i18n-tests.js

@@ -31,4 +31,4 @@ assert.equal(t('md.wish_budget', {
 console.log('\nI18N TESTS: 4/4 OK(en 零缺键/默认 zh 金标准一致/en 切换数据不动/插值+回退)');
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/scripts/i18n-tests.ts
+//# sourceURL=ts/scripts/i18n-tests.ts

package/dist/scripts/incident-tests.js

@@ -93,4 +93,4 @@ console.log('INTEG 1 OK: 子进程 uncaughtException → fsync 写盘,handler
 console.log('INCIDENT TESTS: 3/3 OK');
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/scripts/incident-tests.ts
+//# sourceURL=ts/scripts/incident-tests.ts

package/dist/scripts/journey-tests.js

@@ -42,4 +42,4 @@ assert.ok(r3.suggestions.some((sg)=>sg.relax === 'total:budget'));
 console.log(`TS JOURNEY TESTS: 5/5 OK(五段全链可行,¥${r1.money_cny},与 Python oracle 结构一致)`);
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/scripts/journey-tests.ts
+//# sourceURL=ts/scripts/journey-tests.ts

package/dist/scripts/ledger-tests.js

@@ -492,4 +492,4 @@ console.log(`\nLEDGER TESTS: ${pass} ok, ${fail} fail`);
 if (fail > 0) process.exit(1);
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/scripts/ledger-tests.ts
+//# sourceURL=ts/scripts/ledger-tests.ts

package/dist/scripts/ledger-workflow-crash.js

@@ -39,4 +39,4 @@ await collectDeepPlanning(state, ticket, solve);
 process.exit(9);
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/scripts/ledger-workflow-crash.ts
+//# sourceURL=ts/scripts/ledger-workflow-crash.ts

package/dist/scripts/memory-capture-tests.js

@@ -74,4 +74,4 @@ const cur = {
 }console.log('\nMEMORY-MERGE TESTS: 3/3 OK(T1 合并守门层)');
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/scripts/memory-capture-tests.ts
+//# sourceURL=ts/scripts/memory-capture-tests.ts

package/dist/scripts/memory-decay-tests.js

@@ -80,4 +80,4 @@ pass('动机层零衰减(构造性):本模块无作用于 motivation-profile 的
 console.log(`\nMEMORY DECAY TESTS: ${n}/5 OK(memory-design P3 分级窗口/单调/地板/上界/动机零衰减)`);
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/scripts/memory-decay-tests.ts
+//# sourceURL=ts/scripts/memory-decay-tests.ts

package/dist/scripts/memory-metrics.js

@@ -21,4 +21,4 @@ console.log(`经验回流率基线 = ${verifiedWishes}/${recalledWishes} = ${ref
 if (pool.length === 0) console.log('(wish pool 为空——首访用户,指标从首条憧憬入池开始积累)');
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/scripts/memory-metrics.ts
+//# sourceURL=ts/scripts/memory-metrics.ts

package/dist/scripts/memory-value-report.js

@@ -376,4 +376,4 @@ const invokedPath = process.argv[1] ? pathToFileURL(resolve(process.argv[1])).hr
 if (import.meta.url === invokedPath) main();
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/scripts/memory-value-report.ts
+//# sourceURL=ts/scripts/memory-value-report.ts