dsh-workplan 2.0.3 → 2.1.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/plan.js CHANGED
@@ -11,6 +11,7 @@ import { DEPARTMENT_CAPABILITIES, departmentCapability } from './departments.js'
11
11
  import { MAX_TASK_ANCHOR_CHARS } from './understanding.js';
12
12
  import { isMappingDigest, verifyMappingDigest } from './supersede-digest.js';
13
13
  import { phaseSummaryLine, threePhasePromptLines, validatePhaseEvidence } from './three-phase.js';
14
+ import { checkCommFormatCompliance, renderCommFormatRejection, renderCommFormatSpec, } from './comm-format.js';
14
15
  export const PLAN_VERSION = 1;
15
16
  /**
16
17
  * [1.9.0] 处置终态:cancelled(用户撤销)与 superseded(责任已转移)。
@@ -116,7 +117,7 @@ export const CLOSURES = Object.freeze([
116
117
  'replanned',
117
118
  ]);
118
119
  /** Why a `blocked` / `escalated` row stopped. Read by the dashboard and result message. */
119
- export const BLOCKED_KINDS = Object.freeze(['failed', 'timeout', 'no-ack', 'escalated']);
120
+ export const BLOCKED_KINDS = Object.freeze(['failed', 'timeout', 'no-ack', 'escalated', 'comm-format']);
120
121
  /**
121
122
  * [1.11.0] 合法闭环迁移(T4 §4 的 19 条,M1)。
122
123
  *
@@ -850,6 +851,124 @@ export function flattenSubtasks(plan) {
850
851
  }
851
852
  return out;
852
853
  }
854
+ /**
855
+ * [2.1.0] 只补结构、不补内容。
856
+ *
857
+ * 规划器返回的 JSON 常见三类损伤:少一个 `}`、多一个尾逗号、字符串里有裸换行。
858
+ * 旧实现直接 JSON.parse,一个字符之差就抛 INVALID_JSON,整个计划降级。
859
+ * 这里做的是纯结构修复:配对括号、去掉尾逗号、把字符串里的裸控制符转义。
860
+ * 绝不猜测、绝不编造任何字段或值——修不好就照旧抛错。
861
+ */
862
+ export function repairJsonStructure(input) {
863
+ const stack = [];
864
+ let inString = false;
865
+ let escaped = false;
866
+ let out = '';
867
+ for (let i = 0; i < input.length; i += 1) {
868
+ const ch = input[i];
869
+ if (inString) {
870
+ if (escaped) {
871
+ out += ch;
872
+ escaped = false;
873
+ continue;
874
+ }
875
+ if (ch === '\\') {
876
+ out += ch;
877
+ escaped = true;
878
+ continue;
879
+ }
880
+ if (ch === '"') {
881
+ inString = false;
882
+ out += ch;
883
+ continue;
884
+ }
885
+ if (ch === '\n') {
886
+ out += '\\n';
887
+ continue;
888
+ }
889
+ if (ch === '\r') {
890
+ out += '\\r';
891
+ continue;
892
+ }
893
+ if (ch === '\t') {
894
+ out += '\\t';
895
+ continue;
896
+ }
897
+ if (ch < ' ') {
898
+ out += `\\u${ch.charCodeAt(0).toString(16).padStart(4, '0')}`;
899
+ continue;
900
+ }
901
+ out += ch;
902
+ continue;
903
+ }
904
+ if (ch === '"') {
905
+ inString = true;
906
+ out += ch;
907
+ continue;
908
+ }
909
+ if (ch === '{' || ch === '[') {
910
+ stack.push(ch);
911
+ out += ch;
912
+ continue;
913
+ }
914
+ if (ch === '}' || ch === ']') {
915
+ const want = ch === '}' ? '{' : '[';
916
+ while (stack.length > 0 && stack[stack.length - 1] !== want) {
917
+ out += stack.pop() === '{' ? '}' : ']';
918
+ }
919
+ if (stack.length > 0)
920
+ stack.pop();
921
+ out += ch;
922
+ continue;
923
+ }
924
+ out += ch;
925
+ }
926
+ if (inString)
927
+ out += '"';
928
+ while (stack.length > 0)
929
+ out += stack.pop() === '{' ? '}' : ']';
930
+ return stripTrailingCommas(out);
931
+ }
932
+ function stripTrailingCommas(input) {
933
+ return input.replace(/,(\s*[}\]])/g, '$1');
934
+ }
935
+ /** 找到最后一个「成员边界」逗号(在任何嵌套深度上、且不在字符串内)。 */
936
+ function lastMemberComma(input) {
937
+ let inString = false;
938
+ let escaped = false;
939
+ let index = -1;
940
+ for (let i = 0; i < input.length; i += 1) {
941
+ const ch = input[i];
942
+ if (inString) {
943
+ if (escaped)
944
+ escaped = false;
945
+ else if (ch === '\\')
946
+ escaped = true;
947
+ else if (ch === '"')
948
+ inString = false;
949
+ continue;
950
+ }
951
+ if (ch === '"')
952
+ inString = true;
953
+ else if (ch === ',')
954
+ index = i;
955
+ }
956
+ return index;
957
+ }
958
+ /**
959
+ * 截断修复:规划器被 max tokens 截断时,最后一个成员通常是半截的。
960
+ * 从尾部逐个丢弃不完整成员,再补齐括号——丢掉的都是「本来就残缺、不能用」的内容。
961
+ */
962
+ function* truncatedCandidates(input, rounds = 24) {
963
+ let working = input;
964
+ for (let round = 0; round < rounds; round += 1) {
965
+ const cut = lastMemberComma(working);
966
+ if (cut <= 0)
967
+ return;
968
+ working = working.slice(0, cut);
969
+ yield repairJsonStructure(working);
970
+ }
971
+ }
853
972
  export function extractJson(text) {
854
973
  if (typeof text !== 'string' || text.trim() === '') {
855
974
  throw new PlanError('规划器没有返回内容', 'EMPTY_OUTPUT');
@@ -859,15 +978,34 @@ export function extractJson(text) {
859
978
  if (fenced)
860
979
  value = fenced[1].trim();
861
980
  const first = value.indexOf('{');
862
- const last = value.lastIndexOf('}');
863
- if (first < 0 || last <= first) {
981
+ if (first < 0) {
864
982
  throw new PlanError('规划器返回内容中没有 JSON 对象', 'NO_JSON');
865
983
  }
866
- const candidate = value.slice(first, last + 1);
984
+ const last = value.lastIndexOf('}');
985
+ // [2.1.0] 输出被截断时没有结尾 `}`,旧实现这里直接判 NO_JSON —— 改成仍以 `{` 起头做修复。
986
+ const candidate = last > first ? value.slice(first, last + 1) : value.slice(first);
867
987
  try {
868
988
  return JSON.parse(candidate);
869
989
  }
870
990
  catch (error) {
991
+ const repaired = repairJsonStructure(candidate);
992
+ try {
993
+ const value2 = JSON.parse(repaired);
994
+ console.warn('[dsh-workplan] 规划器 JSON 结构已修复(只补括号/逗号,未改内容)');
995
+ return value2;
996
+ }
997
+ catch {
998
+ for (const attempt of truncatedCandidates(repaired)) {
999
+ try {
1000
+ const value3 = JSON.parse(attempt);
1001
+ console.warn('[dsh-workplan] 规划器 JSON 被截断,已丢弃末尾残缺成员后解析成功');
1002
+ return value3;
1003
+ }
1004
+ catch {
1005
+ continue;
1006
+ }
1007
+ }
1008
+ }
871
1009
  throw new PlanError(`规划器返回的 JSON 无法解析:${error instanceof Error ? error.message : String(error)}`, 'INVALID_JSON');
872
1010
  }
873
1011
  }
@@ -1666,6 +1804,53 @@ export function normaliseCriterion(value) {
1666
1804
  .replace(/[\s,。;、,.;::!!??"'“”‘’()()\[\]【】《》<>]/g, '')
1667
1805
  .replace(/^(必须|需要|应当|应该|请|务必)/, '');
1668
1806
  }
1807
+ /**
1808
+ * [2.0.4] 两条验收描述的相似度(0–1)。
1809
+ *
1810
+ * 用字符二元组 Dice 系数而不是编辑距离:中文短句里「逐项」「一致性」这类
1811
+ * 词被增删时,二元组重合度比字符级编辑距离更接近人的判断,也不需要引入
1812
+ * 任何依赖。空串与单字返回 0,交给调用方的长度门槛处理。
1813
+ */
1814
+ export function criterionSimilarity(a, b) {
1815
+ if (!a || !b)
1816
+ return 0;
1817
+ if (a === b)
1818
+ return 1;
1819
+ const grams = (text) => {
1820
+ const chars = Array.from(text);
1821
+ const out = new Map();
1822
+ for (let i = 0; i + 1 < chars.length; i += 1) {
1823
+ const gram = chars[i] + chars[i + 1];
1824
+ out.set(gram, (out.get(gram) ?? 0) + 1);
1825
+ }
1826
+ return out;
1827
+ };
1828
+ const left = grams(a);
1829
+ const right = grams(b);
1830
+ let leftTotal = 0;
1831
+ let rightTotal = 0;
1832
+ for (const count of left.values())
1833
+ leftTotal += count;
1834
+ for (const count of right.values())
1835
+ rightTotal += count;
1836
+ if (leftTotal === 0 || rightTotal === 0)
1837
+ return 0;
1838
+ let overlap = 0;
1839
+ for (const [gram, count] of left) {
1840
+ overlap += Math.min(count, right.get(gram) ?? 0);
1841
+ }
1842
+ return (2 * overlap) / (leftTotal + rightTotal);
1843
+ }
1844
+ /**
1845
+ * [2.0.4] 验收文本里是否带否定/禁止语气。
1846
+ *
1847
+ * 「不得超过 5%」与「超过 5%」的二元组相似度可以很高,但语义相反。
1848
+ * 相似度只用来判「是不是同一条」,判不了「是不是同一个约束」,所以要单独
1849
+ * 把否定词拎出来比较:两边不一致就直接判不覆盖,不交给阈值碰运气。
1850
+ */
1851
+ export function hasNegation(text) {
1852
+ return /不得|禁止|严禁|不能|不可|不允许|不应|无需|避免|排除|不超过|不低于|不高于|不等于|未通过|未完成/.test(String(text ?? ''));
1853
+ }
1669
1854
  export function acceptanceCoverage(expected, actual) {
1670
1855
  const want = (Array.isArray(expected) ? expected : []).map(normaliseCriterion).filter(Boolean);
1671
1856
  const got = (Array.isArray(actual) ? actual : [])
@@ -1693,7 +1878,28 @@ export function acceptanceCoverage(expected, actual) {
1693
1878
  return true;
1694
1879
  if (Math.min(row.length, criterion.length) < 6)
1695
1880
  return false;
1696
- return row.includes(criterion);
1881
+ if (row.includes(criterion))
1882
+ return true;
1883
+ /*
1884
+ * [2.0.4] 同义改写必须算同一条验收(用户 m00302 / 2026-11-05)。
1885
+ *
1886
+ * 1.12.0 只认「证据原文包含计划原文」,于是主 Agent 把
1887
+ * 「数字与 T9 逐项一致」写成「数字与 T9 一致」就会被判成「没回应」,
1888
+ * 交付门禁反复重开。这不是证据不合格,是**字面匹配**在惩罚正常表述。
1889
+ *
1890
+ * [2.0.4] 补充规则(阈值与注释一致,不再出现 2/3 对 0.65、0.75 对 0.70):
1891
+ * 1. 证据几乎抄全了计划原文(≥85%)→ 覆盖;
1892
+ * 2. 字符二元组 Dice 相似度 ≥ 0.70,且两边否定词状态一致 → 覆盖。
1893
+ * 否定词必须单独看:T4 用真实差异对复现出「删掉『不得超过』」这种
1894
+ * 改写会被纯相似度放过,那是把约束反过来的假阳性,必须挡住。
1895
+ * 只回应一半的情况(如「登录测试」对「登录测试与越权测试」,Dice 0.667)
1896
+ * 仍然不覆盖,Q6/U-16 的本意不变。
1897
+ */
1898
+ if (criterion.includes(row) && row.length / criterion.length >= 0.85)
1899
+ return true;
1900
+ if (hasNegation(criterion) !== hasNegation(row))
1901
+ return false;
1902
+ return criterionSimilarity(row, criterion) >= 0.7;
1697
1903
  });
1698
1904
  if (!covered)
1699
1905
  missing.push(String((Array.isArray(expected) ? expected : [])[index] ?? criterion));
@@ -1836,6 +2042,48 @@ function readEvidenceOptions(value) {
1836
2042
  .map((item) => truncate(typeof item === 'string' ? item : String(item ?? ''), 300))
1837
2043
  .filter(Boolean);
1838
2044
  }
2045
+ /**
2046
+ * [2.1.0] 顶层证据字段被误写进 `phases` 时,把它们提回顶层(用户 2026-11-05)。
2047
+ *
2048
+ * 事故(子会话 13b45af6 原文复核):子 Agent 的回执像这样——
2049
+ * {"status":"done","phases":{"planning":{…},"execution":{…},"verification":{…},
2050
+ * "acceptance":[…4 条…],"artifacts":[…]}}
2051
+ * 少了一个 `}`,于是 acceptance/artifacts 全部落进 `phases`。`closeOpenJson`
2052
+ * 在末尾补一个 `}` 后 JSON 合法,`readEvidenceAcceptance(payload.acceptance)`
2053
+ * 读到空数组,最终判成「验收项未被逐条回应(0/4)」——证据一条不缺,却被
2054
+ * 说成「没做验收」,且把责任推回子 Agent。这不是证据问题,是层级错位。
2055
+ *
2056
+ * 这里只做**位置归位**:字段名与值原样搬回顶层,不改内容、不补内容;顶层
2057
+ * 已有非空值时不覆盖(避免把真值盖掉)。归位后仍走完整门禁。
2058
+ */
2059
+ const HOISTABLE_EVIDENCE_KEYS = ['acceptance', 'artifacts', 'needs', 'question', 'options'];
2060
+ export function hoistEvidenceFields(payload) {
2061
+ if (!isRecord(payload) || !isRecord(payload.phases))
2062
+ return { payload, hoisted: [] };
2063
+ const phases = payload.phases;
2064
+ const next = { ...payload, phases: { ...phases } };
2065
+ const hoisted = [];
2066
+ for (const key of HOISTABLE_EVIDENCE_KEYS) {
2067
+ const top = next[key];
2068
+ const topEmpty = top === undefined || top === null
2069
+ || (Array.isArray(top) && top.length === 0)
2070
+ || (typeof top === 'string' && top.trim() === '');
2071
+ if (!topEmpty)
2072
+ continue;
2073
+ if (!(key in phases))
2074
+ continue;
2075
+ const value = phases[key];
2076
+ const hasValue = Array.isArray(value)
2077
+ ? value.length > 0
2078
+ : typeof value === 'string' ? value.trim() !== '' : false;
2079
+ if (!hasValue)
2080
+ continue;
2081
+ next[key] = value;
2082
+ delete next.phases[key];
2083
+ hoisted.push(key);
2084
+ }
2085
+ return hoisted.length > 0 ? { payload: next, hoisted } : { payload, hoisted };
2086
+ }
1839
2087
  /**
1840
2088
  * Parse the child's structured evidence block.
1841
2089
  *
@@ -1844,25 +2092,193 @@ function readEvidenceOptions(value) {
1844
2092
  * A malformed block is reported as such instead of being silently ignored —
1845
2093
  * "cannot tell" must never default to "done".
1846
2094
  */
2095
+ /**
2096
+ * [2.0.4] 把一段被截断的 JSON 补成可解析的对象(用户 m00302)。
2097
+ *
2098
+ * 事故(T1 报告 §2.3 复核后的真实形态):5 个子 Agent 的产物都已落盘,
2099
+ * 其中 3 项(T4/T6/T10)的回执**结尾各少一个 `}`**,2 项(T5/T7)JSON 合法
2100
+ * 但漏写规定标记。旧实现把前者判成「无法解析」、后者判成「未提供证据块」,
2101
+ * 证据在盘上,判定却拿不到,只能人工兜底。
2102
+ *
2103
+ * 注意:早期口头归因写的「内容太长被截断」是错的——会话里 3000 字符是
2104
+ * 结果写回时的展示上限,不是解析输入;同样被判 done 的 T1/T2/T3 也被截到
2105
+ * 3000 字却解析正常。这里做的是**有界修复**,不是放宽验收:
2106
+ * - 只补结构(收尾引号、闭合括号),绝不补内容,也不改任何字段值;
2107
+ * - 修复后的对象仍然走完整的 status/acceptance/phases 门禁;
2108
+ * - 修不好就如实返回 null,绝不用「猜」的内容顶替。
2109
+ */
2110
+ function closeOpenJson(text) {
2111
+ const chars = Array.from(text);
2112
+ const stack = [];
2113
+ let inString = false;
2114
+ let escaped = false;
2115
+ for (const char of chars) {
2116
+ if (inString) {
2117
+ if (escaped)
2118
+ escaped = false;
2119
+ else if (char === '\\')
2120
+ escaped = true;
2121
+ else if (char === '"')
2122
+ inString = false;
2123
+ continue;
2124
+ }
2125
+ if (char === '"')
2126
+ inString = true;
2127
+ else if (char === '{')
2128
+ stack.push('}');
2129
+ else if (char === '[')
2130
+ stack.push(']');
2131
+ else if (char === '}' || char === ']') {
2132
+ if (stack.pop() !== char)
2133
+ return null;
2134
+ }
2135
+ }
2136
+ let closed = text;
2137
+ if (inString)
2138
+ closed += '"';
2139
+ while (stack.length > 0)
2140
+ closed += stack.pop();
2141
+ return closed;
2142
+ }
2143
+ /** 最后一个「切掉它之后仍可能闭合」的位置:字符串外的逗号或左括号。 */
2144
+ function lastSafeCut(text) {
2145
+ const chars = Array.from(text);
2146
+ let inString = false;
2147
+ let escaped = false;
2148
+ let cut = -1;
2149
+ for (let i = 0; i < chars.length; i += 1) {
2150
+ const char = chars[i];
2151
+ if (inString) {
2152
+ if (escaped)
2153
+ escaped = false;
2154
+ else if (char === '\\')
2155
+ escaped = true;
2156
+ else if (char === '"')
2157
+ inString = false;
2158
+ continue;
2159
+ }
2160
+ if (char === '"')
2161
+ inString = true;
2162
+ else if (char === ',' || char === '{' || char === '[')
2163
+ cut = inString ? cut : i;
2164
+ }
2165
+ return cut;
2166
+ }
2167
+ export function repairEvidenceJson(text) {
2168
+ let body = String(text ?? '').trim();
2169
+ for (let attempt = 0; attempt < 24 && body.length > 0; attempt += 1) {
2170
+ const closed = closeOpenJson(body);
2171
+ if (closed) {
2172
+ try {
2173
+ const value = JSON.parse(closed);
2174
+ if (isRecord(value))
2175
+ return value;
2176
+ }
2177
+ catch {
2178
+ /* 继续往前切 */
2179
+ }
2180
+ }
2181
+ const cut = lastSafeCut(body);
2182
+ if (cut <= 0)
2183
+ return null;
2184
+ body = body.slice(0, cut);
2185
+ }
2186
+ return null;
2187
+ }
2188
+ /**
2189
+ * [2.0.4] 没写规定标记、但内容其实交齐了的回执(用户 m00302)。
2190
+ *
2191
+ * 子会话原文核查(T1 报告 §2.3)显示:T5/T7 的证据块 **JSON 完全合法**,
2192
+ * status/phases/acceptance/artifacts 一样不缺,只是被放进了 Markdown 代码块,
2193
+ * 没有写 `WORKPLAN_EVIDENCE:START/END`。旧实现直接判「结果块缺失」,把
2194
+ * 「格式没按规定」说成「没交作业」。
2195
+ *
2196
+ * 这里做的是**有界认领**:只认带 `status` 且至少还有一个证据字段的 JSON
2197
+ * 对象,绝不把任意 JSON(比如计划载荷、配置片段)当成回执。
2198
+ */
2199
+ function rescueEvidence(output) {
2200
+ const text = typeof output === 'string' ? output : '';
2201
+ if (!text.includes('{'))
2202
+ return null;
2203
+ const candidates = [];
2204
+ const fence = /```(?:json|JSON)?\s*\n([\s\S]*?)```/g;
2205
+ let match;
2206
+ while ((match = fence.exec(text)) !== null)
2207
+ candidates.push(match[1]);
2208
+ const first = text.indexOf('{');
2209
+ const last = text.lastIndexOf('}');
2210
+ if (first >= 0 && last > first)
2211
+ candidates.push(text.slice(first, last + 1));
2212
+ for (const candidate of candidates) {
2213
+ const body = String(candidate).trim();
2214
+ let value = null;
2215
+ let repaired = false;
2216
+ try {
2217
+ value = JSON.parse(body);
2218
+ }
2219
+ catch {
2220
+ value = repairEvidenceJson(body);
2221
+ repaired = value !== null;
2222
+ }
2223
+ if (!isRecord(value))
2224
+ continue;
2225
+ if (!EVIDENCE_STATUSES.includes(value.status))
2226
+ continue;
2227
+ const hasEvidence = Array.isArray(value.acceptance) || Array.isArray(value.artifacts)
2228
+ || Array.isArray(value.needs) || isRecord(value.phases) || typeof value.summary === 'string';
2229
+ if (!hasEvidence)
2230
+ continue;
2231
+ return { payload: value, raw: body, repaired };
2232
+ }
2233
+ return null;
2234
+ }
2235
+ export function rescueEvidenceFromFence(output) {
2236
+ const rescued = rescueEvidence(output);
2237
+ return rescued ? rescued.payload : null;
2238
+ }
1847
2239
  export function parseEvidenceBlock(output) {
1848
2240
  const text = typeof output === 'string' ? output : '';
1849
2241
  const begin = text.lastIndexOf(EVIDENCE_MARKER_BEGIN);
1850
- if (begin < 0)
1851
- return { found: false, malformed: false, truncated: false, payload: null, raw: '' };
1852
- const end = text.indexOf(EVIDENCE_MARKER_END, begin + EVIDENCE_MARKER_BEGIN.length);
1853
- if (end < 0)
1854
- return { found: true, malformed: true, truncated: false, payload: null, raw: '' };
1855
- const raw = text.slice(begin + EVIDENCE_MARKER_BEGIN.length, end).trim();
1856
- const truncated = raw.length > MAX_EVIDENCE_BLOCK_CHARS;
1857
- try {
1858
- const payload = JSON.parse(raw);
2242
+ if (begin < 0) {
2243
+ const rescued = rescueEvidence(text);
2244
+ if (rescued) {
2245
+ return {
2246
+ found: true,
2247
+ malformed: false,
2248
+ truncated: false,
2249
+ repaired: rescued.repaired,
2250
+ rescued: true,
2251
+ payload: rescued.payload,
2252
+ raw: rescued.raw,
2253
+ };
2254
+ }
2255
+ return { found: false, malformed: false, truncated: false, repaired: false, rescued: false, payload: null, raw: '' };
2256
+ }
2257
+ const bodyStart = begin + EVIDENCE_MARKER_BEGIN.length;
2258
+ const end = text.indexOf(EVIDENCE_MARKER_END, bodyStart);
2259
+ /*
2260
+ * [2.0.4] 结束标记缺失 = 输出被截断,不是「格式错误」。
2261
+ *
2262
+ * 旧实现遇到这种情况直接判 malformed,还把 `truncated` 写成 false,于是
2263
+ * 上层拿到的是「无法解析」,看不出真正原因。现在先把标记之后的全部内容
2264
+ * 当作候选块,交给有界修复;修得回来就是可用证据,修不回来才报截断。
2265
+ */
2266
+ const raw = (end < 0 ? text.slice(bodyStart) : text.slice(bodyStart, end)).trim();
2267
+ const truncated = end < 0 || raw.length > MAX_EVIDENCE_BLOCK_CHARS;
2268
+ const accept = (payload, repaired) => {
1859
2269
  if (!isRecord(payload) || !EVIDENCE_STATUSES.includes(payload.status)) {
1860
- return { found: true, malformed: true, truncated, payload: null, raw };
2270
+ return { found: true, malformed: true, truncated, repaired, rescued: false, payload: null, raw };
1861
2271
  }
1862
- return { found: true, malformed: false, truncated, payload, raw };
2272
+ return { found: true, malformed: false, truncated, repaired, rescued: false, payload, raw };
2273
+ };
2274
+ try {
2275
+ return accept(JSON.parse(raw), false);
1863
2276
  }
1864
2277
  catch {
1865
- return { found: true, malformed: true, truncated, payload: null, raw };
2278
+ const repaired = repairEvidenceJson(raw);
2279
+ if (repaired)
2280
+ return accept(repaired, true);
2281
+ return { found: true, malformed: true, truncated, repaired: false, payload: null, raw };
1866
2282
  }
1867
2283
  }
1868
2284
  const BLOCKED_LINE = /^\s*(BLOCKED|受阻|无法完成)\s*[::]\s*/i;
@@ -1896,7 +2312,17 @@ export function adjudicateResult({ output, strict = true, expectedAcceptance = [
1896
2312
  acceptance: [],
1897
2313
  artifacts: [],
1898
2314
  needs: [],
1899
- error: '结果块无法解析,请主 Agent 核对',
2315
+ /*
2316
+ * [2.0.4] 失败信息必须能指导下一步动作(用户 m00302)。
2317
+ *
2318
+ * 「无法解析,请主 Agent 核对」把诊断责任推回给人:既不说是不是截断,
2319
+ * 也不说该重发还是该改格式,于是只能靠读原始输出猜。现在按截断/非法
2320
+ * 分档给出可执行提示。
2321
+ */
2322
+ error: parsed.truncated
2323
+ ? '结果块被截断(缺少结束标记或超过长度上限):请让该子 Agent 重新回报,'
2324
+ + '只保留 status/summary/acceptance/artifacts/needs 字段,删掉大段执行日志后重发'
2325
+ : '结果块 JSON 非法(不是截断):请检查引号、逗号与括号是否成对,修正后重新回报',
1900
2326
  };
1901
2327
  }
1902
2328
  if (!parsed.found) {
@@ -1929,7 +2355,8 @@ export function adjudicateResult({ output, strict = true, expectedAcceptance = [
1929
2355
  error: '子 Agent 未提供结构化证据块(完成必回报):结果块缺失,无法确认验收项是否真的通过',
1930
2356
  };
1931
2357
  }
1932
- const payload = parsed.payload;
2358
+ const hoistedEvidence = hoistEvidenceFields(parsed.payload);
2359
+ const payload = hoistedEvidence.payload;
1933
2360
  const acceptance = readEvidenceAcceptance(payload.acceptance);
1934
2361
  const artifacts = readEvidenceArtifacts(payload.artifacts);
1935
2362
  const needs = readEvidenceNeeds(payload.needs);
@@ -2004,6 +2431,19 @@ export function adjudicateResult({ output, strict = true, expectedAcceptance = [
2004
2431
  */
2005
2432
  const coverage = acceptanceCoverage(expectedAcceptance, acceptance);
2006
2433
  if (coverage.total > 0 && coverage.missing.length > 0) {
2434
+ /*
2435
+ * [2.1.0] 先把「为什么没读到」说清楚,再要求补证据。
2436
+ *
2437
+ * 旧文案只有一句「验收项未被逐条回应」,于是「真没回」「层级写错」
2438
+ * 「被截断」三种完全不同的原因长得一模一样,主 Agent 只能反复重派。
2439
+ */
2440
+ const rawText = String(parsed.raw ?? '');
2441
+ const rawHasAcceptance = /"acceptance"\s*:/.test(rawText);
2442
+ const hint = acceptance.length === 0 && rawHasAcceptance
2443
+ ? '(原始结果块里确实写了 acceptance,但没有落在顶层:通常是 phases 少一个 } 导致层级错位,已尝试自动归位仍未读到)'
2444
+ : parsed.repaired
2445
+ ? '(结果块 JSON 有语法错误,已修复;若 acceptance 位于错误点之后,会被一起裁掉)'
2446
+ : '';
2007
2447
  return {
2008
2448
  status: 'blocked',
2009
2449
  verification: 'unverified',
@@ -2011,7 +2451,7 @@ export function adjudicateResult({ output, strict = true, expectedAcceptance = [
2011
2451
  artifacts,
2012
2452
  needs,
2013
2453
  error: `验收项未被逐条回应(${coverage.covered}/${coverage.total}):缺少 ${coverage.missing
2014
- .map((item) => truncate(String(item), 120)).slice(0, 5).join(';')}。请按计划验收逐条给出证据后再回报。`,
2454
+ .map((item) => truncate(String(item), 120)).slice(0, 5).join(';')}${hint}。请按计划验收逐条给出证据后再回报。`,
2015
2455
  };
2016
2456
  }
2017
2457
  /*
@@ -2038,6 +2478,42 @@ export function adjudicateResult({ output, strict = true, expectedAcceptance = [
2038
2478
  phases: null,
2039
2479
  };
2040
2480
  }
2481
+ /*
2482
+ * [2.1.0] 沟通交流格式门禁(用户 2026-11-06 的强制要求,契约见
2483
+ * `src/comm-format.ts`)。
2484
+ *
2485
+ * 主 Agent 派发任务时随提示词附带《沟通交流格式规范》(renderCommFormatSpec),
2486
+ * 部门人员提交前须逐条自查;这里按同一份规范对「其它门禁都已通过、
2487
+ * 即将判 done」的结果做最终核验:任一不合规即退回(blocked/comm-format),
2488
+ * 不合规条目随下一次激活的 previousFailure 发回,通知其重新自查后重交。
2489
+ *
2490
+ * 只拦 done 路径:解析失败、验收缺口、三阶段缺失等已被上方门禁拦下的结果,
2491
+ * 维持原受阻原因,不用格式条目覆盖更有针对性的诊断。
2492
+ */
2493
+ const commFormat = requirePhases === false
2494
+ /*
2495
+ * [2.1.0] 兼容边界:`requirePhases:false` 是「历史回放 / 明确关闭新契约」
2496
+ * 的既有开关(1.13.0 语义)。格式契约只对实时执行生效,不得追溯否决
2497
+ * 旧会话日志里按当时规则合法的 done。
2498
+ */
2499
+ ? { compliant: true, violations: [], version: 0 }
2500
+ : checkCommFormatCompliance(payload, text, Array.isArray(expectedAcceptance) ? expectedAcceptance.length : 0);
2501
+ if (!commFormat.compliant) {
2502
+ return {
2503
+ status: 'blocked',
2504
+ verification: 'unverified',
2505
+ acceptance,
2506
+ artifacts,
2507
+ needs,
2508
+ error: `沟通交流格式不合规,结果已退回重交:${commFormat.violations
2509
+ .map((v) => `${v.ruleId} ${v.message}`)
2510
+ .slice(0, 6)
2511
+ .join(';')}`,
2512
+ blockedKind: 'comm-format',
2513
+ commFormatViolations: commFormat.violations,
2514
+ commFormatRejection: renderCommFormatRejection(commFormat),
2515
+ };
2516
+ }
2041
2517
  return {
2042
2518
  status: 'done',
2043
2519
  verification: hasUnverified ? 'unverified' : 'structured',
@@ -2551,8 +3027,22 @@ export function applyStatus(statuses, subtaskId, patch) {
2551
3027
  next.updatedBy = ['child', 'agent', 'system'].includes(patch.updatedBy) ? patch.updatedBy : 'system';
2552
3028
  if (patch.status === 'done') {
2553
3029
  next.progress = 100;
2554
- if (patch.closure === undefined)
2555
- next.closure = 'done';
3030
+ /*
3031
+ * [2.0.4] 「已回报」是事实,不是阶段(用户 m00302 / 2026-11-05)。
3032
+ *
3033
+ * `closure:'reported'` 的意思是「这条完成结果已经通过结果消息回报过」,
3034
+ * 它是交付门禁 `reportPending` 读的事实。主 Agent 事后复核证据、把
3035
+ * verification/acceptance 补齐时,status 仍然是 done —— 旧代码却把
3036
+ * closure 默认改回 `done`,于是撞上「非法闭环迁移:reported → done」,
3037
+ * 逼着人先写一次假的 blocked 再写 done。审计链被污染,界面还会短暂
3038
+ * 显示「受阻」。
3039
+ *
3040
+ * 现在:没有显式指定 closure 的复核写入,保留已回报事实;只有调用方
3041
+ * 明确要把它退回未回报时,迁移表才继续拒绝并在文案里给出出路。
3042
+ */
3043
+ if (patch.closure === undefined) {
3044
+ next.closure = current.closure === 'reported' ? 'reported' : 'done';
3045
+ }
2556
3046
  /*
2557
3047
  * 一条已经完成的子任务不可能同时“在等指示”。旧的 question/options 是
2558
3048
  * 上一段受阻经历的证据,不能继续驱动模型把它当成未决请示;失败原因本身
@@ -2723,7 +3213,8 @@ export function applyStatus(statuses, subtaskId, patch) {
2723
3213
  && next.closure != null
2724
3214
  && next.closure !== previousClosure
2725
3215
  && !(CLOSURE_TRANSITIONS[String(previousClosure)] ?? []).includes(String(next.closure))) {
2726
- throw new PlanError(`非法闭环迁移:${String(previousClosure)} → ${String(next.closure)}`, 'INVALID_TRANSITION');
3216
+ throw new PlanError(`非法闭环迁移:${String(previousClosure)} → ${String(next.closure)};`
3217
+ + '「已回报」的行若要再次交付,请直接派发新一轮,不要把它退回未回报', 'INVALID_TRANSITION');
2727
3218
  }
2728
3219
  if (next.closure === 'escalated' && next.status !== 'blocked') {
2729
3220
  throw new PlanError('closure=escalated 必须同时是 status=blocked;恢复推进请写 closure=instructed', 'INVALID_CLOSURE_PROJECTION');
@@ -3768,5 +4259,16 @@ export function buildChildPrompt({ plan, subtask, stage, dependencyResults, cwd,
3768
4259
  '- needs 写需要其他部门配合的事项,每条写清「哪个部门 + 需要什么 + 用来做什么」;它会被登记为待处理需求,主 Agent 必须处置后计划才能交付。不要直连其他子 Agent。',
3769
4260
  '- question/options 只在受阻上报时填写;done 时保持空字符串/空数组。',
3770
4261
  '- 整块不超过 12000 字符;不要把这段模板本身抄进结果块。',
4262
+ '',
4263
+ /*
4264
+ * [2.1.0] 派发工作时附带统一沟通交流格式要求(用户 2026-11-06 的强制要求)。
4265
+ *
4266
+ * 规范文本与主 Agent 核验结果用的是同一份数据(src/comm-format.ts),
4267
+ * 「附带的要求」与「核验的尺子」由此不可能长成两个版本。
4268
+ */
4269
+ renderCommFormatSpec(),
4270
+ '提交前自查(强制):逐条对照上面《沟通交流格式规范》F1–F9,确认全部满足后再提交;'
4271
+ + '主 Agent 收到结果后按同一份规范逐条核验,任一不合规即立刻退回,你会收到列明不合规条目的退回通知,'
4272
+ + '须逐条修正、重新自查通过后再重新提交完整结果。',
3771
4273
  ].join('\n'));
3772
4274
  }