dsh-workplan 3.0.6 → 3.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 +27 -0
- package/README.en.md +2 -2
- package/README.md +16 -14
- package/README.zh.md +2 -2
- package/docs/release-notes-3.0.9.md +7 -0
- package/docs/release-notes-3.1.0.md +7 -0
- package/lib/caps.js +43 -0
- package/lib/comm-format.js +7 -7
- package/lib/{three-phase.js → five-step.js} +204 -132
- package/lib/host.js +124 -77
- package/lib/lessons.js +4 -4
- package/lib/llm-rules.js +71 -104
- package/lib/plan.js +186 -80
- package/lib/runtime.js +367 -139
- package/lib/v3-contract.js +10 -7
- package/package.json +2 -3
- package/src/caps.ts +49 -0
- package/src/comm-format.ts +7 -6
- package/src/{three-phase.ts → five-step.ts} +230 -167
- package/src/host.ts +124 -77
- package/src/lessons.ts +4 -4
- package/src/llm-rules.ts +83 -127
- package/src/plan.ts +181 -76
- package/src/runtime.ts +373 -137
- package/src/v3-contract.ts +10 -7
package/lib/v3-contract.js
CHANGED
|
@@ -3,8 +3,8 @@
|
|
|
3
3
|
*
|
|
4
4
|
* 单一事实源:两条会话固定文案、部门任务质量要求、极简任务硬门槛、专家精简
|
|
5
5
|
* JSON 汇报、部门负责人精简 JSON 汇总。渲染函数与校验函数同源,保证提示词里
|
|
6
|
-
* 写的规则与门禁实际执行的规则不可能分叉(与 2.x 的 comm-format / three-phase
|
|
7
|
-
* 同一哲学)。
|
|
6
|
+
* 写的规则与门禁实际执行的规则不可能分叉(与 2.x 的 comm-format / three-phase、
|
|
7
|
+
* 3.0.8 的 five-step 同一哲学)。
|
|
8
8
|
*
|
|
9
9
|
* 纯函数、零依赖(不 import plan.ts,避免循环依赖),可被 host/plan/runtime/
|
|
10
10
|
* llm-rules 与测试同口径消费。
|
|
@@ -227,13 +227,16 @@ export function checkAtomicAssignment(task, qualityRequirements) {
|
|
|
227
227
|
/** 单个汇报数组的条数上限:精简的量化口径。 */
|
|
228
228
|
export const MAX_REPORT_ITEMS = 6;
|
|
229
229
|
/**
|
|
230
|
-
* [3.0.6][第 3 批③] sources(部门汇总「覆盖的专家汇报」)专用上限。
|
|
231
|
-
*
|
|
230
|
+
* [3.0.6][第 3 批③][3.1.0 改数] sources(部门汇总「覆盖的专家汇报」)专用上限。
|
|
231
|
+
* 死锁修复史:复杂任务按用户裁决 D1/D2 强制 ≥8 名专家(上限原 12),而 sources
|
|
232
232
|
* 必须覆盖全部已派发专家——若与其他数组共用 6 条上限,7–12 人的部门永远
|
|
233
233
|
* 交不出合法汇总(覆盖诚实要求 vs 精简上限互相矛盾)。覆盖是硬要求,
|
|
234
|
-
* 故 sources
|
|
234
|
+
* 故 sources 单独放宽;3.1.0 专家上限 12→25,本条数同步 16→30(25 + 余量 5)。
|
|
235
|
+
* 单一真源在 caps.ts(可用 DSH_WORKPLAN_MAX_SOURCES_ITEMS 覆盖),此处 re-export
|
|
236
|
+
* 保持既有 import 路径不变。
|
|
235
237
|
*/
|
|
236
|
-
|
|
238
|
+
import { MAX_SOURCES_ITEMS } from './caps.js';
|
|
239
|
+
export { MAX_SOURCES_ITEMS };
|
|
237
240
|
/** 单条汇报文本的字符上限。 */
|
|
238
241
|
export const MAX_REPORT_ITEM_CHARS = 200;
|
|
239
242
|
/** 专家汇报的四个必填字段(与用户要求 7 的四个方向一一对应)。 */
|
|
@@ -373,7 +376,7 @@ function checkListField(container, name, violations, options) {
|
|
|
373
376
|
/**
|
|
374
377
|
* 校验专家精简 JSON 汇报(用户要求 7)。
|
|
375
378
|
*
|
|
376
|
-
* 只做结构/精简判定,不判语义真伪(诚信由 F9
|
|
379
|
+
* 只做结构/精简判定,不判语义真伪(诚信由 F9 与五步证据门禁兜底)。
|
|
377
380
|
*/
|
|
378
381
|
export function checkExpertReport(report) {
|
|
379
382
|
if (!report || typeof report !== 'object' || Array.isArray(report)) {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-workplan",
|
|
3
|
-
"version": "3.0
|
|
3
|
+
"version": "3.1.0",
|
|
4
4
|
"description": "Automatic task decomposition, real department subagents, and a responsive workplan dashboard for DeepSeek Harness.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
@@ -53,8 +53,7 @@
|
|
|
53
53
|
"scripts/repair-malformed-user-messages.mjs"
|
|
54
54
|
],
|
|
55
55
|
"engines": {
|
|
56
|
-
"node": ">=22"
|
|
57
|
-
"dsh": ">=0.2.2-rc.3"
|
|
56
|
+
"node": ">=22"
|
|
58
57
|
},
|
|
59
58
|
"dsh": {
|
|
60
59
|
"bundle": {
|
package/src/caps.ts
ADDED
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* [3.1.0] 数量上限的单一真源( caps = capability caps )。
|
|
3
|
+
*
|
|
4
|
+
* 为什么要有这个模块:
|
|
5
|
+
* - 复杂任务分工表人数上限(12 → 25,用户裁决 2026-11-19)与部门汇总 sources
|
|
6
|
+
* 上限(16 → 30)此前分散硬编码在 llm-rules / v3-contract / plan.ts 的存档
|
|
7
|
+
* 消毒里,历史上发生过「改一处漏一处」:3.0.6 的部门汇总死锁(人数 12 但
|
|
8
|
+
* sources 卡 6)、以及「写 25 读 12」的存读不对称。收口到本模块后,
|
|
9
|
+
* 所有消费方 import 同一常量,物理上不可能再分叉。
|
|
10
|
+
* - llm-rules.ts 依赖 plan.ts(历史既有),plan.ts 不能反向 import llm-rules,
|
|
11
|
+
* 因此把上限放在这个零依赖叶子模块里,两边都能安全引用,无循环风险。
|
|
12
|
+
*
|
|
13
|
+
* 环境变量(全部可选,默认即用户裁决值,不设则行为与 3.1.0 默认完全一致):
|
|
14
|
+
* - DSH_WORKPLAN_MAX_COMPLEX_DELEGATE_MEMBERS:复杂任务专家人数上限,默认 25
|
|
15
|
+
* (仍强制 ≥ MIN_COMPLEX_DELEGATE_MEMBERS=8,防止把上限配得比下限低)。
|
|
16
|
+
* - DSH_WORKPLAN_MAX_SOURCES_ITEMS:部门汇总 sources 条数上限,默认 30
|
|
17
|
+
* (必须 ≥ 专家人数上限,否则「逐人覆盖」硬要求与条数上限互相矛盾——
|
|
18
|
+
* 3.0.6 死锁的复发条件,故默认值取 25+余量)。
|
|
19
|
+
*/
|
|
20
|
+
|
|
21
|
+
/** 读取正整数环境变量;缺失/非正整数/NaN 一律回落默认值(fail-closed 到裁决值)。 */
|
|
22
|
+
export function envPositiveInt(name: string, fallback: number): number {
|
|
23
|
+
const raw = process.env[name]
|
|
24
|
+
if (typeof raw !== 'string' || raw.trim() === '') return fallback
|
|
25
|
+
const n = Number(raw.trim())
|
|
26
|
+
return Number.isInteger(n) && n > 0 ? n : fallback
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* 复杂任务(声明档 medium/high/xhigh/max)分工表人数下限:用户裁决 D1/D2,
|
|
31
|
+
* 固定 8,不开放环境变量(裁决明示「少于 8 人硬性阻断」)。
|
|
32
|
+
*/
|
|
33
|
+
export const MIN_COMPLEX_DELEGATE_MEMBERS = 8
|
|
34
|
+
|
|
35
|
+
/**
|
|
36
|
+
* 复杂任务分工表人数上限:用户裁决 D2 原为 12,2026-11-19 用户裁决扩大到 25
|
|
37
|
+
* (部门负责人数量不动;只放宽部门内全球顶尖专家)。仍强制 ≥ 下限 8。
|
|
38
|
+
*/
|
|
39
|
+
export const MAX_COMPLEX_DELEGATE_MEMBERS = Math.max(
|
|
40
|
+
MIN_COMPLEX_DELEGATE_MEMBERS,
|
|
41
|
+
envPositiveInt('DSH_WORKPLAN_MAX_COMPLEX_DELEGATE_MEMBERS', 25),
|
|
42
|
+
)
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* 部门汇总 sources(「覆盖的专家汇报」)条数上限:3.0.6 为修复 12 人死锁放宽到
|
|
46
|
+
* 16;3.1.0 随专家上限 25 同步放宽到 30(25 + 非专家来源余量 5)。覆盖是诚实
|
|
47
|
+
* 硬要求——本条数必须 ≥ 专家人数上限,否则部门永远交不出合法汇总(死锁)。
|
|
48
|
+
*/
|
|
49
|
+
export const MAX_SOURCES_ITEMS = envPositiveInt('DSH_WORKPLAN_MAX_SOURCES_ITEMS', 30)
|
package/src/comm-format.ts
CHANGED
|
@@ -12,15 +12,16 @@
|
|
|
12
12
|
*
|
|
13
13
|
* 设计约束:
|
|
14
14
|
* - 本模块只做「格式/结构」核验,不做语义真伪判断(F9 为提示词级诚信约束,
|
|
15
|
-
*
|
|
15
|
+
* 由五步证据门禁与人工复核兜底,这里不自动判);
|
|
16
16
|
* - 规范是纯数据,可序列化进提示词,也可独立校验,版本号随内容变更递增;
|
|
17
|
-
* -
|
|
17
|
+
* - 与既有门禁正交:解析失败、验收缺口、五步证据缺失仍由原门禁先拦,
|
|
18
18
|
* 本门禁只负责把「其它门禁都过了、但格式仍不合规」的 done 退回。
|
|
19
19
|
*/
|
|
20
20
|
|
|
21
21
|
import {
|
|
22
22
|
checkDepartmentSummary,
|
|
23
23
|
checkExpertReport,
|
|
24
|
+
MAX_SOURCES_ITEMS,
|
|
24
25
|
renderDepartmentSummarySpec,
|
|
25
26
|
renderExpertReportSpec,
|
|
26
27
|
} from './v3-contract.js'
|
|
@@ -95,10 +96,10 @@ export const COMM_FORMAT_SPEC = Object.freeze({
|
|
|
95
96
|
* 冻结条目,本次只增不改;两条新条目按接收者层级启用(见 check 的 tier)。
|
|
96
97
|
*/
|
|
97
98
|
Object.freeze({ id: 'F10', category: 'report',
|
|
98
|
-
description: '专家(第三层执行者)结果必须包含 report 对象,只允许 keyResults/keyInfo/importantInfo/leadRequirements
|
|
99
|
+
description: '专家(第三层执行者)结果必须包含 report 对象,只允许 keyResults/keyInfo/importantInfo/leadRequirements 四个字符串数组字段:keyResults / leadRequirements 各至少 1 条非空内容,keyInfo / importantInfo 可为空数组但字段必须存在,每数组最多 6 条、每条最多 200 字符,内部与跨字段不得出现重复表述',
|
|
99
100
|
rationale: '用户要求 7:专家成果必须非常精简地汇报给部门负责人,只要关键信息、关键成果、重要信息和负责人要求的东西,并以 JSON mode 结构化输出' }),
|
|
100
101
|
Object.freeze({ id: 'F11', category: 'report',
|
|
101
|
-
description:
|
|
102
|
+
description: `部门负责人结果必须包含 departmentSummary 对象,只允许 keyResults/keyInfo/importantInfo/sources 四个字符串数组字段,keyResults 至少 1 条非空,keyResults/keyInfo/importantInfo 每项最多 6 条、每条最多 200 字符;sources 最多 ${MAX_SOURCES_ITEMS} 条且必须逐人覆盖本部门全部已派发专家,内部与跨字段不得出现重复表述`,
|
|
102
103
|
rationale: '用户要求 8/10/11:部门负责人必须全面汇总全部专家汇报,汇总报告必须精简、禁止累赘重复,并以 JSON mode 结构化直接交回主 Agent' }),
|
|
103
104
|
]),
|
|
104
105
|
/*
|
|
@@ -161,7 +162,7 @@ export function checkCommFormatCompliance(
|
|
|
161
162
|
message: `status 字段缺失或取值非法("${String(parsed.status ?? '')}"),只能是 done / blocked / partial` })
|
|
162
163
|
}
|
|
163
164
|
|
|
164
|
-
// F3:
|
|
165
|
+
// F3: 五步证据齐全(planning / preparation / execution / verification)
|
|
165
166
|
const phases = parsed.phases
|
|
166
167
|
if (!phases || typeof phases !== 'object') {
|
|
167
168
|
violations.push({ ruleId: 'F3', category: 'phases',
|
|
@@ -231,7 +232,7 @@ export function checkCommFormatCompliance(
|
|
|
231
232
|
|
|
232
233
|
/*
|
|
233
234
|
* F10/F11(用户 2026-11-14 第 7、10、11 条):按接收者层级启用。
|
|
234
|
-
* 只拦 done 路径——受阻结果已有更针对性的诊断(F8
|
|
235
|
+
* 只拦 done 路径——受阻结果已有更针对性的诊断(F8/五步证据),
|
|
235
236
|
* 不再叠加精简性条目,避免一条 blocked 被反复退回在格式上。
|
|
236
237
|
*/
|
|
237
238
|
if (options.tier === 'expert' && parsed.status === 'done') {
|