dsh-agent-board 1.7.8 → 1.8.0

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.
package/lib/rpc.mjs CHANGED
@@ -13,6 +13,7 @@ import { TASK_SIZE_CONTRACT, withSplitHint, pushRejectLesson, pushArbitrationLes
13
13
  import { makeMsg } from './notify.mjs'
14
14
  import { computeHealthHints, computeRuntimeHealthHints } from './health.mjs'
15
15
  import { isFullSessionId } from './session.mjs' // 幻影板防线口径(纯函数,与 policy.mjs 直引同例)
16
+ import { previewCleanup, runCleanup, SKIP_REASON_TEXT } from './cleanup.mjs' // 已结算会话清理(预览+执行)
16
17
  const { ah, isb, gsb, gpt, vt, validateDeps, classifyPipeline, cfg, claimCheck, claimApply, resolveApply, verifyApply, lateVerdictApply, archiveApply, cancelApply, maybeAutoCloseParent, PRIO_RANK, touchesConflict, holdsFiles, boardHome, aggregateChildStats, createTaskWarnings, epicPrecheck, epicPrecheckNote, attachContextSuggestions, REJECT_REDISPATCH_HINT, tasksHash, normalizeHooks, mergeHooks, pushRejection, normalizeUserTest, draftLint } = core
17
18
 
18
19
  function defineTool(options) {
@@ -38,10 +39,49 @@ function defineTool(options) {
38
39
  export function createRpc(ctx, state, deps) {
39
40
  // deps:session/store/notify/dispatch 各模块公共 API(index.mjs 接线注入)
40
41
  var getActorId = deps.getActorId, resolveRoot = deps.resolveRoot, toolSessionId = deps.toolSessionId, rpcSessionId = deps.rpcSessionId
42
+ // ===== GUI RPC 操作者回退(task-mv493xjs,巡检次生观察①)=====
43
+ // 面板 HTTP RPC 没有 agent 调用栈(currentInitiator 为空),getActorId() 落 'unknown',
44
+ // 流转轨迹 actor 列就显示 unknown。GUI rpc 助手(kernel.js)必带 sessionId 入参,
45
+ // 这里回退到 rpcSessionId(args)(显式 sessionId 优先,缺失时退化解为 actor 归一值),
46
+ // 历史行 actor 落真实会话身份。工具通道(task_*)有真实 initiator,不走本回退。
47
+ function rpcActor(args) { var a = getActorId(); if (a && a !== 'unknown') return a; return rpcSessionId(args) }
41
48
  var rootForSession = deps.rootForSession, deriveWorkMode = deps.deriveWorkMode, runsFor = deps.runsFor
42
49
  var rt = deps.rt, mutateLocked = deps.mutateLocked
50
+ // 续跑资格判定(task-mv6c7cbo):doIntervene 无活跃 rec 时细分「续跑窗口 / 真无 run」。
51
+ // 与 dispatch 同一函数(createDispatch 返回体透出,index.mjs 接线注入),不另写第二套口径;
52
+ // 老宿主/测试桩未注入时退化空函数——claimedBy 窗口判定仍可命中,语义只降不炸。
53
+ var resumeTarget = typeof deps.resumeTarget === 'function' ? deps.resumeTarget : function () { return '' }
43
54
  // 主窗口消耗(task-muwsol23):测试可注入临时日志根;生产 undefined → findRunLog 回退 ~/.dsh/sessions
44
55
  var sessionsRoot = (typeof deps.sessionsRoot === 'string' && deps.sessionsRoot) ? deps.sessionsRoot : undefined
56
+ // ===== 已结算会话清理(task-mv2131cz):路径根 + 活跃/血统保护集 =====
57
+ // 会话日志与 projcache 布局(与 usage.mjs findRunLog 同源):~/.dsh/sessions/<bucket>/<id>/、
58
+ // ~/.dsh/storages/session_projcache/sessions/<id>.json;注册表索引 ~/.dsh/storages/session_projcache.json
59
+ // 是宿主托管(version/seq 结构),**不清理**(残留形态见 README「存储清理」小节)。
60
+ var cleanupRoots = {
61
+ sessions: path.join(boardHome(), 'sessions'),
62
+ projcacheDir: path.join(boardHome(), 'storages', 'session_projcache', 'sessions'),
63
+ }
64
+ // 体积估算主源(task-mv39ag1e):官方 SessionPersistenceSnapshot.sizeBytes——stat(id) 只读元数据
65
+ // (不读事件日志、不取写所有权,preview 零副作用不破),替代逐会话目录递归(消全量预览 ~340ms 同步 IO)。
66
+ // 老宿主/测试桩无 sessionPersistence → statSession=null → cleanup 层回退目录遍历(双轨降级不炸)。
67
+ var cleanupSp = ctx.get && ctx.get('sessionPersistence')
68
+ var statSession = (cleanupSp && typeof cleanupSp.stat === 'function') ? function (id) { return cleanupSp.stat(id) } : null
69
+ // 不可删保护集:本板主会话自身 + 活跃树里所有会话(roots + list)——覆盖「不活跃」与「本会话血统」两闸。
70
+ // 「不活跃」判定维持活跃树/血统口径(task-mv39ag1e 决策留痕):上游官方活性判据是 open(id,'write')
71
+ // 抛 SessionAlreadyOwnedError,但 open 'write' 不抛时即**真拿到单写所有权**(且 handle close 会 drain
72
+ // 落盘)——探活本身有副作用,preview 零副作用红线不允许,故不升级,维持现有活跃树判定。
73
+ function cleanupBlockedIds(sid) {
74
+ var blocked = new Set()
75
+ blocked.add(String(sid)) // 本板主会话自身
76
+ var ag = ctx.agents
77
+ if (ag) {
78
+ try {
79
+ var roots = ag.roots(); if (Array.isArray(roots)) for (var i = 0; i < roots.length; i++) blocked.add(String(roots[i].id))
80
+ var all = ag.list(); if (Array.isArray(all)) for (var j = 0; j < all.length; j++) blocked.add(String(all[j].id))
81
+ } catch (_) {}
82
+ }
83
+ return blocked
84
+ }
45
85
  var maybeNotify = deps.maybeNotify, notifyTaskDone = deps.notifyTaskDone
46
86
  var notifyLateReject = (typeof deps.notifyLateReject === 'function') ? deps.notifyLateReject : null // 迟到驳回 err 级通知(未接线 → 静默跳过)
47
87
  var spawnOneShot = deps.spawnOneShot, accumulateRunUsage = deps.accumulateRunUsage, readContextPack = deps.readContextPack
@@ -197,13 +237,18 @@ export function createRpc(ctx, state, deps) {
197
237
  // 旧实现 roots() 只含活体会话——休眠根会话(有板有卡)恒 false,且生成开始/结束 agents 树重建有瞬态窗口
198
238
  // 返回不含本 sid(假 false),入口分钟级消失。改读持久 parentSession(见 isRootPersistent):
199
239
  // 主源 sessionPersistence.stat(sid)(持久表,休眠会话也读得到)→ header.parentSession 缺省 = 根;
240
+ // fork/seed 会话(v3→v4 迁移产物:parentSession 有值但 delegationDepth===0)同样认根
241
+ // (task-mv59nn9m:「本体数据平台开发」fork 会话被旧判据误判非根导致看板不可见);
200
242
  // 老宿主/测试桩无 sessionPersistence → 回退活跃 agent 的 session.header.parentSession,再回退旧 roots() 成员判定。
201
243
  // 防抖仍在客户端:kernel.js applyIsRoot——曾确认 true 的会话需连续 3 次 false(3s 心跳≈9s)才收抽屉;
202
244
  // 从未 true 的子代理会话仍即时收起(反馈 n-muuerxv9ijxs / task-muupr8ld)。
203
245
  async function isRootPersistent(sid) {
204
246
  var sp = ctx.get && ctx.get('sessionPersistence')
205
247
  if (sp && typeof sp.stat === 'function') {
206
- try { var snap = await sp.stat(sid); if (snap && snap.header) return !snap.header.parentSession } catch (_) {}
248
+ // 判据改用 delegationDepth(task-mv59nn9m):无父 = 根;有父但 delegationDepth===0 的 fork/seed
249
+ // 会话同样认根;delegationDepth 缺省(v3 时代老会话无此字段)且有 parentSession 时维持非根
250
+ // 保守判定——兼容 v3 时代子代理不误放行。
251
+ try { var snap = await sp.stat(sid); if (snap && snap.header) { var hh = snap.header; return !hh.parentSession || (typeof hh.delegationDepth === 'number' && hh.delegationDepth === 0) } } catch (_) {}
207
252
  }
208
253
  var ag = ctx.agents
209
254
  if (ag) {
@@ -234,6 +279,9 @@ export function createRpc(ctx, state, deps) {
234
279
  d.epicSplit = cfg(d).epicSplit
235
280
  // 自测指南开关(设置区「验收」小节)同法透出:缺字段=开,只有显式 false 才关
236
281
  d.verifyUserGuide = cfg(d).verifyUserGuide
282
+ // 清理保留天数(设置区「存储清理」小节):cfg 归一(缺字段/脏值=7,钳 1-90)后透出确定数值,
283
+ // 客户端设置区天数输入与 StorageCleanup 文案都读这一个字段(口径单一,不各自猜缺省)。
284
+ d.cleanupRetentionDays = cfg(d).cleanupRetentionDays
237
285
  // 工作模式派生字段:UI 只读这一个字段决定三档选中态(不落盘,写入仍走 boardMode/teamMode)
238
286
  d.workMode = deriveWorkMode(d)
239
287
  // ===== board 级 token 消耗聚合(现算,不落盘):总量 + 输入/输出/缓存读 + 按模型 + 任务 Top8 =====
@@ -242,7 +290,7 @@ export function createRpc(ctx, state, deps) {
242
290
  // 缺省/空范围 = 现状逐字不变(aggregateUsageSummary 内部判定,空串不算范围)。
243
291
  d.usageSummary = aggregateUsageSummary(d.tasks, args && args.range)
244
292
  // ===== 记分卡聚合底座(task-muxhtgh9 卡2):usageSummary.scoreboard =====
245
- // 模型×角色×规模段七指标桶 + 全局质量趋势 rollup;与 usageSummary 同一 range 口径(run 日落点裁剪)。
293
+ // 模型×角色×规模段八指标桶 + 全局质量趋势 rollup;与 usageSummary 同一 range 口径(run 日落点裁剪)。
246
294
  // 增量缓存 state.scoreboardCache[sid]:键=(taskCount, 最新落定时刻),命中则提取层零重算,
247
295
  // 范围裁剪在装配层现算(缓存的是未裁剪归一化记录,不随范围漂移)。
248
296
  d.usageSummary.scoreboard = buildScoreboard(d.tasks, args && args.range, state.scoreboardCache[sid] || (state.scoreboardCache[sid] = {}))
@@ -290,8 +338,21 @@ export function createRpc(ctx, state, deps) {
290
338
  if (__rkt && __rhints[__rkt.id]) __rkt.reviewHint = __rhints[__rkt.id]
291
339
  }
292
340
  // 渲染变更检测(反馈 n-mut9rzs2mkhg):tasks 关键字段的稳定 hash(纯函数,口径见 core.tasksHash),
293
- // 客户端 3s 轮询 hash 相同则跳过 state.tasks 赋值 + notify——传输仍全量,省的是渲染
341
+ // 客户端 3s 轮询 hash 相同则跳过 state.tasks 赋值 + notify
294
342
  d.tasksHash = tasksHash(d.tasks)
343
+ // ===== 条件请求瘦身(task-mv492for,巡检实证 n-mv2turd1o3iv):轮询载荷 1.34MB→KB 级 =====
344
+ // 客户端轮询带上轮 tasksHash 作 args.ifHash:一致说明任务列表实质没变——reviewHint 挂在卡上
345
+ // 已进 hash 序列化口径;childStats 纯由 tasks 派生(输入 status/parentId 已覆盖);usageSummary/
346
+ // healthHints/poolStatus/childStats/各开关是 KB 级聚合,unchanged 分支照常现算返回(上方赋值链不动)。
347
+ // 响应只剔 tasks 全量(description/context/runs/deliverable 全文——1.34MB 大头全在这),
348
+ // 客户端收 unchanged:true 保留 state.tasks 不动(见 kernel.js fetchTasks 的 unchanged 分支)。
349
+ // 不带 ifHash 的老客户端与 includeArchived(归档 tab 数据源 fetchArchived)一律走原有全量分支,零回归。
350
+ if (args && args.ifHash && args.ifHash === d.tasksHash && !args.includeArchived) {
351
+ var __light = Object.assign({}, d)
352
+ delete __light.tasks
353
+ __light.unchanged = true
354
+ return __light
355
+ }
295
356
  return d })
296
357
  // 派发前上下文预览:主 agent 用它确认"我将注入给子代理的瘦身清单"是否足够(不发任务、不落盘)
297
358
  handle('preview-context', async function (args) {
@@ -371,10 +432,10 @@ export function createRpc(ctx, state, deps) {
371
432
  out.sort(function (a, b) { return (b.lastActivity || '').localeCompare(a.lastActivity || '') })
372
433
  return { ok: true, boards: out }
373
434
  })
374
- handle('claim-task', async function (args) { var sid = rpcSessionId(args); var actor = getActorId(); return mutateLocked(sid, function (d) { var t = d.tasks.find(function (x) { return x.id === args.taskId }); if (!t) return { ok: false, error: 'not found' }; var err = claimCheck(d, t, actor); if (err) return { ok: false, error: err }; claimApply(d, t, actor, 'manual claim via board'); return { ok: true, task: t } }) })
375
- handle('resolve-task', async function (args) { var sid = rpcSessionId(args); var actor = getActorId(); return mutateLocked(sid, function (d) { var t = d.tasks.find(function (x) { return x.id === args.taskId }); if (!t) return { ok: false, error: 'not found' }; if (t.status !== 'in-progress') return { ok: false, error: 'not in-progress' }; return resolveApply(d, t, actor, args.status, args.resolution, args.resolution || args.status) }) })
376
- handle('verify-task', async function (args) { var sid = rpcSessionId(args); var actor = getActorId(); return mutateLocked(sid, function (d) { var t = d.tasks.find(function (x) { return x.id === args.taskId }); if (!t) return { ok: false, error: 'not found' }; if (t.status !== 'verifying') return { ok: false, error: 'not verifying' }; var __act = activeRunOf(sid, t); if (__act && __act.role === 'verifier' && args.force !== true) return { ok: false, error: 'Verifier 还在跑(run ' + __act.id + '),提前裁决将丢弃它的独立结论。确认提前裁决请加 force:true', verifierActive: __act.id }; delete t.escalation; delete t.verifyRetries; var r = verifyApply(d, t, actor, args.verdict, args.comment); if (args.verdict === 'rejected') { t.verification = { verdict: 'rejected', summary: args.comment || '', checks: '', at: new Date().toISOString(), by: actor }; pushRejection(t, args.comment, '', t.verification.at, actor); pushRejectLesson(d, t, args.comment); r.hint = REJECT_REDISPATCH_HINT } return r }) })
377
- handle('archive-task', async function (args) { var sid = rpcSessionId(args); var actor = getActorId(); return mutateLocked(sid, function (d) { var t = d.tasks.find(function (x) { return x.id === args.taskId }); if (!t) return { ok: false, error: 'not found' }; var __ae = archiveErr(sid, t); if (__ae) return { ok: false, error: __ae }; return archiveApply(d, t, actor, 'manual archive') }) })
435
+ handle('claim-task', async function (args) { var sid = rpcSessionId(args); var actor = rpcActor(args); return mutateLocked(sid, function (d) { var t = d.tasks.find(function (x) { return x.id === args.taskId }); if (!t) return { ok: false, error: 'not found' }; var err = claimCheck(d, t, actor); if (err) return { ok: false, error: err }; claimApply(d, t, actor, 'manual claim via board'); return { ok: true, task: t } }) })
436
+ handle('resolve-task', async function (args) { var sid = rpcSessionId(args); var actor = rpcActor(args); return mutateLocked(sid, function (d) { var t = d.tasks.find(function (x) { return x.id === args.taskId }); if (!t) return { ok: false, error: 'not found' }; if (t.status !== 'in-progress') return { ok: false, error: 'not in-progress' }; return resolveApply(d, t, actor, args.status, args.resolution, args.resolution || args.status) }) })
437
+ handle('verify-task', async function (args) { var sid = rpcSessionId(args); var actor = rpcActor(args); return mutateLocked(sid, function (d) { var t = d.tasks.find(function (x) { return x.id === args.taskId }); if (!t) return { ok: false, error: 'not found' }; if (t.status !== 'verifying') return { ok: false, error: 'not verifying' }; var __act = activeRunOf(sid, t); if (__act && __act.role === 'verifier' && args.force !== true) return { ok: false, error: 'Verifier 还在跑(run ' + __act.id + '),提前裁决将丢弃它的独立结论。确认提前裁决请加 force:true', verifierActive: __act.id }; delete t.escalation; delete t.verifyRetries; var r = verifyApply(d, t, actor, args.verdict, args.comment); if (args.verdict === 'rejected') { t.verification = { verdict: 'rejected', summary: args.comment || '', checks: '', at: new Date().toISOString(), by: actor }; pushRejection(t, args.comment, '', t.verification.at, actor); pushRejectLesson(d, t, args.comment); r.hint = REJECT_REDISPATCH_HINT } return r }) })
438
+ handle('archive-task', async function (args) { var sid = rpcSessionId(args); var actor = rpcActor(args); return mutateLocked(sid, function (d) { var t = d.tasks.find(function (x) { return x.id === args.taskId }); if (!t) return { ok: false, error: 'not found' }; var __ae = archiveErr(sid, t); if (__ae) return { ok: false, error: __ae }; return archiveApply(d, t, actor, 'manual archive') }) })
378
439
  // ===== 已阅落账(异常驱动审视①③):打开详情页即幂等落 reviewedAt(唯一新落库字段)=====
379
440
  // 幂等只写一次:已有 reviewedAt 就原样返回、绝不重写(时间戳不漂移、history 不刷屏);
380
441
  // 后续重复打开详情页零副作用。reviewedAt 进 tasksHash 序列化口径 → 落账后下一轮 get-tasks hash 变化,
@@ -403,7 +464,7 @@ export function createRpc(ctx, state, deps) {
403
464
  // 单任务删除:真删(从 d.tasks 数组移除),不写 history(记录随任务一起消失),不留档、无 undo。
404
465
  // console.error 留一行操作日志,便于事后溯源"某个卡片什么时候被谁删了"。
405
466
  handle('delete-task', async function (args) {
406
- var sid = rpcSessionId(args); var actor = getActorId()
467
+ var sid = rpcSessionId(args); var actor = rpcActor(args)
407
468
  if (!args.taskId) return { ok: false, error: 'taskId required' }
408
469
  return mutateLocked(sid, function (d) {
409
470
  var t = d.tasks.find(function (x) { return x.id === args.taskId })
@@ -447,8 +508,8 @@ export function createRpc(ctx, state, deps) {
447
508
  return cancelApply(d, t, actor, note)
448
509
  })
449
510
  }
450
- handle('cancel-task', async function (args) { return doCancel(rpcSessionId(args), getActorId(), args.taskId, args.reason) })
451
- handle('update-task', async function (args) { var sid = rpcSessionId(args); var actor = getActorId(); if (args.hooks !== undefined && hooksDenied(actor)) return { ok: false, error: HOOKS_MAIN_ONLY }; var existsFn = existsInSession(sid); var __res = await mutateLocked(sid, function (d) { var t = d.tasks.find(function (x) { return x.id === args.taskId }); if (!t) return { ok: false, error: 'not found' }; var __pre = null; if (args.title !== undefined) t.title = args.title; if (args.description !== undefined) t.description = args.description; if (args.priority !== undefined) t.priority = args.priority; if (args.tags !== undefined) t.tags = Array.isArray(args.tags) ? args.tags.map(function (s) { return String(s).trim() }).filter(function (s) { return s.length > 0 }) : []; if (args.assignMode !== undefined) t.assignMode = args.assignMode; if (args.assignee !== undefined) t.assignee = args.assignee || null; if (args.dependsOn !== undefined) { var derr = validateDeps(d, t.id, args.dependsOn); if (derr) return { ok: false, error: derr }; t.dependsOn = args.dependsOn } if (args.pipeline !== undefined) { t.pipeline = args.pipeline; t.pipelineAuto = false } if (args.contextFiles !== undefined) { if (!t.context) t.context = { files: [], docs: [], instructions: '', notes: '', relatedTasks: [], prerequisites: '' }; t.context.files = Array.isArray(args.contextFiles) ? args.contextFiles.map(String).slice(0, 20) : [] } if (args.contextNotes !== undefined) { if (!t.context) t.context = { files: [], docs: [], instructions: '', notes: '', relatedTasks: [], prerequisites: '' }; t.context.notes = typeof args.contextNotes === 'string' ? args.contextNotes.slice(0, 8000) : '' } if (args.publish) { if (t.status !== 'draft') return { ok: false, error: 'not a draft' }; t.status = 'pending'; ah(t, 'draft', 'pending', actor, 'published'); /* 调研门禁③:发布的是 epic(有子任务)时轻量预检子任务调研注入,缺失挂返回值由锁外 pushSysNote 汇总 */ __pre = epicPrecheck(d.tasks, t.id, existsFn) } if (args.unfreeze && t.frozen) { delete t.frozen; delete t.frozenAt; delete t.frozenBy; ah(t, t.status, t.status, actor, '解除冻结,重新进入派发池') } if (args.resetToPending) { var ps = t.status; t.status = 'pending'; t.claimedBy = null; t.claimedAt = null; t.resolvedAt = null; t.resolution = null; delete t.retryCount; delete t.stuckSince; delete t.cancelledAt; ah(t, ps, 'pending', actor, 'reset to pending after edit') }; if (args.hooks !== undefined) { var __he = applyHooks(t, args.hooks); if (__he.error) return { ok: false, error: __he.error } }; t.lintWarnings = draftLint(t, draftLintIo(sid, d.ownerCwd)); var __out = { ok: true, task: t }; if (__pre && __pre.missing.length) __out.epicPrecheck = __pre; return __out }); afterPublishPrecheck(sid, args.taskId, __res); return __res })
511
+ handle('cancel-task', async function (args) { return doCancel(rpcSessionId(args), rpcActor(args), args.taskId, args.reason) })
512
+ handle('update-task', async function (args) { var sid = rpcSessionId(args); var actor = rpcActor(args); if (args.hooks !== undefined && hooksDenied(actor)) return { ok: false, error: HOOKS_MAIN_ONLY }; var existsFn = existsInSession(sid); var __res = await mutateLocked(sid, function (d) { var t = d.tasks.find(function (x) { return x.id === args.taskId }); if (!t) return { ok: false, error: 'not found' }; var __pre = null; if (args.title !== undefined) t.title = args.title; if (args.description !== undefined) t.description = args.description; if (args.priority !== undefined) t.priority = args.priority; if (args.tags !== undefined) t.tags = Array.isArray(args.tags) ? args.tags.map(function (s) { return String(s).trim() }).filter(function (s) { return s.length > 0 }) : []; if (args.assignMode !== undefined) t.assignMode = args.assignMode; if (args.assignee !== undefined) t.assignee = args.assignee || null; if (args.dependsOn !== undefined) { var derr = validateDeps(d, t.id, args.dependsOn); if (derr) return { ok: false, error: derr }; t.dependsOn = args.dependsOn } if (args.pipeline !== undefined) { t.pipeline = args.pipeline; t.pipelineAuto = false } if (args.contextFiles !== undefined) { if (!t.context) t.context = { files: [], docs: [], instructions: '', notes: '', relatedTasks: [], prerequisites: '' }; t.context.files = Array.isArray(args.contextFiles) ? args.contextFiles.map(String).slice(0, 20) : [] } if (args.contextNotes !== undefined) { if (!t.context) t.context = { files: [], docs: [], instructions: '', notes: '', relatedTasks: [], prerequisites: '' }; t.context.notes = typeof args.contextNotes === 'string' ? args.contextNotes.slice(0, 8000) : '' } if (args.publish) { if (t.status !== 'draft') return { ok: false, error: 'not a draft' }; t.status = 'pending'; ah(t, 'draft', 'pending', actor, 'published'); /* 调研门禁③:发布的是 epic(有子任务)时轻量预检子任务调研注入,缺失挂返回值由锁外 pushSysNote 汇总 */ __pre = epicPrecheck(d.tasks, t.id, existsFn) } if (args.unfreeze && t.frozen) { delete t.frozen; delete t.frozenAt; delete t.frozenBy; ah(t, t.status, t.status, actor, '解除冻结,重新进入派发池') } if (args.resetToPending) { var ps = t.status; t.status = 'pending'; t.claimedBy = null; t.claimedAt = null; t.resolvedAt = null; t.resolution = null; delete t.retryCount; delete t.stuckSince; delete t.cancelledAt; ah(t, ps, 'pending', actor, 'reset to pending after edit') }; if (args.hooks !== undefined) { var __he = applyHooks(t, args.hooks); if (__he.error) return { ok: false, error: __he.error } }; t.lintWarnings = draftLint(t, draftLintIo(sid, d.ownerCwd)); var __out = { ok: true, task: t }; if (__pre && __pre.missing.length) __out.epicPrecheck = __pre; return __out }); afterPublishPrecheck(sid, args.taskId, __res); return __res })
452
513
  handle('set-board-mode', async function (args) { var sid = rpcSessionId(args); return mutateLocked(sid, function (d) { d.boardMode = args.mode === 'manual' ? 'manual' : 'auto'; if (d.boardMode === 'manual' && d.teamMode) { d.teamMode = false; teamModeCache[sid] = false }; return { ok: true, boardMode: d.boardMode, teamMode: !!d.teamMode, workMode: deriveWorkMode(d) } }) })
453
514
  handle('set-team-mode', async function (args) { var sid = rpcSessionId(args); return mutateLocked(sid, function (d) { d.teamMode = !!args.enabled; if (d.teamMode) d.boardMode = 'auto'; teamModeCache[sid] = d.teamMode; return { ok: true, teamMode: d.teamMode, boardMode: d.boardMode, workMode: deriveWorkMode(d) } }) })
454
515
  // 工作模式三档单入口(v75 UI 收敛):一次写入 boardMode+teamMode 两个字段,
@@ -507,7 +568,7 @@ export function createRpc(ctx, state, deps) {
507
568
  return { ok: true, task: t, unfrozen: true }
508
569
  })
509
570
  }
510
- handle('unfreeze-task', async function (args) { return doUnfreezeTask(rpcSessionId(args), getActorId(), args.taskId) })
571
+ handle('unfreeze-task', async function (args) { return doUnfreezeTask(rpcSessionId(args), rpcActor(args), args.taskId) })
511
572
  // 高优介入(v74):有活跃 run 则直接打进其会话;无则只记录 history(下次派发随 prompt 注入)
512
573
  // 通道选择(v1.2.4):steer 优先——下一个 step 边界即消费;followup 要等整个 turn 结束,
513
574
  // 长 turn 下干预形同失联(实测:Worker 单 turn 跑 10+ 分钟,「口径重写」类干预到位时活已按旧口径干完)。
@@ -583,8 +644,36 @@ export function createRpc(ctx, state, deps) {
583
644
  try { agent.followup(m); delivered = true; channel = 'followup' } catch (_) {}
584
645
  }
585
646
  }
586
- await mutateLocked(sid, function (d) { var t = d.tasks.find(function (x) { return x.id === taskId }); if (t) { if (!Array.isArray(t.messages)) t.messages = []; t.messages.push({ kind: 'intervention', text: msg, at: new Date().toISOString(), by: actor }); ah(t, t.status, t.status, actor, '高优干预: ' + msg.slice(0, 200) + (delivered ? '' : (missedNote || '(无活跃 run,随下次派发注入)'))) }; return t })
587
- return { ok: true, delivered: delivered, channel: channel }
647
+ // ===== 无活跃 rec 的送达提示两态细分(task-mv6c7cbo,实证 n-mv65bhk0mg5w)=====
648
+ // intervene 时刻 run 可能刚结算(incomplete,rec 已摘除)而卡仍在续跑/重排窗口——「无活跃 run」
649
+ // 技术为真但对用户误导:干预落进 t.messages,续跑指令经 buildMessages 原文带上,注入语义依旧成立。
650
+ // 锁内新鲜快照判两态:① resumeTarget(t)!==''(下次重派走续跑)或 claimedBy 还在(结算/重排窗口)
651
+ // → 文案如实写「随续跑注入」,state='resume-pending';
652
+ // ② 真无 run(无续跑资格且无认领位)→ 维持原「随下次派发注入」文案,state='no-run'。
653
+ // state 全枚举:delivered(实时送达)/ redispatch(会话不可用转重派注入)/ resume-pending / no-run,
654
+ // 供 GUI 区分提示色。
655
+ var state = delivered ? 'delivered' : (missedNote ? 'redispatch' : '')
656
+ await mutateLocked(sid, function (d) {
657
+ var t = d.tasks.find(function (x) { return x.id === taskId })
658
+ if (t) {
659
+ if (!Array.isArray(t.messages)) t.messages = []
660
+ t.messages.push({ kind: 'intervention', text: msg, at: new Date().toISOString(), by: actor })
661
+ var note = delivered ? '' : missedNote
662
+ if (!delivered && !note) {
663
+ if (resumeTarget(t) !== '' || t.claimedBy) {
664
+ note = '(run 刚结算/续跑窗口,干预将随续跑注入)'
665
+ state = 'resume-pending'
666
+ } else {
667
+ note = '(无活跃 run,随下次派发注入)'
668
+ state = 'no-run'
669
+ }
670
+ }
671
+ ah(t, t.status, t.status, actor, '高优干预: ' + msg.slice(0, 200) + note)
672
+ }
673
+ return t
674
+ })
675
+ if (!state) state = 'no-run' // 兜底:卡已不存在等异常形态也给确定态(此时干预无处落卡)
676
+ return { ok: true, delivered: delivered, channel: channel, state: state }
588
677
  }
589
678
  // 终止执行某任务的 run:一次性 dispose / continuable interrupt 后回 pending(verifying 则保持待审,由新 verifier 接手)
590
679
  async function doTerminate(sid, actor, taskId) {
@@ -640,8 +729,8 @@ export function createRpc(ctx, state, deps) {
640
729
  })
641
730
  return { ok: true }
642
731
  }
643
- handle('terminate-agent', async function (args) { return doTerminate(rpcSessionId(args), getActorId(), args.taskId) })
644
- handle('dismiss-suspect', async function (args) { return doDismiss(rpcSessionId(args), getActorId(), args.taskId) })
732
+ handle('terminate-agent', async function (args) { return doTerminate(rpcSessionId(args), rpcActor(args), args.taskId) })
733
+ handle('dismiss-suspect', async function (args) { return doDismiss(rpcSessionId(args), rpcActor(args), args.taskId) })
645
734
  ctx.tools.register(defineTool({ name: 'task_terminate', description: 'Team 模式:终止执行某任务的池中 Agent(卡死/跑偏时)。in-progress 任务回 pending 重派,verifying 由新 verifier 接手。', parameters: { type: 'object', properties: { taskId: { type: 'string' } }, required: ['taskId'] }, output: jo(), execute: async function (args) { var __ra = getActorId(); if (resolveRoot(__ra) !== __ra) return { ok: false, error: '看板管理工具仅主窗口可用(子代理无看板权限)' }; return doTerminate(toolSessionId(), getActorId(), args.taskId) } }))
646
735
  // 手动触发单任务派发(manual 模式下"派发给 Worker"按钮,或 auto 模式手动补派)
647
736
  // touches 文件级排他:默认尊重文件锁——候选与活动任务 touches 冲突时返回
@@ -668,6 +757,9 @@ export function createRpc(ctx, state, deps) {
668
757
  var t = d.tasks.find(function (x) { return x.id === args.taskId })
669
758
  if (!t) return { ok: false, error: 'task disappeared' }
670
759
  var rec = await spawnOneShot(sid, t, role)
760
+ // 落闸弃权(task-mv6c7cdm):spawn 在途被 terminate 等路径翻卡——闸门已停掉刚建的子会话,
761
+ // 占位由翻卡那笔写清掉。返回显式错误(误报 spawn failed 会误导成「再点一次」,实际是状态变了)
762
+ if (rec && rec.vetoed) return { ok: false, error: 'spawn-vetoed:派发途中任务状态已变更(可能刚被终止/重排),本轮已放弃,请查看卡片后重试' }
671
763
  if (rec) {
672
764
  if (role === 'worker') { await mutateLocked(sid, function (d) { var t2 = d.tasks.find(function (x) { return x.id === args.taskId }); if (t2 && t2.claimedBy === 'spawn-pending') t2.claimedBy = String(rec.id); return t2 }, true) }
673
765
  if (role === 'verifier') { await mutateLocked(sid, function (d) { var t2 = d.tasks.find(function (x) { return x.id === args.taskId }); if (t2) t2.verifierRun = String(rec.id); return t2 }, true) }
@@ -677,11 +769,11 @@ export function createRpc(ctx, state, deps) {
677
769
  if (role === 'worker') { await mutateLocked(sid, function (d) { var t2 = d.tasks.find(function (x) { return x.id === args.taskId }); if (t2 && t2.status === 'in-progress' && t2.claimedBy === 'spawn-pending') { t2.status = 'pending'; t2.claimedBy = null; t2.claimedAt = null; ah(t2, 'in-progress', 'pending', 'system', 'spawn 失败') }; return t2 }, true) }
678
770
  return { ok: false, error: 'spawn failed' }
679
771
  })
680
- handle('resolve-escalation', async function (args) { return doResolveEscalation(rpcSessionId(args), getActorId(), args.taskId, args.answer, args.action) })
681
- handle('intervene-agent', async function (args) { return doIntervene(rpcSessionId(args), getActorId(), args.taskId, args.message) })
772
+ handle('resolve-escalation', async function (args) { return doResolveEscalation(rpcSessionId(args), rpcActor(args), args.taskId, args.answer, args.action) })
773
+ handle('intervene-agent', async function (args) { return doIntervene(rpcSessionId(args), rpcActor(args), args.taskId, args.message) })
682
774
  // 主 Agent 工具版(Team 模式下主 Agent 通过工具裁决/介入)
683
775
  ctx.tools.register(defineTool({ name: 'task_arbitrate', description: 'Team 模式:裁决 Worker 上报的歧义(escalation)。action=resume(默认)裁决后任务回派发池立即重派;action=hold 任务挂起冻结、不参与自动派发(留给主窗口补 dependsOn/上下文,补完后用 task_update unfreeze:true 解冻)。', parameters: { type: 'object', properties: { taskId: { type: 'string' }, answer: { type: 'string' }, action: { type: 'string', enum: ['resume', 'hold'], description: 'resume(默认)=裁决后重新派发;hold=挂起冻结不派发' } }, required: ['taskId', 'answer'] }, output: jo(), execute: async function (args) { var __ra = getActorId(); if (resolveRoot(__ra) !== __ra) return { ok: false, error: '看板管理工具仅主窗口可用(子代理无看板权限)' }; return doResolveEscalation(toolSessionId(), getActorId(), args.taskId, args.answer, args.action) } }))
684
- ctx.tools.register(defineTool({ name: 'task_intervene', description: 'Team 模式:向执行某任务的池中 Agent 发起高优先级指令(steer 通道,当前 step 结束即响应;无活跃 run 时记录随下次派发注入)。', parameters: { type: 'object', properties: { taskId: { type: 'string' }, message: { type: 'string' } }, required: ['taskId', 'message'] }, output: jo(), execute: async function (args) { var __ra = getActorId(); if (resolveRoot(__ra) !== __ra) return { ok: false, error: '看板管理工具仅主窗口可用(子代理无看板权限)' }; return doIntervene(toolSessionId(), getActorId(), args.taskId, args.message) } }))
776
+ ctx.tools.register(defineTool({ name: 'task_intervene', description: 'Team 模式:向执行某任务的池中 Agent 发起高优先级指令(steer 通道,当前 step 结束即响应;无活跃 run 时记录随下次派发注入——run 刚结算/续跑窗口内随续跑注入,真无 run 随下次派发注入,返回体 state 字段区分:delivered / redispatch / resume-pending / no-run)。', parameters: { type: 'object', properties: { taskId: { type: 'string' }, message: { type: 'string' } }, required: ['taskId', 'message'] }, output: jo(), execute: async function (args) { var __ra = getActorId(); if (resolveRoot(__ra) !== __ra) return { ok: false, error: '看板管理工具仅主窗口可用(子代理无看板权限)' }; return doIntervene(toolSessionId(), getActorId(), args.taskId, args.message) } }))
685
777
  // ===== 池中 Agent 结构化回报工具(双模:工具优先,文本分段为降级路径)=====
686
778
  ctx.tools.register(defineTool({ name: 'board_report', description: '[任务看板 Worker 专用] 上报任务结果。kind=complete 时填 summary/changes/selfTest/diffStat(git 仓库内改动附 git diff --stat 概要);kind=escalate 时填 question(歧义上报,等待主窗口裁决);kind=progress 时填 question(一行里程碑进展摘要,≤200 字符)——只在有实际产物/结论时报,禁止定时或表演式汇报,静默不通知主窗口。', parameters: { type: 'object', properties: { taskId: { type: 'string' }, kind: { type: 'string', enum: ['complete', 'escalate', 'progress'] }, summary: { type: 'string' }, changes: { type: 'string' }, selfTest: { type: 'string' }, diffStat: { type: 'string', description: '变更概要:git diff --stat(含 git status --short)输出,≤1500 字符' }, question: { type: 'string', description: 'kind=escalate:歧义原文;kind=progress:一行里程碑进展摘要(≤200 字符)' } }, required: ['taskId', 'kind'] }, output: jo(), execute: async function (args) {
687
779
  var sid = toolSessionId(); var actor = getActorId()
@@ -774,9 +866,10 @@ export function createRpc(ctx, state, deps) {
774
866
  }
775
867
  return result
776
868
  } }))
777
- // 枚举当前网关可用模型(供 Verifier 模型下拉选择):llm.listProviders + listModels
778
- handle('list-models', async function () {
779
- var llm = ctx.get('llm'); if (!llm) return { ok: false, error: 'llm service unavailable' }
869
+ // 枚举当前网关可用模型(list-models handler 与 set-board-config 模型校验共用):
870
+ // llm.listProviders + listModels;llm 服务缺失(老宿主)返回 null——调用方据此降级,不炸。
871
+ async function enumModels() {
872
+ var llm = ctx.get('llm'); if (!llm) return null
780
873
  var providers = llm.listProviders()
781
874
  var out = []
782
875
  for (var i = 0; i < providers.length; i++) {
@@ -785,7 +878,13 @@ export function createRpc(ctx, state, deps) {
785
878
  for (var j = 0; j < models.length; j++) out.push({ id: providers[i].id + '/' + models[j].id, name: models[j].name || models[j].id, provider: providers[i].name || providers[i].id })
786
879
  } catch (_) { /* 某 provider 枚举失败不阻塞整体 */ }
787
880
  }
788
- return { ok: true, models: out }
881
+ return out
882
+ }
883
+ // 枚举当前网关可用模型(供 Verifier 模型下拉选择):llm.listProviders + listModels
884
+ handle('list-models', async function () {
885
+ var models = await enumModels()
886
+ if (!models) return { ok: false, error: 'llm service unavailable' }
887
+ return { ok: true, models: models }
789
888
  })
790
889
  // ===== 学习飞轮 v1:沉淀推送通道(push-lesson)=====
791
890
  // 详情页「沉淀」按钮 → 把结构化候选教训 followup 给主窗口 agent,由它用自己可用的
@@ -813,15 +912,35 @@ export function createRpc(ctx, state, deps) {
813
912
  // 史诗拆分总开关 epicSplit(UI「功能」小节):布尔原样落盘 + **当场回填 epicSplitCache**——Team 提示词
814
913
  // 组装是同步函数只能读缓存,不回填就得等下一次 rt() 读盘才生效(关掉后仍按旧的劝拆一轮,体感是开关没生效)。
815
914
  // 与 feedbackEnabled 同款双写;机制面(parentId 建子卡/自动收口/hooks)不看这个键。
816
- handle('set-board-config', async function (args) { var sid = rpcSessionId(args); return mutateLocked(sid, function (d) { if (args.key === 'maxWorkers') d.maxWorkers = Math.max(1, Math.min(10, args.value || 3)); else if (args.key === 'maxVerifiers') d.maxVerifiers = Math.max(0, Math.min(5, args.value || 0)); else if (args.key === 'workerModel') d.workerModel = typeof args.value === 'string' ? args.value.trim() : ''; else if (args.key === 'verifierModel') d.verifierModel = typeof args.value === 'string' ? args.value.trim() : ''; else if (args.key === 'softTimeoutMin') d.softTimeoutMin = Math.max(1, Math.min(480, Number(args.value) || 30)); else if (args.key === 'hardTimeoutMin') d.hardTimeoutMin = Math.max(1, Math.min(1440, Number(args.value) || 120)); else if (args.key === 'feedbackEnabled') { d.feedbackEnabled = !!args.value; feedbackCache[sid] = d.feedbackEnabled } else if (args.key === 'notifyDispatch') d.notifyDispatch = !!args.value; else if (args.key === 'notifyDone') d.notifyDone = !!args.value; else if (args.key === 'workerContinuable') d.workerContinuable = !!args.value; else if (args.key === 'verifyUserGuide') d.verifyUserGuide = !!args.value; else if (args.key === 'epicSplit') { d.epicSplit = !!args.value; epicSplitCache[sid] = d.epicSplit } return { ok: true } }) })
817
- handle('create-task', async function (args) { var sid = rpcSessionId(args); /* 短 id 防幻影板(task-muuf0o7a):截断/不完整 sessionId 建出的板永远匹配不到活 root(每 15s 刷屏元凶),显式报错优于静默建幻影板;import- 前缀板由 isFullSessionId 放行 */ if (!isFullSessionId(sid)) return { ok: false, error: 'sessionId 不完整(疑似截断短 id),拒绝创建任务: ' + sid }; var actor = getActorId(); /* hooks 只许主窗口设置(角色门禁) */ if (args.hooks !== undefined && hooksDenied(actor)) return { ok: false, error: HOOKS_MAIN_ONLY }; return mutateLocked(sid, function (d) { var nHooks = null; if (args.hooks !== undefined) { var hn = normalizeHooks(args.hooks); if (hn.error) return { ok: false, error: hn.error }; nHooks = hn.hooks } if (args.id && d.tasks.find(function (x) { return x.id === args.id })) return { ok: false, error: 'duplicate id' }; if (args.dependsOn && args.dependsOn.length) { var derr = validateDeps(d, args.id || '(pending)', args.dependsOn); if (derr) return { ok: false, error: derr } }; var now = new Date().toISOString(); /* Team 模式护栏:draft 缺省跟随 teamMode(先补齐依赖/上下文再统一 publish);显式 draft:false 保留为立即派发的逃生门 */ var asDraft = args.draft === undefined ? !!d.teamMode : !!args.draft; var t = { id: args.id || ('task-' + Date.now().toString(36)), title: args.title || 'Untitled', description: args.description || '', status: asDraft ? 'draft' : 'pending', priority: args.priority || 'medium', tags: args.tags || [], parentId: args.parentId || null, subtaskStrategy: null, assignMode: 'auto', assignee: null, context: { files: (Array.isArray(args.contextFiles) ? args.contextFiles.map(String).slice(0, 20) : []), docs: [], instructions: args.instructions || '', notes: (typeof args.contextNotes === 'string' ? args.contextNotes.slice(0, 8000) : ''), relatedTasks: [], prerequisites: '' }, acceptance: args.acceptance || '', dependsOn: args.dependsOn || [], touches: normTouches(args.touches), pipeline: args.pipeline || '', claimedBy: null, claimedAt: null, createdAt: now, resolvedAt: null, verifiedAt: null, verifiedBy: null, archivedAt: null, resolution: null, waitingForTouches: null, messages: [], history: [{ from: 'created', to: asDraft ? 'draft' : 'pending', timestamp: now, actor: actor, note: asDraft ? 'created as draft' : 'created' }] }; if (nHooks && Object.keys(nHooks).length) t.hooks = nHooks; if (!t.pipeline) { t.pipeline = classifyPipeline(t); t.pipelineAuto = true }; d.tasks.push(t); t.lintWarnings = draftLint(t, draftLintIo(sid, d.ownerCwd)); /* 调研门禁 warning 族(与并行 UI 卡约定字段名 warning,core 纯函数统一口径):空描述/无调研上下文/整树 glob 三类软提示合并为一条(;分隔),不拦截创建;字段可选,老 client 无感 */ var out = withSplitHint({ ok: true, task: t }, t, cfg(d).epicSplit); var warns = createTaskWarnings(t); attachContextSuggestions(out, warns, t.touches, existsInSession(sid)); if (warns.length) out.warning = warns.join(';'); return out }) })
915
+ handle('set-board-config', async function (args) {
916
+ var sid = rpcSessionId(args)
917
+ // ===== 模型字段校验(task-mv73ym2k,实证 n-mv6ezj6vary4:手写显示名当 id → 验收 spawn UNKNOWN_MODEL 秒死×2 + 熔断误报「连续失败」)=====
918
+ // workerModel/verifierModel 的非空值必须先过合法 id 校验:经 enumModels() 枚举当前网关清单(list-models 同款口径),
919
+ // 不命中则拒写并返回合法清单样例(前 8 个防刷屏);空串=清除覆盖,放行。
920
+ // 降级纪律:llm 服务缺失(老宿主,enumModels 返回 null)跳过校验直接放行——配置面绝不因宿主能力缺失而炸。
921
+ var mkey = (args.key === 'workerModel' || args.key === 'verifierModel') ? args.key : null
922
+ var mval = mkey && typeof args.value === 'string' ? args.value.trim() : ''
923
+ if (mkey && mval) {
924
+ var legal = await enumModels()
925
+ if (legal) {
926
+ var hit = false
927
+ for (var mi = 0; mi < legal.length; mi++) { if (legal[mi].id === mval) { hit = true; break } }
928
+ if (!hit) {
929
+ var sample = legal.slice(0, 8).map(function (m) { return m.id })
930
+ return { ok: false, error: '非法模型 id: ' + mval + '(不在当前网关可用清单)。合法清单(' + legal.length + ' 个,示前 ' + sample.length + ' 个):' + (sample.join('、') || '(空)') + '。完整清单见 list-models' }
931
+ }
932
+ }
933
+ }
934
+ return mutateLocked(sid, function (d) { if (args.key === 'maxWorkers') d.maxWorkers = Math.max(1, Math.min(10, args.value || 3)); else if (args.key === 'maxVerifiers') d.maxVerifiers = Math.max(0, Math.min(5, args.value || 0)); else if (args.key === 'workerModel') d.workerModel = typeof args.value === 'string' ? args.value.trim() : ''; else if (args.key === 'verifierModel') d.verifierModel = typeof args.value === 'string' ? args.value.trim() : ''; else if (args.key === 'softTimeoutMin') d.softTimeoutMin = Math.max(1, Math.min(480, Number(args.value) || 30)); else if (args.key === 'hardTimeoutMin') d.hardTimeoutMin = Math.max(1, Math.min(1440, Number(args.value) || 120)); else if (args.key === 'cleanupRetentionDays') d.cleanupRetentionDays = Math.max(1, Math.min(90, Number(args.value) || 7)); else if (args.key === 'feedbackEnabled') { d.feedbackEnabled = !!args.value; feedbackCache[sid] = d.feedbackEnabled } else if (args.key === 'notifyDispatch') d.notifyDispatch = !!args.value; else if (args.key === 'notifyDone') d.notifyDone = !!args.value; else if (args.key === 'workerContinuable') d.workerContinuable = !!args.value; else if (args.key === 'verifyUserGuide') d.verifyUserGuide = !!args.value; else if (args.key === 'epicSplit') { d.epicSplit = !!args.value; epicSplitCache[sid] = d.epicSplit } return { ok: true } })
935
+ })
936
+ handle('create-task', async function (args) { var sid = rpcSessionId(args); /* 短 id 防幻影板(task-muuf0o7a):截断/不完整 sessionId 建出的板永远匹配不到活 root(每 15s 刷屏元凶),显式报错优于静默建幻影板;import- 前缀板由 isFullSessionId 放行 */ if (!isFullSessionId(sid)) return { ok: false, error: 'sessionId 不完整(疑似截断短 id),拒绝创建任务: ' + sid }; var actor = rpcActor(args); /* hooks 只许主窗口设置(角色门禁) */ if (args.hooks !== undefined && hooksDenied(actor)) return { ok: false, error: HOOKS_MAIN_ONLY }; return mutateLocked(sid, function (d) { var nHooks = null; if (args.hooks !== undefined) { var hn = normalizeHooks(args.hooks); if (hn.error) return { ok: false, error: hn.error }; nHooks = hn.hooks } if (args.id && d.tasks.find(function (x) { return x.id === args.id })) return { ok: false, error: 'duplicate id' }; if (args.dependsOn && args.dependsOn.length) { var derr = validateDeps(d, args.id || '(pending)', args.dependsOn); if (derr) return { ok: false, error: derr } }; var now = new Date().toISOString(); /* Team 模式护栏:draft 缺省跟随 teamMode(先补齐依赖/上下文再统一 publish);显式 draft:false 保留为立即派发的逃生门 */ var asDraft = args.draft === undefined ? !!d.teamMode : !!args.draft; var t = { id: args.id || ('task-' + Date.now().toString(36)), title: args.title || 'Untitled', description: args.description || '', status: asDraft ? 'draft' : 'pending', priority: args.priority || 'medium', tags: args.tags || [], parentId: args.parentId || null, subtaskStrategy: null, assignMode: 'auto', assignee: null, context: { files: (Array.isArray(args.contextFiles) ? args.contextFiles.map(String).slice(0, 20) : []), docs: [], instructions: args.instructions || '', notes: (typeof args.contextNotes === 'string' ? args.contextNotes.slice(0, 8000) : ''), relatedTasks: [], prerequisites: '' }, acceptance: args.acceptance || '', dependsOn: args.dependsOn || [], touches: normTouches(args.touches), pipeline: args.pipeline || '', claimedBy: null, claimedAt: null, createdAt: now, resolvedAt: null, verifiedAt: null, verifiedBy: null, archivedAt: null, resolution: null, waitingForTouches: null, messages: [], history: [{ from: 'created', to: asDraft ? 'draft' : 'pending', timestamp: now, actor: actor, note: asDraft ? 'created as draft' : 'created' }] }; if (nHooks && Object.keys(nHooks).length) t.hooks = nHooks; if (!t.pipeline) { t.pipeline = classifyPipeline(t); t.pipelineAuto = true }; d.tasks.push(t); t.lintWarnings = draftLint(t, draftLintIo(sid, d.ownerCwd)); /* 调研门禁 warning 族(与并行 UI 卡约定字段名 warning,core 纯函数统一口径):空描述/无调研上下文/整树 glob 三类软提示合并为一条(;分隔),不拦截创建;字段可选,老 client 无感 */ var out = withSplitHint({ ok: true, task: t }, t, cfg(d).epicSplit); var warns = createTaskWarnings(t); attachContextSuggestions(out, warns, t.touches, existsInSession(sid)); if (warns.length) out.warning = warns.join(';'); return out }) })
818
937
  handle('list-children', async function (args) { var sid = rpcSessionId(args); var subs = ctx.subagents; if (!subs) return { ok: true, children: [] }; try { var list = await subs.listChildren(sid); var children = (list || []).map(function (c) { return { id: String(c.sessionId || c.id || ''), label: String(c.label || c.title || c.mode || '') } }).filter(function (c) { return c.id.length > 0 }); return { ok: true, children: children } } catch (e) { return { ok: true, children: [], error: String(e) } } })
819
938
  // ===== #14 批量操作:archive(仅 resolved/cancelled)/ set-priority(全部)/ delete(真删,无 undo)=====
820
939
  // delete op 与单任务 delete-task 走同一套 deleteGate 门禁(状态 + 未归档子任务),
821
940
  // done/skipped 语义与 archive 完全一致:门禁不过就进 skipped(附 reasons[id] 一行原因)。
822
941
  // 注意:批量删除是**真删**(从 tasks 数组移除),不产生 undo 快照——batch-undo 对 delete 无意义。
823
942
  handle('batch-op', async function (args) {
824
- var sid = rpcSessionId(args); var actor = getActorId()
943
+ var sid = rpcSessionId(args); var actor = rpcActor(args)
825
944
  var ids = Array.isArray(args.ids) ? args.ids : []
826
945
  if (ids.length === 0) return { ok: false, error: 'no ids' }
827
946
  return mutateLocked(sid, function (d) {
@@ -872,7 +991,7 @@ export function createRpc(ctx, state, deps) {
872
991
  // 客户端也不为 delete 显示「↩️ 撤销」按钮(snapshot 只在 done>0 且 op!=='delete' 时保留)。
873
992
  // 若老客户端硬发 op='delete' 快照进来,落到 else 分支只做 priority 回填,不会凭空复活任务。
874
993
  handle('batch-undo', async function (args) {
875
- var sid = rpcSessionId(args); var actor = getActorId()
994
+ var sid = rpcSessionId(args); var actor = rpcActor(args)
876
995
  var snap = args && args.snapshot
877
996
  if (!snap || !Array.isArray(snap.items) || snap.items.length === 0) return { ok: false, error: 'no snapshot' }
878
997
  return mutateLocked(sid, function (d) {
@@ -893,6 +1012,34 @@ export function createRpc(ctx, state, deps) {
893
1012
  })
894
1013
  })
895
1014
 
1015
+ // ===== 已结算会话清理(task-mv2131cz):cleanup-preview / cleanup-run =====
1016
+ // preview:dry-run,返回可删清单(N 个 / 总大小 / 按卡分组 / 跳过项与理由),只读盘估体积零副作用。
1017
+ // run:confirm 执行真删(会话目录 + projcache json),删前再验路径逃逸;操作写 board.cleanupLog 留痕。
1018
+ handle('cleanup-preview', async function (args) {
1019
+ var sid = rpcSessionId(args)
1020
+ var d = await rt(sid)
1021
+ var view = await previewCleanup(d.tasks || [], { blockedIds: cleanupBlockedIds(sid), roots: cleanupRoots, retentionDays: cfg(d).cleanupRetentionDays, statSession: statSession })
1022
+ var skipped = (view.skipped || []).map(function (s) { return { id: s.id, taskId: s.taskId, reason: s.reason, text: s.text || SKIP_REASON_TEXT[s.reason] || s.reason } })
1023
+ return { ok: true, total: view.total, totalBytes: view.totalBytes, items: view.items, skipped: skipped, byTask: view.byTask }
1024
+ })
1025
+ handle('cleanup-run', async function (args) {
1026
+ var sid = rpcSessionId(args)
1027
+ if (args.confirm !== true) return { ok: false, error: '删除不可恢复,需 confirm:true 确认(token 账已入卡不受影响)' }
1028
+ var d = await rt(sid)
1029
+ var view = await previewCleanup(d.tasks || [], { blockedIds: cleanupBlockedIds(sid), roots: cleanupRoots, retentionDays: cfg(d).cleanupRetentionDays, statSession: statSession })
1030
+ if (!view.items || !view.items.length) return { ok: true, deleted: 0, freedBytes: 0, note: '无可删会话' }
1031
+ var report = await runCleanup(view.items, { roots: cleanupRoots, statSession: statSession })
1032
+ // 留痕:board.cleanupLog 追加一条(不逐卡写 history 防刷屏;见 README「存储清理」小节)
1033
+ await mutateLocked(sid, function (dd) {
1034
+ if (!Array.isArray(dd.cleanupLog)) dd.cleanupLog = []
1035
+ dd.cleanupLog.push({ at: new Date().toISOString(), by: rpcActor(args), deleted: report.deleted, freedBytes: report.freedBytes, ids: report.deletedIds })
1036
+ if (dd.cleanupLog.length > 50) dd.cleanupLog = dd.cleanupLog.slice(-50)
1037
+ return { ok: true }
1038
+ }, true)
1039
+ var skippedText = (report.skipped || []).map(function (s) { return { id: s.id, reason: s.reason, text: SKIP_REASON_TEXT[s.reason] || s.reason } })
1040
+ return { ok: true, deleted: report.deleted, freedBytes: report.freedBytes, deletedIds: report.deletedIds, skipped: skippedText }
1041
+ })
1042
+
896
1043
  // ===== client ↔ host RPC:POST /dsh-agent-board { method, args } → JSON =====
897
1044
  function readBody(req, limit) {
898
1045
  return new Promise(function (resolve, reject) {
package/lib/usage.mjs CHANGED
@@ -632,7 +632,7 @@ export function attributeRejection(t, rejectedAt) {
632
632
  }
633
633
  }
634
634
 
635
- // ===== 记分卡聚合底座(task-muxhtgh9 卡2):scoreboard = 模型×角色×规模段七指标桶 + 全局质量趋势 rollup =====
635
+ // ===== 记分卡聚合底座(task-muxhtgh9 卡2):scoreboard = 模型×角色×规模段八指标桶 + 全局质量趋势 rollup =====
636
636
  // 设计稿 v3(笔记 n-muwsq9yztrpa)。数据源与卡1相同:任务级 t.runs[] 留账 + t.messages 驳回包
637
637
  // (kind='rejection',三条驳回来源统一落点,pushRejection 已按 at/文本头判重)+ 落定时刻
638
638
  // (approved 验收 = t.verifiedAt;direct/work 档直落 resolved = t.resolvedAt)。纯函数零 IO:
@@ -641,7 +641,7 @@ export function attributeRejection(t, rejectedAt) {
641
641
  // 两层结构(增量缓存的关键):
642
642
  // 提取层 buildScoreRecs(tasks):扫全部任务的 runs/驳回消息,产出归一化记录 —— 唯一的重活
643
643
  // (逐 run 归一 + 驳回归因 + 日落点解析 + 任务级规模段都在这层)。
644
- // 装配层 assembleScoreboard(recs, range):七指标桶 + 趋势 rollup + 范围裁剪,每次调用现算,
644
+ // 装配层 assembleScoreboard(recs, range):八指标桶 + 趋势 rollup + 范围裁剪,每次调用现算,
645
645
  // 输入只是归一化记录(轻量数组 pass)——范围切换不触发重提取。
646
646
  // 增量缓存:runs 只增不改 —— 缓存槽(调用方持有,与 mainWindow 尾读缓存并列在 state)形态
647
647
  // { taskCount, stamp, recs },键 = (任务数, 最新落定时刻)。stamp 在「最新 run at/endedAt」上扩了
@@ -814,7 +814,7 @@ function assembleScoreboard(recs, range) {
814
814
  var key = q.model + '|' + q.role + '|' + q.size
815
815
  var b = bmap[key]
816
816
  if (!b) {
817
- b = { key: key, model: q.model, role: q.role, size: q.size, runs: 0, effSum: 0, effCount: 0, durs: [], rejected: 0, resolved: 0, firstPass: 0, timeouts: 0, resumes: 0, inpSum: 0, crSum: 0 }
817
+ b = { key: key, model: q.model, role: q.role, size: q.size, runs: 0, effSum: 0, effCount: 0, durs: [], rejected: 0, resolved: 0, firstPass: 0, timeouts: 0, failed: 0, resumes: 0, inpSum: 0, crSum: 0 }
818
818
  bmap[key] = b; bTasks[key] = {}
819
819
  }
820
820
  b.runs++
@@ -822,6 +822,11 @@ function assembleScoreboard(recs, range) {
822
822
  if (q.eff !== null) { b.effSum += q.eff; b.effCount++ }
823
823
  if (q.durMs !== null) b.durs.push(q.durMs)
824
824
  if (q.outcome === 'timeout/error' || q.outcome === 'timeout') b.timeouts++
825
+ // 失败计数(task-mv73ym6i):跑崩落定的 run 不再隐形——outcome ∈ {incomplete, error, failed}
826
+ // (settleRun 失败臂无 err 时落定 'incomplete',flash 验收员猝死实证就是这种);'timeout/error'
827
+ // 有独立超时率维度(上一行)不重复计;terminated = 人工终止(人工动作非模型表现)、
828
+ // stale-closed = 老卡 running 残留关账,均不算失败。
829
+ if (q.outcome === 'incomplete' || q.outcome === 'error' || q.outcome === 'failed') b.failed++
825
830
  if (q.resume) b.resumes++
826
831
  if (q.inp !== null || q.cr !== null) { b.inpSum += q.inp || 0; b.crSum += q.cr || 0 }
827
832
  bTasks[key][q.taskId] = true
@@ -853,7 +858,7 @@ function assembleScoreboard(recs, range) {
853
858
  if (!tk.rejectCount) bb.firstPass++
854
859
  }
855
860
  }
856
- // ===== 七指标定稿 =====
861
+ // ===== 八指标定稿(task-mv73ym6i 补失败率维度)=====
857
862
  var out = []
858
863
  for (var fk in bmap) {
859
864
  if (!Object.prototype.hasOwnProperty.call(bmap, fk)) continue
@@ -878,6 +883,10 @@ function assembleScoreboard(recs, range) {
878
883
  // 口径);若某 provider 把缓存读并进 input,分母被双计、命中率失真——跨 provider 对比先核各家口径。
879
884
  // 无 usage 样本(inpSum+crSum=0)→ null(不假装 0)。
880
885
  cacheHitRate: (f.inpSum + f.crSum) > 0 ? f.crSum / (f.inpSum + f.crSum) : null,
886
+ // ⑧ 失败率(task-mv73ym6i)= 跑崩落定 run / 桶内 runs:outcome ∈ {incomplete, error, failed}。
887
+ // terminated(人工终止)不计入——那是人工动作不是模型跑崩;stale-closed(老卡残留关账)同不计;
888
+ // 与 ⑤ 超时率互补不重叠(timeout/error 只走超时维度)。
889
+ failed: f.failed, failRate: f.runs ? f.failed / f.runs : 0,
881
890
  // 样本量护栏:runs < 5 标 insufficient(客户端据此灰显不排名)
882
891
  insufficient: f.runs < SCOREBOARD_MIN_SAMPLE
883
892
  })
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "dsh-agent-board",
3
3
  "description": "DeepSeek Harness 智能看板:任务卡片 + 一次性 Worker/Verifier 派发 + 依赖调度 + 管线分档 + Team 模式(歧义上报主窗口裁决)",
4
- "version": "1.7.8",
4
+ "version": "1.8.0",
5
5
  "type": "module",
6
6
  "main": "./index.mjs",
7
7
  "scripts": {