dsh-workplan 2.3.0 → 2.3.9

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.
@@ -0,0 +1,221 @@
1
+ /**
2
+ * [2.3.9][T3] LLM 家族检测与推理等级约束——执行工具层。
3
+ *
4
+ * 单一事实源在 src/plan.ts(REASONING_EFFORTS 五档存储全集旁:classifyModelFamily /
5
+ * allowedEffortsForModel / COMPLEXITY_EFFORT_BY_FAMILY,含用户要求 1/2 原文与
6
+ * 「不得删档/模型未知不约束」的完整语义注释)。本模块只做两件事:
7
+ * 1) 转发真源符号(保持 runtime/replan/tests 的引用面稳定,兼容别名
8
+ * detectLlmType ≡ classifyModelFamily);
9
+ * 2) 提供「事前约束」需要的两个执行函数:validateReasoningEffort(集合校验,
10
+ * 给明确错误信息=A3 报错轨)与 correctEffortForModel(越界自动降级修正
11
+ * =A3 修正轨,绝不抛错中断派发)。
12
+ *
13
+ * 与 [2.2.7] 宿主能力钳制(clampEffortToSupported/resolveSupportedEfforts)的
14
+ * 时序关系:检测(入口) → 静态集合收窄(本模块) → 宿主能力交集钳制 → 发送;
15
+ * 两道闸各自留痕(U7 裁决:静态表权威 + 能力面交集钳制留痕)。
16
+ */
17
+ import { allowedEffortsForModel, classifyModelFamily, defuseSessionReferenceText, effortForComplexity, EVIDENCE_MARKER_BEGIN, EVIDENCE_MARKER_END, effortsForModelFamily, highestEffortOf, OTHER_MODEL_EFFORTS, QWEN_MODEL_EFFORTS, REASONING_EFFORTS, truncate, } from './plan.js';
18
+ import { threePhasePromptLines } from './three-phase.js';
19
+ export { allowedEffortsForModel, classifyModelFamily, effortForComplexity, effortsForModelFamily, highestEffortOf, OTHER_MODEL_EFFORTS, QWEN_MODEL_EFFORTS, };
20
+ /** 兼容别名:T3 计划文本中的 detectLlmType ≡ 真源 classifyModelFamily。 */
21
+ export const detectLlmType = classifyModelFamily;
22
+ /** 兼容别名:T3 计划文本中的 getAllowedEffortLevels(llmType) ≡ 真源 effortsForModelFamily。 */
23
+ export const getAllowedEffortLevels = effortsForModelFamily;
24
+ /**
25
+ * 集合校验(用户要求 1/2 的硬白名单判定)。
26
+ * @param effort 待校验档位
27
+ * @param allowed 等级集合(null=模型未知,不施加约束,任何值都 ok)
28
+ */
29
+ export function validateReasoningEffort(effort, allowed) {
30
+ if (allowed === null)
31
+ return { ok: true };
32
+ if (typeof effort !== 'string' || !allowed.includes(effort)) {
33
+ return {
34
+ ok: false,
35
+ error: `reasoningEffort "${String(effort)}" 不在当前模型家族的推理等级集合 {${allowed.join(', ')}} 内(qwen 系仅 low/medium/xhigh;非 qwen 系仅 low/high/max)——请改用集合内档位`,
36
+ };
37
+ }
38
+ return { ok: true };
39
+ }
40
+ /** 静态强度序(与 runtime.ts EFFORT_STRENGTH_ORDER 同源语义)。 */
41
+ const STATIC_STRENGTH_ORDER = Object.freeze(['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max']);
42
+ /**
43
+ * 越界自动降级修正(A3 修正轨):请求档不在家族集合内时,钳到集合内「不高于
44
+ * 请求档」的最近档(按强度序逐级下探:qwen 下 max→xhigh、high→medium;非 qwen
45
+ * 下 xhigh→high、medium→low),全部更弱则取最弱档;集合未知(模型名缺失)
46
+ * ⇒ 原样透传。派发绝不因档位问题中断。
47
+ */
48
+ export function correctEffortForModel(effort, modelId) {
49
+ const allowed = allowedEffortsForModel(modelId);
50
+ if (allowed === null)
51
+ return { effort, adjusted: false, requested: effort };
52
+ if (allowed.includes(effort))
53
+ return { effort, adjusted: false, requested: effort };
54
+ const rank = (id) => STATIC_STRENGTH_ORDER.indexOf(id);
55
+ const ranked = [...allowed].sort((a, b) => rank(a) - rank(b));
56
+ const target = rank(effort);
57
+ const corrected = target < 0
58
+ ? ranked[0]
59
+ : (() => {
60
+ const atOrBelow = ranked.filter((id) => rank(id) >= 0 && rank(id) <= target);
61
+ return atOrBelow.length > 0 ? atOrBelow[atOrBelow.length - 1] : ranked[0];
62
+ })();
63
+ const family = classifyModelFamily(modelId);
64
+ return {
65
+ effort: corrected,
66
+ adjusted: true,
67
+ requested: effort,
68
+ reason: `${family === 'qwen' ? 'qwen-rule' : 'non-qwen-rule'}:${effort}→${corrected}(模型家族等级集合为 {${allowed.join(', ')}},越界档按强度序自动降级)`,
69
+ };
70
+ }
71
+ /**
72
+ * 要求 1/2 的规则全文(供 T4/T4b 部门告知注入引用同一事实源,避免文案漂移)。
73
+ */
74
+ export const LLM_REASONING_RULES_TEXT = [
75
+ '1. 分配任务前先判断用户此刻使用的大模型:字母 qwen 开头的模型,推理等级只包括 low、medium、xhigh——轻度任务使用 low,比较复杂的任务使用 medium,非常复杂的任务使用 xhigh。',
76
+ '2. 非 qwen 开头的其他大模型,推理等级只包括 low、high、max——轻度任务使用 low,比较复杂的任务使用 high,非常复杂的任务使用 max。',
77
+ ].join('\n');
78
+ export function buildLlmRulesBrief(info = {}) {
79
+ const family = info.family ?? classifyModelFamily(info.model ?? null);
80
+ const allowed = info.allowed ?? allowedEffortsForModel(info.model ?? null);
81
+ const lines = [
82
+ '[2.3.9][LLM 推理等级强制规则——用户要求 1/2 全文(部门、专家、组员全员告知,必须遵守)]',
83
+ LLM_REASONING_RULES_TEXT,
84
+ `- 本会话模型:${info.model || '(未知,不施加静态等级约束)'}`
85
+ + (info.model ? `(家族:${family === 'qwen' ? 'qwen 系' : '非 qwen 系'})` : '')
86
+ + (allowed ? `;可用推理等级集合:{${allowed.join(', ')}}` : ''),
87
+ ];
88
+ if (info.effort) {
89
+ const adjusted = Boolean(info.requested) && info.requested !== info.effort;
90
+ lines.push(`- 本任务的推理等级已按任务复杂度配置为 \`${info.effort}\`,必须全程应用(开工预告、执行、验证、复盘全生命周期生效)`
91
+ + (adjusted
92
+ ? `;请求档 \`${info.requested}\` 越出当前模型家族等级集合,已按规则自动钳制修正${info.correctionReason ? `(${info.correctionReason})` : ''}。`
93
+ : '。'));
94
+ }
95
+ if (info.tier === 'delegate') {
96
+ lines.push(`- 你是部门第三层执行者(${info.memberRole === 'expert' ? '本部门相关领域全球顶尖专家' : '本部门组员'}${info.memberName ? `:${info.memberName}` : ''})。你的等级由部门负责人按你分到任务的复杂度配置并经平台按上述等级集合强制约束;越界档会被钳制并留痕。必须确保自身任务完成品质非常高的前提下,完美、超高效率地执行。`);
97
+ }
98
+ else {
99
+ lines.push('- 部门负责人(本任务书的直接接收者)强制流程(用户要求 4/5):接到任务后必须先全面、全盘、深入梳理与研究,再用 dsh_workplan_delegate(action="review") 提交梳理产物(问题梳理 + 分工表 + 每位专家/组员的推理等级配置);梳理产物未提交前,dsh_workplan_delegate(action="dispatch") 会被平台拒绝(硬门禁)。梳理完成后再把任务合理分配给本部门相关领域全球顶尖专家与本部门组员;每位下级必须按自己分到任务的复杂度配置相应推理等级(轻度=low;qwen 中等=medium、非 qwen 中等=high;qwen 非常复杂=xhigh、非 qwen 非常复杂=max),全程应用;平台会按上述等级集合自动钳制越界档并留痕,等级在其任务全生命周期生效且不可被覆盖。第三层为叶子层:任何第四层派发一律被拒绝。');
100
+ }
101
+ return lines.join('\n');
102
+ }
103
+ const MAX_DELEGATE_MEMBERS = 6;
104
+ function readTrimmedStrings(value, limit) {
105
+ return (Array.isArray(value) ? value : [])
106
+ .map((item) => String(item ?? '').trim())
107
+ .filter(Boolean)
108
+ .slice(0, limit);
109
+ }
110
+ /**
111
+ * 梳理产物校验 + 分工表校验 + 等级钳制,三合一(一次调用给出全部拒因)。
112
+ * @param input.consolidation 部门负责人提交的梳理产物(review 阶段写入行,
113
+ * dispatch 阶段从行读回;两处都走这里,门禁与派发同一判据)
114
+ * @param input.model 当前会话模型 id(未知 ⇒ allowed=null ⇒ 不施加静态收窄,
115
+ * 但仍必须落在五档存储全集内——枚举校验永不放松)
116
+ */
117
+ export function planDelegations(input) {
118
+ const empty = { ok: false, code: 'DELEGATE_CONSOLIDATION_MISSING', members: [], clamped: [] };
119
+ const consolidation = input?.consolidation;
120
+ if (!consolidation || typeof consolidation !== 'object') {
121
+ return { ...empty, error: '尚未提交「全面梳理」产物:先用 dsh_workplan_delegate(action="review") 提交问题梳理与分工表,派发才会放行(用户要求 4 的硬门禁)。' };
122
+ }
123
+ const problemAnalysis = readTrimmedStrings(consolidation.problemAnalysis, 12);
124
+ if (problemAnalysis.length === 0) {
125
+ return { ...empty, code: 'DELEGATE_CONSOLIDATION_INCOMPLETE', error: '梳理产物不完整:problemAnalysis 至少 1 条(现状/事实/约束/未知/主要矛盾逐条写清),未梳理完不得进入再分配。' };
126
+ }
127
+ const assignments = (Array.isArray(consolidation.assignments) ? consolidation.assignments : []).slice(0, MAX_DELEGATE_MEMBERS);
128
+ if (assignments.length === 0) {
129
+ return { ...empty, code: 'DELEGATE_CONSOLIDATION_INCOMPLETE', error: '梳理产物不完整:分工表 assignments 至少 1 条(member/role/task/reasoningEffort 四项齐全)。' };
130
+ }
131
+ const allowed = allowedEffortsForModel(input.model ?? null);
132
+ const members = [];
133
+ const clamped = [];
134
+ let experts = 0;
135
+ let regular = 0;
136
+ for (let index = 0; index < assignments.length; index += 1) {
137
+ const item = assignments[index] ?? {};
138
+ const member = truncate(String(item.member ?? '').trim(), 80);
139
+ const role = item.role === 'expert' ? 'expert' : item.role === 'member' ? 'member' : '';
140
+ const task = truncate(String(item.task ?? '').trim(), 1500);
141
+ if (!member || !role || !task) {
142
+ return {
143
+ ok: false,
144
+ code: 'DELEGATE_ASSIGNMENT_INVALID',
145
+ members: [],
146
+ clamped: [],
147
+ error: `分工表第 ${index + 1} 条不完整:member(姓名/代号)、role(expert|member)、task(分到的任务)三者都必须非空。`,
148
+ };
149
+ }
150
+ const requested = REASONING_EFFORTS.includes(item.reasoningEffort)
151
+ ? String(item.reasoningEffort)
152
+ : (allowed === null ? 'low' : (highestEffortOf(allowed) ?? 'low'));
153
+ const outOfSet = allowed !== null && !allowed.includes(requested);
154
+ const correction = outOfSet ? correctEffortForModel(requested, input.model ?? null) : null;
155
+ const effort = correction ? correction.effort : requested;
156
+ if (correction) {
157
+ clamped.push({ member, requested, corrected: correction.effort, reason: correction.reason ?? '' });
158
+ }
159
+ if (role === 'expert')
160
+ experts += 1;
161
+ else
162
+ regular += 1;
163
+ members.push({
164
+ member,
165
+ role,
166
+ task,
167
+ effort,
168
+ ...(outOfSet ? { requested, correctionReason: correction?.reason } : {}),
169
+ });
170
+ }
171
+ if (experts === 0 || regular === 0) {
172
+ return {
173
+ ok: false,
174
+ code: 'DELEGATE_ROLE_MIX_REQUIRED',
175
+ members: [],
176
+ clamped: [],
177
+ error: '分工表必须同时覆盖「本部门相关领域全球顶尖专家」与「本部门组员」(各至少 1 名,用户要求 4):当前 expert=' + experts + '、member=' + regular + '。',
178
+ };
179
+ }
180
+ return {
181
+ ok: true,
182
+ members,
183
+ clamped,
184
+ consolidation: {
185
+ problemAnalysis,
186
+ constraints: readTrimmedStrings(consolidation.constraints, 12),
187
+ unknowns: readTrimmedStrings(consolidation.unknowns, 12),
188
+ approach: readTrimmedStrings(consolidation.approach, 12),
189
+ assignments: members.length,
190
+ },
191
+ };
192
+ }
193
+ /**
194
+ * [2.3.9][T4b] 第三层任务书:部门负责人 → 顶尖专家/组员子会话。
195
+ *
196
+ * 与二级任务书(buildChildPrompt)共享同一注入事实源 buildLlmRulesBrief
197
+ * (tier='delegate'),要求 1/2 全文与「等级全程应用、越界钳制留痕」的
198
+ * 口径不可能在两处漂移;叶子层禁令(不得再派生第四层)直接写进任务书,
199
+ * 服务端 delegateTool 另有一道硬拒——提示词说服模型,代码守住边界。
200
+ */
201
+ export function buildDelegateePrompt(input) {
202
+ const roleLabel = input.member.role === 'expert' ? '本部门相关领域全球顶尖专家' : '本部门组员';
203
+ return defuseSessionReferenceText([
204
+ `你是「${input.departmentLabel ?? '部门'}」的${roleLabel}(${input.member.member}),由部门负责人直接分配,只负责下面这一项分配到的工作。`,
205
+ `负责人任务:${input.leaderSubtaskId ?? ''} ${input.leaderSubtaskTitle ?? ''}`,
206
+ `你的任务:${input.member.task}`,
207
+ `工作目录:${input.cwd || '(未知)'}`,
208
+ ...(input.extraContext ? ['', input.extraContext] : []),
209
+ '',
210
+ input.rulesBrief,
211
+ '',
212
+ '执行要求(用户强制要求 5 原文口径):',
213
+ '- 你分到的推理等级已按任务复杂度配置并由平台按当前模型等级集合钳制生效:必须全程应用(规划、执行、验证、复盘全生命周期),不得自行换档。',
214
+ '- 必须在确保自身任务完成品质非常高的前提下,完美、超高效率地执行;严禁低效执行与浪费 token。',
215
+ '- 你是第三层叶子执行者:不得派生任何第四层 Agent/子会话;无法完成时在结论首行写 BLOCKED: 原因 并说明缺什么,不要空转。',
216
+ '- 完成后把结论与逐项证据(命令输出/文件/引用)用简洁中文回报给部门负责人会话;同时把同一份结构化结论写入 reports/wp-member-<你的成员名>-<任务代号>.json(相对工作目录,目录不存在就创建)作为结算兜底。',
217
+ `- 结果块契约:以 ${EVIDENCE_MARKER_BEGIN} 开头、${EVIDENCE_MARKER_END} 结尾,内含合法 JSON(status ∈ done/blocked/partial、phases 三阶段、acceptance 逐条带证据)。`,
218
+ '',
219
+ ...threePhasePromptLines(),
220
+ ].filter(Boolean).join('\n'));
221
+ }