agentquad 0.4.1 → 0.4.3

package/src/lark-post.js

@@ -0,0 +1,285 @@
+/**
+ * Markdown → 飞书 post 富文本 AST。
+ * 主线场景：LLM / plan 完成通知这类含表格 + 多级标题的长 markdown，发飞书时
+ * 不再降级成纯文本被 toLarkText 摊平，改成 post 富文本，让飞书原生渲染粗体、
+ * 链接、代码块。
+ *
+ * post 的能力边界：
+ *   - text (style: bold/italic/underline/lineThrough), a, at, img, code_block, hr
+ *   - 没有 heading 多级、没有 table、没有 list 原语，全部要自己用前缀/样式模拟
+ *
+ * 输出形状（飞书 im.message.create 直传）：
+ *   { zh_cn: { title?: '', content: [[ {tag,...}, ... ], ...] } }
+ *   content 是"段落数组"，每段是 tag 数组，段间飞书自动换行。
+ */
+
+// 块级 markdown 判据：只有命中"块级"特征才升级到 post，避免普通正文里偶尔
+// 出现的 **bold** / *italic* 误触发。
+const BLOCK_PATTERNS = [
+  /^#{1,6}\s/m,            // 行首 1-6 个 # + 空格
+  /^\|.*\|\s*$\n\s*\|\s*[-:|\s]+\|/m, // 表格：行首 | + 紧跟分隔行
+  /^```/m,                 // 围栏代码块
+  /^[-*]\s/m,              // 列表 - / *
+  /^\d+\.\s/m,             // 列表 1.
+  /^>\s/m,                 // 引用
+]
+
+export function isMarkdownLike(text) {
+  if (typeof text !== 'string' || !text) return false
+  return BLOCK_PATTERNS.some((re) => re.test(text))
+}
+
+const HEADER_PREFIX = ['━━━ ', '▎', '· ', '· ', '· ', '· ']
+
+/**
+ * 把行内 markdown（**bold**, *italic*, [text](url), `code`）切成 post tag 数组。
+ * 不处理块级元素。
+ */
+function inlineTokens(line) {
+  const tokens = []
+  let i = 0
+  const len = line.length
+
+  function pushText(text, style) {
+    if (!text) return
+    const node = { tag: 'text', text }
+    if (style && style.length) node.style = style
+    tokens.push(node)
+  }
+
+  let buf = ''
+  while (i < len) {
+    // 链接 [label](url)
+    const linkMatch = line.slice(i).match(/^\[([^\]]+)\]\(([^)]+)\)/)
+    if (linkMatch) {
+      pushText(buf); buf = ''
+      tokens.push({ tag: 'a', text: linkMatch[1], href: linkMatch[2] })
+      i += linkMatch[0].length
+      continue
+    }
+    // 粗体 **x**
+    if (line[i] === '*' && line[i + 1] === '*') {
+      const end = line.indexOf('**', i + 2)
+      if (end > i + 2) {
+        pushText(buf); buf = ''
+        pushText(line.slice(i + 2, end), ['bold'])
+        i = end + 2
+        continue
+      }
+    }
+    // 粗体 __x__
+    if (line[i] === '_' && line[i + 1] === '_') {
+      const end = line.indexOf('__', i + 2)
+      if (end > i + 2) {
+        pushText(buf); buf = ''
+        pushText(line.slice(i + 2, end), ['bold'])
+        i = end + 2
+        continue
+      }
+    }
+    // 斜体 *x*（前后非字母/星号/反斜杠）
+    if (line[i] === '*' && line[i - 1] !== '*' && line[i + 1] !== '*' && line[i + 1] !== ' ' && line[i - 1] !== '\\') {
+      const rest = line.slice(i + 1)
+      const m = rest.match(/^([^*\n]+?)\*(?!\w)/)
+      if (m) {
+        pushText(buf); buf = ''
+        pushText(m[1], ['italic'])
+        i += 1 + m[0].length
+        continue
+      }
+    }
+    // inline code `code` → post 无 inline code，用斜体近似（保留 backtick 视觉提示）
+    if (line[i] === '`') {
+      const end = line.indexOf('`', i + 1)
+      if (end > i + 1) {
+        pushText(buf); buf = ''
+        pushText(line.slice(i + 1, end), ['italic'])
+        i = end + 1
+        continue
+      }
+    }
+    buf += line[i]
+    i += 1
+  }
+  pushText(buf)
+  return tokens
+}
+
+function isTableSeparator(line) {
+  return /^\s*\|?\s*:?-+:?\s*(\|\s*:?-+:?\s*)+\|?\s*$/.test(line)
+}
+
+function splitTableRow(line) {
+  // 允许首尾 | 也允许没有；按未转义的 | 切
+  let s = line.trim()
+  if (s.startsWith('|')) s = s.slice(1)
+  if (s.endsWith('|')) s = s.slice(0, -1)
+  return s.split('|').map((c) => c.trim() || '—')
+}
+
+/**
+ * 把一段连续表格行转成 post 段落数组：
+ *   - 表头行 → "**h1** | **h2** | ..."
+ *   - 数据行 → "**c1** · c2 · c3 · ..."（首列 bold 当行锚点）
+ */
+function renderTable(headerLine, dataLines) {
+  const paragraphs = []
+  const headers = splitTableRow(headerLine)
+  const headerTokens = []
+  headers.forEach((h, idx) => {
+    if (idx > 0) headerTokens.push({ tag: 'text', text: ' | ' })
+    headerTokens.push({ tag: 'text', text: h, style: ['bold'] })
+  })
+  paragraphs.push(headerTokens)
+
+  for (const row of dataLines) {
+    const cells = splitTableRow(row)
+    const rowTokens = []
+    cells.forEach((c, idx) => {
+      if (idx === 0) {
+        rowTokens.push({ tag: 'text', text: c, style: ['bold'] })
+      } else {
+        rowTokens.push({ tag: 'text', text: ' · ' })
+        // 单元格内的行内 markdown 也展开
+        const inline = inlineTokens(c)
+        for (const t of inline) rowTokens.push(t)
+      }
+    })
+    paragraphs.push(rowTokens)
+  }
+  return paragraphs
+}
+
+/**
+ * 主转换：markdown 字符串 → post AST { zh_cn: { content: [[...]] } }
+ */
+export function toLarkPost(markdown) {
+  const text = typeof markdown === 'string' ? markdown : String(markdown ?? '')
+  const lines = text.split('\n')
+  const content = []
+  let i = 0
+
+  while (i < lines.length) {
+    const line = lines[i]
+    const trimmed = line.trimEnd()
+
+    // 围栏代码块
+    const fenceMatch = trimmed.match(/^```([a-zA-Z0-9_+-]*)\s*$/)
+    if (fenceMatch) {
+      const language = fenceMatch[1] || ''
+      const codeLines = []
+      i += 1
+      while (i < lines.length && !/^```\s*$/.test(lines[i])) {
+        codeLines.push(lines[i])
+        i += 1
+      }
+      i += 1 // 跳过闭合 ```
+      const codeText = codeLines.join('\n')
+      const node = { tag: 'code_block', text: codeText }
+      if (language) node.language = language
+      content.push([node])
+      continue
+    }
+
+    // 水平线
+    if (/^\s*([-*_])\1{2,}\s*$/.test(trimmed)) {
+      content.push([{ tag: 'hr' }])
+      i += 1
+      continue
+    }
+
+    // 标题
+    const headingMatch = trimmed.match(/^(#{1,6})\s+(.*)$/)
+    if (headingMatch) {
+      const level = headingMatch[1].length
+      const body = headingMatch[2].trim()
+      const prefix = HEADER_PREFIX[level - 1] || '· '
+      const suffix = level === 1 ? ' ━━━' : ''
+      content.push([{ tag: 'text', text: `${prefix}${body}${suffix}`, style: ['bold'] }])
+      i += 1
+      continue
+    }
+
+    // 表格：当前行像 | a | b | 且下一行是分隔行
+    if (/^\s*\|.*\|\s*$/.test(trimmed) && i + 1 < lines.length && isTableSeparator(lines[i + 1])) {
+      const headerLine = trimmed
+      const dataLines = []
+      i += 2 // 跳过 header + 分隔
+      while (i < lines.length && /^\s*\|.*\|\s*$/.test(lines[i])) {
+        dataLines.push(lines[i].trimEnd())
+        i += 1
+      }
+      const paragraphs = renderTable(headerLine, dataLines)
+      for (const p of paragraphs) content.push(p)
+      continue
+    }
+
+    // 引用 > x
+    const quoteMatch = trimmed.match(/^>\s?(.*)$/)
+    if (quoteMatch) {
+      const inner = quoteMatch[1]
+      content.push([
+        { tag: 'text', text: '▎ ' },
+        ...inlineTokens(inner),
+      ])
+      i += 1
+      continue
+    }
+
+    // 列表项
+    const ulMatch = line.match(/^(\s*)([-*])\s+(.*)$/)
+    if (ulMatch) {
+      const indent = ulMatch[1]
+      const body = ulMatch[3]
+      content.push([
+        { tag: 'text', text: `${indent}• ` },
+        ...inlineTokens(body),
+      ])
+      i += 1
+      continue
+    }
+    const olMatch = line.match(/^(\s*)(\d+)\.\s+(.*)$/)
+    if (olMatch) {
+      const indent = olMatch[1]
+      const num = olMatch[2]
+      const body = olMatch[3]
+      content.push([
+        { tag: 'text', text: `${indent}${num}. ` },
+        ...inlineTokens(body),
+      ])
+      i += 1
+      continue
+    }
+
+    // 空行：插入一个空段落让飞书产生段间距
+    if (trimmed === '') {
+      content.push([{ tag: 'text', text: '' }])
+      i += 1
+      continue
+    }
+
+    // 图片：丢弃
+    if (/^\s*!\[[^\]]*\]\([^)]+\)\s*$/.test(trimmed)) {
+      i += 1
+      continue
+    }
+
+    // 普通段落
+    // 处理行内图片：删除
+    const cleaned = line.replace(/!\[[^\]]*\]\([^)]+\)/g, '')
+    content.push(inlineTokens(cleaned))
+    i += 1
+  }
+
+  // 修剪末尾的空段落
+  while (content.length > 0) {
+    const last = content[content.length - 1]
+    if (last.length === 1 && last[0].tag === 'text' && last[0].text === '') {
+      content.pop()
+    } else {
+      break
+    }
+  }
+
+  return { zh_cn: { content } }
+}

package/src/mcp/server.js

@@ -13,8 +13,10 @@ const SERVER_NAME = 'agentquad'
 /**
  * 创建一个挂在 Express 下的 MCP Streamable HTTP 路由。
  *
- * 工作方式：一个全局 McpServer + 一个全局 StreamableHTTPServerTransport，stateless 模式。
- * 每个 HTTP 请求都由 transport.handleRequest 完整处理。
+ * 关键：MCP SDK 的 stateless 模式（sessionIdGenerator: undefined）规定每个 HTTP 请求
+ * 必须用新的 transport —— 共享会抛 "Stateless transport cannot be reused"。所以我们
+ * 在每次请求时新建 transport + server + tool 注册，audit / scanner 这种重对象在 router
+ * 工厂里建一次就够，复用给每个 per-request server。
  *
  * 依赖：
  *   - db：openDb(...) 返回的句柄
@@ -33,34 +35,45 @@ export function createMcpRouter({
   if (!db) throw new Error('db_required')
   if (!searchService) throw new Error('searchService_required')
 
-  const server = new McpServer({
-    name: SERVER_NAME,
-    version: (typeof getVersion === 'function' && getVersion()) || '0.1.0',
-  })
-
+  // 重对象只建一次，复用给 per-request server
   const audit = rootDir ? createAuditLog({ rootDir }) : null
   const transcriptScanner = logDir ? createTranscriptScanner({ db, logDir }) : null
+  const serverVersion = (typeof getVersion === 'function' && getVersion()) || '0.1.0'
 
-  registerReadTools(server, { db, searchService, wikiDir, transcriptScanner })
-  registerWriteTools(server, { db })
-  registerDestructiveTools(server, { db, audit })
-  if (pending) {
-    registerOpenClawTools(server, { db, aiTerminal, openclaw, pending, getConfig })
+  function buildServer() {
+    const server = new McpServer({ name: SERVER_NAME, version: serverVersion })
+    registerReadTools(server, { db, searchService, wikiDir, transcriptScanner })
+    registerWriteTools(server, { db })
+    registerDestructiveTools(server, { db, audit })
+    if (pending) {
+      registerOpenClawTools(server, { db, aiTerminal, openclaw, pending, getConfig })
+    }
+    return server
   }
 
-  const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined })
-  // 异步 connect；路由处理器会等这个 promise resolve 之后再调 handleRequest。
-  const ready = server.connect(transport)
-
   const router = express.Router()
   // MCP Streamable HTTP 约定：客户端用 POST /mcp 下发 JSON-RPC；
-  // 对于 SSE 变体或重连，GET 会触发会话初始化。
-  // 我们是 stateless mode，所以两种方法都交给 transport.handleRequest。
+  // SSE 重连或 server-sent 流走 GET。stateless 模式下两种方法都走同一段：
+  // 每请求一个全新 transport + server。
   const handle = async (req, res) => {
+    let transport
+    let server
     try {
-      await ready
+      transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined })
+      server = buildServer()
+      await server.connect(transport)
+
+      // 请求结束/客户端断开时清理；防止泄漏
+      res.on('close', () => {
+        try { transport.close?.() } catch { /* ignore */ }
+        try { server.close?.() } catch { /* ignore */ }
+      })
+
       await transport.handleRequest(req, res, req.body)
     } catch (e) {
+      console.error('[mcp] handleRequest threw:', e?.stack || e?.message || e)
+      try { transport?.close?.() } catch { /* ignore */ }
+      try { server?.close?.() } catch { /* ignore */ }
       if (!res.headersSent) {
         res.status(500).json({
           jsonrpc: '2.0',
@@ -76,8 +89,8 @@ export function createMcpRouter({
 
   // 健康检查（MCP 客户端一般不走这个，但方便 `agentquad mcp status` 和运维）
   router.get('/health', (_req, res) => {
-    res.json({ ok: true, server: SERVER_NAME, tools: server._registeredTools ? Object.keys(server._registeredTools).length : undefined })
+    res.json({ ok: true, server: SERVER_NAME, version: serverVersion })
   })
 
-  return { router, server, transport }
+  return { router }
 }

package/src/mcp/tools/openclaw/index.js

@@ -164,6 +164,11 @@ export function registerOpenClawTools(server, deps) {
         routeUserId: z.string().optional().describe('OpenClaw 微信对端 user_id，用于回推'),
         routeAccount: z.string().optional(),
         routeChannel: z.string().optional(),
+        parentTodoId: z.string().optional().describe(
+          '调用方（父 PTY 的 AI）从 env QUADTODO_TODO_ID 读取后透传过来，' +
+          '用于子 PTY 注入 QUADTODO_PARENT_TODO_ID。' +
+          'AgentQuad 主进程的 process.env 不含父 todo 信息，所以必须显式传。'
+        ),
       },
     },
     async (args) => {
@@ -223,6 +228,7 @@ export function registerOpenClawTools(server, deps) {
         const result = aiTerminal.spawnSession({
           sessionId,
           todoId: args.todoId,
+          parentTodoId: args.parentTodoId || null,  // ← new
           prompt,
           tool,
           cwd,

package/src/openclaw-hook.js

@@ -605,7 +605,7 @@ export function createOpenClawHookHandler(deps = {}) {
     if (!sess) return { ok: false, reason: 'session_gone' }
     // 把 session.status 翻成 pending_confirm —— 前端 deriveAiState 据此显示"待确认"。
     // 信号源是 codex-prompt-detector（已经过 AI self-quoted 过滤），比旧的 PTY 正则路径准。
-    try { aiTerminal?.markPendingConfirm?.(sessionId, { source: 'codex-detector' }) } catch { /* ignore */ }
+    try { aiTerminal?.markPendingConfirm?.(sessionId, { source: 'codex-detector', promptText }) } catch { /* ignore */ }
     const todoId = sess.todoId
     let todoTitle = todoId
     try {

package/src/permission-prompt.js

@@ -0,0 +1,188 @@
+/**
+ * 从 PTY 尾部抽出 Claude Code / Codex 的"授权弹窗"文本与候选选项。
+ *
+ * 双源策略：
+ *   - 主源 raw：session.recentOutput（4KB 滑窗，新鲜但被 TUI redraw 噪声覆盖）
+ *               或 codex-prompt-detector 已经 ANSI-strip 过的短串。
+ *   - 兜底 historicalRaw：session.outputHistory join 后的尾部（更大，旧但完整）。
+ *
+ * 输出 { text, options }：
+ *   - text: 清洗 + 噪声过滤 + 锚定窗口后的多行字符串，给前端 PermissionCard 渲染。
+ *   - options: 形如 [{ index: 1, label: 'Yes' }, ...]，按 index 升序。
+ *
+ * 设计：与 openclaw-hook.js 推 IM 时的清洗管线职责相似，但目标是"短而干净"——
+ * IM 那边整轮 transcript 都要，这里只要授权弹窗那几行。规则同源（spinner /
+ * status verb / prompt prefix / border 都过滤），避免两边漂移。
+ */
+
+const ANSI_OSC = /\x1b\][^\x07]*(\x07|\x1b\\)/g
+const ANSI_CSI = /\x1b\[[0-9;?]*[A-Za-z~]/g
+const ANSI_OTHER = /\x1b[()#][A-Za-z0-9]|\x1b[>=<cDEHMNOPZ78]/g
+const CTRL = /[\x00-\x08\x0b\x0c\x0e-\x1f]/g
+
+const BOX_HORIZONTAL = /[─━┄┅┈┉═]/g
+const BOX_VERTICAL = /[│┃┆┇┊┋║]/g
+const BOX_CORNERS = /[┌┍┎┏┐┑┒┓└┕┖┗┘┙┚┛╭╮╯╰╓╒╕╖╙╘╛╜╔╗╚╝]/g
+const BOX_TEES = /[├┝┞┟┠┡┢┣┤┥┦┧┨┩┪┫┬┭┮┯┰┱┲┳┴┵┶┷┸┹┺┻┼┽┾┿╀╁╂╃╄╅╆╇╈╉╊╋╠╣╦╩╬]/g
+
+// Claude TUI 噪声 —— 与 openclaw-hook.js 保持同步
+const SPINNER_CHARS_STR = '✶✳✻✽★⚙∗⠁⠂⠄⡀⢀⠠⠐⠈'
+// "Brewing for 3m" / "Skedaddled for 5s" / "Cooked." 这类 spinner 状态行
+const STATUS_KEYWORDS = /\b[A-Z][a-z]{2,19}(?:ing|ed)\s+for\s+/
+const STATUS_VERB_LINE = /^\s*[*✶✳✻✽★⚙∗⠁⠂⠄⡀⢀⠠⠐⠈]*\s*[A-Z][a-z]{2,19}(?:ing|ed)\s*(…|\.\.\.|\.\.|\.)\s*$/
+// 行首单独的指示符行（不带任何内容）
+const TUI_PROMPT_LINE = /^\s*[❯⏵►→]\s*$/
+const AUTO_MODE_LINE = /(auto mode (on|off)|shift\+tab to cycle|ctrl\+[a-z]\b)/i
+const BORDER_ONLY = /^[\s\-=_|+~]+$/
+
+// 已知的"该停下来等用户"锚点。命中后我们围绕它取窗口，避免把锚点前的 prompt
+// 文本（Bash 命令、文件路径、warning 等）切掉。多语言都列上，省得后续再扩。
+const PERMISSION_ANCHORS = [
+  /Do you want to proceed/i,
+  /Do you want to make this edit/i,
+  /Do you want to make this change/i,
+  /Do you want to create/i,
+  /Allow this/i,
+  /apply patch\?/i,
+  /run this command\?/i,
+  /Approve\??/i,
+  /\?\s*\[[yYnN]\/[yYnN]\]/,
+  /(允许|批准|授权).*\?/,
+]
+
+function stripAnsi(s) {
+  return String(s || '')
+    .replace(ANSI_OSC, '')
+    .replace(ANSI_CSI, '')
+    .replace(ANSI_OTHER, '')
+    .replace(CTRL, '')
+}
+
+function stripBoxDrawing(s) {
+  return String(s || '')
+    .replace(BOX_HORIZONTAL, '')
+    .replace(BOX_VERTICAL, '')
+    .replace(BOX_CORNERS, '')
+    .replace(BOX_TEES, '')
+}
+
+function compactBlankLines(s) {
+  return String(s || '').replace(/\n[ \t]*\n+/g, '\n\n')
+}
+
+function isSpinnerOnly(line) {
+  const trimmed = line.replace(/\s+/g, '')
+  if (!trimmed) return true
+  for (const ch of trimmed) {
+    if (!SPINNER_CHARS_STR.includes(ch) && !/\d/.test(ch)) return false
+  }
+  return true
+}
+
+function isNoiseLine(line) {
+  if (STATUS_VERB_LINE.test(line)) return true
+  if (STATUS_KEYWORDS.test(line)) return true
+  if (TUI_PROMPT_LINE.test(line)) return true
+  if (AUTO_MODE_LINE.test(line)) return true
+  if (BORDER_ONLY.test(line)) return true
+  return false
+}
+
+export function cleanPtyTail(raw) {
+  if (!raw) return ''
+  let s = stripAnsi(raw)
+  s = stripBoxDrawing(s)
+  // 去掉行尾空白
+  s = s.split('\n').map((l) => l.replace(/[ \t]+$/, '')).join('\n')
+  // 过滤纯噪声行；保留空行（后面 compactBlankLines 再合并）
+  s = s
+    .split('\n')
+    .filter((l) => {
+      if (!l.trim()) return true
+      if (isSpinnerOnly(l)) return false
+      if (isNoiseLine(l)) return false
+      return true
+    })
+    .join('\n')
+  // 去掉行首 ❯ / > 标记（保留内容，比如 "❯ 1. Yes" → "1. Yes"）
+  s = s.split('\n').map((l) => l.replace(/^(\s*)(?:❯|>)\s+/, '$1')).join('\n')
+  return compactBlankLines(s).trim()
+}
+
+/**
+ * 在文本里找形如 "1. Yes" / "2. No, suggest changes" 的枚举选项。
+ * 找不到 → []。重复 index 仅保留首条。
+ */
+export function parsePermissionOptions(cleaned) {
+  if (!cleaned) return []
+  const seen = new Map()
+  for (const l of cleaned.split('\n')) {
+    const m = l.match(/^\s*([1-9])\.\s+(\S.{0,79}?)\s*$/)
+    if (!m) continue
+    const idx = parseInt(m[1], 10)
+    const label = m[2].trim()
+    if (!label) continue
+    if (!seen.has(idx)) seen.set(idx, label)
+  }
+  return [...seen.entries()]
+    .sort((a, b) => a[0] - b[0])
+    .map(([index, label]) => ({ index, label }))
+}
+
+function findAnchorIndex(lines) {
+  for (let i = lines.length - 1; i >= 0; i--) {
+    if (PERMISSION_ANCHORS.some((re) => re.test(lines[i]))) return i
+  }
+  return -1
+}
+
+/**
+ * 从清洗后的 lines 取一个"覆盖授权 prompt 的窗口"。
+ * - 找到锚点：起点 = anchor - maxLines*0.7，终点 = anchor + maxLines*0.3 + 1
+ *   （要把选项行也带进来）
+ * - 没找到锚点：直接取尾部 maxLines
+ */
+function takeWindow(lines, maxLines) {
+  const idx = findAnchorIndex(lines)
+  if (idx >= 0) {
+    const back = Math.floor(maxLines * 0.7)
+    const fwd = Math.ceil(maxLines * 0.3)
+    return lines.slice(Math.max(0, idx - back), Math.min(lines.length, idx + fwd + 1))
+  }
+  return lines.slice(-maxLines)
+}
+
+/**
+ * extractPermissionPrompt(raw, opts):
+ *   - raw          : 主 PTY tail / detector promptText
+ *   - opts.historicalRaw : recentOutput 洗完仍过瘦时回退的更大原始串
+ *                          （建议传入 session.outputHistory.join('') 的尾部）
+ *
+ * 返回 { text, options }；text 不超过 maxChars，options 默认 maxLines=30。
+ */
+export function extractPermissionPrompt(
+  raw,
+  { historicalRaw = null, maxLines = 30, maxChars = 1200 } = {},
+) {
+  function extract(source) {
+    const cleaned = cleanPtyTail(source)
+    if (!cleaned) return ''
+    const lines = cleaned.split('\n')
+    const window = takeWindow(lines, maxLines)
+    let text = window.join('\n').trim()
+    if (text.length > maxChars) text = text.slice(-maxChars)
+    return text
+  }
+
+  let text = extract(raw)
+  // 主源里没有锚点或太瘦 → 回退完整历史尾部
+  const hasAnchor = (s) => PERMISSION_ANCHORS.some((re) => re.test(s))
+  if ((!text || text.length < 40 || !hasAnchor(text)) && historicalRaw) {
+    const fallback = extract(historicalRaw)
+    if (fallback && (hasAnchor(fallback) || fallback.length > text.length)) {
+      text = fallback
+    }
+  }
+  const options = parsePermissionOptions(text)
+  return { text, options }
+}