dsh-retrace 0.4.148 → 0.4.151

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. package/README.md +15 -14
  2. package/README.zh.md +18 -10
  3. package/bin/retrace.mjs +0 -0
  4. package/lib/adapter/dsh-writer.js +2 -2
  5. package/lib/adapter/dsh.js +8 -508
  6. package/lib/archaeology-cli.js +3 -3
  7. package/lib/boot-pin.js +1 -1
  8. package/lib/client-i18n.js +22 -13
  9. package/lib/client.bundle.js +3 -3
  10. package/lib/client.js +136 -205
  11. package/lib/close-guard-client.js +2 -2
  12. package/lib/dynamic-client.js +3 -3
  13. package/lib/dynamic-host.js +8 -257
  14. package/lib/host-core.js +2 -193
  15. package/lib/http.js +3 -132
  16. package/lib/index.js +365 -862
  17. package/lib/marker-carrier.js +4 -4
  18. package/lib/platform/session-paths.js +11 -43
  19. package/lib/prewrite-guard.js +0 -28
  20. package/lib/span-semantics.js +1 -1
  21. package/lib/versioning.js +34 -2
  22. package/package.json +20 -16
  23. package/lib/adapter/compaction-backend.js +0 -92
  24. package/lib/adapter/register-compaction-backend.js +0 -93
  25. package/lib/auto-fold-scheduler.js +0 -519
  26. package/lib/badge.js +0 -65
  27. package/lib/cache-metrics.js +0 -358
  28. package/lib/context-level.js +0 -139
  29. package/lib/core-contract.js +0 -77
  30. package/lib/fold-auto.js +0 -621
  31. package/lib/fold-boundary.js +0 -1051
  32. package/lib/fold-core-text.js +0 -52
  33. package/lib/fold-core.js +0 -191
  34. package/lib/fold-summary.js +0 -168
  35. package/lib/hw3-fallback.js +0 -262
  36. package/lib/identity/code-assign.js +0 -228
  37. package/lib/identity/dedupe.js +0 -168
  38. package/lib/identity/shortcode.js +0 -782
  39. package/lib/identity/sidebar-badge.js +0 -270
  40. package/lib/identity-check-cli.js +0 -379
  41. package/lib/ledger-guard.js +0 -491
  42. package/lib/token-estimate.js +0 -91
@@ -267,7 +267,7 @@ return {
267
267
  * - tail :遮蔽「目标所在轮首 .. 节点序列末尾」——撤回/重新开始的语义
268
268
  * (目标轮内任何位置都回退到轮首,防孤立输入;一直遮蔽到尾部);
269
269
  * @public-note:start
270
- * - range:遮蔽 [startSeq .. endSeq] 位置连续段——折叠完成块(能力)。
270
+ * - range:遮蔽 [startSeq .. endSeq] 位置连续段——完成块(能力)。
271
271
  * 区间**不拆工具对**:`tool/call` 与配对的 `tool/result`(内核口径 = 同 turn +
272
272
  * 同 step + callId)必须同进同出(见 expandRangeForToolPairs)——否则面里会留下
273
273
  * 「有 result 无 call / 有 call 无 result」,写前守卫按 W1 拒绝(严格端点
@@ -682,15 +682,15 @@ return {
682
682
  const TRACE_TEXT = '(此处内容已被撤回,可在恢复视图中查看)'
683
683
 
684
684
  // ─────────────────────────────────────────────────────────────────────────────
685
- // 自动折叠默认关闭(需显式开启)
685
+ // 自动收起默认关闭(需显式开启)
686
686
  //
687
- // true = 被判定为「自动折叠来源」的 marker 在最底层写入器处直接拒写
687
+ // true = 被判定为「自动收起来源」的 marker 在最底层写入器处直接拒写
688
688
  // (手动 recall / edit / regenerate 与用户显式折叠照常写)。调度器侧同一开关;
689
- // 开启自动折叠需两处一起解除。
689
+ // 开启自动收起需两处一起解除。
690
690
  const AUTOFOLD_HARD_DISABLED = true
691
691
 
692
692
  /**
693
- * 判定「自动折叠来源」:op = 'fold' 且(调用方自报自动来源,或未显式声明用户发起)。
693
+ * 判定「自动收起来源」:op = 'fold' 且(调用方自报自动来源,或未显式声明用户发起)。
694
694
  *
695
695
  * - 用户发起 = `meta.userInitiated === true`(手动 fold 入口打标);
696
696
  * - 自动来源 = `meta.autoFoldSource === true`(自动层打标;与 userInitiated 冲突时
@@ -1361,60 +1361,6 @@ return {
1361
1361
  }
1362
1362
  return lines.join('\n')
1363
1363
  }
1364
- /* @public-strip:start */
1365
- /**
1366
- * dsh-retrace — lib/fold-core-text.js
1367
- *
1368
- * 结构化摘要 → 人读文本(留痕载体文本)。**纯模块:零 import**。
1369
- *
1370
- * 为什么单独一个文件(投影阻断修正):
1371
- * 这层序列化承载的是**结构化摘要字段**(roadmap-card/process/archive 是其字段名),
1372
- * 通用层(载体形状 + 写入器)不得带它。写入器改为**注入面**(`deriveContentText`,
1373
- * 与 `meter`/`deriveMessage` 并列,见 lib/adapter/dsh-writer.js);本文件是那个注入面
1374
- * 在序列化侧的**唯一实现体**,两类装配点共用它:
1375
- * ① 宿主装配 lib/index.js(静态 import);
1376
- * ② 动态插件件装配 scripts/generate-dynamic.mjs —— 该 realm 不能 import,故把本文件
1377
- * 整体 inline(零 import 是它能被 inline 的前提;fold-core → fold-boundary →
1378
- * context-level 那条依赖链 inline 不进去)。
1379
- * 同一个函数体被两处共用 ⇒ 不存在"两份实现漂移"的形态(旧形态曾有
1380
- * marker-carrier 内的一份副本,靠单测逐字钉住)。
1381
- */
1382
-
1383
- /**
1384
- * 序列化结构化摘要为文本(人读 + 载体 content 用;JSON 结构清晰可回填)。
1385
- *
1386
- * 空结构化数据(非对象 / 卡与过程都为空)返回 '' —— 调用方据此回落到留痕文案,
1387
- * 而不是写出一张只有标题的"空卡"(那是**非空但无信息**的 content,比回落更差)。
1388
- * @param {object} trio
1389
- * @returns {string} 无可用内容时返回 ''(调用方回落到定稿留痕文案)
1390
- */
1391
- function serializeTrio(trio) {
1392
- if (!trio || typeof trio !== 'object') return ''
1393
- const card = trio['roadmap-card'] ?? {}
1394
- const proc = trio.process ?? {}
1395
- const arch = trio.archive ?? {}
1396
- if (Object.keys(card).length === 0 && Object.keys(proc).length === 0) return ''
1397
- const lines = [
1398
- '【里程碑卡】',
1399
- `块: ${card.blockTitle ?? ''}`,
1400
- `结论: ${card.summary ?? ''}`,
1401
- ]
1402
- if (card.timeRange) lines.push(`时间: ${card.timeRange}`)
1403
- // 修订提示进模型上下文(新卡声明取代旧卡;读旧卡靠 unfold.supersededByNewer)
1404
- if (card.supersededBy) lines.push(`修订: ${card.supersedesNote ?? `取代旧结论(seq ${card.supersededBy},旧卡可审计)`}`)
1405
- lines.push(
1406
- '【过程】',
1407
- `轮次: ${proc.rounds ?? 0} 条用户输入`,
1408
- `动作: ${Array.isArray(proc.actions) && proc.actions.length ? proc.actions.join('; ') : '(无工具调用)'}`,
1409
- `工具结果: ${proc.toolResults ?? 0} 次`,
1410
- )
1411
- if (Array.isArray(arch.shadowedSeqs) && arch.shadowedSeqs.length) {
1412
- lines.push('【原文存档】')
1413
- lines.push(`区间: seq ${arch.shadowedSeqs[0]}..${arch.shadowedSeqs[arch.shadowedSeqs.length - 1]}(日志完整,展开可逐字回填)`)
1414
- }
1415
- return lines.join('\n')
1416
- }
1417
- /* @public-strip:end */
1418
1364
  /**
1419
1365
  * dsh-retrace — lib/adapter/contract.js
1420
1366
  *
@@ -1894,71 +1840,6 @@ return {
1894
1840
  // 可读文本同在该模块(单一真相,不落第二份)。
1895
1841
  // Host event-view compatibility (new host: snapshotEvents/eventAt; old host: events array).
1896
1842
 
1897
- /* @public-strip:start */
1898
- /**
1899
- * 私有能力(不进公开包):撤回时跳过派生展示卡。
1900
- *
1901
- * 只认显式 `data.recallExempt === true`;`data.kind === 'hotzone'` 等语义标签
1902
- * **不改变**判定。真实 user/assistant 内容即带标记也不豁免(安全闸,只有派生
1903
- * 展示卡才可命中)。
1904
- */
1905
- function isRecallExemptEvent(event) {
1906
- if (!event || event.type !== 'user/message') return false
1907
- const data = event.data
1908
- if (!data || typeof data !== 'object') return false
1909
- // 仅「热区派生展示卡」这一组合放行:user/message + kind=hotzone + recallExempt。
1910
- // source.kind 不参与判定(卡可能是 user / model / hotzone 任一来源)。
1911
- return data.recallExempt === true && data.kind === 'hotzone'
1912
- }
1913
-
1914
- /**
1915
- * 从 `seq` 起向前找最近一条**真实用户输入**(source.kind=user 且非豁免)。
1916
- * 撤回目标落在热区卡上时,目标改指它(卡轮不是可撤回的真实轮)。
1917
- */
1918
- function lastRealUserAtOrBefore(session, seq) {
1919
- const nodes = Array.isArray(session?.surface?.nodes) ? session.surface.nodes : []
1920
- const pos = nodes.indexOf(seq)
1921
- if (pos === -1) return null
1922
- for (let i = pos; i >= 0; i -= 1) {
1923
- const event = eventAt(session, nodes[i])
1924
- if (event?.type === 'user/message' && event.data?.source?.kind === 'user' && !isRecallExemptEvent(event)) {
1925
- return { seq: nodes[i], event, viaSeq: false }
1926
- }
1927
- }
1928
- return null
1929
- }
1930
-
1931
- /**
1932
- * 把 `recallExempt` 节点从撤回 span 里剔除:
1933
- * - 尾部豁免卡从 span 尾部切掉(它们留在面上,不参与本次撤回);
1934
- * - 区间内部豁免卡无法从单段 replace 里排除(内核只支持一个连续区间),
1935
- * 仍会被遮蔽,但**不计入** shadowed 计数(也不参与 hide-miss 期望)。
1936
- * 纯函数:events/nodes/span 入参,便于单测钉住语义。
1937
- */
1938
- function recallSpanWithExempt(events, nodes, span) {
1939
- const shadowed = Array.isArray(span?.shadowedSeqs) ? span.shadowedSeqs : []
1940
- const exemptSeqs = new Set()
1941
- for (const seq of shadowed) if (isRecallExemptEvent(events?.[seq])) exemptSeqs.add(seq)
1942
- if (exemptSeqs.size === 0) return { span, exemptSeqs, counted: shadowed.length, interiorExempt: [] }
1943
- // 只有**尾部**连续的热区卡可以从单段 replace 里切掉;区间内部的卡无法排除,
1944
- // 单独报出来(调用方应拒绝撤回,而不是写一个把卡也遮掉的 marker)。
1945
- const trailing = []
1946
- for (let i = shadowed.length - 1; i >= 0; i -= 1) {
1947
- if (!exemptSeqs.has(shadowed[i])) break
1948
- trailing.push(shadowed[i])
1949
- }
1950
- const trailingSet = new Set(trailing)
1951
- const interiorExempt = [...exemptSeqs].filter((seq) => !trailingSet.has(seq)).sort((a, b) => a - b)
1952
- const kept = shadowed.filter((seq) => !trailingSet.has(seq))
1953
- const end = kept.length > 0 ? kept[kept.length - 1] : span.start
1954
- const startPos = Array.isArray(nodes) ? nodes.indexOf(span.start) : -1
1955
- const endPos = Array.isArray(nodes) ? nodes.indexOf(end) : -1
1956
- const range = startPos !== -1 && endPos !== -1 && endPos >= startPos ? nodes.slice(startPos, endPos + 1) : kept
1957
- const counted = range.filter((seq) => !exemptSeqs.has(seq)).length
1958
- return { span: { start: range[0], end: range[range.length - 1], shadowedSeqs: range }, exemptSeqs, counted, interiorExempt }
1959
- }
1960
- /* @public-strip:end */
1961
-
1962
1843
  const EDITOR_PLUGIN = 'retrace'
1963
1844
 
1964
1845
  /**
@@ -2343,11 +2224,7 @@ return {
2343
2224
  * 平台写入器(DSH 三情形翻译)经 hooks.writeMarker 注入,本函数只组装
2344
2225
  * 业务意图(op + targetSeq + originalText)并转发;写入器缺失 = 平台未装配。
2345
2226
  */
2346
- /* @public-strip:start */
2347
- async function writeMarker(session, span, op, targetSeq, originalText, extra = {}) {
2348
- /* @public-strip:else
2349
2227
  async function writeMarker(session, span, op, targetSeq, originalText) {
2350
- @public-strip:end */
2351
2228
  const writer = hooks?.writeMarker
2352
2229
  if (typeof writer !== 'function') {
2353
2230
  throw editorError('writer-unavailable', 'No marker writer (adapter) is wired; cannot shadow messages.')
@@ -2357,11 +2234,7 @@ return {
2357
2234
  // 重放面不一致的 marker)。违规 → contract-violation(指名道姓),绝不静默。
2358
2235
  // (可抛断言一律在**任何写入之前**——)
2359
2236
  assertSpanShape(span, 'host-core.writeMarker.span')
2360
- /* @public-strip:start */
2361
- const markerEvent = await writer(session, span, { op, targetSeq, originalText, ...extra })
2362
- /* @public-strip:else
2363
2237
  const markerEvent = await writer(session, span, { op, targetSeq, originalText })
2364
- @public-strip:end */
2365
2238
  try {
2366
2239
  // 出口自检:适配器返回的 marker 必须合规(下游读 seq/editor/surfaceOp 的假设前提)。
2367
2240
  // 注意:此时**已经写入**(真实写入器在 append 前自检,见 dsh-writer),拒绝
@@ -3101,19 +2974,6 @@ return {
3101
2974
  const session = requireSession(sessionId)
3102
2975
  await ensureIdle(agents.get(sessionId))
3103
2976
  let tgt = resolveTarget(session, args)
3104
- /* @public-strip:start */
3105
- let cardSeq = null
3106
- if (tgt.event !== null && isRecallExemptEvent(tgt.event)) {
3107
- // 热点卡不是可撤回的真实轮:目标改指最近一条真实用户消息;找不到就拒绝
3108
- // (不把卡当用户原文回填/撤回)。
3109
- cardSeq = tgt.seq
3110
- const real = lastRealUserAtOrBefore(session, tgt.seq)
3111
- if (real === null) {
3112
- throw editorError('no-real-user', `检索到的是热区卡(seq ${cardSeq}),它之前没有真实的用户消息可撤回。`)
3113
- }
3114
- tgt = { ...real, retargeted: true, cardSeq }
3115
- }
3116
- /* @public-strip:end */
3117
2977
  const messageId = tgt.retargeted === true ? String(tgt.event?.data?.id ?? '') : String(args?.messageId ?? '')
3118
2978
  const seq = tgt.seq
3119
2979
  if (seq === -1 || tgt.event === null) throw editorError('message-not-found', 'Message not found in this session.')
@@ -3124,26 +2984,6 @@ return {
3124
2984
  // 与「真被遮蔽(fold/recall/compact 已移除,历史只读)」。
3125
2985
  let span = args?.span ?? shadowSpanFrom(session, seq, { mode: 'tail' })
3126
2986
  let shadowedCount = span?.shadowedSeqs?.length ?? 0
3127
- /* @public-strip:start */
3128
- {
3129
- const eventsForSpan = sessionEvents(session)
3130
- const nodesForSpan = Array.isArray(session.surface?.nodes) ? session.surface.nodes : []
3131
- const filtered = span ? recallSpanWithExempt(eventsForSpan, nodesForSpan, span) : null
3132
- if (filtered) {
3133
- if (filtered.interiorExempt.length > 0) {
3134
- // 卡在区间内部 ⇒ 单段 replace 无法排除它;宁可拒绝,也不写一个把卡遮掉的
3135
- // marker。硬性约束:热区卡应位于 surface 尾部。
3136
- throw editorError(
3137
- 'hotzone-card-interior',
3138
- `热区卡应位于会话尾部:卡 seq ${filtered.interiorExempt.join(', ')} 位于本次撤回区间内部,无法在不遮蔽卡片的前提下撤回。请把卡移到尾部后重试。`,
3139
- { cardSeqs: filtered.interiorExempt },
3140
- )
3141
- }
3142
- span = filtered.span
3143
- shadowedCount = filtered.counted
3144
- }
3145
- }
3146
- /* @public-strip:end */
3147
2987
  if (!span) throwSpanMiss(session, seq, args, messageId)
3148
2988
  const recallText = messageTextOf(session, seq) || commandTextOf(tgt.event)
3149
2989
  // ── 方案 A:写 marker **之前**先把被撤回区间里派生出去的任务停干净 ──────────
@@ -3187,12 +3027,6 @@ return {
3187
3027
  // 正常路径恒无此键 —— 由 test/rollback-derived-tasks.test.js 的断言钉住。
3188
3028
  ...(notice !== '' ? { derivedNotice: notice } : {}),
3189
3029
  }
3190
- /* @public-strip:start */
3191
- if (tgt.retargeted === true) {
3192
- recallResult.retargetedFromCard = true
3193
- recallResult.cardSeq = tgt.cardSeq ?? cardSeq
3194
- }
3195
- /* @public-strip:end */
3196
3030
  return recallResult
3197
3031
  })
3198
3032
 
@@ -3471,7 +3305,7 @@ return {
3471
3305
  * `hooks.writeRestoreCopy`(lib/adapter/dsh-writer.js,复用既有写入器:写前
3472
3306
  * validateMarker 契约校验 + 运行中拒写的持久 append 闸;两段路径的成对审计
3473
3307
  * 纪律原样保留 —— 本写入不写第 1 段 claim,详见该方法注释)。
3474
- * · op 段取名 `reclaim`(回收):不是 fold ⇒ 自动折叠默认关闭的闸
3308
+ * · op 段取名 `reclaim`(回收):不是 fold ⇒ 自动收起默认关闭的闸
3475
3309
  * (AUTOFOLD_HARD_DISABLED + isAutoFoldSource 只判 op='fold')无从触发。
3476
3310
  * ═══════════════════════════════════════════════════════════════════════════ */
3477
3311
 
@@ -3655,67 +3489,6 @@ return {
3655
3489
  }
3656
3490
  })
3657
3491
 
3658
- /* @public-strip:start */
3659
- /**
3660
- * 折叠完成块(marker 折叠承载):遮蔽 [start..end] 完成块区间,
3661
- * 日志 append-only 不变(sourceEventSeqs 记录被遮蔽 seq,可展开)。摘要由
3662
- * 生成(marker content);本 op = 承载(区间折叠 + marker 写入)。
3663
- * 端点必须是当前 surface 节点;已被遮蔽的端点 → target-shadowed。
3664
- */
3665
- const fold = op(async (args) => {
3666
- // 折叠入口取证:走宿主 logger(console.log 进不了宿主日志 ⇒ 排障
3667
- // 时零证据);带调用栈前几帧,分辨 api.fold 的实际调用方(自动层/手动入口/其它)。
3668
- try {
3669
- const st = new Error('fold-caller').stack || ''
3670
- log(`retrace-fold-evidence: fold 入口被调用 session=${String(args?.sessionId ?? '')} ${String(args?.start ?? '')}..${String(args?.end ?? '')} userInitiated=${args?.userInitiated === true} 调用栈=${st.split('\n').slice(1, 6).join(' | ').slice(0, 600)}`)
3671
- } catch { /* 取证失败不影响折叠 */ }
3672
- const sessionId = String(args?.sessionId ?? '')
3673
- const session = requireSession(sessionId)
3674
- await ensureIdle(agents.get(sessionId))
3675
- const startSeq = Number(args?.start)
3676
- const endSeq = Number(args?.end)
3677
- if (!Number.isInteger(startSeq) || !Number.isInteger(endSeq) || startSeq < 0 || endSeq < startSeq) {
3678
- throw editorError('bad-fold-range', 'fold 需要合法完成块区间 [start..end](surface 节点 seq,start<=end)')
3679
- }
3680
- // 主路径:index.js 注入 args.span(文件 spanFromFile range mode,官方 foldSurface nodes);
3681
- // fallback:内存 surface.nodes 位置段(host 视图尽力)。
3682
- const span = args?.span ?? rangeSpanFrom(session, startSeq, endSeq)
3683
- if (!span) {
3684
- // 显式状态(不再用 null 猜)——重放失败报内部错误,未落盘报可重试,
3685
- // 其余(端点已被遮蔽/非 surface 节点)保持折叠既有文案与错误码(行为兼容)。
3686
- const status = args?.spanStatus
3687
- if (status === SPAN_STATUS.REPLAY_FAILED) throw editorError('span-replay-failed', SPAN_REPLAY_FAILED_MESSAGE, { start: startSeq, end: endSeq, ...replayFailedDetails(args) })
3688
- if (status === SPAN_STATUS.NOT_PERSISTED) throw editorError('message-pending', PENDING_TARGET_MESSAGE, { start: startSeq, end: endSeq })
3689
- throw editorError('target-shadowed', '折叠区间端点不在当前 surface(已被遮蔽或非节点)——完成块边界需为 surface 节点')
3690
- }
3691
- // 折叠 marker content = 确定摘要(index.js 从文件生成注入 args.summary;
3692
- // 摘要替代折叠块进模型上下文——折叠语义 = 归档可回填,非移除)。
3693
- // 结构化摘要:args.summary = serializeTrio 人读文本(进第 2 段 content,即留痕 + 可解释
3694
- // 的载体);args.trio = 结构化摘要(官方词表无结构化落点 ⇒ 由写入器在无 summary
3695
- // 时就地序列化进 content;旧数据的 editor.trio 仍由读端识别)。
3696
- const summary = typeof args?.summary === 'string' && args.summary.trim() ? args.summary : ''
3697
- const trio = args?.trio && typeof args.trio === 'object' ? args.trio : undefined
3698
- const markerEvent = await writeMarker(session, span, 'fold', startSeq, '', {
3699
- content: summary ? [{ type: 'text', text: summary }] : [],
3700
- ...(trio ? { trio } : {}),
3701
- // 自动折叠默认关闭闸的来源判定随 meta 下传(写入器入口按它拒写自动来源):
3702
- // 用户显式发起的手动 fold 打 userInitiated;自动层自报 autoFoldSource;
3703
- // 两者都没有 = 按自动来源处理(fail-closed)。
3704
- ...(args?.userInitiated === true ? { userInitiated: true } : {}),
3705
- ...(args?.autoFoldSource === true ? { autoFoldSource: true } : {}),
3706
- })
3707
- await flushSafely(session)
3708
- notifyBoundary('fold', session, span, markerEvent, '')
3709
- return {
3710
- op: 'fold',
3711
- start: startSeq,
3712
- end: endSeq,
3713
- markerSeq: markerEvent.seq,
3714
- shadowed: span.shadowedSeqs.length,
3715
- }
3716
- })
3717
- /* @public-strip:end */
3718
-
3719
3492
  /**
3720
3493
  * 真正恢复(日志层面遮蔽撤销,0.4.126)—— 与 `unhide` 并列的第二条替代操作。
3721
3494
  *
@@ -3879,26 +3652,8 @@ return {
3879
3652
  unshadow: (args) => unshadow(args),
3880
3653
  recallIndex: (args) => recallIndex(args),
3881
3654
  reclaim: (args) => reclaim(args),
3882
- fold: (args) => fold(args), // @public-strip-line
3883
3655
  }
3884
3656
  }
3885
-
3886
- /* @public-strip:start */
3887
- /** 内存 surface.nodes 的区间位置段(尽力;主路径 = 文件 spanFromFile range mode)。
3888
- * 区间段规则同样收敛到 span-semantics.spanAt(单一实现)。 */
3889
- function rangeSpanFrom(session, startSeq, endSeq) {
3890
- const nodes = Array.isArray(session?.surface?.nodes) ? session.surface.nodes : []
3891
- // 与适配层(computeSpan)同一接线:eventOf = 内存事件视图取事件(host-compat
3892
- // eventAt);pairAssistantTools 必须 true(`tool/call` 不是面节点,面上要配对的
3893
- // 是 assistant 的 tool-call 块 ↔ tool/result——守卫 W1 的 wire 口径)。
3894
- return spanAt(nodes, nodes.indexOf(startSeq), {
3895
- mode: 'range',
3896
- endSeq,
3897
- eventOf: (seq) => eventAt(session, seq),
3898
- pairAssistantTools: true,
3899
- })
3900
- }
3901
- /* @public-strip:end */
3902
3657
  /**
3903
3658
  * dsh-retrace — lib/adapter/dsh-writer.js
3904
3659
  *
@@ -4111,7 +3866,7 @@ return {
4111
3866
  * @returns {Promise<object>} 第 2 段事件(调用方读 seq/surfaceOp)。
4112
3867
  */
4113
3868
  async writeMarker(session, span, meta) {
4114
- // ── 自动折叠默认关闭(最底层闸,需显式开启)─────────────────────────
3869
+ // ── 自动收起默认关闭(最底层闸,需显式开启)─────────────────────────
4115
3870
  // 判定收敛在 marker-carrier.isAutoFoldSource(op='fold' 且未声明用户发起);
4116
3871
  // AUTOFOLD_HARD_DISABLED=true ⇒ 拒写并返回显式错误码,零落盘(审计段/载体段
4117
3872
  // 都不写)。拒写留一行可核日志:走注入的宿主 logger(console.log 进不了宿主
@@ -4260,7 +4015,7 @@ return {
4260
4015
  * 与 assertPairing)原样保留;本路径一条 claim 都不写 —— 回收副本不遮蔽任何
4261
4016
  * 节点,写 claim 会留下无人消费的孤儿审计行(真实会话里出现过的
4262
4017
  * 形态)。单段 append 无第 1 段 ⇒ 无"半对"可言;
4263
- * ③ 自动折叠默认关闭的闸(AUTOFOLD_HARD_DISABLED + isAutoFoldSource)只判
4018
+ * ③ 自动收起默认关闭的闸(AUTOFOLD_HARD_DISABLED + isAutoFoldSource)只判
4264
4019
  * `op === 'fold'`:本写入的 op 是回收,不落在该闸上;那道闸的代码一行不动;
4265
4020
  * ④ 写入前过注入的 `validateMarker`(prewrite-guard 完整契约校验,信封不带 seq
4266
4021
  * —— 与 unhide 取消标记同规),与 marker 写入共用同一条校验链;
@@ -4395,10 +4150,6 @@ return {
4395
4150
  // shadowedTokenCount 必须写官方 shadow-price(令牌价),拿不到服务时写入器拒写。
4396
4151
  const markerWriter = createDshMarkerWriter({
4397
4152
  meter: () => (typeof ctx.get === 'function' ? ctx.get('tokenMeter') : undefined) ?? ctx.tokenMeter,
4398
- /* @public-strip:start */
4399
- // 业务元数据 → 第 2 段人读文本的派生面(与 lib/index.js 同一个序列化体)。
4400
- deriveContentText: (meta) => serializeTrio(meta?.trio),
4401
- /* @public-strip:end */
4402
4153
  log,
4403
4154
  })
4404
4155
  const api = createEditorApi(ctx, sessions, agents, log, {
package/lib/host-core.js CHANGED
@@ -28,7 +28,7 @@
28
28
  * 2. **span 未命中的判定读显式状态**(第 1 项):args.spanStatus(文件层给出的
29
29
  * SPAN_STATUS)优先;无状态(文件不可读/直接调用/测试桩)才回落到内存判定。
30
30
  */
31
- import { SPAN_STATUS, spanForSeq, isRoundBoundaryEvent, roundStartIndex/* @public-strip:start */, spanAt/* @public-strip:end */ } from './span-semantics.js'
31
+ import { SPAN_STATUS, spanForSeq, isRoundBoundaryEvent, roundStartIndex } from './span-semantics.js'
32
32
 
33
33
 
34
34
  import { assertSpanShape, assertMarkerShape } from './adapter/contract.js'
@@ -39,71 +39,6 @@ import { buildRecallIndex, recallsOf, recallOf, intervalForMarker, reclaimCopyTe
39
39
  // Host event-view compatibility (new host: snapshotEvents/eventAt; old host: events array).
40
40
  import { sessionEvents, eventAt } from './host-compat.js'
41
41
 
42
- /* @public-strip:start */
43
- /**
44
- * 私有能力(不进公开包):撤回时跳过派生展示卡。
45
- *
46
- * 只认显式 `data.recallExempt === true`;`data.kind === 'hotzone'` 等语义标签
47
- * **不改变**判定。真实 user/assistant 内容即带标记也不豁免(安全闸,只有派生
48
- * 展示卡才可命中)。
49
- */
50
- export function isRecallExemptEvent(event) {
51
- if (!event || event.type !== 'user/message') return false
52
- const data = event.data
53
- if (!data || typeof data !== 'object') return false
54
- // 仅「热区派生展示卡」这一组合放行:user/message + kind=hotzone + recallExempt。
55
- // source.kind 不参与判定(卡可能是 user / model / hotzone 任一来源)。
56
- return data.recallExempt === true && data.kind === 'hotzone'
57
- }
58
-
59
- /**
60
- * 从 `seq` 起向前找最近一条**真实用户输入**(source.kind=user 且非豁免)。
61
- * 撤回目标落在热区卡上时,目标改指它(卡轮不是可撤回的真实轮)。
62
- */
63
- export function lastRealUserAtOrBefore(session, seq) {
64
- const nodes = Array.isArray(session?.surface?.nodes) ? session.surface.nodes : []
65
- const pos = nodes.indexOf(seq)
66
- if (pos === -1) return null
67
- for (let i = pos; i >= 0; i -= 1) {
68
- const event = eventAt(session, nodes[i])
69
- if (event?.type === 'user/message' && event.data?.source?.kind === 'user' && !isRecallExemptEvent(event)) {
70
- return { seq: nodes[i], event, viaSeq: false }
71
- }
72
- }
73
- return null
74
- }
75
-
76
- /**
77
- * 把 `recallExempt` 节点从撤回 span 里剔除:
78
- * - 尾部豁免卡从 span 尾部切掉(它们留在面上,不参与本次撤回);
79
- * - 区间内部豁免卡无法从单段 replace 里排除(内核只支持一个连续区间),
80
- * 仍会被遮蔽,但**不计入** shadowed 计数(也不参与 hide-miss 期望)。
81
- * 纯函数:events/nodes/span 入参,便于单测钉住语义。
82
- */
83
- export function recallSpanWithExempt(events, nodes, span) {
84
- const shadowed = Array.isArray(span?.shadowedSeqs) ? span.shadowedSeqs : []
85
- const exemptSeqs = new Set()
86
- for (const seq of shadowed) if (isRecallExemptEvent(events?.[seq])) exemptSeqs.add(seq)
87
- if (exemptSeqs.size === 0) return { span, exemptSeqs, counted: shadowed.length, interiorExempt: [] }
88
- // 只有**尾部**连续的热区卡可以从单段 replace 里切掉;区间内部的卡无法排除,
89
- // 单独报出来(调用方应拒绝撤回,而不是写一个把卡也遮掉的 marker)。
90
- const trailing = []
91
- for (let i = shadowed.length - 1; i >= 0; i -= 1) {
92
- if (!exemptSeqs.has(shadowed[i])) break
93
- trailing.push(shadowed[i])
94
- }
95
- const trailingSet = new Set(trailing)
96
- const interiorExempt = [...exemptSeqs].filter((seq) => !trailingSet.has(seq)).sort((a, b) => a - b)
97
- const kept = shadowed.filter((seq) => !trailingSet.has(seq))
98
- const end = kept.length > 0 ? kept[kept.length - 1] : span.start
99
- const startPos = Array.isArray(nodes) ? nodes.indexOf(span.start) : -1
100
- const endPos = Array.isArray(nodes) ? nodes.indexOf(end) : -1
101
- const range = startPos !== -1 && endPos !== -1 && endPos >= startPos ? nodes.slice(startPos, endPos + 1) : kept
102
- const counted = range.filter((seq) => !exemptSeqs.has(seq)).length
103
- return { span: { start: range[0], end: range[range.length - 1], shadowedSeqs: range }, exemptSeqs, counted, interiorExempt }
104
- }
105
- /* @public-strip:end */
106
-
107
42
  export const EDITOR_PLUGIN = 'retrace'
108
43
 
109
44
  /**
@@ -488,11 +423,7 @@ export function createEditorApi(ctx, sessions, agents, log = () => {}, hooks = {
488
423
  * 平台写入器(DSH 三情形翻译)经 hooks.writeMarker 注入,本函数只组装
489
424
  * 业务意图(op + targetSeq + originalText)并转发;写入器缺失 = 平台未装配。
490
425
  */
491
- /* @public-strip:start */
492
- async function writeMarker(session, span, op, targetSeq, originalText, extra = {}) {
493
- /* @public-strip:else
494
426
  async function writeMarker(session, span, op, targetSeq, originalText) {
495
- @public-strip:end */
496
427
  const writer = hooks?.writeMarker
497
428
  if (typeof writer !== 'function') {
498
429
  throw editorError('writer-unavailable', 'No marker writer (adapter) is wired; cannot shadow messages.')
@@ -502,11 +433,7 @@ export function createEditorApi(ctx, sessions, agents, log = () => {}, hooks = {
502
433
  // 重放面不一致的 marker)。违规 → contract-violation(指名道姓),绝不静默。
503
434
  // (可抛断言一律在**任何写入之前**——)
504
435
  assertSpanShape(span, 'host-core.writeMarker.span')
505
- /* @public-strip:start */
506
- const markerEvent = await writer(session, span, { op, targetSeq, originalText, ...extra })
507
- /* @public-strip:else
508
436
  const markerEvent = await writer(session, span, { op, targetSeq, originalText })
509
- @public-strip:end */
510
437
  try {
511
438
  // 出口自检:适配器返回的 marker 必须合规(下游读 seq/editor/surfaceOp 的假设前提)。
512
439
  // 注意:此时**已经写入**(真实写入器在 append 前自检,见 dsh-writer),拒绝
@@ -1246,19 +1173,6 @@ export function createEditorApi(ctx, sessions, agents, log = () => {}, hooks = {
1246
1173
  const session = requireSession(sessionId)
1247
1174
  await ensureIdle(agents.get(sessionId))
1248
1175
  let tgt = resolveTarget(session, args)
1249
- /* @public-strip:start */
1250
- let cardSeq = null
1251
- if (tgt.event !== null && isRecallExemptEvent(tgt.event)) {
1252
- // 热点卡不是可撤回的真实轮:目标改指最近一条真实用户消息;找不到就拒绝
1253
- // (不把卡当用户原文回填/撤回)。
1254
- cardSeq = tgt.seq
1255
- const real = lastRealUserAtOrBefore(session, tgt.seq)
1256
- if (real === null) {
1257
- throw editorError('no-real-user', `检索到的是热区卡(seq ${cardSeq}),它之前没有真实的用户消息可撤回。`)
1258
- }
1259
- tgt = { ...real, retargeted: true, cardSeq }
1260
- }
1261
- /* @public-strip:end */
1262
1176
  const messageId = tgt.retargeted === true ? String(tgt.event?.data?.id ?? '') : String(args?.messageId ?? '')
1263
1177
  const seq = tgt.seq
1264
1178
  if (seq === -1 || tgt.event === null) throw editorError('message-not-found', 'Message not found in this session.')
@@ -1269,26 +1183,6 @@ export function createEditorApi(ctx, sessions, agents, log = () => {}, hooks = {
1269
1183
  // 与「真被遮蔽(fold/recall/compact 已移除,历史只读)」。
1270
1184
  let span = args?.span ?? shadowSpanFrom(session, seq, { mode: 'tail' })
1271
1185
  let shadowedCount = span?.shadowedSeqs?.length ?? 0
1272
- /* @public-strip:start */
1273
- {
1274
- const eventsForSpan = sessionEvents(session)
1275
- const nodesForSpan = Array.isArray(session.surface?.nodes) ? session.surface.nodes : []
1276
- const filtered = span ? recallSpanWithExempt(eventsForSpan, nodesForSpan, span) : null
1277
- if (filtered) {
1278
- if (filtered.interiorExempt.length > 0) {
1279
- // 卡在区间内部 ⇒ 单段 replace 无法排除它;宁可拒绝,也不写一个把卡遮掉的
1280
- // marker。硬性约束:热区卡应位于 surface 尾部。
1281
- throw editorError(
1282
- 'hotzone-card-interior',
1283
- `热区卡应位于会话尾部:卡 seq ${filtered.interiorExempt.join(', ')} 位于本次撤回区间内部,无法在不遮蔽卡片的前提下撤回。请把卡移到尾部后重试。`,
1284
- { cardSeqs: filtered.interiorExempt },
1285
- )
1286
- }
1287
- span = filtered.span
1288
- shadowedCount = filtered.counted
1289
- }
1290
- }
1291
- /* @public-strip:end */
1292
1186
  if (!span) throwSpanMiss(session, seq, args, messageId)
1293
1187
  const recallText = messageTextOf(session, seq) || commandTextOf(tgt.event)
1294
1188
  // ── 方案 A:写 marker **之前**先把被撤回区间里派生出去的任务停干净 ──────────
@@ -1332,12 +1226,6 @@ export function createEditorApi(ctx, sessions, agents, log = () => {}, hooks = {
1332
1226
  // 正常路径恒无此键 —— 由 test/rollback-derived-tasks.test.js 的断言钉住。
1333
1227
  ...(notice !== '' ? { derivedNotice: notice } : {}),
1334
1228
  }
1335
- /* @public-strip:start */
1336
- if (tgt.retargeted === true) {
1337
- recallResult.retargetedFromCard = true
1338
- recallResult.cardSeq = tgt.cardSeq ?? cardSeq
1339
- }
1340
- /* @public-strip:end */
1341
1229
  return recallResult
1342
1230
  })
1343
1231
 
@@ -1616,7 +1504,7 @@ export function createEditorApi(ctx, sessions, agents, log = () => {}, hooks = {
1616
1504
  * `hooks.writeRestoreCopy`(lib/adapter/dsh-writer.js,复用既有写入器:写前
1617
1505
  * validateMarker 契约校验 + 运行中拒写的持久 append 闸;两段路径的成对审计
1618
1506
  * 纪律原样保留 —— 本写入不写第 1 段 claim,详见该方法注释)。
1619
- * · op 段取名 `reclaim`(回收):不是 fold ⇒ 自动折叠默认关闭的闸
1507
+ * · op 段取名 `reclaim`(回收):不是 fold ⇒ 自动收起默认关闭的闸
1620
1508
  * (AUTOFOLD_HARD_DISABLED + isAutoFoldSource 只判 op='fold')无从触发。
1621
1509
  * ═══════════════════════════════════════════════════════════════════════════ */
1622
1510
 
@@ -1800,67 +1688,6 @@ export function createEditorApi(ctx, sessions, agents, log = () => {}, hooks = {
1800
1688
  }
1801
1689
  })
1802
1690
 
1803
- /* @public-strip:start */
1804
- /**
1805
- * 折叠完成块(marker 折叠承载):遮蔽 [start..end] 完成块区间,
1806
- * 日志 append-only 不变(sourceEventSeqs 记录被遮蔽 seq,可展开)。摘要由
1807
- * 生成(marker content);本 op = 承载(区间折叠 + marker 写入)。
1808
- * 端点必须是当前 surface 节点;已被遮蔽的端点 → target-shadowed。
1809
- */
1810
- const fold = op(async (args) => {
1811
- // 折叠入口取证:走宿主 logger(console.log 进不了宿主日志 ⇒ 排障
1812
- // 时零证据);带调用栈前几帧,分辨 api.fold 的实际调用方(自动层/手动入口/其它)。
1813
- try {
1814
- const st = new Error('fold-caller').stack || ''
1815
- log(`retrace-fold-evidence: fold 入口被调用 session=${String(args?.sessionId ?? '')} ${String(args?.start ?? '')}..${String(args?.end ?? '')} userInitiated=${args?.userInitiated === true} 调用栈=${st.split('\n').slice(1, 6).join(' | ').slice(0, 600)}`)
1816
- } catch { /* 取证失败不影响折叠 */ }
1817
- const sessionId = String(args?.sessionId ?? '')
1818
- const session = requireSession(sessionId)
1819
- await ensureIdle(agents.get(sessionId))
1820
- const startSeq = Number(args?.start)
1821
- const endSeq = Number(args?.end)
1822
- if (!Number.isInteger(startSeq) || !Number.isInteger(endSeq) || startSeq < 0 || endSeq < startSeq) {
1823
- throw editorError('bad-fold-range', 'fold 需要合法完成块区间 [start..end](surface 节点 seq,start<=end)')
1824
- }
1825
- // 主路径:index.js 注入 args.span(文件 spanFromFile range mode,官方 foldSurface nodes);
1826
- // fallback:内存 surface.nodes 位置段(host 视图尽力)。
1827
- const span = args?.span ?? rangeSpanFrom(session, startSeq, endSeq)
1828
- if (!span) {
1829
- // 显式状态(不再用 null 猜)——重放失败报内部错误,未落盘报可重试,
1830
- // 其余(端点已被遮蔽/非 surface 节点)保持折叠既有文案与错误码(行为兼容)。
1831
- const status = args?.spanStatus
1832
- if (status === SPAN_STATUS.REPLAY_FAILED) throw editorError('span-replay-failed', SPAN_REPLAY_FAILED_MESSAGE, { start: startSeq, end: endSeq, ...replayFailedDetails(args) })
1833
- if (status === SPAN_STATUS.NOT_PERSISTED) throw editorError('message-pending', PENDING_TARGET_MESSAGE, { start: startSeq, end: endSeq })
1834
- throw editorError('target-shadowed', '折叠区间端点不在当前 surface(已被遮蔽或非节点)——完成块边界需为 surface 节点')
1835
- }
1836
- // 折叠 marker content = 确定摘要(index.js 从文件生成注入 args.summary;
1837
- // 摘要替代折叠块进模型上下文——折叠语义 = 归档可回填,非移除)。
1838
- // 结构化摘要:args.summary = serializeTrio 人读文本(进第 2 段 content,即留痕 + 可解释
1839
- // 的载体);args.trio = 结构化摘要(官方词表无结构化落点 ⇒ 由写入器在无 summary
1840
- // 时就地序列化进 content;旧数据的 editor.trio 仍由读端识别)。
1841
- const summary = typeof args?.summary === 'string' && args.summary.trim() ? args.summary : ''
1842
- const trio = args?.trio && typeof args.trio === 'object' ? args.trio : undefined
1843
- const markerEvent = await writeMarker(session, span, 'fold', startSeq, '', {
1844
- content: summary ? [{ type: 'text', text: summary }] : [],
1845
- ...(trio ? { trio } : {}),
1846
- // 自动折叠默认关闭闸的来源判定随 meta 下传(写入器入口按它拒写自动来源):
1847
- // 用户显式发起的手动 fold 打 userInitiated;自动层自报 autoFoldSource;
1848
- // 两者都没有 = 按自动来源处理(fail-closed)。
1849
- ...(args?.userInitiated === true ? { userInitiated: true } : {}),
1850
- ...(args?.autoFoldSource === true ? { autoFoldSource: true } : {}),
1851
- })
1852
- await flushSafely(session)
1853
- notifyBoundary('fold', session, span, markerEvent, '')
1854
- return {
1855
- op: 'fold',
1856
- start: startSeq,
1857
- end: endSeq,
1858
- markerSeq: markerEvent.seq,
1859
- shadowed: span.shadowedSeqs.length,
1860
- }
1861
- })
1862
- /* @public-strip:end */
1863
-
1864
1691
  /**
1865
1692
  * 真正恢复(日志层面遮蔽撤销,0.4.126)—— 与 `unhide` 并列的第二条替代操作。
1866
1693
  *
@@ -2024,23 +1851,5 @@ export function createEditorApi(ctx, sessions, agents, log = () => {}, hooks = {
2024
1851
  unshadow: (args) => unshadow(args),
2025
1852
  recallIndex: (args) => recallIndex(args),
2026
1853
  reclaim: (args) => reclaim(args),
2027
- fold: (args) => fold(args), // @public-strip-line
2028
1854
  }
2029
1855
  }
2030
-
2031
- /* @public-strip:start */
2032
- /** 内存 surface.nodes 的区间位置段(尽力;主路径 = 文件 spanFromFile range mode)。
2033
- * 区间段规则同样收敛到 span-semantics.spanAt(单一实现)。 */
2034
- function rangeSpanFrom(session, startSeq, endSeq) {
2035
- const nodes = Array.isArray(session?.surface?.nodes) ? session.surface.nodes : []
2036
- // 与适配层(computeSpan)同一接线:eventOf = 内存事件视图取事件(host-compat
2037
- // eventAt);pairAssistantTools 必须 true(`tool/call` 不是面节点,面上要配对的
2038
- // 是 assistant 的 tool-call 块 ↔ tool/result——守卫 W1 的 wire 口径)。
2039
- return spanAt(nodes, nodes.indexOf(startSeq), {
2040
- mode: 'range',
2041
- endSeq,
2042
- eventOf: (seq) => eventAt(session, seq),
2043
- pairAssistantTools: true,
2044
- })
2045
- }
2046
- /* @public-strip:end */