dsh-workplan 2.3.9 → 3.0.1
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 +161 -0
- package/README.en.md +20 -18
- package/README.md +33 -19
- package/README.zh.md +15 -19
- package/client.js +88 -59
- package/docs/cc/ADV-FSP-FUNCTIONAL-SPEC.md +19 -6
- package/docs/cc/ADV-TDS-TOE-DESIGN.md +3 -3
- package/docs/cc/AGD-OPS-SECURE-OPERATION.md +3 -7
- package/docs/cc/AVA-VULNERABILITY-ANALYSIS.md +22 -3
- package/docs/cc/SECURITY-TARGET.md +6 -6
- package/docs/collaboration.md +17 -16
- package/lib/approval-gate.js +144 -0
- package/lib/client.js +88 -59
- package/lib/comm-format.js +58 -6
- package/lib/criterion.js +210 -0
- package/lib/dept-journal.js +319 -0
- package/lib/host.js +333 -63
- package/lib/llm-rules.js +281 -24
- package/lib/plan.js +1468 -219
- package/lib/replan.js +50 -39
- package/lib/runtime.js +3474 -1088
- package/lib/three-phase.js +106 -20
- package/lib/understanding.js +18 -3
- package/lib/v3-contract.js +431 -0
- package/lib/watchdog.js +9 -1
- package/package.json +4 -3
- package/src/approval-gate.ts +168 -0
- package/src/client.ts +88 -59
- package/src/comm-format.ts +63 -5
- package/src/criterion.ts +261 -0
- package/src/dept-journal.ts +373 -0
- package/src/host.ts +341 -64
- package/src/llm-rules.ts +349 -27
- package/src/plan.ts +1464 -210
- package/src/replan.ts +48 -37
- package/src/runtime.ts +3028 -699
- package/src/three-phase.ts +147 -20
- package/src/understanding.ts +20 -3
- package/src/v3-contract.ts +470 -0
- package/src/watchdog.ts +13 -1
package/lib/criterion.js
ADDED
|
@@ -0,0 +1,210 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* [3.0.1][历史模块] 「简单」判据 v2 · 判据层(criterion layer)。
|
|
3
|
+
*
|
|
4
|
+
* **生产已停用**:用户已取消部门负责人及全球顶尖专家的执行时限,
|
|
5
|
+
* `criterionV2Active()` 现在无条件返回 false,任何环境变量、计划时间或旧字段
|
|
6
|
+
* 都不能重新开启 `≤10 分钟才能 done` 的间接时间门。本文件保留纯函数,仅供
|
|
7
|
+
* 旧记录回放、历史审计和既有单元测试解释当时规则,不参与新任务结算。
|
|
8
|
+
*
|
|
9
|
+
* 口径来源(历史,逐字保留以便追溯):
|
|
10
|
+
* - reports/simple-criterion-v2-spec.md(用户 2026-11-13 裁决 B/B/B/B/A/A/B):
|
|
11
|
+
* S-Q1-1..6 / S-Q2-1..4 / S-Q3-1..4 / S-Q4-1..5 / S-Q5-1..5 / S-Q6-1..5 / S-Q7-1..5,
|
|
12
|
+
* §3.5 唯一判定链(met / exception-approved / unmet 三选一)。
|
|
13
|
+
* - reports/simple-criterion-v2-touchpoints.md C05–C10 / C22 / C29(机制落点)。
|
|
14
|
+
* - reports/simple-criterion-v2-open-decisions.md D-1~D-4 推荐项(均选 A,
|
|
15
|
+
* **待用户裁定**;本模块按推荐实现,裁定前不得据以宣称达标)。
|
|
16
|
+
*
|
|
17
|
+
* 分层纪律(Q7-B,红线):
|
|
18
|
+
* - 本模块只承载**判据层**(完成目标 ≤10 分钟);**运行层**安全兜底
|
|
19
|
+
* (CHILD_TIMEOUT_MS=900000 / MAX_CHILD_TIMEOUT_MS=7200000 /
|
|
20
|
+
* deriveSubtaskTimeoutMs 公式 / L4 结算)数值与公式一律不改。
|
|
21
|
+
* - 判据层不改变运行层时限;运行层允许延长不等于判据层达标。
|
|
22
|
+
*
|
|
23
|
+
* 历史生效边界(Q5-A/D-1;当前已全部失效):
|
|
24
|
+
* - 旧版本曾用 DSH_WORKPLAN_CRITERION_V2 与 _SINCE 按计划创建时间开启;
|
|
25
|
+
* - [3.0.1] 该开关已被硬编码关闭,且不得恢复。即使环境变量齐全、计划新建,
|
|
26
|
+
* `criterionV2Active()` 仍为 false;时长不参与 done 判定。
|
|
27
|
+
* - `evaluateCriterion` 等纯函数仍可被历史测试/审计直接调用,但其结论不会
|
|
28
|
+
* 进入生产结算路径。
|
|
29
|
+
*
|
|
30
|
+
* 本模块不 import plan.ts / runtime.ts(避免循环依赖):聚合结果
|
|
31
|
+
* (LeaderEstimateSummary 形状)由调用方以参数传入。
|
|
32
|
+
*/
|
|
33
|
+
/** [历史] 旧判据层目标(分钟);仅供纯函数审计,不参与新任务验收。 */
|
|
34
|
+
export const CRITERION_TARGET_MINUTES = 10;
|
|
35
|
+
/** 结算判据三选一(spec §3.5 第 4 步)。 */
|
|
36
|
+
export const CRITERION_RESULTS = ['met', 'unmet', 'exception-approved'];
|
|
37
|
+
function isRecord(value) {
|
|
38
|
+
return value !== null && typeof value === 'object' && !Array.isArray(value);
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* fail-closed 消毒(与 sanitizeDelegateEstimate 同风格):任一必填项缺失/非法
|
|
42
|
+
* ⇒ 整个批准丢弃(返回 null),绝不入库脏值、绝不把「未批准」洗成「已批准」。
|
|
43
|
+
*/
|
|
44
|
+
export function sanitizeCriterionException(value) {
|
|
45
|
+
if (!isRecord(value))
|
|
46
|
+
return null;
|
|
47
|
+
if (value.approvedBy !== 'user')
|
|
48
|
+
return null;
|
|
49
|
+
const at = Number(value.at);
|
|
50
|
+
if (!Number.isFinite(at) || at <= 0)
|
|
51
|
+
return null;
|
|
52
|
+
const reason = typeof value.reason === 'string' ? value.reason.trim() : '';
|
|
53
|
+
if (reason === '')
|
|
54
|
+
return null;
|
|
55
|
+
if (value.scope !== 'task' && value.scope !== 'plan')
|
|
56
|
+
return null;
|
|
57
|
+
const extendedMs = Number(value.extendedMs);
|
|
58
|
+
const extendedMinutes = Number(value.extendedMinutes);
|
|
59
|
+
return {
|
|
60
|
+
approvedBy: 'user',
|
|
61
|
+
at,
|
|
62
|
+
reason: reason.slice(0, 2000),
|
|
63
|
+
...(typeof value.source === 'string' && value.source.trim() !== ''
|
|
64
|
+
? { source: value.source.trim().slice(0, 500) }
|
|
65
|
+
: {}),
|
|
66
|
+
scope: value.scope,
|
|
67
|
+
...(Number.isFinite(extendedMs) && extendedMs > 0 ? { extendedMs: Math.floor(extendedMs) } : {}),
|
|
68
|
+
...(Number.isFinite(extendedMinutes) && extendedMinutes > 0
|
|
69
|
+
? { extendedMinutes: Math.round(extendedMinutes * 100) / 100 }
|
|
70
|
+
: {}),
|
|
71
|
+
};
|
|
72
|
+
}
|
|
73
|
+
/**
|
|
74
|
+
* [3.0.1] 判据 v2 是否对该计划生效。
|
|
75
|
+
*
|
|
76
|
+
* 现在恒为 false:这是取消执行时限后的硬边界,不是默认值。保留参数是为了
|
|
77
|
+
* 兼容旧调用签名与历史测试;任何环境变量都不能让判据重新进入生产结算。
|
|
78
|
+
*/
|
|
79
|
+
export function criterionV2Active(planCreatedAt, env = process.env) {
|
|
80
|
+
// 用户已取消部门负责人及全球顶尖专家的执行时限:历史环境变量不得重新启用
|
|
81
|
+
// “≤10 分钟才能 done”的间接时间门。evaluateCriterion 仍保留供历史记录/回放审计。
|
|
82
|
+
void planCreatedAt;
|
|
83
|
+
void env;
|
|
84
|
+
return false;
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* [SCv2-T4][Q6-A/C28/C29] 单次尝试墙钟(毫秒)=结算时间 − 尝试起点。
|
|
88
|
+
*
|
|
89
|
+
* 数据源只认 journal 时间戳(startedAt/finishedAt),绝不采用模型自报分钟数
|
|
90
|
+
* (S-Q6-3)。已知陷阱(touchpoints C29 ⚠):预算重置会清空 startedAt/finishedAt
|
|
91
|
+
* ——缺失时返回 null(「未验证」),**绝不返回 0**(否则把「计时被清空」误判成
|
|
92
|
+
* 「0 分钟完成」)。每次尝试独立计量,不跨尝试累计(S-Q6-1/2)。
|
|
93
|
+
*/
|
|
94
|
+
export function attemptWallClockMsOf(row) {
|
|
95
|
+
if (!isRecord(row))
|
|
96
|
+
return null;
|
|
97
|
+
// null/undefined 必须显式拒绝:Number(null)===0 会把「计时被重置清空」
|
|
98
|
+
// 误判成「0 分钟完成」(Q6-A 唯一实现陷阱,touchpoints C29 ⚠)。
|
|
99
|
+
if (row.startedAt === null || row.startedAt === undefined)
|
|
100
|
+
return null;
|
|
101
|
+
if (row.finishedAt === null || row.finishedAt === undefined)
|
|
102
|
+
return null;
|
|
103
|
+
const started = Number(row.startedAt);
|
|
104
|
+
const finished = Number(row.finishedAt);
|
|
105
|
+
if (!Number.isFinite(started) || !Number.isFinite(finished))
|
|
106
|
+
return null;
|
|
107
|
+
return Math.max(0, finished - started);
|
|
108
|
+
}
|
|
109
|
+
/**
|
|
110
|
+
* [SCv2-T4][Q4-B/D-2 推荐 A/D-3 推荐 A] 部门行事前预估口径。
|
|
111
|
+
*
|
|
112
|
+
* - 有叶子(leaderEstimate 非 null):事前值=全部叶子最新 sent 预估之和;
|
|
113
|
+
* reported===expected 才算「齐」(部分和不得视为达标,S-Q4-5/D-3)。
|
|
114
|
+
* - 无叶子直做(leaderEstimate null):事前值=负责人自身开工预估
|
|
115
|
+
* (row.timeNotice.declaredMinutes,D-2 推荐 A,对称于叶子之和);缺失⇒不齐。
|
|
116
|
+
* 绝不因「没有叶子」而自动豁免(S-Q4-4)。
|
|
117
|
+
*
|
|
118
|
+
* leaderEstimate 由调用方传 plan.ts deriveLeaderEstimate 的结果(形状兼容),
|
|
119
|
+
* 本模块不重复求和、不反写台账(F6/J8 同纪律)。
|
|
120
|
+
*/
|
|
121
|
+
export function criterionExAnte(row, leaderEstimate) {
|
|
122
|
+
if (leaderEstimate && Number.isFinite(Number(leaderEstimate.totalMinutes))) {
|
|
123
|
+
return {
|
|
124
|
+
minutes: Number(leaderEstimate.totalMinutes),
|
|
125
|
+
complete: leaderEstimate.reported === leaderEstimate.expected && leaderEstimate.expected > 0,
|
|
126
|
+
};
|
|
127
|
+
}
|
|
128
|
+
const notice = isRecord(row) && isRecord(row.timeNotice) ? row.timeNotice : null;
|
|
129
|
+
const declared = notice ? Number(notice.declaredMinutes) : NaN;
|
|
130
|
+
if (Number.isFinite(declared) && declared > 0)
|
|
131
|
+
return { minutes: declared, complete: true };
|
|
132
|
+
return { minutes: null, complete: false };
|
|
133
|
+
}
|
|
134
|
+
/**
|
|
135
|
+
* [SCv2-T4][spec §3.5 第 4 步 / S-Q6-5 / D-4 推荐 A] 判据层结算判定(纯函数)。
|
|
136
|
+
*
|
|
137
|
+
* 达标(met)=事前预估之和 ≤10 **且** 事后单次尝试墙钟 ≤10(双条件同时满足);
|
|
138
|
+
* 任一不满足且无有效用户批准 ⇒ unmet(不得 done、记违规、转接替行);
|
|
139
|
+
* 有有效用户批准 ⇒ exception-approved(可 done、留例外、不生成接替行)。
|
|
140
|
+
*
|
|
141
|
+
* 批准时机(C-4 推荐 A,待裁定):批准必须不晚于本次结算(at <= settledAt);
|
|
142
|
+
* 结算后追认一律无效(防「事后洗白」),只能批准接替行。
|
|
143
|
+
*
|
|
144
|
+
* 严格口径(D-3 推荐 A,待裁定):事前预估未齐 / 墙钟缺失(被重置清空)
|
|
145
|
+
* ⇒ 不得宣称达标,按 unmet 处理并如实给出 reasons;受平台缺陷影响的行
|
|
146
|
+
* 可经 Q1 例外审批留痕后豁免(exception-approved 分支)。
|
|
147
|
+
*/
|
|
148
|
+
export function evaluateCriterion(input) {
|
|
149
|
+
const reasons = [];
|
|
150
|
+
let over = false;
|
|
151
|
+
if (!input.exAnteComplete) {
|
|
152
|
+
over = true;
|
|
153
|
+
reasons.push('ex-ante-incomplete:事前预估未齐或缺失(D-3 严格口径,不得视为达标)');
|
|
154
|
+
}
|
|
155
|
+
else if (input.exAnteMinutes !== null && input.exAnteMinutes > CRITERION_TARGET_MINUTES) {
|
|
156
|
+
over = true;
|
|
157
|
+
reasons.push(`ex-ante-over:事前预估 ${input.exAnteMinutes} 分钟 > ${CRITERION_TARGET_MINUTES} 分钟目标`);
|
|
158
|
+
}
|
|
159
|
+
if (input.wallClockMs === null) {
|
|
160
|
+
over = true;
|
|
161
|
+
reasons.push('wall-clock-unverified:单次尝试墙钟缺失(计时被重置或无时间戳),不得按 0 分钟判达标(Q6-A)');
|
|
162
|
+
}
|
|
163
|
+
else if (input.wallClockMs > CRITERION_TARGET_MINUTES * 60_000) {
|
|
164
|
+
over = true;
|
|
165
|
+
reasons.push(`wall-clock-over:本次尝试墙钟 ${(input.wallClockMs / 60_000).toFixed(2)} 分钟 > ${CRITERION_TARGET_MINUTES} 分钟目标`);
|
|
166
|
+
}
|
|
167
|
+
if (!over) {
|
|
168
|
+
return { criterionResult: 'met', canBeDone: true, needsReplacement: false, exceptionRecorded: false, reasons };
|
|
169
|
+
}
|
|
170
|
+
const exception = input.exception ?? null;
|
|
171
|
+
if (exception) {
|
|
172
|
+
const settledAt = Number.isFinite(Number(input.settledAt)) ? Number(input.settledAt) : Date.now();
|
|
173
|
+
if (exception.at <= settledAt) {
|
|
174
|
+
return {
|
|
175
|
+
criterionResult: 'exception-approved',
|
|
176
|
+
canBeDone: true,
|
|
177
|
+
needsReplacement: false,
|
|
178
|
+
exceptionRecorded: true,
|
|
179
|
+
reasons: [...reasons, 'user-exception:用户明确批准并留痕(Q1-B 唯一例外通道)'],
|
|
180
|
+
};
|
|
181
|
+
}
|
|
182
|
+
reasons.push('approval-after-settlement:批准时间晚于本次结算,事后追认无效(C-4 推荐 A)');
|
|
183
|
+
}
|
|
184
|
+
return { criterionResult: 'unmet', canBeDone: false, needsReplacement: true, exceptionRecorded: false, reasons };
|
|
185
|
+
}
|
|
186
|
+
/**
|
|
187
|
+
* [SCv2-T4] T5 参考实现 referenceQ3Settlement 的同口径生产适配器(分钟入参)。
|
|
188
|
+
* 生产接线落盘后 T5 只需把 referenceQ3* 替换为本导出,断言口径保持不变。
|
|
189
|
+
*/
|
|
190
|
+
export function q3SettlementVerdict(input) {
|
|
191
|
+
const exception = input.userApproved === true
|
|
192
|
+
? { approvedBy: 'user', at: 1, reason: 'user-approved(参考夹具口径)', scope: 'task' }
|
|
193
|
+
: null;
|
|
194
|
+
return evaluateCriterion({
|
|
195
|
+
exAnteMinutes: Number(input.declaredMinutes ?? 0),
|
|
196
|
+
exAnteComplete: true,
|
|
197
|
+
wallClockMs: Number(input.wallClockMinutes ?? 0) * 60_000,
|
|
198
|
+
exception,
|
|
199
|
+
settledAt: Date.now(),
|
|
200
|
+
});
|
|
201
|
+
}
|
|
202
|
+
/**
|
|
203
|
+
* [SCv2-T4][D-4 推荐 A] 判据违规审计条目(append-only,绝不抹除)。
|
|
204
|
+
* 行级最终结果取最后一次(接替)尝试;原始未批准超时保留在本数组供审计,
|
|
205
|
+
* 防「续跑洗白」。上限 20 条与 timeJournal 同纪律。
|
|
206
|
+
*/
|
|
207
|
+
export function appendCriterionViolation(existing, entry) {
|
|
208
|
+
const list = Array.isArray(existing) ? existing.filter(isRecord) : [];
|
|
209
|
+
return [...list, { ...entry, kind: 'criterion-overrun' }].slice(-20);
|
|
210
|
+
}
|
|
@@ -0,0 +1,319 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* [2.5.4][T5] 部门消息留痕(journal)——用户决策 D5/D6 的持久化底座。
|
|
3
|
+
*
|
|
4
|
+
* 唯一权威契约:_t5_channel_20261112/00-contract-v1.md(FROZEN,T5 负责人冻结)。
|
|
5
|
+
* 本文件严格实现契约 §1 消息结构与 §2 冻结导出;其他人只 import 不改。
|
|
6
|
+
* 任何字段/语义变更必须经 T5 负责人重新冻结,不得私改。
|
|
7
|
+
*
|
|
8
|
+
* 设计纪律(契约 §2/§6):
|
|
9
|
+
* - 纯函数 + 同步 fs,不依赖 harness 服务,不 import runtime/plan(避免环);
|
|
10
|
+
* 落盘模式参照 src/lessons.ts(JSONL 追加写、容错读取、坏行不静默吞)。
|
|
11
|
+
* - fail-closed:未知 kind/role、缺字段、超限一律拒(validateDeptMessage)。
|
|
12
|
+
* - 一切失败显式返回(JOURNAL_WRITE_FAILED / JOURNAL_READ_FAILED),绝不静默;
|
|
13
|
+
* planId 只允许 [A-Za-z0-9_-]{1,120},非法抛 INVALID_PLAN_ID(防路径穿越)。
|
|
14
|
+
* - 目录 env DSH_WORKPLAN_JOURNAL_DIR || ~/.dsh/workplan/journal;文件 <planId>.jsonl。
|
|
15
|
+
* - 本模块只负责留痕的写/读/校验,不做任何投递与状态判定(路由归 runtime.ts,
|
|
16
|
+
* 由 channel-expert 按契约 §3 实现)。
|
|
17
|
+
*/
|
|
18
|
+
import { randomBytes } from 'node:crypto';
|
|
19
|
+
import { appendFileSync, existsSync, mkdirSync, readFileSync } from 'node:fs';
|
|
20
|
+
import { homedir } from 'node:os';
|
|
21
|
+
import { dirname, join } from 'node:path';
|
|
22
|
+
/** 接口版本(契约 §1:字面量 1)。 */
|
|
23
|
+
export const DEPT_MESSAGE_VERSION = 1;
|
|
24
|
+
/** 7 种关键沟通(frozen 数组,契约 §1/§2;日常闲聊不属于任何 kind,不入库)。 */
|
|
25
|
+
export const DEPT_MESSAGE_KINDS = Object.freeze([
|
|
26
|
+
'dispatch',
|
|
27
|
+
'instruction',
|
|
28
|
+
'escalation',
|
|
29
|
+
'estimate',
|
|
30
|
+
'completion',
|
|
31
|
+
'need',
|
|
32
|
+
'receipt',
|
|
33
|
+
]);
|
|
34
|
+
/**
|
|
35
|
+
* 角色枚举(frozen 数组,契约 §1/§2)。
|
|
36
|
+
*
|
|
37
|
+
* [3.0.0][用户要求 9] 部门组员角色已取消:新写入只使用 root/head/expert。
|
|
38
|
+
* `member` 保留在枚举里仅用于**读取历史 journal**(append-only 历史记录不可
|
|
39
|
+
* 追溯改写,拒绝读取会让旧会话的回放直接失败);现有代码不再产生该值。
|
|
40
|
+
*/
|
|
41
|
+
export const DEPT_ROLES = Object.freeze([
|
|
42
|
+
'root',
|
|
43
|
+
'head',
|
|
44
|
+
'expert',
|
|
45
|
+
'member',
|
|
46
|
+
]);
|
|
47
|
+
/* —— 契约 §1 的边界常量(私有;数值全部来自冻结契约,不得私改) —— */
|
|
48
|
+
const MAX_ID_CHARS = 80;
|
|
49
|
+
const MAX_TS = 8.64e15;
|
|
50
|
+
const MAX_PLAN_ID_CHARS = 120;
|
|
51
|
+
/** subtaskId 契约未给上限;取与 planId 同宽的防御边界(行 ID 形如 T5/R1-2,远小于此)。 */
|
|
52
|
+
const MAX_SUBTASK_ID_CHARS = 120;
|
|
53
|
+
const MAX_SESSION_ID_CHARS = 200;
|
|
54
|
+
const MAX_MEMBER_CHARS = 80;
|
|
55
|
+
const MAX_BODY_CHARS = 4000;
|
|
56
|
+
const MAX_DATA_JSON_CHARS = 4000;
|
|
57
|
+
const MAX_DELIVERY_MESSAGE_ID_CHARS = 200;
|
|
58
|
+
const MAX_DELIVERY_CODE_CHARS = 80;
|
|
59
|
+
const MAX_DELIVERY_ERROR_CHARS = 4000;
|
|
60
|
+
const DEFAULT_READ_LIMIT = 500;
|
|
61
|
+
const MAX_READ_LIMIT = 5000;
|
|
62
|
+
const PLAN_ID_PATTERN = /^[A-Za-z0-9_-]{1,120}$/;
|
|
63
|
+
function isRecord(value) {
|
|
64
|
+
return !!value && typeof value === 'object' && !Array.isArray(value);
|
|
65
|
+
}
|
|
66
|
+
/** 与 lessons.ts 同口径:去掉不可见控制字符,保留 \t \n \r。 */
|
|
67
|
+
function cleanBody(value) {
|
|
68
|
+
return value.replace(/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/g, '');
|
|
69
|
+
}
|
|
70
|
+
function errorText(error) {
|
|
71
|
+
const text = error instanceof Error ? error.message : String(error);
|
|
72
|
+
return text.slice(0, 500);
|
|
73
|
+
}
|
|
74
|
+
function isNonEmptyString(value, maxChars) {
|
|
75
|
+
return typeof value === 'string' && value.trim().length > 0 && value.length <= maxChars;
|
|
76
|
+
}
|
|
77
|
+
/**
|
|
78
|
+
* 生成消息 id:msg-<ts36>-<rand6>(契约 §1)。
|
|
79
|
+
* now 非法(缺省/非有限/越界)时回退 Date.now();总长恒 ≤80。
|
|
80
|
+
*/
|
|
81
|
+
export function makeDeptMessageId(now) {
|
|
82
|
+
const ts = typeof now === 'number' && Number.isFinite(now) && now > 0 && now <= MAX_TS
|
|
83
|
+
? Math.floor(now)
|
|
84
|
+
: Date.now();
|
|
85
|
+
return `msg-${ts.toString(36)}-${randomBytes(3).toString('hex')}`;
|
|
86
|
+
}
|
|
87
|
+
function validateEndpoint(value, label) {
|
|
88
|
+
if (!isRecord(value))
|
|
89
|
+
return `${label} 必须是对象`;
|
|
90
|
+
const sessionId = value.sessionId;
|
|
91
|
+
if (!isNonEmptyString(sessionId, MAX_SESSION_ID_CHARS)) {
|
|
92
|
+
return `${label}.sessionId 必填且 ≤${MAX_SESSION_ID_CHARS} 字符`;
|
|
93
|
+
}
|
|
94
|
+
const role = value.role;
|
|
95
|
+
if (typeof role !== 'string' || !DEPT_ROLES.includes(role)) {
|
|
96
|
+
return `${label}.role 非法(期望 ${DEPT_ROLES.join('/')})`;
|
|
97
|
+
}
|
|
98
|
+
const member = value.member;
|
|
99
|
+
const needsMember = role === 'expert' || role === 'member';
|
|
100
|
+
if (needsMember && !isNonEmptyString(member, MAX_MEMBER_CHARS)) {
|
|
101
|
+
return `${label}.member 必填(expert/member 角色)且 ≤${MAX_MEMBER_CHARS} 字符`;
|
|
102
|
+
}
|
|
103
|
+
if (member !== undefined && !isNonEmptyString(member, MAX_MEMBER_CHARS)) {
|
|
104
|
+
return `${label}.member 若提供必须非空且 ≤${MAX_MEMBER_CHARS} 字符`;
|
|
105
|
+
}
|
|
106
|
+
const endpoint = { sessionId, role: role };
|
|
107
|
+
if (member !== undefined)
|
|
108
|
+
endpoint.member = member;
|
|
109
|
+
return endpoint;
|
|
110
|
+
}
|
|
111
|
+
function validateDelivery(value) {
|
|
112
|
+
if (!isRecord(value))
|
|
113
|
+
return 'delivery 必须是对象';
|
|
114
|
+
const status = value.status;
|
|
115
|
+
if (status !== 'sent' && status !== 'failed') {
|
|
116
|
+
return 'delivery.status 非法(期望 sent/failed)';
|
|
117
|
+
}
|
|
118
|
+
const delivery = { status };
|
|
119
|
+
if (value.messageId !== undefined) {
|
|
120
|
+
if (!isNonEmptyString(value.messageId, MAX_DELIVERY_MESSAGE_ID_CHARS)) {
|
|
121
|
+
return `delivery.messageId 若提供必须非空且 ≤${MAX_DELIVERY_MESSAGE_ID_CHARS} 字符`;
|
|
122
|
+
}
|
|
123
|
+
delivery.messageId = value.messageId;
|
|
124
|
+
}
|
|
125
|
+
if (value.code !== undefined) {
|
|
126
|
+
if (!isNonEmptyString(value.code, MAX_DELIVERY_CODE_CHARS)) {
|
|
127
|
+
return `delivery.code 若提供必须非空且 ≤${MAX_DELIVERY_CODE_CHARS} 字符`;
|
|
128
|
+
}
|
|
129
|
+
delivery.code = value.code;
|
|
130
|
+
}
|
|
131
|
+
if (value.error !== undefined) {
|
|
132
|
+
if (typeof value.error !== 'string' || value.error.length > MAX_DELIVERY_ERROR_CHARS) {
|
|
133
|
+
return `delivery.error 若提供必须是字符串且 ≤${MAX_DELIVERY_ERROR_CHARS} 字符`;
|
|
134
|
+
}
|
|
135
|
+
delivery.error = value.error;
|
|
136
|
+
}
|
|
137
|
+
if (value.latencyMs !== undefined) {
|
|
138
|
+
if (typeof value.latencyMs !== 'number' || !Number.isFinite(value.latencyMs) || value.latencyMs < 0) {
|
|
139
|
+
return 'delivery.latencyMs 若提供必须是 ≥0 的有限数字';
|
|
140
|
+
}
|
|
141
|
+
delivery.latencyMs = value.latencyMs;
|
|
142
|
+
}
|
|
143
|
+
return delivery;
|
|
144
|
+
}
|
|
145
|
+
/**
|
|
146
|
+
* 契约 §2 的唯一校验入口(fail-closed):未知 kind/role、缺字段、超限一律拒。
|
|
147
|
+
* 通过时返回白名单归一化后的 DeptMessage(body 已清洗控制字符)。
|
|
148
|
+
*/
|
|
149
|
+
export function validateDeptMessage(value) {
|
|
150
|
+
const fail = (error) => ({ ok: false, error: `INVALID_MESSAGE: ${error}` });
|
|
151
|
+
if (!isRecord(value))
|
|
152
|
+
return fail('消息必须是对象');
|
|
153
|
+
if (value.v !== DEPT_MESSAGE_VERSION)
|
|
154
|
+
return fail(`v 必须为 ${DEPT_MESSAGE_VERSION}`);
|
|
155
|
+
if (!isNonEmptyString(value.id, MAX_ID_CHARS))
|
|
156
|
+
return fail(`id 必填且 ≤${MAX_ID_CHARS} 字符`);
|
|
157
|
+
const ts = value.ts;
|
|
158
|
+
if (typeof ts !== 'number' || !Number.isFinite(ts) || ts <= 0 || ts > MAX_TS) {
|
|
159
|
+
return fail('ts 必须是 >0 且 ≤8.64e15 的有限 epoch ms');
|
|
160
|
+
}
|
|
161
|
+
if (!isNonEmptyString(value.planId, MAX_PLAN_ID_CHARS)) {
|
|
162
|
+
return fail(`planId 必填且 ≤${MAX_PLAN_ID_CHARS} 字符`);
|
|
163
|
+
}
|
|
164
|
+
if (!isNonEmptyString(value.subtaskId, MAX_SUBTASK_ID_CHARS)) {
|
|
165
|
+
return fail(`subtaskId 必填且 ≤${MAX_SUBTASK_ID_CHARS} 字符`);
|
|
166
|
+
}
|
|
167
|
+
const kind = value.kind;
|
|
168
|
+
if (typeof kind !== 'string' || !DEPT_MESSAGE_KINDS.includes(kind)) {
|
|
169
|
+
return fail(`kind 非法(期望 ${DEPT_MESSAGE_KINDS.join('/')})`);
|
|
170
|
+
}
|
|
171
|
+
const from = validateEndpoint(value.from, 'from');
|
|
172
|
+
if (typeof from === 'string')
|
|
173
|
+
return fail(from);
|
|
174
|
+
const to = validateEndpoint(value.to, 'to');
|
|
175
|
+
if (typeof to === 'string')
|
|
176
|
+
return fail(to);
|
|
177
|
+
if (typeof value.body !== 'string')
|
|
178
|
+
return fail('body 必须是字符串');
|
|
179
|
+
if (value.body.length > MAX_BODY_CHARS)
|
|
180
|
+
return fail(`body 超限(≤${MAX_BODY_CHARS} 字符)`);
|
|
181
|
+
const body = cleanBody(value.body);
|
|
182
|
+
let data;
|
|
183
|
+
if (value.data !== undefined) {
|
|
184
|
+
if (!isRecord(value.data))
|
|
185
|
+
return fail('data 若提供必须是对象');
|
|
186
|
+
let json;
|
|
187
|
+
try {
|
|
188
|
+
json = JSON.stringify(value.data);
|
|
189
|
+
}
|
|
190
|
+
catch {
|
|
191
|
+
return fail('data 必须可 JSON 序列化');
|
|
192
|
+
}
|
|
193
|
+
if (typeof json !== 'string' || json.length > MAX_DATA_JSON_CHARS) {
|
|
194
|
+
return fail(`data JSON 超限(≤${MAX_DATA_JSON_CHARS} 字符)`);
|
|
195
|
+
}
|
|
196
|
+
data = value.data;
|
|
197
|
+
}
|
|
198
|
+
const delivery = validateDelivery(value.delivery);
|
|
199
|
+
if (typeof delivery === 'string')
|
|
200
|
+
return fail(delivery);
|
|
201
|
+
const message = {
|
|
202
|
+
v: DEPT_MESSAGE_VERSION,
|
|
203
|
+
id: value.id,
|
|
204
|
+
ts,
|
|
205
|
+
planId: value.planId,
|
|
206
|
+
subtaskId: value.subtaskId,
|
|
207
|
+
kind: kind,
|
|
208
|
+
from,
|
|
209
|
+
to,
|
|
210
|
+
body,
|
|
211
|
+
delivery,
|
|
212
|
+
};
|
|
213
|
+
if (data !== undefined)
|
|
214
|
+
message.data = data;
|
|
215
|
+
return { ok: true, value: message };
|
|
216
|
+
}
|
|
217
|
+
/** 留痕目录:env DSH_WORKPLAN_JOURNAL_DIR || ~/.dsh/workplan/journal(契约 §2)。 */
|
|
218
|
+
function resolveJournalDir() {
|
|
219
|
+
const override = typeof process.env.DSH_WORKPLAN_JOURNAL_DIR === 'string'
|
|
220
|
+
? process.env.DSH_WORKPLAN_JOURNAL_DIR.trim()
|
|
221
|
+
: '';
|
|
222
|
+
if (override)
|
|
223
|
+
return override;
|
|
224
|
+
return join(homedir(), '.dsh', 'workplan', 'journal');
|
|
225
|
+
}
|
|
226
|
+
/**
|
|
227
|
+
* 留痕文件路径:<目录>/<planId>.jsonl。
|
|
228
|
+
* planId 只允许 [A-Za-z0-9_-]{1,120};非法抛显式错误 INVALID_PLAN_ID(防路径穿越)。
|
|
229
|
+
*/
|
|
230
|
+
export function deptJournalPath(planId) {
|
|
231
|
+
if (typeof planId !== 'string' || !PLAN_ID_PATTERN.test(planId)) {
|
|
232
|
+
throw new Error(`INVALID_PLAN_ID: planId 只允许 [A-Za-z0-9_-]{1,120},收到 ${JSON.stringify(String(planId)).slice(0, 100)}`);
|
|
233
|
+
}
|
|
234
|
+
return join(resolveJournalDir(), `${planId}.jsonl`);
|
|
235
|
+
}
|
|
236
|
+
/**
|
|
237
|
+
* 追加一条留痕(契约 §2):先 validate,再 mkdirSync(recursive)+appendFileSync。
|
|
238
|
+
* 任何失败(校验不过 / planId 非法 / 写盘失败)显式返回 JOURNAL_WRITE_FAILED,绝不静默。
|
|
239
|
+
*/
|
|
240
|
+
export function appendDeptMessage(msg) {
|
|
241
|
+
const verdict = validateDeptMessage(msg);
|
|
242
|
+
if (!verdict.ok)
|
|
243
|
+
return { ok: false, code: 'JOURNAL_WRITE_FAILED', error: verdict.error };
|
|
244
|
+
let path;
|
|
245
|
+
try {
|
|
246
|
+
path = deptJournalPath(verdict.value.planId);
|
|
247
|
+
}
|
|
248
|
+
catch (error) {
|
|
249
|
+
return { ok: false, code: 'JOURNAL_WRITE_FAILED', error: errorText(error) };
|
|
250
|
+
}
|
|
251
|
+
try {
|
|
252
|
+
mkdirSync(dirname(path), { recursive: true });
|
|
253
|
+
appendFileSync(path, `${JSON.stringify(verdict.value)}\n`, 'utf8');
|
|
254
|
+
}
|
|
255
|
+
catch (error) {
|
|
256
|
+
return { ok: false, code: 'JOURNAL_WRITE_FAILED', error: errorText(error) };
|
|
257
|
+
}
|
|
258
|
+
return { ok: true, path };
|
|
259
|
+
}
|
|
260
|
+
/**
|
|
261
|
+
* 按追加序回放留痕(契约 §2):
|
|
262
|
+
* - 文件不存在 → 空列表(ok:true);
|
|
263
|
+
* - 坏行(JSON 损坏或校验不过)计入 skipped,不静默吞;
|
|
264
|
+
* - kind/since 过滤后按 limit 截取:默认 500、上限 5000;
|
|
265
|
+
* - planId 非法或读盘失败 → 显式 JOURNAL_READ_FAILED。
|
|
266
|
+
*/
|
|
267
|
+
export function readDeptMessages(planId, filter) {
|
|
268
|
+
let path;
|
|
269
|
+
try {
|
|
270
|
+
path = deptJournalPath(planId);
|
|
271
|
+
}
|
|
272
|
+
catch (error) {
|
|
273
|
+
return { ok: false, code: 'JOURNAL_READ_FAILED', error: errorText(error) };
|
|
274
|
+
}
|
|
275
|
+
if (!existsSync(path))
|
|
276
|
+
return { ok: true, messages: [], skipped: 0 };
|
|
277
|
+
let text;
|
|
278
|
+
try {
|
|
279
|
+
text = readFileSync(path, 'utf8');
|
|
280
|
+
}
|
|
281
|
+
catch (error) {
|
|
282
|
+
return { ok: false, code: 'JOURNAL_READ_FAILED', error: errorText(error) };
|
|
283
|
+
}
|
|
284
|
+
const kind = filter?.kind;
|
|
285
|
+
const since = typeof filter?.since === 'number' && Number.isFinite(filter.since)
|
|
286
|
+
? filter.since
|
|
287
|
+
: null;
|
|
288
|
+
const rawLimit = Number(filter?.limit);
|
|
289
|
+
const limit = Number.isFinite(rawLimit) && rawLimit > 0
|
|
290
|
+
? Math.min(Math.floor(rawLimit), MAX_READ_LIMIT)
|
|
291
|
+
: DEFAULT_READ_LIMIT;
|
|
292
|
+
const matched = [];
|
|
293
|
+
let skipped = 0;
|
|
294
|
+
for (const line of text.split('\n')) {
|
|
295
|
+
const trimmed = line.trim();
|
|
296
|
+
if (!trimmed)
|
|
297
|
+
continue;
|
|
298
|
+
let parsed;
|
|
299
|
+
try {
|
|
300
|
+
parsed = JSON.parse(trimmed);
|
|
301
|
+
}
|
|
302
|
+
catch {
|
|
303
|
+
skipped += 1;
|
|
304
|
+
continue;
|
|
305
|
+
}
|
|
306
|
+
const verdict = validateDeptMessage(parsed);
|
|
307
|
+
if (!verdict.ok) {
|
|
308
|
+
skipped += 1;
|
|
309
|
+
continue;
|
|
310
|
+
}
|
|
311
|
+
const message = verdict.value;
|
|
312
|
+
if (kind !== undefined && message.kind !== kind)
|
|
313
|
+
continue;
|
|
314
|
+
if (since !== null && message.ts < since)
|
|
315
|
+
continue;
|
|
316
|
+
matched.push(message);
|
|
317
|
+
}
|
|
318
|
+
return { ok: true, messages: matched.slice(0, limit), skipped };
|
|
319
|
+
}
|