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

package/dist/scripts/flyai-tests.js

@@ -1,99 +1,362 @@
+/**
+ * flyai 能力层测试(离线,临时假 CLI 脚本经 cliBin 注入,零网络):
+ *  1. Sentinel 限流形状 {"message":"SentinelBlockException..."}——合法 JSON 但无 data.itemList,
+ *     曾被 `data?.itemList ?? []` 吞成 0/0 静默 miss(issue #24)→ 应判 error 且保留 sentinel 字样
+ *  2. 业务空形状 {"data":{"itemList":[]}} → verdict=miss(0/0,evidence 标注)
+ *  3. 非空 transport itemList 只要有 malformed sibling → registered effect error,不落负事实
+ *     (flight/train 各一条有效+畸形 fixture;无 partial-completeness hit)
+ *  4. 非空 hotel itemList 有 malformed sibling → registered effect error,不落酒店事实
+ *  5. transport/hotel 字段类型与空白校验不接受 truthy 数字/对象,并覆盖 official Alibaba shape
+ *  6. 完整合法 flight/train/hotel → verdict=hit;有效空列表仍 miss
+ *  7. exit≠0 → verdict=error
+ *  8. 试用额度达限(exit 1 + MCP HTTP 429 "Trial limit reached",2026-09-02 迪拜
+ *     session 实况)→ verdict=needs-setup + setup 指引(不再当通用 error 盲重试)
+ *
+ * 运行: cd ts && npx tsx scripts/flyai-tests.ts
+ */
 import assert from 'node:assert/strict';
 import { writeFile, mkdtemp, rm } from 'node:fs/promises';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { flyaiSearch } from '../capabilities/flyai.js';
+import { makeProductionInterpreter } from '../capabilities/effect.js';
+import { loadFactRegistry } from '../capabilities/fact-log.js';
+import { apply } from '../src/index.js';
+import { factsFromFlyai, factsFromHotel } from '../src/bookable-facts.js';
 const tmp = await mkdtemp(join(tmpdir(), 'flyai-test-'));
 async function fakeCli(name, code, payload) {
     const p = join(tmp, name);
-    await writeFile(p, `#!/bin/sh\necho '${payload}'\nexit ${code}\n`, {
-        mode: 0o755
-    });
+    await writeFile(p, `#!/bin/sh\necho '${payload}'\nexit ${code}\n`, { mode: 0o755 });
     return p;
 }
-const base = {
-    kind: 'flight',
-    origin: '上海',
-    destination: '丽江',
-    depDate: '2026-10-01'
+const base = { kind: 'flight', origin: '上海', destination: '丽江', depDate: '2026-10-01' };
+const trainBase = { kind: 'train', origin: '上海', destination: '大理', depDate: '2026-10-01' };
+const hotelBase = { kind: 'hotel', destName: '大理', checkInDate: '2026-10-01', checkOutDate: '2026-10-03' };
+async function registeredSearch(q) {
+    const registeredFlyai = makeProductionInterpreter({ breakers: new Map(), sleep: async () => { } });
+    const observation = await registeredFlyai({ effect: 'FLYAI_SEARCH', params: q });
+    assert.ok(observation.result, 'registered FlyAI effect 应返回结构化 observation');
+    return observation.result;
+}
+const registeredStateRoot = await mkdtemp(join(tmpdir(), 'flyai-registered-e2e-'));
+let registeredCliBin = '';
+const registeredTools = [];
+const registeredBreakers = new Map();
+const registeredContext = {
+    tools: { register: (tool) => registeredTools.push(tool) },
+    systemPrompt: { variable: () => { } },
+    on: () => () => { },
+    get: () => undefined,
 };
-const sentinelBin = await fakeCli('flyai-sentinel', 0, '{"message":"SentinelBlockException: flow control"}');
-const s = await flyaiSearch({
-    ...base,
-    cliBin: sentinelBin,
-    timeoutMs: 5000
+const isolatedConfig = {
+    stateRoot: registeredStateRoot,
+    timeoutMs: 5000,
+    hbcliBin: 'hbcli-not-on-path',
+    sessionAccess: 'off',
+};
+const registeredProductionEffect = makeProductionInterpreter({
+    breakers: registeredBreakers,
+    sleep: async () => { },
+    handlers: {
+        FLYAI_SEARCH: async (params) => flyaiSearch({ ...params, cliBin: registeredCliBin, timeoutMs: 5000 }),
+    },
 });
+apply(registeredContext, isolatedConfig, { effect: registeredProductionEffect });
+const registeredFlyaiTool = registeredTools.find(tool => tool.name === 'gotry_flyai_search');
+assert.ok(registeredFlyaiTool, 'apply 应注册 gotry_flyai_search');
+async function registeredToolSearch(name, args, itemList) {
+    registeredCliBin = await fakeCli(`registered-${name}`, 0, JSON.stringify({ data: { itemList } }));
+    return await registeredFlyaiTool.execute(args, null);
+}
+async function assertRegisteredFactLogEmpty(label) {
+    const facts = await loadFactRegistry(registeredStateRoot);
+    assert.equal(facts.length, 0, `${label} 不得落 positive/negative fact`);
+    registeredBreakers.clear();
+}
+// 1. 真正 registered tool E2E:apply → gotry_flyai_search → production effect/parser → fact sidecar
+const registeredMalformedCases = [
+    { name: 'all-malformed-flight', args: { kind: 'flight', from: '北京', to: '上海', date: '2027-04-01' }, itemList: [{}] },
+    { name: 'all-malformed-train', args: { kind: 'train', from: '北京', to: '上海', date: '2027-04-02' }, itemList: [null] },
+    { name: 'all-malformed-hotel', args: { kind: 'hotel', to: '大理', checkIn: '2027-04-03', checkOut: '2027-04-05' }, itemList: [{ name: 42 }] },
+];
+for (const testCase of registeredMalformedCases) {
+    const result = await registeredToolSearch(testCase.name, testCase.args, testCase.itemList);
+    assert.equal(result.ok, false, `${testCase.name} 应返回 structured error(ok=false)`);
+    assert.equal(result.verdict, 'error', `${testCase.name} 应经 registered tool 返回 error`);
+    assert.match(String(result.evidence ?? ''), /flyai@error|malformed/i, `${testCase.name} 应保留结构化 error evidence`);
+    await assertRegisteredFactLogEmpty(testCase.name);
+}
+const registeredMixedCases = [
+    {
+        name: 'mixed-flight',
+        args: { kind: 'flight', from: '北京', to: '上海', date: '2027-04-06' },
+        itemList: [{ adultPrice: '¥400.0', journeys: [{ segments: [{ marketingTransportNo: 'CA1883', marketingTransportName: '国航', depDateTime: '2027-04-06 21:00:00', arrDateTime: '2027-04-06 23:20:00', depStationName: '首都国际机场', arrStationName: '浦东国际机场', duration: '140分钟' }] }] }, {}],
+    },
+    {
+        name: 'mixed-train',
+        args: { kind: 'train', from: '北京', to: '上海', date: '2027-04-07' },
+        itemList: [{ adultPrice: '¥553.0', journeys: [{ segments: [{ marketingTransportNo: 'G11', depDateTime: '2027-04-07 08:00:00', arrDateTime: '2027-04-07 12:28:00', depStationName: '北京南', arrStationName: '上海虹桥', duration: '268分钟' }] }] }, null],
+    },
+    {
+        name: 'mixed-hotel',
+        args: { kind: 'hotel', to: '大理', checkIn: '2027-04-08', checkOut: '2027-04-10' },
+        itemList: [{ name: '大理A 酒店', star: '高档型', price: '¥7xx', shId: 'hotel-a', detailUrl: 'https://example.test/hotel-a' }, { name: null }],
+    },
+];
+for (const testCase of registeredMixedCases) {
+    const result = await registeredToolSearch(testCase.name, testCase.args, testCase.itemList);
+    assert.equal(result.ok, false, `${testCase.name} 应返回 structured error(ok=false)`);
+    assert.equal(result.verdict, 'error', `${testCase.name} 应经 registered tool 返回整体 error`);
+    assert.match(String(result.evidence ?? ''), /flyai@error|malformed/i, `${testCase.name} 应保留结构化 error evidence`);
+    await assertRegisteredFactLogEmpty(testCase.name);
+}
+const registeredMiss = await registeredToolSearch('exact-empty-flight', { kind: 'flight', from: '深圳', to: '普吉', date: '2027-04-11' }, []);
+assert.equal(registeredMiss.verdict, 'miss', `registered exact empty list 应返回 miss: ${JSON.stringify(registeredMiss)}`);
+const factsAfterMiss = await loadFactRegistry(registeredStateRoot);
+assert.equal(factsAfterMiss.length, 1, 'registered miss 只应产生一条 exact-date negative fact');
+assert.equal(factsAfterMiss[0]?.kind, 'flight');
+assert.equal(factsAfterMiss[0]?.bookability, 'unavailable_exact_date');
+const registeredHit = await registeredToolSearch('official-train-hit', { kind: 'train', from: '北京', to: '上海', date: '2027-04-12' }, [{ adultPrice: '¥553.0', journeys: [{ journeyType: '直达', segments: [{ depStationName: '北京南', depDateTime: '2027-04-12 08:00:00', arrStationName: '上海虹桥', arrDateTime: '2027-04-12 12:28:00', duration: '268分钟', marketingTransportNo: 'G11', seatClassName: '二等座' }] }], jumpUrl: 'https://example.test/train' }]);
+assert.equal(registeredHit.verdict, 'hit', 'registered official train batch 应返回 hit');
+const factsAfterHit = await loadFactRegistry(registeredStateRoot);
+const typedPositive = factsAfterHit.find((f) => f.kind === 'train' && f.query_id.endsWith(':2027-04-12'));
+assert.ok(typedPositive, 'registered hit 应产生 typed positive fact');
+assert.equal(typedPositive?.bookability, 'bookable_exact_date');
+assert.equal(typedPositive?.flight_no, 'G11');
+await rm(registeredStateRoot, { recursive: true, force: true });
+console.log('1. registered E2E → mixed/all-malformed zero facts / empty miss negative / official train hit positiveOK');
+// 1. Sentinel 限流:合法 JSON 的非业务形状 → error(不是静默 miss)
+const sentinelBin = await fakeCli('flyai-sentinel', 0, '{"message":"SentinelBlockException: flow control"}');
+const s = await flyaiSearch({ ...base, cliBin: sentinelBin, timeoutMs: 5000 });
 assert.equal(s.ok, false, 'Sentinel 形状应 ok=false');
 assert.equal(s.verdict, 'error', `Sentinel 形状应判 error,实际 ${s.verdict}`);
 assert.match(s.error ?? '', /sentinel/i, `error 应保留 sentinel 字样(供上层限流识别),实际 ${s.error}`);
 assert.match(s.evidence, /\[实时API:flyai@error@/, 'error 证据链标注');
 console.log('1. Sentinel 非业务形状 → error(非静默 miss)OK');
+// 2. 业务空形状 → miss(上游正常,确无航班)
 const missBin = await fakeCli('flyai-miss', 0, '{"data":{"itemList":[]}}');
-const m = await flyaiSearch({
-    ...base,
-    cliBin: missBin,
-    timeoutMs: 5000
-});
+const m = await flyaiSearch({ ...base, cliBin: missBin, timeoutMs: 5000 });
 assert.equal(m.ok, true, '业务空形状 ok=true');
 assert.equal(m.verdict, 'miss', `空 itemList 应判 miss,实际 ${m.verdict}`);
 assert.match(m.evidence, /0\/0 flight options/, 'miss 证据链 0/0');
 console.log('2. 业务空形状 → miss(0/0)OK');
+// 3. 非空但全 malformed transport item → registered effect error,不落负事实
+const malformedBin = await fakeCli('flyai-malformed', 0, '{"data":{"itemList":[{}]}}');
+const malformed = await registeredSearch({ ...base, cliBin: malformedBin, timeoutMs: 5000 });
+assert.equal(malformed.ok, false, '全 malformed transport item 不应报告成功');
+assert.equal(malformed.verdict, 'error', '非空全 malformed transport item 应判 error');
+assert.match(malformed.error ?? '', /malformed|valid typed transport/i, 'error 应保留 transport shape 原因');
+assert.match(malformed.evidence, /flyai@error@.*transport itemList/i, 'evidence 应保留结构化 transport 错误');
+assert.deepEqual(factsFromFlyai({ kind: base.kind, origin: base.origin, destination: base.destination, date: base.depDate }, malformed, new Date().toISOString()), [], 'registered path 的 malformed error 不得生成负库存事实');
+console.log('3. 非空全 malformed transport item → registered error,不落负事实OK');
+// 4. flight 有效+malformed sibling → 整体 error,不落负事实
 const hitPayload = JSON.stringify({
     data: {
-        itemList: [
-            {
-                journeys: [
-                    {
-                        segments: [
-                            {
-                                marketingTransportNo: '9C6617',
-                                marketingTransportName: '吉祥航空',
-                                depDateTime: '2026-10-01 07:55',
-                                arrDateTime: '2026-10-01 11:20',
-                                depStationName: '浦东T2',
-                                arrStationName: '丽江三义',
-                                duration: 205
-                            }
-                        ]
-                    }
-                ],
+        itemList: [{
+                journeys: [{
+                        segments: [{
+                                marketingTransportNo: '9C6617', marketingTransportName: '吉祥航空',
+                                depDateTime: '2026-10-01 07:55', arrDateTime: '2026-10-01 11:20',
+                                depStationName: '浦东T2', arrStationName: '丽江三义', duration: 205,
+                            }],
+                    }],
                 ticketPrice: '580',
-                jumpUrl: 'https://www.fliggy.com/demo'
-            }
-        ]
-    }
+                jumpUrl: 'https://www.fliggy.com/demo',
+            }],
+    },
 });
+const mixedBin = await fakeCli('flyai-mixed', 0, JSON.stringify({
+    data: {
+        itemList: [{}, {
+                journeys: [{ segments: [{
+                                marketingTransportNo: 'G201', marketingTransportName: '高铁',
+                                depDateTime: '2026-10-01 09:00', arrDateTime: '2026-10-01 12:00',
+                                depStationName: '上海虹桥', arrStationName: '丽江站', duration: 180,
+                            }] }],
+                ticketPrice: '480',
+            }],
+    },
+}));
+const flightMixed = await registeredSearch({ ...base, cliBin: mixedBin, timeoutMs: 5000 });
+assert.equal(flightMixed.ok, false, 'flight 混合响应不应报告成功');
+assert.equal(flightMixed.verdict, 'error', 'flight 有效+malformed sibling 应整体 error');
+assert.equal(flightMixed.options, undefined, 'flight malformed error 不应暴露 options');
+assert.match(flightMixed.evidence, /transport itemList malformed.*1\/2/i, 'flight error 应暴露 malformed/总条目比例');
+assert.deepEqual(factsFromFlyai({ kind: base.kind, origin: base.origin, destination: base.destination, date: base.depDate }, flightMixed, new Date().toISOString()), [], 'flight mixed error 不得生成负库存事实');
+console.log('4. flight 有效+malformed sibling → 整体 error,不落负事实OK');
+// 5. train 有效+malformed sibling → 整体 error,不落负事实
+const trainMixedBin = await fakeCli('flyai-train-mixed', 0, JSON.stringify({
+    data: {
+        itemList: [{
+                journeys: [{ segments: [{
+                                marketingTransportNo: 'G201', marketingTransportName: '高铁',
+                                depDateTime: '2026-10-01 09:00', arrDateTime: '2026-10-01 12:00',
+                                depStationName: '上海虹桥', arrStationName: '大理站', duration: '180',
+                            }] }],
+                ticketPrice: '480',
+            }, null],
+    },
+}));
+const trainMixed = await registeredSearch({ ...trainBase, cliBin: trainMixedBin, timeoutMs: 5000 });
+assert.equal(trainMixed.ok, false, 'train 混合响应不应报告成功');
+assert.equal(trainMixed.verdict, 'error', 'train 有效+malformed sibling 应整体 error');
+assert.equal(trainMixed.options, undefined, 'train malformed error 不应暴露 options');
+assert.match(trainMixed.evidence, /transport itemList malformed.*1\/2/i, 'train error 应暴露 malformed/总条目比例');
+assert.deepEqual(factsFromFlyai({ kind: trainBase.kind, origin: trainBase.origin, destination: trainBase.destination, date: trainBase.depDate }, trainMixed, new Date().toISOString()), [], 'train mixed error 不得生成负库存事实');
+console.log('5. train 有效+malformed sibling → 整体 error,不落负事实OK');
+// 6. hotel 有效+malformed sibling → 整体 error,不落酒店事实
+const hotelMixedBin = await fakeCli('flyai-hotel-mixed', 0, JSON.stringify({
+    data: {
+        itemList: [{ name: '大理A 酒店', star: '高档型', price: '¥7xx', shId: 'hotel-a' }, { name: null }],
+    },
+}));
+const hotelMixed = await registeredSearch({ ...hotelBase, cliBin: hotelMixedBin, timeoutMs: 5000 });
+assert.equal(hotelMixed.ok, false, 'hotel 混合响应不应报告成功');
+assert.equal(hotelMixed.verdict, 'error', 'hotel 有效+malformed sibling 应整体 error');
+assert.equal(hotelMixed.hotels, undefined, 'hotel malformed error 不应暴露 hotels');
+assert.match(hotelMixed.evidence, /hotel itemList malformed.*1\/2/i, 'hotel error 应暴露 malformed/总条目比例');
+assert.deepEqual(factsFromHotel({ source: 'flyai-hotel', destination: hotelBase.destName, checkIn: hotelBase.checkInDate, checkOut: hotelBase.checkOutDate, verdict: hotelMixed.verdict, options: 0, evidence: hotelMixed.evidence, fetchedAt: new Date().toISOString() }), [], 'hotel mixed error 不得生成酒店事实');
+console.log('6. hotel 有效+malformed sibling → 整体 error,不落酒店事实OK');
+// 7. typed transport/hotel 字段拒绝 truthy 数字与空白
+const typedTransportMalformedBin = await fakeCli('flyai-typed-transport-malformed', 0, JSON.stringify({
+    data: { itemList: [{
+                journeys: [{ segments: [{
+                                marketingTransportNo: 12345, marketingTransportName: '吉祥航空',
+                                depDateTime: '   ', arrDateTime: '2026-10-01 11:20',
+                                depStationName: '浦东T2', arrStationName: '丽江三义', duration: 205,
+                            }] }],
+                ticketPrice: '580',
+            }] },
+}));
+const typedTransportMalformed = await registeredSearch({ ...base, cliBin: typedTransportMalformedBin, timeoutMs: 5000 });
+assert.equal(typedTransportMalformed.verdict, 'error', '数字 transportNo/空白 depDateTime 应判 error');
+assert.equal(typedTransportMalformed.options, undefined, '字段类型 malformed 不应暴露 options');
+const typedHotelMalformedBin = await fakeCli('flyai-typed-hotel-malformed', 0, JSON.stringify({ data: { itemList: [{ name: { value: '酒店' }, price: '¥7xx' }] } }));
+const typedHotelMalformed = await registeredSearch({ ...hotelBase, cliBin: typedHotelMalformedBin, timeoutMs: 5000 });
+assert.equal(typedHotelMalformed.verdict, 'error', '对象 hotel name 应判 error');
+assert.equal(typedHotelMalformed.hotels, undefined, '字段类型 malformed 不应暴露 hotels');
+console.log('7. typed transport/hotel 字段拒绝 truthy 数字、对象与空白OK');
+// 8. official Alibaba shape → adultPrice、带“分钟”时长与 train 缺名称兼容
+const officialFlightBin = await fakeCli('flyai-official-flight', 0, JSON.stringify({
+    data: { itemList: [{
+                adultPrice: '¥400.0',
+                journeys: [{ journeyType: '直达', segments: [{
+                                depStationName: '首都国际机场', depDateTime: '2026-03-28 21:00:00',
+                                arrStationName: '浦东国际机场', arrDateTime: '2026-03-28 23:20:00',
+                                duration: '140分钟', marketingTransportName: '国航', marketingTransportNo: 'CA1883', seatClassName: '经济舱',
+                            }] }],
+                jumpUrl: 'https://example.test/flight',
+            }] },
+}));
+const officialFlight = await registeredSearch({ ...base, cliBin: officialFlightBin, timeoutMs: 5000 });
+assert.equal(officialFlight.verdict, 'hit', 'official flight shape 应保持 hit');
+assert.equal(officialFlight.options?.[0]?.price, 400, 'official adultPrice 应解析为 400');
+assert.equal(officialFlight.options?.[0]?.durationMin, 140, 'official 中文分钟时长应解析为 140');
+const officialTrainBin = await fakeCli('flyai-official-train', 0, JSON.stringify({
+    data: { itemList: [{
+                adultPrice: '¥553.0',
+                journeys: [{ journeyType: '直达', segments: [{
+                                depStationName: '北京南', depDateTime: '2026-03-15 08:00:00',
+                                arrStationName: '上海虹桥', arrDateTime: '2026-03-15 12:28:00',
+                                duration: '268分钟', marketingTransportNo: 'G11', seatClassName: '二等座',
+                            }] }],
+                jumpUrl: 'https://example.test/train',
+            }] },
+}));
+const officialTrain = await registeredSearch({ ...trainBase, cliBin: officialTrainBin, timeoutMs: 5000 });
+assert.equal(officialTrain.verdict, 'hit', 'official train shape 应保持 hit');
+assert.equal(officialTrain.options?.[0]?.price, 553, 'official train adultPrice 应解析为 553');
+assert.equal(officialTrain.options?.[0]?.durationMin, 268, 'official train 中文分钟时长应解析为 268');
+assert.equal(officialTrain.options?.[0]?.name, '', '缺 marketingTransportName 不猜名称且保留空字符串');
+console.log('8. official flight/train shape → adultPrice/分钟时长/缺名称兼容OK');
+// 9. official typed fields:invalid price/duration/name type → structured error
+const invalidPriceBin = await fakeCli('flyai-invalid-price', 0, JSON.stringify({
+    data: { itemList: [{
+                adultPrice: 'not-a-price',
+                journeys: [{ segments: [{
+                                marketingTransportNo: 'CA1883', marketingTransportName: '国航',
+                                depDateTime: '2026-03-28 21:00:00', arrDateTime: '2026-03-28 23:20:00',
+                                depStationName: '首都国际机场', arrStationName: '浦东国际机场', duration: '140分钟',
+                            }] }],
+            }] },
+}));
+const invalidPrice = await registeredSearch({ ...base, cliBin: invalidPriceBin, timeoutMs: 5000 });
+assert.equal(invalidPrice.verdict, 'error', '非法文本价格应判 error');
+const invalidDurationBin = await fakeCli('flyai-invalid-duration', 0, JSON.stringify({
+    data: { itemList: [{
+                adultPrice: '¥400.0',
+                journeys: [{ segments: [{
+                                marketingTransportNo: 'CA1883', marketingTransportName: '国航',
+                                depDateTime: '2026-03-28 21:00:00', arrDateTime: '2026-03-28 23:20:00',
+                                depStationName: '首都国际机场', arrStationName: '浦东国际机场', duration: { value: 140 },
+                            }] }],
+            }] },
+}));
+const invalidDuration = await registeredSearch({ ...base, cliBin: invalidDurationBin, timeoutMs: 5000 });
+assert.equal(invalidDuration.verdict, 'error', '对象时长应判 error');
+const invalidNameBin = await fakeCli('flyai-invalid-name', 0, JSON.stringify({
+    data: { itemList: [{
+                adultPrice: '¥553.0',
+                journeys: [{ segments: [{
+                                depStationName: '北京南', depDateTime: '2026-03-15 08:00:00',
+                                arrStationName: '上海虹桥', arrDateTime: '2026-03-15 12:28:00',
+                                duration: '268分钟', marketingTransportNo: 'G11', marketingTransportName: 123,
+                            }] }],
+            }] },
+}));
+const invalidName = await registeredSearch({ ...trainBase, cliBin: invalidNameBin, timeoutMs: 5000 });
+assert.equal(invalidName.verdict, 'error', '数字 marketingTransportName 应判 error');
+console.log('9. official typed 字段非法 price/duration/name → errorOK');
+// 10. 完整合法 flight → hit,字段解析
 const hitBin = await fakeCli('flyai-hit', 0, hitPayload);
-const h = await flyaiSearch({
-    ...base,
-    cliBin: hitBin,
-    timeoutMs: 5000
-});
-assert.equal(h.verdict, 'hit', `业务条目应判 hit,实际 ${h.verdict}`);
+const h = await flyaiSearch({ ...base, cliBin: hitBin, timeoutMs: 5000 });
+assert.equal(h.ok, true, '完整合法 flight ok=true');
+assert.equal(h.verdict, 'hit', `完整合法 flight 应判 hit,实际 ${h.verdict}`);
 assert.equal(h.options?.length, 1, '1 个选项');
 assert.equal(h.options[0].no, '9C6617');
 assert.equal(h.options[0].price, 580, '价格数值解析');
 assert.equal(h.options[0].depStation, '浦东T2');
 assert.match(h.evidence, /1\/1 flight options/, 'hit 证据链 1/1');
-console.log('3. 业务命中 → hit(9C6617 ¥580)OK');
+console.log('10. 完整合法 flight → hit(9C6617 ¥580)OK');
+// 11. 完整合法 train → hit,共享 transport typed 合同
+const trainHitBin = await fakeCli('flyai-train-hit', 0, JSON.stringify({
+    data: {
+        itemList: [{
+                journeys: [{ segments: [{
+                                marketingTransportNo: 'G201', marketingTransportName: '高铁',
+                                depDateTime: '2026-10-01 09:00', arrDateTime: '2026-10-01 12:00',
+                                depStationName: '上海虹桥', arrStationName: '大理站', duration: '180', seatClassName: '二等座',
+                            }] }],
+                ticketPrice: '480',
+            }],
+    },
+}));
+const trainHit = await flyaiSearch({ ...trainBase, cliBin: trainHitBin, timeoutMs: 5000 });
+assert.equal(trainHit.ok, true, '完整合法 train ok=true');
+assert.equal(trainHit.verdict, 'hit', '完整合法 train 应判 hit');
+assert.equal(trainHit.options?.length, 1, '完整合法 train 产出 1 个选项');
+assert.equal(trainHit.options?.[0]?.no, 'G201');
+console.log('11. 完整合法 train → hit(G201)OK');
+// 12. 完整合法 hotel → hit,保持酒店语义
+const hotelHitBin = await fakeCli('flyai-hotel-hit', 0, JSON.stringify({ data: { itemList: [{ name: '大理A 酒店', star: '高档型', price: '¥7xx', rate: null, address: 'addr', interestsPoi: '近洱海', shId: 'hotel-a', detailUrl: 'https://example.test/hotel-a' }] } }));
+const hotelHit = await flyaiSearch({ ...hotelBase, cliBin: hotelHitBin, timeoutMs: 5000 });
+assert.equal(hotelHit.ok, true, '完整合法 hotel ok=true');
+assert.equal(hotelHit.verdict, 'hit', '完整合法 hotel 应判 hit');
+assert.equal(hotelHit.hotels?.length, 1, '1 个酒店选项');
+assert.equal(hotelHit.hotels?.[0]?.name, '大理A 酒店');
+assert.equal(hotelHit.hotels?.[0]?.priceRaw, '¥7xx', '酒店打码价原值保留');
+console.log('12. 完整合法 hotel → hit(打码价保真)OK');
+// 13. exit≠0 → error
 const failBin = await fakeCli('flyai-fail', 1, '');
-const f = await flyaiSearch({
-    ...base,
-    cliBin: failBin,
-    timeoutMs: 5000
-});
+const f = await flyaiSearch({ ...base, cliBin: failBin, timeoutMs: 5000 });
 assert.equal(f.ok, false);
 assert.equal(f.verdict, 'error', '非零退出应判 error');
-console.log('4. 非零退出 → error OK');
+console.log('13. 非零退出 → error OK');
+// 14. 试用额度达限(2026-09-02 迪拜 session 实况:exit 1 + MCP HTTP 429 Trial limit
+//    reached)→ needs-setup 而非通用 error——阻断 LLM 拿同一把 429 跨轮盲重试
 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
-});
+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 配置路径');
@@ -101,11 +364,5 @@ 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: 5/5 OK(离线假 CLI:Sentinel→error / 空 itemList→miss / 命中→hit / exit≠0→error / 429 达限→needs-setup)');
-
-
-//# sourceURL=ts/scripts/flyai-tests.ts
+await rm(tmp, { recursive: true, force: true });
+console.log('FLYAI TESTS: transport/hotel completeness contract OK(离线假 CLI:Sentinel→error / 空 itemList→miss / flight+train+hotel mixed→整体 error 且不落事实 / typed 字段校验 / 完整 flight+train+hotel→hit / exit≠0→error / 429→needs-setup)');

package/dist/scripts/g5-guard-tests.js

@@ -0,0 +1,131 @@
+/**
+ * G5 机械闸自测(issue #348;全离线,零网络,零共享 state 写入)。
+ *
+ * 覆盖:
+ *  1. (17) pattern 命中/不命中双向——真桥接形状(G5_BRIDGE/g5Bridge/
+ *     capability-travel-mcp/t-system bridge/G5桥)必须命中;承运人代码
+ *     G5/G52667、persona-bench 案例 G5、base64 噪声、「提到 G5 门」的
+ *     门定义句必须不命中(误报会把 tracker 自身打红);
+ *  2. (7) 台账解析——GRANT 缺 issue/决策链接 → 拒收(fail closed);
+ *     code fence 内模板行不计入;glob 语义(** 跨段 / * 单段);覆盖判定;
+ *  3. (2) 命名面豁免存在(master-outline 对 + 台账/guard 对);
+ *  4. (4) CLI 端到端(临时 git fixture,--root 注入):未授权引用 → exit 1
+ *     且输出可操作指引;GRANT 覆盖后 → exit 0;干净仓 → exit 0;
+ *     台账缺失 → exit 2(闸自身不可用,而非放行)。
+ *
+ * 运行:cd ts && npx tsx scripts/g5-guard-tests.ts
+ */
+import assert from 'node:assert/strict';
+import { spawnSync } from 'node:child_process';
+import { mkdtempSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { globToRegExp, grantCovers, parseGrants, scanContent, NAMING_SURFACES } from './g5-guard.js';
+let assertions = 0;
+function ok(value, message) {
+    assert.ok(value, message);
+    assertions += 1;
+}
+// ── 1. pattern 命中/不命中双向 ──────────────────────────────────────────────
+const mustHit = [
+    ['env key', 'G5_BRIDGE_ENDPOINT=https://internal.example'],
+    ['camelCase identifier', 'const g5Bridge = createBridge()'],
+    ['hyphen path', 'see ts/src/adapters/g5-bridge/client.ts'],
+    ['internal MCP plugin id', 'registerPlugin("capability-travel-mcp")'],
+    ['t-system bridge', 't-system bridge adapter for flights'],
+    ['bridge adjacent t-system', 'BridgeTSystem flights'],
+    ['chinese adjacency', '启用 G5 桥'],
+    ['chinese bridge g5', '桥 G5 工具'],
+    ['chinese t-system prefix', '桥接 T 系统 的机票工具'],
+    ['chinese t-system suffix', 'T 系统适配层'],
+];
+for (const [label, text] of mustHit) {
+    ok(scanContent('fixture.ts', text).length === 1, `pattern 应命中: ${label} (${text})`);
+}
+const mustNotHit = [
+    ['carrier code', '{ "carrier_codes": ["CA", "CZ", "G5", "GS"] }'],
+    ['flight number', '"known_flights": ["G52667", "CZ5817"]'],
+    ['persona-bench case id', '| G5 | 万xx 指代 | = 甲米 |'],
+    ['gate mention without bridge adjacency', 'constrained by G5); ② reference'],
+    ['gate row phrase', 'G5 (internal travel bridge approval)'],
+    ['base64-ish noise', '"integrity": "sha512-mQ+/0Fo3LTIX+4k3m+P4y9e9IA6/BeNHrWW19U+G5x0Z8BlybHDELZIB=="'],
+    ['zh gate row phrase', '内部差旅工具桥（T 系统侧，脱敏）的内部审批'],
+];
+for (const [label, text] of mustNotHit) {
+    ok(scanContent('fixture.ts', text).length === 0, `pattern 不应命中(误报): ${label} (${text})`);
+}
+// ── 2. 台账解析 + glob 语义 ────────────────────────────────────────────────
+const empty = parseGrants('# G5 Authorization Ledger\n\n(empty)\n');
+ok(empty.grants.length === 0 && empty.malformed === 0, '空台账应解析为 0 授权');
+const noLink = parseGrants('- GRANT: src/** — some bridge\n');
+ok(noLink.grants.length === 0 && noLink.malformed === 1, '缺 issue/决策链接的 GRANT 应被拒收(fail closed)');
+const ledger = parseGrants([
+    '# ledger',
+    '- GRANT: src/adapters/** — masked flight reads, tenant X — issue: #348',
+    '- GRANT: docs/notes.md — demo — decision: https://example/decision',
+].join('\n'));
+ok(ledger.grants.length === 2 && ledger.malformed === 0, '带 issue/决策链接的 GRANT 应成立');
+ok(grantCovers(ledger.grants[0], 'src/adapters/flight/client.ts'), '`**` 应跨段覆盖');
+ok(!grantCovers(ledger.grants[0], 'docs/notes.md'), '不匹配的路径不应被覆盖');
+const withTemplate = parseGrants([
+    '# ledger',
+    '```',
+    '- GRANT: <path-glob> — system/purpose/scope one-liner — issue/decision: #<n> or URL',
+    '```',
+    '- GRANT: src/** — real entry — issue: #348',
+].join('\n'));
+ok(withTemplate.grants.length === 1 && withTemplate.malformed === 0, 'code fence 内的模板行不应计入 GRANT/畸形');
+const single = globToRegExp('docs/*.md');
+ok(single.test('docs/a.md') && !single.test('docs/sub/b.md'), '`*` 应限单段');
+// ── 3. 命名面豁免 ──────────────────────────────────────────────────────────
+ok(NAMING_SURFACES.has('docs/gotry-master-outline.md') && NAMING_SURFACES.has('docs/gotry-master-outline.zh-CN.md'), '门定义对必须在命名面');
+ok(NAMING_SURFACES.has('docs/g5-authorization-ledger.md') && NAMING_SURFACES.has('ts/scripts/g5-guard.ts'), '台账与 guard 自身必须在命名面');
+// ── 4. CLI 端到端(临时 git fixture) ───────────────────────────────────────
+const tsRoot = join(import.meta.dirname, '..');
+const guardScript = join(tsRoot, 'scripts', 'g5-guard.ts');
+const tsxBin = join(tsRoot, 'node_modules', '.bin', 'tsx');
+function makeFixture(files) {
+    const root = mkdtempSync(join(tmpdir(), 'g5-guard-fixture-'));
+    for (const [rel, content] of Object.entries(files)) {
+        const abs = join(root, rel);
+        mkdirSync(join(abs, '..'), { recursive: true });
+        writeFileSync(abs, content);
+    }
+    spawnSync('git', ['init', '-q'], { cwd: root });
+    spawnSync('git', ['add', '-A'], { cwd: root });
+    return root;
+}
+function runGuard(root) {
+    const result = spawnSync(tsxBin, [guardScript, '--root', root], { encoding: 'utf8' });
+    return { status: result.status ?? -1, stdout: result.stdout ?? '', stderr: result.stderr ?? '' };
+}
+const LEDGER_HEADER = [
+    '# G5 Authorization Ledger',
+    '',
+    '## Entries',
+    '',
+    '(empty)',
+    '',
+].join('\n');
+// 红:未授权桥接引用 → exit 1 + 可操作指引
+const redRoot = makeFixture({
+    'src/adapter.ts': 'export const endpoint = process.env.G5_BRIDGE_ENDPOINT\n',
+    'docs/README.md': 'docs index\n',
+    'docs/g5-authorization-ledger.md': LEDGER_HEADER,
+});
+const red = runGuard(redRoot);
+ok(red.status === 1 && red.stderr.includes('src/adapter.ts') && red.stderr.includes('issues/348'), `未授权引用应 exit 1 且给出路径与 #348 指引(status=${red.status}, stderr=${red.stderr.slice(0, 200)})`);
+// 绿:创始人侧 GRANT 覆盖后 → exit 0(fixture 内的 GRANT 仅演示解析,非真实授权)
+writeFileSync(join(redRoot, 'docs', 'g5-authorization-ledger.md'), LEDGER_HEADER + '- GRANT: src/** — fixture demo only, not a real grant — issue: #348\n');
+const green = runGuard(redRoot);
+ok(green.status === 0, `GRANT 覆盖后应 exit 0(status=${green.status}, stderr=${green.stderr.slice(0, 200)})`);
+rmSync(redRoot, { recursive: true, force: true });
+// 绿:干净仓(无任何引用)→ exit 0
+const cleanRoot = makeFixture({ 'src/adapter.ts': 'export const endpoint = "https://api.hotelbyte.example"\n', 'docs/g5-authorization-ledger.md': LEDGER_HEADER });
+ok(runGuard(cleanRoot).status === 0, '干净仓应 exit 0');
+rmSync(cleanRoot, { recursive: true, force: true });
+// exit 2:台账缺失 → 闸不可用,而不是放行
+const noLedgerRoot = makeFixture({ 'src/adapter.ts': 'export const x = 1\n' });
+ok(runGuard(noLedgerRoot).status === 2, '台账缺失应 exit 2(闸配置错误),不得放行');
+rmSync(noLedgerRoot, { recursive: true, force: true });
+console.log(`G5 GUARD TESTS: ${assertions}/${assertions} OK(命中/不命中双向 / 台账 fail-closed+glob / 命名面 / CLI 红绿+exit2)`);