dsh-agent-board 1.8.3 → 1.9.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
@@ -14,7 +14,7 @@ import { makeMsg } from './notify.mjs'
14
14
  import { computeHealthHints, computeRuntimeHealthHints } from './health.mjs'
15
15
  import { isFullSessionId } from './session.mjs' // 幻影板防线口径(纯函数,与 policy.mjs 直引同例)
16
16
  import { previewCleanup, runCleanup, SKIP_REASON_TEXT } from './cleanup.mjs' // 已结算会话清理(预览+执行)
17
- const { ah, isb, gsb, gpt, vt, validateDeps, classifyPipeline, cfg, claimCheck, claimApply, resolveApply, verifyApply, lateVerdictApply, verdictErr, lateNoticeFp, archiveApply, cancelApply, maybeAutoCloseParent, PRIO_RANK, touchesConflict, holdsFiles, boardHome, aggregateChildStats, createTaskWarnings, epicPrecheck, epicPrecheckNote, attachContextSuggestions, REJECT_REDISPATCH_HINT, tasksHash, normalizeHooks, mergeHooks, pushRejection, normalizeUserTest, draftLint, appendDispatchWarning } = core
17
+ const { ah, isb, gsb, gpt, vt, validateDeps, classifyPipeline, cfg, claimCheck, claimApply, resolveApply, verifyApply, lateVerdictApply, verdictErr, lateNoticeFp, archiveApply, cancelApply, maybeAutoCloseParent, PRIO_RANK, touchesConflict, holdsFiles, boardHome, aggregateChildStats, createTaskWarnings, epicPrecheck, epicPrecheckNote, attachContextSuggestions, REJECT_REDISPATCH_HINT, tasksHash, normalizeHooks, mergeHooks, pushRejection, normalizeUserTest, draftLint, appendDispatchWarning, TASK_SIZES, opsLogLine } = core
18
18
 
19
19
  function defineTool(options) {
20
20
  var userExecute = options.execute
@@ -235,7 +235,7 @@ export function createRpc(ctx, state, deps) {
235
235
  }
236
236
 
237
237
  // ===== Tools =====
238
- ctx.tools.register(defineTool({ name: 'task_list', description: '列出当前会话任务。', parameters: { type: 'object', properties: { status: { type: 'string', enum: ['pending', 'in-progress', 'verifying', 'resolved', 'blocked', 'cancelled'] }, priority: { type: 'string', enum: ['low', 'medium', 'high', 'critical'] }, tag: { type: 'string' }, parentId: { type: 'string' }, includeArchived: { type: 'boolean' }, limit: { type: 'number' } }, required: [] }, output: jo(), execute: async function (args) { var __ra = getActorId(); if (resolveRoot(__ra) !== __ra) return { ok: false, error: '看板管理工具仅主窗口可用(子代理无看板权限)' }; var sid = toolSessionId(); var d = await rt(sid); var a = d.tasks; var ts = a; if (!args.includeArchived) ts = ts.filter(function (x) { return x.status !== 'archived' }); if (args.status) ts = ts.filter(function (x) { return x.status === args.status }); if (args.priority) ts = ts.filter(function (x) { return x.priority === args.priority }); if (args.tag) ts = ts.filter(function (x) { return (x.tags || []).indexOf(args.tag) >= 0 }); if (args.parentId === 'null') ts = ts.filter(function (x) { return !isb(x) }); else if (args.parentId) ts = ts.filter(function (x) { return x.parentId === args.parentId }); var po = PRIO_RANK; ts.sort(function (a, b) { var dd = (po[b.priority] || 0) - (po[a.priority] || 0); return dd !== 0 ? dd : (a.createdAt || '').localeCompare(b.createdAt || '') }); var lim = Math.min(args.limit || 20, 100); var res = ts.slice(0, lim).map(function (x) { var e = Object.assign({}, x); if (isb(x)) { var p = gpt(x, a); if (p) e.parentSummary = { id: p.id, title: p.title, status: p.status } }; var ch = gsb(x.id, a); if (ch.length) { e.subtaskCount = ch.length; e.subtaskResolved = ch.filter(function (y) { return y.status === 'resolved' }).length }; return e }); var out = { tasks: res, total: ts.length, session: sid, actor: getActorId(), boardMode: d.boardMode || 'auto', teamMode: !!d.teamMode, poolStatus: d.poolStatus }; if (d.teamMode) out.teamHint = 'Team 模式已开启:实质性改动请优先 task_create 提交看板由池执行;调研/读取/讨论可直接进行;Worker 歧义会上报等你裁决。'; return out } }))
238
+ ctx.tools.register(defineTool({ name: 'task_list', description: '列出当前会话任务。返回体 recentOps=最近人工/外部操作尾部 5 条单行摘要(HTTP 通道写集留痕,Team 模式下对齐「人动了什么」)。', parameters: { type: 'object', properties: { status: { type: 'string', enum: ['pending', 'in-progress', 'verifying', 'resolved', 'blocked', 'cancelled'] }, priority: { type: 'string', enum: ['low', 'medium', 'high', 'critical'] }, tag: { type: 'string' }, parentId: { type: 'string' }, includeArchived: { type: 'boolean' }, limit: { type: 'number' } }, required: [] }, output: jo(), execute: async function (args) { var __ra = getActorId(); if (resolveRoot(__ra) !== __ra) return { ok: false, error: '看板管理工具仅主窗口可用(子代理无看板权限)' }; var sid = toolSessionId(); var d = await rt(sid); var a = d.tasks; var ts = a; if (!args.includeArchived) ts = ts.filter(function (x) { return x.status !== 'archived' }); if (args.status) ts = ts.filter(function (x) { return x.status === args.status }); if (args.priority) ts = ts.filter(function (x) { return x.priority === args.priority }); if (args.tag) ts = ts.filter(function (x) { return (x.tags || []).indexOf(args.tag) >= 0 }); if (args.parentId === 'null') ts = ts.filter(function (x) { return !isb(x) }); else if (args.parentId) ts = ts.filter(function (x) { return x.parentId === args.parentId }); var po = PRIO_RANK; ts.sort(function (a, b) { var dd = (po[b.priority] || 0) - (po[a.priority] || 0); return dd !== 0 ? dd : (a.createdAt || '').localeCompare(b.createdAt || '') }); var lim = Math.min(args.limit || 20, 100); var res = ts.slice(0, lim).map(function (x) { var e = Object.assign({}, x); if (isb(x)) { var p = gpt(x, a); if (p) e.parentSummary = { id: p.id, title: p.title, status: p.status } }; var ch = gsb(x.id, a); if (ch.length) { e.subtaskCount = ch.length; e.subtaskResolved = ch.filter(function (y) { return y.status === 'resolved' }).length }; return e }); var out = { tasks: res, total: ts.length, session: sid, actor: getActorId(), boardMode: d.boardMode || 'auto', teamMode: !!d.teamMode, poolStatus: d.poolStatus, recentOps: (Array.isArray(d.opsLog) ? d.opsLog : []).slice(-5).map(opsLogLine).filter(function (s) { return s.length > 0 }) }; if (d.teamMode) out.teamHint = 'Team 模式已开启:实质性改动请优先 task_create 提交看板由池执行;调研/读取/讨论可直接进行;Worker 歧义会上报等你裁决。'; return out } }))
239
239
  ctx.tools.register(defineTool({ name: 'task_context', description: '获取任务完整上下文。', parameters: { type: 'object', properties: { taskId: { type: 'string' }, expandFiles: { type: 'boolean' }, includeParent: { type: 'boolean' }, includeSubtasks: { type: 'boolean' } }, required: ['taskId'] }, output: jo(), execute: async function (args) { var __ra = getActorId(); if (resolveRoot(__ra) !== __ra) return { ok: false, error: '看板管理工具仅主窗口可用(子代理无看板权限)' }; var sid = toolSessionId(); var d = await rt(sid); var t = d.tasks.find(function (x) { return x.id === args.taskId }); if (!t) return { ok: false, error: 'not found: ' + args.taskId }; return { ok: true, context: { task: t, inheritedContext: t.context || {} } } } }))
240
240
  ctx.tools.register(defineTool({ name: 'task_preview_context', description: '派发前上下文预览:预演 task_create 的 contextFiles/contextNotes 将注入给子代理的瘦身清单形态(调研笔记全文 + 文件清单行「路径:L行号 — 一句用途」;文件内容本体不进 prompt,由子代理按需 read 自取),用于确认材料是否足够。不创建任务。返回 ok=false/empty=true 说明无可注入内容。', parameters: { type: 'object', properties: { contextFiles: { type: 'array', items: { type: 'string' }, description: '预演的文件路径列表;支持「路径:L1-L2」锚点与可选「 — 一句用途」写法' }, contextNotes: { type: 'string', description: '预演的调研笔记' } }, required: [] }, output: jo(), execute: async function (args) { var __ra = getActorId(); if (resolveRoot(__ra) !== __ra) return { ok: false, error: '看板管理工具仅主窗口可用(子代理无看板权限)' }; toolSessionId(); /* 副作用:注册已知会话(心跳集合);清单组装不依赖会话 id */ var files = Array.isArray(args.contextFiles) ? args.contextFiles.map(String).slice(0, 20) : []; var notes = typeof args.contextNotes === 'string' ? args.contextNotes.slice(0, 8000) : ''; if (!files.length && !notes.trim()) return { ok: false, error: 'contextFiles/contextNotes 至少提供一个' }; try { var pack = readContextPack({ context: { files: files, notes: notes } }); return { ok: true, empty: !pack, pack: pack } } catch (e) { return { ok: false, error: String(e).slice(0, 200) } } } }))
241
241
  ctx.tools.register(defineTool({ name: 'task_claim', description: '领取待办任务→in-progress。', parameters: { type: 'object', properties: { taskId: { type: 'string' }, reason: { type: 'string' } }, required: ['taskId'] }, output: jo(), execute: async function (args) { var __ra = getActorId(); if (resolveRoot(__ra) !== __ra) return { ok: false, error: '看板管理工具仅主窗口可用(子代理无看板权限)' }; var sid = toolSessionId(); 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, args.reason || 'claimed'); return { ok: true, task: t, context: { task: t, inheritedContext: t.context || {} } } }) } }))
@@ -247,8 +247,27 @@ export function createRpc(ctx, state, deps) {
247
247
  ctx.tools.register(defineTool({ name: 'task_verify', description: '验收:approved→resolved,rejected→in-progress。子任务全完成父任务自动verifying。Verifier 仍在跑(无 endedAt/run outcome 仍 running)时默认拦截并返回提示;确认提前裁决请加 force:true。', parameters: { type: 'object', properties: { taskId: { type: 'string' }, verdict: { type: 'string', enum: ['approved', 'rejected'] }, comment: { type: 'string' }, force: { type: 'boolean' } }, required: ['taskId', 'verdict'] }, output: jo(), execute: async function (args) { var __ra = getActorId(); if (resolveRoot(__ra) !== __ra) return { ok: false, error: '看板管理工具仅主窗口可用(子代理无看板权限)' }; var sid = toolSessionId(); 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 }; var __vr = 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); __vr.hint = REJECT_REDISPATCH_HINT } return __vr }) } }))
248
248
  ctx.tools.register(defineTool({ name: 'task_archive', description: '归档已解决/已取消任务(无活跃 run 的 in-progress 僵尸卡也可归档,用于 parentKick 僵尸态出清)。', 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: '看板管理工具仅主窗口可用(子代理无看板权限)' }; var sid = toolSessionId(); 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, 'archived') }) } }))
249
249
  ctx.tools.register(defineTool({ name: 'task_cancel', description: '取消任务:draft/pending/blocked 态可取消(取消后不再派发,可在归档 tab 恢复待办)。in-progress/verifying 需先 terminate-agent,resolved 请用归档。reason 可选,落流转轨迹。', parameters: { type: 'object', properties: { taskId: { type: 'string' }, reason: { type: 'string', description: '取消理由(可选,随流转轨迹留档)' } }, required: ['taskId'] }, output: jo(), execute: async function (args) { var __ra = getActorId(); if (resolveRoot(__ra) !== __ra) return { ok: false, error: '看板管理工具仅主窗口可用(子代理无看板权限)' }; return doCancel(toolSessionId(), getActorId(), args.taskId, args.reason) } }))
250
- ctx.tools.register(defineTool({ name: 'task_update', description: '更新任务字段,可选重置为 pending。dependsOn/pipeline 也可更新(环检测会拒绝成环依赖)。contextFiles 可更新预研文件清单。unfreeze:true 解除裁决挂起冻结(frozen)并触发派发。', parameters: { type: 'object', properties: { taskId: { type: 'string' }, title: { type: 'string' }, description: { type: 'string' }, priority: { type: 'string', enum: ['low', 'medium', 'high', 'critical'] }, assignMode: { type: 'string', enum: ['auto', 'manual'] }, assignee: { type: 'string' }, dependsOn: { type: 'array', items: { type: 'string' } }, contextFiles: { type: 'array', items: { type: 'string' }, description: '预研文件路径(替换式更新),派发时以文件清单(路径:L行号 — 一句用途)随首条 prompt 注入,内容由子代理按需 read 自取' }, contextNotes: { type: 'string', description: '预研笔记(替换式更新):调研结论/原始需求/思路' }, pipeline: { type: 'string', enum: ['full', 'work', 'direct'] }, resetToPending: { type: 'boolean' }, unfreeze: { type: 'boolean', description: '解除冻结(frozen)并立即触发派发,用于 hold 裁决补完上下文后重新入池' }, publish: { type: 'boolean', description: '发布草稿为 pending(仅 draft 状态有效)' }, hooks: { type: 'object', additionalProperties: true, description: '史诗 hook 点位(仅主窗口可设):{ pre?: { enabled?, prompt }, post?: { enabled?, prompt } } —— hook 点=一次真实 agent 运行(不是声明式命令):pre 在子任务派发前跑一遍前置准备(未完成前该 epic 的子任务一张都不派),post 在全部子任务了结后跑一遍收口(完成后 epic 才转 verifying)。prompt 是薄框架契约(做什么由 hook agent 判断,吃不准会歧义上报)。传 null 清除,传 { pre: null } 只撤该点位。' } }, required: ['taskId'] }, output: jo(), execute: async function (args) { var __ra = getActorId(); if (args.hooks !== undefined && resolveRoot(__ra) !== __ra) return { ok: false, error: 'hooks 仅主窗口可设(子代理无 hooks 权限)' }; if (resolveRoot(__ra) !== __ra) return { ok: false, error: '看板管理工具仅主窗口可用(子代理无看板权限)' }; var sid = toolSessionId(); var actor = getActorId(); 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; var __depWarn = null; /* dependsOn 后补软提示(task-mv9yupm4②):在飞卡写依赖时挂返回体 warning 字段 */ 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.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; /* task-mv9yupm4②:在飞卡(in-progress 含 spawn-pending 占位 / verifying)写依赖只软提示——本次 run 的 prompt 已注入、不受新依赖影响(在途 spawn 由落闸锁内重验 depsSatisfied 兜底否决);不拒写不写历史 */ if (t.status === 'in-progress' || t.status === 'verifying') __depWarn = '卡已在执行中,依赖变更不影响本次 run' } 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 (__depWarn) __out.warning = __depWarn; if (__pre && __pre.missing.length) __out.epicPrecheck = __pre; return __out }); afterPublishPrecheck(sid, args.taskId, __res); return __res } }))
251
- ctx.tools.register(defineTool({ name: 'task_create', description: '创建新任务到当前会话看板。acceptance 可选:硬性验收脚本命令(如 "node --test src/x.test.js"),Worker 必须实际运行、Verifier 必须独立复跑。dependsOn 可选:依赖任务 id 数组,依赖全部完成后才会被派发。pipeline 可选:full(默认,工作+验证)/work(只做不验)/direct(不进池,主窗口直接处理)。contextFiles 可选:你在调研中已经读过的关键文件路径数组——派发时以「文件清单」(每行「路径:L起-L止 — 一句用途」)随首条 prompt 一次性注入,只给路径与行号、不含内容本体(子代理用 read 工具按行号范围按需自取:执行时盘面更新鲜,也免了大文件正文撑爆 prompt 与随快照每轮重发),避免子代理从零重复调研。contextNotes 可选:调研结论/原始需求/思路等非文件类上下文,全文随首条 prompt 一次性注入(≤8000 字符)。【开发类任务(涉及代码改动/修复/特性)务必带文件调研】:把调研中读过的关键文件路径放进 contextFiles、结论思路放进 contextNotes——实测可让 Worker 省去 10~15 分钟从零 grep 定位的时间,且方向感天壤之别(无调研的 Worker 只能靠标题猜需求、极易跑偏)。调研门禁:pipeline=full/work 且 touches 非空而未带调研上下文时,返回将附 warning 提示。touches 可选:本任务将要改动的文件路径/glob 数组(如 "src/x.mjs"、"src/**")——派发器在同一时刻只派发 touches 不冲突的任务,避免并行 Worker 改同一批文件互踩;任务持有文件锁(in-progress/verifying 持有,状态流转到 resolved/cancelled/archived 即释放——锁只护正在写的阶段,验收后-提交前的窗口期由主窗口提交纪律 + 史诗 post-hook 承接)。' + TASK_SIZE_CONTRACT, parameters: { type: 'object', properties: { id: { type: 'string' }, title: { type: 'string' }, description: { type: 'string' }, priority: { type: 'string', enum: ['low', 'medium', 'high', 'critical'] }, tags: { type: 'array', items: { type: 'string' } }, parentId: { type: 'string' }, instructions: { type: 'string' }, acceptance: { type: 'string' }, dependsOn: { type: 'array', items: { type: 'string' } }, contextFiles: { type: 'array', items: { type: 'string' }, description: '预研文件路径(相对 workspace 或绝对路径;可写「路径:L1-L2 — 一句用途」),派发时以文件清单随首条 prompt 注入(只给路径行号,内容由子代理按需 read 自取)' }, contextNotes: { type: 'string', description: '预研笔记:调研结论/原始需求/思路等(≤8000 字符),全文随首条 prompt 一次性注入' }, pipeline: { type: 'string', enum: ['full', 'work', 'direct'] }, touches: { type: 'array', items: { type: 'string' }, description: '本任务将改动的文件路径/glob(文件级排他锁):与活动任务 touches 冲突时不派发,等锁释放;支持 "src/**" 目录、"./a/b.mjs"、裸文件名等写法' }, draft: { type: 'boolean', description: '创建为草稿(不派发)。Team 模式下缺省即为 true——补全 dependsOn/上下文后用 task_update publish=true 统一发布;非 Team 模式缺省 false(建卡即立即派发:约 1s 内被 Worker 领取烧 token),显式 draft:false 可跳过草稿——不派发的占位/测试卡请显式 draft:true' }, hooks: { type: 'object', additionalProperties: true, description: '史诗 hook 点位(仅主窗口可设):{ pre?: { enabled?, prompt }, post?: { enabled?, prompt } } —— hook 点=一次真实 agent 运行(不是声明式命令):pre 在子任务派发前跑一遍前置准备(未完成前该 epic 的子任务一张都不派),post 在全部子任务了结后跑一遍收口(完成后 epic 才转 verifying)。prompt 是薄框架契约(做什么由 hook agent 判断,吃不准会歧义上报)。传 null 清除,传 { pre: null } 只撤该点位。' } }, required: ['title'] }, output: jo(), execute: async function (args) { var __ra = getActorId(); if (args.hooks !== undefined && resolveRoot(__ra) !== __ra) return { ok: false, error: 'hooks 仅主窗口可设(子代理无 hooks 权限)' }; if (resolveRoot(__ra) !== __ra) return { ok: false, error: '看板管理工具仅主窗口可用(子代理无看板权限)' }; var sid = toolSessionId(); var actor = getActorId(); return mutateLocked(sid, function (d) { if (args.id && d.tasks.find(function (x) { return x.id === args.id })) return { ok: false, error: 'duplicate id: ' + args.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, 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 (args.hooks !== undefined) { var __hn = normalizeHooks(args.hooks); if (__hn.error) return { ok: false, error: __hn.error }; if (__hn.hooks && Object.keys(__hn.hooks).length) t.hooks = __hn.hooks } if (!t.pipeline) t.pipeline = classifyPipeline(t); t.pipelineAuto = !args.pipeline; d.tasks.push(t); t.lintWarnings = draftLint(t, draftLintIo(sid, d.ownerCwd)); /* 调研门禁 warning 族(与 create-task RPC 同口径,core 纯函数):空描述/无调研上下文/整树 glob 三类软提示合并为一条(;分隔),不拦截创建 */ var __out = withSplitHint({ ok: true, task: t }, t, cfg(d).epicSplit); appendDispatchWarning(__out, d, t); /* 派发预警(task-mvbealtf):将自动派发形态的建卡返回体 lintWarnings 追加一行瞬态提示(不落卡) */ var __warns = createTaskWarnings(t); attachContextSuggestions(__out, __warns, t.touches, existsInSession(sid)); if (__warns.length) __out.warning = __warns.join(';'); return __out }) } }))
250
+ ctx.tools.register(defineTool({ name: 'task_update', description: '更新任务字段,可选重置为 pending。dependsOn/pipeline 也可更新(环检测会拒绝成环依赖)。contextFiles 可更新预研文件清单。unfreeze:true 解除裁决挂起冻结(frozen)并触发派发。', parameters: { type: 'object', properties: { taskId: { type: 'string' }, title: { type: 'string' }, description: { type: 'string' }, priority: { type: 'string', enum: ['low', 'medium', 'high', 'critical'] }, assignMode: { type: 'string', enum: ['auto', 'manual'] }, assignee: { type: 'string' }, dependsOn: { type: 'array', items: { type: 'string' } }, contextFiles: { type: 'array', items: { type: 'string' }, description: '预研文件路径(替换式更新),派发时以文件清单(路径:L行号 — 一句用途)随首条 prompt 注入,内容由子代理按需 read 自取' }, contextNotes: { type: 'string', description: '预研笔记(替换式更新):调研结论/原始需求/思路' }, pipeline: { type: 'string', enum: ['full', 'work', 'direct'] }, resetToPending: { type: 'boolean' }, unfreeze: { type: 'boolean', description: '解除冻结(frozen)并立即触发派发,用于 hold 裁决补完上下文后重新入池' }, publish: { type: 'boolean', description: '发布草稿为 pending(仅 draft 状态有效)' }, size: { type: 'string', enum: ['light', 'standard', 'heavy', ''], description: '力度档位(查板级 laneModels 路由表):light/standard/heavy;空串=清除(回标档语义),非法值拒写' }, model: { type: 'string', description: '卡级模型特例(取模链最高优先,provider/model 复合格式):空串=清除;非空走合法清单校验,非法拒写' }, hooks: { type: 'object', additionalProperties: true, description: '史诗 hook 点位(仅主窗口可设):{ pre?: { enabled?, prompt }, post?: { enabled?, prompt } } —— hook 点=一次真实 agent 运行(不是声明式命令):pre 在子任务派发前跑一遍前置准备(未完成前该 epic 的子任务一张都不派),post 在全部子任务了结后跑一遍收口(完成后 epic 才转 verifying)。prompt 是薄框架契约(做什么由 hook agent 判断,吃不准会歧义上报)。传 null 清除,传 { pre: null } 只撤该点位。' } }, required: ['taskId'] }, output: jo(), execute: async function (args) { var __ra = getActorId(); if (args.hooks !== undefined && resolveRoot(__ra) !== __ra) return { ok: false, error: 'hooks 仅主窗口可设(子代理无 hooks 权限)' }; if (resolveRoot(__ra) !== __ra) return { ok: false, error: '看板管理工具仅主窗口可用(子代理无看板权限)' }; var sid = toolSessionId(); var actor = getActorId(); var existsFn = existsInSession(sid); /* 力度路由卡级字段(task-mvnemvf5):size 枚举校验 + model 合法清单校验(空串=清除);model 校验要异步拉网关清单,必须在锁外完成 */ if (args.size !== undefined) { var __szV = typeof args.size === 'string' ? args.size.trim() : ''; if (__szV !== '' && TASK_SIZES.indexOf(__szV) < 0) return { ok: false, error: '非法 size: ' + String(args.size) + '(合法值: light/standard/heavy,空串=清除)' } } if (args.model !== undefined) { var __cmv = typeof args.model === 'string' ? args.model.trim() : ''; if (__cmv) { var __cme = await cardModelErr(__cmv); if (__cme) return { ok: false, error: __cme } } } 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; var __depWarn = null; /* dependsOn 后补软提示(task-mv9yupm4②):在飞卡写依赖时挂返回体 warning 字段 */ 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.assignMode !== undefined) t.assignMode = args.assignMode; if (args.assignee !== undefined) t.assignee = args.assignee || null; /* 力度路由卡级字段落卡(task-mvnemvf5):合法性已在锁外验过;空串=删字段清除(缺字段=标档/无特例语义,存量卡零迁移) */ if (args.size !== undefined) { var __sv = typeof args.size === 'string' ? args.size.trim() : ''; if (__sv) t.size = __sv; else delete t.size } if (args.model !== undefined) { var __mv2 = typeof args.model === 'string' ? args.model.trim() : ''; if (__mv2) t.model = __mv2; else delete t.model } if (args.dependsOn !== undefined) { var derr = validateDeps(d, t.id, args.dependsOn); if (derr) return { ok: false, error: derr }; t.dependsOn = args.dependsOn; /* task-mv9yupm4②:在飞卡(in-progress 含 spawn-pending 占位 / verifying)写依赖只软提示——本次 run 的 prompt 已注入、不受新依赖影响(在途 spawn 由落闸锁内重验 depsSatisfied 兜底否决);不拒写不写历史 */ if (t.status === 'in-progress' || t.status === 'verifying') __depWarn = '卡已在执行中,依赖变更不影响本次 run' } 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' }; /* Team 硬闸(task-mvomad2c):缺档草稿拒发布(同调用先赋 size 者已在上方生效,可一把过) */ if (d.teamMode && TASK_SIZES.indexOf(t.size) < 0) return { ok: false, error: core.TEAM_SIZE_REQUIRED_ERR }; 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; delete t.waitingLock; 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 (__depWarn) __out.warning = __depWarn; if (__pre && __pre.missing.length) __out.epicPrecheck = __pre; return __out }); afterPublishPrecheck(sid, args.taskId, __res); return __res } }))
251
+ ctx.tools.register(defineTool({ name: 'task_create', description: '创建新任务到当前会话看板。acceptance 可选:硬性验收脚本命令(如 "node --test src/x.test.js"),Worker 必须实际运行、Verifier 必须独立复跑。dependsOn 可选:依赖任务 id 数组,依赖全部完成后才会被派发。pipeline 可选:full(默认,工作+验证)/work(只做不验)/direct(不进池,主窗口直接处理)。contextFiles 可选:你在调研中已经读过的关键文件路径数组——派发时以「文件清单」(每行「路径:L起-L止 — 一句用途」)随首条 prompt 一次性注入,只给路径与行号、不含内容本体(子代理用 read 工具按行号范围按需自取:执行时盘面更新鲜,也免了大文件正文撑爆 prompt 与随快照每轮重发),避免子代理从零重复调研。contextNotes 可选:调研结论/原始需求/思路等非文件类上下文,全文随首条 prompt 一次性注入(≤8000 字符)。【开发类任务(涉及代码改动/修复/特性)务必带文件调研】:把调研中读过的关键文件路径放进 contextFiles、结论思路放进 contextNotes——实测可让 Worker 省去 10~15 分钟从零 grep 定位的时间,且方向感天壤之别(无调研的 Worker 只能靠标题猜需求、极易跑偏)。调研门禁:pipeline=full/work 且 touches 非空而未带调研上下文时,返回将附 warning 提示。touches 可选:本任务将要改动的文件路径/glob 数组(如 "src/x.mjs"、"src/**")——派发器在同一时刻只派发 touches 不冲突的任务,避免并行 Worker 改同一批文件互踩;任务持有文件锁(in-progress/verifying 持有,状态流转到 resolved/cancelled/archived 即释放——锁只护正在写的阶段,验收后-提交前的窗口期由主窗口提交纪律 + 史诗 post-hook 承接)。' + TASK_SIZE_CONTRACT, parameters: { type: 'object', properties: { id: { type: 'string' }, title: { type: 'string' }, description: { type: 'string' }, priority: { type: 'string', enum: ['low', 'medium', 'high', 'critical'] }, tags: { type: 'array', items: { type: 'string' } }, parentId: { type: 'string' }, instructions: { type: 'string' }, acceptance: { type: 'string' }, dependsOn: { type: 'array', items: { type: 'string' } }, contextFiles: { type: 'array', items: { type: 'string' }, description: '预研文件路径(相对 workspace 或绝对路径;可写「路径:L1-L2 — 一句用途」),派发时以文件清单随首条 prompt 注入(只给路径行号,内容由子代理按需 read 自取)' }, contextNotes: { type: 'string', description: '预研笔记:调研结论/原始需求/思路等(≤8000 字符),全文随首条 prompt 一次性注入' }, pipeline: { type: 'string', enum: ['full', 'work', 'direct'] }, size: { type: 'string', enum: ['light', 'standard', 'heavy'], description: '力度档位(查板级 laneModels 路由表):light/standard/heavy;Team 模式板为必填硬闸(缺 size 拒建拒发布),非 Team 板可省(缺省=标档语义,不落字段)' }, touches: { type: 'array', items: { type: 'string' }, description: '本任务将改动的文件路径/glob(文件级排他锁):与活动任务 touches 冲突时不派发,等锁释放;支持 "src/**" 目录、"./a/b.mjs"、裸文件名等写法' }, draft: { type: 'boolean', description: '创建为草稿(不派发)。Team 模式下缺省即为 true——补全 dependsOn/上下文后用 task_update publish=true 统一发布;非 Team 模式缺省 false(建卡即立即派发:约 1s 内被 Worker 领取烧 token),显式 draft:false 可跳过草稿——不派发的占位/测试卡请显式 draft:true' }, hooks: { type: 'object', additionalProperties: true, description: '史诗 hook 点位(仅主窗口可设):{ pre?: { enabled?, prompt }, post?: { enabled?, prompt } } —— hook 点=一次真实 agent 运行(不是声明式命令):pre 在子任务派发前跑一遍前置准备(未完成前该 epic 的子任务一张都不派),post 在全部子任务了结后跑一遍收口(完成后 epic 才转 verifying)。prompt 是薄框架契约(做什么由 hook agent 判断,吃不准会歧义上报)。传 null 清除,传 { pre: null } 只撤该点位。' } }, required: ['title'] }, output: jo(), execute: async function (args) { var __ra = getActorId(); if (args.hooks !== undefined && resolveRoot(__ra) !== __ra) return { ok: false, error: 'hooks 仅主窗口可设(子代理无 hooks 权限)' }; if (resolveRoot(__ra) !== __ra) return { ok: false, error: '看板管理工具仅主窗口可用(子代理无看板权限)' }; var sid = toolSessionId(); var actor = getActorId(); return mutateLocked(sid, function (d) { if (args.id && d.tasks.find(function (x) { return x.id === args.id })) return { ok: false, error: 'duplicate id: ' + args.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; /* size 普适化(task-mvomad2c):白名单校验(双模式)+ Team 硬闸(缺档拒建,非 Team 零约束零提示) */ var __sz = typeof args.size === 'string' ? args.size.trim() : ''; if (__sz && TASK_SIZES.indexOf(__sz) < 0) return { ok: false, error: '非法 size: ' + String(args.size) + '(合法值: light/standard/heavy)' }; if (d.teamMode && !__sz) return { ok: false, error: core.TEAM_SIZE_REQUIRED_ERR }; var t = { id: args.id || ('task-' + Date.now().toString(36)), title: args.title, 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 (__sz) t.size = __sz; if (args.hooks !== undefined) { var __hn = normalizeHooks(args.hooks); if (__hn.error) return { ok: false, error: __hn.error }; if (__hn.hooks && Object.keys(__hn.hooks).length) t.hooks = __hn.hooks } if (!t.pipeline) t.pipeline = classifyPipeline(t); t.pipelineAuto = !args.pipeline; d.tasks.push(t); t.lintWarnings = draftLint(t, draftLintIo(sid, d.ownerCwd)); /* 调研门禁 warning 族(与 create-task RPC 同口径,core 纯函数):空描述/无调研上下文/整树 glob 三类软提示合并为一条(;分隔),不拦截创建 */ var __out = withSplitHint({ ok: true, task: t }, t, cfg(d).epicSplit); appendDispatchWarning(__out, d, t); /* 派发预警(task-mvbealtf):将自动派发形态的建卡返回体 lintWarnings 追加一行瞬态提示(不落卡) */ var __warns = createTaskWarnings(t); attachContextSuggestions(__out, __warns, t.touches, existsInSession(sid)); if (__warns.length) __out.warning = __warns.join(';'); return __out }) } }))
252
+ // ===== 拆解官(task-mvnenrwk):task_decompose 工具(仅主窗口门禁同 task_create)=====
253
+ // 设计(需求定稿):拆解官=一次性 run,outputSchema 强箍结构化提案;拆解官**零建卡工具**——
254
+ // 提案由 host 读 result.structured 后物化成 draft 子卡(权限口子=根本不需要开)。
255
+ // 门禁:源卡须 draft/pending(执行中/已落定卡不拆);同卡已有活跃 decomposer run → 拒(幂等防重)。
256
+ // 物化侧幂等(dispatch.settleDecompose → applyDecomposeProposal):新提案落地时清掉上次未发布的提案子卡。
257
+ ctx.tools.register(defineTool({ name: 'task_decompose', description: '拆解官:对 draft/pending 源卡 spawn 一次性拆解 run(outputSchema 强箍结构化提案,role=decomposer 计入 verifier 并发位、不占 worker 位)。落定后 host 自动把提案物化为 draft 子卡(size/model/touches/acceptance/dependsOn 落位,上限 8 张)并通知主窗口;源卡状态不变,确认后逐张 task_update publish=true 发布。幂等:重拆自动清掉上次未发布的提案子卡。', parameters: { type: 'object', properties: { taskId: { type: 'string', description: '待拆解的源卡 id(须为 draft/pending)' } }, required: ['taskId'] }, output: jo(), execute: async function (args) {
258
+ var __ra = getActorId(); if (resolveRoot(__ra) !== __ra) return { ok: false, error: '看板管理工具仅主窗口可用(子代理无看板权限)' }
259
+ var sid = toolSessionId()
260
+ var d = await rt(sid)
261
+ var t = d.tasks.find(function (x) { return x.id === args.taskId })
262
+ if (!t) return { ok: false, error: 'not found: ' + args.taskId }
263
+ if (t.status !== 'draft' && t.status !== 'pending') return { ok: false, error: '源卡须为 draft/pending(当前 ' + t.status + ')——执行中/已落定卡不支持拆解' }
264
+ var act = runsFor(sid)[t.id]
265
+ if (act && !act.settled && act.role === 'decomposer') return { ok: false, error: '拆解官已在运行中(run ' + act.id + '),等它落定再重拆', runId: String(act.id) }
266
+ if (typeof spawnOneShot !== 'function') return { ok: false, error: 'spawn 通道未接线(老宿主/测试桩)' }
267
+ var rec = await spawnOneShot(sid, t, 'decomposer')
268
+ if (!rec) return { ok: false, error: 'spawn 失败(无 root/provider 或落闸被否),详见 host 日志' }
269
+ return { ok: true, runId: String(rec.id), taskId: t.id, note: '拆解官运行中;落定后提案自动物化为 draft 子卡并通知主窗口(源卡状态不变,确认后逐张 publish)' }
270
+ } }))
252
271
 
253
272
  // ===== RPC =====
254
273
  // get-tasks 是纯读路径(rt 只读文件)——poolCycle 由 15s 心跳 + 写入后 kickCycle 驱动,
@@ -283,7 +302,12 @@ export function createRpc(ctx, state, deps) {
283
302
  }
284
303
  handle('get-tasks', async function (args) { var sid = rpcSessionId(args); var d = await rt(sid); d.sessionId = sid; d.isRoot = await isRootPersistent(sid)
285
304
  // poolStatus 防幽灵:只保留指向当前活跃任务的条目(重启后内存 runs 清空,文件快照可能残留)
286
- if (d.poolStatus) { var __act = {}; (d.tasks || []).forEach(function (t) { if (t.status === 'in-progress' || t.status === 'verifying') __act[t.id] = true }); d.poolStatus.workers = (d.poolStatus.workers || []).filter(function (w) { return __act[w.taskId] }); d.poolStatus.verifiers = (d.poolStatus.verifiers || []).filter(function (v) { return __act[v.taskId] }) }
305
+ // decomposer 豁免(task-mvomad6c 拆解官可见性①,主窗口裁决放行):其源卡全程停 draft/pending
306
+ //(recIsLive 口径,dispatch.mjs),永不在 __act 活跃集——按通用口径过滤会把在跑拆解官的
307
+ // poolStatus 条目当幽灵摘光(池条「🧩 拆解中」永不亮的数据面根因)。新鲜度由 poolCycle 每轮
308
+ // 从活跃 run 重建快照兜底(重启残留 ≤1 个心跳周期自清);老快照条目无 role 字段不命中豁免,
309
+ // 行为与现状逐字一致。纯读路径放行,不动调度/并发位/结算任何语义。
310
+ if (d.poolStatus) { var __act = {}; (d.tasks || []).forEach(function (t) { if (t.status === 'in-progress' || t.status === 'verifying') __act[t.id] = true }); d.poolStatus.workers = (d.poolStatus.workers || []).filter(function (w) { return __act[w.taskId] }); d.poolStatus.verifiers = (d.poolStatus.verifiers || []).filter(function (v) { return __act[v.taskId] || v.role === 'decomposer' }) }
287
311
  // 学习飞轮 v1:把 feedbackEnabled 显式放进返回体(normalizeBoard 已按老看板补默认 true),
288
312
  // 客户端据此做能力检测——开关关闭时渲染层不生成候选、不显示「沉淀」按钮。
289
313
  d.feedbackEnabled = cfg(d).feedbackEnabled
@@ -302,9 +326,27 @@ export function createRpc(ctx, state, deps) {
302
326
  // 板级配置审计行(task-mv9yuq2l)透出:轻量卡外字段,set-board-config 成功写入时落
303
327
  // {key, from, to, actor, at}(截尾 50 条);老看板缺字段透出空数组(读路径归一,不落盘)。
304
328
  d.configLog = Array.isArray(d.configLog) ? d.configLog.slice(-50) : []
329
+ // 人工/外部操作留痕(task-mvnf3gly)透出:HTTP 写集成功时落 {at, op, taskId, summary, actor}
330
+ // (截尾 50 落盘,这里透尾部 20 条);老看板缺字段透出空数组(读路径归一,不落盘)。
331
+ // 与 configLog 同纪律:不进 tasksHash 序列化口径(hash 一致轮询轮会跳过本字段更新,可接受——
332
+ // 消费面是 task_list/Team 注入段现算,GUI v1 不渲染本字段)。
333
+ d.opsLog = Array.isArray(d.opsLog) ? d.opsLog.slice(-20) : []
305
334
  // 清理保留天数(设置区「存储清理」小节):cfg 归一(缺字段/脏值=7,钳 1-90)后透出确定数值,
306
335
  // 客户端设置区天数输入与 StorageCleanup 文案都读这一个字段(口径单一,不各自猜缺省)。
307
336
  d.cleanupRetentionDays = cfg(d).cleanupRetentionDays
337
+ // 力度路由表(task-mvnemvf5):cfg 归一后透出确定形态(三档×双角色,槽位=有序数组——
338
+ // task-mvnxckhq 同档优先序,第一位=首选;空数组槽位=继承下一级),
339
+ // 老看板缺字段也透出全空缺省——客户端不需要各自猜兜底(与上方开关系列同纪律)。
340
+ d.laneModels = cfg(d).laneModels
341
+ // 备用模型链(task-mvnqxlpn):cfg 归一后透出(空数组=未启用),与 laneModels 同纪律——
342
+ // 读路径归一不落盘,老看板缺字段透空数组;GUI v1 不消费本字段(配置先走 set-board-config 对话/RPC)。
343
+ d.fallbackModels = cfg(d).fallbackModels
344
+ // 模型健康统一视图:主动探测开关/间隔 + 本板已配置模型的冷却/熔断/最近 run/延迟聚合。
345
+ // 内部按 sid 分桶(熔断键本就含 sid),公开仅含本板配置模型;unchanged 轻量响应也照常透出。
346
+ d.probeEnabled = cfg(d).probeEnabled
347
+ d.probeIntervalMin = cfg(d).probeIntervalMin
348
+ var __mh = state.modelHealth || {}
349
+ d.modelHealth = core.modelHealthView(d, __mh[sid], { sid: sid, badModels: state.badModels, modelCooldown: state.modelCooldown, now: Date.now() })
308
350
  // 工作模式派生字段:UI 只读这一个字段决定三档选中态(不落盘,写入仍走 boardMode/teamMode)
309
351
  d.workMode = deriveWorkMode(d)
310
352
  // ===== board 级 token 消耗聚合(现算,不落盘):总量 + 输入/输出/缓存读 + 按模型 + 任务 Top8 =====
@@ -532,7 +574,7 @@ export function createRpc(ctx, state, deps) {
532
574
  })
533
575
  }
534
576
  handle('cancel-task', async function (args) { return doCancel(rpcSessionId(args), rpcActor(args), args.taskId, args.reason) })
535
- 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; var __depWarn = null; /* dependsOn 后补软提示(task-mv9yupm4②):在飞卡写依赖时挂返回体 warning 字段 */ 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; /* task-mv9yupm4②:在飞卡(in-progress 含 spawn-pending 占位 / verifying)写依赖只软提示——本次 run 的 prompt 已注入、不受新依赖影响(在途 spawn 由落闸锁内重验 depsSatisfied 兜底否决);不拒写不写历史 */ if (t.status === 'in-progress' || t.status === 'verifying') __depWarn = '卡已在执行中,依赖变更不影响本次 run' } 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 (__depWarn) __out.warning = __depWarn; if (__pre && __pre.missing.length) __out.epicPrecheck = __pre; return __out }); afterPublishPrecheck(sid, args.taskId, __res); return __res })
577
+ 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); /* 力度路由卡级字段(task-mvnemvf5):size 枚举校验 + model 合法清单校验(空串=清除);model 校验要异步拉网关清单,必须在锁外完成 */ if (args.size !== undefined) { var __szV = typeof args.size === 'string' ? args.size.trim() : ''; if (__szV !== '' && TASK_SIZES.indexOf(__szV) < 0) return { ok: false, error: '非法 size: ' + String(args.size) + '(合法值: light/standard/heavy,空串=清除)' } } if (args.model !== undefined) { var __cmv = typeof args.model === 'string' ? args.model.trim() : ''; if (__cmv) { var __cme = await cardModelErr(__cmv); if (__cme) return { ok: false, error: __cme } } } 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; var __depWarn = null; /* dependsOn 后补软提示(task-mv9yupm4②):在飞卡写依赖时挂返回体 warning 字段 */ 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; /* 力度路由卡级字段落卡(task-mvnemvf5):合法性已在锁外验过;空串=删字段清除(缺字段=标档/无特例语义,存量卡零迁移) */ if (args.size !== undefined) { var __sv = typeof args.size === 'string' ? args.size.trim() : ''; if (__sv) t.size = __sv; else delete t.size } if (args.model !== undefined) { var __mv2 = typeof args.model === 'string' ? args.model.trim() : ''; if (__mv2) t.model = __mv2; else delete t.model } if (args.dependsOn !== undefined) { var derr = validateDeps(d, t.id, args.dependsOn); if (derr) return { ok: false, error: derr }; t.dependsOn = args.dependsOn; /* task-mv9yupm4②:在飞卡(in-progress 含 spawn-pending 占位 / verifying)写依赖只软提示——本次 run 的 prompt 已注入、不受新依赖影响(在途 spawn 由落闸锁内重验 depsSatisfied 兜底否决);不拒写不写历史 */ if (t.status === 'in-progress' || t.status === 'verifying') __depWarn = '卡已在执行中,依赖变更不影响本次 run' } 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' }; /* Team 硬闸(task-mvomad2c):缺档草稿拒发布(同调用先赋 size 者已在上方生效,可一把过) */ if (d.teamMode && TASK_SIZES.indexOf(t.size) < 0) return { ok: false, error: core.TEAM_SIZE_REQUIRED_ERR }; 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; delete t.waitingLock; 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 (__depWarn) __out.warning = __depWarn; if (__pre && __pre.missing.length) __out.epicPrecheck = __pre; return __out }); afterPublishPrecheck(sid, args.taskId, __res); return __res })
536
578
  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) } }) })
537
579
  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) } }) })
538
580
  // 工作模式三档单入口(v75 UI 收敛):一次写入 boardMode+teamMode 两个字段,
@@ -557,8 +599,29 @@ export function createRpc(ctx, state, deps) {
557
599
  // action='hold' = 任务置 frozen 冻结,不参与任何自动派发(pickDispatch 跳过),
558
600
  // 留给主窗口补 dependsOn/补上下文的时间窗口,补完再显式解冻(unfreeze-task)。
559
601
  // hold 时 mutateLocked 传 skipKick:冻结任务本就不该派发,省掉一次无意义的 poolCycle。
560
- async function doResolveEscalation(sid, actor, taskId, answer, action) {
602
+ // ===== 仲裁扩权入锁(task-mvonytz3①③⑤,实证缝隙:运行中扩权的文件不进锁注册表)=====
603
+ // expandTouches:[...]:host 校验路径形态(normTouch 归一 + 非空字符串过滤 + 去重)后并入
604
+ // 卡上 extraTouches 运行时字段落盘(touches 审计原值不动)+ history/messages 双留痕——
605
+ // 扩权即刻参与锁语义(core 读侧三处按有效锁集取)。仅主窗口可写(角色门禁同 hooks:
606
+ // 子代理给自己的锁边界扩权 = 既当运动员又当裁判,直接拒)。
607
+ // 冲突预检(不阻断):扩出的文件正被他卡有效锁持有 → 返回体 conflictWarning 点名持锁卡,
608
+ // 由主窗口决策并行/错时。hold + 撞锁 → 落 waitingLock:{files,heldBy,at} 结构化字段
609
+ //(与 frozen 共存)——等锁自动复工链:poolCycle 每轮扫到锁全释放即自动解冻回派发池。
610
+ async function doResolveEscalation(sid, actor, taskId, answer, action, expandTouches) {
561
611
  var act = action === 'hold' ? 'hold' : 'resume'
612
+ var expandIn = null
613
+ if (expandTouches !== undefined && expandTouches !== null) {
614
+ if (hooksDenied(actor)) return { ok: false, error: 'expandTouches 仅主窗口可登记(子代理无扩权权限)' }
615
+ if (!Array.isArray(expandTouches)) return { ok: false, error: 'expandTouches 需为路径字符串数组(如 ["src/x.mjs"])' }
616
+ expandIn = []
617
+ for (var ei = 0; ei < expandTouches.length; ei++) {
618
+ var eraw = expandTouches[ei]
619
+ if (typeof eraw !== 'string') continue
620
+ var ev = core.normTouch(eraw)
621
+ if (ev && expandIn.indexOf(ev) < 0) expandIn.push(ev)
622
+ }
623
+ if (expandTouches.length && !expandIn.length) return { ok: false, error: 'expandTouches 无有效路径(条目需为非空字符串路径)' }
624
+ }
562
625
  var result = await mutateLocked(sid, function (d) {
563
626
  var t = d.tasks.find(function (x) { return x.id === taskId })
564
627
  if (!t) return { ok: false, error: 'not found' }
@@ -572,11 +635,37 @@ export function createRpc(ctx, state, deps) {
572
635
  // → 生成候选教训(场景/疑问/裁决结论),由主窗口决定要不要沉淀进笔记/记忆工具。
573
636
  pushArbitrationLesson(d, t, escQ, answer || '', arbAt)
574
637
  ah(t, t.status, t.status, actor, (act === 'hold' ? '主窗口裁决(挂起冻结): ' : '主窗口裁决: ') + (answer || '').slice(0, 200))
638
+ // ===== 仲裁扩权落账(task-mvonytz3①):并入 extraTouches + 双留痕 =====
639
+ var expandAdded = []
640
+ if (expandIn && expandIn.length) {
641
+ if (!Array.isArray(t.extraTouches)) t.extraTouches = []
642
+ for (var ai = 0; ai < expandIn.length && t.extraTouches.length < 20; ai++) { // 上限 20 条,与 touches 声明上限一致
643
+ if (t.extraTouches.indexOf(expandIn[ai]) < 0) { t.extraTouches.push(expandIn[ai]); expandAdded.push(expandIn[ai]) }
644
+ }
645
+ if (expandAdded.length) {
646
+ ah(t, t.status, t.status, actor, '主窗口裁决扩权登记:extraTouches 并入 ' + expandAdded.length + ' 项(' + expandAdded.join('、') + '),即刻参与文件锁语义')
647
+ // 卡消息留一条:重派/续跑的 Worker prompt 经 buildMessages 带上——下任 Worker 能看到真实边界已扩
648
+ t.messages.push({ kind: 'touches-expand', text: '🔓 仲裁扩权:本卡文件边界新增 ' + expandAdded.join('、') + '(已并入 extraTouches,参与文件锁语义与计划闸口边界比对)', at: arbAt, by: actor })
649
+ }
650
+ }
651
+ // ===== 冲突预检(task-mvonytz3③,不阻断)+ 撞锁等锁登记(⑤)=====
652
+ var lockHits = expandAdded.length ? core.planLockConflicts(d, t.id, expandAdded) : []
653
+ var conflictWarning = ''
654
+ if (lockHits.length) conflictWarning = '⚠️ 扩权冲突预检:' + lockHitText(lockHits) + '——已照常登记(不阻断);请评估与持锁卡错时并行,或 action=hold 进等锁自动复工链'
655
+ if (act === 'hold' && lockHits.length) {
656
+ var heldBy = []
657
+ lockHits.forEach(function (h) { h.holders.forEach(function (x) { if (heldBy.indexOf(x.id) < 0) heldBy.push(x.id) }) })
658
+ t.waitingLock = { files: lockHits.map(function (h) { return h.file }), heldBy: heldBy, at: arbAt }
659
+ ah(t, t.status, t.status, actor, '撞锁等锁:waitingLock 落卡(' + t.waitingLock.files.join('、') + ' ← ' + heldBy.join('、') + '),持锁卡释放后自动解冻复工')
660
+ }
575
661
  // in-progress 的歧义任务:回 pending 重派(新 Worker 带裁决上下文);verifying 的 verifier 故障升级:保持待审,下轮派新 verifier
576
662
  if (t.status === 'in-progress') { var ps = t.status; t.status = 'pending'; t.claimedBy = null; t.claimedAt = null; ah(t, ps, 'pending', 'system', act === 'hold' ? '带裁决挂起冻结(不参与自动派发)' : '带裁决重新排队') }
577
663
  if (act === 'hold') { t.frozen = true; t.frozenAt = new Date().toISOString(); t.frozenBy = actor; ah(t, t.status, t.status, actor, '冻结:不参与自动派发,待主窗口补完上下文后解冻') }
578
- else { delete t.frozen; delete t.frozenAt; delete t.frozenBy }
579
- return { ok: true, task: t, answer: answer || '', action: act, frozen: !!t.frozen }
664
+ else { delete t.frozen; delete t.frozenAt; delete t.frozenBy; delete t.waitingLock } // resume 一律清等锁标记(不等锁即复工)
665
+ var out = { ok: true, task: t, answer: answer || '', action: act, frozen: !!t.frozen }
666
+ if (expandIn) out.extraTouches = Array.isArray(t.extraTouches) ? t.extraTouches.slice() : []
667
+ if (conflictWarning) out.conflictWarning = conflictWarning
668
+ return out
580
669
  }, act === 'hold')
581
670
  return result
582
671
  }
@@ -587,6 +676,7 @@ export function createRpc(ctx, state, deps) {
587
676
  if (!t) return { ok: false, error: 'not found' }
588
677
  if (!t.frozen) return { ok: false, error: 'not frozen' }
589
678
  delete t.frozen; delete t.frozenAt; delete t.frozenBy
679
+ delete t.waitingLock // 手动解冻优先于等锁链(task-mvonytz3⑤):人已放行,不再等锁
590
680
  ah(t, t.status, t.status, actor, '解除冻结,重新进入派发池')
591
681
  return { ok: true, task: t, unfrozen: true }
592
682
  })
@@ -737,14 +827,40 @@ export function createRpc(ctx, state, deps) {
737
827
  var killFail = '', killWhy = ''
738
828
  if (rec) {
739
829
  delete runsFor(sid)[taskId]; label = rec.role + ':' + taskId
830
+ // 终止认领即立首胜旗(task-mvnyk55n 驳回根修):hold 终止的 dispose 会按宿主契约落定
831
+ // activation.result,dispatch 的拆除结算兜底臂接到落定就结算——不先立旗,兜底臂会抢在
832
+ // 下方 hold 落账(mutateLocked)之前把本次手动终止误记成一次 Worker 失败
833
+ // (retryCount+1 / lastError=子会话被宿主拆除 / history 落「worker 失败…重新排队」,
834
+ // retryCount=2 的卡直接被打成 blocked,与「hold=停派」语义正面冲突)。
835
+ // 终止的账由本函数自己结(accumulateRunUsage + closeRunHistory + mutateLocked),立旗后
836
+ // 兜底臂/超时臂/idle 事件通道对这条 rec 的迟到落定一律空转——与落闸弃权臂(dispatch 646)
837
+ // 同一纪律,且补上「离开活跃表的 rec 必然已立 settled 旗」不变式的最后一个缺口。
838
+ rec.settled = true
740
839
  // 清理:一次性 run 走 dispose(既有语义逐字不变);continuable 的 rec 没有 run(持久子会话),
741
840
  // 卡2 起改走 **interrupt 留存**(task-muw5h2ps):只打断当前 turn、不销毁子会话——否则「手动终止」
742
841
  // 之后旧 Worker 仍在改同一棵树,与新派发的 Worker 并行写盘(终止按钮反而制造双写)。
842
+ // 终止分态细化(task-mvnyk55n):hold:true(不再重派)且新契约 activation 在手(rec.act)→
843
+ // 先 interrupt 再 dispose **销毁**子会话——终止=不再续,interrupt 留存只会淤积成停泊残影
844
+ // (ontology EW-B 实证:被终止者 8 小时后被误唤醒与现任并行);默认终止(会重派)保持
845
+ // interrupt 留存(续跑位要留)。dispose 失败一律降级 interrupt 留存,记 console.error 不阻断。
743
846
  // interrupt 失败(会话已死 / 无 root 可授权):任务照常回 pending 重排,不卡死——但不再静默(根修②)。
744
847
  try { if (rec.run) await rec.run.dispose() } catch (_) {}
745
848
  if (rec.continuable) {
746
849
  var subs = ctx.subagents, rroot = rootForSession(sid)
747
- if (subs && typeof subs.interrupt === 'function' && rroot) {
850
+ if (hold && rec.act && typeof rec.act.dispose === 'function') {
851
+ // hold 终止 + activation 在手:先 interrupt 打断当前 turn(与落闸弃权臂同序,停损信号先行),
852
+ // 再 dispose 销毁。dispose 不依赖 rroot(activation 自带句柄);双双失败才记 killFail。
853
+ var stopped = false
854
+ if (subs && typeof subs.interrupt === 'function' && rroot) {
855
+ try { subs.interrupt(rec.childId, { kind: 'ancestor', agent: rroot }); stopped = true } catch (_) {}
856
+ }
857
+ try { await rec.act.dispose() }
858
+ catch (e) {
859
+ console.error('[task-board] terminate(hold) dispose 失败,降级 interrupt 留存 (task ' + taskId + ' child ' + rec.childId + '):', String(e))
860
+ if (!stopped) { killFail = String(rec.childId || ''); killWhy = 'dispose 抛错且无 interrupt 兜底: ' + String(e) }
861
+ }
862
+ }
863
+ else if (subs && typeof subs.interrupt === 'function' && rroot) {
748
864
  try { subs.interrupt(rec.childId, { kind: 'ancestor', agent: rroot }) }
749
865
  catch (e) { killFail = String(rec.childId || ''); killWhy = 'interrupt 抛错: ' + String(e); console.error('[task-board] terminate interrupt 失败 (task ' + taskId + ' child ' + rec.childId + '):', String(e)) }
750
866
  } else { killFail = String(rec.childId || ''); killWhy = '宿主无 interrupt 能力或无活 root 可授权' }
@@ -870,36 +986,150 @@ export function createRpc(ctx, state, deps) {
870
986
  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) }
871
987
  return { ok: false, error: 'spawn failed' }
872
988
  })
873
- handle('resolve-escalation', async function (args) { return doResolveEscalation(rpcSessionId(args), rpcActor(args), args.taskId, args.answer, args.action) })
989
+ handle('resolve-escalation', async function (args) { return doResolveEscalation(rpcSessionId(args), rpcActor(args), args.taskId, args.answer, args.action, args.expandTouches) })
874
990
  handle('intervene-agent', async function (args) { return doIntervene(rpcSessionId(args), rpcActor(args), args.taskId, args.message) })
875
991
  // 主 Agent 工具版(Team 模式下主 Agent 通过工具裁决/介入)
876
- 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) } }))
992
+ // 主窗口纪律(task-mvonytz3⑦):仲裁含文件扩权必须用 expandTouches 逐条登记——扩出的文件进
993
+ // extraTouches 锁注册表(并行卡冲突可检、闸口可点名);只在 answer 文字里放行 = 锁注册表查无此项,
994
+ // 并行卡互踩零警示(用户 2026-10-26 三起实证)。撞锁时 action=hold 即进等锁自动复工链。
995
+ ctx.tools.register(defineTool({ name: 'task_arbitrate', description: 'Team 模式:裁决 Worker 上报的歧义(escalation)。action=resume(默认)裁决后任务回派发池立即重派;action=hold 任务挂起冻结、不参与自动派发(留给主窗口补 dependsOn/上下文,补完后用 task_update unfreeze:true 解冻)。裁决若涉及允许 Worker 改动 touches 声明之外的文件,必须用 expandTouches:[...] 逐条登记扩权文件(host 校验后并入卡上 extraTouches:即刻参与文件锁语义+返回 conflictWarning 冲突预检点名持锁卡),禁止只在 answer 文字里放行(纯文字不进锁注册表,并行卡互踩零警示);撞锁时选 hold 即自动进入等锁复工链(waitingLock 落卡,持锁卡释放后自动解冻重派)。', parameters: { type: 'object', properties: { taskId: { type: 'string' }, answer: { type: 'string' }, action: { type: 'string', enum: ['resume', 'hold'], description: 'resume(默认)=裁决后重新派发;hold=挂起冻结不派发' }, expandTouches: { type: 'array', items: { type: 'string' }, description: '仲裁扩权文件清单(可选):host 校验路径形态后并入卡上 extraTouches(独立于 touches 审计原值),即刻参与锁语义;与他卡有效锁冲突时返回体带 conflictWarning 点名持锁卡(不阻断);action=hold 且撞锁时落 waitingLock 进等锁自动复工链' } }, 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, args.expandTouches) } }))
877
996
  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) } }))
878
997
  // ===== 池中 Agent 结构化回报工具(双模:工具优先,文本分段为降级路径)=====
879
- 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) {
998
+ // 开工计划闸口比对(task-mvneoyba):board_report progress 分支命中『计划改动:』前缀时调用。
999
+ // 只警示不阻断(阻断会把 Worker 卡死在工具调用里);三通道=①卡 messages 警示行 ②主窗口通知
1000
+ //(planGateNotify 字段带出锁外 pushSysNote,投递随回执聚合窗)③工具返回体 warning(Worker 自己最直接看到)。
1001
+ // messages 幂等防刷屏:同内容闸口行不重复记(重复上报同一计划不产生第二条);通知也跟着去重——
1002
+ // 闸口行被幂等吞掉时不再重复惊动主窗口。
1003
+ function planGateMsg(t, text, at, by) {
1004
+ for (var i = 0; i < t.messages.length; i++) { var m = t.messages[i]; if (m && m.kind === 'plan-gate' && m.text === text) return false }
1005
+ t.messages.push({ kind: 'plan-gate', text: text, at: at, by: by })
1006
+ return true
1007
+ }
1008
+ // 撞锁点名文案(task-mvonytz3④):计划闸口双查 / 仲裁扩权冲突预检共用同一措辞(单一事实源)。
1009
+ // 单持锁卡在跑形态:「⚔️ lib/x.mjs 正被 task-a 持锁(该卡 Worker 在跑)」;verifying 持锁卡标「该卡验收中」。
1010
+ function lockHitText(hits) {
1011
+ return (Array.isArray(hits) ? hits : []).map(function (h) {
1012
+ var hs = (Array.isArray(h.holders) ? h.holders : []).map(function (x) { return x.id + ' 持锁(' + (x.status === 'verifying' ? '该卡验收中' : '该卡 Worker 在跑') + ')' }).join('、')
1013
+ return '⚔️ ' + h.file + ' 正被 ' + hs
1014
+ }).join(';')
1015
+ }
1016
+ // 撞锁视图像(返回体 planGate.lockConflicts):纯 id 清单(状态在文案里已分态,视图保持轻量)
1017
+ function lockConflictsView(hits) { return (Array.isArray(hits) ? hits : []).map(function (h) { return { file: h.file, holders: (Array.isArray(h.holders) ? h.holders : []).map(function (x) { return x.id }) } }) }
1018
+ // planGateApply(t, planFiles, actor, pat, d):d=看板数据(board_report 持锁段在调,必然有)——
1019
+ // 双查第二查「撞他卡有效锁」要用它现算他卡持锁(core.planLockConflicts)。
1020
+ function planGateApply(t, planFiles, actor, pat, d) {
1021
+ // 有效边界 = touches ∪ extraTouches(task-mvonytz3:仲裁扩权登记的文件即本卡合法边界,
1022
+ // 不再误报越界;touches 审计原值不动——边界展示带「含仲裁扩权」标注以资区别)
1023
+ var boundary = core.effectiveTouches(t)
1024
+ var hasExtra = Array.isArray(t.extraTouches) && t.extraTouches.length > 0
1025
+ // 卡无有效边界 → 无越界可比;但计划仍可能撞他卡锁(无边界卡的静默漂移同样现形)
1026
+ if (!boundary.length) {
1027
+ var hits0 = d ? core.planLockConflicts(d, t.id, planFiles) : []
1028
+ if (!hits0.length) {
1029
+ planGateMsg(t, '计划闸口:本卡未声明 touches,跳过比对直接过(' + planFiles.length + ' 个文件)', pat, actor)
1030
+ return { ok: true, progress: t.lastProgress, planGate: { skipped: true, files: planFiles.length } }
1031
+ }
1032
+ var lt0 = lockHitText(hits0)
1033
+ var appended0 = planGateMsg(t, '计划闸口:本卡未声明 touches,跳过边界比对;' + lt0 + '——主窗口可 task_intervene 协调或错时执行', pat, actor)
1034
+ var res0 = { ok: true, progress: t.lastProgress, planGate: { skipped: true, files: planFiles.length, outside: [], lockConflicts: lockConflictsView(hits0) }, warning: lt0 + '——请与他卡错时改写这些文件,或 board_report kind=escalate 请主窗口协调' }
1035
+ if (appended0) res0.planGateNotify = '⚔️ ' + t.id + ' 计划改动撞他卡文件锁:' + lt0 + '——可 task_intervene 协调'
1036
+ return res0
1037
+ }
1038
+ // 有前缀但没解析到路径 → 不通知主窗口,返回体 warning 让 Worker 自纠正重报
1039
+ if (!planFiles.length) {
1040
+ planGateMsg(t, '计划闸口:未解析到文件路径——以『计划改动:』开头、每行一个路径重报', pat, actor)
1041
+ return { ok: true, progress: t.lastProgress, planGate: { files: 0, outside: [] }, warning: '计划改动清单为空——请以『计划改动:』开头、每行一个路径列出将要修改/新建的文件后重报' }
1042
+ }
1043
+ var outside = core.planOutsideTouches(boundary, planFiles)
1044
+ // 双查第二查(task-mvonytz3④):计划文件命中其他 in-progress/verifying 卡的有效锁 → 点名持锁卡。
1045
+ // 两个在跑 Worker 各自报计划时都会看到对方持锁——静默漂移在动笔前现形。只警示不阻断。
1046
+ var hits = d ? core.planLockConflicts(d, t.id, planFiles) : []
1047
+ // 全合规 → 记一行过闸(幂等),不打扰主窗口
1048
+ if (!outside.length && !hits.length) {
1049
+ planGateMsg(t, '计划闸口已过(' + planFiles.length + ' 个文件均在 touches 内)', pat, actor)
1050
+ return { ok: true, progress: t.lastProgress, planGate: { files: planFiles.length, outside: [] } }
1051
+ }
1052
+ // 越界/撞锁 → 三通道警示(兼有=合并;无扩权且越界无锁=原文案逐字不变)
1053
+ var oobText = outside.join('、')
1054
+ var boundaryText = hasExtra ? boundary.join('、') + '(含仲裁扩权 extraTouches)' : boundary.join('、')
1055
+ var msgParts = []
1056
+ if (outside.length) msgParts.push('⚠️ 计划改动越界:' + oobText + ' 不在 touches(' + boundaryText + ')内')
1057
+ if (hits.length) msgParts.push(lockHitText(hits))
1058
+ var appended = planGateMsg(t, msgParts.join(';') + '——主窗口可 task_intervene ' + (outside.length ? '纠正或放行' : '协调或错时执行'), pat, actor)
1059
+ var warnParts = []
1060
+ if (outside.length) warnParts.push('计划改动越界:' + oobText + ' 不在本卡 touches 内——请修正计划(只改 touches 范围内的文件),或 board_report kind=escalate 请主窗口放行')
1061
+ if (hits.length) warnParts.push(lockHitText(hits) + '——请与他卡错时改写这些文件,或 board_report kind=escalate 请主窗口协调')
1062
+ var res = {
1063
+ ok: true,
1064
+ progress: t.lastProgress,
1065
+ planGate: { files: planFiles.length, outside: outside },
1066
+ warning: warnParts.join('\n')
1067
+ }
1068
+ if (hits.length) res.planGate.lockConflicts = lockConflictsView(hits)
1069
+ if (appended) {
1070
+ var notParts = []
1071
+ if (outside.length) notParts.push('⚠️ ' + t.id + ' 计划改动越界:' + oobText + ' 不在 touches 内')
1072
+ if (hits.length) notParts.push('⚔️ ' + t.id + ' 计划改动撞他卡文件锁:' + lockHitText(hits))
1073
+ res.planGateNotify = notParts.join(';') + '——可 task_intervene ' + (outside.length ? '纠正或放行' : '协调')
1074
+ }
1075
+ return res
1076
+ }
1077
+ 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 字符)——只在有实际产物/结论时报,禁止定时或表演式汇报,静默不通知主窗口。可选 sizeHint(light/standard/heavy):执行中/验收中自报档位修正——仅 in-progress/verifying 受理,与现档不同才写入(history+messages 双留痕审计);当前 run 模型不变,修正对失败重试/续跑/验收的下一次派发生效。', 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 字符)' }, sizeHint: { type: 'string', enum: ['light', 'standard', 'heavy'], description: '档位自修正(可选):light/standard/heavy;仅 in-progress/verifying 受理,同值幂等跳过,不同则写入并双留痕(history+messages),对下一次派发生效' } }, required: ['taskId', 'kind'] }, output: jo(), execute: async function (args) {
880
1078
  var sid = toolSessionId(); var actor = getActorId()
881
1079
  var result = await mutateLocked(sid, function (d) {
882
1080
  var t = d.tasks.find(function (x) { return x.id === args.taskId })
883
1081
  if (!t) return { ok: false, error: 'not found' }
884
- if (t.status !== 'in-progress') return { ok: false, error: 'not in-progress (状态: ' + t.status + ')' }
1082
+ // ===== 档位自修正(task-mvnesb3j):board_report.sizeHint 可选字段 =====
1083
+ // 受理窗口:in-progress(Worker 执行中)/ verifying(Verifier 验收中)——resolved/archived 等落定态拒收。
1084
+ // 枚举口径复用 TASK_SIZES(与 task_update size 同款);sizeHint 与现档(缺省=standard 语义)不同才写入:
1085
+ // t.size=sizeHint + history 一条(actor=上报者,note 记档位变迁与判定来源)+ 卡 messages 一行同款(双留痕审计);
1086
+ // 同值幂等跳过(零写入零留痕,防刷屏)。生效面零接线:spawnOneShot 每次 spawn 现读 t.size(rt 新鲜快照),
1087
+ // 修正对失败重试/续跑/验收的下一次派发自动生效;当前 run 不换模型(宿主不支持中途换)。
1088
+ // 自肥风险(Worker 给自己升档要更强模型)只靠留痕+可见性约束,不设审批(额度治理是另一个 epic 的事)。
1089
+ var sizeFix = null
1090
+ if (args.sizeHint !== undefined && args.sizeHint !== null && String(args.sizeHint).trim() !== '') {
1091
+ var hint = String(args.sizeHint).trim()
1092
+ if (TASK_SIZES.indexOf(hint) < 0) return { ok: false, error: '非法 sizeHint: ' + String(args.sizeHint) + '(合法值: light/standard/heavy)' }
1093
+ if (t.status !== 'in-progress' && t.status !== 'verifying') return { ok: false, error: 'sizeHint 仅 in-progress/verifying 受理(当前状态: ' + t.status + ')' }
1094
+ var curSize = TASK_SIZES.indexOf(t.size) >= 0 ? t.size : 'standard'
1095
+ if (hint === curSize) sizeFix = { skipped: true, size: curSize }
1096
+ else {
1097
+ var who = t.status === 'verifying' ? 'Verifier 验收中判定' : 'Worker 执行中判定'
1098
+ t.size = hint
1099
+ ah(t, t.status, t.status, actor, '档位自修正:' + curSize + '→' + hint + '(' + who + ')')
1100
+ if (!Array.isArray(t.messages)) t.messages = []
1101
+ t.messages.push({ kind: 'size-hint', text: '🎚 档位自修正:' + curSize + '→' + hint + '(' + who + ';当前 run 模型不变,对下一次派发生效)', at: new Date().toISOString(), by: actor })
1102
+ sizeFix = { applied: true, from: curSize, to: hint }
1103
+ }
1104
+ }
1105
+ if (t.status !== 'in-progress') {
1106
+ // verifying 卡的 sizeHint 专报通道(Verifier 侧,kind=progress):只受理 sizeHint 部分,不进 Worker 进展流
1107
+ if (sizeFix && args.kind === 'progress') return { ok: true, sizeHint: sizeFix }
1108
+ return { ok: false, error: 'not in-progress (状态: ' + t.status + ')' }
1109
+ }
885
1110
  if (!Array.isArray(t.messages)) t.messages = []
886
1111
  // ===== 里程碑进展通道(kind=progress)=====
887
1112
  // 定位:长任务执行期间的「还在正确路上」的轻量证明;不进回执聚合、不通知主窗口(纯静默可见)。
888
1113
  // 防表演式汇报:只在有实际产物/结论时报(契约写在 buildWorkerPrompt 里),且不写 ah() 历史(避免刷屏)。
889
1114
  if (args.kind === 'progress') {
890
- var ptext = String(args.question || '').trim().slice(0, 200)
891
- if (!ptext) return { ok: false, error: 'question required for progress (一行进展摘要)' }
1115
+ var rawQ = String(args.question || '').trim()
1116
+ // 开工计划闸口(task-mvneoyba):『计划改动:』前缀的 progress 进入 touches 边界比对。
1117
+ // 计划清单是多行路径(天然超 200 字),放宽到 2000(与歧义上报同档);普通进展仍 200。
1118
+ var planFiles = core.parsePlanFiles(rawQ)
1119
+ var ptext = rawQ.slice(0, planFiles ? 2000 : 200)
1120
+ if (!ptext) { if (sizeFix) return { ok: true, sizeHint: sizeFix }; return { ok: false, error: 'question required for progress (一行进展摘要)' } } // 纯档位自修正(sizeHint 不带进展文案):受理 sizeHint 即可,不强制补 question
892
1121
  var pat = new Date().toISOString()
893
1122
  t.messages.push({ kind: 'progress', text: ptext, at: pat, by: actor })
894
1123
  t.lastProgress = { text: ptext, at: pat } // 覆盖式:卡片只展示最新一条
895
- return { ok: true, progress: t.lastProgress }
1124
+ if (planFiles) { var pgr = planGateApply(t, planFiles, actor, pat, d); if (sizeFix) pgr.sizeHint = sizeFix; return pgr }
1125
+ var pr = { ok: true, progress: t.lastProgress }; if (sizeFix) pr.sizeHint = sizeFix; return pr
896
1126
  }
897
1127
  if (args.kind === 'escalate') {
898
1128
  var at = new Date().toISOString()
899
1129
  t.escalation = { question: (args.question || '').slice(0, 2000), at: at, by: actor }
900
1130
  t.messages.push({ kind: 'escalation', text: (args.question || '').slice(0, 4000), at: at, by: actor })
901
1131
  ah(t, 'in-progress', 'in-progress', actor, '上报歧义(工具通道),待主窗口裁决')
902
- return { ok: true, escalated: true, task: t }
1132
+ var er = { ok: true, escalated: true, task: t }; if (sizeFix) er.sizeHint = sizeFix; return er
903
1133
  }
904
1134
  delete t.escalation
905
1135
  delete t.retryCount // v72:成功完成清零超时重试计数(工具直报路径)
@@ -907,8 +1137,15 @@ export function createRpc(ctx, state, deps) {
907
1137
  t.deliverable = { summary: args.summary || '', changes: args.changes || '', selfTest: args.selfTest || '', diff: (args.diffStat || '').slice(0, 4000), at: new Date().toISOString(), by: actor }
908
1138
  var r = resolveApply(d, t, actor, 'verifying', (args.summary || '') + (args.selfTest ? '\n\n自测: ' + args.selfTest.slice(0, 300) : ''), 'worker 工具上报完成')
909
1139
  r.ok = true; r.task = t
1140
+ if (sizeFix) r.sizeHint = sizeFix
910
1141
  return r
911
1142
  })
1143
+ // 计划闸口越界警示(task-mvneoyba):走系统异常通道(带 taskId,投递时按任务现状过滤——
1144
+ // 任务已落定的过期警示直接丢弃),锁外调用不拖长写锁;字段带出后即删,不进工具返回体。
1145
+ if (result && result.ok && result.planGateNotify) {
1146
+ try { if (typeof pushSysNote === 'function') pushSysNote(sid, result.planGateNotify, args.taskId) } catch (_) {}
1147
+ delete result.planGateNotify
1148
+ }
912
1149
  if (result && result.ok && result.escalated) maybeNotify(sid, result.task)
913
1150
  if (result && result.ok && result.task && result.task.status === 'resolved') notifyTaskDone(sid, result.task, 'resolved') // 工具直报路径也要回执(work 档 board_report 直接落 resolved)
914
1151
  // ===== 上报通道收尾(task-muwkhqf8)=====
@@ -1009,6 +1246,16 @@ export function createRpc(ctx, state, deps) {
1009
1246
  }
1010
1247
  return out
1011
1248
  }
1249
+ // ===== 卡级 model / laneModels 槽位共用的合法清单校验(task-mvnemvf5,与 set-board-config 模型校验同口径)=====
1250
+ // 入参是 trim 后的非空模型 id;返回 null=放行,否则报错文案(带合法清单样例)。
1251
+ // 空串=清除不走进来;llm 缺失(老宿主,enumModels 返回 null)降级放行——配置面绝不因宿主能力缺失而炸。
1252
+ async function cardModelErr(mval) {
1253
+ var legal = await enumModels()
1254
+ if (!legal) return null
1255
+ for (var i = 0; i < legal.length; i++) { if (legal[i].id === mval) return null }
1256
+ var sample = legal.slice(0, 8).map(function (m) { return m.id })
1257
+ return '非法模型 id: ' + mval + '(不在当前网关可用清单)。合法清单(' + legal.length + ' 个,示前 ' + sample.length + ' 个):' + (sample.join('、') || '(空)') + '。完整清单见 list-models'
1258
+ }
1012
1259
  // 枚举当前网关可用模型(供 Verifier 模型下拉选择):llm.listProviders + listModels
1013
1260
  handle('list-models', async function () {
1014
1261
  var models = await enumModels()
@@ -1061,6 +1308,67 @@ export function createRpc(ctx, state, deps) {
1061
1308
  }
1062
1309
  }
1063
1310
  }
1311
+ // ===== laneModels 三档路由表(task-mvnemvf5):部分合并对象 + 逐槽位合法清单校验 =====
1312
+ // value 形态 { light?/standard?/heavy?: { worker?, verifier? } }——只合显式给出的槽位,未给槽位保留现值。
1313
+ // 槽位值允许**字符串或有序字符串数组**(task-mvnxckhq 同档优先序:第一位=首选,字符串归一为单元素数组,
1314
+ // 空串/空数组=清槽恢复继承下一级);非空 id(数组逐项)走与 workerModel 同款 enumModels 校验,
1315
+ // **任一槽位/任一项非法整体拒写**(不落半截合并结果)。未知档位/角色键、非对象形态一律 fail-loud
1316
+ // 拒写(防手滑写废整张表);llm 缺失(老宿主)由 cardModelErr 内部降级放行。
1317
+ if (args.key === 'laneModels') {
1318
+ var __lmErr = null
1319
+ var __lv = args.value
1320
+ if (!__lv || typeof __lv !== 'object' || Array.isArray(__lv)) __lmErr = 'laneModels 需为部分合并对象(如 {heavy:{worker:"provider/model"}} 或 {heavy:{worker:["首选","次选"]}})'
1321
+ else {
1322
+ var __lanes = Object.keys(__lv)
1323
+ for (var __li = 0; __li < __lanes.length && !__lmErr; __li++) {
1324
+ var __ln = __lanes[__li]
1325
+ if (TASK_SIZES.indexOf(__ln) < 0) { __lmErr = 'laneModels 未知档位: ' + __ln + '(合法: light/standard/heavy)'; break }
1326
+ var __lobj = __lv[__ln]
1327
+ if (!__lobj || typeof __lobj !== 'object' || Array.isArray(__lobj)) { __lmErr = 'laneModels.' + __ln + ' 需为对象 {worker?, verifier?}'; break }
1328
+ var __rks = Object.keys(__lobj)
1329
+ for (var __ri2 = 0; __ri2 < __rks.length; __ri2++) {
1330
+ var __rk = __rks[__ri2]
1331
+ if (__rk !== 'worker' && __rk !== 'verifier') { __lmErr = 'laneModels.' + __ln + ' 未知角色键: ' + __rk + '(合法: worker/verifier)'; break }
1332
+ var __raw = __lobj[__rk]
1333
+ if (typeof __raw === 'string') {
1334
+ var __rv = __raw.trim()
1335
+ if (__rv) { var __me = await cardModelErr(__rv); if (__me) { __lmErr = __me; break } }
1336
+ continue
1337
+ }
1338
+ if (Array.isArray(__raw)) {
1339
+ // 数组形态(同档优先序):逐项必须字符串且 trim 后非空(空串项 fail-loud——清槽请传 [] 或 ''),
1340
+ // 逐项过合法清单校验,任一非法整包拒写
1341
+ for (var __ai = 0; __ai < __raw.length; __ai++) {
1342
+ var __av = __raw[__ai]
1343
+ if (typeof __av !== 'string') { __lmErr = 'laneModels.' + __ln + '.' + __rk + '[' + __ai + '] 需为字符串(provider/model 复合格式)'; break }
1344
+ var __avt = __av.trim()
1345
+ if (!__avt) { __lmErr = 'laneModels.' + __ln + '.' + __rk + '[' + __ai + '] 为空串(清槽请传空数组 [] 或空串)'; break }
1346
+ var __me2 = await cardModelErr(__avt); if (__me2) { __lmErr = __me2; break }
1347
+ }
1348
+ if (__lmErr) break
1349
+ continue
1350
+ }
1351
+ __lmErr = 'laneModels.' + __ln + '.' + __rk + ' 需为字符串或字符串数组(有序=同档优先序,空串/空数组=清槽)'; break
1352
+ }
1353
+ }
1354
+ }
1355
+ if (__lmErr) return { ok: false, error: __lmErr }
1356
+ }
1357
+ // ===== fallbackModels 备用模型链(task-mvnqxlpn):有序字符串数组 + 逐项合法清单校验 =====
1358
+ // value 形态为字符串数组(有序备用链,跨供应商同档替代;空数组=清链不启用);逐项必须字符串且
1359
+ // trim 后非空,非空项走与 workerModel 同款 enumModels 校验,**任一项非法整包拒写**(不落半截数组,
1360
+ // 错误文案带合法清单样例);非数组形态 fail-loud 拒写。llm 缺失(老宿主)由 cardModelErr 内部降级放行。
1361
+ if (args.key === 'fallbackModels') {
1362
+ if (!Array.isArray(args.value)) return { ok: false, error: 'fallbackModels 需为字符串数组(有序备用链,如 ["gsmoma/kimi/kimi-k3","kimi-coding/k3.1-pro"];空数组=清链)' }
1363
+ for (var __fi = 0; __fi < args.value.length; __fi++) {
1364
+ var __fv = args.value[__fi]
1365
+ if (typeof __fv !== 'string') return { ok: false, error: 'fallbackModels[' + __fi + '] 需为字符串(provider/model 复合格式)' }
1366
+ var __fvt = __fv.trim()
1367
+ if (!__fvt) return { ok: false, error: 'fallbackModels[' + __fi + '] 为空串(清链请传空数组 [])' }
1368
+ var __fe = await cardModelErr(__fvt)
1369
+ if (__fe) return { ok: false, error: __fe }
1370
+ }
1371
+ }
1064
1372
  // ===== 板级配置审计行(task-mv9yuq2l,实证 n-mv8ki92qnhdq:verifierModel 神隐回退 flash 零留痕无从审计)=====
1065
1373
  // 白名单键成功写入即追加一行 {key, from, to, actor, at} 到 d.configLog(随看板落盘),截尾留最新 50 条——
1066
1374
  // 审计是「近期谁动了什么」的线索面,不做无限增长。from/to 取 d 的平铺顶层字段(白名单键全是顶层字段),
@@ -1069,7 +1377,7 @@ export function createRpc(ctx, state, deps) {
1069
1377
  return mutateLocked(sid, function (d) {
1070
1378
  var __from = d[args.key] === undefined ? null : d[args.key] // 写前留旧值(JSON 落盘不容 undefined,归一成 null)
1071
1379
  var __hit = true
1072
- 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 } else __hit = false
1380
+ 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 === 'probeEnabled') d.probeEnabled = !!args.value; else if (args.key === 'probeIntervalMin') d.probeIntervalMin = core.normalizeProbeIntervalMin(args.value); else if (args.key === 'epicSplit') { d.epicSplit = !!args.value; epicSplitCache[sid] = d.epicSplit } else if (args.key === 'laneModels') { var __base = cfg(d).laneModels; for (var __pi = 0; __pi < TASK_SIZES.length; __pi++) { var __pl = args.value[TASK_SIZES[__pi]]; if (!__pl) continue; if (__pl.worker !== undefined) __base[TASK_SIZES[__pi]].worker = core.normalizeLaneSlot(__pl.worker); if (__pl.verifier !== undefined) __base[TASK_SIZES[__pi]].verifier = core.normalizeLaneSlot(__pl.verifier) } d.laneModels = __base } else if (args.key === 'fallbackModels') { d.fallbackModels = core.normalizeFallbackModels(args.value) } else __hit = false
1073
1381
  if (__hit) {
1074
1382
  if (!Array.isArray(d.configLog)) d.configLog = []
1075
1383
  d.configLog.push({ key: String(args.key), from: __from, to: d[args.key] === undefined ? null : d[args.key], actor: actor, at: new Date().toISOString() })
@@ -1078,9 +1386,9 @@ export function createRpc(ctx, state, deps) {
1078
1386
  return { ok: true }
1079
1387
  })
1080
1388
  })
1081
- 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); appendDispatchWarning(out, d, t); /* 派发预警(task-mvbealtf):与 task_create 工具同口径,返回体瞬态提示不落卡 */ var warns = createTaskWarnings(t); attachContextSuggestions(out, warns, t.touches, existsInSession(sid)); if (warns.length) out.warning = warns.join(';'); return out }) })
1389
+ 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; /* size 普适化(task-mvomad2c):白名单校验(双模式)+ Team 硬闸(缺档拒建,非 Team 零约束零提示) */ var __sz = typeof args.size === 'string' ? args.size.trim() : ''; if (__sz && TASK_SIZES.indexOf(__sz) < 0) return { ok: false, error: '非法 size: ' + String(args.size) + '(合法值: light/standard/heavy)' }; if (d.teamMode && !__sz) return { ok: false, error: core.TEAM_SIZE_REQUIRED_ERR }; 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 (__sz) t.size = __sz; 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); appendDispatchWarning(out, d, t); /* 派发预警(task-mvbealtf):与 task_create 工具同口径,返回体瞬态提示不落卡 */ var warns = createTaskWarnings(t); attachContextSuggestions(out, warns, t.touches, existsInSession(sid)); if (warns.length) out.warning = warns.join(';'); return out }) })
1082
1390
  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) } } })
1083
- // ===== #14 批量操作:archive(仅 resolved/cancelled)/ set-priority(全部)/ delete(真删,无 undo)=====
1391
+ // ===== #14 批量操作:archive(仅 resolved/cancelled)/ set-priority(全部)/ delete(真删,无 undo)/ publish(仅 draft → pending)=====
1084
1392
  // delete op 与单任务 delete-task 走同一套 deleteGate 门禁(状态 + 未归档子任务),
1085
1393
  // done/skipped 语义与 archive 完全一致:门禁不过就进 skipped(附 reasons[id] 一行原因)。
1086
1394
  // 注意:批量删除是**真删**(从 tasks 数组移除),不产生 undo 快照——batch-undo 对 delete 无意义。
@@ -1114,7 +1422,11 @@ export function createRpc(ctx, state, deps) {
1114
1422
  if (['low', 'medium', 'high', 'critical'].indexOf(args.value) < 0) { skipped.push(id); return }
1115
1423
  t.priority = args.value; ah(t, t.status, t.status, actor, '批量设优先级: ' + args.value); done++
1116
1424
  } else if (args.op === 'publish') {
1117
- if (t.status !== 'draft') { skipped.push(id); return }
1425
+ // 批量发布草稿(task-mvneoy1u 确认流):复用单卡 publish 语义——仅 draft → pending(翻卡即入派发池);
1426
+ // 非 draft 进 skipped 并附原因(与 archive 的 'cannot archive' 同收口,客户端渲成「标题:原因」列表)。
1427
+ if (t.status !== 'draft') { skip(id, '仅草稿可发布(当前状态 ' + t.status + ')'); return }
1428
+ // Team 硬闸(task-mvomad2c):缺档草稿跳过附原因(整批不熔断,与既有 skip 语义一致)
1429
+ if (d.teamMode && TASK_SIZES.indexOf(t.size) < 0) { skip(id, 'Team 板缺力度档位 size——先 task_update 设档(light/standard/heavy)再发布'); return }
1118
1430
  t.status = 'pending'; ah(t, 'draft', 'pending', actor, 'batch publish'); done++
1119
1431
  } else { skipped.push(id) }
1120
1432
  })
@@ -1123,7 +1435,7 @@ export function createRpc(ctx, state, deps) {
1123
1435
  // 刻意不级联归档子卡:批量语义只动显式选中的 id(与单卡 archiveApply 的级联不同,保持老行为)。
1124
1436
  var parentsClosed = 0
1125
1437
  for (var ai = 0; ai < archived.length; ai++) { if (maybeAutoCloseParent(d, archived[ai])) parentsClosed++ }
1126
- // reasons 在 delete(deleteGate 门禁原因)与 archive(cannot archive)op 下有内容;
1438
+ // reasons 在 delete(deleteGate 门禁原因)/ archive(cannot archive)/ publish(非草稿)op 下有内容;
1127
1439
  // 老客户端只读 skipped.length,多一个可选字段无感。
1128
1440
  var out = { ok: true, done: done, skipped: skipped, reasons: reasons }
1129
1441
  if (parentsClosed) out.parentsClosed = parentsClosed
@@ -1186,6 +1498,44 @@ export function createRpc(ctx, state, deps) {
1186
1498
  })
1187
1499
 
1188
1500
  // ===== client ↔ host RPC:POST /dsh-agent-board { method, args } → JSON =====
1501
+ // ===== 人工/外部操作留痕(task-mvnf3gly):HTTP 写集成功即落 d.opsLog(截尾 50,仿 configLog)=====
1502
+ // 通道边界:HTTP 入口=人/外部(GUI 面板、脚本),ctx.tools=agent(agent 自己的操作本就在它上下文里,不记)。
1503
+ // 「人工/外部」是诚实的近似——HTTP 通道也可能是脚本,语义就是「非 agent 工具通道」。
1504
+ // 写集=改变盘面/运行态的方法(任务书列举 ∪ 实际 GUI 写方法名:terminate-task→terminate-agent、
1505
+ // publish 走 update-task);读集(get-tasks/list-children 等)不记,ok:false 不记;
1506
+ // mark-reviewed(详情页自动触发,噪音)/set-board-config(configLog 专道)/cleanup-run(cleanupLog 专道)不记。
1507
+ var OPS_WRITE_SET = { 'create-task': 1, 'update-task': 1, 'delete-task': 1, 'archive-task': 1, 'restore-task': 1, 'publish-task': 1, 'dispatch-task': 1, 'terminate-task': 1, 'terminate-agent': 1, 'batch-op': 1, 'batch-undo': 1, 'resolve-escalation': 1, 'intervene-agent': 1, 'verify-task': 1, 'claim-task': 1, 'resolve-task': 1, 'cancel-task': 1, 'unfreeze-task': 1, 'dismiss-suspect': 1, 'set-board-mode': 1, 'set-team-mode': 1, 'set-work-mode': 1, 'push-lesson': 1 }
1508
+ // 一句话摘要(单行,供 task_list recentOps / Team 注入段共用 opsLogLine 渲染)
1509
+ function opSummary(method, a) {
1510
+ a = a || {}
1511
+ if (method === 'update-task') { var ks = Object.keys(a).filter(function (k) { return k !== 'sessionId' && k !== 'taskId' && a[k] !== undefined }); return 'update-task ' + (ks.slice(0, 4).join('/') || '(无字段)') + (ks.length > 4 ? '…' : '') }
1512
+ if (method === 'batch-op') return 'batch-op ' + String(a.op || '?') + ' ×' + (Array.isArray(a.ids) ? a.ids.length : 0)
1513
+ if (method === 'batch-undo') return 'batch-undo ×' + (a.snapshot && Array.isArray(a.snapshot.items) ? a.snapshot.items.length : 0)
1514
+ if (method === 'verify-task') return 'verify-task ' + String(a.verdict || '?')
1515
+ if (method === 'resolve-task') return 'resolve-task →' + String(a.status || '?')
1516
+ if (method === 'resolve-escalation') return 'resolve-escalation ' + String(a.action || 'resume')
1517
+ if (method === 'create-task') return 'create-task 「' + String(a.title || '').slice(0, 30) + '」'
1518
+ if (method === 'dispatch-task') return 'dispatch-task' + (a.role ? ' ' + String(a.role) : '') + (a.force === true ? '(force)' : '')
1519
+ if (method === 'set-board-mode' || method === 'set-work-mode') return method + ' ' + String(a.mode)
1520
+ if (method === 'set-team-mode') return 'set-team-mode ' + (a.enabled ? 'on' : 'off')
1521
+ if (method === 'terminate-agent') return 'terminate-agent' + (a.hold === true ? '(hold 停派)' : '')
1522
+ return String(method)
1523
+ }
1524
+ // 留痕钩子:命中写集且 ok!==false 才追加;sid 解析不出(unknown/短 id)跳过——不为留痕造幻影板。
1525
+ // 返回 promise 由路由 await(测试确定性:响应落定=留痕已落盘);任何失败静默不反噬业务响应。
1526
+ function logOp(method, args) {
1527
+ try {
1528
+ var sid = rpcSessionId(args || {})
1529
+ if (!sid || sid === 'unknown' || !isFullSessionId(sid)) return null
1530
+ var taskId = String((args && args.taskId) || (args && Array.isArray(args.ids) ? args.ids.join(',') : '') || '')
1531
+ return mutateLocked(sid, function (d) {
1532
+ if (!Array.isArray(d.opsLog)) d.opsLog = []
1533
+ d.opsLog.push({ at: new Date().toISOString(), op: String(method), taskId: taskId, summary: opSummary(method, args), actor: sid })
1534
+ if (d.opsLog.length > 50) d.opsLog = d.opsLog.slice(-50) // 截尾 50 条:只留最新,防无限增长(仿 configLog)
1535
+ return { ok: true }
1536
+ }).catch(function () {})
1537
+ } catch (_) { return null }
1538
+ }
1189
1539
  function readBody(req, limit) {
1190
1540
  return new Promise(function (resolve, reject) {
1191
1541
  var chunks = [], size = 0
@@ -1209,7 +1559,7 @@ export function createRpc(ctx, state, deps) {
1209
1559
  try { payload = JSON.parse(await readBody(req, 4 * 1024 * 1024)) } catch (e) { res.writeHead(400); res.end(JSON.stringify({ ok: false, message: 'bad request' })); return }
1210
1560
  var fn = payload && handlers[payload.method]
1211
1561
  if (!fn) { res.writeHead(404); res.end(JSON.stringify({ ok: false, message: 'unknown method: ' + payload.method })); return }
1212
- try { var out = await fn(payload.args); res.writeHead(200); res.end(JSON.stringify(out === undefined ? null : out)) } catch (e) { res.writeHead(500); res.end(JSON.stringify({ ok: false, message: String(e) })) }
1562
+ try { var out = await fn(payload.args); if (out && out.ok !== false && OPS_WRITE_SET[payload.method]) await logOp(payload.method, payload.args); res.writeHead(200); res.end(JSON.stringify(out === undefined ? null : out)) } catch (e) { res.writeHead(500); res.end(JSON.stringify({ ok: false, message: String(e) })) }
1213
1563
  },
1214
1564
  })
1215
1565
  })