weaver-e9-assistant-cli 1.1.5 → 1.1.11

package/dist/nodemap.js

@@ -1,242 +1,232 @@
-/**
- * 流程节点名解析：nodeid → nodename。
- *
- * 背景：待办/已办/我发起列表服务端**只给当前节点的 id**——行字段 `currentnodeid` 的值形如 "2882"，
- *   且行里没有节点名（实测 `currentnodeidspan` 也只是 id 本身，整行不含 currentnodename/currentnodespan）。
- *   要显示名字只能按流程另取节点表。
- *
- * 接口（2026-10-14 实测 e9pc.e-cology.com.cn）：
- *   POST /api/workflow/test/getNodeInfo   body: { workflowId }
- *     → { nodeInfo: [{id, name, type}], wfInfo: {workflowName, version}, authority, tabInfo, ... }
- *   - 只需 workflowId；文档里的 requestid/userId/type 都非必需（逐个试过）。
- *   - ⚠️ 路径必须带 `/api` 前缀：`/workflow/test/getNodeInfo`（无前缀）返回登录页 HTML。
- *   - ⚠️ 接口挂在「流程测试」模块下，非所有部署/版本都有 → **一律 fail-soft**：
- *       拿不到就返回 null，调用方退回显示节点 id，绝不让列表整体报错。
- *   - `type`：0=发起节点 / 1=审批节点 / 3=归档节点。
- *
- * 缓存：`~/.e9/node_map_<envkey>.json`，按 workflowId 存，TTL 30 天
- *   （节点表几乎不变；响应带 version，流程改版后重新拉取自然覆盖）。
- *   - `E9_NODEMAP_CACHE_DIR` 覆盖缓存目录（测试隔离用，避免污染真实 ~/.e9）。
- *   - `E9_NO_NODE_NAME=1` 或 CLI `--no-node-name` 整体停用解析。
- */
-import { createApiFromProfile } from './client.js';
-import { endpointFor, profileNameFromBaseUrl } from './config.js';
-import { stripHtml } from './parse.js';
-import fs from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
-
-/** 节点表缓存 TTL（天）。 */
-export const NODEMAP_TTL_MS = (Number(process.env.E9_NODEMAP_TTL_DAYS ?? '30') || 30) * 24 * 3600 * 1000;
-/** 并发拉取上限（一次列表页通常 ≤10 个流程，全量拉取路径可能几十个，别一次打满）。 */
-const FETCH_CHUNK = 6;
-
-function str(v) {
-    if (v === undefined || v === null || v === '')
-        return undefined;
-    return String(v);
-}
-
-/** 缓存目录（测试可用 E9_NODEMAP_CACHE_DIR 覆盖）。 */
-export function nodeMapCacheDir() {
-    return process.env.E9_NODEMAP_CACHE_DIR || path.join(os.homedir(), '.e9');
-}
-/** 缓存文件路径：~/.e9/node_map_<envkey>.json（按环境隔离，nodeid 不跨环境通用）。 */
-export function nodeMapCachePath(cfg) {
-    const baseUrl = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
-    return path.join(nodeMapCacheDir(), `node_map_${profileNameFromBaseUrl(baseUrl)}.json`);
-}
-
-/** 是否停用节点名解析（E9_NO_NODE_NAME=1）。 */
-export function isNodeNameDisabled() {
-    return process.env.E9_NO_NODE_NAME === '1';
-}
-
-/**
- * 纯函数：把 getNodeInfo 响应归一化为 { workflowName, version, nodes:{id:name} }。
- * 结构不符（登录页/空表/非 JSON）返回 null——调用方据此 fail-soft。
- */
-export function parseNodeInfo(json) {
-    const list = json?.nodeInfo;
-    if (!Array.isArray(list))
-        return null;
-    const nodes = {};
-    for (const n of list) {
-        const id = str(n?.id);
-        if (!id)
-            continue;
-        nodes[id] = stripHtml(n?.name) || id;
-    }
-    if (Object.keys(nodes).length === 0)
-        return null;
-    return {
-        workflowName: str(json?.wfInfo?.workflowName),
-        version: str(json?.wfInfo?.version),
-        nodes,
-    };
-}
-
-/** 读缓存文件；坏文件/不存在返回 {}。 */
-function readCache(cfg) {
-    try {
-        const p = nodeMapCachePath(cfg);
-        if (!fs.existsSync(p))
-            return {};
-        const raw = JSON.parse(fs.readFileSync(p, 'utf8'));
-        return raw && typeof raw === 'object' && raw.workflows ? raw.workflows : {};
-    }
-    catch {
-        return {};
-    }
-}
-
-/** 写回缓存（单流程）；写入失败不阻断（节点名只是锦上添花）。 */
-function writeCache(cfg, workflowId, entry) {
-    try {
-        const p = nodeMapCachePath(cfg);
-        const workflows = readCache(cfg);
-        workflows[workflowId] = entry;
-        const baseUrl = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
-        fs.mkdirSync(path.dirname(p), { recursive: true });
-        fs.writeFileSync(p, JSON.stringify({
-            envkey: profileNameFromBaseUrl(baseUrl),
-            baseUrl,
-            updatedAt: new Date().toISOString(),
-            workflows,
-        }, null, 2) + '\n', 'utf8');
-    }
-    catch { /* 忽略：缓存写失败不影响本次结果 */ }
-}
-
-function isStale(entry) {
-    if (!entry || !entry.fetchedAt)
-        return true;
-    return Date.now() - new Date(entry.fetchedAt).getTime() > NODEMAP_TTL_MS;
-}
-
-/**
- * 取某流程的节点表（带缓存）。任何失败返回 null（fail-soft，不抛）。
- * @returns {Promise<{workflowName?:string, version?:string, nodes:Record<string,string>}|null>}
- */
-export async function getNodeMap(cfg, workflowId, opts = {}) {
-    const wfId = str(workflowId);
-    if (!wfId)
-        return null;
-    const cached = readCache(cfg)[wfId];
-    if (!opts.refresh && cached && !isStale(cached) && cached.nodes)
-        return { workflowName: cached.workflowName, version: cached.version, nodes: cached.nodes };
-    const api = opts.api ?? await createApiFromProfile(cfg);
-    let json = null;
-    try {
-        const r = await api.post('/api/workflow/test/getNodeInfo', { workflowId: wfId });
-        json = r?.json ?? null;
-    }
-    catch {
-        json = null; // 网络/鉴权异常同上：降级，不打断列表
-    }
-    const parsed = parseNodeInfo(json);
-    if (!parsed)
-        return null;
-    writeCache(cfg, wfId, { ...parsed, workflowId: wfId, fetchedAt: new Date().toISOString() });
-    return parsed;
-}
-
-/**
- * 列出**本地缓存**里所有流程的节点表（供「按节点名跨流程解析」用）。
- * 缓存来自历次列表查询；从没查过的流程不在其中。
- */
-export function listCachedNodeMaps(cfg) {
-    const workflows = readCache(cfg);
-    return Object.entries(workflows)
-        .filter(([, w]) => w && w.nodes && Object.keys(w.nodes).length)
-        .map(([workflowId, w]) => ({ workflowId: String(workflowId), workflowName: w.workflowName, nodes: w.nodes }));
-}
-
-/**
- * 按**节点名**解析节点 id（供 CLI `--node-name`）。
- *
- * 节点 id 是**流程内编号**（每个流程一套），故解析必须先限定流程范围：
- *   - 给了 `workflowId`：只在该流程的节点表内找（按需拉取，不依赖缓存）；
- *   - 未给：在**本地缓存**的所有流程节点表内找（缓存来自历次列表查询）。
- *
- * 匹配规则：**先精确同名**；无精确才做模糊（互相包含）。多候选一律**全部返回**，
- * 由调用方列给用户选——严禁自动取首条（本仓库硬规则）。
- *
- * @returns {Promise<{candidates:Array<{workflowId,workflowName,nodeId,nodeName,matchType}>,
- *                    exact:Array, scoped:boolean, poolSize:number, unavailable:boolean}>}
- *   `unavailable`：限定了流程但节点表取不到（接口不存在/异常）——与"确实没有同名节点"要区分开。
- */
-export async function resolveNodeByName(cfg, name, opts = {}) {
-    const want = String(name ?? '').trim();
-    const empty = { candidates: [], exact: [], scoped: Boolean(opts.workflowId), poolSize: 0, unavailable: false };
-    if (!want)
-        return empty;
-    let pool = [];
-    if (opts.workflowId) {
-        const m = await getNodeMap(cfg, opts.workflowId, opts);
-        if (!m)
-            return { ...empty, unavailable: true };
-        pool = [{ workflowId: String(opts.workflowId), workflowName: m.workflowName, nodes: m.nodes }];
-    }
-    else {
-        pool = listCachedNodeMaps(cfg);
-    }
-    const candidates = [];
-    for (const w of pool) {
-        for (const [nodeId, nodeName] of Object.entries(w.nodes)) {
-            if (!nodeName)
-                continue;
-            const isExact = nodeName === want;
-            const isFuzzy = !isExact && (nodeName.includes(want) || want.includes(nodeName));
-            if (isExact || isFuzzy)
-                candidates.push({ workflowId: w.workflowId, workflowName: w.workflowName, nodeId, nodeName, matchType: isExact ? 'exact' : 'fuzzy' });
-        }
-    }
-    return {
-        candidates,
-        exact: candidates.filter((c) => c.matchType === 'exact'),
-        scoped: Boolean(opts.workflowId),
-        poolSize: pool.length,
-        unavailable: false,
-    };
-}
-
-/** 从列表行取流程 id（normalizeRow 归一字段优先，回退原始行）。 */
-function workflowIdOf(item) {
-    return str(item?.workflowId) ?? str(item?.raw?.workflowid) ?? str(item?.raw?.workflowId);
-}
-
-/**
- * 给列表行补 `nodeName`（就地写回）。返回补上的行数。
- *
- * - 行需带 `node`（节点 id）；流程 id 取 `workflowId` 或 `raw.workflowid`。
- * - 按流程去重，每个流程只请求一次；同一流程的多行共用一张表。
- * - 任何失败都不抛：拿不到节点表的行保持原样（渲染层回退显示 id）。
- */
-export async function annotateNodeNames(cfg, items, opts = {}) {
-    if (!Array.isArray(items) || items.length === 0)
-        return 0;
-    if (opts.disabled)
-        return 0;
-    // 只对「node 是纯数字 id」的行解析：服务端不同列表的 span 给的东西不一样——
-    // 待办/公文给的是**节点 id**（需要解析），流程代理办理记录给的是**节点名**（解析无从匹配，纯浪费请求）。
-    const rows = items.filter((it) => /^\d+$/.test(str(it?.node) ?? '') && workflowIdOf(it));
-    if (rows.length === 0)
-        return 0;
-    const wfIds = [...new Set(rows.map(workflowIdOf))];
-    const maps = new Map();
-    for (let i = 0; i < wfIds.length; i += FETCH_CHUNK) {
-        const chunk = wfIds.slice(i, i + FETCH_CHUNK);
-        const got = await Promise.all(chunk.map((w) => getNodeMap(cfg, w, opts)));
-        chunk.forEach((w, idx) => maps.set(w, got[idx]));
-    }
-    let filled = 0;
-    for (const it of rows) {
-        const name = maps.get(workflowIdOf(it))?.nodes?.[str(it.node)];
-        if (name) {
-            it.nodeName = name;
-            filled++;
-        }
-    }
-    return filled;
-}
+/**
+ * 流程节点名解析：nodeid → nodename。
+ *
+ * 背景：待办/已办/我发起列表服务端**只给当前节点的 id**——行字段 `currentnodeid` 的值形如 "2882"，
+ *   且行里没有节点名（实测 `currentnodeidspan` 也只是 id 本身，整行不含 currentnodename/currentnodespan）。
+ *   要显示名字只能按流程另取节点表。
+ *
+ * 接口（2026-10-14 实测 e9pc.e-cology.com.cn）：
+ *   POST /api/workflow/test/getNodeInfo   body: { workflowId }
+ *     → { nodeInfo: [{id, name, type}], wfInfo: {workflowName, version}, authority, tabInfo, ... }
+ *   - 只需 workflowId；文档里的 requestid/userId/type 都非必需（逐个试过）。
+ *   - ⚠️ 路径必须带 `/api` 前缀：`/workflow/test/getNodeInfo`（无前缀）返回登录页 HTML。
+ *   - ⚠️ 接口挂在「流程测试」模块下，非所有部署/版本都有 → **一律 fail-soft**：
+ *       拿不到就返回 null，调用方退回显示节点 id，绝不让列表整体报错。
+ *   - `type`：0=发起节点 / 1=审批节点 / 3=归档节点。
+ *
+ * 缓存：`~/.e9/node_map_<envkey>.json`，按 workflowId 存，TTL 30 天
+ *   （节点表几乎不变；响应带 version，流程改版后重新拉取自然覆盖）。
+ *   - `E9_NODEMAP_CACHE_DIR` 覆盖缓存目录（测试隔离用，避免污染真实 ~/.e9）。
+ *   - `E9_NO_NODE_NAME=1` 或 CLI `--no-node-name` 整体停用解析。
+ */
+import { createApiFromProfile } from './client.js';
+import { endpointFor, profileNameFromBaseUrl } from './config.js';
+import { stripHtml } from './parse.js';
+import path from 'node:path';
+import os from 'node:os';
+
+/** 节点表缓存 TTL（天）。 */
+export const NODEMAP_TTL_MS = (Number(process.env.E9_NODEMAP_TTL_DAYS ?? '30') || 30) * 24 * 3600 * 1000;
+/** 并发拉取上限（一次列表页通常 ≤10 个流程，全量拉取路径可能几十个，别一次打满）。 */
+const FETCH_CHUNK = 6;
+
+function str(v) {
+    if (v === undefined || v === null || v === '')
+        return undefined;
+    return String(v);
+}
+
+/** 缓存目录（测试可用 E9_NODEMAP_CACHE_DIR 覆盖）。 */
+export function nodeMapCacheDir() {
+    return process.env.E9_NODEMAP_CACHE_DIR || path.join(os.homedir(), '.e9');
+}
+/** 缓存文件路径：~/.e9/node_map_<envkey>.json（按环境隔离，nodeid 不跨环境通用）。 */
+export function nodeMapCachePath(cfg) {
+    const baseUrl = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+    return path.join(nodeMapCacheDir(), `node_map_${profileNameFromBaseUrl(baseUrl)}.json`);
+}
+
+/** 是否停用节点名解析（E9_NO_NODE_NAME=1）。 */
+export function isNodeNameDisabled() {
+    return process.env.E9_NO_NODE_NAME === '1';
+}
+
+/**
+ * 纯函数：把 getNodeInfo 响应归一化为 { workflowName, version, nodes:{id:name} }。
+ * 结构不符（登录页/空表/非 JSON）返回 null——调用方据此 fail-soft。
+ */
+export function parseNodeInfo(json) {
+    const list = json?.nodeInfo;
+    if (!Array.isArray(list))
+        return null;
+    const nodes = {};
+    for (const n of list) {
+        const id = str(n?.id);
+        if (!id)
+            continue;
+        nodes[id] = stripHtml(n?.name) || id;
+    }
+    if (Object.keys(nodes).length === 0)
+        return null;
+    return {
+        workflowName: str(json?.wfInfo?.workflowName),
+        version: str(json?.wfInfo?.version),
+        nodes,
+    };
+}
+
+import { cacheGet, cacheUpdate } from './cache-store.js';
+
+/** 读缓存文件；坏文件/不存在返回 {}。 */
+function readCache(cfg) {
+    const raw = cacheGet(nodeMapCachePath(cfg));
+    return raw?.workflows ?? {};
+}
+
+/** 写回缓存（单流程）；写入失败不阻断（节点名只是锦上添花）。 */
+function writeCache(cfg, workflowId, entry) {
+    const baseUrl = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+    cacheUpdate(nodeMapCachePath(cfg), (current) => {
+        const workflows = current?.workflows ?? {};
+        workflows[workflowId] = entry;
+        return {
+            envkey: profileNameFromBaseUrl(baseUrl),
+            baseUrl,
+            updatedAt: new Date().toISOString(),
+            workflows,
+        };
+    });
+}
+
+function isStale(entry) {
+    if (!entry || !entry.fetchedAt)
+        return true;
+    return Date.now() - new Date(entry.fetchedAt).getTime() > NODEMAP_TTL_MS;
+}
+
+/**
+ * 取某流程的节点表（带缓存）。任何失败返回 null（fail-soft，不抛）。
+ * @returns {Promise<{workflowName?:string, version?:string, nodes:Record<string,string>}|null>}
+ */
+export async function getNodeMap(cfg, workflowId, opts = {}) {
+    const wfId = str(workflowId);
+    if (!wfId)
+        return null;
+    const cached = readCache(cfg)[wfId];
+    if (!opts.refresh && cached && !isStale(cached) && cached.nodes)
+        return { workflowName: cached.workflowName, version: cached.version, nodes: cached.nodes };
+    const api = opts.api ?? await createApiFromProfile(cfg);
+    let json = null;
+    try {
+        const r = await api.post('/api/workflow/test/getNodeInfo', { workflowId: wfId });
+        json = r?.json ?? null;
+    }
+    catch {
+        json = null; // 网络/鉴权异常同上：降级，不打断列表
+    }
+    const parsed = parseNodeInfo(json);
+    if (!parsed)
+        return null;
+    writeCache(cfg, wfId, { ...parsed, workflowId: wfId, fetchedAt: new Date().toISOString() });
+    return parsed;
+}
+
+/**
+ * 列出**本地缓存**里所有流程的节点表（供「按节点名跨流程解析」用）。
+ * 缓存来自历次列表查询；从没查过的流程不在其中。
+ */
+export function listCachedNodeMaps(cfg) {
+    const workflows = readCache(cfg);
+    return Object.entries(workflows)
+        .filter(([, w]) => w && w.nodes && Object.keys(w.nodes).length)
+        .map(([workflowId, w]) => ({ workflowId: String(workflowId), workflowName: w.workflowName, nodes: w.nodes }));
+}
+
+/**
+ * 按**节点名**解析节点 id（供 CLI `--node-name`）。
+ *
+ * 节点 id 是**流程内编号**（每个流程一套），故解析必须先限定流程范围：
+ *   - 给了 `workflowId`：只在该流程的节点表内找（按需拉取，不依赖缓存）；
+ *   - 未给：在**本地缓存**的所有流程节点表内找（缓存来自历次列表查询）。
+ *
+ * 匹配规则：**先精确同名**；无精确才做模糊（互相包含）。多候选一律**全部返回**，
+ * 由调用方列给用户选——严禁自动取首条（本仓库硬规则）。
+ *
+ * @returns {Promise<{candidates:Array<{workflowId,workflowName,nodeId,nodeName,matchType}>,
+ *                    exact:Array, scoped:boolean, poolSize:number, unavailable:boolean}>}
+ *   `unavailable`：限定了流程但节点表取不到（接口不存在/异常）——与"确实没有同名节点"要区分开。
+ */
+export async function resolveNodeByName(cfg, name, opts = {}) {
+    const want = String(name ?? '').trim();
+    const empty = { candidates: [], exact: [], scoped: Boolean(opts.workflowId), poolSize: 0, unavailable: false };
+    if (!want)
+        return empty;
+    let pool = [];
+    if (opts.workflowId) {
+        const m = await getNodeMap(cfg, opts.workflowId, opts);
+        if (!m)
+            return { ...empty, unavailable: true };
+        pool = [{ workflowId: String(opts.workflowId), workflowName: m.workflowName, nodes: m.nodes }];
+    }
+    else {
+        pool = listCachedNodeMaps(cfg);
+    }
+    const candidates = [];
+    for (const w of pool) {
+        for (const [nodeId, nodeName] of Object.entries(w.nodes)) {
+            if (!nodeName)
+                continue;
+            const isExact = nodeName === want;
+            const isFuzzy = !isExact && (nodeName.includes(want) || want.includes(nodeName));
+            if (isExact || isFuzzy)
+                candidates.push({ workflowId: w.workflowId, workflowName: w.workflowName, nodeId, nodeName, matchType: isExact ? 'exact' : 'fuzzy' });
+        }
+    }
+    return {
+        candidates,
+        exact: candidates.filter((c) => c.matchType === 'exact'),
+        scoped: Boolean(opts.workflowId),
+        poolSize: pool.length,
+        unavailable: false,
+    };
+}
+
+/** 从列表行取流程 id（normalizeRow 归一字段优先，回退原始行）。 */
+function workflowIdOf(item) {
+    return str(item?.workflowId) ?? str(item?.raw?.workflowid) ?? str(item?.raw?.workflowId);
+}
+
+/**
+ * 给列表行补 `nodeName`（就地写回）。返回补上的行数。
+ *
+ * - 行需带 `node`（节点 id）；流程 id 取 `workflowId` 或 `raw.workflowid`。
+ * - 按流程去重，每个流程只请求一次；同一流程的多行共用一张表。
+ * - 任何失败都不抛：拿不到节点表的行保持原样（渲染层回退显示 id）。
+ */
+export async function annotateNodeNames(cfg, items, opts = {}) {
+    if (!Array.isArray(items) || items.length === 0)
+        return 0;
+    if (opts.disabled)
+        return 0;
+    // 只对「node 是纯数字 id」的行解析：服务端不同列表的 span 给的东西不一样——
+    // 待办/公文给的是**节点 id**（需要解析），流程代理办理记录给的是**节点名**（解析无从匹配，纯浪费请求）。
+    const rows = items.filter((it) => /^\d+$/.test(str(it?.node) ?? '') && workflowIdOf(it));
+    if (rows.length === 0)
+        return 0;
+    const wfIds = [...new Set(rows.map(workflowIdOf))];
+    const maps = new Map();
+    for (let i = 0; i < wfIds.length; i += FETCH_CHUNK) {
+        const chunk = wfIds.slice(i, i + FETCH_CHUNK);
+        const got = await Promise.all(chunk.map((w) => getNodeMap(cfg, w, opts)));
+        chunk.forEach((w, idx) => maps.set(w, got[idx]));
+    }
+    let filled = 0;
+    for (const it of rows) {
+        const name = maps.get(workflowIdOf(it))?.nodes?.[str(it.node)];
+        if (name) {
+            it.nodeName = name;
+            filled++;
+        }
+    }
+    return filled;
+}