Import vendor/dsh-sansheng-liubu/workbench/core/states.mjs
This commit is contained in:
parent
4be8e9d94b
commit
623066c5fc
|
|
@ -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
|
||||
}
|
||||
Loading…
Reference in New Issue