weaver-work-cli 0.1.22 → 0.1.24

package/dist/shortcuts/workflow/operations/flow-status.js

@@ -0,0 +1,63 @@
+/**
+ * 流程状态（`flowstatus`）系统条件。
+ *
+ * ★ `flowstatus` 是**选项类**系统条件，服务端只认 `[{term, multiContent:[<代码>]}]`
+ *   —— **不是** `[{content, term}]`。`content` 形态是给"文本类"条件（requestname /
+ *   requestmark）用的；把取值塞进 `content`，服务端会**静默忽略**该条件
+ *   ⇒ 按流程状态筛选恒不生效、退化成全量。
+ *
+ *   来源对照：V11.3 `e10_workflow.py:8519 flow_status_condition` 产出的就是
+ *   `[{"term": "in", "multiContent": [...]}]`；V12.1 移植时退化成了 `[{content, term}]`
+ *   （2026-09-28 用户实测预期结构为 `[{"term":"in","multiContent":["notFinish","finish"]}]`）。
+ *
+ * ★★ 取值口径（2026-09-28 用户裁定＝方案 C）：**只认四个选项代码，不做中文口语词识别**。
+ *   说明层（schema 描述 / 报错文案 / `workflow-query.md` 的筛选条件表）已经列出四个代码及其
+ *   含义，"用户口语 → 代码"的翻译由**模型**完成；CLI 只做代码的校验与纯归一，且：
+ *   - 出现任何一个非代码取值 ⇒ **整体报错并停止**，不静默丢弃——丢掉一个取值就少一层筛选，
+ *     等于把结果静默放大到全量，与本项目"禁止静默丢条件"的纪律相悖；
+ *   - 大小写不敏感（`Finish` → `finish`）属纯归一，不做任何语义猜测。
+ */
+/** 服务端认可的流程状态选项（唯一定义处，说明文案由它派生，避免两处口径漂移）。 */
+const FLOW_STATUS_OPTIONS = [
+    { code: 'finish', meaning: '已结束' },
+    { code: 'normalFinish', meaning: '正常结束' },
+    { code: 'forceFinish', meaning: '强制结束' },
+    { code: 'notFinish', meaning: '未结束·审批中' },
+];
+/**
+ * 模型可见的取值说明（schema 描述与报错文案共用同一份，避免两处口径漂移）。
+ *
+ * ★ **代码在前、含义在后**（`finish（已结束）`）：与本条契约"传的就是这个 key"一致，
+ *   也和 `workflow-query.md` 筛选条件表的写法逐字对齐（2026-09-28 用户要求统一）。
+ */
+export const FLOW_STATUS_HINT = `${FLOW_STATUS_OPTIONS.map((item) => `${item.code}（${item.meaning}）`).join('、')}`
+    + '；只接受上述四个代码、不接受中文，可逗号分隔多值';
+/**
+ * `--flow-status` 取值 → `formDatas.flowstatus` 条件项。
+ *
+ * 返回 `null` 仅代表**输入为空**（调用方不设该条件）。取值非法一律通过 `invalid` 上报，
+ * 由调用方报错——**绝不静默丢弃条件**（丢弃会退化成全量查询）。
+ */
+export function flowStatusCondition(value, term) {
+    const text = String(value ?? '').trim();
+    if (!text)
+        return null;
+    const byLowerCode = new Map(FLOW_STATUS_OPTIONS.map((item) => [item.code.toLowerCase(), item.code]));
+    const codes = [];
+    const invalid = [];
+    for (const partRaw of text.split(/[,，、]/u)) {
+        const part = partRaw.trim();
+        if (!part)
+            continue;
+        const code = byLowerCode.get(part.toLowerCase());
+        if (code)
+            codes.push(code);
+        else
+            invalid.push(part);
+    }
+    if (invalid.length || !codes.length) {
+        return { condition: [], invalid: invalid.length ? invalid : [text] };
+    }
+    const normalizedTerm = String(term ?? '').trim().toLowerCase() === 'notin' ? 'notin' : 'in';
+    return { condition: [{ term: normalizedTerm, multiContent: [...new Set(codes)] }], invalid: [] };
+}