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

238 lines
11 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 { artifactDigestOf, goalDigest, reviewSubjectDigest, 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 })
/**
* 返工预算:原生阶段里的 reworks 累计是权威,revise 重建阶段会把它清零,
* 所以再与本地返工记录数取较大值,保证"按整个目标累计"不被改写目标绕过。
*/
export function budgetOf(goal, project, recorded = []) {
const native = (goal?.stages ?? []).reduce((sum, stage) => sum + (Number(stage.reworks) || 0), 0)
const logged = (recorded ?? []).filter(record => goal === undefined || record?.goalId === goal.id).length
const used = Math.max(native, logged)
const max = Number.isInteger(project?.maxReworks) && project.maxReworks > 0 ? project.maxReworks : 3
return { used, max, left: Math.max(0, max - used) }
}
function sortKey(review) {
return [Number(review?.seq) || 0, Number(review?.at) || 0]
}
function compareReview(a, b) {
const [aSeq, aAt] = sortKey(a)
const [bSeq, bAt] = sortKey(b)
return bSeq - aSeq || bAt - aAt
}
/**
* 最新判决:先限定 项目/目标/审查类型/阶段/合法审查身份,再取最新一条;
* 绝不先按 verdict 过滤——那会让"先 pass 后 reject"错误命中旧 pass。
*/
export function latestDecision(reviews, { projectId, goalId, kind, stageIndex = null, reviewerRoles }) {
const legal = new Set(reviewerRoles ?? [])
const matches = (reviews ?? []).filter(review => {
if (!review) return false
if (review.projectId !== projectId) return false
if (review.goalId !== goalId) return false
if (review.kind !== kind) return false
if ((review.stageIndex ?? null) !== stageIndex) return false
if (legal.size > 0 && !legal.has(review.reviewerRole)) return false
return true
})
if (matches.length === 0) return undefined
return matches.sort(compareReview)[0]
}
function reviewDigestOf(review) {
return review?.reviewSubjectDigest ?? review?.digest
}
function subjectMatches(review, { kind, goal, stageIndex }) {
const stored = reviewDigestOf(review)
if (stored === undefined) return false
const current = reviewSubjectDigest(kind, goal, stageIndex)
if (review.reviewSubjectDigest !== undefined) return stored === current
// 兼容 v2 旧记录:它们存的是 stageDigest/goalDigest。
const legacy = kind === 'stage' ? stageDigest(goal, stageIndex) : goalDigest(goal)
return stored === current || stored === legacy
}
/**
* 纯函数门禁:尚书是唯一目标操作者;阶段通过/驳回要自己的审查记录,
* 目标完成要丞相的验收记录;返工受预算限制;工部与丞相不得改目标。
*
* 审批约束(v3):
* - 最新判决决定有效性;最新 reject 不能被更旧的 pass 绕过。
* - 审查对象摘要(验收标准+任务范围)、成果摘要、提交代次都必须匹配当前值。
* - 项目有 workDir 时,审查必须绑定服务端生成的成果快照;成果变化即失效。
*/
export function evaluateGoalAction({
action, actor, project, goal, reviews, members, args, reworks = [], artifact, projectFreshness,
}) {
if (!project) return { allow: true }
if (!GOAL_MUTATIONS.has(action)) return { allow: true }
if (project.degraded === true || projectFreshness === 'broken' || projectFreshness === 'missing') {
return deny('state-unavailable', '三省六部治理状态不可读(状态文件损坏或加载失败)。受治理目标已停止修改;请先恢复状态文件或重新绑定项目。')
}
if (actor?.kind === 'unknown') {
return deny('unknown-actor', actor.reason ?? '无法确认调用者身份,受治理操作已拒绝。')
}
// 用户从页面/会话直接操作时放行;Bot 才需要角色约束。
if (actor?.kind !== 'bot') return { allow: true }
if (actor.projectConflict) {
return deny('project-conflict', `Bot「${actor.botName ?? actor.botId}」同时属于多个项目,无法确定项目边界;请先清理绑定。`)
}
if (project.id && actor.project && actor.project.id !== project.id) {
return deny('project-mismatch', `这是项目「${actor.project.name}」的 Bot,不能修改项目「${project.name}」的目标。`)
}
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 }
const checkArtifact = (review) => {
if (!project.workDir) return undefined
if (!review) return undefined
if (!review.artifactDigest) {
return deny('no-artifact', '这份审查没有绑定成果快照;请重新用 sansheng_review 记录(会自动生成成果快照)。')
}
const currentDigest = artifactDigestOf(artifact)
if (artifact === undefined || artifact === null) {
return deny('artifact-unavailable', '无法读取当前成果快照,不能推进受治理目标。')
}
if (artifact.kind === 'missing' || artifact.exists === false) {
return deny('artifact-missing', '当前工作目录不存在或不是目录,不能生成完整成果快照;请恢复工作目录后重新提交/审查。')
}
if (artifact.truncated === true) {
return deny('artifact-truncated', '当前成果快照被截断(文件数超过上限),不是完整成果,不能验收;请缩小交付范围或提高上限后重新提交。')
}
if (currentDigest !== review.artifactDigest) {
return deny('artifact-changed', '交付成果在审查之后发生了变化(文件、未跟踪交付物或提交不同);旧审查已失效,请重新审查并生成新快照。')
}
if (Number.isInteger(review.submissionSeq) && Number.isInteger(project.submissionSeq) && review.submissionSeq !== project.submissionSeq) {
return deny('submission-advanced', '成果提交代次已推进(已有更新的成果提交);旧审批不能复用,请基于当前成果重新审查。')
}
return undefined
}
if (action === 'pass') {
const stageIndex = goal.current + 1
const stage = goal.stages?.[stageIndex - 1]
if (!stage) return deny('no-stage', '当前没有可通过的阶段。')
const review = latestDecision(reviews, {
projectId: project.id, goalId: goal.id, kind: 'stage', stageIndex,
reviewerRoles: ['shangshu', 'user'],
})
if (!review) {
return deny('no-stage-review', `通过阶段 ${stageIndex}「${stage.title}」前,先用 sansheng_review action=stage_pass stage=${stageIndex} evidence=... 记录尚书审查。`)
}
if (review.verdict !== 'pass') {
return deny('latest-reject', `阶段 ${stageIndex} 的最新审查结论是驳回(${review.reason ?? '未写原因'});返工后必须重新记录 stage_pass 才能通过。`)
}
if (!subjectMatches(review, { kind: 'stage', goal, stageIndex })) {
return deny('no-stage-review', `阶段 ${stageIndex} 的最新通过审查针对的是另一版验收标准/任务范围;请按当前版本重新记录 stage_pass。`)
}
const artifactVerdict = checkArtifact(review)
if (artifactVerdict) return artifactVerdict
return { allow: true }
}
if (action === 'rework') {
const stageIndex = goal.current + 1
const budget = budgetOf(goal, project, reworks)
if (budget.used >= budget.max) {
return deny('budget', `返工预算已用尽(${budget.used}/${budget.max})。请与用户确认后用 revise 调整目标,或 stop 结束。`)
}
const review = latestDecision(reviews, {
projectId: project.id, goalId: goal.id, kind: 'stage', stageIndex,
reviewerRoles: ['shangshu', 'user'],
})
if (!review) {
return deny('no-reject-review', `驳回阶段 ${stageIndex} 前,先用 sansheng_review action=stage_reject reason=... 记录审查发现。`)
}
if (review.verdict !== 'reject') {
return deny('latest-pass', `阶段 ${stageIndex} 的最新审查结论是通过;不能基于旧审查发起返工。`)
}
if (!subjectMatches(review, { kind: 'stage', goal, stageIndex })) {
return deny('no-stage-review', `阶段 ${stageIndex} 的最新驳回针对的是另一版验收标准/任务范围;请按当前版本重新记录 stage_reject。`)
}
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 review = latestDecision(reviews, {
projectId: project.id, goalId: goal.id, kind: 'goal', stageIndex: null,
reviewerRoles: ['lead', 'user'],
})
if (!review) {
return deny('no-goal-review', `完成前先由丞相记录目标验收:sansheng_review action=goal_pass evidence=...(当前版本 revision ${goal.revision})。`)
}
if (review.verdict !== 'pass') {
return deny('goal-latest-reject', `目标的最新验收结论是驳回(${review.reason ?? '未写原因'});修正后必须重新记录 goal_pass。`)
}
if (!subjectMatches(review, { kind: 'goal', goal })) {
return deny('no-goal-review', '目标验收针对的是另一版目标/验收标准;请按当前版本重新记录 goal_pass。')
}
const artifactVerdict = checkArtifact(review)
if (artifactVerdict) return artifactVerdict
return { allow: true }
}
return { allow: true }
}