deskbuddy 0.2.0-beta.6 → 0.2.0-beta.8

package/dist/hook.cjs

@@ -86,8 +86,8 @@ const FALLBACK_REGISTRY = {
       format: 'codex-toml',
       processNames: ['codex'],
       // codex-thread-name 是机会主义的一级：session_index.jsonl 里的 thread_name
-      // 原生只有 /rename 手动设，多数用户是空的，取不到就往下回落
-      titleSources: ['codex-thread-name', 'git-branch', 'project'],
+      // 只有 /rename 或 VS Code 扩展起过名的才有，多数是空的，取不到用首条指令
+      titleSources: ['codex-thread-name', 'first-prompt', 'git-branch', 'project'],
       events: {
         UserPromptSubmit: 'watch',
         PreToolUse: 'watch',
@@ -100,7 +100,9 @@ const FALLBACK_REGISTRY = {
     workbuddy: {
       format: 'cc-hook',
       processNames: ['WorkBuddy'],
-      titleSources: ['git-branch', 'project'],
+      // WorkBuddy 的 transcript 与 Claude Code 同格式，也写 ai-title（2026-10-01 WorkBuddy 5.6.2 实测）；
+      // 工作目录是按时间自动建的，目录名不能当标题
+      titleSources: ['cc-ai-title', 'first-prompt', 'git-branch', 'project'],
       events: {
         UserPromptSubmit: 'watch',
         PreToolUse: 'watch',
@@ -113,7 +115,9 @@ const FALLBACK_REGISTRY = {
     qoder: {
       format: 'cc-hook',
       processNames: ['Qoder CN'],
-      titleSources: ['git-branch', 'project'],
+      // 桌面端会话库里的标题（先是首条指令，后被换成 AI 摘要）；qodercli 命令行版的会话不在库里，落到首条指令
+      // （CLI 1.1.61 实测 transcript 里没有 ai-title，UserPromptSubmit 带 prompt）
+      titleSources: ['qoder-session-title', 'first-prompt', 'git-branch', 'project'],
       events: {
         UserPromptSubmit: 'watch',
         PreToolUse: 'watch',
@@ -126,8 +130,8 @@ const FALLBACK_REGISTRY = {
     opencode: {
       format: 'oc-plugin',
       processNames: ['opencode'],
-      // opencode 自带的会话标题是模型对提问的摘要，违反隐私约束（spec §6.4），不用
-      titleSources: ['git-branch', 'project'],
+      // opencode 自己生成的会话标题（插件从 session.updated 取，随事件传 oc_session_title），没有就用首条指令
+      titleSources: ['oc-session-title', 'first-prompt', 'git-branch', 'project'],
       events: {
         UserPromptSubmit: 'watch',
         PreToolUse: 'watch',
@@ -321,7 +325,137 @@ function readGitBranch(cwd, maxUp) {
   return null
 }
 
-/** 按 registry 给的顺序逐级回落。所有来源都不碰 prompt 原文。 */
+/** 首条指令当标题时的最大字数（按字符），与 src/core/title.ts 一致 */
+const FIRST_PROMPT_MAX = 30
+
+/** 用户指令 → 可上屏的短标题，与 src/core/title.ts 的 cleanPrompt 一致 */
+function cleanPrompt(text) {
+  if (typeof text !== 'string') return ''
+  // eslint-disable-next-line no-control-regex
+  const flat = text.replace(/[\u0000-\u001f\u007f-\u009f\u2028\u2029]+/g, ' ').replace(/\s+/g, ' ').trim()
+  const chars = Array.from(flat)
+  return chars.length > FIRST_PROMPT_MAX ? chars.slice(0, FIRST_PROMPT_MAX).join('').trimEnd() + '…' : flat
+}
+
+/** 会话库标题的最大字数，与 src/core/title.ts 一致 */
+const SESSION_TITLE_MAX = 100
+
+/** 外部来的标题清洗，与 src/core/title.ts 的 cleanTitle 一致 */
+function cleanTitle(text) {
+  if (typeof text !== 'string') return ''
+  // eslint-disable-next-line no-control-regex
+  const flat = text.replace(/[\u0000-\u001f\u007f-\u009f\u2028\u2029]+/g, ' ').replace(/\s+/g, ' ').trim()
+  return Array.from(flat).slice(0, SESSION_TITLE_MAX).join('').trimEnd()
+}
+
+/**
+ * node:sqlite 是 Node 内置模块（22.13+ / 23.4+ 免 flag），更老的 Node require 直接抛，调用方跳过。
+ * 加载时的 ExperimentalWarning 吞掉，免得打进智能体的 hook 输出
+ */
+function loadNodeSqlite() {
+  const orig = process.emitWarning
+  process.emitWarning = function () {
+    if (String(arguments[0] == null ? '' : arguments[0]).indexOf('SQLite') !== -1) return
+    return orig.apply(process, arguments)
+  }
+  try {
+    return require('node:sqlite')
+  } finally {
+    process.emitWarning = orig
+  }
+}
+
+/** Qoder 桌面端会话库候选路径，与 src/core/title.ts 的 qoderDbPaths 一致（来源与未核对项见那边注释） */
+function qoderDbPaths(platform, home, env) {
+  const pf = platform || process.platform
+  const h = home || os.homedir()
+  const e = env || process.env
+  let root
+  if (pf === 'darwin') root = path.join(h, 'Library', 'Application Support')
+  else if (pf === 'win32') root = e.APPDATA || path.join(h, 'AppData', 'Roaming')
+  else root = e.XDG_CONFIG_HOME || path.join(h, '.config')
+  return ['com.qodercn.app.stable', 'com.qoder.app.stable'].map((d) => path.join(root, d, 'main.sqlite'))
+}
+
+/** Qoder 桌面端的会话标题（chat_sessions.title），与 src/core/title.ts 一致。任何失败返回 null */
+function readQoderSessionTitle(sessionId, paths, load) {
+  if (!sessionId) return null
+  const existing = (paths || qoderDbPaths()).filter((p) => fs.existsSync(p))
+  if (existing.length === 0) return null
+  let mod
+  try {
+    mod = (load || loadNodeSqlite)()
+  } catch (e) {
+    return null
+  }
+  for (const p of existing) {
+    let db
+    try {
+      db = new mod.DatabaseSync(p, { readOnly: true })
+      const row = db.prepare('select title from chat_sessions where session_id = ?').get(sessionId)
+      const t = cleanTitle(row && row.title)
+      if (t) return t
+    } catch (e) {
+      /* 这个库读不了，试下一个 */
+    } finally {
+      try {
+        if (db) db.close()
+      } catch (e) {
+        /* ignore */
+      }
+    }
+  }
+  return null
+}
+
+// ---------- 非项目目录（与 src/core/dirFilter.ts 同构） ----------
+
+function dirNorm(p, win) {
+  if (win) return path.win32.resolve(p).replace(/[\\/]+$/, '').toLowerCase()
+  return path.posix.resolve(p).replace(/\/+$/, '')
+}
+
+function dirUnder(p, base, win) {
+  return p === base || p.startsWith(base + (win ? '\\' : '/'))
+}
+
+/**
+ * 智能体按时间自动建的工作区。WorkBuddy：<主目录>/WorkBuddy/<日期开头>（5.6.2 实测 2026-09-24-18-50-03 /
+ * 20260430143452 / 2026-05-16-task-1）；Qoder CN：<主目录>/Documents/Qoder/<YYYY-MM-DD>/<8 位十六进制>
+ */
+function isAutoWorkspace(p, opts) {
+  if (!p) return false
+  const o = opts || {}
+  const win = (o.platform || process.platform) === 'win32'
+  const P = win ? path.win32 : path.posix
+  const home = dirNorm(o.home || os.homedir(), win)
+  const full = dirNorm(p, win)
+  const name = P.basename(full)
+  const parent = P.dirname(full)
+  if (parent === dirNorm(P.join(home, 'WorkBuddy'), win) && /^\d{4}-?\d{2}-?\d{2}/.test(name)) return true
+  return (
+    P.dirname(parent) === dirNorm(P.join(home, 'Documents', 'Qoder'), win) &&
+    /^\d{4}-\d{2}-\d{2}$/.test(P.basename(parent)) &&
+    /^[0-9a-f]{8}$/i.test(name)
+  )
+}
+
+/** 能不能作为最近项目目录上报：主目录 / 根目录 / 临时目录及其下 / 自动工作区都不报 */
+function isReportableDir(p, opts) {
+  if (!p) return false
+  const o = opts || {}
+  const win = (o.platform || process.platform) === 'win32'
+  const P = win ? path.win32 : path.posix
+  const full = dirNorm(p, win)
+  if (full === dirNorm(P.parse(P.resolve(p)).root, win)) return false
+  if (full === dirNorm(o.home || os.homedir(), win)) return false
+  const tmps = [o.tmp || os.tmpdir()]
+  if (!win) tmps.push('/tmp', '/private/tmp', '/var/folders', '/private/var/folders')
+  for (const t of tmps) if (t && dirUnder(full, dirNorm(t, win), win)) return false
+  return !isAutoWorkspace(p, o)
+}
+
+/** 按 registry 给的顺序逐级回落。只有 first-prompt 用到 prompt（首条指令前 30 字），其余来源不碰 prompt 原文。 */
 function resolveTitle(sources, ctx) {
   const list = sources || []
   for (const source of list) {
@@ -329,7 +463,10 @@ function resolveTitle(sources, ctx) {
     if (source === 'cc-ai-title') value = readAiTitle(ctx.transcriptPath)
     else if (source === 'codex-thread-name') value = readCodexThreadName(ctx.sessionId, ctx.codexHome)
     else if (source === 'git-branch') value = readGitBranch(ctx.cwd)
-    else if (source === 'project') value = path.basename(ctx.cwd || '') || null
+    else if (source === 'first-prompt') value = ctx.firstPrompt || null
+    else if (source === 'qoder-session-title') value = readQoderSessionTitle(ctx.sessionId, ctx.qoderDbPaths, ctx.loadSqlite)
+    else if (source === 'oc-session-title') value = typeof ctx.ocSessionTitle === 'string' ? ctx.ocSessionTitle.trim() || null : null
+    else if (source === 'project') value = ctx.cwd && !isAutoWorkspace(ctx.cwd) ? path.basename(ctx.cwd) || null : null
     // 不认识的来源直接跳过：新来源应该先发版再进 registry
     if (value) return value
   }
@@ -949,7 +1086,8 @@ const DIRS_KEEP = 30
 
 /** UserPromptSubmit 时记下工作目录：{全路径: 最近使用毫秒}。🔴 全路径只留本机 */
 function recordDir(cwd, now) {
-  if (!cwd) return
+  // 主目录 / 临时目录 / 自动工作区不记，免得把真正的项目挤出 DIRS_KEEP
+  if (!cwd || !isReportableDir(cwd)) return
   const file = path.join(deskbuddyHome(), 'dirs.json')
   let map = {}
   try {
@@ -1157,7 +1295,13 @@ async function main(argv) {
   const prev = readState(sessionId)
   const now = Date.now()
   if (event === 'UserPromptSubmit') recordDir(payload.cwd, now)
-  if (superseded(prev, eventAt)) return
+  // 首条指令（标题来源 first-prompt）：只记第一次
+  const firstPrompt = (prev && prev.firstPrompt) || (event === 'UserPromptSubmit' ? cleanPrompt(payload.prompt) : '') || undefined
+  if (superseded(prev, eventAt)) {
+    // 被并发的更晚事件（多半是同一轮的 Stop）抢先写了：状态不覆盖，但首条指令要补上，不然标题就成了第二条指令
+    if (firstPrompt && !prev.firstPrompt) writeState(Object.assign({}, prev, { firstPrompt: firstPrompt }))
+    return
+  }
   // 状态里记的进程还活着才沿用（评审）：先远程 -p 跑过、后又在窗口 resume 同一会话时，
   // 不能拿死掉的 -p 进程的 interactive=false 挡不住窗口
   const prevAlive = !!(prev && prev.pid && pidExists(prev.pid))
@@ -1196,6 +1340,7 @@ async function main(argv) {
         at: now,
       },
     ])).slice(-RECENT_MAX),
+    firstPrompt: firstPrompt,
   }
 
   // 进 / 出 DeskBuddy 窗口不一定伴随状态跃迁（窗口里 --resume 一个已完成的会话），要立刻报，否则设备最长 2 分钟仍被 8348 挡
@@ -1203,7 +1348,10 @@ async function main(argv) {
   // 跃迁要跟磁盘上的最新状态比，不能只跟开头读到的 prev 比（评审）：上一轮停在 done 时 Stop 读到的 prev 是旧 done，
   // 并发的 UserPromptSubmit 已把 watch 写盘并上报了，Stop 若按 done→done 静默落盘，设备收到的最后一份就是 watch
   const latest = readState(sessionId)
-  if (superseded(latest, eventAt)) return
+  if (superseded(latest, eventAt)) {
+    if (next.firstPrompt && !latest.firstPrompt) writeState(Object.assign({}, latest, { firstPrompt: next.firstPrompt }))
+    return
+  }
   if (!windowChanged && !shouldReport(latest || prev, next, now)) {
     writeState(next)
     return
@@ -1216,12 +1364,18 @@ async function main(argv) {
       transcriptPath: payload.transcript_path,
       cwd: next.project,
       sessionId: sessionId,
+      firstPrompt: next.firstPrompt,
+      ocSessionTitle: payload.oc_session_title,
     }) ||
     next.title ||
     ''
   next.lastReportAt = now
   // 取标题 / 查进程期间可能已有更晚发生的事件写完了：那份更新，这次既不落盘也不上报
-  if (superseded(readState(sessionId), eventAt)) return
+  const last = readState(sessionId)
+  if (superseded(last, eventAt)) {
+    if (next.firstPrompt && !last.firstPrompt) writeState(Object.assign({}, last, { firstPrompt: next.firstPrompt }))
+    return
+  }
   writeState(next)
 
   await reportIfAuthorized(tool, now)
@@ -1261,6 +1415,14 @@ module.exports = {
   readAliveStates,
   readCodexThreadName,
   readGitBranch,
+  cleanPrompt,
+  cleanTitle,
+  FIRST_PROMPT_MAX,
+  SESSION_TITLE_MAX,
+  qoderDbPaths,
+  readQoderSessionTitle,
+  isAutoWorkspace,
+  isReportableDir,
   readState,
   removeState,
   retireState,

package/dist/launcher.cjs

@@ -0,0 +1,229 @@
+'use strict'
+/**
+ * DeskBuddy 稳定入口（自动升级 spec 2026-10-01 §4.1）。
+ *
+ * 开机自启固定执行 `node ~/.deskbuddy/launcher.cjs daemon`，不再写死某一版 CLI 的路径：
+ * 跑哪一版由 ~/.deskbuddy/versions/current.json 决定。
+ *
+ * 🔴 只能用 Node 内置模块：它随 hook 一起被复制到 ~/.deskbuddy，旁边没有 node_modules。
+ * 🔴 current.json / failed.json / crashes.json 的格式与 src/core/versions.ts 共用，改一边必须改另一边。
+ *
+ * - 正常：spawn `node <cliPath> daemon`，stdio 继承，退出码透传，由系统自启负责重拉
+ *   （Windows 的「启动」文件夹不会重拉：verifying 期间由本进程自己隔 10 秒重拉，见 main）
+ * - state=verifying 时子进程 5 分钟内异常退出累计 3 次 → 切回 previous、把这一版记进 failed.json、写 daemon.log
+ */
+const fs = require('node:fs')
+const os = require('node:os')
+const path = require('node:path')
+const { spawn } = require('node:child_process')
+
+const CRASH_WINDOW_MS = 5 * 60 * 1000
+const CRASH_LIMIT = 3
+const WIN_RESTART_MS = 10 * 1000
+
+function home(env) {
+  return (env || process.env).DESKBUDDY_HOME || path.join(os.homedir(), '.deskbuddy')
+}
+
+function paths(h) {
+  const versions = path.join(h, 'versions')
+  return {
+    versions,
+    current: path.join(versions, 'current.json'),
+    failed: path.join(versions, 'failed.json'),
+    crashes: path.join(versions, 'crashes.json'),
+    log: path.join(h, 'daemon.log'),
+    pid: path.join(h, 'launcher.pid'),
+  }
+}
+
+function readJson(p) {
+  try {
+    return JSON.parse(fs.readFileSync(p, 'utf8'))
+  } catch {
+    return null
+  }
+}
+
+function writeJson(p, v) {
+  fs.mkdirSync(path.dirname(p), { recursive: true })
+  const tmp = p + '.' + process.pid + '.tmp'
+  fs.writeFileSync(tmp, JSON.stringify(v, null, 2), 'utf8')
+  fs.renameSync(tmp, p)
+}
+
+function log(h, line) {
+  try {
+    fs.mkdirSync(h, { recursive: true })
+    fs.appendFileSync(paths(h).log, new Date().toISOString() + ' [launcher] ' + line + '\n', 'utf8')
+  } catch {
+    /* 写不了日志不能挡住启动 */
+  }
+}
+
+function isRef(r) {
+  return !!r && typeof r.version === 'string' && typeof r.cliPath === 'string' && r.cliPath !== ''
+}
+
+function readCurrent(h) {
+  const c = readJson(paths(h).current)
+  if (!isRef(c)) return null
+  return {
+    version: c.version,
+    cliPath: c.cliPath,
+    previous: isRef(c.previous) ? { version: c.previous.version, cliPath: c.previous.cliPath } : null,
+    state: c.state === 'verifying' ? 'verifying' : 'good',
+    switchedAt: typeof c.switchedAt === 'number' ? c.switchedAt : 0,
+  }
+}
+
+/**
+ * 切回 previous。markFailed=true 时把出问题的版本记进 failed.json（之后不再自动升到它）。
+ * 返回切过去的版本；没有可退的返回 null
+ */
+function rollback(h, cur, why, now, markFailed) {
+  const p = paths(h)
+  if (!cur.previous || !fs.existsSync(cur.previous.cliPath)) {
+    log(h, '版本 ' + cur.version + ' ' + why + '，但没有可回退的上一版本，继续用它')
+    return null
+  }
+  writeJson(p.current, {
+    version: cur.previous.version,
+    cliPath: cur.previous.cliPath,
+    // 出问题的那版留作 previous：目录不会被清理，便于排查
+    previous: { version: cur.version, cliPath: cur.cliPath },
+    state: 'good',
+    switchedAt: now,
+  })
+  if (markFailed) {
+    const f = readJson(p.failed) || {}
+    const versions = Array.isArray(f.versions) ? f.versions.filter((v) => typeof v === 'string') : []
+    if (!versions.includes(cur.version)) versions.push(cur.version)
+    writeJson(p.failed, { versions, attempts: f.attempts && typeof f.attempts === 'object' ? f.attempts : {} })
+  }
+  try {
+    fs.rmSync(p.crashes, { force: true })
+  } catch {
+    /* ignore */
+  }
+  log(h, '版本 ' + cur.version + ' ' + why + '，已回滚到 ' + cur.previous.version + (markFailed ? '，之后不再自动升到 ' + cur.version : ''))
+  return cur.previous.version
+}
+
+/**
+ * 选这次要跑的那份：current；它的 cliPath 不在了 → 退回 previous（verifying 时同时记失败）。
+ * 返回 null = 没有可跑的
+ */
+function pickTarget(h, now) {
+  let cur = readCurrent(h)
+  if (!cur) return null
+  if (!fs.existsSync(cur.cliPath)) {
+    // 🔴 只有 verifying（刚切过来、没验证过）才拉黑：good 版本的文件被误删 / 被清理不代表这一版有问题（评审 5）
+    if (rollback(h, cur, '的入口文件不存在', now, cur.state === 'verifying') === null) return null
+    cur = readCurrent(h)
+    if (!cur || !fs.existsSync(cur.cliPath)) return null
+  }
+  return cur
+}
+
+/**
+ * 子进程异常退出一次：verifying 期间记崩溃，5 分钟内满 3 次回滚。返回是否回滚了
+ */
+function recordCrash(h, cur, now) {
+  if (cur.state !== 'verifying') return false
+  const p = paths(h)
+  const prev = readJson(p.crashes)
+  let times = prev && prev.version === cur.version && Array.isArray(prev.times) ? prev.times.filter((t) => typeof t === 'number') : []
+  times = times.filter((t) => now - t < CRASH_WINDOW_MS)
+  times.push(now)
+  writeJson(p.crashes, { version: cur.version, times })
+  log(h, '版本 ' + cur.version + ' 验证期内异常退出（5 分钟内第 ' + times.length + ' 次）')
+  if (times.length < CRASH_LIMIT) return false
+  return rollback(h, cur, '验证期内 5 分钟崩溃 ' + times.length + ' 次', now, true) !== null
+}
+
+/**
+ * 子进程环境：剔除自动切换用的 FROM_* 变量（Windows 上 update --auto 直接拉起 launcher 时会继承它们），
+ * 免得一路传到 daemon 起的智能体子进程里。名字与 src/daemon/autoUpdate.ts 一致
+ */
+const SWITCH_ENV_KEYS = ['DESKBUDDY_UPDATE_FROM_VERSION', 'DESKBUDDY_UPDATE_FROM_CLI']
+function childEnv(env) {
+  const out = Object.assign({}, env)
+  for (const k of SWITCH_ENV_KEYS) delete out[k]
+  return out
+}
+
+function runOnce(h, cur, args) {
+  return new Promise((resolve) => {
+    let stopping = false
+    const child = spawn(process.execPath, [cur.cliPath, ...args], { stdio: 'inherit', windowsHide: true, env: childEnv(process.env) })
+    const forward = (sig) => {
+      stopping = true
+      try {
+        child.kill(sig)
+      } catch {
+        /* 已经退了 */
+      }
+    }
+    const handlers = {}
+    for (const sig of ['SIGTERM', 'SIGINT', 'SIGHUP']) {
+      handlers[sig] = () => forward(sig)
+      process.on(sig, handlers[sig])
+    }
+    const done = (code, signal, err) => {
+      for (const sig of Object.keys(handlers)) process.removeListener(sig, handlers[sig])
+      resolve({ code, signal, stopping, err })
+    }
+    child.on('error', (e) => done(null, null, e))
+    child.on('exit', (code, signal) => done(code, signal, null))
+  })
+}
+
+async function main(argv, deps) {
+  const d = deps || {}
+  const h = home(d.env)
+  const platform = d.platform || process.platform
+  const now = d.now || (() => Date.now())
+  const args = argv.length > 0 ? argv : ['daemon']
+  const run = d.runOnce || ((cur) => runOnce(h, cur, args))
+  const sleep = d.sleep || ((ms) => new Promise((r) => setTimeout(r, ms)))
+  try {
+    fs.mkdirSync(h, { recursive: true })
+    fs.writeFileSync(paths(h).pid, String(process.pid), 'utf8')
+  } catch {
+    /* 记不上 pid：Windows 升级时停不掉本进程，最坏多一个 launcher 在等子进程 */
+  }
+  for (;;) {
+    const cur = pickTarget(h, now())
+    if (!cur) {
+      // 🔴 返回 0：launchd（SuccessfulExit=false）/ systemd（on-failure）都不再重拉 —— 返回非 0 会每 10 秒重拉一次刷满日志（评审 4）
+      log(
+        h,
+        '没有可运行的 CLI（' + paths(h).current + ' 缺失，或它和上一版本指向的文件都不在）。守护进程不再自动重启；' +
+          '恢复办法：在终端执行 npx -y deskbuddy@beta update'
+      )
+      return 0
+    }
+    const r = await run(cur)
+    const abnormal = !r.stopping && (r.err || r.signal || r.code !== 0)
+    if (r.err) log(h, '起不来版本 ' + cur.version + '：' + r.err.message)
+    if (!abnormal) return r.code == null ? 0 : r.code
+    const rolledBack = recordCrash(h, cur, now())
+    // 非 Windows：交给 launchd / systemd 按「非正常退出」重拉（它们会重新执行本 launcher，读到回滚后的 current.json）
+    // Windows：「启动」文件夹只在登录时跑一次，崩了没人拉 —— verifying 期间（或刚回滚）自己重拉，否则保持原来的行为直接退出
+    if (platform !== 'win32' || (cur.state !== 'verifying' && !rolledBack)) return r.code == null ? 1 : r.code || 1
+    await sleep(WIN_RESTART_MS)
+  }
+}
+
+module.exports = { main, childEnv, SWITCH_ENV_KEYS, pickTarget, recordCrash, rollback, readCurrent, paths, CRASH_WINDOW_MS, CRASH_LIMIT }
+
+if (require.main === module) {
+  main(process.argv.slice(2)).then(
+    (code) => process.exit(code),
+    (e) => {
+      log(home(), 'launcher 出错：' + (e && e.stack ? e.stack : String(e)))
+      process.exit(1)
+    }
+  )
+}

package/dist/opencode.mjs

@@ -130,6 +130,26 @@ export function openPermissions(cfg) {
   if (build && build.permission && typeof build.permission === 'object') open(build.permission)
 }
 
+/** chat.message 的 output（{ message, parts }）里用户自己打的字：text 类 part，跳过 synthetic（插件 / 系统补的） */
+export function userText(output) {
+  const parts = output && Array.isArray(output.parts) ? output.parts : []
+  return parts
+    .filter((p) => p && p.type === 'text' && !p.synthetic && typeof p.text === 'string')
+    .map((p) => p.text)
+    .join('\n')
+}
+
+/** opencode 起标题前的占位名（1.18.32 isDefaultTitle：`New session - ` / `Child session - ` + ISO 时间），不当标题 */
+const OC_DEFAULT_TITLE_RE = /^(New session - |Child session - )\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/
+
+/** session.updated 的 info → 记下自动标题。子会话（subagent，带 parentID）、占位名不记 */
+export function rememberTitle(titles, info) {
+  if (!info || typeof info.id !== 'string' || !info.id || info.parentID) return
+  const t = typeof info.title === 'string' ? info.title.trim() : ''
+  if (!t || OC_DEFAULT_TITLE_RE.test(t)) return
+  titles.set(info.id, t.slice(0, 100))
+}
+
 /** 活着的子进程；opencode 退出时一并结束，不留孤儿 gate 挂着设备卡片（评审） */
 const LIVE = new Set()
 process.on('exit', () => {
@@ -183,9 +203,12 @@ export function make(opts = {}) {
 
     // ---- 状态上报：串行喂 hook.cjs，保证 PreToolUse / PostToolUse / Stop 的先后 ----
     let queue = Promise.resolve()
+    const titles = new Map() // sessionID → opencode 自动生成的标题（session.updated 里来）
     const report = (event, sessionID, extra) => {
       if (!sessionID) return
       const input = { hook_event_name: event, session_id: sessionID, cwd, ...extra }
+      const title = titles.get(sessionID)
+      if (title) input.oc_session_title = title
       queue = queue.then(() => runChild(node, HOOK, [TOOL], input, HOOK_KILL_MS)).catch(() => {})
     }
 
@@ -273,8 +296,9 @@ export function make(opts = {}) {
         if (runId) openPermissions(cfg)
       },
 
-      'chat.message': async (input) => {
-        report('UserPromptSubmit', input && input.sessionID)
+      'chat.message': async (input, output) => {
+        // prompt 给 hook 的 first-prompt 标题来源用（只记首条，见 hook.cjs）
+        report('UserPromptSubmit', input && input.sessionID, { prompt: userText(output) })
       },
 
       'tool.execute.before': async (input, output) => {
@@ -318,6 +342,9 @@ export function make(opts = {}) {
           case 'session.idle':
             report('Stop', p.sessionID)
             break
+          case 'session.updated':
+            rememberTitle(titles, p.info)
+            break
           case 'session.deleted':
             report('SessionEnd', (p.info && p.info.id) || p.sessionID)
             break