weaver-work-cli 0.1.5 → 0.1.7

package/dist/shortcuts/project/operations/read.js

@@ -0,0 +1,551 @@
+import { assertDatajsonSuccess, assertWeaverSuccess, } from '../host.js';
+import { SCHEMA_FILTERS, SCHEMA_FIELDS, SCHEMA_ID_STRING, SCHEMA_PAGE_NO, SCHEMA_PAGE_SIZE, projectSuccess, schemaOf, } from './types.js';
+import { compactFilters, idString, operatorId, positiveInt, queryText, } from './shared.js';
+const APP_TAG = 'weaver-project-eb';
+const DEFAULT_OBJ_IDS = { task: '1020270486210527232', project: '1020275562853482532' };
+const MIN_VERSION = [20, 6, 11];
+function buildCardUrl(baseUrl, objId, dataId) {
+    if (!baseUrl || !objId || !dataId || /[\s/\\?#]/u.test(dataId))
+        return null;
+    return `${baseUrl.replace(/\/+$/u, '')}/sp/ebdfpage/card/0/${objId}/${dataId}`;
+}
+const CURRENT_USER_FILTERS = new Set([
+    'manager',
+    'participant',
+    'participants',
+    'tester',
+    'customer_manager',
+    'acceptance_manager',
+]);
+const SCHEMA_OUTPUT_FIELDS = {
+    type: 'array',
+    minItems: 1,
+    maxItems: 50,
+    uniqueItems: true,
+    items: { type: 'string', minLength: 1, maxLength: 100, pattern: '^[A-Za-z][A-Za-z0-9_]*' },
+    description: '可选；只保留指定 mainTable 字段。id 和记录名称字段始终保留；fields 不含 detail_url 时不会解析详情链接。',
+};
+async function resolveCurrentUserFilters(filters, host) {
+    for (const [key, value] of Object.entries(filters)) {
+        if (value === '@me' && CURRENT_USER_FILTERS.has(key)) {
+            filters[key] = await operatorId(host);
+        }
+    }
+}
+function outputFields(value) {
+    if (value === undefined)
+        return null;
+    if (!Array.isArray(value) || value.length === 0) {
+        throw new Error('fields 必须是非空字符串数组');
+    }
+    const fields = [];
+    for (const item of value) {
+        if (typeof item !== 'string' || !/^[A-Za-z]/.test(item) || /[^A-Za-z0-9_]/.test(item)) {
+            throw new Error('fields 包含非法字段名');
+        }
+        fields.push(item);
+    }
+    return [...new Set(fields)];
+}
+function compactDatajson(datajson, fields, requiredFields) {
+    if (!fields)
+        return datajson;
+    const keep = new Set([...fields, 'id', 'detail_url', ...requiredFields]);
+    const value = datajson;
+    const rows = Array.isArray(value?.datas) ? value.datas : [];
+    for (const row of rows) {
+        const mainTable = row?.mainTable;
+        if (!mainTable || typeof mainTable !== 'object' || Array.isArray(mainTable))
+            continue;
+        row.mainTable = Object.fromEntries(Object.entries(mainTable).filter(([key]) => keep.has(key)));
+    }
+    return datajson;
+}
+function normalizeFieldNames(value, inputName) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value) || value.length === 0) {
+        throw new Error(`${inputName} 必须是非空字符串数组`);
+    }
+    const names = [];
+    for (const item of value) {
+        if (typeof item !== 'string' || item.trim() === '' || item.length > 100) {
+            throw new Error(`${inputName} 包含非法字段名`);
+        }
+        names.push(item);
+    }
+    return [...new Set(names)];
+}
+function filterFormFieldResponse(response, fieldNames, fieldKeyword) {
+    if (fieldNames.length === 0 && !fieldKeyword)
+        return response;
+    if (!response || typeof response !== 'object')
+        return response;
+    const groups = response?.data?.data;
+    if (!Array.isArray(groups))
+        return response;
+    const keyword = fieldKeyword?.toLowerCase() ?? null;
+    const nextGroups = groups.map((group) => {
+        if (!group || typeof group !== 'object' || !Array.isArray(group.fields))
+            return group;
+        return {
+            ...group,
+            fields: group.fields.filter((field) => {
+                if (!field || typeof field !== 'object')
+                    return false;
+                const name = typeof field.name === 'string' ? field.name : '';
+                const text = typeof field.text === 'string' ? field.text : '';
+                if (fieldNames.length > 0)
+                    return fieldNames.includes(name);
+                return keyword ? name.toLowerCase().includes(keyword) || text.toLowerCase().includes(keyword) : true;
+            }),
+        };
+    });
+    return { ...response, data: { ...response.data, data: nextGroups } };
+}
+function operationTable(name) {
+    return name === 'project.project.list' || name === 'project.project.detail' ? 'project' : 'task';
+}
+async function decorateDetailUrls(host, operation, datajson) {
+    const value = datajson;
+    const rows = Array.isArray(value?.datas) ? value.datas : [];
+    const targets = rows.map((row) => row?.mainTable).filter((row) => row?.id !== undefined && row?.id !== null);
+    if (targets.length === 0)
+        return datajson;
+    try {
+        const objId = await getObject(host, operationTable(operation));
+        const session = await host.getSession();
+        for (const row of targets) {
+            const url = buildCardUrl(session.baseUrl, objId, String(row.id));
+            if (url)
+                row.detail_url = url;
+        }
+    }
+    catch (error) {
+        if (value && typeof value === 'object') {
+            value.detail_url_warning = `详情链接暂不可用：${error instanceof Error ? error.message : String(error)}；主查询已成功，不要因此重试。`;
+        }
+    }
+    return datajson;
+}
+function table(value) {
+    if (value !== 'task' && value !== 'project') {
+        throw new Error('table must be task or project');
+    }
+    return value;
+}
+function versionAtLeast(version) {
+    const parts = version.split('.').map((item) => Number(item) || 0);
+    for (let index = 0; index < Math.max(parts.length, MIN_VERSION.length); index += 1) {
+        const left = parts[index] ?? 0;
+        const right = MIN_VERSION[index] ?? 0;
+        if (left > right)
+            return true;
+        if (left < right)
+            return false;
+    }
+    return true;
+}
+async function getAppId(host) {
+    const response = await host.request({
+        method: 'GET',
+        path: '/api/bs/ebuilder/app/tags/getAppIds',
+        query: { tag: APP_TAG },
+        operation: 'project.app.ids',
+    });
+    assertWeaverSuccess(response, 'project.app.ids');
+    const data = response?.data;
+    const appId = Array.isArray(data) && data.length > 0 ? String(data[0]) : '';
+    if (!appId)
+        throw new Error('当前环境未安装事井然项目管理应用');
+    return appId;
+}
+async function getObject(host, value) {
+    const response = await host.request({
+        method: 'GET',
+        path: '/api/ebproject/backendConsole/getCurrentObjId',
+        query: { objId: DEFAULT_OBJ_IDS[value] },
+        operation: 'project.object.id',
+    });
+    assertWeaverSuccess(response, 'project.object.id');
+    const object = String(response?.data ?? '');
+    if (!object)
+        throw new Error('接口未返回当前环境对象 ID');
+    return object;
+}
+async function datajsonRequest(host, operation, path, payload, query) {
+    const response = await host.request({
+        method: 'POST',
+        path,
+        query,
+        body: { datajson: JSON.stringify(payload) },
+        operation,
+    });
+    assertDatajsonSuccess(response, operation);
+    return response;
+}
+function listOperation(name, path, nameField, descField, statusField) {
+    return {
+        name,
+        resource: 'project',
+        method: 'list',
+        action: name,
+        summary: '分页查询项目/任务列表，默认第 1 页 10 条，未指定状态时仅查询未开始和进行中',
+        risk: 'read',
+        inputSchema: schemaOf({
+            filters: SCHEMA_FILTERS,
+            pageNo: SCHEMA_PAGE_NO,
+            pageSize: SCHEMA_PAGE_SIZE,
+            name: { type: 'string', description: `${nameField} 模糊搜索，通过 URL Query 传递` },
+            description: { type: 'string', description: `${descField} 模糊搜索，通过 URL Query 传递` },
+            allStatuses: { type: 'boolean', default: false, description: '为 true 时不传系统状态和业务状态，查询全部状态；不能与业务状态同时传' },
+            withDetailUrl: { type: 'boolean', default: true, description: '是否为每条记录补充 detail_url；传 false 可跳过链接解析' },
+            fields: SCHEMA_OUTPUT_FIELDS,
+        }),
+        handler: async (args, { host }) => {
+            const pageNo = positiveInt(args.pageNo, 'pageNo', 1);
+            const pageSize = positiveInt(args.pageSize, 'pageSize', 10);
+            const filters = compactFilters(args.filters);
+            await resolveCurrentUserFilters(filters, host);
+            const allStatuses = args.allStatuses === true;
+            if (allStatuses && (filters.sys_status !== undefined || filters[statusField] !== undefined)) {
+                throw new Error("allStatuses 不能与 sys_status 或业务状态同时传");
+            }
+            if (allStatuses) {
+                delete filters.sys_status;
+            }
+            else if (filters[statusField] === undefined && filters.sys_status === undefined) {
+                filters.sys_status = 'todo,doing';
+            }
+            else if (filters[statusField] !== undefined) {
+                delete filters.sys_status;
+            }
+            const response = await datajsonRequest(host, name, path, {
+                mainTable: filters,
+                pageInfo: { pageNo, pageSize },
+                header: { operator: await operatorId(host) },
+            }, {
+                [nameField]: queryText(args.name, 'name'),
+                [descField]: queryText(args.description, 'description'),
+            });
+            const fields = outputFields(args.fields);
+            const shouldDecorate = args.withDetailUrl !== false && (!fields || fields.includes('detail_url'));
+            const decorated = shouldDecorate
+                ? await decorateDetailUrls(host, name, response?.datajson ?? null)
+                : response?.datajson ?? null;
+            const datajson = compactDatajson(decorated, fields, [nameField]);
+            return projectSuccess(name, datajson, { pageNo, pageSize });
+        },
+    };
+}
+function detailOperation(name, path, nameField) {
+    return {
+        name,
+        resource: 'project',
+        method: 'detail',
+        action: name,
+        summary: '按主键查询单条项目/任务详情',
+        risk: 'read',
+        inputSchema: schemaOf({
+            id: SCHEMA_ID_STRING,
+            withDetailUrl: { type: 'boolean', default: true, description: '是否为记录补充 detail_url；传 false 可跳过链接解析' },
+            fields: SCHEMA_OUTPUT_FIELDS,
+        }, { required: ['id'] }),
+        handler: async (args, { host }) => {
+            const id = idString(args.id, 'id');
+            const response = await datajsonRequest(host, name, path, {
+                mainTable: { id },
+                header: { operator: await operatorId(host) },
+            });
+            const fields = outputFields(args.fields);
+            const shouldDecorate = args.withDetailUrl !== false && (!fields || fields.includes('detail_url'));
+            const decorated = shouldDecorate
+                ? await decorateDetailUrls(host, name, response?.datajson ?? null)
+                : response?.datajson ?? null;
+            const datajson = compactDatajson(decorated, fields, [nameField]);
+            return projectSuccess(name, datajson, { id });
+        },
+    };
+}
+function dictionaryOperation(name, path, summary) {
+    return {
+        name,
+        resource: 'project',
+        method: 'dictionary',
+        action: name,
+        summary,
+        risk: 'read',
+        inputSchema: schemaOf({
+            filters: SCHEMA_FILTERS,
+            pageNo: { ...SCHEMA_PAGE_NO, default: 1 },
+            pageSize: { ...SCHEMA_PAGE_SIZE, default: 100 },
+            fields: SCHEMA_OUTPUT_FIELDS,
+        }),
+        handler: async (args, { host }) => {
+            const pageNo = positiveInt(args.pageNo, 'pageNo', 1);
+            const pageSize = positiveInt(args.pageSize, 'pageSize', 100);
+            const response = await datajsonRequest(host, name, path, {
+                mainTable: compactFilters(args.filters),
+                pageInfo: { pageNo, pageSize },
+                header: { operator: await operatorId(host) },
+            });
+            const datajson = compactDatajson(response?.datajson ?? null, outputFields(args.fields), []);
+            return projectSuccess(name, datajson, { pageNo, pageSize });
+        },
+    };
+}
+function hrmOperation(name, path, kind, summary) {
+    return {
+        name,
+        resource: 'project',
+        method: 'resolve',
+        action: name,
+        summary,
+        risk: 'read',
+        inputSchema: schemaOf({
+            name: { type: 'string', minLength: 1 },
+            match: { type: 'string', enum: ['exact', 'fuzzy'], default: 'exact' },
+            ...(kind === 'employee' ? { status: { type: 'string', enum: ['normal', 'all'], default: 'normal' } } : {}),
+        }, { required: ['name'] }),
+        handler: async (args, { host }) => {
+            const body = kind === 'employee'
+                ? {
+                    browserMultiple: true,
+                    authWecahtBook: false,
+                    wxDepNeedConvertCount: 0,
+                    wxEmpNeedConvertCount: 0,
+                    wxTotalNeedConvertCount: 0,
+                    cmd: 'all',
+                    current: 1,
+                    pageSize: 30,
+                    formDatas: {
+                        username: [{ usernameOpt: args.match === 'fuzzy' ? 'in' : 'eq', usernameInput: args.name }],
+                        status: [{ statusSelect: args.status === 'all' ? [] : ['normal'] }],
+                    },
+                    quickSearchDatas: {},
+                    type: 'and',
+                    containsNoneAccount: false,
+                    containsPartTimeEmployee: false,
+                }
+                : {
+                    browserMultiple: true,
+                    virtualType: 'ALL',
+                    cmd: 'list',
+                    current: 1,
+                    pageSize: 200,
+                    formDatas: {
+                        name: [{
+                                nameCondition: { id: args.match === 'fuzzy' ? 'in' : 'eq', content: '等于', disabled: false },
+                                name: args.name,
+                            }],
+                    },
+                    quickSearchDatas: {},
+                    type: 'and',
+                    stopDepartment: false,
+                };
+            const response = await host.request({ method: 'POST', path, body, operation: name });
+            assertWeaverSuccess(response, name);
+            const data = response?.data;
+            const rows = Array.isArray(data?.data) ? data.data : [];
+            return projectSuccess(name, {
+                total: typeof data?.total === 'number' ? data.total : rows.length,
+                rows: rows.map((row) => ({
+                    id: row?.id === undefined || row?.id === null ? null : String(row.id),
+                    name: row?.name ?? row?.title ?? null,
+                    department: row?.department ?? row?.supDepartment ?? row?.supSubDepartment ?? null,
+                    title: row?.title ?? null,
+                })),
+            });
+        },
+    };
+}
+export const projectReadOperations = [
+    {
+        name: 'project.app.ids',
+        resource: 'project',
+        method: 'metadata',
+        action: 'project.app.ids',
+        summary: '按固定应用标签获取当前环境的事井然应用 ID',
+        risk: 'read',
+        inputSchema: schemaOf({}),
+        handler: async (_args, { host }) => projectSuccess('project.app.ids', {
+            appId: await getAppId(host),
+        }),
+    },
+    {
+        name: 'project.object.id',
+        resource: 'project',
+        method: 'metadata',
+        action: 'project.object.id',
+        summary: '将任务/项目出厂锚点转换成当前环境对象 ID',
+        risk: 'read',
+        inputSchema: schemaOf({ table: { type: 'string', enum: ['task', 'project'] } }, { required: ['table'] }),
+        handler: async (args, { host }) => {
+            const value = table(args.table);
+            return projectSuccess('project.object.id', { table: value, objId: await getObject(host, value) });
+        },
+    },
+    {
+        name: 'project.form.fields',
+        resource: 'project',
+        method: 'metadata',
+        action: 'project.form.fields',
+        summary: '获取任务/项目表单字段定义；未传 groupId/sourceId 时自动解析',
+        risk: 'read',
+        inputSchema: schemaOf({
+            table: { type: 'string', enum: ['task', 'project'] },
+            groupId: { type: 'string', description: '可选；缺省时自动调用 project.app.ids' },
+            sourceId: { type: 'string', description: '可选；缺省时按 table 自动解析当前环境 objId' },
+            detailFieldsGroup: { type: 'boolean', default: true },
+            enableMerge: { type: 'boolean', default: true },
+            fieldNames: {
+                type: 'array',
+                minItems: 1,
+                maxItems: 50,
+                uniqueItems: true,
+                items: { type: 'string', minLength: 1, maxLength: 100 },
+                description: '可选；只返回指定 name 的字段定义。与 fieldKeyword 同时传时 fieldNames 优先。',
+            },
+            fieldKeyword: {
+                type: 'string',
+                minLength: 1,
+                maxLength: 100,
+                description: '可选；按字段 name/text 模糊过滤字段定义，用于把中文字段名解析成 field name。',
+            },
+        }, { required: ['table'] }),
+        handler: async (args, { host }) => {
+            const value = table(args.table);
+            const groupId = args.groupId ? String(args.groupId) : await getAppId(host);
+            const sourceId = args.sourceId ? String(args.sourceId) : await getObject(host, value);
+            const response = await host.request({
+                method: 'POST',
+                path: '/api/ebuilder/common/ds/fields',
+                formData: {
+                    groupId,
+                    sourceId,
+                    sourceType: 'FORM',
+                    detailFieldsGroup: args.detailFieldsGroup === false ? 'false' : 'true',
+                    enableMerge: args.enableMerge === false ? 'false' : 'true',
+                    customParam: JSON.stringify({ terminal: '' }),
+                    params: '[]',
+                },
+                operation: 'project.form.fields',
+            });
+            assertWeaverSuccess(response, 'project.form.fields');
+            const data = filterFormFieldResponse(response, normalizeFieldNames(args.fieldNames, 'fieldNames'), args.fieldKeyword === undefined || args.fieldKeyword === null || args.fieldKeyword === ''
+                ? null
+                : String(args.fieldKeyword));
+            return projectSuccess('project.form.fields', data, { table: value, groupId, sourceId });
+        },
+    },
+    {
+        name: 'project.form.options',
+        resource: 'project',
+        method: 'metadata',
+        action: 'project.form.options',
+        summary: '获取选择类字段选项；未传 groupId/sourceId 时自动解析',
+        risk: 'read',
+        inputSchema: schemaOf({
+            table: { type: 'string', enum: ['task', 'project'] },
+            fieldName: { type: 'string', minLength: 1 },
+            groupId: { type: 'string' },
+            sourceId: { type: 'string' },
+            optionLevel: { type: 'integer', minimum: 1, default: 1 },
+        }, { required: ['table', 'fieldName'] }),
+        handler: async (args, { host }) => {
+            const value = table(args.table);
+            const groupId = args.groupId ? String(args.groupId) : await getAppId(host);
+            const sourceId = args.sourceId ? String(args.sourceId) : await getObject(host, value);
+            const response = await host.request({
+                method: 'GET',
+                path: '/api/ebuilder/common/ds/options',
+                query: {
+                    fieldName: args.fieldName,
+                    objId: sourceId,
+                    sourceType: 'FORM',
+                    groupId,
+                    optionLevel: args.optionLevel ?? 1,
+                },
+                operation: 'project.form.options',
+            });
+            assertWeaverSuccess(response, 'project.form.options');
+            return projectSuccess('project.form.options', response, { table: value, groupId, sourceId });
+        },
+    },
+    {
+        name: 'project.form.data.page',
+        resource: 'project',
+        method: 'metadata',
+        action: 'project.form.data.page',
+        summary: '在关联表单中按标题字段分页查询记录，用于 Ebuilder 名称到 ID 解析',
+        risk: 'read',
+        inputSchema: schemaOf({
+            refObjId: SCHEMA_ID_STRING,
+            fieldKey: { type: 'string', minLength: 1 },
+            value: { type: 'string', minLength: 1 },
+            pageNo: SCHEMA_PAGE_NO,
+            pageSize: SCHEMA_PAGE_SIZE,
+        }, { required: ['refObjId', 'fieldKey', 'value'] }),
+        handler: async (args, { host }) => {
+            const pageNo = positiveInt(args.pageNo, 'pageNo', 1);
+            const pageSize = positiveInt(args.pageSize, 'pageSize', 10);
+            const response = await host.request({
+                method: 'POST',
+                path: '/api/ebuilder/form/dataset/v2/getAllData',
+                body: {
+                    datajson: {
+                        header: { objId: idString(args.refObjId, 'refObjId') },
+                        mainTable: { [String(args.fieldKey)]: args.value },
+                        pageInfo: { pageNo, pageSize },
+                        operationinfo: { isReturnDetail: 'n', fieldNoFindIgnore: 'false' },
+                    },
+                },
+                operation: 'project.form.data.page',
+            });
+            assertDatajsonSuccess(response?.data, 'project.form.data.page');
+            return projectSuccess('project.form.data.page', response?.data?.datajson ?? null, { pageNo, pageSize });
+        },
+    },
+    {
+        name: 'project.version.check',
+        resource: 'project',
+        method: 'diagnose',
+        action: 'project.version.check',
+        summary: '查询事井然应用版本并判断是否满足 20.6.11；仅用于异常诊断或用户主动询问',
+        risk: 'read',
+        inputSchema: schemaOf({ appId: { type: 'string', description: '可选；缺省时自动解析' } }),
+        handler: async (args, { host }) => {
+            const appId = args.appId ? String(args.appId) : await getAppId(host);
+            const response = await host.request({
+                method: 'GET',
+                path: '/api/installer/public/querySpAppVersionInfo',
+                query: { appId },
+                operation: 'project.version.check',
+            });
+            assertWeaverSuccess(response, 'project.version.check');
+            const version = String(response?.data?.commitVersion ?? '');
+            if (!version)
+                throw new Error('接口未返回应用版本');
+            return projectSuccess('project.version.check', {
+                appId,
+                version,
+                minimumVersion: MIN_VERSION.join('.'),
+                supported: versionAtLeast(version),
+            });
+        },
+    },
+    listOperation('project.task.list', '/api/ebuilder/form/formdata/v2/getFormDataList/queryTasks', 'task_name', 'task_desc', 'task_status'),
+    detailOperation('project.task.detail', '/api/ebuilder/form/formdata/v2/getFormDataByPk/queryTaskDetail', 'task_name'),
+    listOperation('project.project.list', '/api/ebuilder/form/formdata/v2/getFormDataList/queryProjects', 'proj_name', 'proj_desc', 'proj_status'),
+    detailOperation('project.project.detail', '/api/ebuilder/form/formdata/v2/getFormDataByPk/queryProjDetail', 'proj_name'),
+    dictionaryOperation('project.dictionary.task-type', '/api/ebuilder/form/formdata/v2/getFormDataList/queryTaskTypes', '查询任务类型'),
+    dictionaryOperation('project.dictionary.task-priority', '/api/ebuilder/form/formdata/v2/getFormDataList/queryTaskPriorities', '查询任务紧急程度'),
+    dictionaryOperation('project.dictionary.task-status', '/api/ebuilder/form/formdata/v2/getFormDataList/queryTaskStatus', '查询任务状态'),
+    dictionaryOperation('project.dictionary.project-type', '/api/ebuilder/form/formdata/v2/getFormDataList/queryProjTypes', '查询项目类型'),
+    dictionaryOperation('project.dictionary.project-priority', '/api/ebuilder/form/formdata/v2/getFormDataList/queryProjPriorities', '查询项目紧急程度'),
+    dictionaryOperation('project.dictionary.project-status', '/api/ebuilder/form/formdata/v2/getFormDataList/queryProjStatus', '查询项目状态'),
+    hrmOperation('project.employee.resolve', '/api/hrm/common/browser/data/resource', 'employee', '按姓名精确或模糊解析员工 ID，默认仅查在职员工'),
+    hrmOperation('project.department.resolve', '/api/hrm/common/browser/data/department', 'organization', '按名称精确或模糊解析部门 ID'),
+    hrmOperation('project.subcompany.resolve', '/api/hrm/common/browser/data/subcompany', 'organization', '按名称精确或模糊解析分部 ID'),
+];
+export { getAppId, getObject, SCHEMA_FIELDS };

package/dist/shortcuts/project/operations/registry.js

@@ -0,0 +1,31 @@
+import { projectValidationError } from '../errors.js';
+import { projectReadOperations } from './read.js';
+import { projectWriteOperations } from './write.js';
+function buildRegistry() {
+    const registry = new Map();
+    const definitions = [
+        ...projectReadOperations,
+        ...projectWriteOperations,
+    ];
+    for (const definition of definitions) {
+        if (registry.has(definition.name)) {
+            throw new Error(`duplicate project operation: ${definition.name}`);
+        }
+        registry.set(definition.name, definition);
+    }
+    return registry;
+}
+const projectOperationRegistry = buildRegistry();
+export function projectOperationDefinitions() {
+    return [...projectOperationRegistry.values()];
+}
+export function getProjectOperation(operation) {
+    const definition = projectOperationRegistry.get(operation);
+    if (!definition) {
+        throw projectValidationError('operation_unknown', `事井然项目模块不支持操作：${operation}`);
+    }
+    return definition;
+}
+export function hasProjectOperation(operation) {
+    return projectOperationRegistry.has(operation);
+}

package/dist/shortcuts/project/operations/shared.js

@@ -0,0 +1,68 @@
+import { projectValidationError } from '../errors.js';
+export function asObject(value, field = 'input') {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw projectValidationError('field_invalid', `${field} 必须是 JSON 对象`);
+    }
+    return value;
+}
+export function assertNoForbiddenKeys(input) {
+    for (const key of Object.keys(input)) {
+        if (!/^[A-Za-z][A-Za-z0-9_]*$/.test(key)) {
+            throw projectValidationError('field_invalid', `不允许的字段名：${key}`);
+        }
+    }
+}
+export function idString(value, field) {
+    if (value === undefined || value === null || value === '') {
+        throw projectValidationError('field_required', `${field} 不能为空`);
+    }
+    const text = String(value);
+    if (!/^\d+$/.test(text))
+        throw projectValidationError('field_invalid', `${field} 必须是数字 ID 字符串`);
+    return text;
+}
+export function optionalIdString(value, field) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    return idString(value, field);
+}
+export function positiveInt(value, field, fallback, maximum = 1000) {
+    if (value === undefined || value === null || value === '')
+        return fallback;
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 1 || parsed > maximum) {
+        throw projectValidationError('field_invalid', `${field} 必须是 1-${maximum} 的整数`);
+    }
+    return parsed;
+}
+export function compactFilters(value) {
+    if (!value)
+        return {};
+    return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined && item !== null && item !== ''));
+}
+export function queryText(value, field) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    if (typeof value !== 'string')
+        throw projectValidationError('field_invalid', `${field} 必须是字符串`);
+    return value;
+}
+export async function operatorId(host) {
+    const session = await host.getSession();
+    if (!session.userId)
+        throw projectValidationError('operator_missing', '当前登录会话缺少 operator，请重新登录');
+    return session.userId;
+}
+export function stableFingerprint(value) {
+    const text = JSON.stringify(value, (_key, item) => {
+        if (item && typeof item === 'object' && !Array.isArray(item)) {
+            return Object.fromEntries(Object.entries(item).sort(([a], [b]) => a.localeCompare(b)));
+        }
+        return item;
+    });
+    let hash = 0;
+    for (let index = 0; index < text.length; index += 1) {
+        hash = (hash * 31 + text.charCodeAt(index)) >>> 0;
+    }
+    return `${text.length}:${hash.toString(16)}`;
+}