dsh-agent-board 1.6.0 → 1.6.1

package/README.md

@@ -101,6 +101,7 @@ dsh plugin --profile web remove dsh-agent-board
 
 - 仪表盘视图新增「Token 消耗」区：本看板累计总量 + 输入 / 输出 / 缓存读（缓存写非零时一并展示）拆分、按模型分布条形图、任务消耗 **Top 8**（标题可点击直达该任务详情）；进行中的卡片右上角显示本任务已累计消耗（`⛁ 数字`）
 - 数据来源：每次 Worker/Verifier run 结算时读该 run 的 v4 会话日志（`~/.dsh/sessions/*/<runId>/session.v4.jsonl.zstd`），把 `assistant/message` 事件的 `usage`（`inputTokens` / `outputTokens` / `cacheReadTokens` / `cacheWriteTokens` / `totalTokens`，字段形状以真实日志为准）按 zstd 帧逐帧累加到任务 `usage`（含按模型小计与 `runs` 计数，多轮重跑/驳回重做自动累加），`get-tasks` 再现算 board 级 `usageSummary`（总量 / 按模型 / Top8，不落盘额外表）——**只做展示、不做计费断言**，日志读不到或没有 usage 时一律显示「暂无数据」
+- 「架构健康」区（架构自省 L1）：`get-tasks` 顺带对**近 50 张卡**现算四信号（纯函数零存储：touches 声明热度 ≥8 次且占比 ≥40% / 带 touches 任务滞留中位数 >2 倍 / 任务时长 p90 >45min / 同路径驳回 ≥2 次），命中才在仪表盘渲染提示条（⚠️/ℹ️ 两级，最多 3 条）——让运行数据主动提示"该优化架构了"（如某文件反复成为锁热点=该拆），信号只建议不裁判
 
 ### 学习反馈（候选教训信号 → 主窗口沉淀）
 

package/lib/client/dashboard.js

@@ -1,6 +1,7 @@
 // ============================================================================
 // dashboard —— 仪表盘域：统计（computeStats/TrendChart/StatCard/BarRow）· 范围筛选（RangeFilter）
 //   · 全局总览（GlobalBoards）· 报告（buildReport/ReportButton）· Token 消耗（TokenUsage）
+//   · 架构健康（HealthHints，架构自省 L1）
 //   · 团队池（TeamView/PoolStatus）· 设置（WorkModeSwitch/PoolCfg/MinCfg/ModelCfg/PoolCfgPopover）
 // 本文件是 apply(ctx) 函数体片段，不可独立运行；由 scripts/build-client.cjs 按序拼接生成 lib/client.js。
 // ============================================================================
@@ -204,12 +205,44 @@
             }))))
     }
 
+    // ===== 架构健康提示区（架构自省 L1 · 数据源：host 端 get-tasks 的 healthHints）=====
+    // healthHints 由 host lib/health.mjs 的 computeHealthHints(tasks) 每次请求现算（纯函数零存储零 IO）：
+    //   [{ level: 'warn'|'info', text }]。缺省兼容：老 host 无此字段 / 非数组 / 空数组 → 返回 null，
+    //   整块不渲染（零残留）。无按钮无状态（不做 dismiss）：以 state.tasks 为 effect 依赖——kernel
+    //   fetchTasks 每轮都赋它新数组引用，故本区随 3s 轮询同步重取，只反映 host 最新一轮纯重算结果。
+    function HealthHints() {
+      var _R = React; var useState = _R.useState, useEffect = _R.useEffect
+      var _a = useState([]), hints = _a[0], setHints = _a[1]
+      useEffect(function () {
+        var dead = false
+        rpc('get-tasks').then(function (d) {
+          if (dead) return
+          var arr = (d && Array.isArray(d.healthHints)) ? d.healthHints : []
+          setHints(arr.filter(function (h) { return h && h.text }))
+        }).catch(function () {})
+        return function () { dead = true }
+      }, [state.tasks])
+      if (!hints.length) return null
+      // 两级配色：warn=⚠️ 琥珀（C.warn）；info=ℹ️ 蓝灰（DSH 现有 business 信息色——色板无独立 info 档）
+      var infoColor = 'var(--dsw-alias-state-business-primary)'
+      return React.createElement('div', { style: { padding: '8px 10px', background: C.card, border: '1px solid ' + C.border, borderRadius: 6, marginBottom: 12 } },
+        React.createElement('div', { style: { fontSize: 11, fontWeight: 600, color: C.text2, marginBottom: 6, display: 'flex', alignItems: 'center', gap: 4 } }, ic('activity', 11), '架构健康'),
+        hints.map(function (h, i) {
+          var warn = h.level === 'warn'
+          var col = warn ? C.warn : infoColor
+          return React.createElement('div', { key: i, style: { display: 'flex', alignItems: 'baseline', gap: 5, fontSize: 10, lineHeight: 1.5, color: col, marginBottom: 3 } },
+            React.createElement('span', { style: { flexShrink: 0 } }, warn ? '⚠️' : 'ℹ️'),
+            React.createElement('span', null, String(h.text)))
+        }))
+    }
+
     function Dashboard() {
       var stats = computeStats(state.tasks); var statusOrder = ['pending', 'in-progress', 'verifying', 'resolved', 'blocked', 'archived']; var prioOrder = ['critical', 'high', 'medium', 'low']
       return React.createElement('div', null,
         React.createElement(RangeFilter),
         React.createElement(GlobalBoards),
         React.createElement('div', { style: { display: 'flex', gap: 6, marginBottom: 12, flexWrap: 'wrap' } }, React.createElement(StatCard, { label: '总任务', value: stats.total, color: C.text }), React.createElement(StatCard, { label: '待办', value: stats.byStatus['pending'] || 0, color: C.text2 }), React.createElement(StatCard, { label: '进行中', value: stats.byStatus['in-progress'] || 0, color: C.brand }), React.createElement(StatCard, { label: '验证中', value: stats.byStatus['verifying'] || 0, color: C.warn }), React.createElement(StatCard, { label: '已完成', value: stats.byStatus['resolved'] || 0, color: C.ok }), React.createElement(StatCard, { label: '已归档', value: stats.byStatus['archived'] || 0, color: C.text2 })),
+        React.createElement(HealthHints),
         React.createElement(TokenUsage, { usage: state.usageSummary }),
         React.createElement('div', { style: { display: 'flex', gap: 12, marginBottom: 12, flexWrap: 'wrap' } },
           React.createElement('div', { style: { flex: '1 1 0', minWidth: 200, padding: '8px 10px', background: C.card, border: '1px solid ' + C.border, borderRadius: 6 } }, React.createElement('div', { style: { fontSize: 11, fontWeight: 600, color: C.text2, marginBottom: 6 } }, '按状态分布'), statusOrder.map(function (s) { return React.createElement(BarRow, { key: s, label: statusLabels[s] || s, count: stats.byStatus[s] || 0, total: stats.total, color: statusColors[s] || C.brand }) })),

package/lib/client.js

@@ -900,6 +900,7 @@ function apply(ctx) {
 // ============================================================================
 // dashboard —— 仪表盘域：统计（computeStats/TrendChart/StatCard/BarRow）· 范围筛选（RangeFilter）
 //   · 全局总览（GlobalBoards）· 报告（buildReport/ReportButton）· Token 消耗（TokenUsage）
+//   · 架构健康（HealthHints，架构自省 L1）
 //   · 团队池（TeamView/PoolStatus）· 设置（WorkModeSwitch/PoolCfg/MinCfg/ModelCfg/PoolCfgPopover）
 // 本文件是 apply(ctx) 函数体片段，不可独立运行；由 scripts/build-client.cjs 按序拼接生成 lib/client.js。
 // ============================================================================
@@ -1103,12 +1104,44 @@ function apply(ctx) {
             }))))
     }
 
+    // ===== 架构健康提示区（架构自省 L1 · 数据源：host 端 get-tasks 的 healthHints）=====
+    // healthHints 由 host lib/health.mjs 的 computeHealthHints(tasks) 每次请求现算（纯函数零存储零 IO）：
+    //   [{ level: 'warn'|'info', text }]。缺省兼容：老 host 无此字段 / 非数组 / 空数组 → 返回 null，
+    //   整块不渲染（零残留）。无按钮无状态（不做 dismiss）：以 state.tasks 为 effect 依赖——kernel
+    //   fetchTasks 每轮都赋它新数组引用，故本区随 3s 轮询同步重取，只反映 host 最新一轮纯重算结果。
+    function HealthHints() {
+      var _R = React; var useState = _R.useState, useEffect = _R.useEffect
+      var _a = useState([]), hints = _a[0], setHints = _a[1]
+      useEffect(function () {
+        var dead = false
+        rpc('get-tasks').then(function (d) {
+          if (dead) return
+          var arr = (d && Array.isArray(d.healthHints)) ? d.healthHints : []
+          setHints(arr.filter(function (h) { return h && h.text }))
+        }).catch(function () {})
+        return function () { dead = true }
+      }, [state.tasks])
+      if (!hints.length) return null
+      // 两级配色：warn=⚠️ 琥珀（C.warn）；info=ℹ️ 蓝灰（DSH 现有 business 信息色——色板无独立 info 档）
+      var infoColor = 'var(--dsw-alias-state-business-primary)'
+      return React.createElement('div', { style: { padding: '8px 10px', background: C.card, border: '1px solid ' + C.border, borderRadius: 6, marginBottom: 12 } },
+        React.createElement('div', { style: { fontSize: 11, fontWeight: 600, color: C.text2, marginBottom: 6, display: 'flex', alignItems: 'center', gap: 4 } }, ic('activity', 11), '架构健康'),
+        hints.map(function (h, i) {
+          var warn = h.level === 'warn'
+          var col = warn ? C.warn : infoColor
+          return React.createElement('div', { key: i, style: { display: 'flex', alignItems: 'baseline', gap: 5, fontSize: 10, lineHeight: 1.5, color: col, marginBottom: 3 } },
+            React.createElement('span', { style: { flexShrink: 0 } }, warn ? '⚠️' : 'ℹ️'),
+            React.createElement('span', null, String(h.text)))
+        }))
+    }
+
     function Dashboard() {
       var stats = computeStats(state.tasks); var statusOrder = ['pending', 'in-progress', 'verifying', 'resolved', 'blocked', 'archived']; var prioOrder = ['critical', 'high', 'medium', 'low']
       return React.createElement('div', null,
         React.createElement(RangeFilter),
         React.createElement(GlobalBoards),
         React.createElement('div', { style: { display: 'flex', gap: 6, marginBottom: 12, flexWrap: 'wrap' } }, React.createElement(StatCard, { label: '总任务', value: stats.total, color: C.text }), React.createElement(StatCard, { label: '待办', value: stats.byStatus['pending'] || 0, color: C.text2 }), React.createElement(StatCard, { label: '进行中', value: stats.byStatus['in-progress'] || 0, color: C.brand }), React.createElement(StatCard, { label: '验证中', value: stats.byStatus['verifying'] || 0, color: C.warn }), React.createElement(StatCard, { label: '已完成', value: stats.byStatus['resolved'] || 0, color: C.ok }), React.createElement(StatCard, { label: '已归档', value: stats.byStatus['archived'] || 0, color: C.text2 })),
+        React.createElement(HealthHints),
         React.createElement(TokenUsage, { usage: state.usageSummary }),
         React.createElement('div', { style: { display: 'flex', gap: 12, marginBottom: 12, flexWrap: 'wrap' } },
           React.createElement('div', { style: { flex: '1 1 0', minWidth: 200, padding: '8px 10px', background: C.card, border: '1px solid ' + C.border, borderRadius: 6 } }, React.createElement('div', { style: { fontSize: 11, fontWeight: 600, color: C.text2, marginBottom: 6 } }, '按状态分布'), statusOrder.map(function (s) { return React.createElement(BarRow, { key: s, label: statusLabels[s] || s, count: stats.byStatus[s] || 0, total: stats.total, color: statusColors[s] || C.brand }) })),

package/lib/core.mjs

@@ -32,7 +32,7 @@ export function vt(d) { return d && typeof d === 'object' && Array.isArray(d.tas
 //   5. 裸文件名（无 '/' 且非 '*.ext'）只在「另一侧也是裸名」时比 basename 相等；
 //      含 '/' 的具体路径不参与裸名规则（否则 'a/core.mjs' 会误撞裸名 'core.mjs'）。
 // 保守倾向：不确定即算冲突（误拦只是晚一轮派发，漏拦会让两个 Worker 互踩）。
-function normTouch(s) {
+export function normTouch(s) {
   var v = String(s).replace(/\\/g, '/').trim()
   while (v.slice(0, 2) === './') v = v.slice(2)
   while (v.length > 1 && v.charAt(v.length - 1) === '/') v = v.slice(0, -1)

package/lib/health.mjs

@@ -0,0 +1,130 @@
+// dsh-agent-board — 架构自省 L1（lib/health.mjs）
+// 纯函数、零状态、零 IO：从任务数组现算「架构健康提示」，不落盘、不通知、不依赖任何 ctx。
+// 数据源只用任务持久化字段（createdAt/claimedAt/resolvedAt/touches/rejectCount）。
+// 窗口化（近 50 张卡）而非累计：架构优化落地后老数据自动滑出窗口不再报警——
+// 健康区同时是「拆分是否有效」的客观验收证据。
+// 信号源不做裁判：只产提示文案，决策永远是人。
+import { normTouch } from './core.mjs'
+
+// ===== 阈值常量（全部置顶，可按实际使用手感调整；只影响之后的计算，不追溯老数据）=====
+var WINDOW_SIZE = 50       // 统计窗口：按 createdAt 取最近 N 张卡（含归档）
+var TOUCH_HOT_MIN = 8      // 信号 a：单路径 touches 声明次数阈值
+var TOUCH_HOT_RATIO = 0.4  // 信号 a：声明次数占窗口内「有 touches 任务」的比例阈值
+var SERIAL_MIN_TOUCH = 5   // 信号 b：有 touches 任务的最小样本数（不足则不判定，防小样本噪声）
+var SERIAL_RATIO = 2       // 信号 b：有 touches 任务滞留中位数 > 无 touches 任务的 N 倍
+var P90_LIMIT_MIN = 45     // 信号 c：resolved 任务时长 p90 阈值（分钟）
+var REJECT_HOT_MIN = 2     // 信号 d：单路径累计驳回次数阈值
+var MAX_HINTS = 3          // 返回提示上限（warn 信号优先排列）
+
+// 毫秒 → 分钟（四舍五入取整，仅供文案展示）
+function toMin(ms) { return Math.round(ms / 60000) }
+
+// 中位数（输入任意序，内部复制排序；空数组返回 null）
+function medianOf(nums) {
+  if (!nums.length) return null
+  var v = nums.slice().sort(function (a, b) { return a - b })
+  var n = v.length
+  return n % 2 ? v[(n - 1) / 2] : (v[n / 2 - 1] + v[n / 2]) / 2
+}
+
+// p 分位数（near-rank：升序后取 ceil(p*n)-1 位；空数组返回 null）
+function percentileOf(nums, p) {
+  if (!nums.length) return null
+  var v = nums.slice().sort(function (a, b) { return a - b })
+  var i = Math.ceil(p * v.length) - 1
+  if (i < 0) i = 0
+  return v[i]
+}
+
+// pending 滞留代理：createdAt →（claimedAt 优先，否则 resolvedAt）。无法计算返回 -1。
+function waitMsOf(t) {
+  var end = t.claimedAt || t.resolvedAt
+  if (!end || !t.createdAt) return -1
+  var ms = Date.parse(end) - Date.parse(t.createdAt)
+  return (isNaN(ms) || ms < 0) ? -1 : ms
+}
+
+// 任务时长：resolvedAt - createdAt。无法计算返回 -1。
+function durationMsOf(t) {
+  if (!t.resolvedAt || !t.createdAt) return -1
+  var ms = Date.parse(t.resolvedAt) - Date.parse(t.createdAt)
+  return (isNaN(ms) || ms < 0) ? -1 : ms
+}
+
+// 任务 touches 归一化（与 core.mjs normTouch 同款口径）+ 单任务内去重；无 touches 返回 []
+function normPathsOf(t) {
+  var raw = Array.isArray(t.touches) ? t.touches : []
+  var seen = {}, out = []
+  for (var i = 0; i < raw.length; i++) {
+    if (typeof raw[i] !== 'string') continue
+    var p = normTouch(raw[i])
+    if (p && !seen[p]) { seen[p] = true; out.push(p) }
+  }
+  return out
+}
+
+// 取计数最高的路径；并列时取字典序较小者保证确定性。返回 [path, count]，空表返回 ['', 0]
+function topPath(counts) {
+  var best = '', bestN = 0
+  for (var p in counts) {
+    var n = counts[p]
+    if (n > bestN || (n === bestN && n > 0 && p < best)) { best = p; bestN = n }
+  }
+  return [best, bestN]
+}
+
+// 主入口：tasks = 看板任务数组（含归档）。返回 [{level:'warn'|'info', text}]，最多 MAX_HINTS 条，无命中返回 []。
+export function computeHealthHints(tasks) {
+  var all = Array.isArray(tasks) ? tasks.slice() : []
+  if (!all.length) return []
+  // 窗口：按 createdAt 倒序取最近 WINDOW_SIZE 张（缺 createdAt 视为空串，排在最老一侧）
+  all.sort(function (a, b) { return String((b && b.createdAt) || '').localeCompare(String((a && a.createdAt) || '')) })
+  var win = all.slice(0, WINDOW_SIZE)
+
+  // 单趟遍历收集各信号所需的分组数据
+  var declCounts = {}   // 信号 a：路径 → 声明次数
+  var rejCounts = {}    // 信号 d：路径 → 累计驳回次数
+  var waitWith = []     // 信号 b：有 touches 任务的滞留毫秒
+  var waitWithout = []  // 信号 b：无 touches 任务的滞留毫秒
+  var withTouchN = 0    // 窗口内有 touches 的任务数（信号 a 占比分母）
+  var durations = []    // 信号 c：resolved 任务时长毫秒
+  for (var i = 0; i < win.length; i++) {
+    var t = win[i] || {}
+    var paths = normPathsOf(t)
+    if (paths.length) {
+      withTouchN++
+      for (var j = 0; j < paths.length; j++) declCounts[paths[j]] = (declCounts[paths[j]] || 0) + 1
+    }
+    var rc = t.rejectCount || 0
+    if (rc > 0) { for (var k = 0; k < paths.length; k++) rejCounts[paths[k]] = (rejCounts[paths[k]] || 0) + rc }
+    var w = waitMsOf(t)
+    if (w >= 0) { if (paths.length) waitWith.push(w); else waitWithout.push(w) }
+    var dur = durationMsOf(t)
+    if (dur >= 0) durations.push(dur)
+  }
+
+  var hints = []
+  // --- 信号 a：touches 声明热度（某路径被高频声明 = 架构收敛点失控，该拆）---
+  var hot = topPath(declCounts)
+  if (hot[1] >= TOUCH_HOT_MIN && withTouchN > 0 && hot[1] / withTouchN >= TOUCH_HOT_RATIO) {
+    hints.push({ level: 'warn', text: hot[0] + ' 在近 ' + win.length + ' 张卡中被 ' + hot[1] + ' 次声明 touches（占比 ' + Math.round(hot[1] / withTouchN * 100) + '%）——考虑拆分模块' })
+  }
+  // --- 信号 d：驳回热点（按 touches 路径聚合 rejectCount = 质量脆弱区）---
+  var rej = topPath(rejCounts)
+  if (rej[1] >= REJECT_HOT_MIN) {
+    hints.push({ level: 'warn', text: rej[0] + ' 相关任务被驳回 ' + rej[1] + ' 次——质量脆弱区，建议审查该模块' })
+  }
+  // --- 信号 b：串行代价代理（有 touches 任务滞留中位数显著更长 = 并行度受锁限制）---
+  if (waitWith.length >= SERIAL_MIN_TOUCH && waitWithout.length > 0) {
+    var medW = medianOf(waitWith), medWo = medianOf(waitWithout)
+    if (medW > medWo * SERIAL_RATIO) {
+      hints.push({ level: 'info', text: '带 touches 任务平均等待明显更长（中位数 ' + toMin(medW) + 'min vs ' + toMin(medWo) + 'min），并行度受锁限制' })
+    }
+  }
+  // --- 信号 c：时长 p90（resolved 任务时长尾部抬升 = 粒度/架构成本恶化）---
+  var p90 = percentileOf(durations, 0.9)
+  if (p90 !== null && p90 > P90_LIMIT_MIN * 60000) {
+    hints.push({ level: 'info', text: '任务时长 p90 已达 ' + toMin(p90) + 'min——超长任务占比升高，考虑拆分粒度或检查架构热点' })
+  }
+  return hints.slice(0, MAX_HINTS)
+}

package/lib/rpc.mjs

@@ -11,6 +11,7 @@ import fsNode from 'node:fs'
 import { findRunLog, readLogBytes, readLogFrames, aggregateUsageSummary } from './usage.mjs'
 import { TASK_SIZE_CONTRACT, withSplitHint, pushRejectLesson, pushArbitrationLesson } from './policy.mjs'
 import { makeMsg } from './notify.mjs'
+import { computeHealthHints } from './health.mjs'
 const { ah, isb, gsb, gpt, vt, validateDeps, classifyPipeline, cfg, claimCheck, claimApply, resolveApply, verifyApply, PRIO_RANK, touchesConflict, holdsFiles, boardHome } = core
 
 function defineTool(options) {
@@ -71,6 +72,8 @@ export function createRpc(ctx, state, deps) {
       d.workMode = deriveWorkMode(d)
       // ===== board 级 token 消耗聚合（现算，不落盘）：总量 + 输入/输出/缓存读 + 按模型 + 任务 Top8 =====
       d.usageSummary = aggregateUsageSummary(d.tasks)
+      // 架构自省 L1：healthHints 现算（纯函数零存储零 IO，近 50 卡窗口），客户端「架构健康」区超阈值才显示
+      d.healthHints = computeHealthHints(d.tasks)
       return d })
     // 派发前上下文预览：主 agent 用它确认"我将注入给子代理的材料"是否足够（不发任务、不落盘）
     handle('preview-context', async function (args) {

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "dsh-agent-board",
   "description": "DeepSeek Harness 智能看板：任务卡片 + 一次性 Worker/Verifier 派发 + 依赖调度 + 管线分档 + Team 模式（歧义上报主窗口裁决）",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "type": "module",
   "main": "./index.mjs",
   "scripts": {
     "build-client": "node scripts/build-client.cjs",
-    "test": "node --test test/core.test.mjs",
+    "test": "node --test test/*.test.mjs",
     "pretest": "npm run build-client",
     "sync-readme": "node -e \"require('fs').copyFileSync('../../README.md','README.md')\"",
     "prepublishOnly": "npm run build-client && node --check index.mjs && node --check lib/client.js && node --check lib/core.mjs && npm test",

package/test/core.test.mjs

@@ -864,3 +864,17 @@ test('学习飞轮接线：两处触发点 + push-lesson 开关拦截 + prompt/
   assert.doesNotMatch(coreSrc, /from 'dsh-notes|ctx\.get\('notes'\)|uiWorkspace\.openNote|note_manage\(|note_search\(/)
   assert.doesNotMatch(cli, /from 'dsh-notes|ctx\.get\('notes'\)|uiWorkspace\.openNote|note_manage\(|note_search\(/)
 })
+
+// ===== 架构自省 L1·UI：仪表盘「架构健康」提示区接线（源码级断言；纯函数信号本身见 health.test.mjs）=====
+test('架构健康接线：get-tasks 返回 healthHints + 仪表盘 HealthHints 区缺省兼容渲染', () => {
+  const host = hostSrc()
+  const cli = readFileSync(new URL('../lib/client.js', import.meta.url), 'utf8')
+  assert.match(host, /d\.healthHints = computeHealthHints\(d\.tasks\)/)   // host 每次请求现算返回（零存储）
+  assert.match(cli, /function HealthHints\(\)/)                          // 仪表盘提示区组件
+  assert.match(cli, /React\.createElement\(HealthHints\)/)               // 挂进 Dashboard（统计卡行下方、Token 消耗区上方）
+  assert.match(cli, /Array\.isArray\(d\.healthHints\)/)                  // 缺省兼容：老 host 无字段/非数组 → 按空处理
+  assert.match(cli, /if \(!hints\.length\) return null/)                 // 空数组 → 整块不渲染（零残留）
+  assert.match(cli, /'架构健康'/)                                        // 区标题
+  assert.match(cli, /warn \? C\.warn : infoColor/)                       // warn=琥珀 / info=蓝灰 两级配色
+  assert.match(cli, /dsw-alias-state-business-primary/)                  // info 蓝灰用 DSH 现有 business 信息色（色板无独立 info 档）
+})

package/test/health.test.mjs

@@ -0,0 +1,144 @@
+// dsh-agent-board — 架构自省 L1 单测（test/health.test.mjs）
+// 覆盖：四信号命中/不命中、窗口边界（近 50 张卡）、空板、提示上限 3 条。
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { computeHealthHints } from '../lib/health.mjs'
+
+var MIN = 60000
+var BASE = Date.parse('2026-01-01T00:00:00.000Z')
+function iso(ms) { return new Date(ms).toISOString() }
+
+// 造卡：i 决定 createdAt（i 越大越新），extra 覆盖字段
+function mk(i, extra) {
+  var t = { id: 't' + i, createdAt: iso(BASE + i * MIN), status: 'resolved', touches: [], claimedAt: null, resolvedAt: null, rejectCount: 0 }
+  return Object.assign(t, extra || {})
+}
+
+// ===== 空板 / 非法输入 =====
+test('空板与非法输入返回 []', function () {
+  assert.deepEqual(computeHealthHints([]), [])
+  assert.deepEqual(computeHealthHints(undefined), [])
+  assert.deepEqual(computeHealthHints(null), [])
+})
+
+// ===== 信号 a：touches 声明热度 =====
+test('信号 a 命中：单路径 ≥8 次且占比 ≥40% → warn', function () {
+  var ts = []
+  for (var i = 0; i < 10; i++) ts.push(mk(i, { touches: ['src/big.js'], claimedAt: iso(BASE + i * MIN + 1 * MIN), resolvedAt: iso(BASE + i * MIN + 2 * MIN) }))
+  var hints = computeHealthHints(ts)
+  assert.equal(hints.length, 1)
+  assert.equal(hints[0].level, 'warn')
+  assert.ok(hints[0].text.indexOf('src/big.js') >= 0)
+  assert.ok(hints[0].text.indexOf('10 次声明 touches') >= 0)
+  assert.ok(hints[0].text.indexOf('占比 100%') >= 0)
+  assert.ok(hints[0].text.indexOf('考虑拆分模块') >= 0)
+})
+
+test('信号 a 不命中：声明次数 <8', function () {
+  var ts = []
+  for (var i = 0; i < 7; i++) ts.push(mk(i, { touches: ['src/big.js'], claimedAt: iso(BASE + i * MIN + MIN), resolvedAt: iso(BASE + i * MIN + 2 * MIN) }))
+  assert.deepEqual(computeHealthHints(ts), [])
+})
+
+test('信号 a 不命中：次数够但占有 touches 任务比例 <40%', function () {
+  var ts = []
+  for (var i = 0; i < 8; i++) ts.push(mk(i, { touches: ['src/hot.js'] }))
+  for (var j = 0; j < 20; j++) ts.push(mk(100 + j, { touches: ['src/u' + j + '.js'] }))
+  // src/hot.js 计 8 次 ≥8，但有 touches 任务共 28 张，占比 28.6% <40% → 不提示
+  assert.deepEqual(computeHealthHints(ts), [])
+})
+
+test('信号 a 口径：路径归一化（./ 前缀与反斜杠合并计数）', function () {
+  var ts = []
+  for (var i = 0; i < 4; i++) ts.push(mk(i, { touches: ['./src/big.js'] }))
+  for (var j = 0; j < 4; j++) ts.push(mk(10 + j, { touches: ['src\\big.js'] }))
+  var hints = computeHealthHints(ts)
+  assert.equal(hints.length, 1)
+  assert.equal(hints[0].level, 'warn')
+  assert.ok(hints[0].text.indexOf('src/big.js 在近 8 张卡中被 8 次声明 touches（占比 100%）') >= 0)
+})
+
+// ===== 信号 b：串行代价代理 =====
+test('信号 b 命中：有 touches 任务滞留中位数 > 无 touches 的 2 倍且样本 ≥5', function () {
+  var ts = []
+  for (var i = 0; i < 6; i++) ts.push(mk(i, { touches: ['src/x' + i + '.js'], claimedAt: iso(BASE + i * MIN + 30 * MIN), resolvedAt: iso(BASE + i * MIN + 31 * MIN) }))
+  for (var j = 0; j < 6; j++) ts.push(mk(100 + j, { claimedAt: iso(BASE + (100 + j) * MIN + 3 * MIN), resolvedAt: iso(BASE + (100 + j) * MIN + 4 * MIN) }))
+  var hints = computeHealthHints(ts)
+  assert.equal(hints.length, 1)
+  assert.equal(hints[0].level, 'info')
+  assert.ok(hints[0].text.indexOf('中位数 30min vs 3min') >= 0)
+  assert.ok(hints[0].text.indexOf('并行度受锁限制') >= 0)
+})
+
+test('信号 b 不命中：有 touches 任务样本 <5', function () {
+  var ts = []
+  for (var i = 0; i < 4; i++) ts.push(mk(i, { touches: ['src/x' + i + '.js'], claimedAt: iso(BASE + i * MIN + 60 * MIN) }))
+  for (var j = 0; j < 4; j++) ts.push(mk(100 + j, { claimedAt: iso(BASE + (100 + j) * MIN + MIN) }))
+  assert.deepEqual(computeHealthHints(ts), [])
+})
+
+// ===== 信号 c：时长 p90 =====
+test('信号 c 命中：resolved 任务时长 p90 > 45min', function () {
+  var ts = []
+  for (var i = 0; i < 8; i++) ts.push(mk(i, { claimedAt: iso(BASE + i * MIN + MIN), resolvedAt: iso(BASE + i * MIN + 10 * MIN) }))
+  for (var j = 0; j < 2; j++) ts.push(mk(100 + j, { claimedAt: iso(BASE + (100 + j) * MIN + MIN), resolvedAt: iso(BASE + (100 + j) * MIN + 120 * MIN) }))
+  // n=10，p90 = 升序第 ceil(0.9*10)=9 位 = 120min
+  var hints = computeHealthHints(ts)
+  assert.equal(hints.length, 1)
+  assert.equal(hints[0].level, 'info')
+  assert.ok(hints[0].text.indexOf('p90 已达 120min') >= 0)
+})
+
+test('信号 c 不命中：p90 未超阈值', function () {
+  var ts = []
+  for (var i = 0; i < 10; i++) ts.push(mk(i, { claimedAt: iso(BASE + i * MIN + MIN), resolvedAt: iso(BASE + i * MIN + 30 * MIN) }))
+  assert.deepEqual(computeHealthHints(ts), [])
+})
+
+// ===== 信号 d：驳回热点 =====
+test('信号 d 命中：同路径累计驳回 ≥2 次 → warn', function () {
+  var ts = [
+    mk(0, { touches: ['src/fragile.js'], rejectCount: 1 }),
+    mk(1, { touches: ['src/fragile.js'], rejectCount: 1 }),
+  ]
+  var hints = computeHealthHints(ts)
+  assert.equal(hints.length, 1)
+  assert.equal(hints[0].level, 'warn')
+  assert.ok(hints[0].text.indexOf('src/fragile.js 相关任务被驳回 2 次') >= 0)
+  assert.ok(hints[0].text.indexOf('质量脆弱区') >= 0)
+})
+
+test('信号 d 不命中：驳回 <2 次；无 touches 的驳回无法归因', function () {
+  assert.deepEqual(computeHealthHints([mk(0, { touches: ['src/a.js'], rejectCount: 1 })]), [])
+  assert.deepEqual(computeHealthHints([mk(0, { rejectCount: 5 })]), [])
+})
+
+// ===== 窗口边界：只统计近 50 张卡（含归档）=====
+test('窗口边界：热点滑出近 50 张窗口后不再报警', function () {
+  var hot = []
+  for (var i = 0; i < 10; i++) hot.push(mk(i, { touches: ['src/old.js'], rejectCount: 1, status: 'archived' }))
+  // 对照组：热点卡在窗口内时确实命中（信号 a + d）
+  assert.ok(computeHealthHints(hot).length >= 2)
+  // 追加 50 张更新的普通卡，把热点挤出窗口
+  var all = hot.slice()
+  for (var j = 0; j < 50; j++) all.push(mk(100 + j, { claimedAt: iso(BASE + (100 + j) * MIN + MIN), resolvedAt: iso(BASE + (100 + j) * MIN + 2 * MIN) }))
+  assert.equal(all.length, 60)
+  assert.deepEqual(computeHealthHints(all), [])
+})
+
+// ===== 提示上限：最多 3 条，warn 优先 =====
+test('四信号同时命中时截断为 3 条（warn 优先）', function () {
+  var ts = []
+  // 8 张热点卡：touches src/hot.js（信号 a：8/14=57%）、各驳回 1 次（信号 d：累计 8 次）、滞留 30min、时长 100min
+  for (var i = 0; i < 8; i++) ts.push(mk(i, { touches: ['src/hot.js'], rejectCount: 1, claimedAt: iso(BASE + i * MIN + 30 * MIN), resolvedAt: iso(BASE + i * MIN + 100 * MIN) }))
+  // 6 张其他 touches 卡：滞留 30min、时长 100min（凑信号 b 样本与信号 c）
+  for (var j = 0; j < 6; j++) ts.push(mk(100 + j, { touches: ['src/other.js'], claimedAt: iso(BASE + (100 + j) * MIN + 30 * MIN), resolvedAt: iso(BASE + (100 + j) * MIN + 100 * MIN) }))
+  // 6 张无 touches 卡：滞留 3min、时长 100min（信号 b 对照组）
+  for (var k = 0; k < 6; k++) ts.push(mk(200 + k, { claimedAt: iso(BASE + (200 + k) * MIN + 3 * MIN), resolvedAt: iso(BASE + (200 + k) * MIN + 100 * MIN) }))
+  var hints = computeHealthHints(ts)
+  assert.equal(hints.length, 3)
+  assert.deepEqual(hints.map(function (h) { return h.level }), ['warn', 'warn', 'info'])
+  assert.ok(hints[0].text.indexOf('src/hot.js') >= 0)
+  assert.ok(hints[1].text.indexOf('驳回 8 次') >= 0)
+  assert.ok(hints[2].text.indexOf('并行度受锁限制') >= 0)
+})