@danceiny/gotry 0.2.0-rc.28 → 0.2.0-rc.30

package/dist/scripts/turn-handoff-web-e2e.js

@@ -0,0 +1,240 @@
+/** Isolated DSH Web handoff journey. Synthetic model/planner; real host, jobs,
+ * processes, composer, completion notice, presentation and artifact tools.
+ * Never a live travel-research or published-package acceptance receipt. */
+import assert from 'node:assert/strict';
+import { execFileSync, spawn } from 'node:child_process';
+import { createServer } from 'node:http';
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, symlinkSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { basename, join } from 'node:path';
+import puppeteer from 'puppeteer-core';
+const ROOT = join(import.meta.dirname, '..', '..');
+const sourceSha = execFileSync('git', ['rev-parse', 'HEAD'], { cwd: ROOT, encoding: 'utf8' }).trim();
+const sourceDirty = execFileSync('git', ['status', '--porcelain'], { cwd: ROOT, encoding: 'utf8' }).trim() !== '';
+const CHROME = '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome';
+const evidence = process.env.GOTRY_HANDOFF_WEB_E2E_OUT ?? mkdtempSync(join(tmpdir(), 'gotry-handoff-web-evidence-'));
+const isolated = mkdtempSync(join(tmpdir(), 'gotry-handoff-web-'));
+const product = join(isolated, 'product');
+const hostCwd = join(isolated, 'host');
+const workspace = join(isolated, 'workspace');
+const stateRoot = join(isolated, 'handoff-state');
+const home = join(isolated, 'home');
+const dshHome = join(isolated, 'dsh');
+for (const dir of [evidence, product, hostCwd, workspace, stateRoot, home, dshHome])
+    mkdirSync(dir, { recursive: true });
+const planner = join(isolated, 'planner.mjs');
+writeFileSync(planner, `console.error('DIAGNOSTIC_NOT_A_PLAN');setTimeout(()=>console.log('# Completed synthetic plan\\nWorkspace: '+process.cwd()+'\\n'+process.argv[2]),15000)`);
+const bodies = [];
+const served = [];
+let phase = 0;
+let serverLog = '';
+let notified = false;
+let relayError;
+let browser;
+let page;
+let child;
+const pageErrors = [];
+const sse = (data) => `data: ${JSON.stringify(data)}\n\n`;
+function response(name, input = {}, text = '') {
+    const block = name ? { type: 'tool_use', id: `handoff-${phase}`, name, input } : { type: 'text', text };
+    return sse({ type: 'message_start', message: { usage: { input_tokens: 10 } } })
+        + sse({ type: 'content_block_start', index: 0, content_block: block })
+        + sse({ type: 'content_block_stop', index: 0 })
+        + sse({ type: 'message_delta', delta: { stop_reason: name ? 'tool_use' : 'end_turn' }, usage: { output_tokens: 10 } })
+        + sse({ type: 'message_stop' }) + 'data: [DONE]\n\n';
+}
+const ticketDir = join(stateRoot, 'gotry-state', 'turn-handoffs');
+function ticket() {
+    const names = existsSync(ticketDir) ? readdirSync(ticketDir).filter(name => name.endsWith('.json')) : [];
+    assert.equal(names.length, 1, 'one durable ticket');
+    return JSON.parse(readFileSync(join(ticketDir, names[0]), 'utf8'));
+}
+const relay = createServer((req, res) => {
+    if (req.method !== 'POST' || !req.url?.endsWith('/messages')) {
+        res.writeHead(404).end();
+        return;
+    }
+    const chunks = [];
+    req.on('data', chunk => chunks.push(Buffer.from(chunk)));
+    req.on('end', () => {
+        try {
+            const body = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+            bodies.push(body);
+            res.writeHead(200, { 'content-type': 'text/event-stream', 'cache-control': 'no-cache' });
+            const names = (body.tools ?? []).map((tool) => tool.name ?? tool.function?.name);
+            const messages = JSON.stringify(body.messages ?? []);
+            const isPlanner = names.includes('write') || names.includes('present') || names.includes('job_output');
+            if (!isPlanner) {
+                res.end(response(undefined, {}, 'Synthetic title'));
+                return;
+            }
+            let name;
+            let input = {};
+            let final = '';
+            let delay = 0;
+            if (phase === 0) {
+                name = 'write';
+                input = { file_path: 'exploration.md', content: '# Synthetic exploration\nWork hours 9-18 CST; original request retained.' };
+                // Cross the foreground deadline deliberately, while giving the later
+                // completion/query turn enough time for several native tool round trips.
+                delay = 5500;
+            }
+            else if (phase === 1) {
+                name = 'present';
+                input = { files: [{ path: join(workspace, 'exploration.md'), description: '探索稿' }] };
+            }
+            else if (phase === 2) {
+                final = '探索稿已保存，后台任务已启动。';
+            }
+            else if (phase === 3) {
+                assert.match(messages, /finished.*completed/, 'native completion notice wakes the owning session');
+                notified = true;
+                name = 'job_output';
+                input = { job_id: ticket().jobId, wait: false };
+            }
+            else if (phase === 4) {
+                assert.ok(messages.includes('Planning completed:'), 'native job result reaches the model');
+                name = 'present';
+                input = { files: [{ path: join(ticketDir, ticket().deliverableFile), description: '最终交付物' }] };
+            }
+            else if (phase === 5) {
+                name = 'gotry_artifacts_list';
+                input = { limit: 20 };
+            }
+            else if (phase === 6) {
+                assert.ok(messages.includes(ticket().id), 'artifact list includes the same ticket');
+                name = 'gotry_artifacts_read';
+                input = { path: ticket().id };
+            }
+            else {
+                final = '最终规划已完成并展示，可按工单重新读取。';
+            }
+            if (name) {
+                assert.ok(names.includes(name), `${name} remains available in phase ${phase}: ${names}`);
+                served.push(name);
+            }
+            phase++;
+            setTimeout(() => res.end(response(name, input, final)), delay);
+        }
+        catch (error) {
+            relayError = String(error);
+            res.end(response(undefined, {}, 'RELAY_TEST_FAILURE'));
+        }
+    });
+});
+try {
+    assert.ok(existsSync(CHROME), 'Chrome is required for the browser receipt');
+    assert.ok(existsSync(join(ROOT, 'dist/src/turn-handoff-job.js')), 'build dist before the browser journey');
+    // The real source launcher normally uses ts/dsh-runtime as host cwd. Run the
+    // exact built package in a private layout instead, so even legacy state reads
+    // and process-guard logs cannot touch the founder's runtime directory.
+    const packed = JSON.parse(execFileSync('npm', ['pack', '--ignore-scripts', '--json', '--pack-destination', isolated], { cwd: ROOT, encoding: 'utf8' }))[0];
+    execFileSync('tar', ['xzf', join(isolated, packed.filename), '--strip-components=1', '-C', product]);
+    symlinkSync(join(ROOT, 'node_modules'), join(product, 'node_modules'), 'dir');
+    await new Promise(resolve => relay.listen(0, '127.0.0.1', resolve));
+    const port = relay.address().port;
+    child = spawn(process.execPath, [join(product, 'bin/gotry-inner.js'), 'web', '--no-open', '--port', '0'], {
+        cwd: hostCwd,
+        env: { ...process.env, HOME: home, DSH_HOME: dshHome, GOTRY_SETUP_SKIP: '1', GOTRY_ONBOARDING_SKIP: '1',
+            GOTRY_SESSION_LIVE: '0', GOTRY_HBCLI_LIVE: '0', GOTRY_HOTELBYTE_SKILLS_LIVE: '0',
+            LLM_API_KEY: 'synthetic-only', LLM_BASE_URL: `http://127.0.0.1:${port}/v1`, LLM_MODEL: 'synthetic-handoff-web',
+            GOTRY_LLM_MODEL: 'synthetic-handoff-web', DEEPSEEK_API_KEY: 'synthetic-only', DEEPSEEK_BASE_URL: `http://127.0.0.1:${port}/v1`,
+            GOTRY_TURN_HANDOFF_ROOT: stateRoot, GOTRY_HANDOFF_PLANNER_BIN: planner,
+            GOTRY_TURN_DEADLINE_SOFT_MS: '2000', GOTRY_TURN_DEADLINE_HARD_MS: '5000' },
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    const url = await new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new Error(`Web startup timed out: ${serverLog.slice(-4000)}`)), 30000);
+        const collect = (chunk) => {
+            serverLog += chunk.toString();
+            const match = serverLog.match(/dsh web: (http:\/\/127\.0\.0\.1:\d+\/\?token=[^\s)]+)/);
+            if (match) {
+                clearTimeout(timer);
+                resolve(match[1]);
+            }
+        };
+        child.stdout.on('data', collect);
+        child.stderr.on('data', collect);
+        child.once('error', reject);
+    });
+    browser = await puppeteer.launch({ executablePath: CHROME, headless: true, userDataDir: join(isolated, 'chrome'), args: ['--no-sandbox', '--disable-gpu'] });
+    page = await browser.newPage();
+    page.setDefaultTimeout(30000);
+    page.on('pageerror', (error) => pageErrors.push(error.message));
+    await page.goto(url, { waitUntil: 'networkidle2' });
+    const dismiss = async () => {
+        await page.waitForFunction(() => [...document.querySelectorAll('button')].some(node => ['继续', 'Continue'].includes(node.textContent?.trim() ?? '')));
+        await page.evaluate(() => [...document.querySelectorAll('button')].find(node => ['继续', 'Continue'].includes(node.textContent?.trim() ?? ''))?.click());
+    };
+    await dismiss();
+    const registered = await page.evaluate(async (path) => {
+        const response = await fetch('/api/workspace/create', { method: 'POST', headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ type: 'client-request', rpcId: crypto.randomUUID(), method: 'workspace/create', payload: { args: { request: { path } } } }) });
+        return response.json();
+    }, workspace);
+    assert.equal(registered.result?.ok, true, 'register the isolated workspace through public RPC');
+    await page.reload({ waitUntil: 'networkidle2' });
+    await page.waitForFunction(() => [...document.querySelectorAll('button')].some(node => /Default workspace|默认工作区/.test(node.textContent ?? '')));
+    await page.evaluate(() => [...document.querySelectorAll('button')].find(node => /Default workspace|默认工作区/.test(node.textContent ?? ''))?.click());
+    await page.waitForFunction((title) => [...document.querySelectorAll('[role="menuitem"], [role="option"], button')].some(node => node.textContent?.trim() === title), {}, basename(workspace));
+    await page.evaluate((title) => [...document.querySelectorAll('[role="menuitem"], [role="option"], button')].find(node => node.textContent?.trim() === title)?.click(), basename(workspace));
+    await page.waitForSelector('[contenteditable="true"]');
+    await page.click('[contenteditable="true"]');
+    await page.keyboard.type('12月初阿联酋国庆，借5天IRW远程办公和请假回国十几天，去东北长春泡澡，女朋友从南京过去，请探索具体规划。工作时间9-18 CST。');
+    await page.click('button[aria-label="发送消息"], button[aria-label="Send message"]');
+    await page.waitForFunction(() => /探索稿已保存|RELAY_TEST_FAILURE/.test(document.body.innerText), { timeout: 30000 });
+    assert.equal(relayError, undefined);
+    assert.ok(existsSync(join(workspace, 'exploration.md')), 'deadline draft really exists in the original workspace');
+    const running = ticket();
+    assert.equal(running.status, 'running');
+    assert.ok(running.jobId);
+    await page.screenshot({ path: join(evidence, 'running.png'), fullPage: true });
+    await page.waitForFunction(() => /最终规划已完成并展示|RELAY_TEST_FAILURE/.test(document.body.innerText), { timeout: 60000 });
+    assert.equal(relayError, undefined);
+    const settled = ticket();
+    assert.equal(settled.status, 'settled');
+    const outputPath = join(ticketDir, settled.deliverableFile);
+    const output = readFileSync(outputPath, 'utf8');
+    assert.ok(output.includes('Completed synthetic plan') && output.includes(workspace));
+    assert.ok(output.includes('9-18 CST'), 'prior constraints travel to the worker');
+    assert.ok(!output.includes('DIAGNOSTIC_NOT_A_PLAN'));
+    assert.ok(notified);
+    assert.deepEqual(pageErrors, []);
+    const fileCards = await page.evaluate(() => [...document.querySelectorAll('button')].map(node => ({ text: node.textContent, label: node.getAttribute('aria-label'), title: node.getAttribute('title') })));
+    const openLabel = await page.evaluate((path) => {
+        const button = [...document.querySelectorAll('button')].find(node => [node.getAttribute('title'), node.getAttribute('aria-label'), node.textContent].some(text => text?.includes(path) || text?.includes(path.split('/').at(-1))));
+        if (!button)
+            return false;
+        button.click();
+        return true;
+    }, outputPath);
+    assert.ok(openLabel, `native file card must offer the final output: ${JSON.stringify(fileCards).slice(-4000)}`);
+    await page.waitForFunction(() => document.body.innerText.includes('Completed synthetic plan'), { timeout: 30000 });
+    await page.screenshot({ path: join(evidence, 'completed-preview.png'), fullPage: true });
+    writeFileSync(join(evidence, 'receipt.json'), JSON.stringify({ passed: true, evidence: 'synthetic_fixture',
+        runtime: 'source-built DSH Web', layout: 'isolated tarball with repository dependencies', sourceSha, sourceDirty, nodeVersion: process.version, served, notified, ticketId: settled.id, jobId: settled.jobId,
+        draftWritten: true, finalPresented: true, previewOpened: true, status: settled.status, pageErrors }, null, 2));
+    console.log(`handoff web E2E: OK; synthetic receipt: ${evidence}`);
+}
+catch (error) {
+    if (page) {
+        await page.screenshot({ path: join(evidence, 'failure.png'), fullPage: true }).catch(() => { });
+        writeFileSync(join(evidence, 'failure-dom.txt'), await page.evaluate(() => document.body.innerText + '\n' + JSON.stringify([...document.querySelectorAll('button')].map(node => ({ text: node.textContent, label: node.getAttribute('aria-label'), title: node.getAttribute('title') })))).catch(() => ''));
+    }
+    writeFileSync(join(evidence, 'failure.json'), JSON.stringify({ error: String(error), phase, served, pageErrors,
+        serverLog: serverLog.replace(/token=[^\s)]+/g, 'token=[redacted]').slice(-5000) }, null, 2));
+    writeFileSync(join(evidence, 'requests.json'), JSON.stringify(bodies, null, 2));
+    throw error;
+}
+finally {
+    await browser?.close();
+    if (child && child.exitCode === null) {
+        const closed = new Promise(resolve => child.once('close', () => resolve()));
+        child.kill('SIGTERM');
+        const timer = setTimeout(() => child.kill('SIGKILL'), 5000);
+        await closed;
+        clearTimeout(timer);
+    }
+    await new Promise(resolve => relay.close(() => resolve()));
+    rmSync(isolated, { recursive: true, force: true });
+}

package/dist/scripts/unified-tests.js

@@ -3,7 +3,7 @@
  * 运行(在 ts/ 下):npx tsx scripts/unified-tests.ts
  */
 import assert from 'node:assert/strict';
-import { readFile } from 'node:fs/promises';
+import { readdir, readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { parseFlightPackToSpec, solveUnified } from '../src/unified.js';
 import { hhmmToMin } from '../src/model.js';
@@ -50,23 +50,62 @@ off.budgetCny = 9000;
 off.workWindow = undefined;
 const r4 = await solveUnified(off);
 assert.deepEqual(r4.work_window_exclusions, []); // 关掉窗口,周五班恢复可选
-// 5. Issue #620:yunnan-pack 的 yn0 段缺 buffer_min/origin_transfer_min/dest_transfer_min
+// 5. Issue #620 / #635:云南包的 yn0 衔接段缺 buffer_min/origin_transfer_min/dest_transfer_min
 //    → 旧实现 Number(undefined)=NaN → Int.val(NaN) 在 z3 WASM 里 `Assertion failed`
-//    → 被兜底翻译成「不可行 + unsat_core:['wasm_runtime_error']」。三条红线:
-//    ① parse 边界必须点名拒收(不默认补 0);② 绕过 parse 的 NaN spec 必须以
-//    solver_error 返回而**绝不**是 infeasible;③ 补齐那三个字段后整包必须真能判定。
-const yunnanRaw = JSON.parse(await readFile(join('..', 'data', 'yunnan-pack.json'), 'utf-8'));
-// ① 真实数据包:yn0 的三个缺字段 → NaN → 必须是显式 solver_error,绝不是「不可行」
-const yunnanSpecRaw = parseFlightPackToSpec(structuredClone(yunnanRaw));
-yunnanSpecRaw.budgetCny = 9000;
-assert.ok(Number.isNaN(yunnanSpecRaw.segments[0].options[0].move.bufferMin), 'yn0 缺 buffer_min 的事实前提');
-const rYunnanRaw = await solveUnified(yunnanSpecRaw);
-assert.equal(rYunnanRaw.solver_error?.code, 'solver_input_not_integer', `yunnan 包必须以 solver_error 返回(got ${JSON.stringify(rYunnanRaw)})`);
-assert.ok(rYunnanRaw.solver_error.message.includes('yn0.bufferMin'), `solver_error 必须点名出问题的段与字段(got ${rYunnanRaw.solver_error.message})`);
-assert.equal(rYunnanRaw.feasible, false, 'solver_error 轮次没有产出可行解');
-assert.deepEqual(rYunnanRaw.unsat_core, undefined, '求解器失败不得伪造 unsat_core(机器 token 不进冲突位)');
-assert.ok(!JSON.stringify(rYunnanRaw).includes('wasm_runtime_error'), '不得再出现 wasm_runtime_error 这个伪冲突 token');
-// ② 最小输入:健康包里塞一个 NaN 接驳分钟 → 同样是 solver_error,点名到字段
+//    → 被兜底翻译成「不可行 + unsat_core:['wasm_runtime_error']」。五条红线:
+//    ① 出厂数据包里挂接引擎的每一段(`legs`)三字段必须是非负整数;缺真值的段只能记在
+//       `advisory_legs`(带理由、不挂接)——替它填数等于编造真实世界的事实(ADR-10);
+//    ② 出厂云南包整包可判定,yn0 不进求解(founder 2026-10-05 选「标 advisory」);
+//    ③ 防线仍在:缺字段的包(由测试构造)必须以 solver_error 返回而**绝不**是 infeasible;
+//    ④ 最小输入:健康包里塞一个 NaN 接驳分钟 → 同样是 solver_error;
+//    ⑤ 晋升路径:founder 给出三个真值后,把 advisory 段搬回 legs 即可整包判定。
+const DATA_DIR = join('..', 'data');
+const TRANSFER_FIELDS = ['buffer_min', 'origin_transfer_min', 'dest_transfer_min'];
+const yunnanRaw = JSON.parse(await readFile(join(DATA_DIR, 'yunnan-pack.json'), 'utf-8'));
+// ① 数据完整性:data/ 下每个带 legs 的包,挂接引擎的段三字段齐全;advisory 段自带理由且不与 legs 重名
+let auditedPacks = 0;
+for (const file of (await readdir(DATA_DIR)).filter(f => f.endsWith('.json')).sort()) {
+    const raw = JSON.parse(await readFile(join(DATA_DIR, file), 'utf-8'));
+    if (!Array.isArray(raw['legs']))
+        continue;
+    auditedPacks += 1;
+    const legs = raw['legs'];
+    for (const leg of legs) {
+        for (const field of TRANSFER_FIELDS) {
+            const value = leg[field];
+            assert.ok(typeof value === 'number' && Number.isInteger(value) && value >= 0, `${file}: leg ${String(leg['id'])}.${field} 必须是非负整数(got ${JSON.stringify(value)});缺真值的段请放进 advisory_legs,不要补编造值(issue #635)`);
+        }
+    }
+    const engineIds = new Set(legs.map(leg => String(leg['id'])));
+    for (const advisory of (raw['advisory_legs'] ?? [])) {
+        const reason = advisory['advisory_reason'];
+        assert.ok(typeof reason === 'string' && reason.trim() !== '', `${file}: advisory 段 ${String(advisory['id'])} 必须写明 advisory_reason`);
+        assert.ok(!engineIds.has(String(advisory['id'])), `${file}: ${String(advisory['id'])} 不能同时在 legs 与 advisory_legs`);
+    }
+}
+assert.ok(auditedPacks >= 2, `数据完整性审计应覆盖航班包与云南包(审计了 ${auditedPacks} 个)`);
+// ② 出厂云南包按产品同款路径整包可判定;advisory 段 yn0 不进引擎段链,也不参与求解
+const yunnanSpec = parseFlightPackToSpec(structuredClone(yunnanRaw));
+assert.deepEqual(yunnanSpec.segments.map(s => s.id), ['yn1', 'yn2', 'yn3', 'yn4'], 'advisory 段 yn0 不得进引擎段链');
+yunnanSpec.budgetCny = 9000;
+const rYunnan = await solveUnified(yunnanSpec);
+assert.equal(rYunnan.solver_error, undefined, `出厂云南包不得再有求解器失败(got ${JSON.stringify(rYunnan.solver_error)})`);
+assert.equal(rYunnan.feasible, true, `出厂云南包应可行(unsat_core=${JSON.stringify(rYunnan.unsat_core)})`);
+assert.deepEqual(rYunnan.legs.map(l => l.leg), ['yn1', 'yn2', 'yn3', 'yn4'], '四段全判定,yn0 不在其中');
+// ③ 防线仍在:缺三个字段的包(由测试从出厂包构造)→ NaN → 必须是显式 solver_error,绝不是「不可行」
+const yunnanGap = structuredClone(yunnanRaw);
+for (const field of TRANSFER_FIELDS)
+    delete yunnanGap['legs'][0][field];
+const yunnanGapSpec = parseFlightPackToSpec(yunnanGap);
+yunnanGapSpec.budgetCny = 9000;
+assert.ok(Number.isNaN(yunnanGapSpec.segments[0].options[0].move.bufferMin), '缺 buffer_min 的事实前提');
+const rYunnanGap = await solveUnified(yunnanGapSpec);
+assert.equal(rYunnanGap.solver_error?.code, 'solver_input_not_integer', `缺字段的包必须以 solver_error 返回(got ${JSON.stringify(rYunnanGap)})`);
+assert.ok(rYunnanGap.solver_error.message.includes('yn1.bufferMin'), `solver_error 必须点名出问题的段与字段(got ${rYunnanGap.solver_error.message})`);
+assert.equal(rYunnanGap.feasible, false, 'solver_error 轮次没有产出可行解');
+assert.deepEqual(rYunnanGap.unsat_core, undefined, '求解器失败不得伪造 unsat_core(机器 token 不进冲突位)');
+assert.ok(!JSON.stringify(rYunnanGap).includes('wasm_runtime_error'), '不得再出现 wasm_runtime_error 这个伪冲突 token');
+// ④ 最小输入:健康包里塞一个 NaN 接驳分钟 → 同样是 solver_error,点名到字段
 const nanSpec = parseFlightPackToSpec(pack);
 nanSpec.budgetCny = 9000;
 nanSpec.segments[0].options[0].move.bufferMin = Number.NaN;
@@ -74,16 +113,18 @@ const rNan = await solveUnified(nanSpec);
 assert.equal(rNan.solver_error?.code, 'solver_input_not_integer', `NaN 接驳必须以 solver_error 返回(got ${JSON.stringify(rNan)})`);
 assert.ok(rNan.solver_error.message.includes('f1.bufferMin'), `solver_error 必须点名字段(got ${rNan.solver_error.message})`);
 assert.equal(rNan.feasible, false, 'solver_error 轮次没有产出可行解');
-// ③ 补齐 yn0 的三个字段(由测试提供,不改数据包:真值待 founder 校准)→ 整包真能判定,
-//    证明断言失败的最小输入正是这三个字段,其余四段编码本身没问题
-const yunnanFixed = structuredClone(yunnanRaw);
-Object.assign(yunnanFixed['legs'][0], {
-    buffer_min: 60, origin_transfer_min: 30, dest_transfer_min: 30,
-});
-const yunnanSpec = parseFlightPackToSpec(yunnanFixed);
-yunnanSpec.budgetCny = 9000;
-const rYunnan = await solveUnified(yunnanSpec);
-assert.equal(rYunnan.solver_error, undefined, `补齐三字段后不得再有求解器失败(got ${JSON.stringify(rYunnan.solver_error)})`);
-assert.equal(rYunnan.feasible, true, `yunnan 整包应可行(unsat_core=${JSON.stringify(rYunnan.unsat_core)})`);
-assert.equal(rYunnan.legs.length, 5, '五段全判定');
-console.log(`TS UNIFIED TESTS: 5/5 OK(工作窗口生效,f2=VZ303,¥${r1.money_cny};#620 yunnan NaN→solver_error 点名 yn0,补齐三字段后可行 ¥${rYunnan.money_cny})`);
+// ⑤ 晋升路径:三个真值由测试提供(数据包里不写——真值待 founder 校准),把 advisory 段搬回 legs 的头部
+//    → 五段全判定,证明「补齐三个整数」正是 yn0 从 advisory 晋升所需的全部
+const yunnanPromoted = structuredClone(yunnanRaw);
+const [promotedYn0] = yunnanPromoted['advisory_legs'];
+delete promotedYn0['advisory_reason'];
+Object.assign(promotedYn0, { buffer_min: 60, origin_transfer_min: 30, dest_transfer_min: 30 });
+yunnanPromoted['legs'] = [promotedYn0, ...yunnanPromoted['legs']];
+delete yunnanPromoted['advisory_legs'];
+const promotedSpec = parseFlightPackToSpec(yunnanPromoted);
+promotedSpec.budgetCny = 9000;
+const rPromoted = await solveUnified(promotedSpec);
+assert.equal(rPromoted.solver_error, undefined, `补齐三字段后不得再有求解器失败(got ${JSON.stringify(rPromoted.solver_error)})`);
+assert.equal(rPromoted.feasible, true, `晋升后的云南包应可行(unsat_core=${JSON.stringify(rPromoted.unsat_core)})`);
+assert.equal(rPromoted.legs.length, 5, '晋升后五段全判定');
+console.log(`TS UNIFIED TESTS: 5/5 OK(工作窗口生效,f2=VZ303,¥${r1.money_cny};#620/#635 ${auditedPacks} 个包三字段齐全,出厂云南包四段可行,缺字段→solver_error 点名 yn1,晋升后五段可行)`);

package/dist/src/backend/modules/session-search.js

@@ -384,7 +384,7 @@ export function startSessionSearchModule(options) {
         if (!queue.extensionConnected()) {
             sendJson(res, 200, {
                 ok: true,
-                suppliers: [{ supplier: 'dida-portal', loggedIn: false, reason: 'extension-not-connected', detail: '会话执行环境=管理员浏览器扩展(GoTry Session Bridge);扩展未连接桥——在管理员浏览器安装扩展并配置本服务桥地址' }],
+                suppliers: [{ supplier: 'dida-portal', loggedIn: false, reason: 'extension-not-connected', detail: '会话执行环境=管理员浏览器扩展(Stai Travel Bridge);扩展未连接桥——在管理员浏览器安装扩展并配置本服务桥地址' }],
                 bridge: queue.stats(),
                 checkedAt,
             });

package/dist/src/index.js

@@ -48,6 +48,7 @@ import { factsFromFlyai, factsFromHotel, factsFromSession, factsFromSessionTrain
 import { hasRecognizedAvailableSeat } from '../capabilities/session/adapters/rail-12306.js';
 import { gateArtifact } from './artifact-gate.js';
 import { installTurnDeadline, listTurnHandoffTickets } from './turn-deadline.js';
+import { startTurnHandoffJob } from './turn-handoff-job.js';
 import { noteChannelVerdict, recordChannelEvent, readLatestChannelEvents } from '../capabilities/channel-health.js';
 import { routingAdvice, renderRoutingCard, toolRoutingHeadline, persistedDownChannels } from '../capabilities/channel-registry.js';
 import { registerBenchmarkEnvironmentBridge } from './benchmark-environment-bridge.js';
@@ -433,7 +434,11 @@ export function apply(ctx, config, seams = {}) {
         ? { fixedPolicy: { softMs: 300_000, hardMs: 900_000, exit: 'converge' } }
         : rawBenchmarkEnvironmentConfigPath.trim()
             ? { fixedPolicy: benchmarkPinnedPolicy() }
-            : { stateRoot: process.env.GOTRY_TURN_HANDOFF_ROOT ?? config.stateRoot ?? '.' });
+            : { stateRoot: process.env.GOTRY_TURN_HANDOFF_ROOT ?? config.stateRoot ?? '.',
+                // A one-shot headless process exits after its final response and cannot
+                // own ongoing work. Keep that ticket queued for explicit collection.
+                startHandoff: (ticket, agent, root) => typeof ctx.get === 'function' && ctx.get('connection')
+                    ? startTurnHandoffJob(ctx, ticket, agent, root) : Promise.resolve(ticket) });
     if (rawBenchmarkEnvironmentConfigPath.trim()) {
         // Benchmark mode is a deliberately minimal kernel: only the model
         // override and the environment bridge are installed besides the pinned
@@ -987,8 +992,8 @@ export function apply(ctx, config, seams = {}) {
     registerGuarded(defineTool({
         name: 'gotry_turn_handoff_list',
         description: 'List background deep-planning handoff tickets (read-only). Call this whenever the user asks about '
-            + 'a previously handed-off plan («规划好了吗» / «上次那个行程»): open = still being worked in the '
-            + 'background (ETA ' + '约 1 小时' + '), settled = deliverable ready (excerpt included, full text in the '
+            + 'a previously handed-off plan («规划好了吗» / «上次那个行程»): open = queued, worker not started; '
+            + 'running = started with a native job id (use job_list for live status); settled = deliverable ready (excerpt included, full text in the '
             + 'ticket\'s .deliverable.md), failed = honest failure note. Never fabricate a deliverable that is not here.',
         // D-30 第三刀(issue #112):query blob → 平铺 typed;全字段可选 → interpretArgs 容忍层(同 session 刀法)
         parameters: {
@@ -998,9 +1003,10 @@ export function apply(ctx, config, seams = {}) {
             schema: { type: 'json' },
             render: (_args, value) => [{ type: 'text', text: String(value.summary ?? '') }],
         },
-        async execute(args, _exec) {
+        async execute(args, exec) {
             const q = interpretArgs(args);
-            const root = process.env.GOTRY_TURN_HANDOFF_ROOT ?? config.stateRoot ?? '.';
+            const configuredRoot = process.env.GOTRY_TURN_HANDOFF_ROOT ?? config.stateRoot ?? '.';
+            const root = configuredRoot === '.' ? sessionCwd(exec) ?? '.' : configuredRoot;
             const all = await listTurnHandoffTickets(root);
             const tickets = (q.ticketId ? all.filter(t => t.id === q.ticketId) : all).slice(0, 10);
             if (tickets.length === 0) {
@@ -1014,10 +1020,19 @@ export function apply(ctx, config, seams = {}) {
             const lines = tickets.map(t => {
                 const head = `[${t.status}] ${t.id} ${t.objective.slice(0, 40)}`;
                 if (t.status === 'open')
-                    return `${head}——后台规划中,ETA ${t.etaLabel}`;
+                    return `${head}——待启动，后台尚未运行`;
+                if (t.status === 'running') {
+                    const owner = exec.agent;
+                    // Native counters restart with the host. A recycled id alone is not
+                    // the durable ticket's identity and must not offer another trip's job.
+                    const live = owner && ctx.get('jobs')?.list(owner.id).some(job => job.id === t.jobId
+                        && job.owner === owner.id && job.kind === 'gotry-planning' && job.label.startsWith(`${t.id}: `)
+                        && (job.status === 'running' || job.status === 'stopping'));
+                    return `${head}——${live ? `后台任务 ${t.jobId}，预计 ${t.etaLabel}` : '运行记录已中断，当前没有活跃后台任务'} `;
+                }
                 if (t.status === 'failed')
                     return `${head}——失败:${t.error ?? '未知原因'}(请重新发起规划)`;
-                return `${head}——已交付,摘要:${(t.deliverableExcerpt ?? '').slice(0, 120).replace(/\n/g, ' ')}`;
+                return `${head}——${t.deliverablePath ? `已交付：${t.deliverablePath}` : '交付文件缺失'}，摘要:${(t.deliverableExcerpt ?? '').slice(0, 120).replace(/\n/g, ' ')}`;
             });
             return {
                 ok: true, count: tickets.length, tickets,
@@ -1660,7 +1675,7 @@ export function apply(ctx, config, seams = {}) {
         description: 'Productized login bootstrap for the account session channel (call this when gotry_session_search returns needs-login — the user never needs a terminal). ' + 'AUTO-DETECTION FIRST: it reads ticket-cookie NAMES before anything else — if the user already logged in (on the external site) it confirms instantly WITHOUT opening any page. '
             + 'OPENS the site login entry in the USER\'S OWN Chrome (foreground tab, left open for the user) and waits for the user to finish logging in on the external site. '
             + 'GoTry NEVER collects, stores, or transmits credentials: no passwords, no SMS codes, no cookie values — it only checks the boolean fact "already logged in" (reads cookie NAMES only, zero values). '
-            + 'Transport: the GoTry Session Bridge browser extension (one-time install, ZERO Chrome system dialogs). '
+            + 'Transport: the Stai Travel Bridge browser extension (one-time install, ZERO Chrome system dialogs). '
             + `verdict logged-in (tickets detected) | pending (login tab opened, user not done yet — offer to re-check later) | needs-extension (one-time extension install: the verdict surfaces the Chrome Web Store installUrl as a clickable link for dsh UI to render — installation is a browser concern, not gotry's). `
             + 'Evidence [会话:<site>-login@ts].',
         // D-30 第三刀(issue #112):query blob → 平铺 typed;全字段可选 → interpretArgs 容忍层
@@ -1680,7 +1695,7 @@ export function apply(ctx, config, seams = {}) {
                 : r.verdict === 'pending'
                     ? `登录入口已在你的 Chrome 打开;请在弹出的标签页里正常登录携程(登录由你在官网完成,不属于 gotry)。完成后说一声"继续",我再确认。gotry 只检查"是否已登录",永不收集你的账号信息。${r.evidence}`
                     : r.verdict === 'needs-extension'
-                        ? `需要一次性安装 GoTry Session Bridge 浏览器扩展:这是浏览器的事,gotry 不弹面板不开剪贴板——请直接在 Chrome 应用商店一键装(add-to-chrome 自动更新)。storeUrl=${EXTENSION_STORE_URL}. 装好即生效,装完后告诉我「重试」即可。${r.evidence}`
+                        ? `需要一次性安装 Stai Travel Bridge 浏览器扩展:这是浏览器的事,gotry 不弹面板不开剪贴板——请直接在 Chrome 应用商店一键装(add-to-chrome 自动更新)。storeUrl=${EXTENSION_STORE_URL}. 装好即生效,装完后告诉我「重试」即可。${r.evidence}`
                         : r.verdict === 'needs-attach'
                             ? `cdp 车道需要一次性开启你 Chrome 的远程调试开关:在你的 Chrome 地址栏打开 chrome://inspect/#remote-debugging 并打开开关,然后说一声"重试"(默认走扩展车道,无需此步)。${r.evidence}`
                             : `登录引导未完成:${r.error ?? '未知原因'} ${r.evidence}`;
@@ -1695,7 +1710,7 @@ export function apply(ctx, config, seams = {}) {
                 : r.verdict === 'pending'
                     ? '等待你在携程页面完成登录'
                     : needsExt
-                        ? '🧩 需装 GoTry Session Bridge 扩展(浏览器商店一键装,自动更新)'
+                        ? '🧩 需装 Stai Travel Bridge 扩展(浏览器商店一键装,自动更新)'
                         : r.verdict ?? '降级';
             const content = [{ type: 'text', text: String(value.summary ?? '') }];
             // needs-extension:把商店 URL 渲成可点链接(浏览器自己当安装器,gotry 不插手)
@@ -1709,7 +1724,7 @@ export function apply(ctx, config, seams = {}) {
         name: 'gotry_session_search',
         description: routed('gotry_session_search', 'Search on the USER\'S OWN browser session (Ctrip kind="flight"(default)/"hotel"; 12306 kind="train" — public query face, no login needed). '
             + 'Consent gate: the FIRST call in a session asks the user via the runtime approval card; once granted it holds for the session, a refusal revokes it for the session (no repeat prompting). '
-            + 'Transport: GoTry Session Bridge browser extension (one-time install) — the agent side never talks to Chrome debugging, ZERO system dialogs; read-only by construction (the extension never issues requests; it only passively forwards the site\'s own search responses; agent NEVER touches credentials/captcha; on captcha it stops and returns challenged). '
+            + 'Transport: Stai Travel Bridge browser extension (one-time install) — the agent side never talks to Chrome debugging, ZERO system dialogs; read-only by construction (the extension never issues requests; it only passively forwards the site\'s own search responses; agent NEVER touches credentials/captcha; on captcha it stops and returns challenged). '
             + 'kind="flight": from/to 中文城市名 + date YYYY-MM-DD — sniffs the site search API for structured options. Evidence [会话:ctrip-flight@ts]. '
             + 'kind="hotel": to=目的地中文, cityId? = the numeric city= in a hotels.ctrip.com list URL (web-search it when the destination is outside the built-in city table), checkIn?/checkOut? (YYYY-MM-DD), adults?; hotel prices are the user\'s real logged-in prices. Evidence [会话:ctrip-hotel@ts]. '
             + 'kind="dida": Dida supplier-portal realtime hotel rates on the employee\'s own logged-in session (hotel-be portal integration line) — no from/to needed; the portal find page\'s own requests are sniffed passively. Rates carry ratePlanId/referenceNo for the server-side booking chain. Evidence [会话:dida-portal@ts]. '
@@ -1888,7 +1903,7 @@ export function apply(ctx, config, seams = {}) {
                 : r.verdict === 'needs-login'
                     ? '需登录'
                     : needsExt
-                        ? '🧩 需装 GoTry Session Bridge 扩展(浏览器商店一键装,自动更新)'
+                        ? '🧩 需装 Stai Travel Bridge 扩展(浏览器商店一键装,自动更新)'
                         : r.verdict ?? '降级';
             const content = [{ type: 'text', text: String(value.summary ?? '') }];
             if (needsExt && r.installUrl)
@@ -2172,7 +2187,7 @@ export function apply(ctx, config, seams = {}) {
     // 统一的状态入口来「显示状态 + 引导补装」,而不是在 not-installed 里各自摸索)----
     registerGuarded(defineTool({
         name: 'gotry_doctor',
-        description: 'Check optional-dependency health for ALL gotry tools (read-only by default). Coverage: GoTry Session Bridge extension / Agent Reach (.venv) / hbcli (hotel realtime) / FlyAI key + recent trial-quota exhaustion time / dsh-calendar mount state / dsh-better-sidebar / dsh-map-tools / dsh-tool-ask-user. '
+        description: 'Check optional-dependency health for ALL gotry tools (read-only by default). Coverage: Stai Travel Bridge extension / Agent Reach (.venv) / hbcli (hotel realtime) / FlyAI key + recent trial-quota exhaustion time / dsh-calendar mount state / dsh-better-sidebar / dsh-map-tools / dsh-tool-ask-user. '
             + 'Call this when ANY gotry tool returns not-installed / needs-setup, when the user asks 「体检/依赖状态/工具为什么不可用」, or BEFORE leaning on a channel for a plan. '
             + 'Returns per-item status (ok/degraded/missing) with exact fix commands. '
             + 'Action=diagnose (default): pure read-only — never installs anything, only renders the report. '
@@ -2355,6 +2370,7 @@ export function apply(ctx, config, seams = {}) {
             try {
                 r = await listArtifacts({
                     stateRoot: config.stateRoot ?? '.',
+                    handoffRoot: process.env.GOTRY_TURN_HANDOFF_ROOT ?? ((config.stateRoot ?? '.') === '.' ? sessionCwd(exec) ?? '.' : config.stateRoot),
                     cwd: sessionCwd(exec),
                     limit: q.limit,
                     offset: q.offset,
@@ -2448,7 +2464,7 @@ export function apply(ctx, config, seams = {}) {
                 throw new Error('gotry_artifacts_read requires path');
             if (!q.path)
                 return JSON.parse(JSON.stringify({ ok: false, error: 'path 必填(来自 gotry_artifacts_list)' }));
-            const r = await readArtifact({ stateRoot: config.stateRoot ?? '.', cwd: sessionCwd(exec), path: q.path, offset: q.offset, limit: q.limit });
+            const r = await readArtifact({ stateRoot: config.stateRoot ?? '.', handoffRoot: process.env.GOTRY_TURN_HANDOFF_ROOT ?? ((config.stateRoot ?? '.') === '.' ? sessionCwd(exec) ?? '.' : config.stateRoot), cwd: sessionCwd(exec), path: q.path, offset: q.offset, limit: q.limit });
             if (!r.ok)
                 return JSON.parse(JSON.stringify(r));
             // 身份/来源展示(issue #285 第 1 条「显示身份/来源」):行号视图保留 read 卡的