weaver-work-cli 0.1.7 → 0.1.20

package/dist/shortcuts/invoice/projection.js

@@ -0,0 +1,328 @@
+import { invoiceValidationError } from './errors.js';
+/**
+ * invoice 域的输出投影：把面向程序的完整 envelope 裁成面向阅读的视图。
+ *
+ * 背景：`invoice.list` 单条发票有 40+ 字段（`custom_field_*`、`rb`、`oa` 等对调用方无用），
+ * 10 条即 35KB。调用方要拿到"号码/金额/购销方"就得自己写解析脚本。
+ * 本模块提供三个出口，让 CLI 直接给出可读结果：
+ *
+ * - `--view summary`：语义化平表（仅 list 类 operation，字段口径与 `invoice.reim.candidates.list` 一致）
+ * - `--view detail`：单张发票的语义详情（仅 `invoice.get`），summary 字段 + 附件/费用说明/查验标记
+ * - `--fields a,b.c`：通用点路径投影，点路径必须存在于原结构（最小惊讶）
+ *
+ * 另有 `--format markdown`（见 markdown.ts）：把上面的语义视图渲染成 markdown 文本，
+ * 属于"渲染档"而非数据档，与 `--json` 互斥。
+ */
+import { assertMarkdownSupported, markdownViewFor, normalizeFormat, } from './markdown.js';
+/** `--view summary` 支持的 operation：data 结构里含发票列表 items 的读取类操作。 */
+export const SUMMARY_OPERATIONS = new Set(['invoice.list', 'invoice.enterprise.list']);
+/** `--view detail` 支持的 operation：data 结构里含 `infos[]`（每条带 info 包装）的详情类操作。 */
+export const DETAIL_OPERATIONS = new Set(['invoice.get']);
+export const OUTPUT_VIEWS = ['full', 'summary', 'detail'];
+/**
+ * summary 视图保留的语义字段。命名与 `invoice.reim.candidates.list` 的 items 对齐
+ * （`buyer` = 购买方，`payer` = 销售方），避免同一业务概念在不同 operation 里换名。
+ */
+export const SUMMARY_ITEM_FIELDS = [
+    'fid',
+    'number',
+    'code',
+    'typeName',
+    'date',
+    'amount',
+    'total',
+    'taxAmount',
+    'buyer',
+    'buyerTaxNo',
+    'payer',
+    'payerTaxNo',
+    'valid',
+    'status',
+    'reimState',
+    'reimRequests',
+    'fileName',
+    'detailUrl',
+];
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+function text(value) {
+    if (value === undefined || value === null)
+        return '';
+    return String(value).replace(/^\uFEFF/u, '').trim();
+}
+function numberOrUndefined(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+/**
+ * 把一条原始发票对象裁成语义摘要。空值（`''` / `null` / 空数组）直接省键，
+ * 票面本身就有的 `'0'`（如税额）保留，避免制造"字段不存在"的歧义。
+ */
+export function summarizeInvoiceItem(item) {
+    const comm = asRecord(item.comm_info);
+    const pro = asRecord(comm.pro);
+    const price = asRecord(comm.price);
+    const buyer = asRecord(comm.buyer);
+    const payer = asRecord(comm.payer);
+    const modify = asRecord(item.modify_info);
+    const reimList = Array.isArray(asRecord(item.oreim).list_reim) ? asRecord(item.oreim).list_reim : [];
+    const summary = {
+        fid: text(item.fid ?? item.id),
+        number: text(item.number),
+        code: text(item.code),
+        typeName: text(pro.cname),
+        date: text(pro.date),
+        amount: text(price.amount),
+        total: text(price.total),
+        taxAmount: text(price.dtax),
+        buyer: text(buyer.company),
+        buyerTaxNo: text(buyer.tcode),
+        payer: text(payer.company),
+        payerTaxNo: text(payer.tcode),
+        valid: numberOrUndefined(pro.valid),
+        status: numberOrUndefined(pro.status),
+        reimState: numberOrUndefined(pro.sreim),
+        reimRequests: reimList.map((entry) => text(asRecord(entry).name)).filter(Boolean),
+        fileName: text(modify.fname),
+        detailUrl: text(item.detailUrl),
+    };
+    for (const [key, value] of Object.entries(summary)) {
+        if (value === '' || value === undefined || value === null)
+            delete summary[key];
+        else if (Array.isArray(value) && value.length === 0)
+            delete summary[key];
+    }
+    return summary;
+}
+/** 把 list 类 data 裁成 summary 视图：列表级汇总在前，明细在后。 */
+export function summarizeListData(data) {
+    const items = Array.isArray(data.items) ? data.items : [];
+    const summary = {};
+    for (const key of ['total', 'totalAmount', 'totalAmountExcludingTax', 'hasMore', 'scope']) {
+        if (data[key] !== undefined && data[key] !== null)
+            summary[key] = data[key];
+    }
+    summary.items = items.map((item) => summarizeInvoiceItem(asRecord(item)));
+    summary.itemCount = summary.items.length;
+    return summary;
+}
+/**
+ * detail 视图比 summary 多出来的语义字段：
+ * 附件清单、票面费用说明、开票人、查验标记（`is_valid`，与票面 `valid` 不是一个口径）。
+ */
+export const DETAIL_EXTRA_FIELDS = ['expenseNote', 'issuer', 'checkState', 'attachments'];
+/** `--view detail` 下 items 的字段集：summary 语义字段 + detail 附加字段。 */
+export const DETAIL_ITEM_FIELDS = [...SUMMARY_ITEM_FIELDS, ...DETAIL_EXTRA_FIELDS];
+/** `info.ext` 是**字符串化的 JSON**（票面扩展字段），解析失败按空对象处理，不让脏数据打断输出。 */
+function parseExt(value) {
+    if (value && typeof value === 'object')
+        return asRecord(value);
+    const raw = text(value);
+    if (!raw)
+        return {};
+    try {
+        return asRecord(JSON.parse(raw));
+    }
+    catch {
+        return {};
+    }
+}
+function attachmentOf(entry) {
+    const record = asRecord(entry);
+    return {
+        id: text(record.fileId ?? record.id),
+        name: text(record.name),
+        type: text(record.type),
+    };
+}
+/**
+ * 把 `invoice.get` 的一条 `{ info, ret, is_valid, detailUrl }` 裁成语义详情。
+ * `info` 与 list 里的发票对象同形，所以直接复用 `summarizeInvoiceItem`，
+ * 避免同一业务概念在两条路径上出现两套字段口径。
+ */
+export function summarizeInvoiceDetailItem(wrapper) {
+    const info = asRecord(wrapper.info);
+    const detail = {
+        ...summarizeInvoiceItem({
+            ...info,
+            detailUrl: info.detailUrl ?? wrapper.detailUrl,
+        }),
+    };
+    const ext = parseExt(info.ext);
+    const expenseNote = text(ext.expenseDesc);
+    if (expenseNote)
+        detail.expenseNote = expenseNote;
+    const issuer = text(ext.issuer);
+    if (issuer)
+        detail.issuer = issuer;
+    // `is_valid` 是查验标记（0=未做过查验登记），与票面 `valid`（票面有效性）不是一个口径，
+    // 必须分开命名，否则调用方会把 0 误读成"这张票无效"。
+    if (typeof wrapper.is_valid === 'number')
+        detail.checkState = wrapper.is_valid;
+    const attachments = (Array.isArray(info.flist) ? info.flist : [])
+        .map(attachmentOf)
+        .filter((attachment) => attachment.id || attachment.name);
+    if (attachments.length)
+        detail.attachments = attachments;
+    return detail;
+}
+/** 把 `invoice.get` 的 data 裁成 detail 视图：保持 items 命名，与 list 视图一致。 */
+export function summarizeDetailData(data) {
+    const infos = Array.isArray(data.infos) ? data.infos : [];
+    const detail = {};
+    if (data.scope !== undefined && data.scope !== null)
+        detail.scope = data.scope;
+    detail.items = infos.map((entry) => summarizeInvoiceDetailItem(asRecord(entry)));
+    detail.itemCount = detail.items.length;
+    return detail;
+}
+function readPath(source, path) {
+    let current = source;
+    for (const segment of path.split('.')) {
+        if (current === null || typeof current !== 'object' || Array.isArray(current)) {
+            return { found: false, value: undefined };
+        }
+        if (!Object.prototype.hasOwnProperty.call(current, segment)) {
+            return { found: false, value: undefined };
+        }
+        current = current[segment];
+    }
+    return { found: true, value: current };
+}
+function writePath(target, path, value) {
+    const segments = path.split('.');
+    let node = target;
+    for (const segment of segments.slice(0, -1)) {
+        if (!node[segment] || typeof node[segment] !== 'object')
+            node[segment] = {};
+        node = node[segment];
+    }
+    node[segments[segments.length - 1]] = value;
+}
+/** 按点路径重建嵌套结构，保持与原 JSON 一致的形状。 */
+export function pickPaths(source, fields) {
+    const picked = {};
+    const missing = [];
+    for (const field of fields) {
+        const { found, value } = readPath(source, field);
+        if (found)
+            writePath(picked, field, value);
+        else
+            missing.push(field);
+    }
+    return { picked, missing };
+}
+export function normalizeFields(value) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    const fields = String(value)
+        .split(',')
+        .map((item) => item.trim())
+        .filter(Boolean);
+    if (!fields.length) {
+        throw invoiceValidationError('input_invalid', '--fields 必须至少包含一个字段路径');
+    }
+    return fields;
+}
+export function normalizeView(value) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    const view = String(value).trim();
+    if (!OUTPUT_VIEWS.includes(view)) {
+        throw invoiceValidationError('view_invalid', `--view 只支持 ${OUTPUT_VIEWS.join(' / ')}`);
+    }
+    return view;
+}
+/**
+ * 把投影参数解析成"最终生效的视图"。`--format markdown` 是渲染档，
+ * 自带字段口径，因此由 operation 决定视图（list 类 → summary，详情类 → detail）；
+ * 此时若显式传了别的视图属于口径冲突，直接报错而不是悄悄忽略。
+ */
+export function resolveView(operation, projection) {
+    const { view, fields, format } = projection;
+    if (format !== 'markdown')
+        return view ?? 'full';
+    assertMarkdownSupported(operation, format);
+    const expected = markdownViewFor(operation);
+    if (fields?.length) {
+        throw invoiceValidationError('input_conflict', '--format markdown 自带字段口径，不接受 --fields；要自定义字段请用 --fields 输出 JSON');
+    }
+    if (view && view !== expected) {
+        throw invoiceValidationError('input_conflict', `--format markdown 固定使用 ${expected} 视图，与 --view ${view} 冲突`);
+    }
+    return expected;
+}
+/** 供 CLI 侧解析 `--format`。 */
+export function formatFrom(value) {
+    return normalizeFormat(value);
+}
+/**
+ * 在发起业务请求**之前**校验投影参数是否可用。
+ * 参数写错就该立刻反馈，而不是先打一次网络请求再报 view_unsupported ——
+ * 否则认证失败/网络慢的场景会让人误以为"操作失败"而非"参数不支持"。
+ */
+export function assertProjectionSupported(operation, projection) {
+    const { view, fields } = projection;
+    if (view && fields?.length) {
+        throw invoiceValidationError('input_conflict', '不能同时传 --view 和 --fields');
+    }
+    if (view === 'summary' && !SUMMARY_OPERATIONS.has(operation)) {
+        throw invoiceValidationError('view_unsupported', `${operation} 不支持 --view summary（仅 ${[...SUMMARY_OPERATIONS].join('、')}）`);
+    }
+    if (view === 'detail' && !DETAIL_OPERATIONS.has(operation)) {
+        throw invoiceValidationError('view_unsupported', `${operation} 不支持 --view detail（仅 ${[...DETAIL_OPERATIONS].join('、')}）`);
+    }
+    // 渲染档的可用性与冲突同样要在请求前判掉（resolveView 内含格式白名单校验）。
+    resolveView(operation, projection);
+}
+/**
+ * 应用投影。返回新的 data 与要写进 envelope `meta` 的说明，
+ * 让调用方知道输出被裁剪过、以及是否有写错的字段路径。
+ */
+export function applyInvoiceProjection(operation, data, projection) {
+    assertProjectionSupported(operation, projection);
+    const { fields } = projection;
+    const view = resolveView(operation, projection);
+    const activeMeta = (base) => ({
+        projection: { view, ...base },
+    });
+    if (view === 'summary') {
+        return {
+            data: summarizeListData(data),
+            meta: activeMeta({ omittedEmpty: true }),
+        };
+    }
+    if (view === 'detail') {
+        return {
+            data: summarizeDetailData(data),
+            meta: activeMeta({ omittedEmpty: true }),
+        };
+    }
+    if (fields?.length) {
+        const targets = Array.isArray(data.items) ? data.items : [data];
+        const missingSet = new Set(fields);
+        const projected = targets.map((target) => {
+            const { picked, missing } = pickPaths(asRecord(target), fields);
+            for (const field of fields) {
+                if (!missing.includes(field))
+                    missingSet.delete(field);
+            }
+            return picked;
+        });
+        const missingFields = [...missingSet];
+        if (missingFields.length === fields.length) {
+            throw invoiceValidationError('field_not_found', `--fields 在 ${operation} 的输出里全部未命中：${fields.join(',')}`, { fields });
+        }
+        const projectedData = Array.isArray(data.items)
+            ? { ...data, items: projected }
+            : projected[0];
+        return {
+            data: projectedData,
+            meta: activeMeta({
+                fields,
+                ...(missingFields.length ? { missingFields } : {}),
+            }),
+        };
+    }
+    return { data };
+}

package/dist/shortcuts/meeting/host.js

@@ -32,11 +32,27 @@ export function businessMessage(value) {
         value.actionMsg?.msg,
         value.data?.message,
         value.data?.msg,
+        // EB（eBuilder formdata）把业务提示放在 datajson 内层：漏掉它时 EB 失败只剩一句
+        // “泛微接口返回业务失败”，真实原因（字段/权限/参数）全丢，排查成本极高。
+        value.datajson?.msg,
+        value.datajson?.message,
+        value.datajson?.errMsg,
+        value.datajson?.errorMsg,
+        value.datajson?.errorMessage,
     ];
     for (const item of candidates) {
         if (typeof item === 'string' && item.trim())
             return item;
     }
+    // 兜底：返回响应原文摘要，避免完全无法定位的报错。
+    try {
+        const raw = JSON.stringify(value);
+        if (raw && raw !== '{}' && raw !== 'null')
+            return `泛微接口返回业务失败：${raw.slice(0, 300)}`;
+    }
+    catch {
+        // 忽略序列化异常，走默认文案
+    }
     return '泛微接口返回业务失败';
 }
 function businessCode(value) {
@@ -145,7 +161,8 @@ export function createMeetingHost(ctx, dependencies = {}) {
                 exitCode: 1,
             });
         }
-        if (!isBusinessSuccess(response.value)) {
+        const acceptBusiness = request.acceptBusiness ?? isBusinessSuccess;
+        if (!acceptBusiness(response.value)) {
             const code = businessCode(response.value);
             const message = businessMessage(response.value);
             if (code === 403) {

package/dist/shortcuts/meeting/manifest.js

@@ -1,23 +1,31 @@
 import { meetingOperationDefinitions } from './operations/registry.js';
 /**
+ * 双模式（两套独立接口，路由由 meeting.env.detect 决定：EB 优先，失败回退标准版）：
+ * - 标准版（Java REST，`/api/meeting/**`）：meeting.list / create / change / cancel / delete /
+ *   receipt / sign.list / sign.mark|back|clear 等，查询与写操作均走标准版契约。
+ * - EB 版（eBuilder formdata，`/api/ebuilder/form/formdata/v2/**`，实现见 operations/eb/）：
+ *   meeting.eb.* 覆盖 EB 版全部 interfacePk —— 会议 6.x / 会议室 2.x / 占用 5.x / 签到 1.x /
+ *   回执 4.x / 纪要 3.x / 会议类型 3.5 / 议题类型 8.x / 会议议题 9.x / 应用设置 7.x；
+ *   读操作单 operation（list 会先 count 再 list），写操作 prepare→apply 确认链。
+ *   **建会 / 变更的 prepare 会先自动执行会议室与参会人冲突检测**（策略取应用设置
+ *   room_conflict_chk/room_conflict、member_conflict_chk/member_conflict：命中禁止提交直接拒绝、
+ *   仅提醒只给 warnings、检测失败 fail-closed）；另提供只读的 meeting.eb.conflict.room /
+ *   meeting.eb.conflict.member（后者为 2 次请求方案，无 N+1）。
+ *   判定 eb 用 meeting.eb.*，判定 standard 用标准版 operations。
+ *
  * 未实现能力（禁用边界，不得编造或绕过）：
- * - EB 版业务链路（query_mtDetail_list / create_meeting / 三件套 / 议题 / 纪要 / 报表）：
- *   依赖 eBuilder formdata 动态字段与工作流集成，未随 v1 实现。
  * - 周期会议走工作流（repeatWorkFlowBaseIds 非空）与 onlyFlowCreate=1 的流程建会：
- *   需要 workflow 集成，create.prepare 会主动拒绝并提示。
+ *   需要 workflow 集成，create.prepare 会主动拒绝并提示（EB 版可据 baseSet 的 only_flow_create 判断）。
  * - 提前结束会议（meeting.over）：服务端为空实现（假成功），CLI 不提供。
- * - 签到二维码（getQrCode 入参契约未确认）、签到写操作（signMeeting 等）、
- *   会议室/会议类型管理（add/update/delete/lock/详情）：待后续版本评估。
+ * - 本人扫码签到（signMeeting）：依赖现场二维码票据（qrticket）与设备 IP，AI 代签会破坏
+ *   签到真实性，不提供；请引导用户现场扫码或在会议页面操作。
+ * - 回收站（列表/还原/强制还原）、签到二维码与大屏签到、EB 版纪要创建（走 OpenAPI 无自定义接口）：待评估。
+ * - **标准版**会议室/会议类型管理接口未实现；EB 版用 meeting.eb.room.* / meeting.eb.type.*。
  *
- * 已实现的生命周期写操作：meeting.change（变更：按会议状态自动选 operateType，
- * 草稿=UPDATE / 正常=CHANGE）、meeting.cancel（取消）、meeting.delete（彻底删除），
- * 均走 prepare→apply 确认链。权限由服务端按会议状态判定并返回原文提示，CLI 原样透传。
+ * 权限由服务端按会议状态判定并返回原文提示（如“您没有变更权限！”），CLI 原样透传。
+ * delete 为软删（mt_detail.delete_type = 2，进回收站可还原），CLI 暂无还原能力。
  */
 const WITHHELD = [
-    {
-        name: 'meeting.eb.*',
-        reason: 'EB 版业务链路依赖 eBuilder formdata 动态字段结构与工作流集成，v1 未实现；请使用 EB 版独立流程或后续版本。',
-    },
     {
         name: 'meeting.create.workflow',
         reason: 'onlyFlowCreate=1 或周期会议配置工作流时必须走流程建会；CLI v1 未集成工作流发起，create.prepare 会主动拒绝。',
@@ -28,15 +36,19 @@ const WITHHELD = [
     },
     {
         name: 'meeting.sign.qrcode',
-        reason: '签到二维码接口（getQrCode）入参契约未在源资料中确认，未实现，不得猜测参数。',
+        reason: '签到二维码（getQrCode / downLoadQrCode）与大屏签到未实现：入参契约未确认且属大屏/扫码场景，不得猜测参数。',
+    },
+    {
+        name: 'meeting.sign.scan',
+        reason: '本人扫码签到（signMeeting）不提供：依赖现场二维码票据（qrticket）与设备 IP，由 AI 代签会破坏签到真实性；请引导用户现场扫码或走 H5 签到。补签/补签退/清除签到请用 meeting.sign.mark/back/clear（需确认链）。',
     },
     {
-        name: 'meeting.sign.submit',
-        reason: '签到写操作（signMeeting 等）未实现，不得绕过确认链直接调用。',
+        name: 'meeting.recycle.*',
+        reason: '回收站（getMeetingRecycleList / restoreMeetingRecycle / forceRestoreMeetingRecycle / cleanMeetingRecycleList）未实现。注意 delete 是软删（mt_detail.delete_type=2，会议进回收站可还原），CLI 暂无还原能力，如需恢复请引导用户到会议回收站页面操作。',
     },
     {
         name: 'meeting.room.admin / meeting.type.admin',
-        reason: '会议室/会议类型管理（add/update/delete/lock/详情）未实现，待后续版本评估。',
+        reason: '**标准版**会议室/会议类型管理接口（add/update/delete/lock）未实现；EB 版请用 meeting.eb.room.create/update/delete 与 meeting.eb.type.create/delete。',
     },
 ];
 function buildOperations() {
@@ -53,12 +65,12 @@ function buildOperations() {
 export const meetingManifest = {
     schemaVersion: 1,
     name: 'meeting',
-    title: '泛微E10会议管理（标准版：查询/冲突/预约/取消/回执/签到）',
+    title: '泛微E10会议管理（双模式：标准版 Java REST + EB 版 eBuilder）',
     version: '1.0.0',
     host: 'e10-meeting',
     status: 'builtin',
     sourceSkill: 'weaver-e10-meeting',
-    capabilities: ['env', 'meeting', 'room', 'type', 'conflict', 'lifecycle', 'receipt', 'sign'],
+    capabilities: ['env', 'meeting', 'room', 'type', 'conflict', 'lifecycle', 'receipt', 'sign', 'eb'],
     operations: buildOperations(),
     withheldOperations: WITHHELD,
 };