From 623066c5fcfafcd2f1cb5709d117f966945e14b6 Mon Sep 17 00:00:00 2001 From: QQ Date: Thu, 12 Nov 2026 00:14:27 +0800 Subject: [PATCH] Import vendor/dsh-sansheng-liubu/workbench/core/states.mjs --- .../workbench/core/states.mjs | 138 ++++++++++++++++++ 1 file changed, 138 insertions(+) create mode 100644 vendor/dsh-sansheng-liubu/workbench/core/states.mjs diff --git a/vendor/dsh-sansheng-liubu/workbench/core/states.mjs b/vendor/dsh-sansheng-liubu/workbench/core/states.mjs new file mode 100644 index 0000000..69ca1c1 --- /dev/null +++ b/vendor/dsh-sansheng-liubu/workbench/core/states.mjs @@ -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 +}