@danceiny/gotry 0.0.1-rc.10

package/ts/capabilities/weather.ts

@@ -0,0 +1,176 @@
+/**
+ * Open-Meteo 天气能力层(免费无 key):预报 + 历史气候回退。
+ *
+ * 产品定位:替代 LLM 的「雨季常识」——季节性建议、窗口内降雨概率、
+ * 体感温度范围,全部走真实数据并带证据标注 [实时API:open-meteo@ts]。
+ *
+ * 契约(与 hbcli.ts 同构,能力层不变量):
+ *   - 永不抛错:网络失败/超时/解析失败一律降级返回,不穿透到调用方;
+ *   - 证据链标注:成功带 [实时API:open-meteo@ts],失败带 [实时API:open-meteo@error@ts];
+ *   - 免费源无配额概念,但仍记录 latency(供 L5 成本工程度量)。
+ *
+ * 端点(全部免费,无 key):
+ *   预报: https://api.open-meteo.com/v1/forecast (≤16 天)
+ *   历史气候: https://archive-api.open-meteo.com/v1/archive (1940→,做季节性)
+ *   地理编码: https://geocoding-api.open-meteo.com/v1/search (地名→坐标)
+ */
+
+export interface WeatherPoint {
+  latitude: number
+  longitude: number
+}
+
+export interface WeatherDaily {
+  date: string
+  tempMaxC: number
+  tempMinC: number
+  precipProbMaxPct: number | null
+  weatherCode: number
+}
+
+export interface WeatherResult {
+  ok: boolean
+  via: 'open-meteo' | 'open-meteo-error'
+  evidence: string
+  latencyMs: number
+  timezone?: string
+  daily?: WeatherDaily[]
+  error?: string
+}
+
+const FORECAST_BASE = 'https://api.open-meteo.com/v1/forecast'
+const ARCHIVE_BASE = 'https://archive-api.open-meteo.com/v1/archive'
+const GEOCODE_BASE = 'https://geocoding-api.open-meteo.com/v1/search'
+
+/** WMO weather code → 中文描述(节选最常用的码) */
+const WMO_ZH: Record<number, string> = {
+  0: '晴', 1: '大致晴', 2: '多云', 3: '阴',
+  45: '雾', 48: '冻雾',
+  51: '毛毛雨', 53: '毛毛雨', 55: '密集毛毛雨',
+  61: '小雨', 63: '中雨', 65: '大雨',
+  66: '冻雨', 67: '强冻雨',
+  71: '小雪', 73: '中雪', 75: '大雪', 77: '雪粒',
+  80: '阵雨', 81: '强阵雨', 82: '暴雨',
+  85: '阵雪', 86: '强阵雪',
+  95: '雷暴', 96: '雷暴伴小冰雹', 99: '雷暴伴大冰雹',
+}
+
+export function wmoLabel(code: number): string {
+  return WMO_ZH[code] ?? `天气码${code}`
+}
+
+async function fetchJson(url: string, timeoutMs: number): Promise<{ ok: boolean; data?: unknown; error?: string }> {
+  const ctrl = new AbortController()
+  const timer = setTimeout(() => ctrl.abort(), timeoutMs)
+  try {
+    const res = await fetch(url, { signal: ctrl.signal, headers: { Accept: 'application/json' } })
+    if (!res.ok) return { ok: false, error: `HTTP ${res.status}` }
+    return { ok: true, data: await res.json() }
+  } catch (e) {
+    return { ok: false, error: (e as Error).message.slice(0, 200) }
+  } finally {
+    clearTimeout(timer)
+  }
+}
+
+/** 地名 → 坐标(地理编码,供 dsh 工具把「大理」转成经纬度) */
+export async function geocodePlace(
+  name: string,
+  opts: { timeoutMs?: number; count?: number } = {},
+): Promise<{ ok: boolean; evidence: string; results: Array<{ name: string; latitude: number; longitude: number; country?: string; admin1?: string }>; error?: string }> {
+  const ts = new Date().toISOString()
+  const count = opts.count ?? 5
+  const url = `${GEOCODE_BASE}?name=${encodeURIComponent(name)}&count=${count}&language=zh&format=json`
+  const r = await fetchJson(url, opts.timeoutMs ?? 15_000)
+  if (!r.ok) {
+    return { ok: false, evidence: `[实时API:open-meteo-geo@error@${ts}]`, results: [], error: r.error }
+  }
+  const results = ((r.data as { results?: unknown[] })?.results ?? []).map((item) => {
+    const it = item as Record<string, unknown>
+    return {
+      name: String(it['name'] ?? ''),
+      latitude: Number(it['latitude']),
+      longitude: Number(it['longitude']),
+      country: it['country'] ? String(it['country']) : undefined,
+      admin1: it['admin1'] ? String(it['admin1']) : undefined,
+    }
+  })
+  return { ok: true, evidence: `[实时API:open-meteo-geo@${ts}]`, results }
+}
+
+/** 未来天气预报(≤16 天) */
+export async function getForecast(
+  point: WeatherPoint,
+  opts: { days?: number; timeoutMs?: number } = {},
+): Promise<WeatherResult> {
+  const started = Date.now()
+  const ts = new Date().toISOString()
+  const days = Math.min(opts.days ?? 7, 16)
+  const url = `${FORECAST_BASE}?latitude=${point.latitude}&longitude=${point.longitude}`
+    + `&daily=temperature_2m_max,temperature_2m_min,precipitation_probability_max,weathercode`
+    + `&forecast_days=${days}&timezone=auto`
+  const r = await fetchJson(url, opts.timeoutMs ?? 15_000)
+  const latencyMs = Date.now() - started
+  if (!r.ok) {
+    return { ok: false, via: 'open-meteo-error', evidence: `[实时API:open-meteo@error@${ts}]`, latencyMs, error: r.error }
+  }
+  const daily = (r.data as { daily?: { time: string[]; temperature_2m_max: number[]; temperature_2m_min: number[]; precipitation_probability_max?: (number | null)[]; weathercode: number[] }; timezone?: string }).daily
+  if (!daily) {
+    return { ok: false, via: 'open-meteo-error', evidence: `[实时API:open-meteo@error@${ts}]`, latencyMs, error: 'empty daily payload' }
+  }
+  const rows: WeatherDaily[] = daily.time.map((date, i) => ({
+    date,
+    tempMaxC: daily.temperature_2m_max[i] ?? NaN,
+    tempMinC: daily.temperature_2m_min[i] ?? NaN,
+    precipProbMaxPct: daily.precipitation_probability_max?.[i] ?? null,
+    weatherCode: daily.weathercode[i] ?? -1,
+  }))
+  return {
+    ok: true, via: 'open-meteo',
+    evidence: `[实时API:open-meteo@${ts}]`,
+    latencyMs,
+    timezone: (r.data as { timezone?: string }).timezone,
+    daily: rows,
+  }
+}
+
+/** 历史气候(季节性推荐底座:去年同期日均温/降雨概率) */
+export async function getClimate(
+  point: WeatherPoint,
+  month: number,
+  opts: { year?: number; timeoutMs?: number } = {},
+): Promise<WeatherResult> {
+  const started = Date.now()
+  const ts = new Date().toISOString()
+  // 默认取去年同月做气候基线
+  const year = opts.year ?? (new Date().getFullYear() - 1)
+  const lastDay = new Date(Date.UTC(year, month, 0)).getUTCDate()
+  const start = `${year}-${String(month).padStart(2, '0')}-01`
+  const end = `${year}-${String(month).padStart(2, '0')}-${String(lastDay).padStart(2, '0')}`
+  const url = `${ARCHIVE_BASE}?latitude=${point.latitude}&longitude=${point.longitude}`
+    + `&start_date=${start}&end_date=${end}`
+    + `&daily=temperature_2m_max,temperature_2m_min,precipitation_sum,weathercode&timezone=auto`
+  const r = await fetchJson(url, opts.timeoutMs ?? 15_000)
+  const latencyMs = Date.now() - started
+  if (!r.ok) {
+    return { ok: false, via: 'open-meteo-error', evidence: `[实时API:open-meteo-climate@error@${ts}]`, latencyMs, error: r.error }
+  }
+  const daily = (r.data as { daily?: { time: string[]; temperature_2m_max: number[]; temperature_2m_min: number[]; weathercode: number[] } }).daily
+  if (!daily) {
+    return { ok: false, via: 'open-meteo-error', evidence: `[实时API:open-meteo-climate@error@${ts}]`, latencyMs, error: 'empty daily payload' }
+  }
+  const rows: WeatherDaily[] = daily.time.map((date, i) => ({
+    date,
+    tempMaxC: daily.temperature_2m_max[i] ?? NaN,
+    tempMinC: daily.temperature_2m_min[i] ?? NaN,
+    precipProbMaxPct: null, // archive 端点没有概率,用降水量另行估算
+    weatherCode: daily.weathercode[i] ?? -1,
+  }))
+  return {
+    ok: true, via: 'open-meteo',
+    evidence: `[实时API:open-meteo-climate@${ts}]`,
+    latencyMs,
+    timezone: (r.data as { timezone?: string }).timezone,
+    daily: rows,
+  }
+}

package/ts/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@gotry/plugin",
+  "version": "0.0.1-rc.2",
+  "private": true,
+  "description": "GoTry dsh plugin: motivation profile, feasibility (door-to-door true cost via unified segment model), skeleton connectivity, hotel search, wish pool — all pure TS, no Python runtime required",
+  "type": "module",
+  "main": "src/index.ts",
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "smoke": "tsx scripts/smoke.ts"
+  },
+  "dependencies": {
+    "@deepseek-ai/cordis": "*",
+    "@deepseek-ai/dsh-tools": "*",
+    "@deepseek-ai/schemastery": "*",
+    "@types/better-sqlite3": "^9.6.0",
+    "better-sqlite3": "^13.0.3",
+    "z3-solver": "^5.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "playwright-core": "^1.62.1",
+    "puppeteer-core": "^25.9.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  }
+}

package/ts/scripts/async-collect.ts

@@ -0,0 +1,50 @@
+/**
+ * 异步工单回收(S5 编排半段 → ADR-15 durable 恢复语义):加载持久化工单,
+ * 经可日志化 solve 端口执行深度规划(done 步骤复用账本结果,不重执行),
+ * 交付物落账本 + .deliverable.md 视图。可由任何后续进程执行(loopx 驱动的
+ * tick、state-cli tick、人工、未来的通知系统)——「一小时后回来」跨进程成立,
+ * 且崩溃恢复 exactly-once:重放不重复花钱。
+ * 运行(在 ts/ 下):npx tsx scripts/async-collect.ts <ticketId> [stateRoot]
+ * 环境变量 GOTRY_SOLVE_COUNT_FILE:每次真实求解追加一行(回归用计数探针)。
+ */
+
+import { appendFileSync } from 'node:fs'
+import { collectDeepPlanning, loadAsyncTicket, makeJournaledSolvePort, settleAsyncTicket } from '../src/loop.ts'
+import { solveUnified } from '../src/unified.ts'
+import { openLedgerIfExists } from '../src/state-ledger.ts'
+
+const ticketId = process.argv[2]
+const stateRoot = process.argv[3] ?? '.'
+if (!ticketId) {
+  console.error('用法:npx tsx scripts/async-collect.ts <ticketId> [stateRoot](权威在账本 workflow_runs,视图在 gotry-state/async/)')
+  process.exit(1)
+}
+
+const loaded = await loadAsyncTicket(ticketId, stateRoot)
+if (!loaded) {
+  console.error(`工单 ${ticketId} 不存在(账本 workflow_runs / gotry-state/async/${ticketId}.json)`)
+  process.exit(1)
+}
+
+// 终态幂等:已 settled 的工单复诵账本交付物,零重算
+const ledger = openLedgerIfExists(stateRoot)
+const run = ledger?.getWorkflowRun(ticketId)
+if (run?.status === 'settled' && run.deliverable) {
+  console.log(`工单 ${ticketId} 已交付(账本终态,复诵不重算):\n\n${run.deliverable}`)
+  process.exit(0)
+}
+if (!ledger) {
+  console.error(`工单 ${ticketId}:stateRoot(${stateRoot})无账本——持久化先于回收,不应发生`)
+  process.exit(1)
+}
+
+const solve = makeJournaledSolvePort(ledger, ticketId, solveUnified as never, {
+  onRealSolve: () => {
+    const f = process.env['GOTRY_SOLVE_COUNT_FILE']
+    if (f) appendFileSync(f, 'solve\n')
+  },
+})
+
+const { reply } = await collectDeepPlanning(loaded.state, loaded.ticket, solve)
+const out = await settleAsyncTicket(ticketId, reply, stateRoot)
+console.log(`交付物已落盘:${out}\n\n${reply}`)

package/ts/scripts/skeleton-check.ts

@@ -0,0 +1,49 @@
+/**
+ * OpenFlights 骨架校验(M2 段 3,§7-1 骨架层):引擎候选集的通航性合法性校验。
+ * 数据源:data/openflights-skeleton.json(OpenFlights ODbL,枢纽间 168 对)。
+ * 语义:「查不到≠不可达」(骨架只含枢纽间),但「查到」= 候选集强证据。
+ * 运行:cd ts && npx tsx scripts/skeleton-check.ts HKG HKT
+ */
+
+import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+interface Skeleton {
+  meta: { source: string; note: string; hub_filter: string[] }
+  pairs: Record<string, string[]>
+}
+
+let cached: Skeleton | null = null
+
+async function load(): Promise<Skeleton> {
+  if (!cached) {
+    cached = JSON.parse(await readFile(join(import.meta.dirname, '..', '..', 'data', 'openflights-skeleton.json'), 'utf-8')) as Skeleton
+  }
+  return cached
+}
+
+export async function checkConnectivity(a: string, b: string): Promise<{ connected: boolean; airlines?: string[]; evidence: string }> {
+  const skeleton = await load()
+  const key = [a.toUpperCase(), b.toUpperCase()].sort().join('-')
+  const airlines = skeleton.pairs[key]
+  if (airlines) {
+    return { connected: true, airlines, evidence: `[骨架:openflights] ✅ ${a}↔${b} 直飞(${airlines.length}+ 航司:${airlines.join(',')})` }
+  }
+  const inHub = (skeleton.meta.hub_filter as string[]).includes(a.toUpperCase())
+    && (skeleton.meta.hub_filter as string[]).includes(b.toUpperCase())
+  return {
+    connected: false,
+    evidence: inHub
+      ? `[骨架:openflights] ❌ ${a}↔${b} 枢纽间无直飞记录——引擎应将此候选降权或要求中转`
+      : `[骨架:openflights] ○ ${a}或${b}不在枢纽集,骨架不覆盖(不作否定结论)`,
+  }
+}
+
+// CLI 直跑
+// 仅作为直接 CLI 入口时执行(被 import 时不触发:此前 dsh 子进程的
+// argv[2]/[3](--profile headless)恰好真值,每次启动白跑一次探测还污染 stdout)
+import { pathToFileURL } from 'node:url'
+const isMain = process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href
+if (isMain && process.argv[2] && process.argv[3]) {
+  console.log((await checkConnectivity(process.argv[2], process.argv[3])).evidence)
+}

package/ts/scripts/skeleton-integration-test.ts

@@ -0,0 +1,23 @@
+/**
+ * 骨架层集成验证(§7-1 消费面):开 skeletonHub + 带 route 的段 → 结果带三值标注;
+ * 枢纽间否定只标注不排除——EK329(数据集滞后的新航线)必须存活。
+ * 运行(在 ts/ 下):npx tsx scripts/skeleton-integration-test.ts
+ */
+
+import assert from 'node:assert/strict'
+import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+import { parseFlightPackToSpec, solveUnified } from '../src/unified.ts'
+
+const pack = JSON.parse(await readFile(join('..', 'data', 'flights_2026.json'), 'utf-8'))
+const spec = parseFlightPackToSpec(pack)
+spec.budgetCny = 9000
+spec.skeletonHub = true
+spec.segments.forEach(s => { if (s.id === 'f5') s.route = 'SZX->DXB'; if (s.id === 'f1') s.route = 'HKG->HKT' })
+const r = await solveUnified(spec)
+assert.equal(r.feasible, true, '骨架否定不排除——EK329 必须仍在')
+const f5 = r.legs!.find(l => l.leg === 'f5')
+assert.equal(f5?.service, 'EK329', 'EK329 存活(骨架滞后容错)')
+assert.ok((r.skeleton_notes ?? []).some(n => n.includes('SZX') && n.includes('❌')), `枢纽否定标注在: ${r.skeleton_notes}`)
+assert.ok((r.skeleton_notes ?? []).some(n => n.includes('HKG') && n.includes('✅')), '正向标注在')
+console.log(`骨架集成 OK:EK329 在枢纽否定下存活,标注=[${r.skeleton_notes?.join(' | ')}]`)

package/ts/scripts/state-cli.ts

@@ -0,0 +1,201 @@
+/**
+ * 账本 CLI(ADR-15 事务化状态基座的操作面;D3 决策:仓内极简命令,恢复语义
+ * 已与驱动器解耦,随时可换 loopx tick):
+ *   migrate [root]                      one-shot 迁移:旧 JSON/JSONL → 账本 events
+ *                                       (导入前自动快照到 gotry-state/pre-ledger-backup/)
+ *   export [root]                       账本 → 旧文件名视图(红线 6:可见可导出;单向,不回流)
+ *   log [root] [--limit N]              事件账本尾部(append-only 审计面)
+ *   stats [root]                        各面计数
+ *   rebuild [root] [toSeq]              DROP 投影 → fold 重放(可截到 toSeq;账本/投影
+ *                                       永不分叉的可验证性)
+ *   rewind [root] <seq>                 = rebuild toSeq(投影回到历史时点;events 不动,
+ *                                       rebuild 无参即回到最新)
+ *   forget [root] wish|companion|motivation <id>
+ *                                       物理硬删该主体全部事件 + 审计一行 + 重建投影
+ *                                       (红线 6「可删除」;D5 默认物理删)
+ *   tick [root]                         回收全部 pending 工单(durable 恢复语义)
+ *   whatif [root] <dest.db>             VACUUM INTO 分叉副本(WriteGate what-if 预演,不触正本)
+ *   pw-list [root]                      pending_writes 清单
+ *   pw-request [root] <idemKey> <seam> <payloadJson>   登记待确认外部写(L2)
+ *   pw-confirm [root] <idemKey> <receipt>              具名 seam 确认(L3,携 receipt)
+ *   pw-compensate [root] <idemKey> <note>              saga 补偿
+ * root 默认 '.';运行:cd ts && npx tsx scripts/state-cli.ts <cmd> ...
+ */
+
+import { mkdirSync, renameSync, writeFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { ensureLedger, openLedgerIfExists } from '../src/state-ledger.ts'
+import { collectDeepPlanning, makeJournaledSolvePort, settleAsyncTicket, type AsyncTicket } from '../src/loop.ts'
+import { solveUnified } from '../src/unified.ts'
+import type { TripState } from '../src/contracts.ts'
+
+const [cmd, ...rest] = process.argv.slice(2)
+
+function rootOf(args: string[]): string {
+  const i = args.indexOf('--state-root')
+  if (i >= 0 && args[i + 1]) return args[i + 1]
+  const first = args.find(a => !a.startsWith('--') && !/^[\d]+$/.test(a))
+  return first ?? '.'
+}
+
+function tenantOf(args: string[]): string {
+  const i = args.indexOf('--tenant')
+  return i >= 0 && args[i + 1] ? args[i + 1] : 'local'
+}
+
+function arg(name: string, fallback?: string): string | undefined {
+  const i = process.argv.indexOf(name)
+  return i >= 0 ? process.argv[i + 1] : fallback
+}
+
+function atomicWrite(path: string, text: string): void {
+  const tmp = `${path}.tmp`
+  writeFileSync(tmp, text, 'utf-8')
+  renameSync(tmp, path)
+}
+
+const HELP = '用法见文件头注释(npx tsx scripts/state-cli.ts <cmd> [root] ...)'
+
+switch (cmd) {
+  case 'migrate': {
+    const root = rootOf(rest)
+    const tenant = tenantOf(rest)
+    const before = openLedgerIfExists(root, tenant)?.countEvents() ?? 0
+    const ledger = ensureLedger(root, tenant)
+    const backupDir = join(root, 'gotry-state', 'pre-ledger-backup')
+    console.log(`账本就绪:${ledger.dbPath}(events ${before} → ${ledger.countEvents()};存在旧文件时已快照至 ${backupDir}/)`)
+    break
+  }
+  case 'export': {
+    const root = rootOf(rest)
+    const tenant = tenantOf(rest)
+    const ledger = ensureLedger(root, tenant)
+    const dir = join(root === '.' ? process.cwd() : root, 'gotry-state')
+    mkdirSync(dir, { recursive: true })
+    const motivation = ledger.readMotivation()
+    if (motivation) atomicWrite(join(dir, 'motivation-profile.json'), JSON.stringify(motivation, null, 2))
+    const pool = ledger.readWishPool()
+    if (pool.length) atomicWrite(join(dir, 'wish-pool.json'), JSON.stringify(pool, null, 2))
+    const companions = ledger.readCompanions()
+    if (companions.length) atomicWrite(join(dir, 'companions.json'), JSON.stringify(companions, null, 2))
+    const utility = ledger.readUtilityEvents()
+    if (utility.length) atomicWrite(join(dir, 'memory-utility.jsonl'), utility.map(e => JSON.stringify(e)).join('\n') + '\n')
+    const trips = ledger.readTrips()
+    if (trips.length) atomicWrite(join(dir, 'trips.jsonl'), trips.map(e => JSON.stringify(e)).join('\n') + '\n')
+    console.log(`视图已导出(单向,DB→文件;红线 6):${dir}/`)
+    break
+  }
+  case 'log': {
+    const root = rootOf(rest)
+    const tenant = tenantOf(rest)
+    const limit = Number(arg('--limit', '20'))
+    const ledger = openLedgerIfExists(root, tenant)
+    if (!ledger) { console.log('(无账本——未迁移 root,旧文件形态)'); break }
+    for (const e of ledger.readEvents(undefined, limit)) {
+      console.log(`${String(e.seq).padStart(5)}  ${e.ts}  ${e.actor.padEnd(28)} ${e.kind.padEnd(24)} ${e.subject_id}${e.idem_key ? `  #${e.idem_key}` : ''}`)
+    }
+    break
+  }
+  case 'stats': {
+    const root = rootOf(rest)
+    const tenant = tenantOf(rest)
+    const ledger = openLedgerIfExists(root, tenant)
+    if (!ledger) { console.log('(无账本——未迁移 root)'); break }
+    console.log(`events=${ledger.countEvents()} wishes=${ledger.readWishPool().length} companions=${ledger.readCompanions().length} trips=${ledger.readTrips().length} utility=${ledger.readUtilityEvents().length} pendingRuns=${ledger.pendingWorkflowRuns().length} pendingWrites=${ledger.listPendingWrites().length}`)
+    break
+  }
+  case 'rebuild':
+  case 'rewind': {
+    const root = rootOf(rest)
+    const tenant = tenantOf(rest)
+    const ledger = openLedgerIfExists(root, tenant)
+    if (!ledger) { console.error('无账本'); process.exit(1) }
+    const toSeqRaw = rest.find(a => /^\d+$/.test(a))
+    const r = ledger.rebuildProjections(toSeqRaw ? Number(toSeqRaw) : undefined)
+    console.log(`fold 重建完成${toSeqRaw ? `(至 seq ${toSeqRaw};rebuild 无参即回最新)` : '(全量)'}:重放 ${r.events} 事件 → 愿望 ${r.wishes} / 同行人 ${r.companions}`)
+    break
+  }
+  case 'forget': {
+    const root = rootOf(rest)
+    const tenant = tenantOf(rest)
+    const ledger = openLedgerIfExists(root, tenant)
+    if (!ledger) { console.error('无账本'); process.exit(1) }
+    const subject = rest.find(a => !a.startsWith('--') && a !== root)
+    const id = rest[rest.indexOf(subject!) + 1]
+    if (!subject || id === undefined) { console.error(HELP); process.exit(1) }
+    const map: Record<string, { kinds: string[]; subjectId: string }> = {
+      wish: { kinds: ['wish.imported', 'wish.added', 'wish.updated', 'memory_utility.event'], subjectId: id },
+      companion: { kinds: ['companion.imported', 'companion.saved'], subjectId: id },
+      motivation: { kinds: ['motivation.imported', 'motivation.patch'], subjectId: 'motivation' },
+    }
+    const spec = map[subject]
+    if (!spec) { console.error(`未知主体 ${subject}(wish|companion|motivation)`); process.exit(1) }
+    const r = ledger.forgetSubject([spec])
+    console.log(`已物理硬删 ${r.deleted} 条事件并重建投影(审计一行留痕;红线 6「可删除」)`)
+    break
+  }
+  case 'tick': {
+    const root = rootOf(rest)
+    const tenant = tenantOf(rest)
+    const ledger = openLedgerIfExists(root, tenant)
+    if (!ledger) { console.log('(无账本,无待办)'); break }
+    const pending = ledger.pendingWorkflowRuns()
+    if (pending.length === 0) { console.log('(无 pending 工单)'); break }
+    for (const p of pending) {
+      const run = ledger.getWorkflowRun(p.id)!
+      const ticket = JSON.parse(run.ticket_json) as AsyncTicket
+      const state = JSON.parse(run.state_json) as TripState
+      const solve = makeJournaledSolvePort(ledger, p.id, solveUnified as never)
+      const { reply } = await collectDeepPlanning(state, ticket, solve)
+      await settleAsyncTicket(p.id, reply, root)
+      console.log(`工单 ${p.id} 已回收(durable 恢复语义:done 步骤零重执行)`)
+    }
+    break
+  }
+  case 'whatif': {
+    const root = rootOf(rest)
+    const tenant = tenantOf(rest)
+    const ledger = openLedgerIfExists(root, tenant)
+    if (!ledger) { console.error('无账本'); process.exit(1) }
+    const dest = rest.find(a => a !== root && !a.startsWith('--'))
+    if (!dest) { console.error(HELP); process.exit(1) }
+    mkdirSync(dirname(dest), { recursive: true })
+    ledger.forkWhatIf(dest)
+    console.log(`what-if 分叉已生成:${dest}(预演在副本,正本零改动)`)
+    break
+  }
+  case 'pw-list': {
+    const root = rootOf(rest)
+    const tenant = tenantOf(rest)
+    const ledger = openLedgerIfExists(root, tenant)
+    if (!ledger) { console.log('(无账本)'); break }
+    for (const w of ledger.listPendingWrites()) {
+      console.log(`${w.status.padEnd(12)} ${w.idem_key}  seam=${w.seam}${w.receipt ? `  receipt=${w.receipt}` : ''}`)
+    }
+    break
+  }
+  case 'pw-request':
+  case 'pw-confirm':
+  case 'pw-compensate': {
+    const root = rootOf(rest)
+    const tenant = tenantOf(rest)
+    const ledger = ensureLedger(root, tenant)
+    const positional = rest.filter(a => a !== root && !a.startsWith('--'))
+    if (positional.length < (cmd === 'pw-request' ? 3 : 2)) { console.error(HELP); process.exit(1) }
+    if (cmd === 'pw-request') {
+      const r = ledger.requestPendingWrite({ idemKey: positional[0]!, seam: positional[1]!, payload: JSON.parse(positional[2]!) as unknown })
+      console.log(`登记:${JSON.stringify(r)}(L2:只登记不执行)`)
+    } else if (cmd === 'pw-confirm') {
+      const r = ledger.confirmPendingWrite(positional[0]!, positional[1]!)
+      console.log(`确认:${JSON.stringify(r)}`)
+    } else {
+      const r = ledger.compensatePendingWrite(positional[0]!, positional[1]!)
+      console.log(`补偿:${JSON.stringify(r)}`)
+    }
+    break
+  }
+  default:
+    console.error(cmd ? `未知命令 ${cmd}` : HELP)
+    console.error(HELP)
+    process.exit(1)
+}

package/ts/src/bridge.ts

@@ -0,0 +1,44 @@
+/**
+ * GoTry 桥接工具集(纯 Node 版,无 Python 依赖):
+ *   - ensureStateDir: 状态目录创建
+ *   - recordLatency: 延迟日志追加
+ *   - readJson / writeJson: JSON 文件安全读写
+ *
+ * 历史:曾有 callFeasibilityEngine 用 spawn(.venv/bin/python) 起 Python CLI,
+ * 作为 TS 求解的回退路径。D-7 切轨后 unified solveChoiceSegment 是唯一求解入口,
+ * Python oracle 路径于 v0.0.1-rc.2 移除——npm 一键分发不再需要 Python 运行时依赖。
+ */
+
+import { appendFile, mkdir, readFile, writeFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+/** 状态目录:动机画像 / wish pool 的落盘位置(红线 6:用户数据可见、可编辑、可删除) */
+export async function ensureStateDir(root: string): Promise<string> {
+  const dir = join(root, 'gotry-state')
+  await mkdir(dir, { recursive: true })
+  return dir
+}
+
+/** JSON 安全读取:文件不存在返回 fallback,解析失败抛错 */
+export async function readJson<T>(path: string, fallback: T): Promise<T> {
+  try {
+    const text = await readFile(path, 'utf-8')
+    return JSON.parse(text) as T
+  } catch (e) {
+    if ((e as NodeJS.ErrnoException).code === 'ENOENT') return fallback
+    throw e
+  }
+}
+
+/** JSON 原子写入 */
+export async function writeJson(path: string, value: unknown): Promise<void> {
+  const tmp = `${path}.tmp`
+  await writeFile(tmp, JSON.stringify(value, null, 2), 'utf-8')
+  const { rename } = await import('node:fs/promises')
+  await rename(tmp, path)
+}
+
+/** 桥接延迟日志(追加式;T5 成本工程的度量数据源之一) */
+export async function recordLatency(logPath: string, latencyMs: number, kind: string): Promise<void> {
+  await appendFile(logPath, JSON.stringify({ ts: new Date().toISOString(), kind, latencyMs }) + '\n')
+}