@danceiny/gotry 0.0.1-rc.14 → 0.0.1-rc.16

package/dist/scripts/effect-tests.js

@@ -0,0 +1,474 @@
+import assert from 'node:assert/strict';
+import { mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { backoffDelayMs, CircuitBreaker, withRetry } from '../capabilities/resilience.js';
+import { declinedObservation, makeMockInterpreter, makeProductionInterpreter, __resetEffectBreakersForTest } from '../capabilities/effect.js';
+const sleep0 = async ()=>{};
+let clock = 1_000_000;
+const now = ()=>clock;
+const interp = makeProductionInterpreter({
+    sleep: sleep0,
+    now
+});
+const badItp = await interp({
+    effect: 'CTRIP_DIRECT_QUERY',
+    params: {}
+});
+assert.equal(badItp.result, null, '未登记效应 result=null');
+assert.equal(badItp.trace.declined, 'unknown-effect');
+assert.equal(badItp.trace.attempts, 0, '未登记效应零执行');
+const badObs = declinedObservation('CTRIP_DIRECT_QUERY', badItp.trace);
+assert.equal(badObs.ok, false);
+assert.match(badObs.summary, /未登记效应/, '拒绝面人话 summary');
+assert.match(badObs.evidence, /\[效应:CTRIP_DIRECT_QUERY@/, '拒绝面带证据链');
+console.log('1. 注册表封闭性:未登记效应 → 结构化拒绝面(不抛错)OK');
+assert.equal(backoffDelayMs({
+    baseDelayMs: 500,
+    maxDelayMs: 8000
+}, 1), 500);
+assert.equal(backoffDelayMs({
+    baseDelayMs: 500,
+    maxDelayMs: 8000
+}, 2), 1000);
+assert.equal(backoffDelayMs({
+    baseDelayMs: 500,
+    maxDelayMs: 8000
+}, 4), 4000);
+assert.equal(backoffDelayMs({
+    baseDelayMs: 500,
+    maxDelayMs: 2000
+}, 6), 2000, '封顶');
+const retried = [];
+const rt = await withRetry(async ()=>({
+        ok: false
+    }), {
+    maxAttempts: 4,
+    baseDelayMs: 500,
+    maxDelayMs: 2000,
+    isRetryable: ()=>true,
+    sleep: sleep0
+}, (_failN, delayMs)=>retried.push(delayMs));
+assert.deepEqual(retried, [
+    500,
+    1000,
+    2000
+], '退避序列 500/1000/2000');
+assert.equal(rt.attempts, 4, '重试到上限');
+assert.equal(rt.backoffMs, 3500, '累计回退记账');
+const noRetry = await withRetry(async ()=>({
+        ok: false,
+        verdict: 'error',
+        error: '{"message":"SentinelBlockException"}'
+    }), {
+    maxAttempts: 3,
+    baseDelayMs: 500,
+    maxDelayMs: 2000,
+    isRetryable: ()=>false,
+    sleep: sleep0
+});
+assert.equal(noRetry.attempts, 1, '瞬时判定说不重试就 1 次');
+console.log('2. 指数退避(封顶链/累计记账/非瞬时止步)OK');
+const br = new CircuitBreaker({
+    failureThreshold: 2,
+    openMs: 60_000,
+    now
+});
+assert.equal(br.canAttempt().state, 'closed');
+br.onFailure();
+br.onFailure();
+assert.equal(br.state(), 'open', '连续 2 失败 → open');
+assert.equal(br.canAttempt().allowed, false, 'open 中拒绝');
+clock += 61_000;
+assert.equal(br.state(), 'half-open', '冷却满 → half-open');
+const gate = br.canAttempt();
+assert.equal(gate.allowed, true, 'half-open 放行单探测');
+assert.equal(br.canAttempt().allowed, false, '探测在途拒并发');
+br.onSuccess();
+assert.equal(br.state(), 'closed', '探测成功 → closed');
+br.onFailure();
+br.onFailure();
+clock += 61_000;
+assert.equal(br.state(), 'half-open');
+assert.equal(br.canAttempt().allowed, true);
+br.onFailure();
+assert.equal(br.state(), 'open', '探测失败 → 重新 open(冷却重启)');
+console.log('3. 断路器三态(closed→open→half-open 单探测→双向收敛)OK');
+let flaky = 0;
+const ip = makeProductionInterpreter({
+    sleep: sleep0,
+    breakers: new Map(),
+    handlers: {
+        WEATHER_FORECAST: async ()=>{
+            flaky += 1;
+            return flaky < 2 ? {
+                ok: false,
+                via: 'open-meteo-error',
+                evidence: '[实时API:open-meteo@error]',
+                latencyMs: 1,
+                error: 'socket hang up'
+            } : {
+                ok: true,
+                via: 'open-meteo',
+                evidence: '[实时API:open-meteo@ts]',
+                latencyMs: 2,
+                daily: []
+            };
+        }
+    }
+});
+const itp4 = await ip({
+    effect: 'WEATHER_FORECAST',
+    params: {
+        latitude: 25.6,
+        longitude: 100.2
+    }
+});
+assert.equal(itp4.trace.attempts, 2, '瞬时失败重试第 2 次成功(免费源上限 2)');
+assert.equal(itp4.trace.backoffMs, 400, '回退按 API 策略记账');
+assert.ok(itp4.result.ok, '成功 observation 原样透传');
+assert.match(itp4.trace.evidence[0] ?? '', /attempts=2 backoff=400ms breaker=closed/, 'trace 证据行');
+console.log('4. 生产解译器×瞬时失败:重试后成功 + trace 记账 OK');
+const sentinelResult = {
+    ok: false,
+    via: 'flyai-error',
+    verdict: 'error',
+    kind: 'flight',
+    latencyMs: 5,
+    evidence: '[实时API:flyai@error@ts] parse failed(SentinelBlockException)',
+    error: 'failed to parse flyai output as JSON (incomplete FlyAI JSON object): {"message":"SentinelBlockException"}'
+};
+let sentinelCalls = 0;
+const flyaiBreakers = new Map();
+const ipS = makeProductionInterpreter({
+    sleep: sleep0,
+    breakers: flyaiBreakers,
+    now,
+    handlers: {
+        FLYAI_SEARCH: async ()=>{
+            sentinelCalls += 1;
+            return structuredClone(sentinelResult);
+        }
+    }
+});
+const q = {
+    kind: 'flight',
+    origin: '上海',
+    destination: '丽江',
+    depDate: '2026-10-01'
+};
+await ipS({
+    effect: 'FLYAI_SEARCH',
+    params: q
+});
+await ipS({
+    effect: 'FLYAI_SEARCH',
+    params: q
+});
+assert.equal(sentinelCalls, 2, '每次调用只打一次上游(Sentinel 不重试)');
+const itp3 = await ipS({
+    effect: 'FLYAI_SEARCH',
+    params: q
+});
+assert.equal(itp3.trace.attempts, 1);
+assert.equal(itp3.trace.breaker, 'open', '连续 3 次失败(FlyAI 阈值 3)→ 断路器开启');
+assert.equal(sentinelCalls, 3);
+const itp4th = await ipS({
+    effect: 'FLYAI_SEARCH',
+    params: q
+});
+assert.equal(itp4th.trace.declined, 'circuit-open', '第 4 次:熔断中零执行成本拒绝');
+assert.equal(itp4th.result, null);
+assert.equal(sentinelCalls, 3, '熔断后不再打上游');
+console.log('5. FlyAI×Sentinel:永不重试 + 连环失败触发熔断保护配额 OK');
+const declined = declinedObservation('FLYAI_SEARCH', itp4th.trace);
+assert.equal(declined.ok, false);
+assert.match(declined.summary, /断路器开启/, '拒绝面指引「不要立即重试」,不伪装成 miss');
+clock += 120_000;
+const ipOk = makeProductionInterpreter({
+    sleep: sleep0,
+    breakers: flyaiBreakers,
+    now,
+    handlers: {
+        FLYAI_SEARCH: async ()=>({
+                ok: true,
+                via: 'flyai',
+                verdict: 'hit',
+                kind: 'flight',
+                latencyMs: 1,
+                evidence: 'e',
+                options: []
+            })
+    }
+});
+const itp6 = await ipOk({
+    effect: 'FLYAI_SEARCH',
+    params: {
+        kind: 'flight'
+    }
+});
+assert.equal(itp6.trace.breaker, 'closed', 'half-open 单探测成功 → closed 恢复');
+assert.ok(itp6.result != null && !itp6.trace.declined);
+console.log('6. 断路拒绝面(结构化/零执行)+ 冷却后单探测恢复 closed OK');
+const mock = makeMockInterpreter({
+    FLYAI_SEARCH: {
+        ok: true,
+        via: 'flyai',
+        verdict: 'hit',
+        kind: 'flight',
+        latencyMs: 0,
+        evidence: '[实时API:flyai@2026-08-29T00:00:00Z] 2/2 flight options',
+        options: [
+            {
+                no: '9C6617',
+                name: '吉祥航空',
+                depDateTime: '2026-10-01 07:55',
+                arrDateTime: '2026-10-01 11:20',
+                depStation: '浦东T2',
+                arrStation: '丽江三义',
+                durationMin: 205,
+                price: 580
+            }
+        ]
+    }
+});
+const mockFx = {
+    effect: 'FLYAI_SEARCH',
+    params: {
+        kind: 'flight',
+        origin: '上海',
+        destination: '丽江',
+        depDate: '2026-10-01'
+    }
+};
+const mockA = await mock(mockFx);
+const mockB = await mock(mockFx);
+assert.deepEqual(mockA.result, mockB.result, '同一夹具两次回放同值');
+assert.equal(mockA.result.verdict, 'hit');
+assert.match(mockA.trace.evidence[0] ?? '', /\[效应:mock@.*夹具回放/, 'mock trace 标注');
+const mockMiss = await mock({
+    effect: 'WEATHER_FORECAST',
+    params: {}
+});
+assert.equal(mockMiss.trace.declined, 'unknown-effect', 'mock 未登记夹具 = 拒绝面');
+console.log('7. mock 解译器(夹具回放/未登记拒绝/确定性)OK');
+let sessionCalls = 0;
+const ipSess = makeProductionInterpreter({
+    sleep: sleep0,
+    breakers: new Map(),
+    handlers: {
+        SESSION_FLIGHT_SEARCH: async ()=>{
+            sessionCalls += 1;
+            return {
+                ok: false,
+                via: 'session-ctrip-flight-error',
+                verdict: 'challenged',
+                evidence: '[会话:ctrip-flight@error@ts] 风控命中',
+                latencyMs: 9,
+                error: 'challenge'
+            };
+        }
+    }
+});
+const sessQ = {
+    from: '上海',
+    to: '丽江',
+    date: '2026-10-01'
+};
+const itp8 = await ipSess({
+    effect: 'SESSION_FLIGHT_SEARCH',
+    params: sessQ
+});
+assert.equal(itp8.result.verdict, 'challenged', '渠道 verdict 原样透传');
+assert.equal(itp8.trace.attempts, 1, 'SESSION 永不重试(挑战=红线)');
+assert.equal(itp8.trace.breaker, 'off', 'SESSION 不参与断路器');
+for(let i = 0; i < 5; i++)await ipSess({
+    effect: 'SESSION_FLIGHT_SEARCH',
+    params: sessQ
+});
+const itp8z = await ipSess({
+    effect: 'SESSION_FLIGHT_SEARCH',
+    params: sessQ
+});
+assert.ok(itp8z.trace.breaker === 'off' && !itp8z.trace.declined, 'SESSION 无断路拒绝(治理在节律闸与授权闸)');
+assert.equal(sessionCalls, 7);
+console.log('8. SESSION 通道策略(永不重试/不熔断/verdict 透传)OK');
+__resetEffectBreakersForTest();
+const tmp = await mkdtemp(join(tmpdir(), 'effect-test-'));
+const itp9 = await interp({
+    effect: 'HBCLI_HOTEL_SEARCH',
+    params: {
+        destination: '大理',
+        hbcliBin: join(tmp, 'no-such-hbcli'),
+        fallbackPath: join(import.meta.dirname, '..', '..', 'data', 'hotels_2026.json')
+    }
+});
+const hb9 = itp9.result;
+assert.ok(hb9 != null, '真实 handler 降级仍返回 observation');
+assert.ok(typeof hb9.summary === 'string' && hb9.summary.length > 0, '降级带人话 summary');
+assert.ok(itp9.trace.evidence[0]?.startsWith('[效应:HBCLI_HOTEL_SEARCH@'), '解译层证据行');
+await rm(tmp, {
+    recursive: true,
+    force: true
+});
+console.log(`9. 真实 handler 离线冒烟(HBCLI 静态包降级,summary=${(hb9.summary ?? '').slice(0, 40)}…)OK`);
+let ratesDispatches = 0;
+const ipM0 = makeProductionInterpreter({
+    sleep: sleep0,
+    breakers: new Map(),
+    handlers: {
+        HBCLI_HOTEL_RATES: async ()=>{
+            ratesDispatches += 1;
+            return {
+                via: 'hbcli-realtime',
+                exitCode: 0,
+                result: {
+                    rooms: []
+                },
+                evidence: '[实时API:hbcli@ts]',
+                latencyMs: 1,
+                rates: {
+                    rooms: []
+                },
+                summary: 'ok'
+            };
+        },
+        HBCLI_CHECK_AVAIL: async ()=>({
+                via: 'hbcli-error',
+                exitCode: 1,
+                result: null,
+                evidence: '[实时API:hbcli@error@ts]',
+                latencyMs: 1,
+                error: 'boom',
+                avail: null,
+                summary: 'err'
+            })
+    }
+});
+const itp10 = await ipM0({
+    effect: 'HBCLI_HOTEL_RATES',
+    params: {
+        hotelId: '900000001',
+        checkIn: '2026-09-05',
+        checkOut: '2026-09-07',
+        adults: 2
+    }
+});
+assert.equal(itp10.trace.attempts, 1, 'RATES 永不重试(候选路径切换不是重试)');
+assert.ok(itp10.result != null && !itp10.trace.declined, 'RATES 命中注入 handler,observation 透传');
+assert.ok(itp10.trace.evidence[0]?.startsWith('[效应:HBCLI_HOTEL_RATES@'), '解译层证据行');
+const itp10b = await ipM0({
+    effect: 'HBCLI_CHECK_AVAIL',
+    params: {
+        ratePkgId: 'rp-1'
+    }
+});
+assert.equal(itp10b.result?.via, 'hbcli-error', '渠道失败观察原样透传(平铺失败面,isFailure 计熔断)');
+await ipM0({
+    effect: 'HBCLI_CHECK_AVAIL',
+    params: {
+        ratePkgId: 'rp-2'
+    }
+});
+await ipM0({
+    effect: 'HBCLI_CHECK_AVAIL',
+    params: {
+        ratePkgId: 'rp-3'
+    }
+});
+const itp10c = await ipM0({
+    effect: 'HBCLI_CHECK_AVAIL',
+    params: {
+        ratePkgId: 'rp-4'
+    }
+});
+assert.equal(itp10c.trace.declined, 'circuit-open', '3 连错熔断保护(同 HBCLI 族策略)');
+assert.equal(ratesDispatches, 1, '成功通道不受失败通道熔断影响(per-effect 隔离)');
+console.log('10a. 预订链读效应注册(派发/永不重试/熔断族/per-effect 隔离)OK');
+__resetEffectBreakersForTest();
+const tmp10 = await mkdtemp(join(tmpdir(), 'effect-m0-'));
+const itp10d = await interp({
+    effect: 'HBCLI_HOTEL_RATES',
+    params: {
+        hotelId: '900000001',
+        hbcliBin: join(tmp10, 'no-such-hbcli')
+    }
+});
+const hr10 = itp10d.result;
+assert.ok(hr10 != null, '不可达仍返回 observation(永不抛错)');
+assert.equal(hr10.via, 'hbcli-error', '未伪装成功');
+assert.match(hr10.summary ?? '', /不可用/, 'summary 明示不可用');
+assert.ok(!/静态包/.test(hr10.summary ?? '') || /无静态降级/.test(hr10.summary ?? ''), '价格面不降级到静态包');
+const itp10e = await interp({
+    effect: 'HBCLI_CHECK_AVAIL',
+    params: {
+        ratePkgId: 'rp-x',
+        hbcliBin: join(tmp10, 'no-such-hbcli')
+    }
+});
+assert.equal(itp10e.result?.via, 'hbcli-error', 'check-avail 同口径诚实失败');
+await rm(tmp10, {
+    recursive: true,
+    force: true
+});
+console.log('10b. 真实 handler 离线冒烟(价格面 fail-closed,无静态降级)OK');
+const mock10 = makeMockInterpreter({
+    HBCLI_HOTEL_RATES: {
+        via: 'hbcli-realtime',
+        exitCode: 0,
+        result: {
+            rooms: [
+                {
+                    ratePkgId: 'rp-fx-1',
+                    roomTypeName: 'Deluxe King'
+                }
+            ]
+        },
+        evidence: '[实时API:hbcli@2026-08-30T00:00:00Z]',
+        latencyMs: 1800,
+        rates: {
+            rooms: [
+                {
+                    ratePkgId: 'rp-fx-1',
+                    roomTypeName: 'Deluxe King'
+                }
+            ]
+        },
+        summary: 'hotel 900000001:hbcli 实时报价(2026-09-05 → 2026-09-07)'
+    },
+    HBCLI_CHECK_AVAIL: {
+        via: 'hbcli-realtime',
+        exitCode: 0,
+        result: {
+            ratePkgId: 'rp-fx-1',
+            avail: true
+        },
+        evidence: '[实时API:hbcli@2026-08-30T00:00:01Z]',
+        latencyMs: 900,
+        avail: {
+            ratePkgId: 'rp-fx-1',
+            avail: true
+        },
+        summary: 'ratePkg rp-fx-1:hbcli 实时验价(库存与价格以后端为准)'
+    }
+});
+const m10a = await mock10({
+    effect: 'HBCLI_HOTEL_RATES',
+    params: {
+        hotelId: '900000001'
+    }
+});
+const m10b = await mock10({
+    effect: 'HBCLI_CHECK_AVAIL',
+    params: {
+        ratePkgId: 'rp-fx-1'
+    }
+});
+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 预订链读效应,纯离线)');
+
+
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/scripts/effect-tests.ts

package/dist/scripts/engine-run.js

@@ -11,4 +11,4 @@ console.log(`(TS 引擎总耗时含 WASM init: ${Date.now() - t0}ms, recommended
 console.log(result['answer_md']);
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/scripts/engine-run.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/scripts/engine-run.ts

package/dist/scripts/engine-tests.js

@@ -42,4 +42,4 @@ assert.ok(v.suggestions.some((s)=>s.text.includes('预算提高到')));
 console.log('TS ENGINE TESTS: 8/8 OK');
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/scripts/engine-tests.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/scripts/engine-tests.ts