@mldong/jeeflow 1.3.0 → 1.5.0

package/dist/jdbc/shared.js

@@ -11,6 +11,30 @@
 import { AsyncLocalStorage } from 'node:async_hooks';
 import { ProcessInstance, ProcessTask } from '../model.js';
 import { TaskState } from '../model.js';
+// ═══ 列白名单（issues/05-5，与 mldong-boot2 别名一致） ═══
+const TASK_WHITELIST = new Set([
+    't.id', 't.task_name', 't.display_name', 't.task_type', 't.perform_type', 't.task_state',
+    't.operator', 't.form_key', 't.create_time', 't.finish_time', 't.expire_time',
+    't.process_instance_id', 't.task_parent_id', 't.variable',
+    'pi.id', 'pi.business_no', 'pi.operator', 'pi.create_time', 'pi.state',
+    'pd.name', 'pd.display_name', 'pd.type',
+    'pta.actor_id', 'pta.process_task_id',
+]);
+const INSTANCE_WHITELIST = new Set([
+    't.id', 't.parent_id', 't.process_define_id', 't.state', 't.business_no',
+    't.operator', 't.create_time', 't.expire_time', 't.variable',
+    'pd.name', 'pd.display_name', 'pd.type', 'pd.version',
+]);
+const CC_WHITELIST = new Set([
+    't.id', 't.process_define_id', 't.state', 't.business_no', 't.operator',
+    't.create_time', 't.variable',
+    'pd.name', 'pd.display_name', 'pd.type', 'pd.version',
+    'cc.actor_id', 'cc.state',
+]);
+const DEFINE_WHITELIST = new Set([
+    't.id', 't.name', 't.display_name', 't.type', 't.state', 't.version',
+    't.create_time', 't.update_time',
+]);
 // 当前异步上下文绑定的事务连接
 const txStore = new AsyncLocalStorage();
 /** 默认 ID 生成器：时间戳毫秒 + 同毫秒递增序号（对齐 Java nextId 默认实现） */
@@ -399,20 +423,193 @@ export class JdbcRepository {
             await this.done(conn);
         }
     }
+    // ── 核心表分页（v1.5.0，对齐 Java pageDefines/pageInstances/pageTodoTasks/pageDoneTasks）──
+    async pageDefines(pageNum, pageSize, conditions) {
+        const cond = this.buildWhere(conditions ?? [], DEFINE_WHITELIST);
+        const where = ' FROM wf_process_define t WHERE 1=1' + cond.sql;
+        const conn = await this.c();
+        try {
+            const countRow = await conn.fetchOne(this.sql('SELECT COUNT(*) ' + where), cond.params);
+            const total = Number(Object.values(countRow)[0] ?? 0);
+            const rows = await conn.fetchAll(this.sql('SELECT id, name, display_name, type, state, version, create_time, create_user, update_time, update_user' +
+                where + ' ORDER BY t.id DESC LIMIT ? OFFSET ?'), [...cond.params, pageSize, (pageNum - 1) * pageSize]);
+            return {
+                rows: rows.map(r => ({
+                    id: Number(r.id), name: r.name, displayName: r.display_name, type: r.type,
+                    state: Number(r.state), version: Number(r.version),
+                    createTime: r.create_time, createUser: r.create_user ?? '',
+                    updateTime: r.update_time, updateUser: r.update_user ?? '',
+                })),
+                total,
+            };
+        }
+        finally {
+            await this.done(conn);
+        }
+    }
+    async pageInstances(pageNum, pageSize, operator, conditions) {
+        const cond = this.buildWhere(conditions ?? [], INSTANCE_WHITELIST);
+        const where = ' FROM wf_process_instance t' +
+            ' LEFT JOIN wf_process_define pd ON t.process_define_id = pd.id' +
+            ' WHERE t.operator = ?' + cond.sql;
+        const conn = await this.c();
+        try {
+            const countRow = await conn.fetchOne(this.sql('SELECT COUNT(*) ' + where), [operator, ...cond.params]);
+            const total = Number(Object.values(countRow)[0] ?? 0);
+            const cols = 't.id, t.parent_id, t.process_define_id, t.state, t.parent_node_name, t.business_no,' +
+                ' t.operator, t.expire_time, t.variable, t.create_time, t.create_user, t.update_time, t.update_user,' +
+                ' pd.name, pd.display_name, pd.version';
+            const rows = await conn.fetchAll(this.sql(`SELECT ${cols}${where} ORDER BY t.id DESC LIMIT ? OFFSET ?`), [operator, ...cond.params, pageSize, (pageNum - 1) * pageSize]);
+            return { rows: rows.map(r => this.mapInstanceRow(r)), total };
+        }
+        finally {
+            await this.done(conn);
+        }
+    }
+    async pageTodoTasks(pageNum, pageSize, actorId, conditions) {
+        return this.pageTasks(pageNum, pageSize, false, actorId, conditions);
+    }
+    async pageDoneTasks(pageNum, pageSize, operator, conditions) {
+        return this.pageTasks(pageNum, pageSize, true, operator, conditions);
+    }
+    async pageTasks(pageNum, pageSize, done, filter, conditions) {
+        const cond = this.buildWhere(conditions ?? [], TASK_WHITELIST);
+        const where = ' FROM wf_process_task t' +
+            ' LEFT JOIN wf_process_instance pi ON t.process_instance_id = pi.id' +
+            ' LEFT JOIN wf_process_define pd ON pi.process_define_id = pd.id' +
+            ' LEFT JOIN wf_process_task_actor pta ON t.id = pta.process_task_id' +
+            (done ? ' WHERE t.task_state <> 10 AND t.operator = ?' : ' WHERE t.task_state = 10 AND pta.actor_id = ?') + cond.sql;
+        const conn = await this.c();
+        try {
+            const countRow = await conn.fetchOne(this.sql('SELECT COUNT(DISTINCT t.id) ' + where), [filter, ...cond.params]);
+            const total = Number(Object.values(countRow)[0] ?? 0);
+            const cols = 'DISTINCT t.id, t.process_instance_id, t.task_name, t.display_name, t.task_type, t.perform_type,' +
+                ' t.task_state, t.operator, t.finish_time, t.expire_time, t.form_key, t.task_parent_id, t.variable,' +
+                ' t.create_time, t.create_user, t.update_time, t.update_user,' +
+                ' pd.name, pd.display_name, pd.version AS process_define_version,' +
+                ' pi.variable AS instance_variable, pi.create_time AS instance_create_time';
+            const rows = await conn.fetchAll(this.sql(`SELECT ${cols}${where} ORDER BY t.id DESC LIMIT ? OFFSET ?`), [filter, ...cond.params, pageSize, (pageNum - 1) * pageSize]);
+            return { rows: rows.map(r => this.mapTaskRow(r)), total };
+        }
+        finally {
+            await this.done(conn);
+        }
+    }
+    mapInstanceRow(r) {
+        let variables = {};
+        if (r.variable) {
+            try {
+                variables = JSON.parse(r.variable);
+            }
+            catch { /* 忽略坏 JSON */ }
+        }
+        return {
+            id: Number(r.id), parentId: r.parent_id != null ? Number(r.parent_id) : undefined,
+            defineId: Number(r.process_define_id), state: r.state,
+            parentNodeName: r.parent_node_name ?? '', businessNo: r.business_no ?? '', operator: r.operator ?? '',
+            expireTime: r.expire_time ?? undefined, variables,
+            createTime: r.create_time, createUser: r.create_user ?? '',
+            updateTime: r.update_time, updateUser: r.update_user ?? '',
+            defineName: r.name ?? '', defineDisplayName: r.display_name ?? '',
+            defineVersion: Number(r.version ?? 0),
+        };
+    }
+    // ═══ m_ 条件 WHERE 构建（issues/05-5，白名单 + 参数化，对齐 Java buildWhere） ═══
+    buildWhere(conditions, whitelist) {
+        let sql = '';
+        const params = [];
+        for (const c of conditions) {
+            if (!whitelist.has(c.column))
+                continue; // 不在白名单，丢弃
+            const val = c.value;
+            if (val == null || val === '')
+                continue;
+            switch (c.operator.toUpperCase()) {
+                case 'EQ':
+                    sql += ` AND ${c.column} = ?`;
+                    params.push(val);
+                    break;
+                case 'NE':
+                    sql += ` AND ${c.column} <> ?`;
+                    params.push(val);
+                    break;
+                case 'LIKE':
+                    sql += ` AND ${c.column} LIKE ?`;
+                    params.push(`%${val}%`);
+                    break;
+                case 'LLIKE':
+                    sql += ` AND ${c.column} LIKE ?`;
+                    params.push(`%${val}`);
+                    break;
+                case 'RLIKE':
+                    sql += ` AND ${c.column} LIKE ?`;
+                    params.push(`${val}%`);
+                    break;
+                case 'GT':
+                    sql += ` AND ${c.column} > ?`;
+                    params.push(val);
+                    break;
+                case 'GE':
+                    sql += ` AND ${c.column} >= ?`;
+                    params.push(val);
+                    break;
+                case 'LT':
+                    sql += ` AND ${c.column} < ?`;
+                    params.push(val);
+                    break;
+                case 'LE':
+                    sql += ` AND ${c.column} <= ?`;
+                    params.push(val);
+                    break;
+                case 'IN':
+                case 'NIN': {
+                    if (Array.isArray(val) && val.length > 0) {
+                        const marks = val.map(() => '?').join(',');
+                        sql += ` AND ${c.column} ${c.operator.toUpperCase() === 'IN' ? 'IN' : 'NOT IN'} (${marks})`;
+                        params.push(...val);
+                    }
+                    break;
+                }
+            }
+        }
+        return { sql, params };
+    }
+    mapTaskRow(r) {
+        let variables = {};
+        if (r.variable) {
+            try {
+                variables = JSON.parse(r.variable);
+            }
+            catch { /* 忽略坏 JSON */ }
+        }
+        return {
+            id: Number(r.id), processInstanceId: Number(r.process_instance_id), taskName: r.task_name,
+            displayName: r.display_name, taskType: Number(r.task_type), performType: Number(r.perform_type),
+            taskState: r.task_state, operator: r.operator ?? '', finishTime: r.finish_time ?? undefined,
+            expireTime: r.expire_time ?? undefined, formKey: r.form_key ?? '',
+            taskParentId: r.task_parent_id != null ? Number(r.task_parent_id) : undefined,
+            variables, createTime: r.create_time, createUser: r.create_user ?? '',
+            updateTime: r.update_time, updateUser: r.update_user ?? '',
+            processDefineName: r.name ?? '', processDefineDisplayName: r.display_name ?? '',
+            defineVersion: Number(r.process_define_version ?? 0),
+            instanceVariable: r.instance_variable ?? '', instanceCreateTime: r.instance_create_time,
+        };
+    }
     // pageCcInstances 我的抄送分页（v1.3.0）：cc 表 join 实例 + 定义，按抄送人过滤（对齐 Java pageCcInstances）
-    async pageCcInstances(pageNum, pageSize, actorId) {
+    async pageCcInstances(pageNum, pageSize, actorId, conditions) {
+        const cond = this.buildWhere(conditions ?? [], CC_WHITELIST);
         const where = ' FROM wf_process_instance t' +
             ' LEFT JOIN wf_process_define pd ON t.process_define_id = pd.id' +
             ' LEFT JOIN wf_process_cc_instance cc ON t.id = cc.process_instance_id' +
-            ' WHERE cc.actor_id = ?';
+            ' WHERE cc.actor_id = ?' + cond.sql;
         const cols = 't.id, t.parent_id, t.process_define_id, t.state, t.parent_node_name, t.business_no,' +
             ' t.operator, t.expire_time, t.variable, t.create_time, t.create_user, t.update_time, t.update_user,' +
             ' pd.name, pd.display_name, pd.version';
         const conn = await this.c();
         try {
-            const countRow = await conn.fetchOne(this.sql('SELECT COUNT(*) ' + where), [actorId]);
+            const countRow = await conn.fetchOne(this.sql('SELECT COUNT(*) ' + where), [actorId, ...cond.params]);
             const total = Number(Object.values(countRow)[0] ?? 0);
-            const rows = await conn.fetchAll(this.sql(`SELECT ${cols}${where} ORDER BY t.id ASC LIMIT ? OFFSET ?`), [actorId, pageSize, (pageNum - 1) * pageSize]);
+            const rows = await conn.fetchAll(this.sql(`SELECT ${cols}${where} ORDER BY t.id ASC LIMIT ? OFFSET ?`), [actorId, ...cond.params, pageSize, (pageNum - 1) * pageSize]);
             return {
                 rows: rows.map(r => this.mapCcRow(r)),
                 total,

package/dist/memory-ext.d.ts

@@ -1,5 +1,5 @@
 import { ProcessDesign, ProcessDesignHis, ProcessSurrogate } from './model.js';
-import type { ProcessExtRepository } from './spi.js';
+import type { ProcessExtRepository, QueryCondition } from './spi.js';
 export declare class MemoryExtRepository implements ProcessExtRepository {
     private designs;
     private designHis;
@@ -9,13 +9,13 @@ export declare class MemoryExtRepository implements ProcessExtRepository {
     saveDesign(d: ProcessDesign): Promise<void>;
     updateDesign(d: ProcessDesign): Promise<void>;
     removeDesign(id: number): Promise<void>;
-    pageDesigns(_pageNum?: number, _pageSize?: number, _filters?: Record<string, any>): Promise<[ProcessDesign[], number]>;
+    pageDesigns(_pageNum?: number, _pageSize?: number, _filters?: Record<string, any>, conditions?: QueryCondition[]): Promise<[ProcessDesign[], number]>;
     saveDesignHis(his: ProcessDesignHis): Promise<void>;
     listDesignHis(designId: number): Promise<ProcessDesignHis[]>;
     findSurrogateById(id: number): Promise<ProcessSurrogate | null>;
     saveSurrogate(s: ProcessSurrogate): Promise<void>;
     updateSurrogate(s: ProcessSurrogate): Promise<void>;
     removeSurrogate(id: number): Promise<void>;
-    pageSurrogates(_pageNum?: number, _pageSize?: number, _filters?: Record<string, any>): Promise<[ProcessSurrogate[], number]>;
+    pageSurrogates(_pageNum?: number, _pageSize?: number, filters?: Record<string, any>, conditions?: QueryCondition[]): Promise<[ProcessSurrogate[], number]>;
     getSurrogate(operator: string, processName: string, at?: Date): Promise<ProcessSurrogate | null>;
 }

package/dist/memory-ext.js

@@ -1,4 +1,24 @@
 // 扩展仓储内存实现（v1.1.0，测试/演示用）
+import { matchConditions } from './memory.js';
+// ═══ 条件匹配基建（issues/05-5） ═══
+const DESIGN_FIELDS = {
+    't.id': 'id', 't.name': 'name', 't.display_name': 'displayName', 't.type': 'type',
+    't.is_deployed': 'isDeployed', 't.remark': 'remark',
+    't.create_time': 'createTime', 't.update_time': 'updateTime',
+};
+const SURROGATE_FIELDS = {
+    't.id': 'id', 't.process_name': 'processName', 't.operator': 'operator',
+    't.surrogate': 'surrogate', 't.enabled': 'enabled',
+    't.start_time': 'startTime', 't.end_time': 'endTime',
+    't.create_time': 'createTime', 't.update_time': 'updateTime',
+};
+function pickFields(row, map) {
+    const fields = {};
+    for (const [col, key] of Object.entries(map)) {
+        fields[col] = row[key];
+    }
+    return fields;
+}
 export class MemoryExtRepository {
     designs = new Map();
     designHis = new Map();
@@ -24,8 +44,9 @@ export class MemoryExtRepository {
         this.designs.delete(id);
         this.designHis.delete(id);
     }
-    async pageDesigns(_pageNum = 1, _pageSize = 10, _filters) {
-        return [[...this.designs.values()], this.designs.size];
+    async pageDesigns(_pageNum = 1, _pageSize = 10, _filters, conditions) {
+        const rows = [...this.designs.values()].filter(d => matchConditions(conditions, pickFields(d, DESIGN_FIELDS)));
+        return [rows, rows.length];
     }
     // ── 设计历史 ──
     async saveDesignHis(his) {
@@ -61,8 +82,18 @@ export class MemoryExtRepository {
     async removeSurrogate(id) {
         this.surrogates.delete(id);
     }
-    async pageSurrogates(_pageNum = 1, _pageSize = 10, _filters) {
-        return [[...this.surrogates.values()], this.surrogates.size];
+    async pageSurrogates(_pageNum = 1, _pageSize = 10, filters, conditions) {
+        const rows = [...this.surrogates.values()].filter(s => {
+            for (const [col, val] of Object.entries(filters ?? {})) {
+                if (val == null || val === '')
+                    continue;
+                const k = col === 'process_name' ? 'processName' : col;
+                if (String(s[k]) !== String(val))
+                    return false;
+            }
+            return matchConditions(conditions, pickFields(s, SURROGATE_FIELDS));
+        });
+        return [rows, rows.length];
     }
     async getSurrogate(operator, processName, at = new Date()) {
         let fallback = null;

package/dist/memory.d.ts

@@ -1,6 +1,10 @@
-import type { CcInstanceRow, ProcessDefine } from './model.js';
+import type { CcInstanceRow, DefineRow, InstanceRow, TaskRow, ProcessDefine } from './model.js';
 import { type ProcessInstance, type ProcessTask } from './model.js';
-import type { ProcessRepository } from './spi.js';
+import type { ProcessRepository, QueryCondition } from './spi.js';
+/** 条件全匹配（操作符对齐 JDBC buildWhere；列不在字段中则跳过） */
+export declare function matchConditions(conditions: QueryCondition[] | undefined, fields: Record<string, any>): boolean;
+/** EQ：值或集合包含判断（pta.actor_id/cc.actor_id 为数组） */
+export declare function eqValue(v: any, expect: any): boolean;
 export declare class MemoryRepository implements ProcessRepository {
     private defines;
     private instances;
@@ -29,7 +33,24 @@ export declare class MemoryRepository implements ProcessRepository {
     removeTaskActor(taskId: number, actors: string[]): Promise<void>;
     createCcInstance(instanceId: number, _creator: string, ...actorIds: string[]): Promise<void>;
     updateCcStatus(_instanceId: number, _actorId: string): Promise<void>;
-    pageCcInstances(pageNum: number | undefined, pageSize: number | undefined, actorId: string): Promise<{
+    pageDefines(pageNum?: number, pageSize?: number, conditions?: QueryCondition[]): Promise<{
+        rows: DefineRow[];
+        total: number;
+    }>;
+    pageInstances(pageNum: number | undefined, pageSize: number | undefined, operator: string, conditions?: QueryCondition[]): Promise<{
+        rows: InstanceRow[];
+        total: number;
+    }>;
+    pageTodoTasks(pageNum: number | undefined, pageSize: number | undefined, actorId: string, conditions?: QueryCondition[]): Promise<{
+        rows: TaskRow[];
+        total: number;
+    }>;
+    pageDoneTasks(pageNum: number | undefined, pageSize: number | undefined, operator: string, conditions?: QueryCondition[]): Promise<{
+        rows: TaskRow[];
+        total: number;
+    }>;
+    private taskRow;
+    pageCcInstances(pageNum: number | undefined, pageSize: number | undefined, actorId: string, conditions?: QueryCondition[]): Promise<{
         rows: CcInstanceRow[];
         total: number;
     }>;

package/dist/memory.js

@@ -1,4 +1,97 @@
+import { TaskState } from './model.js';
 import { cloneInstance, cloneTask } from './model.js';
+// ═══ 条件匹配基建（issues/05-5，对齐 JDBC 白名单语义） ═══
+// 行字段映射（列名 → 行属性，白名单列均可匹配）
+const TASK_FIELDS = {
+    't.id': 'id', 't.task_name': 'taskName', 't.display_name': 'displayName',
+    't.task_type': 'taskType', 't.perform_type': 'performType', 't.task_state': 'taskState',
+    't.operator': 'operator', 't.form_key': 'formKey', 't.create_time': 'createTime',
+    't.finish_time': 'finishTime', 't.expire_time': 'expireTime',
+    't.process_instance_id': 'processInstanceId', 't.task_parent_id': 'taskParentId',
+    'pd.name': 'processDefineName', 'pd.display_name': 'processDefineDisplayName',
+    'pd.version': 'defineVersion',
+};
+const INSTANCE_FIELDS = {
+    't.id': 'id', 't.parent_id': 'parentId', 't.process_define_id': 'defineId',
+    't.state': 'state', 't.parent_node_name': 'parentNodeName', 't.business_no': 'businessNo',
+    't.operator': 'operator', 't.expire_time': 'expireTime', 't.create_time': 'createTime',
+    'pd.name': 'defineName', 'pd.display_name': 'defineDisplayName', 'pd.version': 'defineVersion',
+};
+const DEFINE_FIELDS = {
+    't.id': 'id', 't.name': 'name', 't.display_name': 'displayName', 't.type': 'type',
+    't.state': 'state', 't.version': 'version', 't.create_time': 'createTime',
+    't.update_time': 'updateTime',
+};
+/** 行字段提取（列名 → 值） */
+function pickFields(row, map) {
+    const fields = {};
+    for (const [col, key] of Object.entries(map)) {
+        fields[col] = row[key];
+    }
+    return fields;
+}
+/** 条件全匹配（操作符对齐 JDBC buildWhere；列不在字段中则跳过） */
+export function matchConditions(conditions, fields) {
+    for (const c of conditions ?? []) {
+        const v = fields[c.column];
+        const expect = c.value;
+        if (v == null || expect == null)
+            continue;
+        switch (c.operator.toUpperCase()) {
+            case 'EQ':
+                if (!eqValue(v, expect))
+                    return false;
+                break;
+            case 'NE':
+                if (eqValue(v, expect))
+                    return false;
+                break;
+            case 'LIKE':
+                if (!String(v).includes(String(expect)))
+                    return false;
+                break;
+            case 'LLIKE':
+                if (!String(v).endsWith(String(expect)))
+                    return false;
+                break;
+            case 'RLIKE':
+                if (!String(v).startsWith(String(expect)))
+                    return false;
+                break;
+            case 'GT':
+                if (Number(v) <= Number(expect))
+                    return false;
+                break;
+            case 'GE':
+                if (Number(v) < Number(expect))
+                    return false;
+                break;
+            case 'LT':
+                if (Number(v) >= Number(expect))
+                    return false;
+                break;
+            case 'LE':
+                if (Number(v) > Number(expect))
+                    return false;
+                break;
+            case 'IN':
+                if (!Array.isArray(expect) || !expect.includes(v))
+                    return false;
+                break;
+            case 'NIN':
+                if (Array.isArray(expect) && expect.includes(v))
+                    return false;
+                break;
+        }
+    }
+    return true;
+}
+/** EQ：值或集合包含判断（pta.actor_id/cc.actor_id 为数组） */
+export function eqValue(v, expect) {
+    if (Array.isArray(v))
+        return v.includes(expect);
+    return String(v) === String(expect);
+}
 export class MemoryRepository {
     defines = new Map();
     instances = new Map();
@@ -162,8 +255,90 @@ export class MemoryRepository {
         this.ccInstances.set(instanceId, existing);
     }
     async updateCcStatus(_instanceId, _actorId) { }
+    // ── 核心表分页（v1.5.0）──
+    async pageDefines(pageNum = 1, pageSize = 10, conditions) {
+        const rows = [...this.defines.values()].map(d => ({
+            id: d.id, name: d.name, displayName: d.displayName, type: d.type,
+            state: d.state, version: d.version,
+            createTime: d.createTime, createUser: d.createUser,
+            updateTime: d.updateTime, updateUser: d.updateUser,
+        })).filter(r => matchConditions(conditions, pickFields(r, DEFINE_FIELDS)));
+        const total = rows.length;
+        const start = (pageNum - 1) * pageSize;
+        return { rows: rows.slice(start, start + pageSize), total };
+    }
+    async pageInstances(pageNum = 1, pageSize = 10, operator, conditions) {
+        const rows = [];
+        for (const inst of this.instances.values()) {
+            if (operator && inst.operator !== operator)
+                continue;
+            const def = this.defines.get(inst.defineId);
+            const r = {
+                id: inst.id, parentId: inst.parentId, defineId: inst.defineId, state: inst.state,
+                parentNodeName: inst.parentNodeName, businessNo: inst.businessNo, operator: inst.operator,
+                expireTime: inst.expireTime, variables: { ...inst.variables },
+                createTime: inst.createTime, createUser: inst.createUser,
+                updateTime: inst.updateTime, updateUser: inst.updateUser,
+                defineName: def?.name ?? '', defineDisplayName: def?.displayName ?? '',
+                defineVersion: def?.version ?? 0,
+            };
+            if (matchConditions(conditions, pickFields(r, INSTANCE_FIELDS)))
+                rows.push(r);
+        }
+        const total = rows.length;
+        const start = (pageNum - 1) * pageSize;
+        return { rows: rows.slice(start, start + pageSize), total };
+    }
+    async pageTodoTasks(pageNum = 1, pageSize = 10, actorId, conditions) {
+        const rows = [];
+        for (const t of this.tasks.values()) {
+            if (t.taskState !== TaskState.Doing)
+                continue;
+            if (actorId && !(this.actors.get(t.id) ?? []).includes(actorId))
+                continue;
+            const r = this.taskRow(t);
+            const fields = pickFields(r, TASK_FIELDS);
+            fields['pta.actor_id'] = this.actors.get(t.id) ?? [];
+            if (matchConditions(conditions, fields))
+                rows.push(r);
+        }
+        const total = rows.length;
+        const start = (pageNum - 1) * pageSize;
+        return { rows: rows.slice(start, start + pageSize), total };
+    }
+    async pageDoneTasks(pageNum = 1, pageSize = 10, operator, conditions) {
+        const rows = [];
+        for (const t of this.tasks.values()) {
+            if (t.taskState === TaskState.Doing)
+                continue;
+            if (operator && t.actorId !== operator)
+                continue;
+            const r = this.taskRow(t);
+            if (matchConditions(conditions, pickFields(r, TASK_FIELDS)))
+                rows.push(r);
+        }
+        const total = rows.length;
+        const start = (pageNum - 1) * pageSize;
+        return { rows: rows.slice(start, start + pageSize), total };
+    }
+    taskRow(t) {
+        const inst = this.instances.get(t.processInstanceId);
+        const def = inst ? this.defines.get(inst.defineId) : undefined;
+        return {
+            id: t.id, processInstanceId: t.processInstanceId, taskName: t.taskName,
+            displayName: t.displayName, taskType: t.taskType, performType: t.performType,
+            taskState: t.taskState, operator: t.actorId ?? '', finishTime: t.finishTime,
+            expireTime: t.expireTime, formKey: t.formKey ?? '', taskParentId: t.parentTaskId,
+            variables: { ...t.variables }, createTime: t.createTime, createUser: t.createUser,
+            updateTime: t.updateTime, updateUser: t.updateUser,
+            processDefineName: def?.name ?? '', processDefineDisplayName: def?.displayName ?? '',
+            defineVersion: def?.version ?? 0,
+            instanceVariable: inst ? JSON.stringify(inst.variables ?? {}) : '',
+            instanceCreateTime: inst?.createTime ?? t.createTime,
+        };
+    }
     // pageCcInstances 我的抄送分页（v1.3.0）：按抄送人 actorId 过滤，join 实例 + 定义
-    async pageCcInstances(pageNum = 1, pageSize = 10, actorId) {
+    async pageCcInstances(pageNum = 1, pageSize = 10, actorId, conditions) {
         const rows = [];
         for (const [instId, actors] of this.ccInstances) {
             if (actorId && !actors.includes(actorId))
@@ -172,7 +347,7 @@ export class MemoryRepository {
             if (!inst)
                 continue;
             const def = this.defines.get(inst.defineId);
-            rows.push({
+            const r = {
                 id: inst.id, parentId: inst.parentId, defineId: inst.defineId, state: inst.state,
                 parentNodeName: inst.parentNodeName, businessNo: inst.businessNo, operator: inst.operator,
                 expireTime: inst.expireTime, variables: { ...inst.variables },
@@ -180,7 +355,11 @@ export class MemoryRepository {
                 updateTime: inst.updateTime, updateUser: inst.updateUser,
                 defineName: def?.name ?? '', defineDisplayName: def?.displayName ?? '',
                 defineVersion: def?.version ?? 0,
-            });
+            };
+            const fields = pickFields(r, INSTANCE_FIELDS);
+            fields['cc.actor_id'] = actors;
+            if (matchConditions(conditions, fields))
+                rows.push(r);
         }
         const total = rows.length;
         const start = (pageNum - 1) * pageSize;

package/dist/metadata.d.ts

@@ -0,0 +1,9 @@
+/** 单个字典项 */
+export interface DictItem {
+    value: string;
+    label: string;
+}
+/** 内置枚举字典 key 清单（对齐 boot3 字典 key，存量前端零改动） */
+export declare function enumDictKeys(): string[];
+/** 按 key 取字典（[{value, label}]），未知 key 返回空列表 */
+export declare function enumDict(key: string): DictItem[];

package/dist/metadata.js

@@ -0,0 +1,41 @@
+// 引擎元数据能力（v1.4.0，issues/04）——内置状态枚举字典
+//
+// key 对齐 boot3 字典（wf_process_define_state 等），value/label 与 Java enums 完全一致，
+// 杜绝集成方重复定义导致的值漂移。
+// 内置字典表（值顺序与 Java enums 声明顺序一致）
+const DICTS = {
+    wf_process_define_state: [
+        { value: '0', label: '禁用' }, { value: '1', label: '启用' },
+    ],
+    wf_process_instance_state: [
+        { value: '10', label: '进行中' }, { value: '20', label: '已完成' }, { value: '30', label: '已撤回' },
+        { value: '40', label: '强行终止' }, { value: '45', label: '已拒绝' }, { value: '50', label: '挂起' },
+        { value: '99', label: '已废弃' },
+    ],
+    wf_process_submit_type: [
+        { value: '0', label: '发起申请' }, { value: '1', label: '同意申请' }, { value: '2', label: '拒绝申请' },
+        { value: '3', label: '退回上一步' }, { value: '4', label: '跳转' }, { value: '5', label: '重新提交' },
+        { value: '6', label: '退回发起人' }, { value: '20', label: '拒绝申请' },
+    ],
+    wf_process_task_state: [
+        { value: '10', label: '进行中' }, { value: '20', label: '已完成' }, { value: '30', label: '已撤回' },
+        { value: '40', label: '强行终止' }, { value: '50', label: '挂起' }, { value: '99', label: '已废弃' },
+    ],
+    wf_process_task_type: [
+        { value: '0', label: '主办' }, { value: '1', label: '协办' }, { value: '2', label: '记录' },
+    ],
+    wf_process_task_perform_type: [
+        { value: '0', label: '普通参与' }, { value: '1', label: '会签参与' },
+    ],
+    wf_countersign_type: [
+        { value: '0', label: '并行会签' }, { value: '1', label: '串行会签' },
+    ],
+};
+/** 内置枚举字典 key 清单（对齐 boot3 字典 key，存量前端零改动） */
+export function enumDictKeys() {
+    return Object.keys(DICTS);
+}
+/** 按 key 取字典（[{value, label}]），未知 key 返回空列表 */
+export function enumDict(key) {
+    return [...(DICTS[key] ?? [])];
+}