Import vendor/dsh-sansheng-liubu/workbench/core/states.mjs

This commit is contained in:
QQ 2026-11-12 00:14:27 +08:00
parent 4be8e9d94b
commit 623066c5fc
1 changed files with 138 additions and 0 deletions

View File

@ -0,0 +1,138 @@
// 四套状态机分开维护:部门运行、任务结论、投递进度、单次尝试。
// 合并成一个大状态会让“空闲”被当成“已完成”,正是方案 7.3/8.1 明确禁止的误判。
export const TASK_STATES = Object.freeze([
'draft',
'queued',
'running',
'waiting_input',
'needs_attention',
'completed',
'failed',
'cancelled',
])
export const DISPATCH_STATES = Object.freeze(['prepared', 'sending', 'accepted', 'unknown', 'rejected'])
export const ATTEMPT_STATES = Object.freeze([
'queued',
'running',
'succeeded',
'failed',
'cancel_requested',
'cancelled',
'unknown',
])
export const DEPARTMENT_STATES = Object.freeze(['uninitialized', 'idle', 'queued', 'running', 'unavailable'])
/**
* Task:draft 校验通过且授权有效才入队;waiting_input 只能回到原任务的执行路径,
* completed 是唯一“可交付”终态;needs_attention 仍可补报后完成,也可显式失败/取消。
* 终态(completed / failed / cancelled)不回到任何活动状态:重试一律新 attempt 或新任务。
*/
const TASK_TRANSITIONS = Object.freeze({
draft: Object.freeze(['queued', 'cancelled']),
queued: Object.freeze(['running', 'waiting_input', 'needs_attention', 'failed', 'cancelled']),
running: Object.freeze(['waiting_input', 'needs_attention', 'completed', 'failed', 'cancelled']),
waiting_input: Object.freeze(['queued', 'running', 'cancelled']),
needs_attention: Object.freeze(['running', 'completed', 'failed', 'cancelled']),
completed: Object.freeze([]),
failed: Object.freeze([]),
cancelled: Object.freeze([]),
})
/** Dispatch:发出不等于接收;超时可能 unknown,必须先对账,不能自动当失败重试。 */
const DISPATCH_TRANSITIONS = Object.freeze({
prepared: Object.freeze(['sending', 'rejected', 'unknown']),
sending: Object.freeze(['accepted', 'unknown', 'rejected']),
accepted: Object.freeze([]),
unknown: Object.freeze(['accepted', 'rejected']),
rejected: Object.freeze([]),
})
/** Attempt:cancel_requested 不等于已取消;unknown 必须先核对宿主运行再定终态。 */
const ATTEMPT_TRANSITIONS = Object.freeze({
queued: Object.freeze(['running', 'cancelled', 'failed', 'unknown']),
running: Object.freeze(['succeeded', 'failed', 'cancel_requested', 'unknown']),
cancel_requested: Object.freeze(['cancelled', 'succeeded', 'unknown']),
succeeded: Object.freeze([]),
failed: Object.freeze([]),
cancelled: Object.freeze([]),
unknown: Object.freeze(['succeeded', 'failed', 'cancelled', 'running']),
})
/** Department 只表达会话运行情况:unavailable 是绑定失效,仍保留旧引用。 */
const DEPARTMENT_TRANSITIONS = Object.freeze({
uninitialized: Object.freeze(['idle', 'queued', 'unavailable']),
idle: Object.freeze(['queued', 'running', 'unavailable']),
queued: Object.freeze(['running', 'idle', 'unavailable']),
running: Object.freeze(['idle', 'queued', 'unavailable']),
unavailable: Object.freeze(['uninitialized', 'idle']),
})
const MACHINES = Object.freeze({
task: Object.freeze({ key: 'task', name: 'Task', states: TASK_STATES, transitions: TASK_TRANSITIONS }),
dispatch: Object.freeze({ key: 'dispatch', name: 'Dispatch', states: DISPATCH_STATES, transitions: DISPATCH_TRANSITIONS }),
attempt: Object.freeze({ key: 'attempt', name: 'Attempt', states: ATTEMPT_STATES, transitions: ATTEMPT_TRANSITIONS }),
department: Object.freeze({ key: 'department', name: 'Department', states: DEPARTMENT_STATES, transitions: DEPARTMENT_TRANSITIONS }),
})
export const STATE_MACHINES = Object.freeze(
Object.fromEntries(Object.entries(MACHINES).map(([key, machine]) => [key, Object.freeze({
name: machine.name,
states: machine.states,
transitions: machine.transitions,
})])),
)
export const TERMINAL_STATES = Object.freeze({
task: Object.freeze(['completed', 'failed', 'cancelled']),
dispatch: Object.freeze(['accepted', 'rejected']),
attempt: Object.freeze(['succeeded', 'failed', 'cancelled']),
department: Object.freeze([]),
})
function machineOf(kind) {
const machine = MACHINES[kind]
if (machine === undefined) throw new Error(`未知状态机: ${String(kind)}`)
return machine
}
export function statesOf(kind) {
return machineOf(kind).states
}
export function isState(kind, value) {
return machineOf(kind).states.includes(value)
}
export function allowedTransitions(kind, from) {
const machine = machineOf(kind)
if (!machine.states.includes(from)) throw new Error(`${machine.name} 未知状态: ${String(from)}`)
return machine.transitions[from]
}
export function canTransition(kind, from, to) {
// 同状态重复写入不算迁移:事件重放时应由调用方静默忽略,而不是报错。
if (from === to) return true
return allowedTransitions(kind, from).includes(to)
}
const MACHINE_KEY = Object.freeze({ task: 'task', dispatch: 'dispatch', attempt: 'attempt', department: 'department' })
export function isTerminal(kind, state) {
return TERMINAL_STATES[machineOf(kind).key].includes(state)
}
/** 非法迁移一律抛错:状态倒退还沉默会让故障矩阵里“终态不被覆盖”的保证失效。 */
export function assertTransition(kind, from, to) {
const machine = machineOf(kind)
if (!machine.states.includes(from)) throw new Error(`${machine.name} 当前状态非法: ${String(from)}`)
if (!machine.states.includes(to)) throw new Error(`${machine.name} 目标状态非法: ${String(to)}`)
if (from === to) return to
if (!machine.transitions[from].includes(to)) {
throw new Error(`${machine.name} 不允许从 ${from} 迁移到 ${to}`)
}
return to
}