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

139 lines
5.5 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.

// 四套状态机分开维护:部门运行、任务结论、投递进度、单次尝试。
// 合并成一个大状态会让“空闲”被当成“已完成”,正是方案 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
}