@danceiny/gotry 0.0.1-rc.9 → 0.2.0-rc.28

package/dist/src/gotry-backend.js

@@ -0,0 +1,125 @@
+/**
+ * gotry-backend 统一入口(founder 口径:「我只允许一个 gotry 包装出来的服务」)。
+ *
+ * 一个进程、一个 HTTP 服务面;能力 = 模块(booking-copilot、session-search,后续
+ * a2a 协议端口亦归此服务),模块自带鉴权/探活,内核只做路由分发。hotel-be 是
+ * 外层 BFF,只认本服务。
+ *
+ * 端口:GOTRY_BACKEND_PORT > GOTRY_BOOKING_COPILOT_PORT > 3082(向后兼容:
+ * 默认与既有 booking-copilot 部署同端口,路由合同不变,hotel-be BFF 零改动)。
+ *
+ * 环境变量:
+ *   booking-copilot 模块:GOTRY_BOOKING_COPILOT_API_KEY/STATE_ROOT/INGRESS_MODE/
+ *     ARTIFACT_ID + DEEPSEEK/LLM keys(dsh planner,同独立部署)
+ *   session-search 模块:GOTRY_BACKEND_SESSION_API_KEY(缺 = 该模块 fail-closed 503)、
+ *     GOTRY_SESSION_TRANSPORT=cdp、CHROME_USER_DATA_DIR、GOTRY_SESSION_AUDIT_PATH、
+ *     GOTRY_BACKEND_STATE_ROOT(桥作业账本根,缺省 '.';账本文件 <stateRoot>/gotry-state/bridge.db)
+ *
+ * 运行:node bin/gotry-backend.js(编译产物)或 tsx ts/src/gotry-backend.ts(源码形态)。
+ */
+import { startBookingCopilotModule } from './backend/modules/booking-copilot.js';
+import { startBookingExecutorModule } from './backend/modules/booking-executor.js';
+import { startSessionSearchModule } from './backend/modules/session-search.js';
+import { resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { closeBackend, createBackendServer } from './backend/kernel.js';
+/**
+ * #511:服务运行时启动阶段标记。四类启动标记(CORE_BOOT_STAGE/CORE_BOOT_FAILURE/
+ * HARNESS_BOOT_TIMEOUT/PLANNER_BOOT_TIMEOUT)此前只存在于构建期 proof 脚本输出,
+ * 服务进程从不打印——「复发即定位」在运行时面不成立。行形状与 proof 脚本同族
+ * (`标记 + JSON`),字段封闭(phase/module/port/elapsedMs),不含密钥/凭证。
+ */
+export function formatBackendBootStage(phase, detail) {
+    return `CORE_BOOT_STAGE ${JSON.stringify({ phase, ...detail })}`;
+}
+/** 启动失败行:数组形状与 booking-surface-package-proof 的 CORE_BOOT_FAILURE 对齐;error 只留有界摘要 */
+export function formatBackendBootFailure(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return `CORE_BOOT_FAILURE ${JSON.stringify([{ phase: 'startup', error: message.slice(0, 200) }])}`;
+}
+export function resolveGotryBackendPort(env) {
+    const raw = env.GOTRY_BACKEND_PORT ?? env.GOTRY_BOOKING_COPILOT_PORT;
+    if (raw === undefined)
+        return 3082;
+    if (!/^(?:0|[1-9][0-9]{0,4})$/.test(raw))
+        throw new Error('gotry_backend_invalid_port');
+    const port = Number(raw);
+    if (!Number.isSafeInteger(port) || port < 0 || port > 65_535)
+        throw new Error('gotry_backend_invalid_port');
+    return port;
+}
+export async function startGotryBackendFromEnvironment(env = process.env, log = (line) => { process.stderr.write(`${line}\n`); }) {
+    const bootStartedAt = Date.now();
+    const bootStage = (phase, detail) => {
+        try {
+            log(formatBackendBootStage(phase, { elapsedMs: Date.now() - bootStartedAt, ...detail }));
+        }
+        catch { /* 启动阶段行不反噬启动本身 */ }
+    };
+    // 失败标记也必须由本函数发:编译产物 bin/gotry-backend.js 包装层直接调用这里,
+    // 源码形态 runCli 的 catch 在 bin 形态不可达(#511 的失败面要在服务运行时可见)
+    const bootFailure = (error) => {
+        try {
+            log(formatBackendBootFailure(error));
+        }
+        catch { /* 同上 */ }
+    };
+    const modules = [];
+    try {
+        modules.push(await startBookingCopilotModule(env));
+        bootStage('module_mounted', { module: 'booking-copilot' });
+        modules.push(startSessionSearchModule({
+            apiKey: () => env.GOTRY_BACKEND_SESSION_API_KEY ?? '',
+            auditPath: env.GOTRY_SESSION_AUDIT_PATH,
+            // 批次 A「桥作业账本化」:挂载路径桥队列/在飞/节律/客户端注册落 SQLite
+            // (<stateRoot>/gotry-state/bridge.db),重启经 recoverOnBoot 收敛,不丢在飞作业。
+            stateRoot: env.GOTRY_BACKEND_STATE_ROOT ?? '.',
+        }));
+        bootStage('module_mounted', { module: 'session-search' });
+        modules.push(startBookingExecutorModule({
+            apiKey: () => env.GOTRY_BACKEND_BOOKING_API_KEY ?? '',
+            evidenceDir: () => env.GOTRY_BACKEND_EVIDENCE_DIR ?? '/var/lib/gotry-backend/booking-evidence',
+        }));
+        bootStage('module_mounted', { module: 'booking-executor' });
+        const handle = await createBackendServer({
+            modules,
+            host: env.GOTRY_BACKEND_HOST ?? '127.0.0.1',
+            port: resolveGotryBackendPort(env),
+        });
+        bootStage('listening', { port: handle.port, modules: handle.moduleNames.join(',') });
+        return {
+            port: handle.port,
+            moduleNames: handle.moduleNames,
+            close: () => closeBackend(handle, modules),
+        };
+    }
+    catch (error) {
+        bootFailure(error);
+        throw error;
+    }
+}
+async function runCli() {
+    const handle = await startGotryBackendFromEnvironment();
+    process.stderr.write(`[gotry-backend] listening on http://127.0.0.1:${handle.port}; modules=${handle.moduleNames.join(',')}\n`);
+    let stopping = false;
+    const stop = () => {
+        if (stopping)
+            return;
+        stopping = true;
+        void handle.close().then(() => process.exit(0), (error) => {
+            process.stderr.write(`[gotry-backend] shutdown failed: ${error instanceof Error ? error.message : String(error)}\n`);
+            process.exit(1);
+        });
+    };
+    process.once('SIGINT', stop);
+    process.once('SIGTERM', stop);
+}
+const invokedPath = process.argv[1] ? resolve(process.argv[1]) : '';
+if (invokedPath === fileURLToPath(import.meta.url)) {
+    runCli().catch((error) => {
+        // CORE_BOOT_FAILURE 标记已在 startGotryBackendFromEnvironment 的失败路径落过
+        // (#511);这里补源码 CLI 形态的可读行
+        process.stderr.write(`[gotry-backend] startup failed: ${error instanceof Error ? error.message : String(error)}\n`);
+        process.exit(1);
+    });
+}

package/dist/src/hotel-date-gate.js

@@ -0,0 +1,118 @@
+/**
+ * 酒店日期校验闸(issue #283):`gotry_hotel_search` 在派发供应商 CLI 前必须先确认
+ * 「完整、有效且退房晚于入住」。缺/空/单侧/类型错/不可解析/倒序/同日/不存在的日历
+ * 日期(如 2026-02-30、2026-13-01),任一命中即返回可行动的 input_required,
+ * 绝不发供应商命令。有效自然语言日期复用既有 `buildTimeAnchor` /
+ * `resolveSlotDate`(已含严格 ISO 校验),不动时间锚点/slot-spec/其它工具。
+ *
+ * 失败原因(顺序决策,一次问清):
+ *   missing(字段未传)> blank(空字符串)> type(非字符串)> unresolved(词表外/不存在的日历)> 倒序/同日
+ *   - 同侧 缺失 + 另一侧 空串 → 两端均报缺,两轮往返压成一次
+ *   - 五字段契约:reason(最小语义根因)/missing(需补齐的字段)/raw(用户原话)/message(可行动指引)/evidence(落账标签)
+ */
+import { buildTimeAnchor, isRealIsoDate } from './time-anchor.js';
+import { resolveSlotDate } from './slot-spec.js';
+/**
+ * 闸主入口。返回 success 表示闸通过,绝对日期可直接进入供应商查询;
+ * 返回 failure 表示闸失败,工具层应原样回传 input_required,不调 interpretEffect、
+ * 不写延迟日志。
+ */
+export function evaluateHotelStayDates(rawCheckIn, rawCheckOut, opts = {}) {
+    const anchor = buildTimeAnchor(opts.now ?? new Date());
+    const checkInStr = typeof rawCheckIn === 'string' ? rawCheckIn.trim() : '';
+    const checkOutStr = typeof rawCheckOut === 'string' ? rawCheckOut.trim() : '';
+    const raw = {
+        checkIn: typeof rawCheckIn === 'string' ? rawCheckIn : undefined,
+        checkOut: typeof rawCheckOut === 'string' ? rawCheckOut : undefined,
+    };
+    const checkInProvided = rawCheckIn !== undefined;
+    const checkOutProvided = rawCheckOut !== undefined;
+    const checkInIsString = typeof rawCheckIn === 'string';
+    const checkOutIsString = typeof rawCheckOut === 'string';
+    const checkInBlank = checkInIsString && checkInStr === '';
+    const checkOutBlank = checkOutIsString && checkOutStr === '';
+    const checkInTypeError = checkInProvided && !checkInIsString;
+    const checkOutTypeError = checkOutProvided && !checkOutIsString;
+    // 两端均缺失或一侧缺失+另一侧空串 → 一次报齐缺的两侧(避免两轮往返)
+    const bothNeedQuery = !checkInProvided && (!checkOutProvided || checkOutBlank)
+        || !checkOutProvided && (!checkInProvided || checkInBlank);
+    // 两端均空字符串(都已传但都是空串) → 同样报齐
+    if (bothNeedQuery || (checkInBlank && checkOutBlank)) {
+        const reason = !checkInProvided || checkInBlank ? 'check_in_blank' : 'check_out_blank';
+        return fail(reason, ['checkIn', 'checkOut'], '请告诉 gotry 入住日和退房日(具体日期,例如 2026-09-18);完整、有效且退房晚于入住才能查询酒店,缺一不查', `[hotel-date-gate@input_required:${reason}:both]`, raw);
+    }
+    // 单侧缺失(另一侧已正常传入) → 报缺的一侧
+    if (!checkInProvided) {
+        return fail('check_in_missing', ['checkIn'], '请告诉 gotry 入住日(具体日期,例如 2026-09-18);退房日已收到,但缺入住日无法判定窗口', '[hotel-date-gate@input_required:check_in_missing]', raw);
+    }
+    if (!checkOutProvided) {
+        return fail('check_out_missing', ['checkOut'], '请告诉 gotry 退房日(具体日期,例如 2026-09-20);入住日已收到,但缺退房日无法判定窗口', '[hotel-date-gate@input_required:check_out_missing]', raw);
+    }
+    // 类型错误(字段已传但不是字符串) → 按 blank 同形 + 标注类型,提示用户形态
+    if (checkInTypeError) {
+        return fail('check_in_blank', ['checkIn'], '入住日格式不对(应为日期字符串,例如 2026-09-18)——请向用户确认具体日期', '[hotel-date-gate@input_required:check_in_blank:type]', raw);
+    }
+    if (checkOutTypeError) {
+        return fail('check_out_blank', ['checkOut'], '退房日格式不对(应为日期字符串,例如 2026-09-20)——请向用户确认具体日期', '[hotel-date-gate@input_required:check_out_blank:type]', raw);
+    }
+    // 单侧空字符串(另一侧已正常传入)
+    if (checkInBlank) {
+        return fail('check_in_blank', ['checkIn'], '请告诉 gotry 入住日(具体日期,例如 2026-09-18);不要留空,不要猜日期', '[hotel-date-gate@input_required:check_in_blank]', raw);
+    }
+    if (checkOutBlank) {
+        return fail('check_out_blank', ['checkOut'], '请告诉 gotry 退房日(具体日期,例如 2026-09-20);不要留空,不要猜日期', '[hotel-date-gate@input_required:check_out_blank]', raw);
+    }
+    // 解析:复用 slot-spec 词表;词表外/不存在的日历日 → unresolved
+    const inRes = resolveSlotDate(checkInStr, anchor);
+    const outRes = resolveSlotDate(checkOutStr, anchor);
+    // 终消费层严格校验(issue #283 红线):resolveSlotDate 的 +N 算术(addDaysYmd) 可能
+    // 溢出产生 Invalid Date("NaN-NaN-NaN"),或 JS 自动进位跨千年("10000-01-01")。
+    // 词表外/不存在的日历日/算术溢出 一律归 unresolved,不发供应商命令。
+    if (inRes.kind === 'unresolved' || !isStrictIsoYmd(inRes.date)) {
+        return fail('check_in_unresolved', ['checkIn'], `入住日「${inRes.raw}」不是合法的具体日期——请给完整日期(例如 2026-09-18);不接受「近期」「明天之前」这类模糊表达,也不接受 2026-02-30 这类不存在的日历日`, '[hotel-date-gate@input_required:check_in_unresolved]', raw);
+    }
+    if (outRes.kind === 'unresolved' || !isStrictIsoYmd(outRes.date)) {
+        return fail('check_out_unresolved', ['checkOut'], `退房日「${outRes.raw}」不是合法的具体日期——请给完整日期(例如 2026-09-20);不接受「近期」「下周末」这类模糊表达,也不接受 2026-13-01 这类不存在的日历日`, '[hotel-date-gate@input_required:check_out_unresolved]', raw);
+    }
+    // 退房必须晚于入住;同日视为 0 晚
+    if (outRes.date <= inRes.date) {
+        const sameDay = outRes.date === inRes.date;
+        return fail('check_out_not_after_check_in', ['checkOut'], sameDay
+            ? `退房日(${outRes.date})与入住日(${inRes.date})相同,0 晚没有意义——请告诉 gotry 退房日应该晚于入住日`
+            : `退房日(${outRes.date})早于入住日(${inRes.date}),顺序反了——请告诉 gotry 正确的退房日(应该晚于入住)`, sameDay
+            ? '[hotel-date-gate@input_required:check_out_not_after_check_in:same_day]'
+            : '[hotel-date-gate@input_required:check_out_not_after_check_in:reversed]', raw);
+    }
+    // 通过:绝对日期已就位;slot 解析过程产生的原话 → 绝对日期 注记回显
+    const notes = [];
+    if (inRes.raw !== inRes.date)
+        notes.push(`slot-resolved: ${inRes.raw} → ${inRes.date}`);
+    if (outRes.raw !== outRes.date)
+        notes.push(`slot-resolved: ${outRes.raw} → ${outRes.date}`);
+    return { ok: true, checkIn: inRes.date, checkOut: outRes.date, notes };
+}
+function fail(reason, missing, message, evidence, raw) {
+    return { ok: false, verdict: 'input_required', reason, missing, raw, message, evidence };
+}
+/**
+ * 闸终消费层严格校验(issue #283 红线第二层,parseAbsoluteDate 词表口径之外):
+ *   1. 必须是字符串且匹配 `YYYY-MM-DD`(4-2-2 数字,前导零),拒 null/NaN/越界格式
+ *      (addDaysYmd 溢出产生 "NaN-NaN-NaN",JS 自动进位跨千年产生 "10000-01-01")。
+ *   2. 年份 1-9999;复用 `isRealIsoDate` 拒不存在的日历日(2026-02-30 / 2025-02-29 等)。
+ * 仅供 evaluateHotelStayDates 在 resolveSlotDate 返回后使用;其它层不要复用此 helper。
+ */
+function isStrictIsoYmd(s) {
+    if (typeof s !== 'string')
+        return false;
+    const m = s.match(/^(\d{4})-(\d{2})-(\d{2})$/);
+    if (!m)
+        return false;
+    const y = Number(m[1]);
+    const mo = Number(m[2]);
+    const d = Number(m[3]);
+    if (!Number.isFinite(y) || !Number.isFinite(mo) || !Number.isFinite(d))
+        return false;
+    if (y < 1 || y > 9999)
+        return false;
+    return isRealIsoDate(y, mo, d);
+}

package/dist/src/i18n.js

@@ -0,0 +1,88 @@
+/**
+ * i18n 消息目录(README Known limitation「zh-CN 体验」的工程清偿件):
+ * GoTry 自有「确定性输出面」= 求解 answer_md(候选/航班链两渲染)+ 放宽建议文案
+ * + 排除理由。LLM 人格面(对话语言)由模型跟随用户语言,不在此层。
+ *
+ * 契约:
+ *   - 默认 `zh-CN`,模板与历次金标准逐字节一致(engine/unified 金标准套件即回归闸);
+ *   - `GOTRY_LOCALE=en`(或 setLocale)切英文;键缺失回退 zh 再回退键名——en 目录不齐不算错;
+ *   - 插值 `{var}`;数字/时刻在调用点格式化,catalog 只管词序与措辞。
+ */
+const ZH = {
+    'md.header': '> 憧憬:{note}',
+    'md.constraints': '> 已识别约束:窗口 {days} 天 | 预算 ¥{budget} | 动机(休整改写需求 {hours}h 有效休整)',
+    'md.infeasible': '**{name}:现在不行**——冲突约束:{core}。',
+    'md.relax_one': '- 放宽 {relax}:约 ¥{money}',
+    'md.wish_pool': '- 已放入「下一次出发」清单:需要 {days} 天{budgetNote}{season}',
+    'md.wish_budget': '、约 ¥{cny}',
+    'md.wish_season': ',{months} 月最佳',
+    'md.feasible_engine': '**{name}:可行**({id} {dep} 出发,{mode} 接驳,{arrive} 到住处,起床 {wake},到达精力 {energy}%,门到门 {d2d},有效休整 {hours}h,共 ¥{money})',
+    'md.feasible_unified': '**{name}:可行**({svc} 出发,{mode} 接驳,起床 {wake},到达精力 {energy}%,门到门 {d2d},有效休整 {hours}h,共 ¥{money})',
+    'md.recommend': '**建议:{best}**(意象匹配 {match}%)。',
+    'md.alt': '备选:{name}(¥{money},匹配 {match}%)。',
+    'md.decide_two': '**待你决定的两个问题**:',
+    'md.q_choice': '1. {a} 还是 {b}?(前者更贴意象,后者更省)',
+    'md.q_single': '1. 就去 {name} 吗?',
+    'md.q_none': '1. 所有候选都不可行——考虑放宽哪条约束?',
+    'md.q_wish': '2. 把 {name} 留给「下一次出发」({days} 天起),这次先去可行的?',
+    'md.q_depart': '2. 出发班次选 {id}({dep})还是更晚的?',
+    'sg.duration': '把行程延长到 {days} 天({name} 值得这个窗口)',
+    'sg.budget': '预算提高到 ¥{cost}(原 ¥{budget})',
+    'sg.wake_floor': '接受 {wake} 起床——破坏生物钟,与你的休整动机冲突,不推荐',
+    'sg.energy_floor': '接受到达精力 {pct}%(低于你要求的 {min}%)',
+    'sg.usable_hours': '接受有效休整 {hours}h(低于动机所需的 {need}h)',
+    'sg.arrival': '接受 {time} 才到住处',
+    'sg.plan': '可行方案:{id} {dep} 出发、{mode} 接驳,¥{money},{wake} 起床,{arrive} 到住处,到达精力 {percent}%',
+    'sg.wish_reason_engine': '动机谱系 {weights} 下,{days} 天窗口装不下这个目的地',
+    'sg.wish_reason_window': '{days} 天窗口装不下(目的需 {minDays} 天)',
+    'un.workwindow_reason': '周{wd} {dep} 起飞落在工作窗口(当地 {start}-{end})内',
+    'un.workwindow_unresolvable_reason': 'home zone 投影失败:{reason}',
+    'un.redflag_redeye': '{leg} 落地精力仅 {pct}%(红眼后直奔事务,当日不宜安排重要会议)',
+};
+const EN = {
+    'md.header': '> Aspiration: {note}',
+    'md.constraints': '> Constraints captured: {days}-day window | budget ¥{budget} | motivation (needs {hours}h of usable rest)',
+    'md.infeasible': '**{name}: not yet** — conflicting constraints: {core}.',
+    'md.relax_one': '- Relax {relax}: about ¥{money}',
+    'md.wish_pool': '- Added to the "next departure" list: needs {days} days{budgetNote}{season}',
+    'md.wish_budget': ', about ¥{cny}',
+    'md.wish_season': ', best in months {months}',
+    'md.feasible_engine': '**{name}: feasible** ({id} departs {dep}, {mode} transfer, at your stay by {arrive}, wake {wake}, arrival energy {energy}%, door-to-door {d2d}, {hours}h of real rest, total ¥{money})',
+    'md.feasible_unified': '**{name}: feasible** ({svc} departs, {mode} transfer, wake {wake}, arrival energy {energy}%, door-to-door {d2d}, {hours}h of real rest, total ¥{money})',
+    'md.recommend': '**Suggestion: {best}** (imagery match {match}%).',
+    'md.alt': 'Alternative: {name} (¥{money}, match {match}%).',
+    'md.decide_two': '**Two decisions for you**:',
+    'md.q_choice': '1. {a} or {b}? (former fits the vision, latter saves more)',
+    'md.q_single': '1. Go with {name}?',
+    'md.q_none': '1. All candidates are infeasible — which constraint to relax?',
+    'md.q_wish': '2. Keep {name} for the "next departure" ({days}+ days) and go feasible this time?',
+    'md.q_depart': '2. Departure: {id} ({dep}) or later?',
+    'sg.duration': 'Extend the trip to {days} days ({name} deserves this window)',
+    'sg.budget': 'Raise budget to ¥{cost} (was ¥{budget})',
+    'sg.wake_floor': 'Accept a {wake} wake-up — wrecks your body clock, conflicts with your rest motivation, not recommended',
+    'sg.energy_floor': 'Accept arrival energy {pct}% (below your required {min}%)',
+    'sg.usable_hours': 'Accept {hours}h of usable rest (below the {need}h your motivation needs)',
+    'sg.arrival': 'Accept reaching your stay only at {time}',
+    'sg.plan': 'Feasible plan: {id} departs {dep}, {mode} transfer, ¥{money}, wake {wake}, at your stay {arrive}, arrival energy {percent}%',
+    'sg.wish_reason_engine': 'under motivation weights {weights}, a {days}-day window cannot fit this destination',
+    'sg.wish_reason_window': '{days}-day window cannot fit (the purpose needs {minDays} days)',
+    'un.workwindow_reason': 'Departs {dep} on weekday {wd}, inside your work window (local {start}-{end})',
+    'un.workwindow_unresolvable_reason': 'home zone projection failed: {reason}',
+    'un.redflag_redeye': '{leg} lands with only {pct}% energy (red-eye then straight to business — no big meetings that day)',
+};
+let locale = process.env['GOTRY_LOCALE'] === 'en' ? 'en' : 'zh-CN';
+export function getLocale() {
+    return locale;
+}
+export function setLocale(l) {
+    locale = l;
+}
+/** 词条渲染:en 缺键回退 zh,再回退键名;插值 {var},缺变量原样保留 `{var}`。 */
+export function t(key, vars = {}) {
+    const tpl = (locale === 'en' ? EN[key] : undefined) ?? ZH[key] ?? String(key);
+    return tpl.replace(/\{(\w+)\}/g, (_, k) => (k in vars ? String(vars[k]) : `{${k}}`));
+}
+/** en 目录完备性检查:缺键即列出(测试闸用,运行时回退而非抛错) */
+export function enCoverage() {
+    return Object.keys(ZH).filter(k => EN[k] === undefined);
+}