@mldong/jeeflow 1.8.12 → 1.8.14

package/README.md

@@ -1,80 +1,80 @@
-# jeeflow · Node.js / TypeScript
-
-[jeeflow](https://jeeflow-doc.mldong.com) 引擎规范的 **TypeScript 实现**。仅依赖 `node:*` 标准库，零外部依赖（引擎核心）。
-
-> **v1.1.0**：新增管理扩展（流程设计/历史/委托 + `ProcessExtRepository`）与统一门面
-> `JeeflowFacade.flow(action, args)`；assignee 变量解析与 `flow.auto`/`flow.admin` 系统代执行对齐 boot2/boot3。
-
-```bash
-npm install @mldong/jeeflow   # 等发布到 npm 后
-```
-
-## 快速开始
-
-```ts
-import { EngineImpl, MemoryRepository } from '@mldong/jeeflow'
-
-const repo = new MemoryRepository()
-const engine = new EngineImpl(repo)
-
-const def = {
-  id: '1', name: 'leave', displayName: '请假审批',
-  content: JSON.stringify({ nodes: [...], edges: [...] })
-}
-repo.addDefine(def)
-
-const inst = await engine.startProcessInstanceById(def.id, '张三')
-const tasks = await repo.findDoingTasks(inst.id)
-await engine.executeProcessTask(tasks[0].id, 'leader')
-```
-
-> ⚠️ **id 全程 string（issue 38 E9）**：引擎内部与 API 契约的 id（流程定义/实例/任务/设计）一律为**字符串**。
-> Java 雪花 id（>2^53）超出 JS 安全整数，`Number()` 转换必丢精度；字符串可无损承载，保证四语言同库共享流程。
-
-## JDBC（MySQL/PostgreSQL）
-
-```ts
-import mysql from 'mysql2/promise'
-import { JdbcRepository, TsIDGenerator, MysqlAdapter } from '@mldong/jeeflow/jdbc'
-
-// ⚠️ 必须配置 bigNumberStrings（issue 38 E9）：BIGINT 列以 string 返回，
-// 否则 mysql2 默认转 number，Java 雪花 id（>2^53）在驱动层就已丢精度
-const pool = mysql.createPool({
-  host: 'localhost', user: 'root', password: '***', database: 'wf',
-  supportBigNumbers: true,
-  bigNumberStrings: true,
-})
-const repo = new JdbcRepository(new MysqlAdapter(pool), new TsIDGenerator())
-```
-
-- MySQL 连接池必须带 `supportBigNumbers: true, bigNumberStrings: true`；PostgreSQL 的 int8 默认即字符串，无此要求
-- 引擎侧已做驱动兜底：`rowId()` 把驱动返回的 number/string 统一归一化为 string，未开 `bigNumberStrings` 时小 id（Node 自建）仍可用
-
-## 运行演示
-
-```bash
-git clone https://github.com/mldong/jeeflow-node
-cd jeeflow-node
-npm install
-npm run demo     # http://localhost:8082
-```
-
-## 目录
-
-| 路径 | 说明 |
-|------|------|
-| `src/engine.ts` | 引擎核心 |
-| `src/model.ts` | 域类型 |
-| `src/spi.ts` | SPI 接口 |
-| `src/memory.ts` | 内存仓储 |
-| `src/jdbc/` | JDBC 多库实现（shared 核心 + mysql/postgres 适配器） |
-| `demo/main.ts` | Express 演示 |
-| `__tests__/` | 9 项合规测试 |
-
-## 节点支持
-
-对齐 [SPEC.md](https://jeeflow-doc.mldong.com) v1.0——与 Java/Go 版一致。
-
-## License
-
-Apache-2.0
+# jeeflow · Node.js / TypeScript
+
+[jeeflow](https://jeeflow-doc.mldong.com) 引擎规范的 **TypeScript 实现**。仅依赖 `node:*` 标准库，零外部依赖（引擎核心）。
+
+> **v1.1.0**：新增管理扩展（流程设计/历史/委托 + `ProcessExtRepository`）与统一门面
+> `JeeflowFacade.flow(action, args)`；assignee 变量解析与 `flow.auto`/`flow.admin` 系统代执行对齐 boot2/boot3。
+
+```bash
+npm install @mldong/jeeflow   # 等发布到 npm 后
+```
+
+## 快速开始
+
+```ts
+import { EngineImpl, MemoryRepository } from '@mldong/jeeflow'
+
+const repo = new MemoryRepository()
+const engine = new EngineImpl(repo)
+
+const def = {
+  id: '1', name: 'leave', displayName: '请假审批',
+  content: JSON.stringify({ nodes: [...], edges: [...] })
+}
+repo.addDefine(def)
+
+const inst = await engine.startProcessInstanceById(def.id, '张三')
+const tasks = await repo.findDoingTasks(inst.id)
+await engine.executeProcessTask(tasks[0].id, 'leader')
+```
+
+> ⚠️ **id 全程 string（issue 38 E9）**：引擎内部与 API 契约的 id（流程定义/实例/任务/设计）一律为**字符串**。
+> Java 雪花 id（>2^53）超出 JS 安全整数，`Number()` 转换必丢精度；字符串可无损承载，保证四语言同库共享流程。
+
+## JDBC（MySQL/PostgreSQL）
+
+```ts
+import mysql from 'mysql2/promise'
+import { JdbcRepository, TsIDGenerator, MysqlAdapter } from '@mldong/jeeflow/jdbc'
+
+// ⚠️ 必须配置 bigNumberStrings（issue 38 E9）：BIGINT 列以 string 返回，
+// 否则 mysql2 默认转 number，Java 雪花 id（>2^53）在驱动层就已丢精度
+const pool = mysql.createPool({
+  host: 'localhost', user: 'root', password: '***', database: 'wf',
+  supportBigNumbers: true,
+  bigNumberStrings: true,
+})
+const repo = new JdbcRepository(new MysqlAdapter(pool), new TsIDGenerator())
+```
+
+- MySQL 连接池必须带 `supportBigNumbers: true, bigNumberStrings: true`；PostgreSQL 的 int8 默认即字符串，无此要求
+- 引擎侧已做驱动兜底：`rowId()` 把驱动返回的 number/string 统一归一化为 string，未开 `bigNumberStrings` 时小 id（Node 自建）仍可用
+
+## 运行演示
+
+```bash
+git clone https://github.com/mldong/jeeflow-node
+cd jeeflow-node
+npm install
+npm run demo     # http://localhost:8082
+```
+
+## 目录
+
+| 路径 | 说明 |
+|------|------|
+| `src/engine.ts` | 引擎核心 |
+| `src/model.ts` | 域类型 |
+| `src/spi.ts` | SPI 接口 |
+| `src/memory.ts` | 内存仓储 |
+| `src/jdbc/` | JDBC 多库实现（shared 核心 + mysql/postgres 适配器） |
+| `demo/main.ts` | Express 演示 |
+| `__tests__/` | 9 项合规测试 |
+
+## 节点支持
+
+对齐 [SPEC.md](https://jeeflow-doc.mldong.com) v1.0——与 Java/Go 版一致。
+
+## License
+
+Apache-2.0

package/dist/engine.d.ts

@@ -14,6 +14,7 @@ export declare const KeyNextNodeOperator = "tf_nextNodeOperator";
 export declare const KeyProcessStartNextNodeOperator = "f_nextNodeOperator";
 export declare const KeyAutoExecute = "flow.auto";
 export declare const KeyAdminID = "flow.admin";
+export declare const KeyAutoGenTitle = "autoGenTitle";
 export interface Engine {
     startProcessInstanceById(defineId: string, operator: string, args?: Record<string, any>): Promise<ProcessInstance>;
     executeProcessTask(taskId: string, operator: string, args?: Record<string, any>): Promise<ProcessInstance>;
@@ -34,7 +35,9 @@ export declare class EngineImpl implements Engine {
     private interceptorCache;
     /** 定义级拦截器解析（issue 34，对齐 Java 模型级 postInterceptors）：
      *  流程定义顶层 postInterceptors 声明 → 按名从 interceptorRegistry 取（未声明该流程不触发）；
-     *  未声明 → 回落引擎级列表（向后兼容）。结果按 defineId 缓存。 */
+     *  未声明 → 回落引擎级列表（向后兼容）。结果按 defineId 缓存。
+     *  issues/60：解析与校验分离——定义读取/JSON 解析失败回落引擎级（现状语义），
+     *  声明中存在未注册名时抛错（不静默跳过），且错误不写缓存保证持续报错。 */
     private resolveInterceptors;
     private firePre;
     /** 表达式求值（v1.5.0，门面 highLight 决策分支过滤用） */
@@ -53,6 +56,8 @@ export declare class EngineImpl implements Engine {
     private resolveActors;
     private isAllowed;
     private addUserInfo;
+    /** issue 29：自动生成标题（对齐 boot3 FlowUtil.addAutoGenTitle） */
+    private addAutoGenTitle;
     /** 用户提供者访问（issue 41 补强：nodeProgress 姓名解析用） */
     getUserProvider(): UserProvider | undefined;
     private nextId;

package/dist/engine.js

@@ -15,6 +15,8 @@ export const KeyProcessStartNextNodeOperator = 'f_nextNodeOperator';
 // v1.0.1：系统代执行 / 超级管理员（对齐 boot3 FlowConst）
 export const KeyAutoExecute = 'flow.auto';
 export const KeyAdminID = 'flow.admin';
+// issue 29：自动生成标题（对齐 boot3 FlowConst.AUTO_GEN_TITLE）
+export const KeyAutoGenTitle = 'autoGenTitle';
 export class EngineImpl {
     repo;
     userProv;
@@ -36,7 +38,9 @@ export class EngineImpl {
     interceptorCache = new Map();
     /** 定义级拦截器解析（issue 34，对齐 Java 模型级 postInterceptors）：
      *  流程定义顶层 postInterceptors 声明 → 按名从 interceptorRegistry 取（未声明该流程不触发）；
-     *  未声明 → 回落引擎级列表（向后兼容）。结果按 defineId 缓存。 */
+     *  未声明 → 回落引擎级列表（向后兼容）。结果按 defineId 缓存。
+     *  issues/60：解析与校验分离——定义读取/JSON 解析失败回落引擎级（现状语义），
+     *  声明中存在未注册名时抛错（不静默跳过），且错误不写缓存保证持续报错。 */
     async resolveInterceptors(inst) {
         if (!this.ext)
             return [];
@@ -47,23 +51,27 @@ export class EngineImpl {
         if (cached)
             return cached;
         let list = this.ext.interceptors ?? [];
+        let declared = '';
         try {
             const def = await this.repo.findDefineById(defineId);
             if (def) {
                 const content = typeof def.content === 'string' ? def.content : new TextDecoder().decode(def.content);
                 const meta = JSON.parse(content);
-                const declared = String(meta.postInterceptors ?? '').trim();
-                if (declared) {
-                    list = [];
-                    for (const name of declared.split(',').map(n => n.trim())) {
-                        const ic = this.ext.interceptorRegistry?.[name];
-                        if (name && ic)
-                            list.push(ic);
-                    }
-                }
+                declared = String(meta.postInterceptors ?? '').trim();
+            }
+        }
+        catch { /* 定义读取/JSON 解析失败回落引擎级 */ }
+        if (declared) {
+            list = [];
+            for (const name of declared.split(',').map(n => n.trim())) {
+                if (!name)
+                    continue;
+                const ic = this.ext.interceptorRegistry?.[name];
+                if (!ic)
+                    throw new Error(`postInterceptors 声明的拦截器未注册: ${name}`);
+                list.push(ic);
             }
         }
-        catch { /* 解析失败回落引擎级 */ }
         this.interceptorCache.set(defineId, list);
         return list;
     }
@@ -103,6 +111,7 @@ export class EngineImpl {
         const flow = JSON.parse(content);
         const vars = { ...args };
         await this.addUserInfo(operator, vars);
+        this.addAutoGenTitle(def.displayName, vars);
         const now = new Date();
         // 聚合根工厂创建实例
         const inst = ProcessInstance.create(this.nextId(), defineId, operator, vars, now);
@@ -470,6 +479,14 @@ export class EngineImpl {
         if (u.postName)
             vars[KeyPostName] = u.postName;
     }
+    /** issue 29：自动生成标题（对齐 boot3 FlowUtil.addAutoGenTitle） */
+    addAutoGenTitle(displayName, vars) {
+        const realName = vars[KeyRealName] || '';
+        const now = new Date();
+        const pad = (n) => n.toString().padStart(2, '0');
+        const timeStr = `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())} ${pad(now.getHours())}:${pad(now.getMinutes())}`;
+        vars[KeyAutoGenTitle] = `${realName}的${displayName}-${timeStr}`;
+    }
     /** 用户提供者访问（issue 41 补强：nodeProgress 姓名解析用） */
     getUserProvider() {
         return this.userProv;

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 export { EngineImpl, type Engine } from './engine.js';
 export { MemoryRepository } from './memory.js';
-export { HandlerRegistry, type IAssignmentHandler, type IDecisionHandler, type HandlerMeta } from './registry.js';
+export { HandlerRegistry, type IAssignmentHandler, type IDecisionHandler, type HandlerMeta, type HandlerType } from './registry.js';
 export { enumDict, enumDictKeys, type DictItem } from './metadata.js';
 export * from './model.js';
 export type { ProcessRepository, UserProvider, OrgUserProvider, IDGenerator, ExpressionEvaluator } from './spi.js';
-export { SqliteDynamicTableWriter, PersistPostInterceptor, type DynamicTableWriter, type DefineLoader, } from './persist.js';
+export { SqliteDynamicTableWriter, PersistPostInterceptor, registerPersistMeta, type DynamicTableWriter, type DefineLoader, } from './persist.js';
 export { registerBuiltinAssignments, OperatorAssignmentHandler, FormFieldAssigneeHandler, DeptLeaderAssignmentHandler, DeptMainLeaderAssignmentHandler, ApplicantDeptLeaderAssignmentHandler, ApplicantDeptMainLeaderAssignmentHandler, TaskRoleAssigneeHandler, HANDLER_OPERATOR_ASSIGNMENT, HANDLER_FORM_FIELD_ASSIGNEE, HANDLER_DEPT_LEADER, HANDLER_DEPT_MAIN_LEADER, HANDLER_APPLICANT_DEPT_LEADER, HANDLER_APPLICANT_DEPT_MAIN_LEADER, HANDLER_TASK_ROLE_ASSIGNEE, } from './builtin.js';
 export { JeeflowFacade } from './facade.js';
 export type { EngineExtensions, FlowInterceptor, ProcessEventListener, ProcessEvent, AssignmentHandler, DecisionHandler } from './extensions.js';

package/dist/index.js

@@ -3,7 +3,7 @@ export { MemoryRepository } from './memory.js';
 export { HandlerRegistry } from './registry.js';
 export { enumDict, enumDictKeys } from './metadata.js';
 export * from './model.js';
-export { SqliteDynamicTableWriter, PersistPostInterceptor, } from './persist.js';
+export { SqliteDynamicTableWriter, PersistPostInterceptor, registerPersistMeta, } from './persist.js';
 export { registerBuiltinAssignments, OperatorAssignmentHandler, FormFieldAssigneeHandler, DeptLeaderAssignmentHandler, DeptMainLeaderAssignmentHandler, ApplicantDeptLeaderAssignmentHandler, ApplicantDeptMainLeaderAssignmentHandler, TaskRoleAssigneeHandler, HANDLER_OPERATOR_ASSIGNMENT, HANDLER_FORM_FIELD_ASSIGNEE, HANDLER_DEPT_LEADER, HANDLER_DEPT_MAIN_LEADER, HANDLER_APPLICANT_DEPT_LEADER, HANDLER_APPLICANT_DEPT_MAIN_LEADER, HANDLER_TASK_ROLE_ASSIGNEE, } from './builtin.js';
 // issues/35：包导出面补齐——门面/扩展类型/扩展仓储（集成方组装完整引擎链）
 export { JeeflowFacade } from './facade.js';

package/dist/persist.d.ts

@@ -1,6 +1,7 @@
 import { DatabaseSync } from 'node:sqlite';
 import { type ProcessInstance, type ProcessDefine, type FlowNode } from './model.js';
 import type { FlowInterceptor } from './extensions.js';
+import type { HandlerRegistry } from './registry.js';
 /**
  * 动态表写入组件接口——引擎无关，四语言契约一致（Java/Go/Python/Node）
  *
@@ -111,3 +112,6 @@ export declare class PersistPostInterceptor implements FlowInterceptor {
     /** 流程上下文字段（蛇形列名约定，与 writer 系统字段一致） */
     private fillContext;
 }
+/** 将 PersistPostInterceptor 元数据注册进处理器注册中心（SPI 字典源），
+ *  集成方在实例组装处调用一次即可，保证"字典项 ⟺ 实例"同步（避免各端写死注册遗漏/名不一致）。 */
+export declare function registerPersistMeta(registry: HandlerRegistry): void;

package/dist/persist.js

@@ -362,3 +362,14 @@ export class PersistPostInterceptor {
         data['apply_dept_id'] ??= inst.variables[KeyDeptID] ?? null;
     }
 }
+// ─── 注册助手（issues/60）──────────────────────────────────────────────────────
+/** 将 PersistPostInterceptor 元数据注册进处理器注册中心（SPI 字典源），
+ *  集成方在实例组装处调用一次即可，保证"字典项 ⟺ 实例"同步（避免各端写死注册遗漏/名不一致）。 */
+export function registerPersistMeta(registry) {
+    registry.registerMeta('FlowInterceptor', {
+        name: 'com.mldong.jeeflow.persist.interceptor.PersistPostInterceptor',
+        displayName: '业务数据自动入库',
+        order: 0,
+        group: 'post',
+    });
+}

package/dist/registry.d.ts

@@ -8,8 +8,12 @@ export interface IAssignmentHandler {
 export interface IDecisionHandler {
     decide(node: FlowNode, inst: ProcessInstance, vars: Record<string, any>): string | Promise<string>;
 }
+/** 处理器类型名（对齐 Java/go/python HandlerMeta.type，四语言通用） */
+export type HandlerType = 'AssignmentHandler' | 'CandidateHandler' | 'FlowInterceptor' | 'DecisionHandler';
 /** 处理器元数据（v1.4.0，SPI 实现清单字典源） */
 export interface HandlerMeta {
+    /** 处理器类型（内置 AssignmentHandler 元数据自动携带；老数据缺省按 AssignmentHandler 归类） */
+    type?: HandlerType;
     /** 处理器标识：节点配置的 handlerName（与字典 value 一致） */
     name: string;
     /** 显示名（字典 label） */
@@ -28,14 +32,18 @@ export declare class HandlerRegistry {
     private metas;
     /** 构造即内置 7 个通用 AssignmentHandler 元数据（v1.6.0 issues/16，注册名与 Java 类全限定名一致） */
     constructor();
-    registerAssignment(name: string, handler: IAssignmentHandler, meta?: Omit<HandlerMeta, 'name'>): void;
-    registerDecision(name: string, handler: IDecisionHandler, meta?: Omit<HandlerMeta, 'name'>): void;
+    registerAssignment(name: string, handler: IAssignmentHandler, meta?: Omit<HandlerMeta, 'name' | 'type'>): void;
+    registerDecision(name: string, handler: IDecisionHandler, meta?: Omit<HandlerMeta, 'name' | 'type'>): void;
+    /** 注册处理器元数据（不绑定运行时实现，对齐 Java HandlerRegistry.register；
+     *  拦截器/候选类清单等无运行时注册表的类型用） */
+    registerMeta(type: HandlerType, meta: Omit<HandlerMeta, 'type'>): void;
     resolveAssignment(name: string): IAssignmentHandler | undefined;
     resolveDecision(name: string): IDecisionHandler | undefined;
-    /** 按处理器类型列出可用实现的元数据（typeName: AssignmentHandler / DecisionHandler，按 order 升序） */
-    listHandlers(typeName: 'AssignmentHandler' | 'DecisionHandler'): HandlerMeta[];
+    /** 按处理器类型列出可用实现的元数据（按 order 升序；
+     *  AssignmentHandler/DecisionHandler 并集运行时注册名，其余类型只列显式元数据） */
+    listHandlers(typeName: HandlerType): HandlerMeta[];
     /** 按处理器类型 + 分组列出（拦截器 pre/post） */
-    listHandlersGroup(typeName: 'AssignmentHandler' | 'DecisionHandler', group: string): HandlerMeta[];
+    listHandlersGroup(typeName: HandlerType, group: string): HandlerMeta[];
     /** 已注册的处理器名称清单（含未带元数据的） */
     listHandlerNames(): string[];
 }

package/dist/registry.js

@@ -1,12 +1,12 @@
 /** 内置通用 AssignmentHandler 元数据（v1.6.0 issues/16，注册名与 Java 类全限定名一致，四语言通用） */
 export const BUILTIN_ASSIGNMENT_METAS = [
-    { name: 'com.mldong.jeeflow.interceptor.impl.OperatorAssignmentHandler', displayName: '流程发起人', order: -9999 },
-    { name: 'com.mldong.jeeflow.interceptor.impl.OrgUserAssignmentHandlers$ApplicantDeptLeaderAssignmentHandler', displayName: '发起人所属部门经理', order: 10 },
-    { name: 'com.mldong.jeeflow.interceptor.impl.OrgUserAssignmentHandlers$ApplicantDeptMainLeaderAssignmentHandler', displayName: '发起人所属部门分管领导', order: 20 },
-    { name: 'com.mldong.jeeflow.interceptor.impl.OrgUserAssignmentHandlers$DeptLeaderAssignmentHandler', displayName: '当前用户所属部门经理', order: 30 },
-    { name: 'com.mldong.jeeflow.interceptor.impl.OrgUserAssignmentHandlers$DeptMainLeaderAssignmentHandler', displayName: '当前用户所属部门分管领导', order: 40 },
-    { name: 'com.mldong.jeeflow.interceptor.impl.FormFieldAssigneeHandler', displayName: '根据表单字段值分配参与者', order: 50 },
-    { name: 'com.mldong.jeeflow.interceptor.impl.OrgUserAssignmentHandlers$TaskRoleAssigneeHandler', displayName: '根据任务节点唯一编码关联角色分配参与者', order: 60 },
+    { type: 'AssignmentHandler', name: 'com.mldong.jeeflow.interceptor.impl.OperatorAssignmentHandler', displayName: '流程发起人', order: -9999 },
+    { type: 'AssignmentHandler', name: 'com.mldong.jeeflow.interceptor.impl.OrgUserAssignmentHandlers$ApplicantDeptLeaderAssignmentHandler', displayName: '发起人所属部门经理', order: 10 },
+    { type: 'AssignmentHandler', name: 'com.mldong.jeeflow.interceptor.impl.OrgUserAssignmentHandlers$ApplicantDeptMainLeaderAssignmentHandler', displayName: '发起人所属部门分管领导', order: 20 },
+    { type: 'AssignmentHandler', name: 'com.mldong.jeeflow.interceptor.impl.OrgUserAssignmentHandlers$DeptLeaderAssignmentHandler', displayName: '当前用户所属部门经理', order: 30 },
+    { type: 'AssignmentHandler', name: 'com.mldong.jeeflow.interceptor.impl.OrgUserAssignmentHandlers$DeptMainLeaderAssignmentHandler', displayName: '当前用户所属部门分管领导', order: 40 },
+    { type: 'AssignmentHandler', name: 'com.mldong.jeeflow.interceptor.impl.FormFieldAssigneeHandler', displayName: '根据表单字段值分配参与者', order: 50 },
+    { type: 'AssignmentHandler', name: 'com.mldong.jeeflow.interceptor.impl.OrgUserAssignmentHandlers$TaskRoleAssigneeHandler', displayName: '根据任务节点唯一编码关联角色分配参与者', order: 60 },
 ];
 /** 处理器注册表——按名称注册/解析 + 元数据清单（对标 Spring IoC / Java HandlerRegistry） */
 export class HandlerRegistry {
@@ -22,12 +22,17 @@ export class HandlerRegistry {
     registerAssignment(name, handler, meta) {
         this.assignments.set(name, handler);
         if (meta)
-            this.metas.set(name, { name, ...meta });
+            this.metas.set(name, { type: 'AssignmentHandler', name, ...meta });
     }
     registerDecision(name, handler, meta) {
         this.decisions.set(name, handler);
         if (meta)
-            this.metas.set(name, { name, ...meta });
+            this.metas.set(name, { type: 'DecisionHandler', name, ...meta });
+    }
+    /** 注册处理器元数据（不绑定运行时实现，对齐 Java HandlerRegistry.register；
+     *  拦截器/候选类清单等无运行时注册表的类型用） */
+    registerMeta(type, meta) {
+        this.metas.set(meta.name, { type, ...meta });
     }
     resolveAssignment(name) {
         return this.assignments.get(name);
@@ -36,14 +41,24 @@ export class HandlerRegistry {
         return this.decisions.get(name);
     }
     // ── SPI 实现清单（v1.4.0）──
-    /** 按处理器类型列出可用实现的元数据（typeName: AssignmentHandler / DecisionHandler，按 order 升序） */
+    /** 按处理器类型列出可用实现的元数据（按 order 升序；
+     *  AssignmentHandler/DecisionHandler 并集运行时注册名，其余类型只列显式元数据） */
     listHandlers(typeName) {
-        const names = typeName === 'AssignmentHandler'
-            ? [...this.assignments.keys(), ...this.metas.keys()]
-            : [...this.decisions.keys(), ...this.metas.keys()];
-        // 内置 meta 属于 AssignmentHandler 类型——DecisionHandler 只列注册过的
-        const unique = typeName === 'AssignmentHandler' ? names : this.decisions.keys();
-        return [...new Set(unique)]
+        const names = new Set();
+        if (typeName === 'AssignmentHandler') {
+            for (const n of this.assignments.keys())
+                names.add(n);
+        }
+        else if (typeName === 'DecisionHandler') {
+            for (const n of this.decisions.keys())
+                names.add(n);
+        }
+        for (const [n, m] of this.metas) {
+            // 老数据无 type 时按 AssignmentHandler 归类（与历史 listHandlers 行为一致）
+            if ((m.type ?? 'AssignmentHandler') === typeName)
+                names.add(n);
+        }
+        return [...names]
             .map(n => this.metas.get(n) ?? { name: n })
             .sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
     }

package/package.json

@@ -1,48 +1,48 @@
-{
-  "name": "@mldong/jeeflow",
-  "version": "1.8.12",
-  "description": "jeeflow workflow engine — Node.js / TypeScript implementation",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": "./dist/index.js",
-    "./engine": "./dist/engine.js",
-    "./model": "./dist/model.js",
-    "./spi": "./dist/spi.js",
-    "./memory": "./dist/memory.js",
-    "./jdbc": "./dist/jdbc/index.js",
-    "./mysql": "./dist/jdbc/mysql.js",
-    "./postgres": "./dist/jdbc/postgres.js",
-    "./jdbc/ext": "./dist/jdbc/ext.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "test": "node --import tsx __tests__/spec.test.ts",
-    "demo": "node --import tsx demo/main.ts",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "workflow",
-    "engine",
-    "jeeflow",
-    "typescript"
-  ],
-  "license": "Apache-2.0",
-  "devDependencies": {
-    "@types/express": "^4.17.25",
-    "@types/pg": "^8.20.3",
-    "express": "^4.22.2",
-    "tsx": "^4.19.0",
-    "typescript": "^5.5.0"
-  },
-  "optionalDependencies": {
-    "mysql2": "^3.11.0",
-    "pg": "^8.13.0"
-  },
-  "files": [
-    "dist",
-    "LICENSE",
-    "README.md"
-  ]
+{
+  "name": "@mldong/jeeflow",
+  "version": "1.8.14",
+  "description": "jeeflow workflow engine — Node.js / TypeScript implementation",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./engine": "./dist/engine.js",
+    "./model": "./dist/model.js",
+    "./spi": "./dist/spi.js",
+    "./memory": "./dist/memory.js",
+    "./jdbc": "./dist/jdbc/index.js",
+    "./mysql": "./dist/jdbc/mysql.js",
+    "./postgres": "./dist/jdbc/postgres.js",
+    "./jdbc/ext": "./dist/jdbc/ext.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "node --import tsx __tests__/spec.test.ts",
+    "demo": "node --import tsx demo/main.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "workflow",
+    "engine",
+    "jeeflow",
+    "typescript"
+  ],
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@types/express": "^4.17.25",
+    "@types/pg": "^8.20.3",
+    "express": "^4.22.2",
+    "tsx": "^4.19.0",
+    "typescript": "^5.5.0"
+  },
+  "optionalDependencies": {
+    "mysql2": "^3.11.0",
+    "pg": "^8.13.0"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ]
 }