dsh-chief 1.3.0 → 1.5.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 +84 -12
- package/README.en.md +156 -113
- package/README.md +149 -140
- package/api-routes.js +183 -4
- package/archive-core.js +136 -8
- package/archive-dossiers.js +450 -20
- package/archive-precipitated.js +115 -36
- package/auto-continue.js +13 -5
- package/board-actions.js +131 -5
- package/board-schema.js +1 -1
- package/chief-approvals.js +415 -90
- package/chief-archives.js +191 -29
- package/chief-commands.js +1178 -207
- package/chief-executor.js +279 -555
- package/chief-models.js +158 -28
- package/chief-network.js +157 -8
- package/chief-review.js +240 -67
- package/chief-state.js +855 -109
- package/chief-view.js +38 -20
- package/client.js +5602 -2618
- package/digest.js +18 -9
- package/model-tools.js +92 -6
- package/package.json +41 -25
- package/runtime-hooks.js +221 -12
- package/safety/audit-log.js +95 -0
- package/safety/command-analyzer.js +339 -0
- package/safety/guard-walls.js +993 -0
- package/safety/index.js +78 -0
- package/safety/invariant-guards.js +280 -0
- package/safety/path-guard.js +227 -0
- package/safety/policy-engine.js +387 -0
- package/safety/policy-plugin.js +391 -0
- package/safety/tool-gate.js +278 -0
- package/subagent-runtime.js +266 -3
|
@@ -0,0 +1,387 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* safety/policy-engine.js
|
|
3
|
+
*
|
|
4
|
+
* Four-role + granular capability model (`role + capabilities`) and single-use
|
|
5
|
+
* `capabilityScope` binding/verification for DSH Chief.
|
|
6
|
+
*/
|
|
7
|
+
|
|
8
|
+
import crypto from 'node:crypto'
|
|
9
|
+
import path from 'node:path'
|
|
10
|
+
import { validatePolicyPlugin } from './policy-plugin.js'
|
|
11
|
+
|
|
12
|
+
export const CHIEF_PERMISSION_MODES = ['advisor', 'assistant', 'strategist', 'chief']
|
|
13
|
+
export const DEFAULT_CHIEF_PERMISSION_MODE = 'advisor'
|
|
14
|
+
|
|
15
|
+
export const CHIEF_PERMISSION_META = {
|
|
16
|
+
advisor: {
|
|
17
|
+
key: 'advisor',
|
|
18
|
+
rank: 0,
|
|
19
|
+
level: 'L0',
|
|
20
|
+
icon: '👁',
|
|
21
|
+
shortLabel: 'L0 顾问',
|
|
22
|
+
title: '顾问模式',
|
|
23
|
+
enTitle: 'READ ONLY',
|
|
24
|
+
badge: '默认模式',
|
|
25
|
+
tagline: '只观察、只分析、只建议。',
|
|
26
|
+
desc: 'L0 默认只读档:仅读取看板与允许访问的项目状态,分析任务并提建议,绝不修改工作区或任何工作流。',
|
|
27
|
+
bullets: [
|
|
28
|
+
'读取看板和允许访问的项目状态',
|
|
29
|
+
'分析任务、提供建议',
|
|
30
|
+
'不修改工作区',
|
|
31
|
+
'不修改主代理和子代理工作流',
|
|
32
|
+
],
|
|
33
|
+
},
|
|
34
|
+
assistant: {
|
|
35
|
+
key: 'assistant',
|
|
36
|
+
rank: 1,
|
|
37
|
+
level: 'L1',
|
|
38
|
+
icon: '🗂',
|
|
39
|
+
shortLabel: 'L1 助手',
|
|
40
|
+
title: '助手模式',
|
|
41
|
+
enTitle: 'ASSISTANT',
|
|
42
|
+
badge: '',
|
|
43
|
+
tagline: '允许自主维护参谋系统。',
|
|
44
|
+
desc: 'L1 参谋内务档:具备顾问全部能力,允许维护自身记忆、档案与看板配置,但不改工作区、不接管主子代理工作流。',
|
|
45
|
+
bullets: [
|
|
46
|
+
'顾问模式全部能力',
|
|
47
|
+
'管理自己的参谋系统',
|
|
48
|
+
'修改自己的记忆、档案和看板配置',
|
|
49
|
+
'不直接修改项目工作区',
|
|
50
|
+
'不接管主代理工作流',
|
|
51
|
+
],
|
|
52
|
+
},
|
|
53
|
+
strategist: {
|
|
54
|
+
key: 'strategist',
|
|
55
|
+
rank: 2,
|
|
56
|
+
level: 'L2',
|
|
57
|
+
icon: '🛡️',
|
|
58
|
+
shortLabel: 'L2 参谋',
|
|
59
|
+
title: '参谋模式',
|
|
60
|
+
enTitle: 'ADVISOR WITH APPROVAL',
|
|
61
|
+
badge: '逐项授权',
|
|
62
|
+
tagline: 'Agent 提出操作,用户决定是否执行。',
|
|
63
|
+
desc: 'L2 逐项确认档:可申请修改工作区文件、运行系统命令及调整主对话/子代理工作流,每项受控操作执行前均弹窗由您逐项确认。',
|
|
64
|
+
bullets: [
|
|
65
|
+
'助手模式全部能力',
|
|
66
|
+
'可以申请修改工作区文件',
|
|
67
|
+
'可以申请修改主对话和子代理工作流',
|
|
68
|
+
'每项受控操作执行前弹窗',
|
|
69
|
+
'用户确认后才能执行',
|
|
70
|
+
],
|
|
71
|
+
},
|
|
72
|
+
chief: {
|
|
73
|
+
key: 'chief',
|
|
74
|
+
rank: 3,
|
|
75
|
+
level: 'L3',
|
|
76
|
+
icon: '⚡',
|
|
77
|
+
shortLabel: 'L3 参谋长',
|
|
78
|
+
title: '参谋长模式',
|
|
79
|
+
enTitle: 'CHIEF OF STAFF',
|
|
80
|
+
badge: '主动风险知悉',
|
|
81
|
+
tagline: '用户明确接受更高自主权带来的操作风险。',
|
|
82
|
+
desc: 'L3 高权限自主档:可自主修改工作区、执行命令、切换主代理并协调子代理工作流;启用前必须阅读风险声明并主动勾选确认。',
|
|
83
|
+
bullets: [
|
|
84
|
+
'参谋模式全部能力',
|
|
85
|
+
'获得更高的自主执行权限',
|
|
86
|
+
'可以切换主代理',
|
|
87
|
+
'可以协调子代理及其工作流',
|
|
88
|
+
'启用前必须阅读风险声明并主动勾选确认',
|
|
89
|
+
],
|
|
90
|
+
},
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
const PERM_ALIAS_MAP = {
|
|
94
|
+
advisor: 'advisor',
|
|
95
|
+
l0: 'advisor',
|
|
96
|
+
'read-only': 'advisor',
|
|
97
|
+
assistant: 'assistant',
|
|
98
|
+
l1: 'assistant',
|
|
99
|
+
strategist: 'strategist',
|
|
100
|
+
counselor: 'strategist',
|
|
101
|
+
l2: 'strategist',
|
|
102
|
+
'workspace-write': 'strategist',
|
|
103
|
+
'auto-review': 'strategist',
|
|
104
|
+
chief: 'chief',
|
|
105
|
+
'chief-of-staff': 'chief',
|
|
106
|
+
l3: 'chief',
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
export function normalizePermissionMode(raw, opts = {}) {
|
|
110
|
+
const v = String(raw || '').trim().toLowerCase()
|
|
111
|
+
const hasAck = Boolean(opts && opts.hasChiefRiskAck)
|
|
112
|
+
const requireAck = Boolean(opts && opts.requireAck)
|
|
113
|
+
if (v === 'danger-full-access') {
|
|
114
|
+
return hasAck ? 'chief' : DEFAULT_CHIEF_PERMISSION_MODE
|
|
115
|
+
}
|
|
116
|
+
const mapped = PERM_ALIAS_MAP[v] || DEFAULT_CHIEF_PERMISSION_MODE
|
|
117
|
+
if (mapped === 'chief' && requireAck && !hasAck) {
|
|
118
|
+
return DEFAULT_CHIEF_PERMISSION_MODE
|
|
119
|
+
}
|
|
120
|
+
return mapped
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
export function permissionRank(mode) {
|
|
124
|
+
const norm = normalizePermissionMode(mode)
|
|
125
|
+
return (CHIEF_PERMISSION_META[norm] && CHIEF_PERMISSION_META[norm].rank) ?? 0
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
export function getToolOpClass(tool) {
|
|
129
|
+
switch (String(tool || '').trim()) {
|
|
130
|
+
case 'read_file':
|
|
131
|
+
case 'list_dir':
|
|
132
|
+
case 'search_files':
|
|
133
|
+
return 'read'
|
|
134
|
+
case 'request_permission_elevation':
|
|
135
|
+
return 'elevation_request'
|
|
136
|
+
case 'archive_write':
|
|
137
|
+
return 'chief_system'
|
|
138
|
+
case 'write_file':
|
|
139
|
+
case 'edit_file':
|
|
140
|
+
case 'run_command':
|
|
141
|
+
return 'workspace'
|
|
142
|
+
case 'subagent_dispatch':
|
|
143
|
+
case 'subagent_steer':
|
|
144
|
+
case 'subagent_interrupt':
|
|
145
|
+
case 'main_agent_control':
|
|
146
|
+
case 'session_compact':
|
|
147
|
+
return 'workflow'
|
|
148
|
+
default:
|
|
149
|
+
return 'workflow'
|
|
150
|
+
}
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
export function resolveRoleCapabilities(role, { hasChiefRiskAck = false, policyPlugins = [] } = {}) {
|
|
154
|
+
let effectiveRole = normalizePermissionMode(role, { requireAck: true, hasChiefRiskAck })
|
|
155
|
+
let restrictedWritePrefixes = null
|
|
156
|
+
|
|
157
|
+
for (const rawPlugin of (Array.isArray(policyPlugins) ? policyPlugins : [])) {
|
|
158
|
+
const v = validatePolicyPlugin(rawPlugin)
|
|
159
|
+
if (!v.ok || !v.plugin.enabled) continue
|
|
160
|
+
const rules = v.plugin.rules || {}
|
|
161
|
+
if (rules.maxRoleCeiling && permissionRank(rules.maxRoleCeiling) < permissionRank(effectiveRole)) {
|
|
162
|
+
effectiveRole = rules.maxRoleCeiling
|
|
163
|
+
}
|
|
164
|
+
if (rules.restrictFsWritePrefixes && rules.restrictFsWritePrefixes.length > 0) {
|
|
165
|
+
const next = rules.restrictFsWritePrefixes.map(p => p.replace(/\\/g, '/').replace(/^\.\//, '').replace(/\/+$/, '').toLowerCase()).filter(Boolean)
|
|
166
|
+
if (next.length > 0) {
|
|
167
|
+
if (restrictedWritePrefixes === null) {
|
|
168
|
+
restrictedWritePrefixes = next
|
|
169
|
+
} else {
|
|
170
|
+
const inter = []
|
|
171
|
+
for (const a of restrictedWritePrefixes) {
|
|
172
|
+
for (const b of next) {
|
|
173
|
+
if (a === b || a.startsWith(b + '/')) inter.push(a)
|
|
174
|
+
else if (b.startsWith(a + '/')) inter.push(b)
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
restrictedWritePrefixes = [...new Set(inter)]
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
}
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
const capabilities = (() => {
|
|
184
|
+
switch (effectiveRole) {
|
|
185
|
+
case 'advisor':
|
|
186
|
+
return {
|
|
187
|
+
fsReadWorkspace: true,
|
|
188
|
+
fsWritePrefixes: [],
|
|
189
|
+
allowBoardAdmin: false,
|
|
190
|
+
allowBoundsPropose: true,
|
|
191
|
+
allowArchiveCurate: false,
|
|
192
|
+
allowNetworkLink: false,
|
|
193
|
+
allowWorkspaceWrite: 'deny',
|
|
194
|
+
allowShellExec: 'deny',
|
|
195
|
+
allowMainRelay: 'deny',
|
|
196
|
+
allowSubagentDispatch: 'deny',
|
|
197
|
+
allowSessionCompact: 'deny',
|
|
198
|
+
}
|
|
199
|
+
case 'assistant':
|
|
200
|
+
return {
|
|
201
|
+
fsReadWorkspace: true,
|
|
202
|
+
fsWritePrefixes: [],
|
|
203
|
+
allowBoardAdmin: true,
|
|
204
|
+
allowBoundsPropose: true,
|
|
205
|
+
allowArchiveCurate: true,
|
|
206
|
+
allowNetworkLink: true,
|
|
207
|
+
allowWorkspaceWrite: 'deny',
|
|
208
|
+
allowShellExec: 'deny',
|
|
209
|
+
allowMainRelay: 'deny',
|
|
210
|
+
allowSubagentDispatch: 'deny',
|
|
211
|
+
allowSessionCompact: 'deny',
|
|
212
|
+
}
|
|
213
|
+
case 'strategist':
|
|
214
|
+
return {
|
|
215
|
+
fsReadWorkspace: true,
|
|
216
|
+
fsWritePrefixes: restrictedWritePrefixes !== null ? restrictedWritePrefixes : ['*'],
|
|
217
|
+
allowBoardAdmin: true,
|
|
218
|
+
allowBoundsPropose: true,
|
|
219
|
+
allowArchiveCurate: true,
|
|
220
|
+
allowNetworkLink: true,
|
|
221
|
+
allowWorkspaceWrite: 'approval',
|
|
222
|
+
allowShellExec: 'approval',
|
|
223
|
+
allowMainRelay: 'approval',
|
|
224
|
+
allowSubagentDispatch: 'approval',
|
|
225
|
+
allowSessionCompact: 'approval',
|
|
226
|
+
}
|
|
227
|
+
case 'chief':
|
|
228
|
+
default:
|
|
229
|
+
return {
|
|
230
|
+
fsReadWorkspace: true,
|
|
231
|
+
fsWritePrefixes: restrictedWritePrefixes !== null ? restrictedWritePrefixes : ['*'],
|
|
232
|
+
allowBoardAdmin: true,
|
|
233
|
+
allowBoundsPropose: true,
|
|
234
|
+
allowArchiveCurate: true,
|
|
235
|
+
allowNetworkLink: true,
|
|
236
|
+
allowWorkspaceWrite: 'allow',
|
|
237
|
+
allowShellExec: 'allow',
|
|
238
|
+
allowMainRelay: 'allow',
|
|
239
|
+
allowSubagentDispatch: 'allow',
|
|
240
|
+
allowSessionCompact: 'allow',
|
|
241
|
+
}
|
|
242
|
+
}
|
|
243
|
+
})()
|
|
244
|
+
|
|
245
|
+
return {
|
|
246
|
+
role: effectiveRole,
|
|
247
|
+
capabilities,
|
|
248
|
+
}
|
|
249
|
+
}
|
|
250
|
+
|
|
251
|
+
export function buildCapabilityScope({ kind = 'tool', tool = '', args = {}, cwd = '', target = '' } = {}) {
|
|
252
|
+
const safeKind = String(kind || 'tool').trim()
|
|
253
|
+
const safeTool = String(tool || (safeKind === 'relay' ? 'relay' : safeKind)).trim()
|
|
254
|
+
const argObj = args && typeof args === 'object' ? args : {}
|
|
255
|
+
const baseCwd = cwd ? path.resolve(String(cwd)) : process.cwd()
|
|
256
|
+
|
|
257
|
+
const scope = {
|
|
258
|
+
kind: safeKind,
|
|
259
|
+
tool: safeTool,
|
|
260
|
+
opClass: getToolOpClass(safeTool),
|
|
261
|
+
}
|
|
262
|
+
|
|
263
|
+
if (safeTool === 'write_file' || safeTool === 'edit_file' || safeTool === 'read_file' || safeTool === 'list_dir' || safeTool === 'search_files') {
|
|
264
|
+
const rawPath = String(argObj.path || '').trim()
|
|
265
|
+
if (rawPath) {
|
|
266
|
+
scope.allowedPaths = [path.resolve(baseCwd, rawPath)]
|
|
267
|
+
}
|
|
268
|
+
}
|
|
269
|
+
|
|
270
|
+
if (safeTool === 'run_command') {
|
|
271
|
+
const cmdText = String(argObj.command || argObj.cmd || '').trim()
|
|
272
|
+
if (cmdText) {
|
|
273
|
+
scope.commandSha256 = crypto.createHash('sha256').update(cmdText).digest('hex')
|
|
274
|
+
}
|
|
275
|
+
const runCwd = path.resolve(baseCwd, String(argObj.cwd || '.').trim() || '.')
|
|
276
|
+
scope.allowedCwd = runCwd
|
|
277
|
+
}
|
|
278
|
+
|
|
279
|
+
if (safeTool === 'relay' || safeTool === 'subagent_dispatch' || safeTool === 'subagent_steer' || safeTool === 'subagent_interrupt') {
|
|
280
|
+
const tgt = String(target || argObj.agent || argObj.subagent || argObj.target || '').trim()
|
|
281
|
+
if (tgt) scope.targetAgent = tgt
|
|
282
|
+
}
|
|
283
|
+
|
|
284
|
+
if (safeTool === 'main_agent_control') {
|
|
285
|
+
scope.controlOp = String(argObj.op || 'steer').trim()
|
|
286
|
+
}
|
|
287
|
+
|
|
288
|
+
return scope
|
|
289
|
+
}
|
|
290
|
+
|
|
291
|
+
function sameResolvedPath(a, b) {
|
|
292
|
+
const na = path.resolve(String(a || ''))
|
|
293
|
+
const nb = path.resolve(String(b || ''))
|
|
294
|
+
return process.platform === 'win32' ? na.toLowerCase() === nb.toLowerCase() : na === nb
|
|
295
|
+
}
|
|
296
|
+
|
|
297
|
+
export function verifyCapabilityScope(scope, { kind = 'tool', tool = '', args = {}, cwd = '', target = '' } = {}) {
|
|
298
|
+
if (!scope || typeof scope !== 'object') {
|
|
299
|
+
return { ok: true }
|
|
300
|
+
}
|
|
301
|
+
const actualKind = String(kind || 'tool').trim()
|
|
302
|
+
const actualTool = String(tool || '').trim()
|
|
303
|
+
const argObj = args && typeof args === 'object' ? args : {}
|
|
304
|
+
const baseCwd = cwd ? path.resolve(String(cwd)) : process.cwd()
|
|
305
|
+
|
|
306
|
+
if (scope.kind && scope.kind !== actualKind) {
|
|
307
|
+
return {
|
|
308
|
+
ok: false,
|
|
309
|
+
rule: 'capability_scope_mismatch',
|
|
310
|
+
error: `单次授权作用域类型不匹配:预期 ${scope.kind},实际 ${actualKind}`,
|
|
311
|
+
}
|
|
312
|
+
}
|
|
313
|
+
|
|
314
|
+
if (scope.tool && actualTool && scope.tool !== actualTool) {
|
|
315
|
+
return {
|
|
316
|
+
ok: false,
|
|
317
|
+
rule: 'capability_scope_mismatch',
|
|
318
|
+
error: `单次授权工具作用域不匹配:预期 ${scope.tool},实际 ${actualTool}`,
|
|
319
|
+
}
|
|
320
|
+
}
|
|
321
|
+
|
|
322
|
+
if (Array.isArray(scope.allowedPaths) && scope.allowedPaths.length > 0) {
|
|
323
|
+
const rawPath = String(argObj.path || '').trim()
|
|
324
|
+
if (!rawPath) {
|
|
325
|
+
return {
|
|
326
|
+
ok: false,
|
|
327
|
+
rule: 'capability_scope_mismatch',
|
|
328
|
+
error: '单次授权要求显式路径且必须落在已批准路径范围内',
|
|
329
|
+
}
|
|
330
|
+
}
|
|
331
|
+
const actualAbs = path.resolve(baseCwd, rawPath)
|
|
332
|
+
if (!scope.allowedPaths.some(p => sameResolvedPath(p, actualAbs))) {
|
|
333
|
+
return {
|
|
334
|
+
ok: false,
|
|
335
|
+
rule: 'capability_scope_mismatch',
|
|
336
|
+
error: `单次授权作用域拒绝越权路径访问:未批准写入 ${rawPath}`,
|
|
337
|
+
}
|
|
338
|
+
}
|
|
339
|
+
}
|
|
340
|
+
|
|
341
|
+
if (scope.commandSha256) {
|
|
342
|
+
const cmdText = String(argObj.command || argObj.cmd || '').trim()
|
|
343
|
+
const actualHash = crypto.createHash('sha256').update(cmdText).digest('hex')
|
|
344
|
+
if (actualHash !== scope.commandSha256) {
|
|
345
|
+
return {
|
|
346
|
+
ok: false,
|
|
347
|
+
rule: 'capability_scope_mismatch',
|
|
348
|
+
error: '单次授权作用域校验失败:执行命令与已批准内容不一致',
|
|
349
|
+
}
|
|
350
|
+
}
|
|
351
|
+
}
|
|
352
|
+
|
|
353
|
+
if (scope.allowedCwd) {
|
|
354
|
+
const actualCwd = path.resolve(baseCwd, String(argObj.cwd || '.').trim() || '.')
|
|
355
|
+
if (!sameResolvedPath(scope.allowedCwd, actualCwd)) {
|
|
356
|
+
return {
|
|
357
|
+
ok: false,
|
|
358
|
+
rule: 'capability_scope_mismatch',
|
|
359
|
+
error: '单次授权作用域校验失败:命令工作目录与已批准目录不一致',
|
|
360
|
+
}
|
|
361
|
+
}
|
|
362
|
+
}
|
|
363
|
+
|
|
364
|
+
if (scope.targetAgent) {
|
|
365
|
+
const actualTarget = String(target || argObj.agent || argObj.subagent || argObj.target || '').trim()
|
|
366
|
+
if (actualTarget && actualTarget !== scope.targetAgent) {
|
|
367
|
+
return {
|
|
368
|
+
ok: false,
|
|
369
|
+
rule: 'capability_scope_mismatch',
|
|
370
|
+
error: `单次授权目标代理不匹配:预期 ${scope.targetAgent},实际 ${actualTarget}`,
|
|
371
|
+
}
|
|
372
|
+
}
|
|
373
|
+
}
|
|
374
|
+
|
|
375
|
+
if (scope.controlOp) {
|
|
376
|
+
const actualOp = String(argObj.op || 'steer').trim()
|
|
377
|
+
if (actualOp !== scope.controlOp) {
|
|
378
|
+
return {
|
|
379
|
+
ok: false,
|
|
380
|
+
rule: 'capability_scope_mismatch',
|
|
381
|
+
error: `单次授权主代理控制动作不匹配:预期 ${scope.controlOp},实际 ${actualOp}`,
|
|
382
|
+
}
|
|
383
|
+
}
|
|
384
|
+
}
|
|
385
|
+
|
|
386
|
+
return { ok: true }
|
|
387
|
+
}
|