weaver-work-cli 0.1.42 → 0.1.44

package/dist/shortcuts/invoice/manifest.js

@@ -1,5 +1,5 @@
+import { FULL_EXT_MASK } from './invoice-record.js';
 import { DETAIL_ITEM_FIELDS, OUTPUT_VIEWS, SUMMARY_ITEM_FIELDS } from './projection.js';
-import { OUTPUT_FORMATS } from './markdown.js';
 function objectSchema(properties, required = [], additionalProperties = false) {
     return {
         type: 'object',
@@ -35,10 +35,15 @@ function epochEndDateProperty(label) {
 }
 const listProperties = {
     page_size: { type: 'integer', minimum: 1, maximum: 200 },
-    start_pos: { type: 'integer', minimum: 0 },
+    start_pos: { type: 'integer', minimum: 0, description: '服务端分页偏移。翻页时按 page_size 递增，不要按返回的 items 条数递增（items 已剔除全额红冲票，可能不满一页）。' },
     req_type: { type: 'integer', enum: [0, 1, 7, 8] },
     mask: { type: 'integer', minimum: 0 },
-    mext: { type: 'integer', minimum: 0 },
+    mext: {
+        type: 'integer',
+        minimum: 0,
+        default: FULL_EXT_MASK,
+        description: `按位选择返回哪些 ext 字段（1=trate、2=ttax …）；不传按 ${FULL_EXT_MASK} 返回完整 ext（费用说明、城市、备注、起止地等），传 0 不返回 ext。`,
+    },
     content: { type: 'string' },
     types: { type: 'array', items: { type: 'integer' } },
     date_begin: epochDateProperty('开票日期起（含）'),
@@ -90,94 +95,6 @@ const listProperties = {
 const positiveId = { type: 'string', pattern: '^[1-9]\\d*$' };
 const positiveIdArray = { type: 'array', minItems: 1, maxItems: 100, items: positiveId };
 const jsonObject = { type: 'object', additionalProperties: true };
-const reimFieldValue = {
-    type: 'object',
-    additionalProperties: false,
-    properties: {
-        fieldId: { type: 'string', minLength: 1 },
-        fieldName: { type: 'string' },
-        value: {},
-        optionValue: {},
-        unable_to_fill: { type: 'boolean' },
-        need_search: { type: 'boolean' },
-    },
-    required: ['fieldId'],
-};
-const reimNeedUserConfirm = {
-    type: 'object',
-    additionalProperties: false,
-    properties: {
-        fieldId: { type: 'string', minLength: 1 },
-        fieldName: { type: 'string' },
-        dataIndex: { type: ['integer', 'null'], minimum: 1 },
-        reason: { type: 'string', minLength: 1 },
-        candidates: {
-            type: 'array',
-            items: {
-                type: 'object',
-                additionalProperties: true,
-                properties: {
-                    id: { type: 'string', minLength: 1 },
-                    name: { type: 'string' },
-                },
-            },
-        },
-    },
-    required: ['fieldId', 'reason'],
-};
-const reimUnableToFill = {
-    type: 'object',
-    additionalProperties: false,
-    properties: {
-        fieldId: { type: 'string', minLength: 1 },
-        fieldName: { type: 'string' },
-        dataIndex: { type: ['integer', 'null'], minimum: 1 },
-        reason: { type: 'string', minLength: 1 },
-    },
-    required: ['fieldId', 'reason'],
-};
-const reimDetailRow = {
-    type: 'object',
-    additionalProperties: false,
-    properties: {
-        dataIndex: { type: 'integer', minimum: 1 },
-        subFormId: { type: 'string', minLength: 1 },
-        invoiceId: { type: 'string', minLength: 1 },
-        fields: { type: 'array', items: reimFieldValue },
-    },
-    required: ['dataIndex', 'subFormId', 'invoiceId', 'fields'],
-};
-const reimFlowCreateProperties = {
-    work_flow_id: { type: 'string', minLength: 1, description: '目标报销流程的工作流 ID。' },
-    mainFormId: { type: 'string', minLength: 1, description: '报销单主表 formId，来自 invoice.reim.form.structure。' },
-    request_name: { type: 'string', minLength: 1, description: '流程标题。' },
-    main_fields: { type: 'array', items: reimFieldValue, description: '主表字段值列表。' },
-    detail_rows: { type: 'array', minItems: 1, items: reimDetailRow, description: '明细表行数据。' },
-    need_user_confirm: { type: 'array', items: reimNeedUserConfirm, description: '需用户确认的字段。' },
-    unable_to_fill: { type: 'array', items: reimUnableToFill, description: '无法自动填写的字段。' },
-};
-const reimFlowCreateRequired = ['work_flow_id', 'mainFormId', 'request_name', 'main_fields', 'detail_rows'];
-const reimFlowUpdateProperties = {
-    requestId: { type: 'string', minLength: 1, description: '要更新的流程 requestId。' },
-    mainFormId: { type: 'string', minLength: 1, description: '报销单主表 formId。' },
-    main_fields: { type: 'array', minItems: 1, items: reimFieldValue, description: '需要更新的主表字段列表。' },
-    detail_rows: { type: 'array', minItems: 1, items: reimDetailRow, description: '需要更新或新增的明细行数据。' },
-    deleteDetailRows: {
-        type: 'array',
-        minItems: 1,
-        items: {
-            type: 'object',
-            additionalProperties: true,
-            properties: {
-                detailId: { type: 'string', minLength: 1 },
-                dataIndex: { type: 'integer', minimum: 1 },
-            },
-        },
-        description: '需要删除的明细行。',
-    },
-    need_user_confirm: { type: 'array', items: reimNeedUserConfirm, description: '需用户确认的字段。' },
-    unable_to_fill: { type: 'array', items: reimUnableToFill, description: '无法自动填写的字段。' },
-};
 const rawValue = { description: '服务端原始字段，类型随接口返回而定。' };
 const rawObject = objectSchema({}, [], true);
 const rawArray = arrayOf(rawObject);
@@ -335,12 +252,30 @@ const resultEnvelopeOutput = (dataSchema = rawValue) => objectSchema({
     data: dataSchema,
     workflow: workflowSchema,
 }, ['result', 'data', 'workflow']);
+const extInfoSchema = objectSchema({
+    expenseNote: { type: 'string', description: '费用说明（ext.expenseDesc），如「上海-武汉」' },
+    content: { type: 'string', description: '消费内容（ext.content；为空时取 ext.products[].name）' },
+    city: { type: 'string', description: '城市（ext.city）' },
+    province: { type: 'string', description: '省份（ext.province，为空时取票面 province）' },
+    comment: { type: 'string', description: '备注（ext.comment），常写出差地、订单号和行程' },
+    from: { type: 'string', description: '出发地（ext.from → 票面 from → ext.passengersService[0].from）' },
+    to: { type: 'string', description: '到达地（ext.to → 票面 to → ext.passengersService[0].to）' },
+    stationGetOn: { type: 'string', description: '上车站（ext.station_geton）' },
+    stationGetOff: { type: 'string', description: '下车站（ext.station_getoff）' },
+});
+const listInvoiceItemSchema = {
+    ...invoiceInfoSchema,
+    properties: {
+        ...invoiceInfoSchema.properties,
+        extInfo: { ...extInfoSchema, description: '已解析的 ext 语义字段，空值省键；原始 ext 字符串仍保留' },
+    },
+};
 const listOutputSchema = objectSchema({
-    items: arrayOf(invoiceInfoSchema),
-    total: { type: 'integer' },
-    totalAmount: { type: 'string' },
-    totalAmountExcludingTax: { type: 'string' },
-    hasMore: { type: 'boolean' },
+    items: arrayOf(listInvoiceItemSchema, { description: '本页发票，已剔除全额红冲票（comm_info.pro.status=8），条数可能少于 page_size。' }),
+    total: { type: 'integer', description: '服务端汇总的总张数，含 items 里已剔除的全额红冲票。' },
+    totalAmount: { type: 'string', description: '服务端汇总的价税合计，含已剔除的全额红冲票。' },
+    totalAmountExcludingTax: { type: 'string', description: '服务端汇总的不含税合计，含已剔除的全额红冲票。' },
+    hasMore: { type: 'boolean', description: '是否还有下一页。判断是否翻页只看它，不要用 items 条数是否等于 page_size 推断。' },
     scope: { type: 'string', enum: ['personal', 'enterprise'] },
 }, ['items', 'total', 'totalAmount', 'totalAmountExcludingTax', 'hasMore', 'scope']);
 /**
@@ -349,12 +284,12 @@ const listOutputSchema = objectSchema({
  */
 const summaryOutputView = {
     name: 'summary',
-    description: '语义化平表，省略空值字段；列表级汇总在前、items 在后，并附 itemCount。用 CLI 的 --view summary 启用。',
+    description: '语义化平表，省略空值字段；列表级汇总在前、items 在后，并附 itemCount。含 ext 里的 expenseNote（费用说明）、content、city、province、comment（备注）、from / to、stationGetOn / stationGetOff。用 CLI 的 --view summary 启用。',
     itemFields: SUMMARY_ITEM_FIELDS,
 };
 const detailOutputView = {
     name: 'detail',
-    description: '单张发票的语义详情：summary 字段，外加 attachments（附件清单）、expenseNote（费用说明）、issuer（开票人）、checkState（查验标记，0=未查验，与票面 valid 不是一个口径）。用 CLI 的 --view detail 启用。',
+    description: '单张发票的语义详情：summary 字段（含 ext 的费用说明、城市、备注、起止地等），外加 attachments（附件清单）、issuer（开票人）、checkState（查验标记，0=未查验，与票面 valid 不是一个口径）。用 CLI 的 --view detail 启用。',
     itemFields: DETAIL_ITEM_FIELDS,
 };
 const uploadOutputSchema = objectSchema({
@@ -504,34 +439,6 @@ const workflowResolveDataSchema = objectSchema({
         workFlowName: { type: 'string' },
     }, ['workFlowId', 'workFlowName'])),
 }, [], true);
-const reimFieldOptionSchema = objectSchema({
-    optionId: { type: 'string' },
-    optionName: { type: 'string' },
-    optionValue: { type: 'string' },
-}, [], true);
-const reimFormFieldSchema = objectSchema({
-    fieldId: { type: 'string' },
-    fieldName: { type: 'string' },
-    fieldType: { type: 'string' },
-    single: { type: 'boolean' },
-    marked: { type: 'boolean' },
-    options: arrayOf(reimFieldOptionSchema),
-}, ['fieldId', 'fieldName', 'fieldType'], true);
-const formStructureDataSchema = objectSchema({
-    mainFormId: { type: 'string' },
-    mainFields: arrayOf(reimFormFieldSchema),
-    subTables: arrayOf(objectSchema({
-        subFormId: { type: 'string' },
-        subFormName: { type: 'string' },
-        subFields: arrayOf(reimFormFieldSchema),
-    }, ['subFormId', 'subFields'], true)),
-}, ['mainFormId', 'mainFields', 'subTables'], true);
-const rowInfoDataSchema = objectSchema({
-    date: { type: 'string' },
-    fysm: { type: 'string' },
-    itinerary: { type: 'string' },
-    subjectId: { type: 'string' },
-}, [], true);
 const employeeSchema = objectSchema({
     id: { type: 'string' },
     name: { type: 'string' },
@@ -546,32 +453,6 @@ const fieldSearchItemSchema = objectSchema({
     value: { type: 'string' },
 }, ['id', 'name'], true);
 const fieldSearchItemsSchema = arrayOf(fieldSearchItemSchema);
-const flowPreviewOutputSchema = objectSchema({
-    requestName: { type: 'string' },
-    workflowId: { type: 'string' },
-    mainFormId: { type: 'string' },
-    mainFieldCount: { type: 'integer' },
-    detailRowCount: { type: 'integer' },
-}, ['requestName', 'workflowId', 'mainFormId', 'mainFieldCount', 'detailRowCount']);
-const flowUpdatePreviewOutputSchema = objectSchema({
-    requestId: { type: 'string' },
-    mainFormId: { type: 'string' },
-    mainFieldCount: { type: 'integer' },
-    detailRowCount: { type: 'integer' },
-    deleteDetailRowCount: { type: 'integer' },
-}, ['requestId', 'mainFormId', 'mainFieldCount', 'detailRowCount', 'deleteDetailRowCount']);
-const flowCreateApplyOutputSchema = objectSchema({
-    requestId: { type: 'string' },
-    requestName: { type: 'string' },
-    viewUrl: { type: 'string', format: 'uri' },
-    result: rawObject,
-    workflow: workflowSchema,
-}, ['requestId', 'requestName', 'viewUrl', 'result', 'workflow']);
-const flowUpdateApplyOutputSchema = objectSchema({
-    requestId: { type: 'string' },
-    result: rawObject,
-    workflow: workflowSchema,
-}, ['requestId', 'result', 'workflow']);
 const reimCandidateItemSchema = objectSchema({
     fid: { type: 'string' },
     number: { type: 'string' },
@@ -590,114 +471,63 @@ const reimCandidatesOutputSchema = objectSchema({
     hasMore: { type: 'boolean' },
     available: arrayOf(reimCandidateItemSchema),
     assigned: arrayOf(reimCandidateItemSchema),
-    redReversed: arrayOf(reimCandidateItemSchema),
     summary: objectSchema({
         availableCount: { type: 'integer' },
         assignedCount: { type: 'integer' },
-        redReversedCount: { type: 'integer' },
         availableAmount: { type: 'string' },
         assignedAmount: { type: 'string' },
-        redReversedAmount: { type: 'string' },
-        filteredRedReversedCount: { type: 'integer' },
-    }, ['availableCount', 'assignedCount', 'redReversedCount', 'availableAmount', 'assignedAmount', 'redReversedAmount', 'filteredRedReversedCount']),
+    }, ['availableCount', 'assignedCount', 'availableAmount', 'assignedAmount']),
     warnings: arrayOf({ type: 'string' }),
     workflow: workflowSchema,
-}, ['total', 'fetched', 'hasMore', 'available', 'assigned', 'redReversed', 'summary', 'warnings', 'workflow']);
-const reimTemplateInputProperties = {
-    invoiceIds: { type: 'array', minItems: 1, maxItems: 100, items: positiveId, description: '用于报销的发票 fid 列表，将作为明细行顺序。' },
-    requestName: { type: 'string', minLength: 1, maxLength: 100, description: '报销单标题。' },
-    workflowId: { ...positiveId, description: `目标报销流程工作流 ID。不传时自动解析唯一候选；当前模板固化映射对应的流程为 ${'100003460000000060'}（总部费用报销）。` },
-    reason: { type: 'string', maxLength: 500, description: '报销事由，缺省使用 requestName。' },
-    relatedCustomerId: { ...positiveId, description: '相关客户 ID（非出差场景）。缺省留空并产生 warning。' },
-    relatedCustomerName: { type: 'string', minLength: 1, maxLength: 200, description: '相关客户名称。只传名称时会反查 ID；与 relatedCustomerId 同时传时只用于渲染预览中文名，不额外请求。' },
-    contractNo: { type: 'string', minLength: 1, maxLength: 100, description: '合同号。未传入时默认使用 "20260999"，不再留空。' },
-};
-const reimPreviewLabeledFieldSchema = objectSchema({
-    fieldId: { type: 'string' },
-    fieldName: { type: 'string' },
-    value: { type: 'string' },
-    optionValue: { type: 'string' },
-    text: { type: 'string', description: '已渲染的「中文(id)」文本，可直接展示。' },
-});
-const reimPreviewLabeledRowSchema = objectSchema({
-    dataIndex: { type: 'integer' },
-    invoiceId: { type: 'string' },
-    invoiceNumber: { type: 'string' },
-    amount: { type: 'string' },
-    expenseNote: { type: 'string' },
-    subject: { type: 'string', description: '费用科目，已渲染成「中文(id)」。' },
-    currency: { type: 'string', description: '币种，已渲染成「中文(id)」。' },
-});
-const reimTemplatePreviewSchema = objectSchema({
-    ...flowPreviewOutputSchema.properties,
-    totalAmount: { type: 'string' },
-    invoiceCount: { type: 'integer' },
-    mainFields: arrayOf(reimPreviewLabeledFieldSchema, { description: '主表字段的可读渲染，字典类 ID 已带中文名。' }),
-    detailRows: arrayOf(reimPreviewLabeledRowSchema, { description: '明细行的可读渲染，科目/币种已带中文名。' }),
-    unresolvedLabels: arrayOf({ type: 'string' }, { description: '未能取到中文名的 ID 清单。' }),
-}, ['requestName', 'workflowId', 'mainFormId', 'mainFieldCount', 'detailRowCount', 'totalAmount', 'invoiceCount', 'mainFields', 'detailRows', 'unresolvedLabels']);
-const reimTemplatePayloadSchema = objectSchema(reimFlowCreateProperties, [...reimFlowCreateRequired]);
-const reimLabelsSchema = objectSchema({
-    workflow: objectSchema({ id: { type: 'string' }, name: { type: 'string' } }),
-    mainFormId: { type: 'string' },
-    detailSubForm: objectSchema({ id: { type: 'string' }, name: { type: 'string' } }),
-    employees: { type: 'object', additionalProperties: { type: 'string' } },
-    subjects: { type: 'object', additionalProperties: { type: 'string' } },
-    currencies: { type: 'object', additionalProperties: { type: 'string' } },
-    customers: { type: 'object', additionalProperties: { type: 'string' } },
-    selectOptions: { type: 'object', additionalProperties: { type: 'object', additionalProperties: { type: 'string' } } },
-    customer: { type: ['object', 'null'], additionalProperties: true },
-    unresolved: arrayOf({ type: 'string' }),
-}, ['workflow', 'employees', 'subjects', 'currencies', 'customers', 'selectOptions', 'unresolved']);
-const reimTemplateBuildOutputSchema = objectSchema({
-    payload: reimTemplatePayloadSchema,
-    preview: reimTemplatePreviewSchema,
-    labels: reimLabelsSchema,
-    warnings: arrayOf({ type: 'string' }),
-    workflow: workflowSchema,
-}, ['payload', 'preview', 'labels', 'warnings', 'workflow']);
-const reimAutoPrepareOutputSchema = continuationPreviewOutput(reimTemplatePreviewSchema, {
-    payload: reimTemplatePayloadSchema,
-    labels: reimLabelsSchema,
-    warnings: arrayOf({ type: 'string' }),
-});
+}, ['total', 'fetched', 'hasMore', 'available', 'assigned', 'summary', 'warnings', 'workflow']);
 const nullableText = { type: ['string', 'null'] };
-const qysListOutputSchema = objectSchema({
-    items: arrayOf(objectSchema({
-        issuable: { type: 'boolean' },
-        blockers: arrayOf({ type: 'string' }),
-    }, ['formDataId', 'issuable', 'blockers'], true)),
-    groups: arrayOf(objectSchema({
-        contractNo: { type: 'string' },
-        contractFlowId: { type: 'string', description: '台账「合同审批流程」的流程 ID，用于填开票流程的「相关合同审批流程」' },
-        contractFlowName: { type: 'string' },
-        purchaserName: { type: 'string' },
-        purchaserTaxNo: { type: 'string' },
-        purchaserBankName: { type: 'string', description: '购方开户行名称；台账把名称写进账号列时已拆出' },
-        purchaserBankAccount: { type: 'string', description: '购方开户行账号（只含账号）；台账混写时已去掉开户行名称' },
-        invoiceTypes: arrayOf({ type: 'string' }),
-        specialInvoiceWithoutTaxNo: { type: 'boolean', description: '购方无税号但台账发票类型是专票；为 true 时不能发起开票流程，需先在台账改为普票' },
-        goodsNames: arrayOf({ type: 'string' }),
-        taxRates: arrayOf({ type: 'string' }),
-        specifications: arrayOf({ type: 'string' }, { description: '可开票行“规格型号”去重（开票流程主表“所售产品版本号”取此值）' }),
-        sellerNames: arrayOf({ type: 'string' }, { description: '台账“核算公司”去重，即所属公司（销售方）；空名称不计入。用于选择开票流程' }),
-        rowCount: { type: 'integer' },
-        formDataIds: arrayOf({ type: 'string' }),
-        totalAmount: { type: 'string', description: '可开票行“开票金额”合计，按分累加（开票流程按含税金额使用）' },
-        blockedRows: { type: 'integer', description: '同组已开票、开票中或已废弃的行数' },
-        warnings: arrayOf({ type: 'string' }),
-    }, ['contractNo', 'purchaserName', 'purchaserBankName', 'purchaserBankAccount', 'rowCount', 'formDataIds', 'totalAmount', 'blockedRows', 'specialInvoiceWithoutTaxNo', 'warnings'])),
-    matched: { type: 'integer' },
-    truncated: { type: 'boolean' },
-    scanned: { type: 'integer' },
-    scanComplete: { type: 'boolean' },
-}, ['items', 'groups', 'matched', 'truncated', 'scanned', 'scanComplete']);
+const issuingContractsOutputSchema = objectSchema({
+    cards: arrayOf(objectSchema({
+        requestId: { type: 'string', description: '合同审批流程的 requestId' },
+        invoiced: { type: 'boolean', description: '合同虚拟表查不到开票明细时为 true（已开票）；有明细为 false（待开票）' },
+        contractNo: { ...nullableText, description: '合同号；已开票时为 null' },
+        customerName: { ...nullableText, description: '客户（购方）名称；已开票时为 null' },
+        buyerTaxNo: { ...nullableText, description: '购方税号' },
+        sellerName: { ...nullableText, description: '销售方名称' },
+        invoiceAmount: { ...nullableText, description: '开票金额：全部明细金额之和，两位小数；已开票时为 null' },
+        invoiceGroups: arrayOf(objectSchema({
+            group: { ...nullableText, description: '分组标识' },
+            amount: { type: 'string', description: '该分组明细金额之和，两位小数' },
+            items: arrayOf(objectSchema({
+                name: { ...nullableText, description: '开票项目，如 技术服务费' },
+                amount: { type: 'string' },
+            }, ['name', 'amount'])),
+        }, ['group', 'amount', 'items'])),
+    }, ['requestId', 'invoiced', 'contractNo', 'customerName', 'invoiceAmount', 'invoiceGroups'], true)),
+    count: { type: 'integer' },
+    pendingCount: { type: 'integer', description: '待开票（invoiced=false）条数' },
+    invoicedCount: { type: 'integer', description: '已开票（invoiced=true）条数' },
+}, ['cards', 'count', 'pendingCount', 'invoicedCount']);
+const issuingContractDetailOutputSchema = objectSchema({
+    requestId: { type: 'string', description: '合同审批流程 requestId' },
+    requestName: { ...nullableText, description: '合同审批流程标题' },
+    workflowName: { ...nullableText, description: '合同审批流程所属工作流' },
+    customer: {
+        type: ['object', 'null'],
+        additionalProperties: false,
+        required: ['id', 'name'],
+        properties: { id: { type: 'string' }, name: { type: 'string' } },
+        description: '客户：取「客户名称」，没有时取「最终用户卡片」；开票申请「合同客户」填这个 {id, name}',
+    },
+    customerSource: { ...nullableText, description: 'customer 取自哪个字段：客户名称 / 最终用户卡片' },
+    contractDocuments: arrayOf(objectSchema({
+        docId: { ...nullableText, description: '文档 id。开票申请「合同文本」与合同流程一样传 {id, name}，id 用这个值' },
+        fileId: nullableText,
+        name: { ...nullableText, description: '文件名。开票申请「合同文本」的 name 用这个值' },
+    }, ['docId', 'fileId', 'name'])),
+    contractDocIds: { ...nullableText, description: '全部文档 id，英文逗号分隔。开票申请「合同文本」不要填这个字符串' },
+}, ['requestId', 'requestName', 'workflowName', 'customer', 'customerSource', 'contractDocuments', 'contractDocIds']);
 export const invoiceOperations = [
     {
         name: 'invoice.list',
         risk: 'read',
         scope: 'personal',
-        fixed: { flag: 0, defaultSreim: '3', defaultBillType: 0 },
+        fixed: { flag: 0, defaultSreim: '3', defaultBillType: 0, excludeProStatus: 8 },
         inputSchema: { type: 'object', additionalProperties: false, properties: listProperties },
         outputSchema: listOutputSchema,
         outputViews: [summaryOutputView],
@@ -706,7 +536,7 @@ export const invoiceOperations = [
         name: 'invoice.enterprise.list',
         risk: 'read',
         scope: 'enterprise',
-        fixed: { flag: 6, defaultSreim: '3', defaultBillType: 0 },
+        fixed: { flag: 6, defaultSreim: '3', defaultBillType: 0, excludeProStatus: 8 },
         inputSchema: { type: 'object', additionalProperties: false, properties: listProperties },
         outputSchema: listOutputSchema,
         outputViews: [summaryOutputView],
@@ -996,7 +826,13 @@ export const invoiceOperations = [
     {
         name: 'invoice.reim.requests.list',
         risk: 'read',
-        fixed: { path: '/api/inc/book/getRequestListByTabId', defaultPageNo: 1, defaultPageSize: 100, defaultCusCreateDateEnd: 'passedOrShanghaiToday+1' },
+        fixed: {
+            path: '/api/inc/book/getRequestListByTabId',
+            defaultPageNo: 1,
+            defaultPageSize: 100,
+            defaultCusCreateDateEnd: 'passedOrShanghaiToday+1',
+            defaultCusCreateDateStart: 'end-7d, page1Empty→end-1month; scene=phone→end-90d',
+        },
         inputSchema: {
             type: 'object',
             additionalProperties: false,
@@ -1004,15 +840,29 @@ export const invoiceOperations = [
                 pageNo: { type: 'integer', minimum: 1, maximum: 10000, default: 1 },
                 pageSize: { type: 'integer', minimum: 1, maximum: 200, default: 100, description: '每页条数。不传时默认 100。' },
                 requestname: { type: 'string', minLength: 1 },
-                cusCreateDateStart: { type: 'string', pattern: '^\\d{4}-\\d{2}-\\d{2}$' },
+                cusCreateDateStart: {
+                    type: 'string',
+                    pattern: '^\\d{4}-\\d{2}-\\d{2}$',
+                    description: '发起日期开始（YYYY-MM-DD）。用户没指定时不要传：CLI 取结束日前 7 天，第 1 页查不到再放宽到结束日前 1 个月；scene=phone 时取结束日前 90 天。',
+                },
                 cusCreateDateEnd: {
                     type: 'string',
                     pattern: '^\\d{4}-\\d{2}-\\d{2}$',
                     description: '发起日期结束（YYYY-MM-DD）。不传时按东八区当天 + 1 天填入；传入时按该日期再 + 1 天后发给接口。调用方传业务结束日本身，不要自己再加 1 天。',
                 },
+                scene: { type: 'string', enum: ['phone'], description: '话费报销传 "phone"，默认开始日改为结束日前 90 天。' },
             },
         },
-        outputSchema: resultEnvelopeOutput(requestListDataSchema),
+        outputSchema: objectSchema({
+            result: rawObject,
+            data: requestListDataSchema,
+            workflow: workflowSchema,
+            query: objectSchema({
+                cusCreateDateStart: { type: 'string', description: '本次实际使用的发起日期开始' },
+                cusCreateDateEnd: { type: 'string', description: '本次的业务结束日（发给接口时已再 + 1 天）' },
+                widened: { type: 'boolean', description: '是否因 7 天内查不到而放宽到 1 个月' },
+            }, ['cusCreateDateStart', 'cusCreateDateEnd', 'widened']),
+        }, ['result', 'data', 'workflow', 'query']),
     },
     {
         name: 'invoice.reim.workflow.resolve',
@@ -1027,64 +877,6 @@ export const invoiceOperations = [
         },
         outputSchema: resultEnvelopeOutput(workflowResolveDataSchema),
     },
-    {
-        name: 'invoice.reim.form.structure',
-        risk: 'read',
-        fixed: { path: '/api/inc/book/getFormStructure', defaultNodeId: '1' },
-        inputSchema: {
-            type: 'object',
-            additionalProperties: false,
-            properties: {
-                workflowId: positiveId,
-                nodeId: { type: 'string', minLength: 1, default: '1' },
-            },
-            required: ['workflowId'],
-        },
-        outputSchema: resultEnvelopeOutput(formStructureDataSchema),
-    },
-    {
-        name: 'invoice.reim.row-info',
-        risk: 'read',
-        fixed: { path: '/api/secondev/fna/expense/dataInfo/getRowInfo', sf_request_type: 'fetch' },
-        inputSchema: {
-            type: 'object',
-            additionalProperties: false,
-            properties: {
-                invoiceId: positiveId,
-                requestid: { type: 'string' },
-                cdzt: positiveId,
-            },
-            required: ['invoiceId'],
-        },
-        outputSchema: resultEnvelopeOutput(rowInfoDataSchema),
-    },
-    {
-        name: 'invoice.reim.row-info-batch',
-        risk: 'read',
-        fixed: { path: '/api/secondev/fna/expense/dataInfo/getRowInfo', sf_request_type: 'fetch', concurrency: 4 },
-        inputSchema: {
-            type: 'object',
-            additionalProperties: false,
-            properties: {
-                invoiceIds: positiveIdArray,
-                requestid: { type: 'string' },
-                cdzt: positiveId,
-            },
-            required: ['invoiceIds'],
-        },
-        outputSchema: objectSchema({
-            results: arrayOf(objectSchema({
-                invoiceId: { type: 'string' },
-                status: { type: 'string', enum: ['success', 'fail'] },
-                data: rowInfoDataSchema,
-                error: { type: 'string' },
-            }, ['invoiceId', 'status'])),
-            succeeded: { type: 'integer' },
-            failed: { type: 'integer' },
-            total: { type: 'integer' },
-            workflow: workflowSchema,
-        }, ['results', 'succeeded', 'failed', 'total', 'workflow']),
-    },
     {
         name: 'invoice.reim.employee-superiors',
         risk: 'read',
@@ -1122,117 +914,126 @@ export const invoiceOperations = [
         }, ['result', 'data', 'keywords', 'match', 'items', 'workflow']),
     },
     {
-        name: 'invoice.reim.flow.create.prepare',
-        risk: 'read-before-write',
-        fixed: { path: '/api/inc/book/createFlowNew' },
-        inputSchema: {
-            type: 'object',
-            additionalProperties: false,
-            properties: reimFlowCreateProperties,
-            required: reimFlowCreateRequired,
-        },
-        outputSchema: continuationPreviewOutput(flowPreviewOutputSchema),
-    },
-    {
-        name: 'invoice.reim.flow.create.apply',
-        risk: 'high-risk-write',
+        name: 'invoice.reim.candidates.list',
+        risk: 'read',
+        fixed: { path: '/api/inc/sync', sreim: '3', billType: 0, excludeProStatus: 8 },
         inputSchema: {
             type: 'object',
             additionalProperties: false,
             properties: {
-                ...reimFlowCreateProperties,
-                continuation: { type: 'string', minLength: 1 },
-                confirm: { const: true },
+                date_begin: { type: 'string', pattern: '^\\d{4}-\\d{2}-\\d{2}$', description: '开票日期起（YYYY-MM-DD，含）。' },
+                date_end: { type: 'string', pattern: '^\\d{4}-\\d{2}-\\d{2}$', description: '开票日期止（YYYY-MM-DD，含）。' },
+                consumption_tm_begin: epochDateProperty('消费日期起（含）'),
+                consumption_tm_end: epochEndDateProperty('消费日期止（含）'),
+                page_size: { type: 'integer', minimum: 10, maximum: 200, default: 50, description: '单页条数。' },
+                max_items: { type: 'integer', minimum: 1, maximum: 500, default: 200, description: '最多拉取条数，超出截断并产生 warning。' },
             },
-            required: [...reimFlowCreateRequired, 'continuation', 'confirm'],
         },
-        outputSchema: flowCreateApplyOutputSchema,
+        outputSchema: reimCandidatesOutputSchema,
     },
     {
-        name: 'invoice.reim.flow.update.prepare',
-        risk: 'read-before-write',
-        fixed: { path: '/api/inc/book/updateFlow' },
-        inputSchema: {
-            type: 'object',
-            additionalProperties: false,
-            properties: reimFlowUpdateProperties,
-            required: ['requestId', 'mainFormId'],
-            anyOf: [{ required: ['main_fields'] }, { required: ['detail_rows'] }, { required: ['deleteDetailRows'] }],
+        name: 'invoice.issuing.contracts.list',
+        risk: 'read',
+        fixed: {
+            path: '/api/ebuilder/form/eblist/getData',
+            source: '合同虚拟表（按「合同审批流程」requestId 过滤）',
+            note: '每个 requestId 单独查询一次，结果按 requestId 拼回 cards',
         },
-        outputSchema: continuationPreviewOutput(flowUpdatePreviewOutputSchema),
-    },
-    {
-        name: 'invoice.reim.flow.update.apply',
-        risk: 'high-risk-write',
         inputSchema: {
             type: 'object',
             additionalProperties: false,
             properties: {
-                ...reimFlowUpdateProperties,
-                continuation: { type: 'string', minLength: 1 },
-                confirm: { const: true },
+                cards: {
+                    type: 'array',
+                    maxItems: 50,
+                    items: { type: 'object', required: ['requestId'], additionalProperties: true },
+                    description: 'workflow.search 返回的 data.cards，原样传入；与 requestIds 二选一',
+                },
+                requestIds: {
+                    type: 'array',
+                    maxItems: 50,
+                    items: { type: 'string', pattern: '^\\d+$' },
+                    description: '合同审批流程 requestId 列表；与 cards 二选一',
+                },
             },
-            required: ['requestId', 'mainFormId', 'continuation', 'confirm'],
-            anyOf: [{ required: ['main_fields'] }, { required: ['detail_rows'] }, { required: ['deleteDetailRows'] }],
         },
-        outputSchema: flowUpdateApplyOutputSchema,
+        outputSchema: issuingContractsOutputSchema,
     },
     {
-        name: 'invoice.reim.candidates.list',
+        name: 'invoice.issuing.contract.detail',
         risk: 'read',
-        fixed: { path: '/api/inc/sync', sreim: '3', billType: 0 },
+        fixed: {
+            path: '/api/workflow/core/paService/v1/getWorkflowRequest',
+            source: '合同审批流程详情（isReadRequest=false，不标记已读）',
+            note: '只取主表「客户名称」/「最终用户卡片」与「合同正文及附件」',
+        },
         inputSchema: {
             type: 'object',
             additionalProperties: false,
+            required: ['requestId'],
             properties: {
-                date_begin: { type: 'string', pattern: '^\\d{4}-\\d{2}-\\d{2}$', description: '开票日期起（YYYY-MM-DD，含）。' },
-                date_end: { type: 'string', pattern: '^\\d{4}-\\d{2}-\\d{2}$', description: '开票日期止（YYYY-MM-DD，含）。' },
-                consumption_tm_begin: epochDateProperty('消费日期起（含）'),
-                consumption_tm_end: epochEndDateProperty('消费日期止（含）'),
-                page_size: { type: 'integer', minimum: 10, maximum: 200, default: 50, description: '单页条数。' },
-                max_items: { type: 'integer', minimum: 1, maximum: 500, default: 200, description: '最多拉取条数（不含被过滤的红冲票），超出截断并产生 warning。' },
-                include_red_reversed: { type: 'boolean', default: false, description: '是否在结果中保留全额红冲（status=8）发票。默认 false —— 报销场景直接过滤掉，过滤张数由 summary.filteredRedReversedCount 告知，不会静默丢失。' },
+                requestId: { type: 'string', pattern: '^\\d+$', description: '用户选定的合同审批流程 requestId' },
             },
         },
-        outputSchema: reimCandidatesOutputSchema,
+        outputSchema: issuingContractDetailOutputSchema,
+    },
+];
+const REIM_REFERENCE = 'references/invoice-reim.md';
+const ISSUING_REFERENCE = 'references/invoice-issuing-workflow.md';
+/**
+ * 已下线的 operation：不可执行，也不在 operations 里。注册表按名字返回 operation_retired 和替代链路，
+ * 照旧 skill 调用的 Agent / 脚本才知道怎么改，而不是只拿到 operation_unknown。
+ */
+export const invoiceRetiredOperations = [
+    {
+        name: 'invoice.reim.form.structure',
+        replacement: '载入报销表单改用 weaver-e10-workflow 的 workflow.createForm（workflow 传 {workFlowName}({workFlowId})）',
+        reference: REIM_REFERENCE,
+    },
+    {
+        name: 'invoice.reim.row-info',
+        replacement: '明细行不再预填：每行只写「相关发票」（用 invoice.browse-field.data 生成），其余列由联动带出',
+        reference: REIM_REFERENCE,
+    },
+    {
+        name: 'invoice.reim.row-info-batch',
+        replacement: '明细行不再预填：每行只写「相关发票」（用 invoice.browse-field.data 生成），其余列由联动带出',
+        reference: REIM_REFERENCE,
+    },
+    {
+        name: 'invoice.reim.flow.create.prepare',
+        replacement: '创建报销单改用 weaver-e10-workflow 的 workflow.createRequest（action 固定 draft，存草稿）',
+        reference: REIM_REFERENCE,
+    },
+    {
+        name: 'invoice.reim.flow.create.apply',
+        replacement: '创建报销单改用 weaver-e10-workflow 的 workflow.createRequest（action 固定 draft，存草稿）',
+        reference: REIM_REFERENCE,
+    },
+    {
+        name: 'invoice.reim.flow.update.prepare',
+        replacement: '修改报销单改用 weaver-e10-workflow 的 workflow.editLoad → workflow.editPrepare → workflow.editApply',
+        reference: REIM_REFERENCE,
+    },
+    {
+        name: 'invoice.reim.flow.update.apply',
+        replacement: '修改报销单改用 weaver-e10-workflow 的 workflow.editLoad → workflow.editPrepare → workflow.editApply',
+        reference: REIM_REFERENCE,
     },
     {
         name: 'invoice.reim.template.build',
-        risk: 'read',
-        inputSchema: {
-            type: 'object',
-            additionalProperties: false,
-            properties: reimTemplateInputProperties,
-            required: ['invoiceIds', 'requestName'],
-        },
-        outputSchema: reimTemplateBuildOutputSchema,
+        replacement: '改为 invoice.reim.candidates.list 取候选发票 → workflow.createForm 载入表单 → 按 reim-form-fill-rules.md 组装 data → workflow.createRequest 存草稿',
+        reference: REIM_REFERENCE,
     },
     {
         name: 'invoice.reim.flow.create.auto-prepare',
-        risk: 'read-before-write',
-        inputSchema: {
-            type: 'object',
-            additionalProperties: false,
-            properties: reimTemplateInputProperties,
-            required: ['invoiceIds', 'requestName'],
-        },
-        outputSchema: reimAutoPrepareOutputSchema,
+        replacement: '改为 invoice.reim.candidates.list 取候选发票 → workflow.createForm 载入表单 → 按 reim-form-fill-rules.md 组装 data → workflow.createRequest 存草稿',
+        reference: REIM_REFERENCE,
     },
     {
         name: 'invoice.issuing.qys.list',
-        risk: 'read',
-        fixed: { path: '/api/ebuilder/form/list/getListDatas', ledger: '待开票合同数据' },
-        inputSchema: {
-            type: 'object',
-            additionalProperties: false,
-            properties: {
-                keyword: { type: 'string', description: '模糊匹配合同号、购买方名称、合同审批流程名称、商品名称或开票名称' },
-                contractNo: { type: 'string', description: '按合同号精确筛选' },
-                includeIssued: { type: 'boolean', default: false, description: '是否包含已开票、开票中或已废弃的行。默认 false 只返回可开票行；groups 始终按合同号+购方汇总，blockedRows 计不可开票行数。' },
-                limit: { type: 'integer', minimum: 1, maximum: 100, default: 20 },
-            },
-        },
-        outputSchema: qysListOutputSchema,
+        replacement: '改为 workflow.search 查合同审批流程 → 把 data.cards 传给 invoice.issuing.contracts.list 列出待开票合同 → 选定后用 invoice.issuing.contract.detail 取客户和合同文档',
+        reference: ISSUING_REFERENCE,
     },
 ];
 export const invoiceManifest = {
@@ -1253,15 +1054,10 @@ export const invoiceManifest = {
             default: 'full',
             description: `输出视图。full=完整包络；summary=${SUMMARY_ITEM_FIELDS.length} 个语义字段的平表，仅 invoice.list / invoice.enterprise.list 支持；detail=${DETAIL_ITEM_FIELDS.length} 个字段的单张发票详情（含附件、费用说明、查验标记），仅 invoice.get 支持。`,
         },
-        '--format': {
-            values: OUTPUT_FORMATS,
-            default: 'json',
-            description: '输出格式。json=标准 envelope（默认，供程序消费）；markdown=人读渲染（票夹列表/发票详情两类模板，内置列顺序与单位），仅 invoice.list / invoice.enterprise.list / invoice.get 支持，且与 --json、--fields 互斥。markdown 档自带字段口径（list→summary、get→detail），不必再传 --view。',
-        },
         '--fields': {
             description: '逗号分隔的点路径列表，按原结构投影，例如 --fields number,detailUrl。所有 operation 可用；未命中的路径会出现在 meta.projection.missingFields 里。⚠️ 不要用裸 total 取金额：发票顶层 total 是 E10 的独立字段（实测恒为 0），价税合计在 comm_info.price.total，不含税金额在 comm_info.price.amount。',
         },
-        note: '--view 与 --fields 互斥；--format markdown 与 --json/--fields 互斥。投影只影响输出，不改变任何请求参数；meta.projection 会说明本次裁剪结果。',
+        note: '--view 与 --fields 互斥。投影只影响输出，不改变任何请求参数；meta.projection 会说明本次裁剪结果。',
     },
     operations: invoiceOperations,
     withheldOperations: [
@@ -1278,6 +1074,7 @@ export const invoiceManifest = {
             reason: '新增源资料给出 /api/my/tag/common/batchAddEntityTag 请求体，但仍缺少标签定义查询、当前标签关系回查和移除/替换语义。',
         },
     ],
+    retiredOperations: invoiceRetiredOperations,
 };
 export function hasInvoiceOperation(operation) {
     return invoiceOperations.some((item) => item.name === operation);