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

package/bin/gotry-process-liveness.d.ts

@@ -0,0 +1,27 @@
+import type { ChildProcess, SpawnOptions } from 'node:child_process'
+
+export interface OwnedChild {
+  child: ChildProcess
+  groupPid: number | null
+}
+
+export interface OwnedChildCleanupResult {
+  childExited: boolean
+  groupEmpty: boolean
+  forced: boolean
+}
+
+export interface OwnedChildCleanupOptions {
+  child?: ChildProcess | null
+  groupPid?: number | null
+  signal?: NodeJS.Signals
+  termGraceMs?: number
+  killWaitMs?: number
+}
+
+export declare function spawnOwnedChild(command: string, args: readonly string[], options?: SpawnOptions): OwnedChild
+export declare function signalOwnedChild(child: ChildProcess | null | undefined, signal: NodeJS.Signals, groupPid?: number | null): void
+export declare function isOwnedProcessGroupEmpty(groupPid: number | null): boolean
+export declare function waitForOwnedChildQuiescence(child: ChildProcess, groupPid?: number | null, timeoutMs?: number): Promise<boolean>
+export declare function terminateOwnedChild(options?: OwnedChildCleanupOptions): Promise<OwnedChildCleanupResult>
+export declare const PROCESS_LIVENESS_BOUNDS: Readonly<{ termGraceMs: number; killWaitMs: number }>

package/bin/gotry-process-liveness.js

@@ -0,0 +1,97 @@
+/**
+ * GoTry-owned lifecycle for one externally spawned dsh child.
+ *
+ * The dsh CLI is an external process boundary. On POSIX we make it the
+ * leader of its own process group so a parent-only signal or a failed dsh
+ * child cannot strand descendants. This module owns only bounded signalling
+ * and quiescence observation; incident formatting remains in the existing
+ * GoTry incident writer.
+ */
+
+import { spawn } from 'node:child_process'
+
+const DEFAULT_TERM_GRACE_MS = 5_000
+const DEFAULT_KILL_WAIT_MS = 1_000
+const POLL_MS = 20
+
+/** Spawn a child in a private process group where the host supports it. */
+export function spawnOwnedChild(command, args, options = {}) {
+  const child = spawn(command, args, {
+    ...options,
+    detached: process.platform !== 'win32',
+  })
+  return {
+    child,
+    groupPid: process.platform !== 'win32' ? (child.pid ?? null) : null,
+  }
+}
+
+/** Signal the child group, falling back to the direct child when necessary. */
+export function signalOwnedChild(child, signal, groupPid = null) {
+  if (!child) return
+  if (process.platform !== 'win32' && groupPid !== null) {
+    try {
+      process.kill(-groupPid, signal)
+      return
+    } catch {
+      // The group can disappear between observation and delivery. Try the
+      // direct handle as a best-effort race fallback.
+    }
+  }
+  try { child.kill(signal) } catch { /* exit races are contained */ }
+}
+
+function childExited(child) {
+  return child.exitCode !== null || child.signalCode !== null
+}
+
+function groupEmpty(groupPid) {
+  if (process.platform === 'win32' || groupPid === null) return true
+  try {
+    process.kill(-groupPid, 0)
+    return false
+  } catch (error) {
+    return error?.code === 'ESRCH'
+  }
+}
+
+/** Expose the same group-emptiness fact used by the bounded cleanup proof. */
+export function isOwnedProcessGroupEmpty(groupPid) {
+  return groupEmpty(groupPid)
+}
+
+/** Wait for the direct child and, on POSIX, its whole private group. */
+export async function waitForOwnedChildQuiescence(child, groupPid = null, timeoutMs = DEFAULT_TERM_GRACE_MS) {
+  const deadline = Date.now() + timeoutMs
+  while (Date.now() <= deadline) {
+    if (childExited(child) && groupEmpty(groupPid)) return true
+    await new Promise((resolve) => setTimeout(resolve, POLL_MS))
+  }
+  return childExited(child) && groupEmpty(groupPid)
+}
+
+/**
+ * Bounded TERM → KILL cleanup for one owned child group. It resolves only
+ * after the direct child and group are observed empty, or after the bound.
+ */
+export async function terminateOwnedChild({
+  child,
+  groupPid = null,
+  signal = 'SIGTERM',
+  termGraceMs = DEFAULT_TERM_GRACE_MS,
+  killWaitMs = DEFAULT_KILL_WAIT_MS,
+} = {}) {
+  if (!child) return { childExited: true, groupEmpty: true, forced: false }
+  signalOwnedChild(child, signal, groupPid)
+  if (await waitForOwnedChildQuiescence(child, groupPid, termGraceMs)) {
+    return { childExited: true, groupEmpty: true, forced: false }
+  }
+  signalOwnedChild(child, 'SIGKILL', groupPid)
+  const empty = await waitForOwnedChildQuiescence(child, groupPid, killWaitMs)
+  return { childExited: childExited(child), groupEmpty: empty, forced: true }
+}
+
+export const PROCESS_LIVENESS_BOUNDS = Object.freeze({
+  termGraceMs: DEFAULT_TERM_GRACE_MS,
+  killWaitMs: DEFAULT_KILL_WAIT_MS,
+})

package/bin/gotry-runtime-resolution.d.ts

@@ -0,0 +1,27 @@
+export type DshResolver = {
+  resolve(specifier: string): string
+}
+
+export type DshRuntime = {
+  bin: string
+  version: string
+  source: 'root'
+}
+
+export const REQUIRED_BENCHMARK_DSH_VERSION: '0.2.0-rc.2'
+
+export function readDshPackage(bin: string): Omit<DshRuntime, 'source'> | null
+export function resolveDshPackage(resolver: DshResolver): Omit<DshRuntime, 'source'> | null
+export function supportsNodeVersion(version: string): boolean
+export function selectDshRuntime(options: {
+  repoRoot: string
+  rootResolver: DshResolver
+  benchmark: boolean
+}): DshRuntime | null
+export function benchmarkRuntimeSupported(runtime: { version: string } | null): boolean
+export function selectDshCwd(options: {
+  repoRoot: string
+  invocationCwd: string
+  sourceCheckoutMode: boolean
+  benchmark: boolean
+}): string

package/bin/gotry-runtime-resolution.js

@@ -0,0 +1,49 @@
+import { readFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+
+export const REQUIRED_BENCHMARK_DSH_VERSION = '0.2.0-rc.2'
+
+export function readDshPackage(bin) {
+  try {
+    const packageJson = join(dirname(dirname(bin)), 'package.json')
+    const metadata = JSON.parse(readFileSync(packageJson, 'utf8'))
+    return typeof metadata.version === 'string' ? { bin, version: metadata.version } : null
+  } catch {
+    return null
+  }
+}
+
+export function resolveDshPackage(resolver) {
+  try {
+    return readDshPackage(resolver.resolve('@deepseek-ai/dsh/lib/bin.js'))
+  } catch {
+    return null
+  }
+}
+
+export function supportsNodeVersion(version) {
+  const match = /^(\d+)\.(\d+)/.exec(version)
+  if (!match) return false
+  const major = Number(match[1])
+  const minor = Number(match[2])
+  return major > 22 || (major === 22 && minor >= 15)
+}
+
+export function selectDshRuntime({ rootResolver }) {
+  const root = resolveDshPackage(rootResolver)
+  if (root) return { ...root, source: 'root' }
+  // D-27 清偿(issue #120):legacy vendored 回退路径已移除——该形态的 Node 兼容窗口
+  // 断裂(Round 5 起「不承诺可运行」),解析成功只会把「dsh 缺失」变成下游玄学失败。
+  // 唯一受支持形态 = root manifest / 依赖解析(232 精确依赖闭包);找不到即 fail-closed,
+  // 由调用方给明确重装指引。benchmark 原本就禁用回退,语义不变(入参保留以稳调用面)。
+  return null
+}
+
+export function benchmarkRuntimeSupported(runtime) {
+  return runtime?.version === REQUIRED_BENCHMARK_DSH_VERSION
+}
+
+export function selectDshCwd({ repoRoot, invocationCwd, sourceCheckoutMode, benchmark }) {
+  if (sourceCheckoutMode && !benchmark) return join(repoRoot, 'ts/dsh-runtime')
+  return invocationCwd
+}

package/bin/gotry.js

@@ -17,7 +17,7 @@ if [ -z "$conf" ] || [ ! -x "$conf" ]; then
 fi
 if [ -z "$conf" ] || [ ! -x "$conf" ]; then
   cat >&2 <<'EOF'
-gotry: node not found in PATH. Install Node 22+:
+gotry: node not found in PATH. Install Node 22.15+:
   macOS:  brew install node@22  (or use nvm)
   Linux:  https://nodejs.org/
 

package/client/client.js

@@ -0,0 +1,203 @@
+/*
+ * GoTry's public DSH Web client half.
+ *
+ * This is a lazy-CJS browser bundle. The host serves it through the exact
+ * `./client` export and DSH materializes it with the platform React module.
+ * The Client receives the frozen `block` from the runtime; Host
+ * presentationMeta/presentResult values are not available here.
+ */
+window.__ModuleLoader__.load({
+  id: '@danceiny/gotry',
+  factory: (require) => {
+    var module = { exports: {} }
+    var exports = module.exports
+    var React = require('react')
+
+    function element(type, props, children) {
+      return React.createElement(type, props, ...(Array.isArray(children) ? children : [children]))
+    }
+
+    function object(value) {
+      return value !== null && typeof value === 'object' && !Array.isArray(value) ? value : null
+    }
+
+    function isSettled(block) {
+      return object(block)?.kind === 'tool-result'
+    }
+
+    function resultText(block) {
+      var content = Array.isArray(block?.content) ? block.content : []
+      var text = content.map(function (item) {
+        return item && item.type === 'text' && typeof item.text === 'string' ? item.text : JSON.stringify(item)
+      }).filter(Boolean).join('\n')
+      var error = object(block?.error)
+      if (!text && error) text = String(error.name || 'Tool error') + ': ' + String(error.code || 'unknown')
+      return text
+    }
+
+    function stateOf(block) {
+      if (!isSettled(block)) return 'running'
+      return block.isError ? 'error' : 'ok'
+    }
+
+    function metaOf(block) {
+      return object(block?.meta)
+    }
+
+    function shellProps(type, state) {
+      return {
+        'data-gotry-artifact-card': type,
+        'data-gotry-artifact-state': state,
+        role: 'region',
+        'aria-label': type === 'list' ? 'GoTry artifacts' : 'GoTry artifact preview',
+        style: {
+          border: '1px solid var(--dsw-alias-border-l1, rgba(127,127,127,.35))',
+          borderRadius: '12px',
+          margin: '6px 0',
+          overflow: 'hidden',
+          background: 'var(--dsw-alias-bg-layer-3, rgba(127,127,127,.05))',
+        },
+      }
+    }
+
+    function statusLine(state, type) {
+      if (state === 'running') return type === 'list' ? '正在查找产物…' : '正在读取产物…'
+      if (state === 'error') return type === 'list' ? '产物列表读取失败' : '产物预览失败'
+      return type === 'list' ? '可打开的 GoTry 产物' : '产物预览'
+    }
+
+    function isHtmlPath(path) {
+      return typeof path === 'string' && /\.(html|htm)$/i.test(path)
+    }
+
+    function ArtifactListCard(props) {
+      var block = props.block
+      var state = stateOf(block)
+      var meta = metaOf(block)
+      var selectedState = React.useState(null)
+      var selected = selectedState[0]
+      var setSelected = selectedState[1]
+      var valid = state === 'ok' && meta && meta.shape === 'paths' && Array.isArray(meta.paths) &&
+        meta.paths.every(function (path) { return typeof path === 'string' && path.length > 0 }) &&
+        typeof meta.total === 'number' && Number.isInteger(meta.total) && meta.total >= 0 &&
+        typeof meta.truncated === 'boolean'
+      var text = resultText(block)
+      var children = [element('div', { style: { padding: '10px 14px 4px', fontWeight: 600 } }, statusLine(state, 'list'))]
+      if (state === 'running') {
+        children.push(element('p', { 'data-gotry-artifact-status': 'running', style: { padding: '0 14px 12px', margin: 0 } }, '等待运行时返回路径…'))
+      } else if (state === 'error') {
+        children.push(element('p', { 'data-gotry-artifact-status': 'error', style: { padding: '0 14px 12px', margin: 0, color: 'var(--dsw-alias-state-error-primary, #c44)' } }, text || '未知错误'))
+      } else if (!valid) {
+        children.push(element('p', { 'data-gotry-artifact-status': 'malformed', style: { padding: '0 14px 12px', margin: 0, color: 'var(--dsw-alias-state-error-primary, #c44)' } }, '产物列表数据格式异常，已降级显示原始结果。'))
+        if (text) children.push(element('pre', { style: { whiteSpace: 'pre-wrap', padding: '0 14px 12px', margin: 0 } }, text))
+      } else {
+        var list = meta.paths.map(function (path) {
+          var isSelected = selected === path
+          var htmlPreview = isHtmlPath(path)
+          var buttonProps = {
+            type: 'button',
+            'data-gotry-artifact-path': path,
+            'aria-pressed': isSelected,
+            onClick: function () {
+              setSelected(path)
+              if (typeof props.openFile === 'function') props.openFile(path)
+            },
+            style: {
+              color: 'var(--dsw-alias-accent, #4f8cff)',
+              background: 'none',
+              border: 0,
+              padding: 0,
+              cursor: 'pointer',
+              textAlign: 'left',
+              textDecoration: isSelected ? 'underline' : 'none',
+            },
+          }
+          var label = path
+          if (htmlPreview) {
+            buttonProps['data-gotry-artifact-open'] = 'html-preview'
+            buttonProps['aria-label'] = 'Open HTML preview ' + path
+            buttonProps.title = '打开 HTML 预览：这是可直接查看的网页文件，其中的脚本可能会运行；只想看源码请用读取结果里的文本视图。'
+            label = [
+              element('span', { key: 'path' }, path),
+              element('span', {
+                key: 'badge',
+                'data-gotry-artifact-badge': 'html-preview',
+                style: {
+                  marginLeft: '6px', padding: '0 6px', borderRadius: '999px',
+                  border: '1px solid currentColor', fontSize: '11px', opacity: .75,
+                },
+              }, 'HTML 预览'),
+            ]
+          } else {
+            buttonProps['data-gotry-artifact-open'] = 'artifact'
+            buttonProps['aria-label'] = 'Open artifact ' + path
+          }
+          return element('li', { key: path, style: { margin: '4px 0' } }, element('button', buttonProps, label))
+        })
+        children.push(element('div', { style: { padding: '0 14px 10px', color: 'var(--dsw-alias-label-secondary, #888)' } },
+          '共 ' + String(meta.total) + ' 项' + (meta.truncated ? '（已截断）' : '')))
+        children.push(element('ul', { 'data-gotry-artifact-paths': 'true', style: { margin: '0', padding: '0 14px 12px 34px' } }, list))
+        if (selected) children.push(element('div', { 'data-gotry-artifact-selection': selected, style: { padding: '0 14px 12px', fontSize: '12px' } }, '已选择：' + selected))
+      }
+      return element('section', shellProps('list', state), children)
+    }
+
+    function ArtifactReadCard(props) {
+      var block = props.block
+      var state = stateOf(block)
+      var meta = metaOf(block)
+      var validLines = Array.isArray(meta?.lines) && meta.lines.every(function (line) {
+        return object(line) && Number.isInteger(line.number) && typeof line.text === 'string'
+      })
+      var valid = state === 'ok' && typeof meta?.path === 'string' && meta.path !== '' &&
+        Number.isInteger(meta?.offset) && meta.offset >= 1 && Number.isInteger(meta?.totalLines) &&
+        meta.totalLines >= 0 && validLines
+      var text = resultText(block)
+      var htmlSource = valid && meta.lang === 'html'
+      var header = htmlSource ? 'HTML 源码预览（只读文本）' : statusLine(state, 'read')
+      var children = [element('div', { style: { padding: '10px 14px 4px', fontWeight: 600 } }, header)]
+      if (state === 'running') {
+        children.push(element('p', { 'data-gotry-artifact-status': 'running', style: { padding: '0 14px 12px', margin: 0 } }, '等待运行时返回文件内容…'))
+      } else if (state === 'error') {
+        children.push(element('p', { 'data-gotry-artifact-status': 'error', style: { padding: '0 14px 12px', margin: 0, color: 'var(--dsw-alias-state-error-primary, #c44)' } }, text || '未知错误'))
+      } else if (!valid) {
+        children.push(element('p', { 'data-gotry-artifact-status': 'malformed', style: { padding: '0 14px 12px', margin: 0, color: 'var(--dsw-alias-state-error-primary, #c44)' } }, '产物预览数据格式异常，已降级显示原始结果。'))
+        if (text) children.push(element('pre', { style: { whiteSpace: 'pre-wrap', padding: '0 14px 12px', margin: 0 } }, text))
+      } else {
+        var version = typeof meta.version === 'string' && meta.version ? meta.version : 'content-refresh'
+        children.push(element('div', { 'data-gotry-artifact-identity': 'true', style: { padding: '0 14px 8px', fontSize: '12px', color: 'var(--dsw-alias-label-secondary, #888)' } },
+          '来源：' + String(meta.source || 'unknown') + ' · ' + meta.path + ' · ' + String(meta.totalLines) + ' 行 · 版本：' + version))
+        children.push(element('div', { 'data-gotry-artifact-version': version, style: { padding: '0 14px 12px', fontFamily: 'var(--ds-font-family-code, monospace)', fontSize: '13px', lineHeight: '21px', overflowX: 'auto' } },
+          meta.lines.map(function (line) {
+            return element('div', { key: String(line.number), 'data-gotry-artifact-line': String(line.number), style: { display: 'grid', gridTemplateColumns: '4em 1fr', whiteSpace: 'pre' } }, [
+              element('span', { key: 'number', 'aria-hidden': 'true', style: { color: 'var(--dsw-alias-label-caption, #999)', userSelect: 'none', textAlign: 'right', paddingRight: '12px' } }, String(line.number)),
+              element('span', { key: 'text' }, line.text || ' '),
+            ])
+          })))
+      }
+      var shell = shellProps('read', state)
+      if (htmlSource) shell['data-gotry-artifact-source'] = 'html'
+      return element('section', shell, children)
+    }
+
+    function ArtifactToolView(props) {
+      if (props.toolName === 'gotry_artifacts_list') return ArtifactListCard(props)
+      return ArtifactReadCard(props)
+    }
+
+    function apply(ctx) {
+      ctx.inject(['slots'], function (scope) {
+        scope.slots.inject('tool.call.toolview', function () {
+          return scope.slots.register({ name: 'tool.call.toolview', key: 'gotry_artifacts_list' }, ArtifactToolView)
+        })
+        scope.slots.inject('tool.call.toolview', function () {
+          return scope.slots.register({ name: 'tool.call.toolview', key: 'gotry_artifacts_read' }, ArtifactToolView)
+        })
+      })
+    }
+
+    exports.apply = apply
+    exports.inject = []
+    return module.exports
+  },
+})

package/cordis.gotry-patch.yml

@@ -1,7 +1,7 @@
 # GoTry × dsh 成品组合(DeepSeek 原生——创始人官方 key)
 # 用法(在仓库根或 gotry 安装目录):
 #   DEEPSEEK_API_KEY=<key> dsh web --patch ./cordis.gotry-patch.yml
-#   (从 npm 安装: npx gotry web 自动应用本 patch)
+#   (从 npm 安装: npx @danceiny/gotry web 自动应用本 patch)
 - insert:
     - id: gotry-tools
       name: 'placeholder/ts/src/index.ts'   # 占位:bin/gotry-inner.js 运行时
@@ -17,15 +17,23 @@
     # {ask-user-insert} ← inner 运行时填充(dsh-user-questions 服务 + ask_user_question
     # 工具,结构化澄清卡);解析失败整块剔除
 
-# 注:insert 里 dsh-map-tools 的 name 是占位符,bin/gotry-inner.js 运行时重写为
-# 绝对路径(repo=vendored runtime;npm=依赖解析,裸包名绕 exports 子路径限制);
-# 依赖缺失时该条目整块剔除,不挡启动。地图/路线/POI 工具,零 key 走 OSRM/OSRM。
+# 注:insert 里 dsh-map-tools 的 name 是占位符,bin/gotry-inner.js 运行时优先重写为
+# 随包 ts/dsh-runtime/vendor/dsh-map-tools/lib/index.js 的绝对路径(source/package
+# 均可用;旧 source/npm 依赖路径仅作兼容回退)。payload 缺失时该条目整块剔除,
+# 不挡启动。地图/路线/POI 工具,零 key 走 OSM/OSRM。
 
 # GoTry 成品人格:行为契约=产品语义
+# 注:target dsh-system-prompt Config 公开读取 personaPrefix / personaSuffix;
+# legacy persona 键不投影,需改用目标键。
+# 2026-09-11 瘦身(M4 人格校准线,founder 指令):23→13 条,窄域细则去重归位——
+# 渠道 setup→gotry_agent_reach 描述、会话授权/登录→gotry_session_search/login 描述、
+# 可下单事实细则→gotry_fact_gate 描述(均原文已在,persona 纯重复);persona 只留
+# 跨场景行为契约。回归锚见 ts/scripts/persona-surface-guard-tests.ts。
 - id: system-prompt
   config:
-    persona: >-
+    personaPrefix: >-
       你是 GoTry——从出发到下一次出发的 AI 旅行伙伴(中国出境首发,workation 场景)。
+      下面每条契约都来自真实会话的失败或同题横评证据,没有一条是装饰。
       今天是 {{current_date}}。时间锚点卡(相对日期换算的唯一依据,一律查卡不自算):
       {{time_anchor_card}}
       用户记忆 brief(空 = 首访,按 (1) 访谈;非空 = 回访——已答字段不重复问,
@@ -33,54 +41,70 @@
       {{motivation_brief}}
       行为契约:
       (1)动机先行:首轮必问工作窗口(几点到几点/什么时区)与已订资源(航班/酒店);
-      (2)日历一次断言:日期换算以锚点卡为准并记住,冲突让用户裁决,永不重算;
-      (3)翻译不造数:班次/价格只来自工具(gotry_feasibility_check/gotry_skeleton_check/gotry_hotel_search);
-      (4)判定归引擎:可行性/全成本由工具计算,你只解释;
-      (5)待决=选择题:优先用 ask_user_question 工具发结构化选项(2-3 个带 trade-off,
-      web 界面渲染成卡片;该工具不可用或无响应时退化为文本选择题);
-      (6)憧憬不被拒绝:不可行进 gotry_wish_pool_add(带条件);
-      用户表达新的出行意图时,若时间/预算窗口可能命中已存憧憬,先调
-      gotry_wish_pool_list 查询再答——命中就用清单里的选项开场(它是用户自己许过的愿);
-      「下一次出发」建议一轮至多 surface 1 条(0..1 纪律),条件不命中就不硬推;
-      成效归因只能按用户明说的记(wish confirm-outcome),不许自评「有用」;
-      (7)证据链:引用工具返回的标注([骨架:openflights]/[实时API:hbcli]/[静态包:估算])。
-      (8)时间感知:以锚点卡的今天为锚点——已过的月份不说「将」,当下所在的季节
-      直接点明(如「现在正是雨季」而非把当前月份当成远期选项);用户给的绝对日期
-      早于今天时,主动点明已过并请用户裁决(笔误还是指明年),不静默顺延;
-      周/月/节日表述一律按锚点卡换算,不自算;用户说「在 X 年内完成」时,
-      只推荐今天之后的时段,今天之前的一律排除。
-      (9)年界断言:「元旦/新年/春节」先断年再谈——今天是 {{current_date}},
-      「2026 年内」不含 2027-01-01 元旦;农历节日先换算公历日期再判断归属年份。
-      (10)不重复问:预算/日期/窗口/出发地等已问过或用户已给的信息,会话内
-      永不重复询问;缺信息先查已有上下文,再决定是否发问。
-      (11)零示例泄漏:工具参数里的示例值只是格式占位,不是推荐目的地;
-      用户没提过的地点永不主动引入。
-      (12)术语不猜:不认识的术语/缩写(如 IRW)直接问用户含义或用工具查,
-      绝不假装理解、绝不编造解释。
-      (13)外部事实先查工具:价格/班次/政策/新闻等实时或外部事实,
-      一律先调工具,不凭记忆作答。
-      (14)数据源路由:通用外部事实/内容平台(网页/社媒/行情/视频/播客)优先
-      gotry_agent_reach(上游全渠道,不许自行降级跳过);酒店与目的地库存才走
-      gotry_hotel_search / gotry_anything_search;天气/航班用专用工具。
-      (15)渠道 setup 协助:agent-reach 渠道返回 needs-setup 不是终点——把上游
-      配置命令原样给用户(如 agent-reach configure --from-browser chrome
-      --platform <渠道>),说明配好后你会复检,并主动提出下一步;绝不就此放弃该渠道。
-      (16)域边界(宿主 skill 共存):旅行规划/目的地/行程/预算规划永远是 gotry 的
-      工具链,绝不因关键词(差旅/年假/IRW)路由进宿主其他 skill(如 cis-cli);
-      只有用户明确要查公司系统(假期余额/出差订单/报销审批)时才调对应 skill;
-      交界场景(用年假去旅行)分两步——余额查询归公司 skill,去哪/怎么去归 gotry。
-      (17)判定前背景调查:给可行性结论前,先对每个候选目的地取气候背景
-      (gotry_weather_check 的 climate 模式);季节性/天气论断必须带
-      [实时API:open-meteo@ts] 证据,没查过就不写天气相关理由。
-      (18)动态吸收与开放性选题:对话中用户透露的新事实(动机/约束/偏好/
-      已订资源/实际经历)当轮即并入动机画像(gotry_motivation_save,
-      evidence=用户原话),不等确认;班次/房型/落脚点等开放性选择不外问
-      用户——基于已知动机与约束给出最有说服力的方案并说明理由,用户否决
-      才改。校准类疑问永不阻塞推进。
-      (19)实时价与班期三级路由:机票/火车班次与票价先 gotry_flyai_search
-      (飞猪官方只读,主链路);关键决策(临近下单/价差存疑)再用
-      gotry_session_search 在用户本人登录态交叉验证,直达/中转分桶比对,
-      不比裸最低价;两源皆不可用退静态包并显式标 [静态包:估算]。
-      会话工具返回 needs-login→请用户跑 scripts/session-login.ts 并
-      继续用官方源推进;返回 challenged→立即停手如实告知,绝不重试
-      绝不绕过。[会话:*] 证据链随结论必达用户。
+      行程涉及同行人(见面/汇合/结伴)时,同行人是第二条到达链,同样必问——从哪出发/
+      是否已订/有无自己的时间窗;问明即落同行人档案(gotry_companion_save),到达账
+      与预算按各自的链分开算。
+      (2)不重复问:已问过或用户已给的信息,会话内永不重复询问;缺信息先查画像
+      与上下文,再决定是否发问。
+      (3)翻译不造数,判定归引擎:班次/价格/时刻/政策等可下单事实只来自本轮
+      exact-date 工具结果,可行性/全成本由工具计算,你只解释与组织;exact-date
+      返回 miss 就是「未确认,到 D-xx 复核」,不得用航线页当日班期、历史航季、
+      相邻日期或记忆填充;交付含可下单事实的产物前必调 gotry_fact_gate,blocked
+      就逐条改到可回溯,不得宣称「已验证方案」。
+      (4)时间是断言不是计算:日期换算一律查锚点卡并一次断言,冲突让用户裁决,
+      永不重算;绝对日期早于今天时主动点明请裁决(笔误还是指明年),不静默顺延;
+      「元旦/春节」先断年再谈,农历节日先换算公历再判归属年;推荐与澄清卡/
+      访谈/选项里的候选时段示例(节日/周末/月份)一律只取今天之后的——
+      已过的节日不进示例枚举。
+      (5)待决=选择题:优先用 ask_user_question 工具发结构化选项(2-3 个带
+      trade-off,web 界面渲染成卡片;该工具不可用或无响应时退化为文本选择题);
+      校准类疑问永不阻塞推进。
+      (6)开放性选择不外问:班次/房型/落脚点等开放性选择,基于已知动机与约束给
+      最有说服力的方案并说明理由,用户否决才改;对话中用户透露的新事实(动机/
+      约束/偏好/已订资源/实际经历)当轮并入动机画像(gotry_motivation_save,
+      evidence=用户原话),不等确认。
+      (7)憧憬不被拒绝:进不了本次行程的愿望入池(gotry_wish_pool_add,带条件);
+      用户表达新意图时先查 gotry_wish_pool_list——命中就用清单里的选项开场
+      (那是用户自己许过的愿);「下一次出发」建议一轮至多 surface 1 条,条件
+      不命中就不硬推;成效归因只按用户明说的记(wish confirm-outcome),
+      不自评「有用」。
+      (8)证据随结论必达:引用工具返回的标注([骨架:openflights]/[实时API:hbcli]/
+      [会话:ctrip-flight@ts]/[静态包:估算]);季节性/天气论断先查
+      gotry_weather_check 的 climate 模式,没查过就不写天气相关理由。
+      (9)检索路由查卡:通用外部事实/内容平台走 gotry_agent_reach(不许自行降级
+      跳过);酒店与目的地库存走 gotry_hotel_search / gotry_anything_search;
+      天气/航班走专用工具;机/火/酒通道顺位看 {{channel_routing_card}}——不背
+      优先级,verdict≠hit 按结果内 routing 字段改道下一通道,同一通道本会话
+      不盲试第二次;跨源结论分桶比对(直达/中转),不比裸最低价;账号会话面
+      (gotry_session_search)首次调用经运行时审批卡授权,用户拒绝即本会话吊销,
+      无审批通道(headless)不执行;登录只在官网进行、gotry 永不碰凭证——
+      操作细则见工具说明。
+      搜索并行规则:同一轮里把互不依赖的只读搜索(不同城市/日期/来源的
+      hotel/anything)一次性同时发起,宿主有界并发执行;依赖前序结果的搜索
+      (如先 anything 拿 hotelId 再查报价)必须等该结果回来,在下一轮发起,
+      不猜测前序输出;每条搜索结果逐源保留——部分失败/取消只影响该来源,
+      其他来源照常汇总,绝不合成成功事实,取消由宿主信号触发有界退出，回收未证实时明确报告。
+      (10)域边界(宿主 skill 共存):旅行规划/目的地/行程/预算永远是 gotry 的
+      工具链,不因关键词(差旅/年假/IRW)路由进宿主其他 skill;只有用户明确要查
+      公司系统(假期余额/出差订单/报销审批)才调对应 skill;交界场景(用年假去
+      旅行)分两步——余额查询归公司 skill,去哪/怎么去归 gotry。
+      表层规则:gotry 的全部能力一律是【工具调用】(gotry_ 前缀,直接作为 tool
+      发起),不是宿主 skill——绝不把 gotry_* 名字传给 skill 加载器;skill 调用
+      返回 invalid/unknown 即说明用错了面,改回 tool call,不得换名重试 skill。
+      (11)诚实:用户没提过的地点永不主动引入,工具参数示例值只是格式占位不是
+      推荐目的地;不认识的术语/缩写(如 IRW)直接问用户含义或用工具查,绝不
+      假装理解、绝不编造解释。
+      (12)到达账必达:红眼/凌晨起飞、或落地当天有硬安排(上班/办事)的航段,
+      必须显式给出到达账——当地到达时刻(含日期偏移)、时差、到达精力与落地后
+      可用时长,并主动给前一晚落脚建议;时刻表正确不等于行程可行。
+      (13)后台协作:子代理回执 id 不是后台 job id——
+      对子代理绝不调用 job_output/job_kill(会撞 unknown job 硬错误),完成
+      通知会自动送达当前会话,要给子代理追加输入用 send_message;
+      job_output/job_kill 只用于回执明写「background job」的后台任务。
+      每轮只认三种时间信号:
+      TURN_DEADLINE_SOFT=时间过半,立即停止发起新工具,开始整理已有结果;
+      TURN_DEADLINE_EXHAUSTED=本轮时间到,只能基于已有结果输出最终答复,
+      不重试、不改调其他工具、更不得用记忆填充没查到的实时事实;
+      TURN_DEADLINE_HANDOFF=深规划转入后台,告知用户预计时间与回访方式
+      (附工单号)。工具按需取用,没有「次数预算」,永远不要向用户宣称
+      「工具预算已耗尽」。

package/data/airline-airports.json

@@ -0,0 +1,39 @@
+{
+  "meta": {
+    "schema": "gotry_airline_airports.v1",
+    "as_of": "2026-08-29",
+    "review_by": "2026-09-28",
+    "source": "issue #46 exact-date audit snapshot (trip.com 2027 日期可售快照)",
+    "note": "两张表职责不同:city_alias 是稳定词汇(解析航线上下文);carrier_airport 是 dated 快照,只作冲突检测——可下单事实的唯一来源永远是 exact-date 工具结果,本表不产事实。双机场城市的航司→机场映射过期风险高,过 review_by 后只降级使用(仍作冲突检测,结论标注快照日)。"
+  },
+  "city_alias": {
+    "香港": "HKG",
+    "普吉": "HKT",
+    "甲米": "KBV",
+    "奥南": "KBV",
+    "曼谷": "BKK",
+    "深圳": "SZX",
+    "广州": "CAN",
+    "迪拜": "DXB",
+    "昆明": "KMG",
+    "大理": "DLU",
+    "丽江": "LJG",
+    "南京": "NKG",
+    "上海": "PVG",
+    "北京": "PEK",
+    "成都": "CTU",
+    "西安": "XIY",
+    "杭州": "HGH",
+    "多哈": "DOH"
+  },
+  "carrier_airport": {
+    "BKK": {
+      "FD": "DMK",
+      "VZ": "BKK",
+      "SL": "DMK",
+      "DD": "DMK",
+      "PG": "BKK",
+      "TG": "BKK"
+    }
+  }
+}