@danceiny/gotry 0.0.1-rc.18 → 0.0.1-rc.19

package/dist/scripts/effect-tests.js

@@ -468,7 +468,280 @@ assert.equal(m10a.result.rates?.rooms?.length, 1, 'RATES 夹具回放');
 assert.equal(m10b.result.avail?.avail, true, 'CHECK_AVAIL 夹具回放');
 assert.match(m10a.trace.evidence[0] ?? '', /\[效应:mock@.*夹具回放/, 'mock trace 标注');
 console.log('10c. mock 解译器夹具回放(预订链 CI 形态)OK');
-console.log('EFFECT INTERPRETER TESTS: 10/10 OK(effect_interpreter.v1:注册表封闭/退避链/断路三态/Sentinel 不重试/mock 夹具/SESSION 红线/真实降级/M0 预订链读效应,纯离线)');
+__resetEffectBreakersForTest();
+let flakyCalls = 0;
+const ipTimeout = makeProductionInterpreter({
+    sleep: sleep0,
+    breakers: new Map(),
+    handlers: {
+        HBCLI_HOTEL_SEARCH: async ()=>{
+            flakyCalls += 1;
+            if (flakyCalls === 1) return {
+                via: 'hbcli-error',
+                exitCode: -1,
+                result: null,
+                evidence: '[实时API:hbcli@timeout@ts]',
+                latencyMs: 1,
+                error: 'timeout after 30000ms'
+            };
+            return {
+                via: 'hbcli-realtime',
+                exitCode: 0,
+                result: {
+                    hotels: []
+                },
+                evidence: '[实时API:hbcli@ts]',
+                latencyMs: 1
+            };
+        }
+    }
+});
+const itp11 = await ipTimeout({
+    effect: 'HBCLI_HOTEL_SEARCH',
+    params: {
+        destination: '迪拜'
+    }
+});
+assert.equal(itp11.trace.attempts, 2, `timeout 重试一次(attempts=2),实际 ${itp11.trace.attempts}`);
+assert.equal(itp11.result?.via, 'hbcli-realtime', '重试后恢复实时');
+assert.equal(itp11.trace.breaker, 'closed', '恢复即成功,断路不计数');
+let hardCalls = 0;
+const ipEnoent = makeProductionInterpreter({
+    sleep: sleep0,
+    breakers: new Map(),
+    handlers: {
+        HBCLI_HOTEL_SEARCH: async ()=>{
+            hardCalls += 1;
+            return {
+                via: 'hbcli-error',
+                exitCode: -1,
+                result: null,
+                evidence: '[实时API:hbcli@spawn_error@ts]',
+                latencyMs: 1,
+                error: 'spawn hbcli ENOENT'
+            };
+        }
+    }
+});
+const itp11b = await ipEnoent({
+    effect: 'HBCLI_HOTEL_SEARCH',
+    params: {
+        destination: '迪拜'
+    }
+});
+assert.equal(itp11b.trace.attempts, 1, 'ENOENT 类永不重试(切换不是重试契约不变)');
+console.log('11. HBCLI×timeout 冷启动重试(timeout→attempts=2 恢复实时;ENOENT→attempts=1)OK');
+__resetEffectBreakersForTest();
+const sixChannels = [
+    [
+        'ANYTHING_SEARCH',
+        'cli',
+        {
+            ok: true,
+            via: 'hbcli-anything',
+            verdict: 'hit',
+            evidence: 'e',
+            latencyMs: 1
+        }
+    ],
+    [
+        'WEB_READ',
+        'api',
+        {
+            ok: true,
+            via: 'r.jina.ai',
+            evidence: 'e',
+            latencyMs: 1
+        }
+    ],
+    [
+        'GITHUB_SEARCH',
+        'cli',
+        {
+            ok: true,
+            verdict: 'found',
+            evidence: 'e',
+            latencyMs: 1
+        }
+    ],
+    [
+        'VIDEO_SUBTITLE',
+        'cli',
+        {
+            ok: true,
+            verdict: 'found',
+            evidence: 'e',
+            latencyMs: 1
+        }
+    ],
+    [
+        'AGENT_REACH',
+        'cli',
+        {
+            ok: true,
+            verdict: 'found',
+            channel: 'v2ex',
+            method: 'read',
+            evidence: 'e',
+            latencyMs: 1
+        }
+    ],
+    [
+        'SESSION_LOGIN',
+        'browser',
+        {
+            ok: true,
+            via: 'session-login',
+            verdict: 'pending',
+            evidence: 'e',
+            latencyMs: 1
+        }
+    ]
+];
+for (const [fx, channel, obs] of sixChannels){
+    const ip = makeProductionInterpreter({
+        sleep: sleep0,
+        breakers: new Map(),
+        handlers: {
+            [fx]: async ()=>obs
+        }
+    });
+    const out = await ip({
+        effect: fx,
+        params: {}
+    });
+    assert.equal(out.result, obs, `${fx} 透传原样`);
+    assert.equal(out.trace.channel, channel, `${fx} trace.channel=${channel}(策略表行在案)`);
+    assert.equal(out.trace.attempts, 1, `${fx} 成功单次执行`);
+}
+console.log('12a. 六渠道入表(透传 + trace.channel 与策略表一致)OK');
+for (const fx of [
+    'AGENT_REACH',
+    'SESSION_LOGIN'
+]){
+    const ip = makeProductionInterpreter({
+        sleep: sleep0,
+        breakers: new Map(),
+        handlers: {
+            [fx]: async ()=>{
+                throw new Error('upstream says no');
+            }
+        }
+    });
+    const out = await ip({
+        effect: fx,
+        params: {}
+    });
+    assert.equal(out.result, null, `${fx} 抛错 → result=null`);
+    assert.equal(out.trace.attempts, 1, `${fx} 永不重试(attempts=1)`);
+}
+console.log('12b. AGENT_REACH/SESSION_LOGIN 永不重试(反射桥透传/浏览器风控红线)OK');
+__resetEffectBreakersForTest();
+let webCalls = 0;
+const ipWeb = makeProductionInterpreter({
+    sleep: sleep0,
+    breakers: new Map(),
+    handlers: {
+        WEB_READ: async ()=>{
+            webCalls += 1;
+            if (webCalls === 1) throw new Error('socket hang up');
+            return {
+                ok: true,
+                via: 'r.jina.ai',
+                evidence: 'e',
+                latencyMs: 1
+            };
+        }
+    }
+});
+const outWeb = await ipWeb({
+    effect: 'WEB_READ',
+    params: {
+        url: 'https://example.com'
+    }
+});
+assert.equal(outWeb.trace.attempts, 2, `WEB_READ 瞬时抖动重试 1 次,实际 ${outWeb.trace.attempts}`);
+let ghTimeoutCalls = 0;
+const ipGhTimeout = makeProductionInterpreter({
+    sleep: sleep0,
+    breakers: new Map(),
+    handlers: {
+        GITHUB_SEARCH: async ()=>{
+            ghTimeoutCalls += 1;
+            if (ghTimeoutCalls === 1) return {
+                ok: false,
+                verdict: 'timeout',
+                evidence: 'e',
+                latencyMs: 1,
+                stdout: '',
+                stderr: ''
+            };
+            return {
+                ok: true,
+                verdict: 'found',
+                evidence: 'e',
+                latencyMs: 1
+            };
+        }
+    }
+});
+const outGhT = await ipGhTimeout({
+    effect: 'GITHUB_SEARCH',
+    params: {
+        query: 'x'
+    }
+});
+assert.equal(outGhT.trace.attempts, 2, 'GITHUB timeout 类重试 1 次(冷启动同 HBCLI 实况)');
+let ghNiCalls = 0;
+const ipGhNi = makeProductionInterpreter({
+    sleep: sleep0,
+    breakers: new Map(),
+    handlers: {
+        GITHUB_SEARCH: async ()=>{
+            ghNiCalls += 1;
+            return {
+                ok: false,
+                verdict: 'not-installed',
+                evidence: 'e',
+                latencyMs: 0
+            };
+        }
+    }
+});
+const outGhNi = await ipGhNi({
+    effect: 'GITHUB_SEARCH',
+    params: {
+        query: 'x'
+    }
+});
+assert.equal(outGhNi.trace.attempts, 1, 'not-installed 是配置态(needs-setup 族)不重试');
+console.log('12c. WEB_READ/GITHUB/VIDEO 策略行(timeout 重试/配置态不重试)OK');
+__resetEffectBreakersForTest();
+const mockIp = makeMockInterpreter({
+    ANYTHING_SEARCH: {
+        ok: true,
+        via: 'hbcli-anything',
+        verdict: 'hit',
+        evidence: '[实时API:hbcli-anything@ts]',
+        latencyMs: 1
+    }
+});
+const outMock = await mockIp({
+    effect: 'ANYTHING_SEARCH',
+    params: {
+        keyword: '大理'
+    }
+});
+assert.equal(outMock.result.verdict, 'hit', 'mock 夹具回放原样');
+assert.equal(outMock.trace.channel, 'mock', 'mock 通道标注');
+const outMockBad = await mockIp({
+    effect: 'SESSION_LOGIN',
+    params: {}
+});
+assert.equal(outMockBad.result, null, '未登记夹具 → result=null');
+assert.equal(outMockBad.trace.declined, 'unknown-effect', '未登记夹具 → 结构化拒绝');
+console.log('12d. mock 夹具回放/未登记拒绝(新效应同语义)OK');
+console.log('EFFECT INTERPRETER TESTS: 12/12 OK(effect_interpreter.v1:注册表封闭/退避链/断路三态/Sentinel 不重试/mock 夹具/SESSION 红线/真实降级/M0 预订链读效应/HBCLI timeout 重试/D-23 六渠道入表,纯离线)');
 
 
 //# sourceURL=ts/scripts/effect-tests.ts

package/dist/scripts/extension-tests.js

@@ -1,15 +1,17 @@
 import assert from 'node:assert/strict';
 import { fork } from 'node:child_process';
 import { createHash } from 'node:crypto';
-import { mkdtempSync, readFileSync, rmSync } from 'node:fs';
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { BRIDGE_PORTS, EXTENSION_ID, EXTENSION_ID_STORE, EXTENSION_ORIGIN, EXTENSION_ORIGIN_STORE, EXTENSION_ORIGINS, EXTENSION_STORE_URL, createSessionBridge, __resetSessionBridgeForTest, __setSessionBridgeForTest } from '../capabilities/session/extension-bridge.js';
+import { BRIDGE_PORTS, EXTENSION_ID, EXTENSION_ID_STORE, EXTENSION_ORIGIN, EXTENSION_ORIGIN_STORE, EXTENSION_ORIGINS, EXTENSION_STORE_URL, createSessionBridge, localExtensionInstalled, needsExtensionSummary, __resetSessionBridgeForTest, __setSessionBridgeForTest } from '../capabilities/session/extension-bridge.js';
 import { classifyBridgeFailure, extensionCookieNames, extensionSearchJob } from '../capabilities/session/extension-channel.js';
-import { appendExtensionAudit, resolveTransportMode, sessionFlightSearch } from '../capabilities/session-search.js';
+import { appendExtensionAudit, resolveTransportMode, sessionFlightSearch, sessionHotelSearch, sessionTrainSearch, __resetRateLimiterForTest } from '../capabilities/session-search.js';
 import { sessionLogin } from '../capabilities/session-login.js';
 import { LOGIN_COOKIE_NAMES, NETWORK_HINTS, SITE_DOMAIN } from '../capabilities/session/adapters/ctrip-flight.js';
+import { HOTEL_NETWORK_HINTS, HOTEL_SITE_HOST, buildHotelEntryUrl } from '../capabilities/session/adapters/ctrip-hotel.js';
+import { TRAIN_NETWORK_HINTS, TRAIN_SITE_HOST } from '../capabilities/session/adapters/rail-12306.js';
 import { evaluateDoubleSource } from '../capabilities/session/benchmark.js';
 const EXT_DIR = fileURLToPath(new URL('../../extension/', import.meta.url));
 const UNREF_CHILD = fileURLToPath(new URL('./fixtures/extension-bridge-unref-child.mjs', import.meta.url));
@@ -161,11 +163,14 @@ async function main() {
         ].sort((a, b)=>a - b));
         assert.ok(manifest.host_permissions.includes('https://*.ctrip.com/*'));
     });
-    await check('防漂移:content_scripts 双 world 只挂 flights.ctrip.com(MAIN 嗅探 + ISOLATED 桥)', ()=>{
+    await check('防漂移:content_scripts 双 world 挂 ctrip 双站+12306(MAIN 嗅探 + ISOLATED 桥;2026-09-03 酒/火实装)', ()=>{
         assert.equal(manifest.content_scripts.length, 2);
         for (const cs of manifest.content_scripts){
             assert.deepEqual(cs.matches, [
-                'https://flights.ctrip.com/*'
+                'https://flights.ctrip.com/*',
+                `https://${HOTEL_SITE_HOST}/*`,
+                `https://${TRAIN_SITE_HOST}/*`,
+                'https://www.12306.cn/*'
             ]);
             assert.equal(cs.run_at, 'document_start');
         }
@@ -182,19 +187,42 @@ async function main() {
     const backgroundJs = read('background.js');
     const contentMainJs = read('content-main.js');
     const contentBridgeJs = read('content-bridge.js');
+    await check('版本跟随主版本:manifest version_name = package.json version;version = 四段投影(0.0.1-rc.N → 0.0.1.N,founder 2026-09-03 拍板)', ()=>{
+        const pkgVersion = JSON.parse(readFileSync(join(EXT_DIR, '..', 'package.json'), 'utf8')).version;
+        assert.equal(manifest.version_name, pkgVersion, 'version_name 应与 gotry 主版本逐字一致');
+        const m = /^(\d+)\.(\d+)\.(\d+)-rc\.(\d+)$/.exec(pkgVersion);
+        assert.ok(m, `主版本形态应为 x.y.z-rc.N,实际 ${pkgVersion}`);
+        assert.equal(manifest.version, `${m[1]}.${m[2]}.${m[3]}.${m[4]}`, 'version 应为主版本的四段投影(Chrome manifest 只收点分整数)');
+        assert.equal(manifest.content_scripts.length, 2);
+    });
     await check('防漂移:票据 cookie 名单(Node LOGIN_COOKIE_NAMES)= 扩展 SITES.ticketNames', ()=>{
         for (const name of LOGIN_COOKIE_NAMES){
             assert.ok(backgroundJs.includes(`'${name}'`), `background.js 缺票据名 ${name}`);
         }
         assert.ok(backgroundJs.includes("domain: 'ctrip.com'"), 'background.js 站点域应与 LOGIN_TARGETS.domain 对账');
     });
-    await check('防漂移:NETWORK_HINTS(Node)= content-main HINT_RE(MAIN-world 嗅探面)', ()=>{
+    await check('防漂移:NETWORK_HINTS + HOTEL_NETWORK_HINTS(Node)= content-main 嗅探面(MAIN-world)', ()=>{
         for (const hint of NETWORK_HINTS){
             assert.ok(stripRe(contentMainJs).includes(stripRe(hint.source)), `content-main.js 缺 hint ${hint.source}`);
         }
+        for (const hint of HOTEL_NETWORK_HINTS){
+            assert.ok(stripRe(contentMainJs).includes(stripRe(hint.source)), `content-main.js 缺酒店 hint ${hint.source}`);
+        }
+        for (const hint of TRAIN_NETWORK_HINTS){
+            assert.ok(stripRe(contentMainJs).includes(stripRe(hint.source)), `content-main.js 缺火车 hint ${hint.source}`);
+        }
+        assert.ok(contentMainJs.includes('12306'), 'content-main.js 应感知 12306 页域(火车嗅探作用域)');
+        assert.ok(contentMainJs.includes('hotels\\.ctrip\\.com'), 'content-main.js 应感知酒店页域(形状嗅探兜底的作用域)');
+    });
+    await check('防漂移:酒店形状签名(Node looksLikeHotelListBody 同款)= content-main HOTEL_BODY_SIG_RE', ()=>{
+        assert.ok(stripRe(contentMainJs).includes('"hotelList"|"hotelMatchInfos"|"hotelName"'), '形状嗅探签名两侧必须逐字一致');
     });
-    await check('防漂移:检索/登录 URL 面(background 只允许 flights.ctrip.com;ISOLATED 桥转发两类事件)', ()=>{
-        assert.ok(backgroundJs.includes('https://flights.ctrip.com/'));
+    await check('防漂移:检索/登录 URL 面(background per-site 白名单 flights+hotels;ISOLATED 桥转发两类事件)', ()=>{
+        assert.ok(backgroundJs.includes('https://flights.ctrip.com/'), 'background 应含机票检索白名单');
+        assert.ok(backgroundJs.includes(`https://${HOTEL_SITE_HOST}/`), 'background 应含酒店检索白名单(2026-09-03 实装)');
+        assert.ok(backgroundJs.includes('https://kyfw.12306.cn/'), 'background 应含火车检索白名单(2026-09-03 实装)');
+        assert.ok(backgroundJs.includes("'ctrip-hotel'"), 'background SITES 应注册 ctrip-hotel');
+        assert.ok(backgroundJs.includes("'train-12306'"), 'background SITES 应注册 train-12306');
         assert.ok(contentMainJs.includes('gotry-ctrip-sniff'));
         assert.ok(contentBridgeJs.includes('gotry-ctrip-sniff'));
         assert.ok(contentBridgeJs.includes('gotry-page'));
@@ -453,16 +481,43 @@ async function main() {
                                 ]
                             };
                             if (job.kind === 'search') {
-                                assert.ok(String(job.url).startsWith('https://flights.ctrip.com/'));
+                                const u = String(job.url);
+                                const isHotel = u.startsWith(`https://${HOTEL_SITE_HOST}/`);
+                                const isTrain = u.startsWith('https://kyfw.12306.cn/');
+                                assert.ok(u.startsWith('https://flights.ctrip.com/') || isHotel || isTrain, `search job 只允许已注册站点域,实际 ${u}`);
                                 return {
                                     ok: true,
                                     kind: 'search',
-                                    body: JSON.stringify({
+                                    body: isHotel ? JSON.stringify({
+                                        data: {
+                                            hotelList: [
+                                                {
+                                                    hotelId: 442516,
+                                                    hotelName: 'Hotel X',
+                                                    star: 5,
+                                                    commentScore: 4.7,
+                                                    priceInfo: {
+                                                        avgPrice: 680
+                                                    }
+                                                }
+                                            ]
+                                        }
+                                    }) : isTrain ? JSON.stringify({
+                                        data: {
+                                            result: [
+                                                '|预订|24000000G1375|G1375|SHH|KMM|SHH|KMM|07:35|15:27|07:52|Y|yp|x|x|loc|01|02|Y|0|--|--|--|--|--|--|有|--|--|有|有|有|有|--|ex|st|'
+                                            ],
+                                            map: {
+                                                SHH: '上海南',
+                                                KMM: '昆明'
+                                            }
+                                        }
+                                    }) : JSON.stringify({
                                         data: {
                                             flightItineraryList: []
                                         }
                                     }),
-                                    title: '机票列表'
+                                    title: isHotel ? '酒店列表' : isTrain ? '12306 车票预订' : '机票列表'
                                 };
                             }
                             return {
@@ -491,6 +546,40 @@ async function main() {
             assert.ok(search.ok);
             assert.equal(search.ok ? search.timedOut : true, false);
             assert.ok(search.ok ? search.body.includes('flightItineraryList') : false);
+            const hotelLane = await extensionSearchJob({
+                site: 'ctrip-hotel',
+                url: `https://${HOTEL_SITE_HOST}/hotels/list?city=220&checkin=2026-12-01&checkout=2026-12-03`,
+                timeoutMs: 3_000
+            });
+            assert.ok(hotelLane.ok, '酒店 search job 应放行(per-site 白名单)');
+            assert.ok(hotelLane.ok ? hotelLane.body.includes('hotelList') : false);
+            __resetRateLimiterForTest();
+            const hotelSession = await sessionHotelSearch({
+                to: '迪拜',
+                cityId: 220,
+                checkIn: '2026-12-01',
+                checkOut: '2026-12-03',
+                timeoutMs: 3_000
+            });
+            assert.equal(hotelSession.verdict, 'hit', `酒店会话检索应 hit,实际 ${hotelSession.verdict}:${hotelSession.error ?? ''}`);
+            assert.ok(hotelSession.evidence.includes('[会话:ctrip-hotel@'), '酒店证据链 [会话:ctrip-hotel@ts]');
+            assert.equal(hotelSession.hotels?.[0]?.name, 'Hotel X');
+            assert.equal(hotelSession.hotels?.[0]?.price, 680);
+            assert.ok(hotelSession.hotels?.[0]?.jumpUrl?.includes('/hotel/442516'), 'jumpUrl 由 hotelId 构造(预订由人在落地页完成)');
+            __resetRateLimiterForTest();
+            const trainSession = await sessionTrainSearch({
+                from: '上海',
+                to: '昆明',
+                date: '2026-12-01',
+                timeoutMs: 3_000
+            });
+            assert.equal(trainSession.verdict, 'hit', `火车会话检索应 hit,实际 ${trainSession.verdict}:${trainSession.error ?? ''}`);
+            assert.ok(trainSession.evidence.includes('[会话:train-12306@'), '火车证据链 [会话:train-12306@ts]');
+            assert.ok(trainSession.evidence.includes('公开查询面'), '证据链标注公开查询面(无登录闸的诚实口径)');
+            assert.equal(trainSession.trains?.[0]?.trainCode, 'G1375');
+            assert.equal(trainSession.trains?.[0]?.depTime, '07:35');
+            assert.equal(trainSession.trains?.[0]?.durationMin, 472);
+            assert.ok(trainSession.trains?.[0]?.jumpUrl?.includes('kyfw.12306.cn'), 'jumpUrl=查询落地页(人选车完成预订)');
             const login = await sessionLogin({
                 site: 'ctrip-flight'
             });
@@ -558,6 +647,35 @@ async function main() {
         assert.equal(e.quota_disposition, 'no_spend_waiting_user');
         assert.equal(e.retry_allowed, false);
     });
+    await check('needs-extension 自适应文案:本地已落位 → 双通道完整指引(含开发者模式)', ()=>{
+        const s = needsExtensionSummary({
+            localInstalled: true
+        });
+        assert.match(s, /开发者模式「加载已解压的扩展程序」/, '本地通道在 → 保留开发者模式指引');
+        assert.ok(s.includes(EXTENSION_STORE_URL), '商店 URL 仍在');
+    });
+    await check('needs-extension 自适应文案:本地未落位(商店版用户/未装)→ 自动跳过 dev-mode 文案', ()=>{
+        const s = needsExtensionSummary({
+            localInstalled: false
+        });
+        assert.doesNotMatch(s, /开发者模式/, '不再推开发者模式/本地通道(商店版用户不该被指导 load unpacked)');
+        assert.doesNotMatch(s, /加载已解压/, '不再出现 load unpacked 字样');
+        assert.match(s, /已从 Chrome 商店安装/, '给「已装商店版?」提示(打开 Chrome 即可,无需再装)');
+        assert.match(s, /应用商店一键装/, '未装用户仍得商店一键装指引');
+    });
+    await check('localExtensionInstalled:HOME 注入可测(manifest 存在=本地通道在)', ()=>{
+        const fakeHome = mkdtempSync(join(tmpdir(), 'gotry-ext-home-'));
+        assert.equal(localExtensionInstalled(fakeHome), false, '空 HOME → 本地通道未落位');
+        mkdirSync(join(fakeHome, '.gotry', 'extension'), {
+            recursive: true
+        });
+        writeFileSync(join(fakeHome, '.gotry', 'extension', 'manifest.json'), '{}', 'utf-8');
+        assert.equal(localExtensionInstalled(fakeHome), true, 'manifest 落位 → true');
+        rmSync(fakeHome, {
+            recursive: true,
+            force: true
+        });
+    });
     await b.close();
     console.log(`\n§38 extension bridge: ${passed} 段全绿`);
 }

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

@@ -1,6 +1,6 @@
 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 { BOOKABLE_FACT_SCHEMA, checkSameDayDeparture, dedupeFacts, detectBacktrack, factsFromFlyai, factsFromHotel, flightClaimVerdict, itineraryInvariants, latestFactsForRouteDate, negativeFact, renderConnection, renderFlightFact, renderHotelFact, renderNightsLine, renderPolicyFact } from '../src/bookable-facts.js';
 import { ARTIFACT_GATE_SCHEMA, gateArtifact } from '../src/artifact-gate.js';
 let pass = 0;
 let fail = 0;
@@ -311,7 +311,96 @@ const goodReport = gateArtifact(goodArtifact, registry, map, {
 });
 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`);
+{
+    const fetchedAt = '2026-09-04T00:00:00.000Z';
+    assert(factsFromHotel({
+        source: 'flyai-hotel',
+        destination: '大理',
+        verdict: 'hit',
+        options: 9,
+        evidence: 'e',
+        fetchedAt
+    }).length === 0, '摸底(无档期)酒店检索不落账(无 exact-date 语义)');
+    assert(factsFromHotel({
+        source: 'flyai-hotel',
+        destination: '大理',
+        checkIn: '2026-10-01',
+        checkOut: '2026-10-03',
+        verdict: 'needs-setup',
+        options: 0,
+        evidence: 'e',
+        fetchedAt
+    }).length === 0 && factsFromHotel({
+        source: 'flyai-hotel',
+        destination: '大理',
+        checkIn: '2026-10-01',
+        checkOut: '2026-10-03',
+        verdict: 'error',
+        options: 0,
+        evidence: 'e',
+        fetchedAt
+    }).length === 0, 'needs-setup/error 传输失败永不落负事实(ADR-19 不变量)');
+    const hitFacts = factsFromHotel({
+        source: 'flyai-hotel',
+        destination: '大理',
+        checkIn: '2026-10-01',
+        checkOut: '2026-10-03',
+        verdict: 'hit',
+        options: 9,
+        evidence: 'e',
+        fetchedAt
+    });
+    const missFacts = factsFromHotel({
+        source: 'session:ctrip-hotel',
+        destination: '大理',
+        checkIn: '2026-10-01',
+        checkOut: '2026-10-03',
+        verdict: 'miss',
+        options: 0,
+        evidence: 'e',
+        fetchedAt
+    });
+    assert(hitFacts.length === 1 && hitFacts[0].bookability === 'bookable_exact_date' && hitFacts[0].options_masked === 9, 'exact-date hit → 正事实(在架家数,无数字价字段)');
+    assert(!('price' in hitFacts[0]), '酒店事实无 price 字段(打码价保真,不落数字价)');
+    assert(missFacts.length === 1 && missFacts[0].bookability === 'unavailable_exact_date', 'exact-date miss → 负事实');
+    const hotelLine = renderHotelFact(hitFacts[0]);
+    assert(hotelLine.includes(`fact:${hitFacts[0].fact_id}`), 'renderHotelFact 行内嵌 fact 锚点');
+    const anchoredArtifact = [
+        '## 住宿',
+        hotelLine
+    ].join('\n');
+    const anchoredReport = gateArtifact(anchoredArtifact, [
+        ...hitFacts
+    ], map, {
+        trip_year: 2026
+    });
+    assert(anchoredReport.verdict === 'pass' && anchoredReport.traceable === 1, `锚点酒店行 → 锚点确定性回溯 pass(实际 ${anchoredReport.verdict}/traceable=${anchoredReport.traceable})`);
+    const forged = anchoredArtifact.replace(hitFacts[0].fact_id, '0123456789abcdef');
+    const forgedReport = gateArtifact(forged, [
+        ...hitFacts
+    ], map, {
+        trip_year: 2026
+    });
+    assert(forgedReport.violations.some((v)=>v.kind === 'fact_anchor_unknown'), '手改/伪造锚点 → fact_anchor_unknown');
+    const claimHit = gateArtifact('## 住宿\n- 大理 2026-10-01→2026-10-03 洱海民宿有房可订', [
+        ...hitFacts
+    ], map, {
+        trip_year: 2026
+    });
+    assert(claimHit.verdict === 'pass' && claimHit.traceable === 1, '启发式酒店 claim 命中在册 hit → traceable');
+    const claimMiss = gateArtifact('## 住宿\n- 大理 2026-10-01→2026-10-03 洱海民宿有房可订 ✓', [
+        ...missFacts
+    ], map, {
+        trip_year: 2026
+    });
+    assert(claimMiss.violations.some((v)=>v.kind === 'not_in_source'), 'exact-date miss 在册却写有房 → not_in_source');
+    assert(claimMiss.violations.some((v)=>v.kind === 'unconditional_check'), '对未核验酒店用 ✓ → unconditional_check');
+    const noCtx = gateArtifact('## 住宿\n- 住宿:湖景房有房可订 ✓', [], map, {
+        trip_year: 2026
+    });
+    assert(noCtx.violations.some((v)=>v.kind === 'unverifiable_hotel_claim'), '缺目的地上下文 → unverifiable_hotel_claim(fail closed)');
+    console.log(`  ok - §10 酒店事实闸(D-26)八断言完成`);
+}console.log(`\nFACT GATE TESTS: ${pass} pass, ${fail} fail`);
 if (fail > 0) process.exit(1);
 
 

package/dist/scripts/flyai-tests.js

@@ -85,11 +85,27 @@ const f = await flyaiSearch({
 assert.equal(f.ok, false);
 assert.equal(f.verdict, 'error', '非零退出应判 error');
 console.log('4. 非零退出 → error OK');
+const trialBin = join(tmp, 'flyai-trial');
+await writeFile(trialBin, `#!/bin/sh\necho 'search-hotel: MCP HTTP 429: Body: {"jsonrpc":"2.0","id":"1","error":{"code":-32603,"message":"Trial limit reached. Please visit the console at flyai.open.fliggy.com to get a formal API Key"}}' >&2\nexit 1\n`, {
+    mode: 0o755
+});
+const t = await flyaiSearch({
+    ...base,
+    cliBin: trialBin,
+    timeoutMs: 5000
+});
+assert.equal(t.ok, false);
+assert.equal(t.verdict, 'needs-setup', `429 达限应判 needs-setup,实际 ${t.verdict}`);
+assert.match(t.setup ?? '', /FLYAI_API_KEY/, 'setup 指引带 FLYAI_API_KEY 配置路径');
+assert.match(t.setup ?? '', /flyai\.open\.fliggy\.com/, 'setup 指引带控制台入口');
+assert.match(t.setup ?? '', /请勿重试|勿重试|不要重试/, 'setup 明示本会话勿重试');
+assert.match(t.error ?? '', /429|Trial limit/i, 'error 保留上游 429 原话');
+assert.match(t.evidence, /\[实时API:flyai@error@/, '证据链标注');
 await rm(tmp, {
     recursive: true,
     force: true
 });
-console.log('FLYAI TESTS: 4/4 OK(离线假 CLI:Sentinel→error / 空 itemList→miss / 命中→hit / exit≠0→error)');
+console.log('FLYAI TESTS: 5/5 OK(离线假 CLI:Sentinel→error / 空 itemList→miss / 命中→hit / exit≠0→error / 429 达限→needs-setup)');
 
 
 //# sourceURL=ts/scripts/flyai-tests.ts

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

@@ -144,9 +144,7 @@ async function main() {
         const tool = registered.find((t)=>t.name === 'gotry_hotel_search');
         assert.ok(tool, 'gotry_hotel_search 应已注册');
         const obs = await tool.execute({
-            query: {
-                destination: '深圳'
-            }
+            destination: '深圳'
         }, null);
         assert.equal(obs.ok, true, '工具面应返回 ok 包络(永不抛错契约)');
         assert.ok(obs.via === 'hbcli-error' || obs.via === 'hbcli-realtime', `工具面 via 应与渠道一致,实际 ${obs.via}`);