dsh-sansheng-liubu/sansheng/src/gate.js

128 lines
5.8 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

import { goalDigest, stageDigest } from './digest.js'
import { roleLabel } from './roles.js'
export const GOAL_MUTATIONS = new Set([
'draft', 'start', 'revise', 'task', 'pass', 'rework', 'complete', 'pause', 'resume', 'stop',
])
const deny = (code, reason) => ({ allow: false, code, reason })
function findReview(reviews, match) {
for (let i = (reviews?.length ?? 0) - 1; i >= 0; i -= 1) {
const review = reviews[i]
if (review.projectId !== match.projectId) continue
if (review.goalId !== match.goalId) continue
if (review.goalRevision !== match.revision) continue
if (review.kind !== match.kind) continue
if ((review.stageIndex ?? null) !== (match.stageIndex ?? null)) continue
if (review.digest !== match.digest) continue
if (review.verdict !== match.verdict) continue
if (match.reviewerRole !== undefined && review.reviewerRole !== match.reviewerRole) continue
return review
}
return undefined
}
/** 返工预算直接取原生目标里的阶段累计,revise/换阶段都不清零。 */
export function budgetOf(goal, project) {
const used = (goal?.stages ?? []).reduce((sum, stage) => sum + (Number(stage.reworks) || 0), 0)
const max = Number.isInteger(project?.maxReworks) && project.maxReworks > 0 ? project.maxReworks : 3
return { used, max, left: Math.max(0, max - used) }
}
/**
* 纯函数门禁:尚书是唯一目标操作者;阶段通过/驳回要自己的审查记录,
* 目标完成要丞相的验收记录;返工受预算限制;工部与丞相不得改目标。
*/
export function evaluateGoalAction({ action, actor, project, goal, reviews, members, args }) {
if (!project) return { allow: true }
if (!GOAL_MUTATIONS.has(action)) return { allow: true }
// 用户从页面/会话直接操作时放行;Bot 才需要角色约束。
if (actor?.kind !== 'bot') return { allow: true }
const shangshuName = members?.find(member => member.role === 'shangshu')?.name ?? '尚书'
const leadName = members?.find(member => member.role === 'lead')?.name ?? '丞相'
if (actor.isMain) {
return deny('main-bot', `Main Bot 不操作已绑定项目的目标:让${shangshuName}推进、${leadName}验收。`)
}
if (actor.role === undefined) {
return deny('not-member', `${actor.botName ?? '这个 Bot'} 不是本项目三角色成员,不能修改目标。`)
}
if (actor.role === 'gongbu') {
return deny('gongbu', '工部只执行任务和回报,不修改目标;目标由尚书起草推进,丞相验收。')
}
if (actor.role === 'lead') {
return deny('lead', '丞相不直接操作目标;请用 sansheng_review 记录目标验收,阶段推进交给尚书。')
}
const roleOfName = name => members?.find(member => member.name === name)?.role
if (action === 'task') {
const name = String(args?.bot ?? '').trim()
if (name !== '') {
const targetRole = roleOfName(name)
if (targetRole === undefined) return deny('task-target', `工单目标“${name}”不是本项目群成员。`)
if (targetRole !== 'gongbu') return deny('task-target', `工单只能派给工部;“${name}”的角色是${roleLabel(targetRole)}。`)
}
return { allow: true }
}
if (action === 'start' || action === 'revise') {
for (const stage of args?.stages ?? []) {
for (const task of stage?.tasks ?? []) {
const name = String(task?.bot ?? '').trim()
if (name === '') continue
const targetRole = roleOfName(name)
if (targetRole === undefined) {
return deny('stage-target', `阶段「${stage?.title ?? ''}」的工单目标“${name}”不是本项目群成员。`)
}
if (targetRole !== 'gongbu') {
return deny('stage-target', `阶段「${stage?.title ?? ''}」的工单只能派给工部;“${name}”的角色是${roleLabel(targetRole)}。`)
}
}
}
return { allow: true }
}
if (!goal) return { allow: true }
if (action === 'pass') {
const stageIndex = goal.current + 1
const stage = goal.stages?.[stageIndex - 1]
if (!stage) return deny('no-stage', '当前没有可通过的阶段。')
const digest = stageDigest(goal, stageIndex)
if (!findReview(reviews, { projectId: project.id, goalId: goal.id, revision: goal.revision, kind: 'stage', stageIndex, digest, verdict: 'pass' })) {
return deny('no-stage-review', `通过阶段 ${stageIndex}「${stage.title}」前,先用 sansheng_review action=stage_pass stage=${stageIndex} evidence=... 记录尚书审查。`)
}
return { allow: true }
}
if (action === 'rework') {
const stageIndex = goal.current + 1
const budget = budgetOf(goal, project)
if (budget.used >= budget.max) {
return deny('budget', `返工预算已用尽(${budget.used}/${budget.max})。请与用户确认后用 revise 调整目标,或 stop 结束。`)
}
const digest = stageDigest(goal, stageIndex)
if (!findReview(reviews, { projectId: project.id, goalId: goal.id, revision: goal.revision, kind: 'stage', stageIndex, digest, verdict: 'reject' })) {
return deny('no-reject-review', `驳回阶段 ${stageIndex} 前,先用 sansheng_review action=stage_reject reason=... 记录审查发现。`)
}
return { allow: true }
}
if (action === 'complete') {
const stages = goal.stages ?? []
if (stages.length === 0 || stages.some(stage => stage.status !== 'passed')) {
return deny('not-all-passed', '还有阶段未通过,不能完成目标。')
}
const digest = goalDigest(goal)
if (!findReview(reviews, { projectId: project.id, goalId: goal.id, revision: goal.revision, kind: 'goal', stageIndex: null, digest, verdict: 'pass', reviewerRole: 'lead' })) {
return deny('no-goal-review', `完成前先由丞相记录目标验收:sansheng_review action=goal_pass evidence=...(当前版本 revision ${goal.revision})。`)
}
return { allow: true }
}
return { allow: true }
}