weaver-work-cli 0.1.33 → 0.1.38

package/dist/shortcuts/meeting/operations/invitation.js

@@ -13,20 +13,37 @@
  * - 数据源必须是 `meeting.eb.meeting.list` 单查（47 字段）；
  *   `meeting.eb.meeting.detail` 在该环境只回 `{id}`，不可用。
  */
+import { existsSync } from 'node:fs';
 import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { meetingValidationError } from '../errors.js';
 import { meetingStateDir } from './env.js';
 import { renderDocx } from '../invitation/docx.js';
+import { renderInvitationMarkdown } from '../invitation/text.js';
 import { meetingSuccess, SCHEMA_ID } from './types.js';
 /** 模板随 CLI 包分发（`templates/` 已在 package.json 的 files 白名单内）。 */
 function templatePath() {
     const override = process.env.WEAVER_MEETING_INVITATION_TEMPLATE;
     if (override)
         return resolve(override);
-    // 本文件编译后位于 <pkg>/dist/shortcuts/meeting/operations/，向上四级即包根
+    // ⛔ 不能写死「向上四级」：同一个源文件在两种产物里的位置不一样 ——
+    //   · tsc 直出：<pkg>/dist/shortcuts/meeting/operations/  → 向上四级是包根
+    //   · bundle 打包：<pkg>/dist/chunks/chunk-xxxx.js         → 向上两级才是包根
+    // 2026-10-30 真机踩过：小e 跑的是 bundle 版，写死四级会算出 <pkg>/../templates/… 而报「模板缺失」。
+    // 所以直接逐级向上找，找到第一个存在的就是它。
     const here = dirname(fileURLToPath(import.meta.url));
+    let dir = here;
+    for (let depth = 0; depth < 6; depth += 1) {
+        const candidate = join(dir, 'templates', 'meeting', 'invitation.docx');
+        if (existsSync(candidate))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    // 都没找到：仍按传统层级拼一个路径返回，让报错信息能指向具体位置
     return resolve(here, '../../../../templates/meeting/invitation.docx');
 }
 const WEEKDAYS = ['星期日', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六'];
@@ -234,8 +251,80 @@ async function resolveIssuerOrganization(env, creatorId) {
         return null;
     }
 }
-/** 组装占位符解析器：派生字段 → 会议标准字段 → extra（租户自定义字段）→ 待补充。 */
-export function buildResolver(row, extra, issuerOrg) {
+/**
+ * 取当前登录人的姓名 —— 会议既没填召集人、又没有创建人名时，用**发起人本人**兜底。
+ *
+ * 理由：邀请函里「XXX 诚邀您参加…」这句必须有个人名，否则通篇【待补充】没法看。
+ * 实际业务上发起建会的人就是召集人，比留空更接近事实（2026-10-31 用户对【待补充】有意见）。
+ */
+async function resolveSessionUserName(env) {
+    try {
+        const session = await env.host.getSession();
+        const userId = String(session?.userId ?? '').trim();
+        if (!userId)
+            return '';
+        const { hrmEmployeeOperations } = await import('../../hrm/operations/employee.js');
+        const batch = hrmEmployeeOperations.find((operation) => operation.name === 'hrm.employee.batch');
+        if (!batch)
+            return '';
+        const result = await batch.handler({ ids: [userId] }, env);
+        const row = (result?.data?.rows ?? [])[0];
+        return String(row?.name ?? '').trim();
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * 用 `meeting.eb.meeting.detail` 补列表单查里**空着**的字段。
+ *
+ * 为什么需要（2026-10-31 真机取证）：同一个会议
+ *   · `meeting.eb.meeting.list`（单查）→ `hrm_members = ""`
+ *   · `meeting.eb.meeting.detail`     → `hrm_members = "王丹丹"`
+ * 邀请函原先只读 list，于是"明明有参会人却写成【待补充】"—— 这正是用户投诉过的
+ * 「参会人员没有带出来」。detail 的价值在于**字段更多且有值**，代价是 `address` 回的是
+ * 会议室 id（不是名称），所以这里**只补白名单字段、且只填空值**，绝不覆盖 list 已有的值。
+ */
+const DETAIL_FALLBACK_KEYS = [
+    'hrm_members', 'mt_desc', 'total_member', 'caller', 'contacter',
+    'begin_datetime', 'end_datetime', 'other_members', 'mt_creator',
+    'topic_presenter', 'mt_format', 'mt_type', 'video_url',
+    'org_members', 'with_secauth',
+];
+async function supplementRowFromDetail(row, mtId, env) {
+    const isBlank = (value) => {
+        if (value === undefined || value === null)
+            return true;
+        if (Array.isArray(value))
+            return value.length === 0;
+        return String(value).trim() === '';
+    };
+    const missing = DETAIL_FALLBACK_KEYS.filter((key) => isBlank(row[key]));
+    if (missing.length === 0)
+        return { row, filled: [] };
+    try {
+        const { getMeetingOperation } = await import('./registry.js');
+        const detailOperation = getMeetingOperation('meeting.eb.meeting.detail');
+        const result = await detailOperation.handler({ id: mtId }, env);
+        // detail 的字段是**扁平**挂在 `data.data` 下（不是 mainTable），两种都兜一下
+        const flat = (result?.data?.data ?? result?.data ?? {});
+        const merged = { ...row };
+        const filled = [];
+        for (const key of missing) {
+            const value = flat[key];
+            if (!isBlank(value)) {
+                merged[key] = value;
+                filled.push(key);
+            }
+        }
+        return { row: merged, filled };
+    }
+    catch {
+        // detail 读失败不能拖垮邀请函：列表数据照样能出一份（缺的字段仍标【待补充】）
+        return { row, filled: [] };
+    }
+}
+/** 组装占位符解析器：派生字段 → 会议标准字段 → extra（租户自定义字段）→ 待补充。 */ export function buildResolver(row, extra, issuerOrg) {
     const begin = parseDateTime(row.begin_datetime);
     const end = parseDateTime(row.end_datetime);
     const derived = {
@@ -281,6 +370,9 @@ export function buildResolver(row, extra, issuerOrg) {
         org_members: orgMembers,
         // 落款公司全称：`extra.company_name` 可覆盖（对外开放时客户传自己的公司名）
         company_name: String(extra.company_name ?? '').trim() || DEFAULT_COMPANY_NAME,
+        // 客户单位（「尊敬的 XXX」）：先看 extra（建会时由 create.flow 把参会客户名带进来），
+        // 再看会议主表的 crm_members（部分租户会存），都没有才留【待补充】
+        guest_org: String(extra.guest_org ?? '').trim() || flattenFieldValue(row.crm_members) || '',
         // 单独暴露上级公司，模板需要「公司级落款」时可直接用
         issuer_company: issuerCompany,
         other_members: humanizeMembers(row.other_members),
@@ -304,8 +396,14 @@ export function buildResolver(row, extra, issuerOrg) {
     const lookup = (key) => {
         if (key in derived)
             return derived[key];
-        if (key in standard)
-            return standard[key];
+        if (key in standard) {
+            const standardValue = standard[key];
+            // ⛔ 会议里该字段**空着**时要继续往 extra 找（2026-10-31）：
+            // 以前 `key in standard` 直接返回空串，导致「会议没填召集人 → extra.caller 也压不上」，
+            // 明明调用方补了值还是渲染成【待补充】。空值不算"有值"，让 extra 有机会兜底。
+            if (String(standardValue ?? '').trim() !== '')
+                return standardValue;
+        }
         if (key.startsWith('extra.') && key.slice(6) in extra)
             return extra[key.slice(6)];
         if (key in extra)
@@ -337,14 +435,27 @@ const meetingInvitationRender = {
     resource: 'invitation',
     method: 'render',
     action: 'meeting.invitation.render',
-    summary: '按会议真实数据生成邀请函 docx（只读，不发送）：数据取 meeting.eb.meeting.list 单查；议程有议题就按议题自动填、没有则保留模板示例行；取不到的字段渲染成黄色高亮【待补充】；租户自定义字段用 extra 传入',
+    summary: '按会议真实数据生成邀请函（只读，不发送）：**同时返回 docx 与对话内可展示的 Markdown 全文**（`text` 字段），'
+        + '会话里应直接把 `text` 贴出来，不要只给文件名让人自己下载；'
+        + '数据取 meeting.eb.meeting.list 单查；议程有议题就按议题自动填、没有则保留模板示例行；'
+        + '取不到的字段渲染成【待补充】（docx 里是黄色高亮）；租户自定义字段用 extra 传入',
     capability: 'invitation',
     risk: 'read',
     inputSchema: {
         type: 'object',
         additionalProperties: false,
         properties: {
-            mtId: { ...SCHEMA_ID, description: '会议 id（EB 版 mt_detail 主键）' },
+            mtId: { ...SCHEMA_ID, description: '会议 id（EB 版 mt_detail 主键）。**与下面的字段二选一**：有 mtId 走真实会议数据；没有则用传入字段直接生成（流程建会审批中也能出邀请函）' },
+            mt_name: { type: 'string', description: '会议名称（无 mtId 时必填）' },
+            begin_datetime: { type: 'string', description: '开始时间 `yyyy-MM-dd HH:mm`（无 mtId 时必填）' },
+            end_datetime: { type: 'string', description: '结束时间 `yyyy-MM-dd HH:mm`（无 mtId 时建议填，缺了结束时间会是【待补充】）' },
+            address: { type: 'string', description: '会议地点/会议室**名称**（无 mtId 时用；这里要传名称，不是 id）' },
+            hrm_members: { type: 'string', description: '参会人姓名（逗号/顿号分隔，无 mtId 时用）' },
+            mt_desc: { type: 'string', description: '会议内容/议题概要' },
+            org_members: { type: 'string', description: '落款单位（不传则尝试用发起人部门 / 留【待补充】）' },
+            caller: { type: 'string', description: '召集人' },
+            contacter: { type: 'string', description: '联系人' },
+            total_member: { type: 'string', description: '参会人数' },
             extra: {
                 type: 'object',
                 additionalProperties: { type: 'string' },
@@ -355,13 +466,10 @@ const meetingInvitationRender = {
                 description: '输出文件完整路径（可选）。缺省写到 ~/.weaver-work-cli/meeting/invitations/邀请函-{会议名}-{日期}.docx',
             },
         },
-        required: ['mtId'],
+        required: [],
     },
     handler: async (args, env) => {
         const mtId = String(args.mtId ?? '').trim();
-        if (!mtId) {
-            throw meetingValidationError('mt_id_required', '必须提供会议 id（mtId）');
-        }
         const extra = {};
         if (args.extra && typeof args.extra === 'object') {
             for (const [key, value] of Object.entries(args.extra)) {
@@ -369,20 +477,68 @@ const meetingInvitationRender = {
                     extra[key] = String(value);
             }
         }
-        // 复用已实现的 EB 列表操作（内部先 count 再 list，筛选走 URL query）
-        const { getMeetingOperation } = await import('./registry.js');
-        const listOperation = getMeetingOperation('meeting.eb.meeting.list');
         let row;
-        try {
-            const listed = await listOperation.handler({ mt_id: mtId, pageNo: 1, pageSize: 1 }, env);
-            const rows = (listed.data?.rows ?? []);
-            row = rows[0]?.mainTable ?? rows[0];
+        /** meeting=按真实会议数据；payload=按调用方传入的申请单字段（会议可能还没生成）。 */
+        let dataSource = 'meeting';
+        /** 用 detail 补回来的字段名（列表单查会丢「参会人员」，见下方注释）。 */
+        let detailSupplementary = [];
+        if (!mtId) {
+            // ⛔ 邀请函本质是「预置函」：项目人员下载后自己改、自己发（2026-10-30 用户明确要求）。
+            // 所以不该卡在"会议必须已生成"——流程还在审批时，用申请单已知信息先生成一份，
+            // 取不到的字段渲染成【待补充】，让人工补。这也保证流程建会提交后立刻能拿到邀请函。
+            const mtName = String(args.mt_name ?? '').trim();
+            const beginText = String(args.begin_datetime ?? '').trim();
+            if (!mtName || !beginText) {
+                throw meetingValidationError('invitation_source_required', '要么传 mtId（按真实会议生成），要么传 mt_name + begin_datetime（按申请单信息预填生成）');
+            }
+            // 无 mtId 时落款单位取当前登录用户的部门（比让用户手填更省事），取不到再留【待补充】
+            const session = await env.host.getSession().catch(() => null);
+            const sessionUserId = String(session?.userId ?? '');
+            row = {
+                mt_name: mtName,
+                begin_datetime: beginText,
+                end_datetime: String(args.end_datetime ?? '').trim(),
+                address: String(args.address ?? '').trim(),
+                hrm_members: String(args.hrm_members ?? '').trim(),
+                mt_desc: String(args.mt_desc ?? '').trim(),
+                org_members: String(args.org_members ?? '').trim(),
+                caller: String(args.caller ?? '').trim(),
+                contacter: String(args.contacter ?? '').trim(),
+                total_member: String(args.total_member ?? '').trim(),
+                creator: sessionUserId,
+            };
+            dataSource = 'payload';
         }
-        catch (error) {
-            throw meetingValidationError('invitation_source_unavailable', `读取会议数据失败（邀请函当前依赖 EB 版会议列表）：${error instanceof Error ? error.message : String(error)}`, { mtId });
+        else {
+            // 复用已实现的 EB 列表操作（内部先 count 再 list，筛选走 URL query）
+            const { getMeetingOperation } = await import('./registry.js');
+            const listOperation = getMeetingOperation('meeting.eb.meeting.list');
+            try {
+                const listed = await listOperation.handler({ mt_id: mtId, pageNo: 1, pageSize: 1 }, env);
+                const rows = (listed.data?.rows ?? []);
+                row = rows[0]?.mainTable ?? rows[0];
+            }
+            catch (error) {
+                throw meetingValidationError('invitation_source_unavailable', `读取会议数据失败（邀请函当前依赖 EB 版会议列表）：${error instanceof Error ? error.message : String(error)}`, { mtId });
+            }
+            if (!row) {
+                throw meetingValidationError('not_found', `未找到会议 id=${mtId}，或当前账号无权限查看`, { mtId });
+            }
+            // 列表单查在真机上会**丢「参会人员」**（2026-10-31 实测：同一会议 list 里 `hrm_members=""`，
+            // detail 里是「王丹丹」）⇒ 只对**空字段**用 detail 补，避免邀请函把明明有的人写成【待补充】。
+            const supplement = await supplementRowFromDetail(row, mtId, env);
+            row = supplement.row;
+            detailSupplementary = supplement.filled;
         }
-        if (!row) {
-            throw meetingValidationError('not_found', `未找到会议 id=${mtId}，或当前账号无权限查看`, { mtId });
+        // 召集人再兜一层：会议没填 caller、也没有创建人名时，用**发起人本人**（当前登录人）。
+        // 否则邀请函开头「XXX 诚邀您参加…」整句就是【待补充】，对话里贴出来很难看。
+        let callerFromSession = false;
+        if (!String(row.caller ?? '').trim() && !String(row.mt_creator ?? '').trim()) {
+            const sessionName = await resolveSessionUserName(env);
+            if (sessionName) {
+                row = { ...row, caller: sessionName };
+                callerFromSession = true;
+            }
         }
         // 落款单位回落：会议 org_members 为空时，用「发起人（creator 人员 id）的所属组织」
         const creatorId = String(row.creator ?? '').trim();
@@ -390,7 +546,7 @@ const meetingInvitationRender = {
         const issuerOrg = needsIssuerOrg ? await resolveIssuerOrganization(env, creatorId) : null;
         const { resolver, orgSource } = buildResolver(row, extra, issuerOrg);
         // 议程：议题表 → extra.agenda → 保留模板里的示例行（用户口径：没有就这样）
-        let agendaRows = await loadAgendaFromTopics(env, mtId);
+        let agendaRows = dataSource === 'meeting' && mtId ? await loadAgendaFromTopics(env, mtId) : [];
         let agendaSource = agendaRows.length > 0 ? 'meeting.topic' : 'template';
         if (agendaRows.length === 0) {
             const fromExtra = parseAgendaFromExtra(extra.agenda);
@@ -409,6 +565,10 @@ const meetingInvitationRender = {
         const rendered = renderDocx(template, resolver, {
             agenda: { headerKeyword: AGENDA_HEADER_KEYWORD, rows: agendaRows },
         });
+        // 对话内文本版（2026-10-31 用户要求「直接展示在对话里」）：
+        // docx 是给打印/外发的成品，但会话里用户看不见内容 ⇒ 同一份 resolver 再渲染一遍 Markdown，
+        // 上层（create.flow / 模型回复）可以直接把 text 贴出来，字段与 docx 完全一致。
+        const textVersion = renderInvitationMarkdown(resolver, agendaRows);
         const begin = parseDateTime(row.begin_datetime);
         const dateTag = begin ? `${begin.getFullYear()}${pad(begin.getMonth() + 1)}${pad(begin.getDate())}` : '未知日期';
         const fileName = `邀请函-${safeFileName(String(row.mt_name ?? ''))}-${dateTag}.docx`;
@@ -418,6 +578,9 @@ const meetingInvitationRender = {
         await mkdir(dirname(target), { recursive: true });
         await writeFile(target, rendered.buffer);
         const warnings = [];
+        if (dataSource === 'payload') {
+            warnings.push('本邀请函按**申请单已知信息**预生成（会议可能还在审批中、尚未生成），属于**预置函**：请下载后人工核对/修改再自行发送。会议正式生成后可用 mtId 重新生成一版拿到完整字段。');
+        }
         if (rendered.pending.length > 0) {
             warnings.push(`以下字段取不到值，已渲染成黄色高亮【待补充】，请人工补充：${rendered.pending.join('、')}`);
         }
@@ -438,16 +601,25 @@ const meetingInvitationRender = {
             filePath: target,
             fileName,
             bytes: rendered.buffer.length,
-            meetingId: mtId,
+            meetingId: mtId || null,
             meetingName: String(row.mt_name ?? ''),
+            // meeting=按真实会议数据；payload=按申请单字段预生成（会议可能还没生成，属预置函）
+            dataSource,
+            // 列表单查丢字段时，用 detail 补回来的字段名（有值 = 邀请函用的是合并后的数据）
+            detailSupplemented: detailSupplementary,
+            // 对话内展示用的 Markdown 全文（与 docx 同源）。上层应直接把这段贴进回复正文，
+            // ⛔ 不要只丢一个 filePath 让用户自己去本地打开看内容。
+            text: textVersion.markdown,
             filledFields: rendered.filled,
             pendingFields: rendered.pending,
             // 落款单位的实际来源，便于调用方判断是否需要人工改写
             orgSource,
-            // 召集人来源：meeting.caller=会议自己填的 / meeting.mt_creator=回落到创建人 / none=都没有
-            callerSource: String(row.caller ?? '').trim()
-                ? 'meeting.caller'
-                : (String(row.mt_creator ?? '').trim() ? 'meeting.mt_creator' : 'none'),
+            // 召集人来源：meeting.caller=会议自己填的 / meeting.mt_creator=回落到创建人 / session.user=回落到发起人本人 / none=都没有
+            callerSource: callerFromSession
+                ? 'session.user'
+                : (String(row.caller ?? '').trim()
+                    ? 'meeting.caller'
+                    : (String(row.mt_creator ?? '').trim() ? 'meeting.mt_creator' : 'none')),
             // 议程来源：meeting.topic=按议题自动填 / extra=调用方传入 / template=保留模板示例行
             agendaSource,
             agendaRows: agendaRows.length,

package/dist/shortcuts/okr/host.js

@@ -6,6 +6,7 @@ import { E10_SESSION_EXPIRED_MESSAGE } from '../../internal/e10/auth/messages.js
 import { getActiveProfile } from '../../internal/e10/auth/session.js';
 import { requireE10Session } from '../../internal/e10/context.js';
 import { E10ApiError, createE10RequestRuntime } from '../../internal/e10/request-runtime.js';
+import { isE10SessionExpiredResponse } from '../../internal/e10/auth-recovery.js';
 import { okrStateRoot } from './continuation.js';
 import { OkrCliError, okrAuthError, okrNetworkError, okrValidationError } from './errors.js';
 function inferProfile(ctx) {
@@ -143,7 +144,7 @@ export function createOkrHost(ctx, dependencies = {}) {
         catch (error) {
             mapRuntimeNetworkError(error);
         }
-        if (response.status === 401 || response.status === 302) {
+        if (isE10SessionExpiredResponse(response)) {
             throw okrAuthError('session_expired', E10_SESSION_EXPIRED_MESSAGE, { httpStatus: response.status });
         }
         if (response.parseError) {

package/dist/shortcuts/plan/host.js

@@ -6,6 +6,7 @@ import { E10_SESSION_EXPIRED_MESSAGE } from '../../internal/e10/auth/messages.js
 import { getActiveProfile } from '../../internal/e10/auth/session.js';
 import { requireE10Session } from '../../internal/e10/context.js';
 import { E10ApiError, createE10RequestRuntime } from '../../internal/e10/request-runtime.js';
+import { isE10SessionExpiredResponse } from '../../internal/e10/auth-recovery.js';
 import { planStateRoot } from './continuation.js';
 import { PlanCliError, planAuthError, planNetworkError, planValidationError } from './errors.js';
 function inferProfile(ctx) {
@@ -150,7 +151,7 @@ export function createPlanHost(ctx, dependencies = {}) {
         catch (error) {
             mapRuntimeNetworkError(error);
         }
-        if (response.status === 401 || response.status === 302) {
+        if (isE10SessionExpiredResponse(response)) {
             throw planAuthError('session_expired', E10_SESSION_EXPIRED_MESSAGE, { httpStatus: response.status });
         }
         if (response.parseError) {

package/dist/shortcuts/project/host.js

@@ -2,6 +2,7 @@ import { E10_SESSION_EXPIRED_MESSAGE } from '../../internal/e10/auth/messages.js
 import { getActiveProfile } from '../../internal/e10/auth/session.js';
 import { requireE10Session } from '../../internal/e10/context.js';
 import { E10ApiError, createE10RequestRuntime } from '../../internal/e10/request-runtime.js';
+import { isE10SessionExpiredResponse } from '../../internal/e10/auth-recovery.js';
 import { ProjectCliError, projectApiError, projectAuthError, projectNetworkError, projectValidationError, } from './errors.js';
 const PROJECT_PATH_PREFIXES = [
     '/api/ebuilder/form/formdata/v2/',
@@ -133,7 +134,7 @@ export function createProjectHost(ctx, dependencies = {}) {
         catch (error) {
             mapRuntimeNetworkError(error);
         }
-        if (response.status === 401 || response.status === 302) {
+        if (isE10SessionExpiredResponse(response)) {
             throw projectAuthError('session_expired', E10_SESSION_EXPIRED_MESSAGE, {
                 httpStatus: response.status,
             });

package/dist/shortcuts/workflow/endpoints.js

@@ -161,11 +161,16 @@ export const AJAX_QUERY = { sf_request_type: 'ajax' };
  * `/api/workflow/core/` 而原样返回，导致请求路径非法。
  *
  * - WEA_FORM（工作流表单）→ 保持 `FORM_ENDPOINTS` 默认地址
- * - WEA_EBUILDER（建模表单）→ `/api/workflow/core/` 段替换为 `/api/ebuilder/flow/`
+ * - WEA_EBUILDER（建模表单）→ `/api/workflow/core/` 段替换为 `ebPrefix`
+ *
+ * ⚠️ `ebPrefix` 默认 `/api/ebuilder/flow/`，但**建模表单内部前缀不统一**，必须按接口给
+ * （均为真机请求实证）：
+ * - `getFormLayout` / `getFormDataAndLayout` / `saveFormData` → `/api/ebuilder/flow/`
+ * - `executeFdLinkage` → `/api/ebuilder/form/`
  */
-export function formApiUrl(path, relateType) {
+export function formApiUrl(path, relateType, ebPrefix = '/api/ebuilder/flow/') {
     if (String(relateType || '').trim() === 'WEA_EBUILDER') {
-        return path.replace('/api/workflow/core/', '/api/ebuilder/flow/');
+        return path.replace('/api/workflow/core/', ebPrefix);
     }
     return path;
 }