@mldong/jeeflow 1.8.17 → 1.8.19

package/dist/builtin.d.ts

@@ -12,9 +12,10 @@ export declare const HANDLER_TASK_ROLE_ASSIGNEE: string;
 export declare class OperatorAssignmentHandler implements IAssignmentHandler {
     assign(_node: FlowNode, inst: ProcessInstance | null, _operator: string): Promise<string[]>;
 }
-/** 按表单字段值分配参与者：精确匹配 node.id → vars 字段；_数字 后缀去后缀再匹配。 */
+/** 按表单字段值分配参与者：f_ 前缀优先 → 裸名回落 → _数字 后缀去后缀再匹配。 */
 export declare class FormFieldAssigneeHandler implements IAssignmentHandler {
     assign(node: FlowNode, inst: ProcessInstance | null, _operator: string): Promise<string[]>;
+    /** issues/48：f_ 前缀优先 → 裸名回落 → 编号后缀去后缀匹配裸名 */
     private findFieldValue;
     private collect;
     private add;

package/dist/builtin.js

@@ -21,7 +21,7 @@ export class OperatorAssignmentHandler {
         return ['apply.operator'];
     }
 }
-/** 按表单字段值分配参与者：精确匹配 node.id → vars 字段；_数字 后缀去后缀再匹配。 */
+/** 按表单字段值分配参与者：f_ 前缀优先 → 裸名回落 → _数字 后缀去后缀再匹配。 */
 export class FormFieldAssigneeHandler {
     async assign(node, inst, _operator) {
         if (!inst || !node)
@@ -31,7 +31,10 @@ export class FormFieldAssigneeHandler {
             return [];
         return this.collect(value);
     }
+    /** issues/48：f_ 前缀优先 → 裸名回落 → 编号后缀去后缀匹配裸名 */
     findFieldValue(variables, fieldName) {
+        if ('f_' + fieldName in variables)
+            return variables['f_' + fieldName];
         if (fieldName in variables)
             return variables[fieldName];
         const m = NUMBER_SUFFIX_PATTERN.exec(fieldName);

package/dist/engine.d.ts

@@ -49,6 +49,11 @@ export declare class EngineImpl implements Engine {
     executeAndJumpToEnd(taskId: string, operator: string, args?: Record<string, any>): Promise<ProcessInstance>;
     executeAndJumpTask(taskId: string, operator: string, args?: Record<string, any>, targetTaskName?: string): Promise<ProcessInstance>;
     executeAndJumpToFirstTaskNode(taskId: string, operator: string, args?: Record<string, any>): Promise<ProcessInstance>;
+    private prepareExecuteTask;
+    private previousTaskName;
+    private isFirstTaskNode;
+    private rollbackActors;
+    private createTaskWithActors;
     private loadAndCheck;
     private executeNode;
     private evaluateDecision;

package/dist/engine.js

@@ -127,31 +127,18 @@ export class EngineImpl {
     }
     // ─── Execute ───────────────────────────────────────────────────────────────
     async executeProcessTask(taskId, operator, args = {}) {
-        const { task, inst } = await this.loadAndCheck(taskId, operator);
-        // issues/26：办理提交的 f_ 字段按任务节点字段权限过滤（只读/隐藏不入变量）——
-        // 被拒值无法经流程变量落到下游节点写入，上游只读声明不可被绕过
-        const def = await this.repo.findDefineById(inst.defineId);
-        const flow = JSON.parse(typeof def.content === 'string' ? def.content : new TextDecoder().decode(def.content));
-        args = filterFieldByPerm(args, findNode(flow, task.taskName));
-        const vars = { ...inst.variables, ...task.variables, ...args };
-        await this.addUserInfo(operator, vars);
+        const { task, inst, flow, vars } = await this.prepareExecuteTask(taskId, operator, args);
         const now = new Date();
-        // 聚合根：完成任务（子实体状态转换 + 实例变量合并）
-        inst.completeTask(task, operator, vars, now);
-        await this.repo.updateTask(task);
-        // v1.0.1：updateInstance 级联持久化依赖聚合内任务副本为最新状态，
-        // completeTask 改的是外部任务对象，需同步回聚合根
-        syncTaskToAggregate(inst, task);
-        await this.fireEvent({ type: EventType.TaskComplete, instanceId: inst.id, taskId: task.id, nodeId: task.taskName, operator });
-        inst.variables = vars;
-        await this.repo.updateInstance(inst);
         const curNode = findNode(flow, task.taskName);
         if (curNode) {
             // 1.8.0：任务完成节点自身的后置拦截器（SYNC 同步演进——任务节点推进更新状态/字段）。
             // createTask 不再触发（引擎语义修正），此处为完成任务节点的唯一触发点
             await this.firePost(curNode, inst);
             const ct = curNode.properties?.countersignType;
-            if (ct === 'SEQUENTIAL') {
+            // issues/79：会签一票否决（对齐 Java CountersignHandler / PHP setMerged(true)）——
+            // submitType=20 COUNTERSIGN_DISAGREE 时跳过会签"未完成即停留"门控，提前流转后续节点
+            const csVeto = !!ct && Number(vars[KeySubmitType]) === Number(SubmitType.CountersignDisagree);
+            if (ct === 'SEQUENTIAL' && !csVeto) {
                 const doing = await this.repo.findDoingTasks(inst.id);
                 if (doing.length === 0) {
                     const [actors, lc] = getCsState(vars, curNode.id);
@@ -171,7 +158,7 @@ export class EngineImpl {
                     return (await this.repo.findInstanceById(inst.id));
                 }
             }
-            if (ct === 'PARALLEL' || ct?.startsWith('RATIO')) {
+            if ((ct === 'PARALLEL' || ct?.startsWith('RATIO')) && !csVeto) {
                 const doing = await this.repo.findDoingTasks(inst.id);
                 if (doing.length > 0)
                     return (await this.repo.findInstanceById(inst.id));
@@ -186,66 +173,176 @@ export class EngineImpl {
     }
     // ─── Reject ────────────────────────────────────────────────────────────────
     async executeAndJumpToEnd(taskId, operator, args = {}) {
-        const { task, inst } = await this.loadAndCheck(taskId, operator);
-        const now = new Date();
-        // 聚合根：废弃所有进行中任务
-        for (const t of inst.abandonAllDoing(now))
-            await this.repo.updateTask(t);
-        // 子实体：完成任务
-        task.finish(operator, task.variables, now);
-        await this.repo.updateTask(task);
-        // v1.0.1：同步回聚合根，避免 updateInstance 级联把任务写回旧状态
-        syncTaskToAggregate(inst, task);
-        // 聚合根：驳回
-        inst.reject(now);
+        const { inst } = await this.prepareExecuteTask(taskId, operator, args);
+        // 门面 submitType=2 REJECT 唯一入口（对齐 Java executeAndJumpToEnd 语义）
+        inst.reject(new Date());
         await this.repo.updateInstance(inst);
         await this.fireEvent({ type: EventType.ProcessReject, instanceId: inst.id, taskId, operator });
-        return inst;
+        return (await this.repo.findInstanceById(inst.id));
     }
-    // ─── Jump ──────────────────────────────────────────────────────────────────
+    // ─── Jump（ROLLBACK 空 target / JUMP 命名 target，boot2 executeAndJumpTask）────
     async executeAndJumpTask(taskId, operator, args = {}, targetTaskName) {
-        const { task, inst } = await this.loadAndCheck(taskId, operator);
-        const now = new Date();
-        // 聚合根：废弃所有进行中任务
-        for (const t of inst.abandonAllDoing(now))
-            await this.repo.updateTask(t);
-        // 子实体：完成任务
-        task.finish(operator, task.variables, now);
-        await this.repo.updateTask(task);
-        if (targetTaskName) {
-            const def = await this.repo.findDefineById(inst.defineId);
-            const flow = JSON.parse(typeof def.content === 'string' ? def.content : new TextDecoder().decode(def.content));
+        const { task, inst, flow, vars } = await this.prepareExecuteTask(taskId, operator, args);
+        if (!targetTaskName) {
+            // issues/79：ROLLBACK 对齐 Java rejectTask——退回上一任务节点（首条输入边 source），
+            // 新任务 actor=当前任务完成人（退回操作人）；无上一任务节点则不产生新待办
+            const prevName = this.previousTaskName(flow, task.taskName);
+            if (prevName) {
+                const prev = findNode(flow, prevName);
+                if (prev) {
+                    const actors = this.rollbackActors(prev, inst, task);
+                    await this.createTaskWithActors(prev, inst, operator, vars, actors);
+                }
+            }
+        }
+        else {
+            // issues/79：对齐 Java——目标节点不存在显式报错（前端 JUMP 无效 taskName 不再静默空操作）
             const target = findNode(flow, targetTaskName);
-            if (target)
-                await this.executeNode(flow, inst, target, operator, inst.variables);
+            if (!target)
+                throw new Error(`根据节点名称[${targetTaskName}]无法找到节点模型`);
+            // 对齐 Java isFirstTaskName：跳首任务节点（start 直接后继）assignee 强制为发起人
+            if (target.type === TypeTask && this.isFirstTaskNode(flow, target)) {
+                target.properties = target.properties ?? {};
+                target.properties.assignee = inst.operator;
+            }
+            await this.executeNode(flow, inst, target, operator, vars);
         }
-        return inst;
+        return (await this.repo.findInstanceById(inst.id));
     }
     // ─── Jump To First Task（退回发起人，boot2 ROLLBACK_TO_OPERATOR=6）────────────
     async executeAndJumpToFirstTaskNode(taskId, operator, args = {}) {
-        const { task, inst } = await this.loadAndCheck(taskId, operator);
-        const now = new Date();
-        // 聚合根：废弃所有进行中任务
-        for (const t of inst.abandonAllDoing(now))
-            await this.repo.updateTask(t);
-        // 子实体：完成任务
-        task.finish(operator, task.variables, now);
-        await this.repo.updateTask(task);
+        const { inst, flow, vars } = await this.prepareExecuteTask(taskId, operator, args);
         // 找到第一个任务节点，强制参与者为发起人，重新执行
-        const def = await this.repo.findDefineById(inst.defineId);
-        const flow = JSON.parse(typeof def.content === 'string' ? def.content : new TextDecoder().decode(def.content));
         const startNode = findNodeByType(flow, TypeStart);
         if (startNode) {
             for (const node of followEdges(flow, startNode.id)) {
                 if (node.type === TypeTask || node.type === TypeCustom) {
                     node.properties = node.properties ?? {};
                     node.properties.assignee = inst.operator;
-                    await this.executeNode(flow, inst, node, operator, inst.variables);
+                    await this.executeNode(flow, inst, node, operator, vars);
                     break;
                 }
             }
         }
-        return inst;
+        return (await this.repo.findInstanceById(inst.id));
+    }
+    // ─── Execute 公共序言（对齐 Java prepareExecution）──────────────────────────
+    // 执行公共序言（对齐 Java prepareExecution）：权限校验 → f_ 字段权限过滤 →
+    // 完成任务（子实体状态转换 + 实例变量合并，经 updateInstance 级联落库）→
+    // 返回流程模型 + 合并后执行变量。Java jump 路径不废弃其余 DOING 任务
+    // （会签兄弟任务不受影响），此处保持一致。
+    async prepareExecuteTask(taskId, operator, args) {
+        const { task, inst } = await this.loadAndCheck(taskId, operator);
+        // issues/26：办理提交的 f_ 字段按任务节点字段权限过滤（只读/隐藏不入变量）
+        const def = await this.repo.findDefineById(inst.defineId);
+        const flow = JSON.parse(typeof def.content === 'string' ? def.content : new TextDecoder().decode(def.content));
+        args = filterFieldByPerm(args, findNode(flow, task.taskName));
+        const vars = { ...inst.variables, ...task.variables, ...args };
+        await this.addUserInfo(operator, vars);
+        const now = new Date();
+        // 聚合根：完成任务（子实体状态转换 + 实例变量合并）
+        inst.completeTask(task, operator, vars, now);
+        await this.repo.updateTask(task);
+        // v1.0.1：updateInstance 级联持久化依赖聚合内任务副本为最新状态，
+        // completeTask 改的是外部任务对象，需同步回聚合根
+        syncTaskToAggregate(inst, task);
+        await this.fireEvent({ type: EventType.TaskComplete, instanceId: inst.id, taskId: task.id, nodeId: task.taskName, operator });
+        inst.variables = vars;
+        await this.repo.updateInstance(inst);
+        return { task, inst, flow, vars };
+    }
+    // 当前任务节点的首条输入边 source（issues/79 对齐 Java getPreviousTaskName）
+    previousTaskName(flow, taskName) {
+        const node = findNode(flow, taskName);
+        if (!node)
+            return '';
+        for (const edge of flow.edges) {
+            if (edge.targetNodeId === node.id) {
+                const src = findNode(flow, edge.sourceNodeId);
+                if (src && (src.type === TypeTask || src.type === TypeCustom))
+                    return src.id;
+            }
+        }
+        return '';
+    }
+    // 是否 start 直接后继任务节点（issues/79 对齐 Java FlowUtil.isFirstTaskName）
+    isFirstTaskNode(flow, node) {
+        const start = findNodeByType(flow, TypeStart);
+        if (!start)
+            return false;
+        return flow.edges.some(e => e.sourceNodeId === start.id && e.targetNodeId === node.id);
+    }
+    // ROLLBACK 新任务参与者：优先当前任务完成人（退回操作人，对齐 Java rejectTask
+    // singletonList(currentTask.getActorId())），其次按目标节点 assignee 解析
+    rollbackActors(node, inst, task) {
+        if (task.actorId)
+            return [task.actorId];
+        const nextOp = inst.variables[KeyNextNodeOperator];
+        if (nextOp != null) {
+            if (typeof nextOp === 'string')
+                return nextOp.split(',').map(s => s.trim()).filter(Boolean);
+            if (Array.isArray(nextOp))
+                return nextOp.map(String);
+            return [String(nextOp)];
+        }
+        const assignee = node.properties?.assignee;
+        if (assignee) {
+            const actors = [];
+            for (const raw of assignee.split(',')) {
+                let token = raw.trim();
+                if (!token)
+                    continue;
+                if (token.includes('applicant'))
+                    token = token.replace('applicant', inst.operator);
+                if (token in inst.variables) {
+                    const val = inst.variables[token];
+                    if (Array.isArray(val))
+                        actors.push(...val.map(String));
+                    else
+                        actors.push(String(val));
+                }
+                else {
+                    actors.push(token);
+                }
+            }
+            return actors;
+        }
+        return [];
+    }
+    // 以显式参与者建任务（会签节点拆分为逐人任务，对齐 Java 会签创建语义）
+    async createTaskWithActors(node, inst, operator, vars, actors) {
+        if (!actors.length)
+            return;
+        const ct = node.properties?.countersignType;
+        const now = new Date();
+        const form = node.properties?.form ?? '';
+        if (isCountersign(node.properties?.performType) && ct) {
+            switch (ct) {
+                case 'PARALLEL':
+                case '':
+                    for (const actor of actors)
+                        await this.repo.saveTask(inst.createTask(this.nextId(), node.id, node.text.value, actor, operator, form, now, 1));
+                    return;
+                case 'SEQUENTIAL': {
+                    const nt = inst.createTask(this.nextId(), node.id, node.text.value, actors[0], operator, form, now, 1);
+                    nt.variables = {
+                        [`nrOfInstances_${node.id}`]: actors.length,
+                        [`loopCounter_${node.id}`]: 0,
+                        [`operatorList_${node.id}`]: actors,
+                    };
+                    await this.repo.saveTask(nt);
+                    return;
+                }
+                default:
+                    for (const actor of actors)
+                        await this.repo.saveTask(inst.createTask(this.nextId(), node.id, node.text.value, actor, operator, form, now, 1));
+                    return;
+            }
+        }
+        const nt = inst.createTask(this.nextId(), node.id, node.text.value, actors[0], operator, form, now);
+        if (actors.length > 1)
+            nt.actorIds = actors;
+        await this.repo.saveTask(nt);
     }
     // ─── Helpers ───────────────────────────────────────────────────────────────
     async loadAndCheck(taskId, operator) {

package/dist/facade.d.ts

@@ -44,6 +44,13 @@ export declare class JeeflowFacade {
     private designSave;
     private surrogatePage;
     private surrogateSave;
+    /** 委托更新（issues/77）：按 id 全字段更新，id 缺失/不存在报错 */
+    private surrogateUpdate;
+    /** 委托详情（issues/77）：按 id 查单条，返回行结构（时间格式化） */
+    private surrogateDetail;
+    /** 委托写入公共字段。授权人（operator）仅在显式传入时覆盖，避免 update
+     *  时清空原授权人（前端编辑表单不带 operator；集成层注入时 operator=授权人，覆盖无害） */
+    private applySurrogateFields;
     private getLastByName;
     private highLight;
     /** 节点成员进度（issue 41，对齐 boot3 highLight）：按任务状态 + 会签变量组装

package/dist/facade.js

@@ -101,6 +101,10 @@ export class JeeflowFacade {
                 return this.surrogatePage(args);
             case 'processSurrogate/save':
                 return this.surrogateSave(args);
+            case 'processSurrogate/update': // issues/77
+                return this.surrogateUpdate(args);
+            case 'processSurrogate/detail': // issues/77
+                return this.surrogateDetail(args);
             case 'processSurrogate/remove':
                 return this.ext().removeSurrogate(toId(args.id));
             case 'processDefine/getLastByName':
@@ -576,7 +580,8 @@ export class JeeflowFacade {
         const pageNum = toInt(args.pageNum ?? 1);
         const pageSize = toInt(args.pageSize ?? 10);
         const [rows, total] = await this.ext().pageSurrogates(pageNum, pageSize, filters, parseMQuery(args));
-        return pageData(pageNum, pageSize, total, rows);
+        // issues/77：行走 surrogateRowToMap（时间格式化），与 detail 同构
+        return pageData(pageNum, pageSize, total, rows.map(r => surrogateRowToMap(r)));
     }
     async surrogateSave(args) {
         const ext = this.ext();
@@ -585,30 +590,56 @@ export class JeeflowFacade {
         let surrogate;
         if (!surrogateId) {
             surrogate = {
-                id: '', operator, // 授权人 = 操作人
-                surrogate: String(args.surrogate ?? ''), processName: String(args.processName ?? ''),
-                enabled: toInt(args.enabled ?? 1),
+                id: '', operator, surrogate: '', processName: '', // 授权人 = 操作人（新建必有）
+                enabled: 1,
                 createTime: new Date(), createUser: operator,
                 updateTime: new Date(), updateUser: operator,
             };
+            this.applySurrogateFields(surrogate, args, operator);
             await ext.saveSurrogate(surrogate);
         }
         else {
             const found = await ext.findSurrogateById(surrogateId);
             if (!found)
                 throw new Error('委托记录不存在');
-            if (args.surrogate != null)
-                found.surrogate = String(args.surrogate);
-            if (args.processName != null)
-                found.processName = String(args.processName);
-            if (args.enabled != null)
-                found.enabled = toInt(args.enabled);
-            found.updateUser = operator;
+            this.applySurrogateFields(found, args, operator);
             await ext.updateSurrogate(found);
             surrogate = found;
         }
         return { id: surrogate.id };
     }
+    /** 委托更新（issues/77）：按 id 全字段更新，id 缺失/不存在报错 */
+    async surrogateUpdate(args) {
+        const ext = this.ext();
+        const surrogateId = toId(args.id);
+        const surrogate = await ext.findSurrogateById(surrogateId);
+        if (!surrogate)
+            throw new Error('委托记录不存在');
+        const operator = String(args.operator ?? 'user1');
+        this.applySurrogateFields(surrogate, args, operator);
+        await ext.updateSurrogate(surrogate);
+        return { id: surrogate.id };
+    }
+    /** 委托详情（issues/77）：按 id 查单条，返回行结构（时间格式化） */
+    async surrogateDetail(args) {
+        const surrogateId = toId(args.id);
+        const surrogate = await this.ext().findSurrogateById(surrogateId);
+        if (!surrogate)
+            throw new Error('委托记录不存在');
+        return surrogateRowToMap(surrogate);
+    }
+    /** 委托写入公共字段。授权人（operator）仅在显式传入时覆盖，避免 update
+     *  时清空原授权人（前端编辑表单不带 operator；集成层注入时 operator=授权人，覆盖无害） */
+    applySurrogateFields(s, args, operator) {
+        s.processName = String(args.processName ?? '');
+        if ('operator' in args)
+            s.operator = String(args.operator);
+        s.surrogate = String(args.surrogate ?? '');
+        s.startTime = parseSurrogateTime(args.startTime);
+        s.endTime = parseSurrogateTime(args.endTime);
+        s.enabled = args.enabled != null ? toInt(args.enabled) : 1;
+        s.updateUser = operator;
+    }
     // ── 视图端点（v1.2.0） ──────────────────────────────────────────────────
     async getLastByName(args) {
         const def = await this.repo.findDefineByName(String(args.processDefineName ?? ''));
@@ -805,12 +836,18 @@ export class JeeflowFacade {
         if (!task)
             throw new Error('任务不存在');
         const actors = await this.repo.findTaskActors(taskId);
+        // issues/82-5：任务级 ext.isFirstTaskNode（前端 detail.vue 双兜底 record.ext?.isFirstTaskNode）
+        // 首个任务节点且 DOING → true，与 instance detail 的 activeTaskList 行语义一致
+        const tExt = { ...(task.variables ?? {}) };
+        const doing = task.taskState === TaskState.Doing;
+        tExt.isFirstTaskNode = false;
         const vo = {
             id: task.id, processInstanceId: task.processInstanceId, taskName: task.taskName,
             displayName: task.displayName, taskType: task.taskType ?? null,
             performType: task.performType ?? null, taskState: task.taskState,
             operator: task.actorId ?? '', formKey: task.formKey ?? '',
             taskActorIdList: actors, executable: task.isAllowed(operator),
+            ext: tExt,
             taskFormData: formDataOf(task.variables, 'tf_'), // issues/15
         };
         // taskModel：流程定义中对应节点
@@ -819,6 +856,7 @@ export class JeeflowFacade {
             const def = await this.repo.findDefineById(inst.defineId);
             if (def) {
                 vo.jsonObject = this.parseGraph(def.content); // issues/05
+                tExt.isFirstTaskNode = doing && task.taskName === this.firstTaskNodeId(vo.jsonObject);
                 try {
                     const flow = JSON.parse(toStr(def.content));
                     for (const n of flow.nodes ?? []) {
@@ -874,7 +912,8 @@ export class JeeflowFacade {
             catch { /* ignore */ }
         }
         if (candidates.length > 0) {
-            const rows = candidates.map(c => ({ userId: c, realName: c }));
+            // issues/80：行键对齐前端 UserSelect（valueField='id'）——补 id 键，保留 userId 兼容旧消费方
+            const rows = candidates.map(c => ({ id: c, userId: c, realName: c }));
             return pageData(pageNum, pageSize, rows.length, rows);
         }
         // 无模型候选 → 用户分页搜索（依赖 userSearch 钩子）
@@ -1102,6 +1141,37 @@ function defineRowToMap(r) {
     };
 }
 /** 设计行：时间格式化（issues/63） */
+/** 委托行：时间格式化（issues/77，对齐 Java surrogateRowToMap / Go surrogateRowToMap / SPEC） */
+function surrogateRowToMap(s) {
+    return {
+        id: s.id, processName: s.processName, operator: s.operator, surrogate: s.surrogate,
+        startTime: fmtTime(s.startTime ?? null), endTime: fmtTime(s.endTime ?? null),
+        enabled: s.enabled,
+        createTime: fmtTime(s.createTime ?? null), createUser: s.createUser,
+        updateTime: fmtTime(s.updateTime ?? null), updateUser: s.updateUser,
+    };
+}
+/** 解析委托时间入参：兼容 yyyy-MM-dd HH:mm:ss（前端 RangePicker/SPEC 契约）与 ISO T（issues/77） */
+function parseSurrogateTime(v) {
+    if (v == null)
+        return undefined;
+    const s = String(v).trim();
+    if (!s)
+        return undefined;
+    for (const fmt of ['YYYY-MM-DD HH:mm:ss', 'YYYY-MM-DDTHH:mm:ss', 'YYYY-MM-DD']) {
+        const m = s.match(fmt === 'YYYY-MM-DD'
+            ? /^(\d{4})-(\d{2})-(\d{2})$/
+            : /^(\d{4})-(\d{2})-(\d{2})[T ](\d{2}):(\d{2}):(\d{2})$/);
+        if (!m)
+            continue;
+        if (fmt === 'YYYY-MM-DD')
+            return new Date(Number(m[1]), Number(m[2]) - 1, Number(m[3]));
+        return new Date(Number(m[1]), Number(m[2]) - 1, Number(m[3]), Number(m[4]), Number(m[5]), Number(m[6]));
+    }
+    // 兜底：交给 Date 解析（覆盖其它可解析形态），失败返回 undefined
+    const d = new Date(s);
+    return isNaN(d.getTime()) ? undefined : d;
+}
 function designRowToMap(r) {
     return {
         id: r.id, name: r.name, displayName: r.displayName,
@@ -1199,6 +1269,12 @@ function toId(v) {
     // 数字输入（JS 安全整数内）转字符串；字符串输入原样保留（含超长雪花 id）。
     if (v == null)
         throw new Error('id 缺失或非法');
+    // issues/82 负向（对齐 Go TestSnowflakeIDPrecision / issues/38 E9）：数字 id 超 2^53
+    // 说明它已被 JSON 解析器（JSON.parse / encoding/json）降级为 float64 且精度已丢，
+    // 必须显性报错而非 String() 静默截断成错误 id。
+    if (typeof v === 'number' && Math.abs(v) > 2 ** 53) {
+        throw new Error(`id ${v} 超出 float64 精确范围（2^53），请以字符串传递`);
+    }
     const s = String(v).trim();
     if (!/^\d+$/.test(s) || s === '0')
         throw new Error('id 缺失或非法');

package/dist/jdbc/ext.js

@@ -203,8 +203,7 @@ export class JdbcProcessExtRepository {
             s.createTime = now;
         if (!s.updateTime)
             s.updateTime = now;
-        if (!s.enabled)
-            s.enabled = 1;
+        // 显式 enabled=0 是合法值（停用委托）；缺省由门面处理（对齐 Java/Go/Python，issues/82-7）
         const conn = await this.c();
         try {
             await conn.execute(this.sql('INSERT INTO wf_process_surrogate (id, process_name, operator, surrogate, start_time, ' +

package/dist/memory-ext.js

@@ -71,8 +71,7 @@ export class MemoryExtRepository {
             s.createTime = now;
         if (!s.updateTime)
             s.updateTime = now;
-        if (!s.enabled)
-            s.enabled = 1;
+        // 显式 enabled=0 是合法值（停用委托）；缺省由门面处理（对齐 Java/Go/Python，issues/82-7）
         this.surrogates.set(s.id, { ...s });
     }
     async updateSurrogate(s) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mldong/jeeflow",
-  "version": "1.8.17",
+  "version": "1.8.19",
   "description": "jeeflow workflow engine — Node.js / TypeScript implementation",
   "type": "module",
   "main": "./dist/index.js",