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

package/dist/scripts/smoke.js

@@ -45,10 +45,10 @@ async function main() {
             }
         }
     }, null);
-    if (rejectedMotivation.ok !== false || !rejectedMotivation.summary?.includes('without evidence')) {
-        throw new Error(`FAIL: profile without evidence should have been rejected, actual ${JSON.stringify(rejectedMotivation).slice(0, 120)}`);
+    if (rejectedMotivation.ok !== false || !/evidence/i.test(rejectedMotivation.summary ?? '')) {
+        throw new Error(`FAIL: profile without evidence should have been rejected, actual ${JSON.stringify(rejectedMotivation).slice(0, 160)}`);
     }
-    console.log(`motivation without evidence rejected: ${rejectedMotivation.summary.slice(0, 80)}...`);
+    console.log(`motivation without evidence rejected: ${(rejectedMotivation.summary ?? '').slice(0, 80)}...`);
     const saved = await motivation.execute({
         profile: {
             weights: {
@@ -112,11 +112,9 @@ async function main() {
     }
     const ar = byName('gotry_agent_reach');
     const arView = ar.presentResult({
-        query: {
-            action: 'reach',
-            channel: 'v2ex',
-            method: 'get_hot_topics'
-        }
+        action: 'reach',
+        channel: 'v2ex',
+        method: 'get_hot_topics'
     }, {
         verdict: 'found',
         summary: '10 topics'
@@ -127,22 +125,12 @@ async function main() {
     const r1 = await ws.execute({
         query: 'not-a-url'
     }, null);
+    if (!(r1.ok === false && !!r1.evidence)) throw new Error(`FAIL: 字符串 blob 形态应被宿主权结构化拒绝(ToolFailure),实际 ${JSON.stringify(r1).slice(0, 160)}`);
     const r2 = await ws.execute({
         url: 'not-a-url'
     }, null);
-    for (const [name, r] of [
-        [
-            'string',
-            r1
-        ],
-        [
-            'bare-obj',
-            r2
-        ]
-    ]){
-        if (r.summary === 'url 必填') throw new Error(`FAIL: ${name} 形态未被 unwrapQuery 接住`);
-    }
-    console.log('unwrapQuery: string + bare-object shapes both accepted');
+    if (r2.summary === 'url 必填') throw new Error(`FAIL: 平铺 url 应进 execute 走降级,而非参数闸,实际 ${r2.summary}`);
+    console.log('D-30 typed 契约:web_search 字符串 blob → 宿主权拒绝;平铺 url → 正常降级');
     const skTool = byName('gotry_skeleton_check');
     const skFlat = await skTool.execute({
         from: 'HKG',
@@ -160,20 +148,16 @@ async function main() {
     {
         const hotel = byName('gotry_hotel_search');
         const resolved = await hotel.execute({
-            query: {
-                destination: '大理',
-                checkIn: '2026-9-4',
-                checkOut: '2026-09-06'
-            }
+            destination: '大理',
+            checkIn: '2026-9-4',
+            checkOut: '2026-09-06'
         }, null);
         if (!resolved.date_notes?.some((n)=>n.includes('2026-9-4 → 2026-09-04'))) {
             throw new Error(`FAIL: 非规整 ISO 应产生 slot-resolved note,实际 ${JSON.stringify(resolved.date_notes)}`);
         }
         const unresolved = await hotel.execute({
-            query: {
-                destination: '大理',
-                checkIn: '近期'
-            }
+            destination: '大理',
+            checkIn: '近期'
         }, null);
         if (!unresolved.date_notes?.some((n)=>n.includes('日期未解析:近期'))) {
             throw new Error(`FAIL: 词表外表达应产生「日期未解析」note(不猜),实际 ${JSON.stringify(unresolved.date_notes)}`);
@@ -290,16 +274,20 @@ async function main() {
     }
     {
         const fa = await byName('gotry_flyai_search').execute({
-            query: {
-                kind: 'flight',
-                from: '上海',
-                to: '丽江',
-                date: '2026-10-01'
-            }
+            kind: 'flight',
+            from: '上海',
+            to: '丽江',
+            date: '2026-10-01'
         }, null);
         const faBlocked = fa.verdict === 'error' && /sentinel|block|trial limit/i.test(fa.error ?? '');
         const faErrTerminal = fa.ok === false && fa.verdict === 'error' && /^flyai-error$/.test(String(fa.via ?? '')) && /\[实时API:flyai@error@/.test(String(fa.evidence ?? ''));
-        if (faBlocked) {
+        const faNeedsSetup = fa.ok === false && fa.verdict === 'needs-setup';
+        if (faNeedsSetup) {
+            if (!/FLYAI_API_KEY/.test(String(fa.setup ?? '')) || !/勿重试|不要重试|请勿重试/.test(String(fa.setup ?? ''))) {
+                throw new Error(`FAIL: flyai needs-setup 应带配 key 指引与勿重试明示,实际 setup:${String(fa.setup ?? '').slice(0, 200)}`);
+            }
+            console.log('  WARN - flyai 匿名试用额度达限(needs-setup,配置态),setup 指引合同通过(hit 断言跳过)');
+        } else if (faBlocked) {
             console.log('  WARN - flyai 上游限流中(Sentinel/trial-limit 429),降级合同通过(hit 断言跳过)');
         } else if (faErrTerminal) {
             console.log('  WARN - flyai 端点不可达(超时/降级),证据链合同通过(hit 断言跳过)');
@@ -308,12 +296,10 @@ async function main() {
         }
         const prof = mkdtempSync(join(smokeRoot, 'sess-'));
         const faPast = await byName('gotry_flyai_search').execute({
-            query: {
-                kind: 'flight',
-                from: '深圳',
-                to: '普吉',
-                date: '2026-01-01'
-            }
+            kind: 'flight',
+            from: '深圳',
+            to: '普吉',
+            date: '2026-01-01'
         }, null);
         if (!(faPast.ok === false && /已是过去/.test(String(faPast.summary ?? '')))) {
             throw new Error(`FAIL: flyai 过去日期应代码层预校验拒绝,实际:${JSON.stringify(faPast).slice(0, 200)}`);
@@ -327,11 +313,9 @@ async function main() {
             process.env.CHROME_USER_DATA_DIR = prof;
             try {
                 ss = await byName('gotry_session_search').execute({
-                    query: {
-                        from: '上海',
-                        to: '丽江',
-                        date: '2026-10-01'
-                    }
+                    from: '上海',
+                    to: '丽江',
+                    date: '2026-10-01'
                 }, null);
             } finally{
                 if (previousChromeUserDataDir === undefined) delete process.env.CHROME_USER_DATA_DIR;
@@ -349,38 +333,83 @@ async function main() {
         const faOutcome = faBlocked ? 'sentinel-限流降级' : faErrTerminal ? '端点不可达降级' : `live hit(${fa.options?.length ?? 0} 条)`;
         console.log(`session-face tools: flyai ${faOutcome}; session cdp 隔离门禁=needs-attach`);
         const fh = await byName('gotry_flyai_search').execute({
-            query: {
-                kind: 'hotel',
-                to: '大理',
-                checkIn: '2026-10-01',
-                checkOut: '2026-10-03'
-            }
+            kind: 'hotel',
+            to: '大理',
+            checkIn: '2026-10-01',
+            checkOut: '2026-10-03'
         }, null);
         const fhBlocked = fh.verdict === 'error' && /sentinel|block|trial limit/i.test(fh.error ?? '');
         const fhErrTerminal = fh.ok === false && fh.verdict === 'error' && /^flyai-error$/.test(String(fh.via ?? '')) && /\[实时API:flyai@error@/.test(String(fh.evidence ?? ''));
-        if (fhBlocked || fhErrTerminal) {
+        const fhNeedsSetup = fh.ok === false && fh.verdict === 'needs-setup';
+        if (fhNeedsSetup) {
+            if (!/FLYAI_API_KEY/.test(String(fh.setup ?? ''))) {
+                throw new Error(`FAIL: flyai hotel needs-setup 应带配 key 指引,实际 setup:${String(fh.setup ?? '').slice(0, 200)}`);
+            }
+            console.log('  WARN - flyai hotel 试用额度达限(needs-setup,配置态),setup 指引合同通过(hit 断言跳过)');
+        } else if (fhBlocked || fhErrTerminal) {
             console.log('  WARN - flyai hotel 限流/端点降级,证据链合同通过(hit 断言跳过)');
         } else if (fh.ok !== true || fh.verdict !== 'hit' || (fh.hotels?.length ?? 0) < 1 || !/\[实时API:flyai@/.test(fh.evidence ?? '')) {
             throw new Error(`FAIL: flyai hotel 应 live hit,实际:${JSON.stringify(fh).slice(0, 220)}`);
         }
         const fhDest = await byName('gotry_flyai_search').execute({
+            kind: 'hotel'
+        }, null);
+        if (fhDest.ok !== false) throw new Error('FAIL: hotel 缺目的地应参数闸拒绝');
+        const faLegacy = await byName('gotry_flyai_search').execute({
             query: {
-                kind: 'hotel'
+                kind: 'flight',
+                from: '上海',
+                to: '丽江',
+                date: '2026-10-01'
             }
         }, null);
-        if (fhDest.ok !== false) throw new Error('FAIL: hotel 缺目的地应参数闸拒绝');
-        const fhPast = await byName('gotry_flyai_search').execute({
+        if (!(faLegacy.ok === false && !!faLegacy.evidence && /内部错误|参数|schema|violat/i.test(String(faLegacy.summary ?? '')))) {
+            throw new Error(`FAIL: flyai legacy blob 形态应被 typed 契约结构化拒绝(ADR-13 ToolFailure),实际:${JSON.stringify(faLegacy).slice(0, 200)}`);
+        }
+        const faBadEnum = await byName('gotry_flyai_search').execute({
+            kind: 'plane'
+        }, null);
+        if (!(faBadEnum.ok === false && !!faBadEnum.evidence)) {
+            throw new Error(`FAIL: flyai kind 枚举外值应被宿主权校验拒绝,实际:${JSON.stringify(faBadEnum).slice(0, 200)}`);
+        }
+        console.log('  D-30 typed 契约:legacy blob/枚举外值 → 宿主权结构化拒绝(ToolFailure 形状保持)');
+        const sh = await byName('gotry_session_search').execute({
+            kind: 'hotel',
+            to: '不在码表的城市'
+        }, null);
+        if (!(sh.ok === false && /city=/.test(String(sh.summary ?? '')))) {
+            throw new Error(`FAIL: 会话酒店未收录城市应带 cityId 指引,实际:${JSON.stringify(sh).slice(0, 200)}`);
+        }
+        console.log('  hotel kind 路由:未收录城市 → error + cityId 指引(transport 前短路)');
+        const st = await byName('gotry_session_search').execute({
+            kind: 'train',
+            from: '不在码表',
+            to: '也不在',
+            date: '2026-12-01'
+        }, null);
+        if (!(st.ok === false && /fromStationTelecode/.test(String(st.summary ?? '')))) {
+            throw new Error(`FAIL: 会话火车未收录电报码应带发现指引,实际:${JSON.stringify(st).slice(0, 200)}`);
+        }
+        console.log('  train kind 路由:未收录电报码 → error + 电报码指引(transport 前短路)');
+        const ssLegacy = await byName('gotry_session_search').execute({
             query: {
-                kind: 'hotel',
-                to: '大理',
-                checkIn: '2026-01-01',
-                checkOut: '2026-01-03'
+                kind: 'hotel'
             }
         }, null);
+        if (!(ssLegacy.ok === false && !('routing' in ssLegacy) && /需要 to/.test(String(ssLegacy.summary ?? '')))) {
+            throw new Error(`FAIL: session legacy blob 应经容忍层归一走业务闸(结构化报错,无 routing),实际:${JSON.stringify(ssLegacy).slice(0, 200)}`);
+        }
+        console.log('  D-30 typed 契约:session legacy blob → 容忍层归一 + 结构化业务报错(全字段可选无法宿主权拒)');
+        const fhPast = await byName('gotry_flyai_search').execute({
+            kind: 'hotel',
+            to: '大理',
+            checkIn: '2026-01-01',
+            checkOut: '2026-01-03'
+        }, null);
         if (!(fhPast.ok === false && /不是未来合法区间/.test(String(fhPast.summary ?? '')))) {
             throw new Error(`FAIL: 酒店过去入住日应代码层预校验拒绝,实际:${JSON.stringify(fhPast).slice(0, 200)}`);
         }
-        const fhOutcome = fhBlocked ? 'sentinel-限流降级' : fhErrTerminal ? '端点不可达降级' : `${fh.hotels?.length ?? 0} 家`;
+        const fhOutcome = fhNeedsSetup ? '试用达限(needs-setup)' : fhBlocked ? 'sentinel-限流降级' : fhErrTerminal ? '端点不可达降级' : `${fh.hotels?.length ?? 0} 家`;
         console.log(`  hotel channel: ${fhOutcome}; 参数闸/过去日闸生效`);
     }
     {
@@ -438,9 +467,7 @@ async function main() {
         });
         ledger.settleWorkflowRun('art-probe-1', '# 交付·账本权威\nD1 大理\nD2 洱海');
         const listTool = byName('gotry_artifacts_list');
-        const ledList = await listTool.execute({
-            query: {}
-        }, null);
+        const ledList = await listTool.execute({}, null);
         const run = ledList.artifacts?.find((a)=>a.id === 'art-probe-1');
         if (!ledList.ok || !run || run.source !== 'async-run' || run.status !== 'settled') {
             throw new Error(`FAIL: artifacts list 应发现账本已交付工单,实际:${JSON.stringify(ledList).slice(0, 200)}`);
@@ -454,17 +481,13 @@ async function main() {
         }
         const readTool = byName('gotry_artifacts_read');
         const r1 = await readTool.execute({
-            query: {
-                path: 'art-probe-1'
-            }
+            path: 'art-probe-1'
         }, null);
         if (!r1.ok || r1.lines?.[0]?.number !== 1 || !r1.lines?.[0]?.text.includes('交付·账本权威') || r1.lang !== 'markdown') {
             throw new Error(`FAIL: 裸工单 id 应从账本读出行号视图,实际:${JSON.stringify(r1).slice(0, 200)}`);
         }
         const view = readTool.presentResult?.({
-            query: {
-                path: 'art-probe-1'
-            }
+            path: 'art-probe-1'
         }, r1);
         if (view?.card !== 'read' || view.path !== r1.path || view.offset !== 1 || view.lines?.length !== r1.lines?.length || view.totalLines !== r1.totalLines || view.lang !== 'markdown') {
             throw new Error(`FAIL: read 卡字段不齐,实际:${JSON.stringify(view).slice(0, 200)}`);
@@ -548,10 +571,8 @@ async function main() {
             '- 国泰航空 CX771 08:05→10:35(已按 exact-date 检索记录)'
         ].join('\n');
         const pass = await gate.execute({
-            query: {
-                markdown: passMd,
-                tripYear: 2027
-            }
+            markdown: passMd,
+            tripYear: 2027
         }, null);
         if (pass.verdict !== 'pass' || pass.presentation !== 'verified_itinerary_allowed') {
             throw new Error(`FAIL: 可回溯产物应 pass,实际:${JSON.stringify(pass).slice(0, 300)}`);
@@ -562,17 +583,13 @@ async function main() {
             '- 香港快运 UO784 10:05→12:40 直飞 ✓'
         ].join('\n');
         const blocked = await gate.execute({
-            query: {
-                markdown: badMd,
-                tripYear: 2027
-            }
+            markdown: badMd,
+            tripYear: 2027
         }, null);
         if (blocked.verdict !== 'blocked' || !blocked.violations?.some((v)=>v.kind === 'not_in_source')) {
             throw new Error(`FAIL: exact-date miss 被 UO784 填充必须 blocked(not_in_source),实际:${JSON.stringify(blocked).slice(0, 300)}`);
         }
-        const view = gate.presentResult?.({
-            query: {}
-        }, blocked);
+        const view = gate.presentResult?.({}, blocked);
         if (!view?.title?.includes('blocked')) throw new Error(`FAIL: blocked 呈现卡标题应含 blocked,实际:${view?.title}`);
         console.log(`fact gate: registry 1+1(hit/miss);verified 措辞 pass;miss 填充 UO784 blocked(not_in_source) + 呈现卡`);
     }

package/dist/scripts/turn-handoff-collect-tests.js

@@ -0,0 +1,216 @@
+import assert from 'node:assert/strict';
+import { execFileSync } from 'node:child_process';
+import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { listTurnHandoffTickets, settleTurnHandoffTicket, writeTurnHandoffTicket } from '../src/turn-deadline.js';
+const TS_DIR = join(import.meta.dirname, '..');
+const TSX = join(TS_DIR, 'node_modules', 'tsx', 'dist', 'cli.mjs');
+function runCollector(args, env = {}) {
+    try {
+        const stdout = execFileSync(process.execPath, [
+            TSX,
+            'scripts/turn-handoff-collect.ts',
+            ...args
+        ], {
+            cwd: TS_DIR,
+            env: {
+                ...process.env,
+                ...env
+            },
+            encoding: 'utf-8',
+            stdio: [
+                'ignore',
+                'pipe',
+                'pipe'
+            ]
+        });
+        return {
+            status: 0,
+            stdout,
+            stderr: ''
+        };
+    } catch (error) {
+        const e = error;
+        return {
+            status: e.status ?? null,
+            stdout: e.stdout ?? '',
+            stderr: e.stderr ?? ''
+        };
+    }
+}
+const root = mkdtempSync(join(tmpdir(), 'gotry-handoff-collect-'));
+const planners = mkdtempSync(join(tmpdir(), 'gotry-handoff-planners-'));
+const plannerCalls = join(planners, 'calls.log');
+const okPlanner = join(planners, 'ok.mjs');
+writeFileSync(okPlanner, `import { appendFileSync } from 'node:fs'
+appendFileSync(${JSON.stringify(plannerCalls)}, [
+  'call child=' + process.env.GOTRY_HANDOFF_CHILD,
+  'pin=' + (process.env.GOTRY_TURN_DEADLINE_SOFT_MS ?? 'CLEARED'),
+  'root=' + (process.env.GOTRY_TURN_HANDOFF_ROOT ?? 'CLEARED'),
+  'msg=' + process.argv[2]?.slice(0, 12),
+].join(' | ') + '\\n')
+console.log('# 规划结果\\n方案A:9.26 DXB→CAN,10.3 衡阳婚礼,10.5 返程')
+`);
+const failPlanner = join(planners, 'fail.mjs');
+writeFileSync(failPlanner, `import { appendFileSync } from 'node:fs'
+appendFileSync(${JSON.stringify(plannerCalls)}, 'call fail\\n')
+process.exit(3)
+`);
+const emptyPlanner = join(planners, 'empty.mjs');
+writeFileSync(emptyPlanner, `import { appendFileSync } from 'node:fs'
+appendFileSync(${JSON.stringify(plannerCalls)}, 'call empty\\n')
+`);
+const calls = ()=>existsSync(plannerCalls) ? readFileSync(plannerCalls, 'utf-8').trim().split('\n') : [];
+try {
+    assert.equal(runCollector([
+        'th-missing',
+        root
+    ]).status, 1);
+    const t1 = await writeTurnHandoffTicket(root, '帮我规划10.3衡阳婚礼十几天行程');
+    {
+        const r = runCollector([
+            t1.id,
+            root
+        ], {
+            GOTRY_HANDOFF_PLANNER_BIN: okPlanner
+        });
+        assert.equal(r.status, 0, `stderr=${r.stderr}`);
+        const terminal = JSON.parse(r.stdout.trim().split('\n').at(-1));
+        assert.equal(terminal['schema'], 'gotry_turn_handoff_terminal.v1');
+        assert.equal(terminal['status'], 'succeeded');
+        assert.ok(String(terminal['deliverable_path']).includes(`${t1.id}.deliverable.md`));
+    }
+    const t1After = JSON.parse(readFileSync(join(root, 'gotry-state', 'turn-handoffs', `${t1.id}.json`), 'utf8'));
+    assert.equal(t1After['status'], 'settled');
+    assert.ok(t1After['settledAt']);
+    const deliverable1 = readFileSync(join(root, 'gotry-state', 'turn-handoffs', `${t1.id}.deliverable.md`), 'utf8');
+    assert.ok(deliverable1.includes('方案A') && deliverable1.includes(t1.id));
+    {
+        const before = calls().length;
+        const r = runCollector([
+            t1.id,
+            root
+        ], {
+            GOTRY_HANDOFF_PLANNER_BIN: okPlanner
+        });
+        assert.equal(r.status, 0);
+        const terminal = JSON.parse(r.stdout.trim().split('\n').at(-1));
+        assert.equal(terminal['status'], 'succeeded');
+        assert.equal(calls().length, before, 'settled ticket must not re-run the planner');
+    }
+    {
+        const last = [
+            ...calls()
+        ].reverse().find((l)=>l.includes('child='));
+        assert.ok(last, 'planner ran');
+        assert.ok(last.includes('child=1'), `GOTRY_HANDOFF_CHILD must be 1: ${last}`);
+        assert.ok(last.includes('pin=CLEARED'), `parent deadline pins must be cleared: ${last}`);
+        assert.ok(last.includes('root=CLEARED'), `parent handoff root must be cleared: ${last}`);
+        assert.ok(last.includes('msg=帮我规划10.3衡阳婚礼'), 'planner receives the verbatim user ask');
+    }
+    const t2 = await writeTurnHandoffTicket(root, '另一趟失败的规划');
+    {
+        const r = runCollector([
+            t2.id,
+            root
+        ], {
+            GOTRY_HANDOFF_PLANNER_BIN: failPlanner
+        });
+        assert.equal(r.status, 2);
+        const terminal = JSON.parse(r.stdout.trim().split('\n').at(-1));
+        assert.equal(terminal['status'], 'failed');
+        assert.ok(String(terminal['error']).startsWith('planner exited 3'), `error shape: ${terminal['error']}`);
+    }
+    const t2After = JSON.parse(readFileSync(join(root, 'gotry-state', 'turn-handoffs', `${t2.id}.json`), 'utf8'));
+    assert.equal(t2After['status'], 'failed');
+    assert.ok(String(t2After['error']).startsWith('planner exited 3'));
+    const deliverable2 = readFileSync(join(root, 'gotry-state', 'turn-handoffs', `${t2.id}.deliverable.md`), 'utf8');
+    assert.ok(deliverable2.includes('没有完成') && deliverable2.includes('planner exited 3'), 'honest failure note');
+    {
+        const before = calls().length;
+        assert.equal(runCollector([
+            t2.id,
+            root
+        ], {
+            GOTRY_HANDOFF_PLANNER_BIN: failPlanner
+        }).status, 2);
+        assert.equal(calls().length, before);
+    }
+    const t3 = await writeTurnHandoffTicket(root, '空输出的规划');
+    {
+        const r = runCollector([
+            t3.id,
+            root
+        ], {
+            GOTRY_HANDOFF_PLANNER_BIN: emptyPlanner
+        });
+        assert.equal(r.status, 2);
+        const terminal = JSON.parse(r.stdout.trim().split('\n').at(-1));
+        assert.equal(terminal['error'], 'planner produced empty output');
+    }
+    const t4 = await writeTurnHandoffTicket(root, '批量规划一');
+    const t5 = await writeTurnHandoffTicket(root, '批量规划二');
+    {
+        const dir = join(root, 'gotry-state', 'turn-handoffs');
+        const t5json = JSON.parse(readFileSync(join(dir, `${t5.id}.json`), 'utf8'));
+        writeFileSync(join(dir, `${t5.id}.json`), JSON.stringify({
+            ...t5json,
+            requestedAt: new Date(Date.now() + 5_000).toISOString()
+        }));
+    }
+    {
+        const before = calls().length;
+        const r = runCollector([
+            '--all',
+            root
+        ], {
+            GOTRY_HANDOFF_PLANNER_BIN: okPlanner
+        });
+        assert.equal(r.status, 0, `stderr=${r.stderr}`);
+        const terminal = JSON.parse(r.stdout.trim().split('\n').at(-1));
+        assert.equal(terminal['status'], 'succeeded');
+        assert.equal(calls().length, before + 2, 'exactly the two open tickets collected');
+    }
+    assert.equal(runCollector([
+        '--all',
+        root
+    ], {
+        GOTRY_HANDOFF_PLANNER_BIN: okPlanner
+    }).status, 0);
+    {
+        const views = await listTurnHandoffTickets(root);
+        assert.equal(views.length, 5);
+        assert.equal(views[0].id, t5.id, 'newest first');
+        const settled = views.find((v)=>v.id === t1.id);
+        assert.equal(settled.status, 'settled');
+        assert.ok(settled.deliverableExcerpt?.includes('方案A'));
+        const failed = views.find((v)=>v.id === t2.id);
+        assert.equal(failed.status, 'failed');
+        assert.ok(failed.error?.startsWith('planner exited 3'));
+    }
+    console.log('turn handoff collector tests: OK (settle/fail/empty/idempotent replay/--all/recursion guard env/revisit views)');
+} finally{
+    rmSync(root, {
+        recursive: true,
+        force: true
+    });
+    rmSync(planners, {
+        recursive: true,
+        force: true
+    });
+}
+{
+    const r = mkdtempSync(join(tmpdir(), 'gotry-handoff-settle-'));
+    const t = await writeTurnHandoffTicket(r, '直调结算');
+    const { deliverablePath } = await settleTurnHandoffTicket(r, t, 'settled', '交付内容');
+    assert.ok(existsSync(deliverablePath));
+    const views = await listTurnHandoffTickets(r);
+    assert.equal(views[0].deliverableExcerpt, '交付内容');
+    rmSync(r, {
+        recursive: true,
+        force: true
+    });
+}
+
+//# sourceURL=ts/scripts/turn-handoff-collect-tests.ts