238 lines
11 KiB
JavaScript
238 lines
11 KiB
JavaScript
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 }
|
||
}
|