dsh-workplan 1.8.3 → 1.8.18

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/client.js CHANGED
@@ -44,6 +44,8 @@ window.__ModuleLoader__.load({
44
44
  "helpTitle": "先看这三句",
45
45
  "helpWhat": "这件事",
46
46
  "helpWho": "现在谁在做",
47
+ /* [1.8.5] 「已结束」的计划下面不许再写「现在谁在做」。 */
48
+ "helpWhere": "停在哪一步",
47
49
  "helpNext": "接下来做什么",
48
50
  "helpNobody": "还没开始",
49
51
  "helpDone": "都做完了",
@@ -183,7 +185,7 @@ window.__ModuleLoader__.load({
183
185
  "scopeAll": "当前各会话最新计划汇总",
184
186
  "scopeThis": "本计划",
185
187
  "vizStageTitle": "分步进度",
186
- "vizWeighted": "总体进度(加权)",
188
+ "vizOverall": "总体进度",
187
189
  "allPlansHint": "上面是当前各会话最新计划的合计;历史计划不在此汇总,下面每张卡片只统计本计划。",
188
190
  "openHint": "打开左侧「任务进度」看完整安排。"
189
191
  },
@@ -215,6 +217,7 @@ window.__ModuleLoader__.load({
215
217
  "helpTitle": "Start with these three",
216
218
  "helpWhat": "This task",
217
219
  "helpWho": "Who is doing it now",
220
+ "helpWhere": "Where it stopped",
218
221
  "helpNext": "What happens next",
219
222
  "helpNobody": "Not started yet",
220
223
  "helpDone": "Everything is done",
@@ -354,7 +357,7 @@ window.__ModuleLoader__.load({
354
357
  "scopeAll": "Latest plan per live session",
355
358
  "scopeThis": "This plan",
356
359
  "vizStageTitle": "Step progress",
357
- "vizWeighted": "Overall progress (weighted)",
360
+ "vizOverall": "Overall progress",
358
361
  "allPlansHint": "These totals cover the latest plan in each live session; older plans are not included. Each card below counts only its own plan.",
359
362
  "openHint": "Open “Task progress” on the left for the full plan."
360
363
  }
@@ -1122,13 +1125,39 @@ window.__ModuleLoader__.load({
1122
1125
  return t('helpDone');
1123
1126
  return t('helpNobody');
1124
1127
  }
1128
+ /*
1129
+ * [1.8.5] 「谁在做」这三个字只能用在真的有东西在跑的时候。
1130
+ *
1131
+ * 事故(2026-10-30 21:38):计划已经「已结束,可续跑 · 卡住了」,卡片却仍写着
1132
+ * 「现在谁在做:研究分析 · 人性自私与利益博弈推演(卡住了)」,用户据此认为
1133
+ * 子智能体还在跑、报告和状态互相矛盾。同一句话在「没人跑」时应改口径为
1134
+ * 「停在哪一步」,把「现在进行时」换成「过去时」,不留误读空间。
1135
+ */
1136
+ function workerLabel(session, t) {
1137
+ const active = findEntry(session, 'in_progress');
1138
+ return active ? t('helpWho') : t('helpWhere');
1139
+ }
1125
1140
  /*
1126
1141
  * A blocked card used to read "卡住了" and stop there: no hint that the plan
1127
1142
  * is recoverable, so the only visible option was to restate the request and
1128
1143
  * build a fresh plan. Say out loud how to resume instead.
1129
1144
  */
1130
1145
  function resumeHint(session, t) {
1131
- if (!session || session.phase !== 'blocked')
1146
+ /*
1147
+ * [1.8.4] 谁承诺「可续跑」,谁就必须给出续跑方法。
1148
+ *
1149
+ * 旧实现只在 `phase === 'blocked'` 时给指令,而徽标在 ended 状态下拼的是
1150
+ * 「已结束,可续跑 · 卡住了」——同一张卡一边承诺能续跑,一边返回空字符串
1151
+ * 不给任何操作,这是事故截图里的第三处自相矛盾(T3 的互斥证据)。
1152
+ * 现在凡是徽标会说出「可续跑」的阶段(blocked / paused / ended 且原阶段
1153
+ * 是这类可续跑状态),一律给出同样的续跑指令。
1154
+ */
1155
+ if (!session)
1156
+ return '';
1157
+ const phase = String(session.phase ?? '');
1158
+ const suspended = String(session.suspendedPhase ?? '');
1159
+ const resumable = phase === 'blocked' || phase === 'paused' || (phase === 'ended' && (suspended === '' || suspended === 'blocked' || suspended === 'paused' || suspended === 'executing' || suspended === 'planning'));
1160
+ if (!resumable)
1132
1161
  return '';
1133
1162
  if (session.resumeAvailable) {
1134
1163
  const limit = Number(session.resumeLimit ?? 0);
@@ -1183,7 +1212,7 @@ window.__ModuleLoader__.load({
1183
1212
  function Guide({ session, t }) {
1184
1213
  const task = session.taskUnderstanding || {};
1185
1214
  const what = task.deliverable || session.title || t('panel');
1186
- return h('section', { className: 'dsh-wp-guide', 'aria-label': t('helpTitle') }, h('div', { className: 'dsh-wp-guide-title' }, t('helpTitle')), h('div', { className: 'dsh-wp-guide-body' }, h('div', { className: 'dsh-wp-guide-row' }, h('div', { className: 'dsh-wp-guide-label' }, t('helpWhat')), h('div', { className: 'dsh-wp-guide-value' }, what)), h('div', { className: 'dsh-wp-guide-row' }, h('div', { className: 'dsh-wp-guide-label' }, t('helpWho')), h('div', { className: 'dsh-wp-guide-value' }, workerText(session, t))), h('div', { className: 'dsh-wp-guide-row' }, h('div', { className: 'dsh-wp-guide-label' }, t('helpNext')), h('div', { className: 'dsh-wp-guide-value' }, nextText(session, t)))), h('div', { className: 'dsh-wp-guide-hint' }, t('helpHint')));
1215
+ return h('section', { className: 'dsh-wp-guide', 'aria-label': t('helpTitle') }, h('div', { className: 'dsh-wp-guide-title' }, t('helpTitle')), h('div', { className: 'dsh-wp-guide-body' }, h('div', { className: 'dsh-wp-guide-row' }, h('div', { className: 'dsh-wp-guide-label' }, t('helpWhat')), h('div', { className: 'dsh-wp-guide-value' }, what)), h('div', { className: 'dsh-wp-guide-row' }, h('div', { className: 'dsh-wp-guide-label' }, workerLabel(session, t)), h('div', { className: 'dsh-wp-guide-value' }, workerText(session, t))), h('div', { className: 'dsh-wp-guide-row' }, h('div', { className: 'dsh-wp-guide-label' }, t('helpNext')), h('div', { className: 'dsh-wp-guide-value' }, nextText(session, t)))), h('div', { className: 'dsh-wp-guide-hint' }, t('helpHint')));
1187
1216
  }
1188
1217
  function Pill({ children, tone = 'idle' }) {
1189
1218
  return h('span', { className: `dsh-wp-pill dsh-wp-tone-${tone}` }, h('span', { className: 'dsh-wp-dot' }), children);
@@ -1440,16 +1469,22 @@ window.__ModuleLoader__.load({
1440
1469
  return phase;
1441
1470
  }
1442
1471
  /*
1443
- * [1.5.2] 加权总进度的展示口径:未全部完成时封顶 99。
1472
+ * [1.8.4] 一张卡片的阶段只能有一个结论,且必须让「存活事实」拥有否决权。
1444
1473
  *
1445
- * 服务端 `deriveAggregates` 已做同样封顶;这里再算一次是为了让旧载荷/手工
1446
- * fixture 也守同一条不变量——「总体进度 100%」绝不能与「还有 N 项没完成」同屏。
1474
+ * 事故截图(2026-10-30 20:06:33)里同一张卡在「已结束」组,第 4 步却写着
1475
+ * 「正在做」。根因在后端(`turn/end` 早于异步派发结束),但展示层同样要能
1476
+ * 自保:服务端现在把 `running` 一起下发,这里据此兜一层——载荷同时说
1477
+ * 「已结束」和「派发仍在跑」时,以存活事实为准,绝不渲染「已结束」。
1478
+ * 老载荷没有 `running` 字段(undefined),行为保持原样。
1447
1479
  */
1448
- function planWeightedPercent(stats, counts) {
1449
- const weighted = clampPct(stats?.progress ?? 0);
1450
- if (counts.total > 0 && counts.done === counts.total)
1451
- return 100;
1452
- return Math.min(99, weighted);
1480
+ function sessionPhaseOf(session, counts) {
1481
+ const resolved = counts ?? planCounts(session?.stats || {});
1482
+ const phase = planPhaseOf(session?.phase || 'pending', resolved);
1483
+ if (phase === 'ended' && session?.running === true) {
1484
+ const suspended = String(session?.suspendedPhase ?? '');
1485
+ return suspended !== '' && suspended !== 'ended' ? suspended : 'executing';
1486
+ }
1487
+ return phase;
1453
1488
  }
1454
1489
  function planStatusMap(statuses) {
1455
1490
  const byId = new Map();
@@ -1657,7 +1692,7 @@ window.__ModuleLoader__.load({
1657
1692
  ? h('span', { className: 'dsh-wp-planviz-alarm' }, `${counts.blocked} ${t('stats.blocked')}`)
1658
1693
  : null, h('span', { className: 'dsh-wp-planviz-now', 'data-state': now.state }, h('span', { className: 'dsh-wp-planviz-now-dot', 'aria-hidden': 'true' }), h('span', { className: 'dsh-wp-planviz-now-text' }, now.text))), h(PlanSegments, { counts }), h(PlanLegend, { t, counts }), h(PlanStepper, { t, rows }));
1659
1694
  }
1660
- // 展开后的「分步进度」:逐阶段行 + 加权总体进度,替代旧的一根计划级进度条。
1695
+ // 展开后的「分步进度」:逐阶段行 + 总体进度(与环/组头同一个计数口径)。
1661
1696
  function PlanOverview({ t, stats, counts, rows }) {
1662
1697
  const stateOf = (tone) => (tone === 'done'
1663
1698
  ? t('stats.done')
@@ -1666,7 +1701,16 @@ window.__ModuleLoader__.load({
1666
1701
  className: 'dsh-wp-planoverview',
1667
1702
  'data-plan-total': String(counts.total),
1668
1703
  'data-plan-done': String(counts.done),
1669
- }, h('div', { className: 'dsh-wp-planoverview-head' }, h('span', { className: 'dsh-wp-planoverview-title' }, t('vizStageTitle')), h('span', null, `${counts.done}/${counts.total} ${t('stats.done')}`)), h('div', { className: 'dsh-wp-planoverview-stats' }, h('span', null, `${t('vizWeighted')} ${planWeightedPercent(stats, counts)}%`), h('span', null, `${counts.active} ${t('stats.inProgress')} · ${counts.pending} ${t('stats.pending')}`), counts.blocked > 0 ? h('span', null, `${counts.blocked} ${t('stats.blocked')}`) : null), rows.length
1704
+ }, h('div', { className: 'dsh-wp-planoverview-head' }, h('span', { className: 'dsh-wp-planoverview-title' }, t('vizStageTitle')), h('span', null, `${counts.done}/${counts.total} ${t('stats.done')}`)), h('div', { className: 'dsh-wp-planoverview-stats' },
1705
+ /*
1706
+ * [1.8.4] 一张卡只允许一个百分比口径。
1707
+ *
1708
+ * 这里以前显示加权进度,卡片其余位置显示计数百分比,于是同一张卡同时
1709
+ * 出现「73%」(环、组头、本计划 11/15)和「总体进度(加权)80%」——
1710
+ * 两者都算得对,但用户看到的是自相矛盾(T3 实测)。展示口径统一为
1711
+ * 计数百分比:它就是环、组头、图例共用的那个数,也是用户能数出来的数。
1712
+ */
1713
+ h('span', null, `${t('vizOverall')} ${counts.percent === null ? '—' : `${counts.percent}%`}`), h('span', null, `${counts.active} ${t('stats.inProgress')} · ${counts.pending} ${t('stats.pending')}`), counts.blocked > 0 ? h('span', null, `${counts.blocked} ${t('stats.blocked')}`) : null), rows.length
1670
1714
  ? h('div', { className: 'dsh-wp-planrows' }, rows.map((row) => {
1671
1715
  const width = row.total > 0 ? (row.done / row.total) * 100 : 0;
1672
1716
  return h('div', {
@@ -1693,7 +1737,7 @@ window.__ModuleLoader__.load({
1693
1737
  * 胶囊就必须是「已完成」,视觉档位也必须是 done。截图里那张卡之所以
1694
1738
  * 「100% + 正在收尾 + 留在进行中组」,就是因为这三个读者各读各的字段。
1695
1739
  */
1696
- const phase = planPhaseOf(session.phase || 'pending', counts);
1740
+ const phase = sessionPhaseOf(session, counts);
1697
1741
  const tone = phaseTone(phase);
1698
1742
  const departments = Array.isArray(session.departments) ? session.departments : [];
1699
1743
  const statuses = Array.isArray(session.statuses) ? session.statuses : [];
@@ -2104,7 +2148,7 @@ window.__ModuleLoader__.load({
2104
2148
  const counts = planCounts(stats);
2105
2149
  // 同一套计数与对账:柱状图的百分比、文案、色调都不得自成一套。
2106
2150
  const percent = counts.percent ?? 0;
2107
- const phase = planPhaseOf(session.phase || 'pending', counts);
2151
+ const phase = sessionPhaseOf(session, counts);
2108
2152
  const tone = phaseTone(phase);
2109
2153
  return h('button', {
2110
2154
  key: session.sessionId,
@@ -2179,7 +2223,7 @@ window.__ModuleLoader__.load({
2179
2223
  * 这正是本次事故的现象:会话结束 4 小时后仍显示「进行中」。
2180
2224
  */
2181
2225
  for (const session of activeSessions) {
2182
- const phase = planPhaseOf(session.phase, planCounts(session.stats));
2226
+ const phase = sessionPhaseOf(session);
2183
2227
  if (phase === 'done')
2184
2228
  finished.push(session);
2185
2229
  else if (phase === 'ended')
@@ -2203,7 +2247,7 @@ window.__ModuleLoader__.load({
2203
2247
  pending: 5,
2204
2248
  ended: 6,
2205
2249
  };
2206
- const rank = (session) => phaseRank[planPhaseOf(session.phase, planCounts(session.stats))] ?? 5;
2250
+ const rank = (session) => phaseRank[sessionPhaseOf(session)] ?? 5;
2207
2251
  live.sort((a, b) => (rank(a) - rank(b))
2208
2252
  || ((Number(b.createdAt) || 0) - (Number(a.createdAt) || 0))
2209
2253
  || String(a.sessionId).localeCompare(String(b.sessionId)));
@@ -2353,9 +2397,9 @@ window.__ModuleLoader__.load({
2353
2397
  * 「侧栏已完成 / 对话里正在收尾」之间再次自相矛盾。
2354
2398
  */
2355
2399
  const stats = session.stats || {};
2356
- const phase = planPhaseOf(session.phase || 'pending', planCounts(stats));
2400
+ const phase = sessionPhaseOf(session);
2357
2401
  const tone = phaseTone(phase);
2358
- return h('div', { className: `dsh-wp-turn dsh-wp-tone-${tone}` }, h('div', { className: 'dsh-wp-turn-title' }, h('span', null, session.title || t('panel')), h(Pill, { tone }, phaseLabel(phase, session, t))), h('div', { className: 'dsh-wp-muted', style: { marginTop: '6px' } }, `${t('helpWho')}:${workerText(session, t)}`), h('div', { className: 'dsh-wp-muted', style: { marginTop: '2px' } }, `${t('helpNext')}:${nextText(session, t)}`), h('div', { className: 'dsh-wp-progress-meta' }, h('span', null, `${stats.done ?? 0}/${stats.total ?? 0} ${t('stats.done')} · ${stats.blocked ?? 0} ${t('stats.blocked')}`), h('span', { className: 'dsh-wp-muted' }, t('viewHint'))));
2402
+ return h('div', { className: `dsh-wp-turn dsh-wp-tone-${tone}` }, h('div', { className: 'dsh-wp-turn-title' }, h('span', null, session.title || t('panel')), h(Pill, { tone }, phaseLabel(phase, session, t))), h('div', { className: 'dsh-wp-muted', style: { marginTop: '6px' } }, `${workerLabel(session, t)}:${workerText(session, t)}`), h('div', { className: 'dsh-wp-muted', style: { marginTop: '2px' } }, `${t('helpNext')}:${nextText(session, t)}`), h('div', { className: 'dsh-wp-progress-meta' }, h('span', null, `${stats.done ?? 0}/${stats.total ?? 0} ${t('stats.done')} · ${stats.blocked ?? 0} ${t('stats.blocked')}`), h('span', { className: 'dsh-wp-muted' }, t('viewHint'))));
2359
2403
  }
2360
2404
  function contentText(block) {
2361
2405
  if (!block || !Array.isArray(block.content))
@@ -0,0 +1,51 @@
1
+ # 复盘:「已结束 ∧ 正在做」同屏(2026-10-30,dsh-workplan 1.8.4)
2
+
3
+ ## 1. 时间线(全部来自原始事件日志,可复核)
4
+
5
+ | 时刻(本机 +08:00) | 事件 | 证据 |
6
+ |---|---|---|
7
+ | 19:52:50 | 事故会话第一个 `turn/start`(seq 5) | `session.v4.jsonl.zstd` |
8
+ | 19:58:39 | turn 1 `turn/end`(seq 254,`reason.kind=completed`) | 同上 |
9
+ | 20:06:33 | 用户截图:卡片已进「已结束」组,60%,第 4 步「正在做」 | 用户截图 |
10
+ | 20:16:37 | turn 2 `turn/start`(seq 261) | 日志 |
11
+ | 20:18:57 | turn 2 `turn/end`(seq 395) | 日志 |
12
+ | 20:22:50 | 计划结果写入(seq 396,`phase=blocked`,11/15,4 blocked) | 日志 |
13
+
14
+ 关键事实:**20:06:33 处于两个回合之间,没有任何打开回合,但计划仍在推进**
15
+ (20:06:33 是 9/15、1 正在做;20:22:50 落成 11/15、4 卡住)。所以「已结束」不是文案错,
16
+ 而是判定依据错。
17
+
18
+ ## 2. 5-Why
19
+
20
+ 1. 为什么同一张卡既说「已结束」又说「正在做」?——载荷同时携带 `phase='ended'` 与
21
+ `statuses` 里的 `in_progress`。
22
+ 2. 为什么 `phase` 会是 `ended`?——`serialisePlan` 只看最后一个 `turn/start|turn/end`,
23
+ 判定「本轮已结束」,就把未完成计划的阶段改写成 `ended`。
24
+ 3. 为什么「回合结束」不等于「没东西在跑」?——1.7.0 引入 async 派发(`cb40b7a`),
25
+ 派发在宿主回合结束后继续执行,结算可以晚数分钟。
26
+ 4. 为什么插件没发现自己在跑?——存活信号 `record.dispatchPromise` 早就存在,且
27
+ `dispatchStatus` 已经用它算 `running`,但 `serialisePlan` 的 ended 改写块没读它,
28
+ 载荷也不下发 `running`。**同一个进程里有两套「是否在跑」的判据,展示层拿到的是弱的那套。**
29
+ 5. 为什么直到用户截图才发现?——没有任何断言检查「ended 载荷里不许有 in_progress」;
30
+ 而 `tests/ended-group.test.ts:193` 反而把「卡住的计划结束后仍然报需处理」固化成期望行为。
31
+
32
+ 系统层原因:状态事实有多个宣告者(宿主回合、派发结算、客户端计数派生),但**没有仲裁规则**
33
+ 和**出口收敛**;一旦异步派发把两个宣告者的时间拉开,矛盾就必然出现。
34
+
35
+ ## 3. 已落地的防复发措施
36
+
37
+ | 措施 | 落点 | 如何验证 |
38
+ |---|---|---|
39
+ | 存活事实优先:有活派发不得进 `ended`,`running` 随载荷下发 | `src/runtime.ts` `serialisePlan` | `tests/ended-live-dispatch.test.ts` 用例 1 |
40
+ | 出口收敛:ending 时残留 `in_progress` 改判 `blocked`(只改下发副本) | `settleStaleInflight` | 用例 3、4、5 |
41
+ | 新不变量 I11:`ended` 且 `inProgress>0` 判红 | `src/plan.ts` `aggregateInvariantViolations` | 用例 6 |
42
+ | 展示层自保:`running===true` 时不得渲染「已结束」 | `src/client.ts` `sessionPhaseOf` | `tests/client-resume-hint.test.ts` |
43
+ | 承诺与操作一致:徽标说「可续跑」,卡片必须给续跑方法 | `resumeHint` | 同上 |
44
+ | 单一百分比口径:分组/环/展开页取同一个计数 | `PlanOverview` | 事故日志离线渲染:只有「总体进度 73%」 |
45
+
46
+ ## 4. 仍待观察(未验证,不当结论)
47
+
48
+ - 重启后 `GET /dsh-workplan/plans` 的实机载荷(本机该端点需进程内凭据,未取像素级证据)。
49
+ - `dsh-context` 的 Fleet「任务进度」是第二个同名表面,是否也读 `turn/end` 判存活未审查完。
50
+ - `billion-context` 改写会话消息是否可能丢弃 workplan 标记、`delivery-accepted.throughSeq`
51
+ 停在某个序号之后的语义——均未证实。
@@ -0,0 +1,385 @@
1
+ # 复盘:计划没做完就把中间结果当成品交付(2026-10-31,dsh-workplan 1.8.7)
2
+
3
+ ## 0. 结论先行
4
+
5
+ 用户看到的现象是真的:会话
6
+ `session-99984ebd-7d13-47d5-87a0-e9ba7271b883` 在计划只完成 **10/13** 时
7
+ `present` 了报告并结束回合;第二个回合把进度改成 **11/13** 后再次结束,
8
+ T12、T13 从此再没执行。这不是用户误判,也不是「报告写得好不好」的问题,
9
+ 而是**「完成」的判据分散在四处、且没有任何一处能在回合边界上强制生效**:
10
+
11
+ | 谁在宣告「完成」 | 当时的实际行为 | 缺陷 |
12
+ |---|---|---|
13
+ | 结果消息(`buildResultMessage`) | 第 3 条命令「给出最终答复」,第 4 条又命令「再派发续跑」 | 两条命令互斥,模型照前者收尾 |
14
+ | 工具返回(dispatch render/schema) | `ok:true` +「已加入进行中的派发并等到结果」 | 没有 `complete` 字段,暂停读起来像成功 |
15
+ | 系统提示词(`PROMPT_SECTION`) | 只有「不要声称未经验证的完成」 | 没有「未完成禁止交付」的硬规则 |
16
+ | 回合边界(官方 `agent/turn-stopping`) | 插件**没有订阅**该事件 | 模型随时可以收尾,没有强制点 |
17
+
18
+ ## 1. 时间线(全部来自原始事件日志,可复核)
19
+
20
+ 证据文件:`~/.dsh/sessions/--Users-open-Documents-Stocks--/`
21
+ `session-99984ebd-7d13-47d5-87a0-e9ba7271b883/session.v4.jsonl.zstd`
22
+ (658,957 字节;解压后 598 个事件)。计划 ID:`wp-66f57fa3-fc71-4f8e-b8dd-b3e67c279467`。
23
+
24
+ | 时刻(本机 +08:00) | 事件 | 证据 |
25
+ |---|---|---|
26
+ | 11:41:34 | turn 1 `turn/start`(真实任务回合) | 会话日志 |
27
+ | 11:42:54 | 首个工具调用 `dsh_workplan_dispatch({"mode":"async"})`(seq 25) | 会话日志 |
28
+ | 11:46:44 | 主 Agent 先写出一版报告 `159667_2026年11月走势预判报告.md` | 会话日志 |
29
+ | 11:48:54 | 再调 `dsh_workplan_dispatch({"mode":"wait"})`,阻塞约 14 分钟 | 会话日志 |
30
+ | 11:49:19–12:00:12 | 后台依次创建 T8/T9/T10/T11 四个子 Agent;T11(排版设计)到预算点仍在跑 | `subagent/catalog` 事件 |
31
+ | 12:02:54 | 派发返回:**「本轮预算用尽,可续跑(完成 10/13,受阻 0)|已加入进行中的派发并等到结果」** | `tool/result` 原文 |
32
+ | 12:02:54 | 同一秒注入「【部门执行结果】完成 10/13,受阻 0,请主 Agent 核对并整合」,正文含「3. 给出最终答复」与「4. 再次调用 dsh_workplan_dispatch」 | `user/message`,`source.kind=workplan-result` |
33
+ | 12:03:08–12:03:54 | 模型修正报告日期/权重/表格,未再派发 | 会话日志 |
34
+ | 12:04:22 | `present` 报告(`deliverables/presented`) | 会话日志 |
35
+ | 12:04:25 | turn 1 `turn/end`,`reason.kind=completed`(计划 10/13) | 会话日志 |
36
+ | 12:12:34 | T11 完成通知(`subagent-settled`)触发 turn 2 `turn/start` | 会话日志 |
37
+ | 12:13:10 | 报告 E/G/I 行改为「11/13(T1–T11)」;T12/T13 未跑 | 会话日志 |
38
+ | 12:13:16 | turn 2 `turn/end`,`reason.kind=completed`(计划 11/13) | 会话日志 |
39
+ | 之后 | 没有第三个回合;计划永久停在 11/13 | 事件流结束 |
40
+
41
+ 用户在 12:04 之后拿到的是「已 present 的报告 + 收尾性答复」;计划卡片同时显示
42
+ 「已结束 · 本轮预算用尽,可续跑」。**聊天里的成品口径与卡片里的未完成口径不一致,
43
+ 而用户读的是聊天。**
44
+
45
+ ## 2. 5-Why
46
+
47
+ 1. **为什么用户在没做完时看到了结果?**
48
+ 因为 12:04:22 调用了 `present`、12:04:25 回合以 `completed` 关闭,而计划
49
+ `10/13`;12:13 的第二回合又以 `11/13` 关闭。
50
+ 2. **为什么模型会认为可以收尾?**
51
+ 模型收到的结果消息第 3 条就是「给出最终答复」;工具返回 `ok:true` 且写着
52
+ 「已加入进行中的派发并等到结果」,没有任何字段说明「还剩 3 项」。
53
+ 3. **为什么结果消息会自相矛盾?**
54
+ `buildResultMessage` 把「核对证据 / 处理受阻 / 给出最终答复」写死成职责清单,
55
+ 未完成分支再追加第 4 条「再次派发」;`buildResultSummary` 也固定写
56
+ 「请主 Agent 核对并整合」。**同一份控制消息里同时存在「收尾」和「续跑」两条命令。**
57
+ 4. **为什么没有任何机制拦住收尾?**
58
+ 插件只订阅 `agent/pre-step`,不订阅回合结束事件;官方提供的
59
+ `agent/turn-stopping`(serial、边界提交前 await、监听器可 `agent.steer()`
60
+ 让机器重读 inbox)完全没有被使用。预算暂停只是文案上的「可续跑」。
61
+ 5. **为什么没有回归测试发现?**
62
+ 1.8.4 只修了「已结束 ∧ 正在做」(I11),`workplan-budget-pause.test.ts`
63
+ 只断言暂停后的状态列表,从不断言「未完成时给模型的指令是什么」。
64
+
65
+ 系统层原因:**「完成」有四个宣告者(模型叙述、工具返回、状态列表、回合边界),
66
+ 但没有任何仲裁规则;唯一有强制力的边界事件没有被订阅。** 只要异步派发把
67
+ 「预算到点」和「子任务结算」的时间拉开,这个缺口就必然被踩中。
68
+
69
+ ## 3. 已落地的修复(1.8.7)
70
+
71
+ | 层 | 改动 | 落点 | 验证 |
72
+ |---|---|---|---|
73
+ | 结果消息 | 未完成时首句「未完成:完成 d/t,剩余 N 项」;职责第 3 条改为「【未完成,禁止交付】」,恢复动作固定为第 4 条;只有全 done 才出现「给出最终答复」 | `src/plan.ts` `buildResultSummary` / `buildResultMessage` | `tests/workplan-turn-stop-gate.test.ts` 用例 1、2 |
74
+ | 收尾指令 | 新增 `buildStopSteerText()`:说清剩余量/ID、禁止 present 与「已完成」措辞、给出唯一恢复动作 | `src/plan.ts` | 用例 3 |
75
+ | 工具返回 | render 分三态:「已开跑,尚未完成」/「未完成:完成 d/t,剩余 N 项」/「已完成」;schema 增加 `complete`、`remaining`;工具描述写明 `complete=false` 必须续跑 | `src/host.ts` `createDispatchTool`;`src/runtime.ts` `dispatchToolOutputSchema`、`completionFields` | `npm run check` + 用例 2 |
76
+ | 提示词 | 新增第 5、6 条:完成唯一判据是全部 done;`ok:true` 不等于完成;未完成禁止 `present`/「已完成」/收尾答复;确有阻碍时答复开头必须写「未完成:剩余 N 项与原因」 | `src/host.ts` `PROMPT_SECTION` | `tests/workplan-host.test.ts` |
77
+ | 回合边界 | 新增 `onTurnStopping` 并注册到官方 `agent/turn-stopping`:仍有未完成项时先等正在跑的派发,再 `agent.steer()` 注入「计划没做完,这个回合不关闭」;每回合最多 2 次;全 done/已取消/非任务回合直接放行 | `src/runtime.ts`、`src/host.ts` | 用例 4、5、6 |
78
+
79
+ ## 4. 为什么这次能真正阻断
80
+
81
+ `agent/turn-stopping` 的语义(`@deepseek-ai/dsh-agent` 的
82
+ `lib/types/runtime-types.d.ts` 原文):
83
+
84
+ > Awaited before the boundary commits — a listener that objects steers
85
+ > (`agent.steer(...)`) and the machine re-reads its inbox: fresh steering runs
86
+ > another step, none closes the turn.
87
+
88
+ 即:监听器在边界提交前被 await;只要 `steer` 注入新消息,机器会多跑一步而不关闭
89
+ 回合。同仓的 `@deepseek-ai/dsh-workspace-changes` 就注册在插件根 `ctx` 上
90
+ (`lib/index.js:1067`),证明该 agent 作用域事件能到达根监听器。**提示词和文案
91
+ 只能说服模型,这个事件能拦住收尾本身——两者叠加才是根治。**
92
+
93
+ ## 5. 仍待验证 / 残余风险(不当结论)
94
+
95
+ - `agent/turn-stopping` 的实机行为尚未在本机重启后的 `dsh web` 上复现验证
96
+ (插件在 `dsh web` 启动时加载,**必须重启一次才生效**)。当前只有类型定义、
97
+ `dsh-agent-loop` 源码与同仓用例三处间接证据。
98
+ - `state.activeTurns` 只在「真实任务回合」置位;由用户一句「继续」触发的回合
99
+ 不会置位(`isVagueContinuation` 提前返回)。1.8.8 已用
100
+ `turnCarriesPlanWork()` 补上「子 Agent 结算 / workplan 结果 / 续跑指令」
101
+ 唤醒的回合,但纯人工「继续」回合仍不 steer;该回合的 `present` 仍会被工具级
102
+ 闸门拒绝,纯文本收尾则只受提示词第 5、6 条约束。
103
+ - 每回合最多 2 次 steer:极端情况下第三轮仍可能带着未完成项收尾;此时界面与
104
+ 文案会明确写「未完成」,但不会无限阻止模型结束回合。
105
+ - 事故会话本身仍停在 11/13;如需补齐 T12/T13,应对主 Agent 说「续跑这个计划」。
106
+ - 客户端卡片仍沿用「已结束 · 本轮预算用尽,可续跑」;本轮未改卡片措辞,只保证
107
+ 聊天答复不再冒充成品。
108
+
109
+ ## 6. 复现与验证命令
110
+
111
+ ```bash
112
+ cd /Users/open/Documents/Stocks/plugins/dsh-workplan
113
+ npm run check # tsc --noEmit,期望无输出
114
+ npm test # 期望 220 tests / 220 pass / 0 fail
115
+ git log --oneline -3 # 期望看到本次 1.8.7 提交
116
+ ```
117
+
118
+ ## 7. 1.8.8 补丁:补上审计发现的第二个绕过路径
119
+
120
+ 1.8.7 上线后,审计计划 `wp-6753e19f` 的 T7 复核事故 turn 2 时发现:1.8.7 的闸门
121
+ 只覆盖「有真实任务标记的回合」,而事故的第二个回合是被 T11 子 Agent 的结算通知
122
+ (`subagent-settled`)唤醒的——`humanMessages()` 只认人类 `user` 消息,`maybePlan`
123
+ 在这类回合提前返回,`state.activeTurns` 没有置位,`onTurnStopping` 首行即放行。
124
+ 同时 `present` 仍只有提示词约束,没有工具级拦截。两条合起来,正是事故里
125
+ 「11/13 收尾 + 呈现半成品」的完整路径(H9、H10)。
126
+
127
+ 1.8.8 的补法:
128
+
129
+ - **H9**:新增 `turnCarriesPlanWork(session, turn, record)`,从 `session.seq - 1`
130
+ 回扫本回合事件,识别 `subagent-settled` / `workplan-result` /
131
+ `workplan-continue` 三类来源;`subagent-settled` 还要求
132
+ `source.senderSessionId` 属于本计划的子会话,无关子 Agent 的结算不会误激活。
133
+ `onTurnStopping` 改为「不在本回合任务标记里 **且** 本回合不携带计划工作」才放行。
134
+ - **H10**:新增 `presentDenialReason(agent)`,在 `src/host.ts` 的
135
+ `ctx.tools.guard` 中对 `present` 执行前拦截;根会话计划未完成即拒绝,文案列出
136
+ 剩余项,并给出「先续跑 / 确实无法继续先 `dsh_workplan_cancel`」两条出路。
137
+ - **附带**:全部剩余项都 blocked 时不再空转 steer(没有可运行子任务,steer 只会
138
+ 消耗回合),但 `present` 仍被拒绝。
139
+
140
+ 验证:`npm run check` 无诊断;`npm test` 220/220;`npm run build` 五个产物
141
+ sha256 前后一致。运行中的 `dsh web` 仍需重启后生效。
142
+
143
+ ## 8. 1.8.9 补丁:重启后的进度回退与剩余两条绕过路径
144
+
145
+ 1.8.8 上线、用户重启 Web 服务后,`wp-6753e19f` 从 13/14 退回 5/14。根因不在
146
+ 写入而在回放:`reconstructFromSession` 只有一组 `plan/statuses`,会话里出现
147
+ 第二个计划(「继续」被误判生成的 `wp-dd26f206`,seq 1223)时,前一个计划被
148
+ 压进冻结快照并停止接收后续事件。`wp-6753e19f` 迟到的 7/14 结果(seq 1337)
149
+ 与六条 T9–T14 的 `done` 改判(seq 1517–1532)因 `planId` 不匹配被丢弃,
150
+ 重启后永远回到冻结时的 5/14。
151
+
152
+ 1.8.9 的补法:
153
+
154
+ - **回放按 planId 分账**:`ReplaySnapshot` 以 `plan.planId` 为键;`plan` /
155
+ `result` / `update` / `cancel` 与 `dsh_workplan_update` 的工具调用都按载荷
156
+ 里的 `planId` 路由,`targetPlanId` 显式指定时优先返回该计划。用 1657 事件的
157
+ 真实日志重放,`wp-6753e19f` 恢复为 13/14(仅 T5 blocked)。
158
+ - **结算回合按会话谱系认亲**:预算暂停把未完成项重置为 `pending`,而
159
+ `normaliseStatusEntry` 对 `pending` 强制清空 `childId`(不变量 I6 也不允许
160
+ `pending` 携带 `childId`)。事故里的 T11 因此从 `planChildIds` 消失。新增
161
+ `isChildSessionOf()`,用 `header.parentSession` 判定谱系,不再依赖易失字段。
162
+ - **`present` 的证据硬缺口**:全部 `done` 但存在 `verification === 'failed'`、
163
+ `acceptance[].result === 'fail'` 或非空 `missingArtifacts` 时,`present` 在
164
+ 执行前被拒绝,并提示先 `dsh_workplan_update` 补证或改回 `blocked`。
165
+ `legacy`/无结构化证据属于软缺口,仍由提示词与结果消息约束;拦死它们会让
166
+ 旧计划永久不可交付,只剩 `cancel` 一条路,是新的死锁。
167
+
168
+ 验证:`npm run check` 无诊断;`npm test` 223/223;新增三条回归用例
169
+ (回放分账、`childId` 清空后的结算拦截、`present` 证据缺口)。
170
+
171
+ 残余:取消计划后 `planIncomplete` 为 `false`,`present` 会放行(当前语义是
172
+ 「取消即只交付中间结果,正文须写明未完成」);`status === 'done'` 但
173
+ `acceptance` 为空时仍按结构化证据接收,只能靠自检失败拦住明确错误的证据。
174
+
175
+ ## 9. 1.8.10 补丁:回放窗口越过 plan 消息
176
+
177
+ 1.8.9 的按 planId 分账在短日志上验证通过,但重启后对 `wp-6753e19f` 仍然
178
+ 返回最新计划。原因是回放窗口固定为最近 `MAX_HISTORY_EVENTS`(2000)个事件,
179
+ 而本会话已增长到 2256 个事件,`wp-6753e19f` 的 plan 消息在 seq 22,早已在
180
+ 窗口之外:`ensure()` 从未执行,快照不存在,`reconstructFromSession` 返回
181
+ `null`,`status` 与 `dispatch` 一起退回内存里的新计划。
182
+
183
+ 1.8.10 在显式传入 `targetPlanId` 且窗口内找不到该计划时,从窗口起点向前
184
+ 扫描 plan 消息,把回放起点前移;默认回放不变。同一份 2256 事件日志重放
185
+ `wp-6753e19f` 得到 13/14(仅 T5 blocked)。`npm run check` 无诊断;
186
+ `npm test` 224/224。
187
+
188
+ 残余:默认回放仍只保证最新计划,多计划并存的会话里续跑旧计划必须显式传
189
+ `planId`。
190
+
191
+ ## 10. 1.8.11 补丁:真实生命周期下的谱系与重复回放
192
+
193
+ 1.8.9 的谱系判定与 1.7.0 的改判回放各有一个只有在真实生命周期里才暴露的
194
+ 缺陷,由 1.8.10 的重启后核验(wp-91b6a96b 的 T3、T7)定位:
195
+
196
+ - **谱系判定在结算消息到达时必然失效。** `dsh-subagent` 的
197
+ `finishDisposal` 先 `await activation.handle.dispose()`(`lib/index.js:2026`),
198
+ 之后才 `notifySettlement`(`:2040`)。父会话收到 `subagent-settled` 时,
199
+ 子会话已从 live 存储移除,`ctx.sessions.get(senderId)` 恒为 `undefined`。
200
+ 1.8.9 的 `isChildSessionOf()` 因此从未在真实生命周期里成立,事故 turn 2
201
+ 的路径仍可绕过闸门;T7 探针 A1a(真实 dispose 顺序)测得 steered:0。
202
+ - **人工改判被回放两次。** 一次 `dsh_workplan_update` 同时留下 durable
203
+ `workplan-update` 消息与配对的 `tool/result`。回放先按消息应用
204
+ (revision 4、`updatedBy: agent`),再按工具结果应用一次
205
+ (revision 5、`updatedBy: system`、summary 被覆盖),T3 在六个 `done`
206
+ 改判上复现。
207
+
208
+ 1.8.11 的补法:
209
+
210
+ - 认亲增加第三来源:父会话自己的 `subagent/catalog` 事件(spawn 时追加,
211
+ 重启、回放、预算重置都不改写)。顺序为 childId → live 谱系 → spawn 记录;
212
+ 三处都不命中才放行。扫描按 `session.seq` 缓存,避免每回合 O(n) 重扫。
213
+ - 回放记录每条 durable 改判的 seq 与状态;配对 `tool/result` 在其后且状态
214
+ 相同时跳过第二次 `applyStatus`。durable 消息缺席时仍由 `tool/result`
215
+ 独立生效,保持 1.6.0 的容错语义。
216
+
217
+ 验证:`npm run check` 无诊断;`npm test` 228/228(新增 3 条:dispose 后按
218
+ spawn 记录认亲、三处都无记录不激活、人工改判只写一次)。
219
+
220
+ 残余:`subagent/catalog` 只能证明「本会话 spawn 过它」,不能证明「它属于
221
+ 该计划」;同一会话里两个未完成计划并存时,任一子 Agent 结算都可能让闸门
222
+ 为当前记录 steer。这个偏差不会放行未完成交付,只会多要求一次续跑。要彻底
223
+ 消除,需要把 childId→planId 的归属在 spawn 时持久化(1.8.12 候选)。
224
+
225
+ ## 11. 1.8.15:取消终态、长会话回放与 present 的计划选择
226
+
227
+ 1.8.14 发布后,三份独立复核(T4e 取消语义、T5c 运行态身份、T3 边界地毯)
228
+ 在 1.8.13 / 1.8.14 字节上又测到四类缺陷:
229
+
230
+ - **取消后 dispatch 仍会启动部门 Agent。** `dispatchTool` 只检查内存里的
231
+ `record.phase`,取消只把计划标成 cancelled,并没有把派发入口关死;
232
+ `activationCalled: true`、`ok: true`,2/2 全 done 的 cancelled 计划还会被
233
+ 静默改写成 `phase: 'done'`。
234
+ - **派发途中第二次取消再写一条取消消息。** 幂等守卫要求
235
+ `!record.dispatchPromise`,而取消正发生在派发进行中,守卫被绕过。
236
+ - **已取消回合的结果消息仍教「继续派发」。** 摘要与第 3/4 条职责不带取消
237
+ 分支,与 stop-steer 的「不要 dispatch」自相矛盾(T4e F3、T3 C14/C15)。
238
+ - **长会话默认回放返回 null。** `MAX_HISTORY_EVENTS = 2000` 的窗口起点可能
239
+ 落在计划消息之后,`reconstructFromSession` 返回 null,`present` 看不到计划
240
+ 而静默放行(T3 B4)。另外 `buildHash` 未覆盖 `lib/watchdog.js`,
241
+ `/dsh-workplan/plans` 载荷没有版本身份(T5c)。
242
+
243
+ 1.8.15 的补法:
244
+
245
+ - `dispatch` 对 `cancelled` 计划返回 `ok: false / code: 'PLAN_CANCELLED'`,
246
+ 在启动任何子 Agent 之前返回。
247
+ - `cancelPlan` 在派发途中记录 `abortRequested`;第二次取消返回
248
+ `alreadyCancelled: true`,不再追加 durable 消息。
249
+ - `buildResultSummary` / `buildResultMessage` 增加取消分支:只完成 X/Y 时
250
+ 明确「已取消,不得交付」,并禁止再次派发。
251
+ - 默认回放窗口向前回扫到最后定义的计划消息;**默认契约仍是「最后定义」**,
252
+ 因为同一个默认答案也喂给 `dispatch`,改成「最后活动」会让旧计划截获新任务
253
+ 的派发目标。`present` 改为优先按本回合消息点名的 `planId` 重建
254
+ (`currentTurnOf` + 已有的 `planIdFromTurn`),从而在 A 定义、B 后定义、
255
+ A 的结果最后到达时判 A 而不是 B。
256
+ - `buildHash` 纳入 `watchdog.js`;`plansPayload` 返回 `version` 与 `runtime`。
257
+
258
+ 验证:`npm run check` 无诊断;`npm test` 252/252(新增
259
+ `tests/workplan-1815-guards.test.ts` 6 条,覆盖上述四类缺陷与身份字段)。
260
+
261
+ 残余:P3 cancelled 后 present 的拒绝由 `deliveryReadiness` 统一承担,测试
262
+ 钉住的是「拒绝 + 文案」;没有活体会话内的端到端 present 证据。默认回放与
263
+ `present` 的「本回合计划」判定依赖会话日志里的 `turn/start` 与结算消息,
264
+ 日志被归档/截断的会话只能退回默认回放。
265
+
266
+ ## 12. 1.8.16:present 必须检查整个会话的计划
267
+
268
+ 1.8.15 交付后,本会话做了一次活体 E2E:直接调用 `present` 交付根因报告。
269
+ 当时 `wp-6753e19f` 仍是 13/14(T5 blocked),但 `present` **成功返回**。
270
+ 原因不是闸门没写,而是它只判「本回合消息点名的计划 / 最后定义的计划」——
271
+ 而本会话最后定义的计划 wp-4038784e 已经 7/7 就绪,于是闸门看了一个已完成
272
+ 的计划,放过了另一个未完成的计划。
273
+
274
+ 这与事故现场是同一类错误:交付动作与「真正未完成的那份工作」之间没有绑定。
275
+ 1.8.16 的补法:
276
+
277
+ - `sessionPlanRecords(session)` 扫描整份会话日志,收集所有出现过的
278
+ `planId`,逐个用显式 planId 重建(`reconstructFromSession(session, id)`
279
+ 自带窗口回扫),得到每个计划的当前状态。
280
+ - 闸门对所有**非取消且未就绪**的计划求并集:只要还有一个,就拒绝
281
+ `present`,并在文案里逐条列出计划、完成数、剩余子任务与证据缺口。
282
+ - 已取消的计划不参与「阻塞其他计划」的并集——事故会话里会累积永远不再
283
+ 推进的取消计划,若让它们永久阻塞,交付将死锁。但若取消的计划正是本回合
284
+ 或当前记录所指的那一个,仍按「已取消 ≠ 可交付」拒绝(T5-C 语义不变)。
285
+
286
+ 验证:`npm run check` 无诊断;`npm test` 253/253(新增一条多计划用例);
287
+ 构建产物 sha256 前后一致。
288
+
289
+ 残余:`present` 没有参数声明「本次交付属于哪个计划」,所以只能按会话级
290
+ 保守规则判断。若未来引入多计划并行交付,需要在 `present` 载荷里显式携带
291
+ planId,或把产物与计划建立持久关联。
292
+
293
+ ## 13. 1.8.17:回放记录缺 `errors` 字段导致整轮假受阻
294
+
295
+ 17:51:37,`wp-40ce5eee` 的派发在 20 分钟预算边界中止,结果消息把 T5–T10
296
+ 六项全部标成
297
+
298
+ ```
299
+ error: record.errors is not iterable
300
+ ```
301
+
302
+ 其中 T5、T6、T7 已经启动了真实的子 Agent,T8–T10 还没轮到——它们不是失败,
303
+ 是被一个 `TypeError` 连坐。
304
+
305
+ 直接原因:
306
+
307
+ 1. 宿主在 17:30:21 重启,内存里没有 `wp-40ce5eee` 的记录;
308
+ 2. `dispatchTool` 走 `needsRebuild`,用 `reconstructFromSession` 从会话日志
309
+ 重建记录;
310
+ 3. 重建返回的对象有 `plan/statuses/phase/createdAt/…`,没有 `errors`;
311
+ 4. 预算到点,`disposeActivation` 在清理子任务时写
312
+ `record.errors = [...record.errors, `${subtaskId} dispose: …`]`;
313
+ 5. 展开 `undefined` 抛出 `TypeError: record.errors is not iterable`,冒到本轮
314
+ 调度器的 catch,把剩余子任务统一记为 blocked。
315
+
316
+ 这条链与事故现场的同类之处:**两条数据源(实时缓存 / 日志回放)形状不一致,
317
+ 失败在边界上被放大成「其余全部失败」**。回放是为了让重启后的计划还能继续,
318
+ 但它返回的记录比内存记录少一个字段,于是本该继续的那一轮被自己拦死。
319
+
320
+ 修复(1.8.17):
321
+
322
+ - `ReplaySnapshot` 增加 `errors: string[]`;回放结果消息时并入
323
+ `result.errors`(最近 20 条);返回的记录始终带 `errors` 数组。
324
+ - 所有 `[...record.errors, …]` 展开点补 `?? []`,覆盖 dispose 失败、重试说明、
325
+ 剩余预算不足、子任务超时、超时写状态失败、预算收尾、错误记录七处。
326
+ - `tests/workplan-replay-errors.test.ts` 两条:回放记录始终有 `errors` 数组并
327
+ 保留 durable 失败行;回放记录再派发时子任务失败只记错、不炸整轮。
328
+
329
+ 验证:`npm run check` 无诊断;`npm test` 255/255;构建前后 5 个产物 sha256
330
+ 一致。
331
+
332
+ 残余:这次崩溃发生在「预算中止 + dispose 失败」的组合路径上;如果未来新增
333
+ 记录字段,仍可能出现「实时缓存有、回放没有」的同类漂移。更彻底的补法是让
334
+ 两条路径共用同一个 record 工厂,或在回放结束时跑一次形状校验(schema
335
+ assertion)。这一条尚未实施。
336
+
337
+ ## 14. 1.8.18:空计划、取消后重启与已交付文件的写保护
338
+
339
+ 1.8.16 的全计划 `present` 闸门解决的是「看哪一个计划」,1.8.18 解决的是
340
+ 「计划本身还算不算交付对象」以及「交付之后文件还能不能被改」。
341
+
342
+ ### 14.1 空计划(U6)
343
+
344
+ `deliveryReadiness` 的 `ready = total > 0 && …` 意味着 `stages: []` 的计划
345
+ 永远到不了 ready;而 `present` 的候选集只看「是否 done/是否 ready」,于是
346
+ 空计划会以「0 个子任务虽都已 done」的错文案被永久拒绝。空计划不是正常
347
+ 规划能产出的(`validatePlan` 会拒),只可能来自畸形历史消息;把它当交付对象
348
+ 判定没有意义。修复:`definedSubtaskCount(plan)` 决定候选是否参与闸门,空计划
349
+ 放行;畸形到无法计算定义的,按「不可判断」继续 fail-closed。
350
+
351
+ ### 14.2 取消后重启(T5 E1/E6)
352
+
353
+ 取消工具自己的契约写着「取消后如仍有未完成项或证据缺口,present 仍会被拒绝」。
354
+ 但在「取消未完成计划 → 重启宿主 → present」这条序列上,回放时 live record 与
355
+ 本回合计划都不存在,候选集为空,闸门直接放行。修复:`lastGateablePlanRecord()`
356
+ 回退到最近一个定义了工作的计划,被取消但未完成的计划因此仍拒绝;同时保留
357
+ 两条不变量——较新的已就绪计划不被历史取消项阻塞,空计划不能当挡箭牌。
358
+
359
+ ### 14.3 已交付文件的写保护(T7-N2)
360
+
361
+ `present` 不复制内容(工具描述原文:the user opens the current files),
362
+ `write`/`edit` 也不校验路径是否已交付。事故的迟到回合在 12:04 出卡后,于
363
+ 12:13 两次原地改写同一份报告,用户点开的卡片背后内容已经变了。修复:
364
+ `present` 时把「当时已定义的计划 id + 路径」记进快照;新增
365
+ `fileWriteGuardReason`,在根会话对同一路径的 `write`/`edit`/
366
+ `str_replace_editor` 检查这些计划是否仍未就绪,未就绪则拒绝并给出续跑 /
367
+ 取消 / 重新 present 的出口。present 之后新建的计划不在快照里,避免把正常
368
+ 改版卡死。
369
+
370
+ ### 14.4 验证
371
+
372
+ - `tests/present-gate-evidence.test.ts` 8 条:A1/A2 回归事故形状,A3 空计划,
373
+ A4 plan 模式防死锁,A5 按定义过滤,A6 取消后重启仍拒,A7 历史取消不阻塞,
374
+ A8 空计划挡箭牌无效。
375
+ - `tests/workplan-presented-write-guard.test.ts` 7 条:拒绝与出口、路径归一、
376
+ 新计划放行、就绪放行、取消放行、非根会话/plan 模式放行、只接管三个写工具。
377
+ - `npm run check` 无诊断;`npm test` 270/270;两次构建 5 个产物 sha256 一致。
378
+
379
+ ### 14.5 残余
380
+
381
+ - 写保护只覆盖根会话的直接写工具调用;shell 重定向、符号链接、子会话写入
382
+ 不在覆盖内(已在 T7 §9.7 列明)。
383
+ - 落码后尚未在运行实例验证:补丁未提交前进程仍加载 1.8.17,活体写拒绝与
384
+ `present` 行为要等重启后按 T7-N3 清单跑。
385
+ - 1.8.18 与并行工程的改动共用工作树,提交时整体评审,不单独 cherry-pick。