dsh-workplan 2.0.4 → 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/CHANGELOG.md +62 -0
- package/README.en.md +2 -2
- package/README.md +2 -2
- package/README.zh.md +1 -1
- package/lib/comm-format.js +184 -0
- package/lib/host.js +1 -1
- package/lib/plan.js +268 -12
- package/lib/runtime.js +36 -3
- package/package.json +1 -1
- package/src/comm-format.ts +215 -0
- package/src/host.ts +1 -1
- package/src/plan.ts +269 -12
- package/src/runtime.ts +36 -3
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
|
-
|
|
863
|
-
if (first < 0 || last <= first) {
|
|
981
|
+
if (first < 0) {
|
|
864
982
|
throw new PlanError('规划器返回内容中没有 JSON 对象', 'NO_JSON');
|
|
865
983
|
}
|
|
866
|
-
const
|
|
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
|
}
|
|
@@ -1904,6 +2042,48 @@ function readEvidenceOptions(value) {
|
|
|
1904
2042
|
.map((item) => truncate(typeof item === 'string' ? item : String(item ?? ''), 300))
|
|
1905
2043
|
.filter(Boolean);
|
|
1906
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
|
+
}
|
|
1907
2087
|
/**
|
|
1908
2088
|
* Parse the child's structured evidence block.
|
|
1909
2089
|
*
|
|
@@ -2016,7 +2196,7 @@ export function repairEvidenceJson(text) {
|
|
|
2016
2196
|
* 这里做的是**有界认领**:只认带 `status` 且至少还有一个证据字段的 JSON
|
|
2017
2197
|
* 对象,绝不把任意 JSON(比如计划载荷、配置片段)当成回执。
|
|
2018
2198
|
*/
|
|
2019
|
-
|
|
2199
|
+
function rescueEvidence(output) {
|
|
2020
2200
|
const text = typeof output === 'string' ? output : '';
|
|
2021
2201
|
if (!text.includes('{'))
|
|
2022
2202
|
return null;
|
|
@@ -2030,12 +2210,15 @@ export function rescueEvidenceFromFence(output) {
|
|
|
2030
2210
|
if (first >= 0 && last > first)
|
|
2031
2211
|
candidates.push(text.slice(first, last + 1));
|
|
2032
2212
|
for (const candidate of candidates) {
|
|
2213
|
+
const body = String(candidate).trim();
|
|
2033
2214
|
let value = null;
|
|
2215
|
+
let repaired = false;
|
|
2034
2216
|
try {
|
|
2035
|
-
value = JSON.parse(
|
|
2217
|
+
value = JSON.parse(body);
|
|
2036
2218
|
}
|
|
2037
2219
|
catch {
|
|
2038
|
-
value = repairEvidenceJson(
|
|
2220
|
+
value = repairEvidenceJson(body);
|
|
2221
|
+
repaired = value !== null;
|
|
2039
2222
|
}
|
|
2040
2223
|
if (!isRecord(value))
|
|
2041
2224
|
continue;
|
|
@@ -2045,17 +2228,29 @@ export function rescueEvidenceFromFence(output) {
|
|
|
2045
2228
|
|| Array.isArray(value.needs) || isRecord(value.phases) || typeof value.summary === 'string';
|
|
2046
2229
|
if (!hasEvidence)
|
|
2047
2230
|
continue;
|
|
2048
|
-
return value;
|
|
2231
|
+
return { payload: value, raw: body, repaired };
|
|
2049
2232
|
}
|
|
2050
2233
|
return null;
|
|
2051
2234
|
}
|
|
2235
|
+
export function rescueEvidenceFromFence(output) {
|
|
2236
|
+
const rescued = rescueEvidence(output);
|
|
2237
|
+
return rescued ? rescued.payload : null;
|
|
2238
|
+
}
|
|
2052
2239
|
export function parseEvidenceBlock(output) {
|
|
2053
2240
|
const text = typeof output === 'string' ? output : '';
|
|
2054
2241
|
const begin = text.lastIndexOf(EVIDENCE_MARKER_BEGIN);
|
|
2055
2242
|
if (begin < 0) {
|
|
2056
|
-
const rescued =
|
|
2243
|
+
const rescued = rescueEvidence(text);
|
|
2057
2244
|
if (rescued) {
|
|
2058
|
-
return {
|
|
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
|
+
};
|
|
2059
2254
|
}
|
|
2060
2255
|
return { found: false, malformed: false, truncated: false, repaired: false, rescued: false, payload: null, raw: '' };
|
|
2061
2256
|
}
|
|
@@ -2160,7 +2355,8 @@ export function adjudicateResult({ output, strict = true, expectedAcceptance = [
|
|
|
2160
2355
|
error: '子 Agent 未提供结构化证据块(完成必回报):结果块缺失,无法确认验收项是否真的通过',
|
|
2161
2356
|
};
|
|
2162
2357
|
}
|
|
2163
|
-
const
|
|
2358
|
+
const hoistedEvidence = hoistEvidenceFields(parsed.payload);
|
|
2359
|
+
const payload = hoistedEvidence.payload;
|
|
2164
2360
|
const acceptance = readEvidenceAcceptance(payload.acceptance);
|
|
2165
2361
|
const artifacts = readEvidenceArtifacts(payload.artifacts);
|
|
2166
2362
|
const needs = readEvidenceNeeds(payload.needs);
|
|
@@ -2235,6 +2431,19 @@ export function adjudicateResult({ output, strict = true, expectedAcceptance = [
|
|
|
2235
2431
|
*/
|
|
2236
2432
|
const coverage = acceptanceCoverage(expectedAcceptance, acceptance);
|
|
2237
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
|
+
: '';
|
|
2238
2447
|
return {
|
|
2239
2448
|
status: 'blocked',
|
|
2240
2449
|
verification: 'unverified',
|
|
@@ -2242,7 +2451,7 @@ export function adjudicateResult({ output, strict = true, expectedAcceptance = [
|
|
|
2242
2451
|
artifacts,
|
|
2243
2452
|
needs,
|
|
2244
2453
|
error: `验收项未被逐条回应(${coverage.covered}/${coverage.total}):缺少 ${coverage.missing
|
|
2245
|
-
.map((item) => truncate(String(item), 120)).slice(0, 5).join(';')}。请按计划验收逐条给出证据后再回报。`,
|
|
2454
|
+
.map((item) => truncate(String(item), 120)).slice(0, 5).join(';')}${hint}。请按计划验收逐条给出证据后再回报。`,
|
|
2246
2455
|
};
|
|
2247
2456
|
}
|
|
2248
2457
|
/*
|
|
@@ -2269,6 +2478,42 @@ export function adjudicateResult({ output, strict = true, expectedAcceptance = [
|
|
|
2269
2478
|
phases: null,
|
|
2270
2479
|
};
|
|
2271
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
|
+
}
|
|
2272
2517
|
return {
|
|
2273
2518
|
status: 'done',
|
|
2274
2519
|
verification: hasUnverified ? 'unverified' : 'structured',
|
|
@@ -4014,5 +4259,16 @@ export function buildChildPrompt({ plan, subtask, stage, dependencyResults, cwd,
|
|
|
4014
4259
|
'- needs 写需要其他部门配合的事项,每条写清「哪个部门 + 需要什么 + 用来做什么」;它会被登记为待处理需求,主 Agent 必须处置后计划才能交付。不要直连其他子 Agent。',
|
|
4015
4260
|
'- question/options 只在受阻上报时填写;done 时保持空字符串/空数组。',
|
|
4016
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
|
+
+ '须逐条修正、重新自查通过后再重新提交完整结果。',
|
|
4017
4273
|
].join('\n'));
|
|
4018
4274
|
}
|
package/lib/runtime.js
CHANGED
|
@@ -916,7 +916,13 @@ function settleFromOutput(record, subtask, output, guard, options) {
|
|
|
916
916
|
? { closure: 'done', blockedKind: null }
|
|
917
917
|
: {
|
|
918
918
|
closure: 'blocked',
|
|
919
|
-
|
|
919
|
+
/*
|
|
920
|
+
* [2.1.0] 沟通交流格式退回是独立的受阻类型:工作本身可能已完成,
|
|
921
|
+
* 只是结果格式不合规,须退回重交。看板与主 Agent 据此区分
|
|
922
|
+
* 「做错了」与「交错了」;退回通知(不合规条目清单)已在
|
|
923
|
+
* error 字段里,由 adjudicateResult 写入。
|
|
924
|
+
*/
|
|
925
|
+
blockedKind: verdict.blockedKind === 'comm-format' ? 'comm-format' : 'failed',
|
|
920
926
|
}),
|
|
921
927
|
}, guard);
|
|
922
928
|
if (verdict.status === 'blocked') {
|
|
@@ -987,6 +993,29 @@ async function executeSubtask(ctx, record, stage, subtask, options) {
|
|
|
987
993
|
? options.attemptOffset
|
|
988
994
|
: 1;
|
|
989
995
|
let lastFailure = options.priorFailure ?? null;
|
|
996
|
+
/*
|
|
997
|
+
* [2.1.0] 格式退回通知必须在下一次激活送达部门人员(用户 2026-11-06 的
|
|
998
|
+
* 强制要求:不符合要求立刻退回,通知其重新检查格式后重交)。
|
|
999
|
+
*
|
|
1000
|
+
* 结果被 `adjudicateResult` 判为 blocked/comm-format 后,退回通知(不合规
|
|
1001
|
+
* 条目清单)落在状态行 error 里;主 Agent 把该行复位为 in_progress 后
|
|
1002
|
+
* blockedKind 保留(只有 settle 的 assigned/done 写入才会清它)。这里据此
|
|
1003
|
+
* 把退回通知作为 COMM_FORMAT_REJECTED 的上次失败原因带回子提示词,部门
|
|
1004
|
+
* 人员重跑时能看到「退回原因 + 逐条修正要求」,而不是从零重做、把同一
|
|
1005
|
+
* 格式错误再交一次。
|
|
1006
|
+
*/
|
|
1007
|
+
if (!lastFailure) {
|
|
1008
|
+
const rejectedRow = Array.isArray(record.statuses)
|
|
1009
|
+
? record.statuses.find((item) => item?.subtaskId === subtask.id)
|
|
1010
|
+
: null;
|
|
1011
|
+
if (rejectedRow?.blockedKind === 'comm-format' && typeof rejectedRow?.error === 'string' && rejectedRow.error.trim() !== '') {
|
|
1012
|
+
lastFailure = {
|
|
1013
|
+
attempt: 1,
|
|
1014
|
+
code: 'COMM_FORMAT_REJECTED',
|
|
1015
|
+
message: rejectedRow.error,
|
|
1016
|
+
};
|
|
1017
|
+
}
|
|
1018
|
+
}
|
|
990
1019
|
/*
|
|
991
1020
|
* [1.8.6] The interrupt has to outlive the thrown error.
|
|
992
1021
|
*
|
|
@@ -1068,7 +1097,11 @@ async function executeSubtask(ctx, record, stage, subtask, options) {
|
|
|
1068
1097
|
cwd: options.cwd,
|
|
1069
1098
|
conversationContext,
|
|
1070
1099
|
statuses: record.statuses,
|
|
1071
|
-
|
|
1100
|
+
/*
|
|
1101
|
+
* [2.1.0] 不再用 attempt>1 做门槛:被格式退回的行复位后第 1 次
|
|
1102
|
+
* 激活也必须带上退回通知,否则「退回」只是写了一行状态。
|
|
1103
|
+
*/
|
|
1104
|
+
previousFailure: lastFailure ?? null,
|
|
1072
1105
|
lessonsBrief,
|
|
1073
1106
|
}),
|
|
1074
1107
|
}],
|
|
@@ -5245,7 +5278,7 @@ export function createWorkplanRuntime(ctx, options = {}) {
|
|
|
5245
5278
|
* 不打印正文、非零退出。交互式会话维持原样(只 steer,不抛错)。
|
|
5246
5279
|
*/
|
|
5247
5280
|
/*
|
|
5248
|
-
* [2.0
|
|
5281
|
+
* [2.1.0] U1=B:交互式会话放行,但必须留痕。
|
|
5249
5282
|
*
|
|
5250
5283
|
* 旧行为是 `return` 了事——用户看到回合正常结束,却没有任何地方写着
|
|
5251
5284
|
* 「这个回合其实是没通过门禁被放出来的」。B 方案不动「不硬拦」这个
|
package/package.json
CHANGED
|
@@ -0,0 +1,215 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* [2.1.0] 统一沟通交流格式规范与合规检查(用户 2026-11-06 的强制要求)。
|
|
3
|
+
*
|
|
4
|
+
* 机制闭环:
|
|
5
|
+
* 1. 主 Agent 派发子任务时,在提示词里附带本模块渲染的《沟通交流格式规范》
|
|
6
|
+
* (renderCommFormatSpec),作为双方认可的唯一结果格式契约;
|
|
7
|
+
* 2. 部门人员提交结果前,必须逐条对照规范自查(提示词中有强制自查指令);
|
|
8
|
+
* 3. 主 Agent 收到结果后,由 adjudicateResult 用 checkCommFormatCompliance
|
|
9
|
+
* 按同一份规范逐条核验;不合规即判定 blocked/comm-format,把
|
|
10
|
+
* renderCommFormatRejection 生成的退回通知随下一次激活发回,
|
|
11
|
+
* 通知部门人员重新检查格式后重交。
|
|
12
|
+
*
|
|
13
|
+
* 设计约束:
|
|
14
|
+
* - 本模块只做「格式/结构」核验,不做语义真伪判断(F9 为提示词级诚信约束,
|
|
15
|
+
* 由三阶段门禁与人工复核兜底,这里不自动判);
|
|
16
|
+
* - 规范是纯数据,可序列化进提示词,也可独立校验,版本号随内容变更递增;
|
|
17
|
+
* - 与既有门禁正交:解析失败、验收缺口、三阶段缺失仍由原门禁先拦,
|
|
18
|
+
* 本门禁只负责把「其它门禁都过了、但格式仍不合规」的 done 退回。
|
|
19
|
+
*/
|
|
20
|
+
|
|
21
|
+
/** 格式规范版本,随规范内容变更递增。 */
|
|
22
|
+
export const COMM_FORMAT_VERSION = 1
|
|
23
|
+
|
|
24
|
+
/** 单条不合规项。 */
|
|
25
|
+
export interface CommFormatViolation {
|
|
26
|
+
/** 规范条目编号(F1-F9)。 */
|
|
27
|
+
ruleId: string
|
|
28
|
+
/** 不合规的具体描述(写清缺什么、怎么补)。 */
|
|
29
|
+
message: string
|
|
30
|
+
/** 条目分类(structure/phases/acceptance/artifacts/retrospective/blocked/integrity)。 */
|
|
31
|
+
category: string
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
/** 格式合规检查结果。 */
|
|
35
|
+
export interface CommFormatCheckResult {
|
|
36
|
+
/** 是否全部合规。 */
|
|
37
|
+
compliant: boolean
|
|
38
|
+
/** 不合规项列表(合规时为空)。 */
|
|
39
|
+
violations: CommFormatViolation[]
|
|
40
|
+
/** 核验所用的规范版本。 */
|
|
41
|
+
version: number
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* 统一沟通交流格式规范定义(F1-F9,冻结不可变)。
|
|
46
|
+
*/
|
|
47
|
+
export const COMM_FORMAT_SPEC = Object.freeze({
|
|
48
|
+
version: COMM_FORMAT_VERSION,
|
|
49
|
+
name: 'dsh-workplan 沟通交流格式规范',
|
|
50
|
+
requirements: Object.freeze([
|
|
51
|
+
Object.freeze({ id: 'F1', category: 'structure',
|
|
52
|
+
description: '结果必须包含结构化证据块:以 <!-- WORKPLAN_EVIDENCE:START --> 开头、<!-- WORKPLAN_EVIDENCE:END --> 结尾,且两块标记成对出现',
|
|
53
|
+
rationale: '没有标记块,主 Agent 无法定位与解析结果,交付门禁无从启动' }),
|
|
54
|
+
Object.freeze({ id: 'F2', category: 'structure',
|
|
55
|
+
description: '证据块必须是合法 JSON 对象,顶层必须含 status 字段,取值只能是 done / blocked / partial',
|
|
56
|
+
rationale: 'status 是交付门禁的入口条件,缺失或非法则无法判定完成与否' }),
|
|
57
|
+
Object.freeze({ id: 'F3', category: 'phases',
|
|
58
|
+
description: '必须包含三阶段证据:phases.planning(问题分析与可执行思路)、phases.execution(实际执行步骤)、phases.verification(逐项验证)',
|
|
59
|
+
rationale: '三阶段是质量闭环的基础,缺任一阶段等于跳过对应质控环节' }),
|
|
60
|
+
Object.freeze({ id: 'F4', category: 'acceptance',
|
|
61
|
+
description: '验收结果必须逐条回应计划的验收标准(A1、A2…),且每条 result=pass 必须附带具体证据(命令输出/文件路径/引用),禁止空证据 pass',
|
|
62
|
+
rationale: '空证据 pass 是自述而非验证,交付门禁只认可证据' }),
|
|
63
|
+
Object.freeze({ id: 'F5', category: 'acceptance',
|
|
64
|
+
description: '验收回应的条数不得少于计划定义的验收标准条数',
|
|
65
|
+
rationale: '少回应一条等于该条验收未做,交付门禁会判为未完成' }),
|
|
66
|
+
Object.freeze({ id: 'F6', category: 'artifacts',
|
|
67
|
+
description: 'artifacts 声明清单中每一项都必须是合法条目:kind 只能取 file / url / note,且 ref 非空;不允许空条目或占位条目',
|
|
68
|
+
rationale: '主 Agent 按 ref 核验交付物;非法条目让核验无从执行。是否必须交付文件由计划验收标准决定,不由本条决定' }),
|
|
69
|
+
Object.freeze({ id: 'F7', category: 'retrospective',
|
|
70
|
+
description: 'phases.verification.retrospective 复盘必须完整:problems、resolutions、prevention 均至少 1 条(detours 没有可写空数组)',
|
|
71
|
+
rationale: '复盘是自我学习闭环的入口,缺失则教训无法写入永久记忆' }),
|
|
72
|
+
Object.freeze({ id: 'F8', category: 'blocked',
|
|
73
|
+
description: '若 status 为 blocked,必须附非空 question 字段写清受阻原因(卡在哪一步、已尝试什么、需要谁决定什么)',
|
|
74
|
+
rationale: '受阻无原因等于主 Agent 不知道卡在哪里,无法给出指示或转派' }),
|
|
75
|
+
Object.freeze({ id: 'F9', category: 'integrity',
|
|
76
|
+
description: '不得编造、虚构或伪造任何证据、文件路径、命令输出或验收结果;无法确认的项目必须写 unverified',
|
|
77
|
+
rationale: '虚假证据一旦通过交付门禁,用户拿到的就是不可信的成品' }),
|
|
78
|
+
]),
|
|
79
|
+
})
|
|
80
|
+
|
|
81
|
+
/**
|
|
82
|
+
* 对子 Agent 的证据块执行沟通交流格式合规检查(F1-F8 自动核验;F9 为诚信约束不自动判)。
|
|
83
|
+
*
|
|
84
|
+
* @param parsed - 已解析的证据块 payload(parseEvidenceBlock 的 payload,可为 null)
|
|
85
|
+
* @param rawOutput - 子 Agent 原始输出全文
|
|
86
|
+
* @param expectedAcceptanceCount - 计划定义的验收标准条数
|
|
87
|
+
*/
|
|
88
|
+
export function checkCommFormatCompliance(
|
|
89
|
+
parsed: any,
|
|
90
|
+
rawOutput: string,
|
|
91
|
+
expectedAcceptanceCount: number,
|
|
92
|
+
): CommFormatCheckResult {
|
|
93
|
+
const violations: CommFormatViolation[] = []
|
|
94
|
+
const text = typeof rawOutput === 'string' ? rawOutput : ''
|
|
95
|
+
|
|
96
|
+
// F1: 证据块标记必须成对出现(rescueEvidence 捞到的豁免——主 Agent 已能解析)
|
|
97
|
+
if (!text.includes('WORKPLAN_EVIDENCE:START') || !text.includes('WORKPLAN_EVIDENCE:END')) {
|
|
98
|
+
if (!parsed) {
|
|
99
|
+
violations.push({ ruleId: 'F1', category: 'structure',
|
|
100
|
+
message: '缺少 WORKPLAN_EVIDENCE:START/END 标记块,主 Agent 无法定位与解析结果' })
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
if (!parsed || typeof parsed !== 'object') {
|
|
105
|
+
if (violations.length === 0) {
|
|
106
|
+
violations.push({ ruleId: 'F2', category: 'structure', message: '证据块无法解析为 JSON 对象' })
|
|
107
|
+
}
|
|
108
|
+
return { compliant: false, violations, version: COMM_FORMAT_VERSION }
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
// F2: status 必填且取值合法
|
|
112
|
+
if (!['done', 'blocked', 'partial'].includes(String(parsed.status ?? ''))) {
|
|
113
|
+
violations.push({ ruleId: 'F2', category: 'structure',
|
|
114
|
+
message: `status 字段缺失或取值非法("${String(parsed.status ?? '')}"),只能是 done / blocked / partial` })
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
// F3: 三阶段证据齐全
|
|
118
|
+
const phases = parsed.phases
|
|
119
|
+
if (!phases || typeof phases !== 'object') {
|
|
120
|
+
violations.push({ ruleId: 'F3', category: 'phases',
|
|
121
|
+
message: '缺少 phases 对象:planning / execution / verification 三阶段证据全部缺失' })
|
|
122
|
+
} else {
|
|
123
|
+
const missing: string[] = []
|
|
124
|
+
if (!phases.planning || typeof phases.planning !== 'object') missing.push('planning(问题分析与思路)')
|
|
125
|
+
if (!phases.execution || typeof phases.execution !== 'object') missing.push('execution(实际执行步骤)')
|
|
126
|
+
if (!phases.verification || typeof phases.verification !== 'object') missing.push('verification(逐项验证与复盘)')
|
|
127
|
+
if (missing.length > 0) {
|
|
128
|
+
violations.push({ ruleId: 'F3', category: 'phases', message: `三阶段证据缺失:${missing.join('、')}` })
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
// F4: pass 必须带证据
|
|
133
|
+
const acceptance = Array.isArray(parsed.acceptance) ? parsed.acceptance : []
|
|
134
|
+
const emptyPass: string[] = []
|
|
135
|
+
for (const item of acceptance) {
|
|
136
|
+
if (item && item.result === 'pass' && !String(item.evidence ?? '').trim()) {
|
|
137
|
+
emptyPass.push(String(item.criterion ?? '(未命名验收项)'))
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
if (emptyPass.length > 0) {
|
|
141
|
+
violations.push({ ruleId: 'F4', category: 'acceptance',
|
|
142
|
+
message: `以下验收项 result=pass 但未附证据:${emptyPass.slice(0, 5).join('、')};pass 必须附命令输出/文件路径/引用` })
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
// F5: 验收条数不得少于计划定义
|
|
146
|
+
if (expectedAcceptanceCount > 0 && acceptance.length < expectedAcceptanceCount) {
|
|
147
|
+
violations.push({ ruleId: 'F5', category: 'acceptance',
|
|
148
|
+
message: `验收回应仅 ${acceptance.length} 条,少于计划定义的 ${expectedAcceptanceCount} 条;须逐条回应 A1、A2…` })
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
// F6: 产物声明必须逐条合法(kind 枚举 + ref 非空);是否必须交付文件由计划验收决定,不在此拦
|
|
152
|
+
const artifacts = Array.isArray(parsed.artifacts) ? parsed.artifacts : []
|
|
153
|
+
const badArtifacts = artifacts.filter((item: any) =>
|
|
154
|
+
!item || typeof item !== 'object'
|
|
155
|
+
|| !['file', 'url', 'note'].includes(String(item.kind ?? ''))
|
|
156
|
+
|| String(item.ref ?? '').trim() === '')
|
|
157
|
+
if (badArtifacts.length > 0) {
|
|
158
|
+
violations.push({ ruleId: 'F6', category: 'artifacts',
|
|
159
|
+
message: `artifacts 有 ${badArtifacts.length} 条非法声明:每条必须 kind 取 file/url/note 且 ref 非空,不允许空条目` })
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
// F7: 复盘完整(problems/resolutions/prevention 均至少 1 条)
|
|
163
|
+
const retro = phases?.verification?.retrospective
|
|
164
|
+
if (!retro || typeof retro !== 'object') {
|
|
165
|
+
violations.push({ ruleId: 'F7', category: 'retrospective',
|
|
166
|
+
message: '缺少 phases.verification.retrospective 复盘(problems / detours / resolutions / prevention)' })
|
|
167
|
+
} else {
|
|
168
|
+
const missingRetro: string[] = []
|
|
169
|
+
if (!Array.isArray(retro.problems) || retro.problems.length === 0) missingRetro.push( 'problems(遇到的问题,现象+根因)')
|
|
170
|
+
if (!Array.isArray(retro.resolutions) || retro.resolutions.length === 0) missingRetro.push( 'resolutions(最终如何解决)')
|
|
171
|
+
if (!Array.isArray(retro.prevention) || retro.prevention.length === 0) missingRetro.push( 'prevention(防再犯规则)')
|
|
172
|
+
if (missingRetro.length > 0) {
|
|
173
|
+
violations.push({ ruleId: 'F7', category: 'retrospective',
|
|
174
|
+
message: `复盘不完整,缺少:${missingRetro.join('、')},均至少 1 条` })
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
// F8: blocked 必须附非空 question
|
|
179
|
+
if (parsed.status === 'blocked' && !String(parsed.question ?? '').trim()) {
|
|
180
|
+
violations.push({ ruleId: 'F8', category: 'blocked',
|
|
181
|
+
message: 'status 为 blocked 但 question 为空:须写清卡在哪一步、已尝试什么、需要谁做什么决定' })
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
return { compliant: violations.length === 0, violations, version: COMM_FORMAT_VERSION }
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
/**
|
|
188
|
+
* 把格式规范渲染为嵌入子 Agent 提示词的文本。
|
|
189
|
+
* 这是「派发工作时附带统一沟通交流格式要求」的具体实现。
|
|
190
|
+
*/
|
|
191
|
+
export function renderCommFormatSpec(): string {
|
|
192
|
+
const lines: string[] = [
|
|
193
|
+
'沟通交流格式规范(v' + String(COMM_FORMAT_VERSION) + ',主 Agent 与部门人员双方认可的结果格式契约):',
|
|
194
|
+
]
|
|
195
|
+
for (const req of COMM_FORMAT_SPEC.requirements) {
|
|
196
|
+
lines.push(`- 【${req.id}】${req.description}`)
|
|
197
|
+
}
|
|
198
|
+
lines.push('不合规的后果:主 Agent 收到结果后按本规范逐条核验;任一不合规,结果立刻退回,你将收到列明不合规条目的退回通知,须全部修正后重新提交完整结果。')
|
|
199
|
+
return lines.join('\n')
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
/**
|
|
203
|
+
* 把合规检查结果渲染为退回通知文本(随下一次激活发回部门人员)。
|
|
204
|
+
*/
|
|
205
|
+
export function renderCommFormatRejection(result: CommFormatCheckResult): string {
|
|
206
|
+
if (result.compliant) return ''
|
|
207
|
+
const lines: string[] = [
|
|
208
|
+
'结果退回:沟通交流格式不合规(规范 v' + String(result.version) + ')。',
|
|
209
|
+
'你的结果未通过以下条目,请逐条修正、重新自查全部 F1-F9 后再提交完整结果(不要只修一条就重交):',
|
|
210
|
+
]
|
|
211
|
+
for (const v of result.violations) {
|
|
212
|
+
lines.push(`- ${v.ruleId}:${v.message}`)
|
|
213
|
+
}
|
|
214
|
+
return lines.join('\n')
|
|
215
|
+
}
|