weaver-work-cli 0.1.7 → 0.1.20

package/dist/shortcuts/index.js

@@ -1,4 +1,6 @@
+import { caizhilianShortcut } from './caizhilian/index.js';
 import { projectShortcut } from './project/index.js';
+import { blogShortcut } from './blog/index.js';
 import { archiveShortcut } from './archive/index.js';
 import { calendarShortcut } from './calendar/index.js';
 import { ehrShortcut } from './ehr/index.js';
@@ -32,5 +34,7 @@ export const builtinShortcuts = [
     assetShortcut,
     imShortcut,
     projectShortcut,
-    workflowShortcut
+    workflowShortcut,
+    blogShortcut,
+    caizhilianShortcut
 ];

package/dist/shortcuts/invoice/index.js

@@ -4,6 +4,8 @@ import { createInvoiceContinuationSigner } from './continuation.js';
 import { createInvoiceHost } from './host.js';
 import { invoiceManifest } from './manifest.js';
 import { executeInvoiceOperation } from './operations.js';
+import { normalizeFields, normalizeView, formatFrom, assertProjectionSupported, applyInvoiceProjection, } from './projection.js';
+import { renderInvoiceMarkdown } from './markdown.js';
 import { invoiceValidationError } from './errors.js';
 function asOptions(value) {
     return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
@@ -57,6 +59,32 @@ function withJsonInputOptions(command) {
         .option('--input-json <json>', 'inline JSON input object');
     return command;
 }
+/**
+ * 输出投影选项：让调用方一次拿到可读结果，而不必再写脚本解析完整 envelope。
+ * `--view summary` 只对 list 类 operation 生效、`--view detail` 只对 invoice.get 生效（见 projection.ts）；
+ * `--fields` 对所有 operation 生效；`--format markdown` 是渲染档，直接出表格文本（见 markdown.ts）。
+ */
+function withOutputOptions(command) {
+    command
+        .option('--view <mode>', 'output view: full (default), summary (list ops) or detail (invoice.get)')
+        .option('--format <mode>', 'output format: json (default) or markdown (human-readable text)')
+        .option('--fields <paths>', 'comma-separated dot paths to keep, e.g. number,detailUrl');
+    return command;
+}
+function withInvoiceOptions(command) {
+    return withOutputOptions(withJsonInputOptions(command));
+}
+function projectionFrom(options) {
+    const opts = asOptions(options);
+    const view = normalizeView(opts.view);
+    const fields = normalizeFields(opts.fields);
+    const format = formatFrom(opts.format);
+    return {
+        ...(view ? { view } : {}),
+        ...(fields ? { fields } : {}),
+        ...(format ? { format } : {}),
+    };
+}
 function intOption(value) {
     if (value === undefined || value === null || value === '')
         return undefined;
@@ -68,13 +96,13 @@ function stringOption(value) {
         return undefined;
     return String(value);
 }
-function successEnvelope(operation, result) {
+function successEnvelope(operation, result, meta) {
     return {
         schemaVersion: 1,
         ok: true,
         operation,
         data: result.data,
-        meta: { status: result.status },
+        meta: { status: result.status, ...(meta ?? {}) },
         warnings: [],
     };
 }
@@ -87,13 +115,23 @@ function failureEnvelope(error) {
         error: toErrorEnvelope(error),
     };
 }
-async function executeAndPrint(ctx, operation, input) {
+async function executeAndPrint(ctx, operation, input, projection = {}) {
     try {
+        assertProjectionSupported(operation, projection);
         const result = await executeInvoiceOperation(operation, input, {
             host: createInvoiceHost(ctx),
             continuation: createInvoiceContinuationSigner(ctx),
         });
-        ctx.output.write(successEnvelope(operation, result), { json: true });
+        const projected = applyInvoiceProjection(operation, result.data, projection);
+        if (projection.format === 'markdown') {
+            // 渲染档输出的是文本，不是 envelope：与 --json 混用会让调用方误判输出契约，直接拦住。
+            if (ctx.getGlobalOptions().json) {
+                throw invoiceValidationError('input_conflict', '--format markdown 与 --json 互斥：markdown 是渲染档（文本），不是 JSON。去掉 --json 再试');
+            }
+            process.stdout.write(renderInvoiceMarkdown(operation, projected.data));
+            return;
+        }
+        ctx.output.write(successEnvelope(operation, { status: result.status, data: projected.data }, projected.meta), { json: true });
     }
     catch (error) {
         console.error(JSON.stringify(failureEnvelope(error), null, 2));
@@ -111,13 +149,13 @@ export const invoiceShortcut = {
             .action(action((ctx) => {
             ctx.output.write(invoiceManifest, { json: true });
         }));
-        withJsonInputOptions(invoice.command('run')
+        withInvoiceOptions(invoice.command('run')
             .description('Run an invoice operation with JSON input')
             .argument('<operation>', 'operation name, e.g. invoice.list'))
             .action(action(async (ctx, operation, options) => {
-            await executeAndPrint(ctx, String(operation), await inputFrom(options));
+            await executeAndPrint(ctx, String(operation), await inputFrom(options), projectionFrom(options));
         }));
-        withJsonInputOptions(invoice.command('list')
+        withInvoiceOptions(invoice.command('list')
             .description('List personal invoice folder entries')
             .option('--content <keyword>', 'keyword search')
             .option('--page-size <size>', 'page size')
@@ -130,10 +168,10 @@ export const invoiceShortcut = {
                 page_size: intOption(opts.pageSize),
                 start_pos: intOption(opts.startPos),
                 sreim: stringOption(opts.sreim),
-            }));
+            }), projectionFrom(options));
         }));
         const enterprise = invoice.command('enterprise').description('Enterprise invoice folder commands');
-        withJsonInputOptions(enterprise.command('list')
+        withInvoiceOptions(enterprise.command('list')
             .description('List enterprise invoice folder entries')
             .option('--content <keyword>', 'keyword search')
             .option('--page-size <size>', 'page size')
@@ -146,9 +184,9 @@ export const invoiceShortcut = {
                 page_size: intOption(opts.pageSize),
                 start_pos: intOption(opts.startPos),
                 sreim: stringOption(opts.sreim),
-            }));
+            }), projectionFrom(options));
         }));
-        withJsonInputOptions(invoice.command('get')
+        withInvoiceOptions(invoice.command('get')
             .description('Get invoice detail by fid or number')
             .option('--fid <fid>', 'invoice fid')
             .option('--number <number>', 'invoice number'))
@@ -157,9 +195,9 @@ export const invoiceShortcut = {
             await executeAndPrint(ctx, 'invoice.get', await inputFrom(options, {
                 fid: opts.fid,
                 number: opts.number,
-            }));
+            }), projectionFrom(options));
         }));
-        withJsonInputOptions(invoice.command('upload')
+        withInvoiceOptions(invoice.command('upload')
             .description('Upload an invoice file for OCR')
             .option('--file <path>', 'local invoice file')
             .option('--url <url>', 'server-accessible file URL'))
@@ -168,10 +206,10 @@ export const invoiceShortcut = {
             await executeAndPrint(ctx, 'invoice.upload', await inputFrom(options, {
                 file: opts.file,
                 url: opts.url,
-            }));
+            }), projectionFrom(options));
         }));
         const ocr = invoice.command('ocr').description('Invoice OCR commands');
-        withJsonInputOptions(ocr.command('preview')
+        withInvoiceOptions(ocr.command('preview')
             .description('Preview OCR result without saving an invoice')
             .option('--file <path>', 'local invoice file')
             .option('--url <url>', 'server-accessible file URL'))
@@ -180,10 +218,10 @@ export const invoiceShortcut = {
             await executeAndPrint(ctx, 'invoice.ocr.preview', await inputFrom(options, {
                 file: opts.file,
                 url: opts.url,
-            }));
+            }), projectionFrom(options));
         }));
         const validate = invoice.command('validate').description('Invoice validation commands');
-        withJsonInputOptions(validate.command('preview')
+        withInvoiceOptions(validate.command('preview')
             .description('Validate an existing invoice without saving validation result')
             .option('--fid <fid>', 'invoice fid')
             .option('--scope <scope>', 'personal or enterprise'))
@@ -192,10 +230,10 @@ export const invoiceShortcut = {
             await executeAndPrint(ctx, 'invoice.validate.preview', await inputFrom(options, {
                 fid: opts.fid,
                 scope: opts.scope,
-            }));
+            }), projectionFrom(options));
         }));
         const importCommand = invoice.command('import').description('Invoice file import commands');
-        withJsonInputOptions(importCommand.command('prepare')
+        withInvoiceOptions(importCommand.command('prepare')
             .description('Prepare a confirmed invoice file import')
             .option('--file <path>', 'local invoice file')
             .option('--validate', 'request validation before import')
@@ -208,9 +246,9 @@ export const invoiceShortcut = {
                 file: opts.file,
                 validate: typeof opts.validate === 'boolean' ? opts.validate : undefined,
                 syncToOa: typeof opts.syncToOa === 'boolean' ? opts.syncToOa : undefined,
-            }));
+            }), projectionFrom(options));
         }));
-        withJsonInputOptions(importCommand.command('apply')
+        withInvoiceOptions(importCommand.command('apply')
             .description('Apply a prepared invoice file import')
             .option('--file <path>', 'local invoice file')
             .option('--continuation <token>', 'continuation token from prepare')
@@ -221,17 +259,17 @@ export const invoiceShortcut = {
                 file: opts.file,
                 continuation: opts.continuation,
                 confirm: opts.yes === true ? true : undefined,
-            }));
+            }), projectionFrom(options));
         }));
         const add = invoice.command('add').description('Manual invoice add commands');
-        withJsonInputOptions(add.command('prepare')
+        withInvoiceOptions(add.command('prepare')
             .description('Prepare a confirmed manual invoice add')
             .option('--scope <scope>', 'personal or enterprise'))
             .action(action(async (ctx, options) => {
             const opts = asOptions(options);
-            await executeAndPrint(ctx, 'invoice.add.prepare', await inputFrom(options, { scope: opts.scope }));
+            await executeAndPrint(ctx, 'invoice.add.prepare', await inputFrom(options, { scope: opts.scope }), projectionFrom(options));
         }));
-        withJsonInputOptions(add.command('apply')
+        withInvoiceOptions(add.command('apply')
             .description('Apply a prepared manual invoice add')
             .option('--continuation <token>', 'continuation token from prepare')
             .option('--yes', 'confirm the write operation'))
@@ -240,10 +278,10 @@ export const invoiceShortcut = {
             await executeAndPrint(ctx, 'invoice.add.apply', await inputFrom(options, {
                 continuation: opts.continuation,
                 confirm: opts.yes === true ? true : undefined,
-            }));
+            }), projectionFrom(options));
         }));
         const update = invoice.command('update').description('Invoice update commands');
-        withJsonInputOptions(update.command('prepare')
+        withInvoiceOptions(update.command('prepare')
             .description('Prepare an invoice update')
             .option('--fid <fid>', 'invoice fid')
             .option('--scope <scope>', 'personal or enterprise'))
@@ -252,9 +290,9 @@ export const invoiceShortcut = {
             await executeAndPrint(ctx, 'invoice.update.prepare', await inputFrom(options, {
                 fid: opts.fid,
                 scope: opts.scope,
-            }));
+            }), projectionFrom(options));
         }));
-        withJsonInputOptions(update.command('apply')
+        withInvoiceOptions(update.command('apply')
             .description('Apply a prepared invoice update')
             .option('--continuation <token>', 'continuation token from prepare')
             .option('--yes', 'confirm the write operation'))
@@ -263,9 +301,9 @@ export const invoiceShortcut = {
             await executeAndPrint(ctx, 'invoice.update.apply', await inputFrom(options, {
                 continuation: opts.continuation,
                 confirm: opts.yes === true ? true : undefined,
-            }));
+            }), projectionFrom(options));
         }));
-        withJsonInputOptions(invoice.command('download')
+        withInvoiceOptions(invoice.command('download')
             .description('Download an invoice attachment after verifying ownership')
             .option('--fid <fid>', 'invoice fid')
             .option('--file-id <id>', 'invoice file id')
@@ -276,10 +314,10 @@ export const invoiceShortcut = {
                 fid: opts.fid,
                 fileId: opts.fileId,
                 output: opts.output,
-            }));
+            }), projectionFrom(options));
         }));
         const del = invoice.command('delete').description('Invoice delete commands');
-        withJsonInputOptions(del.command('prepare')
+        withInvoiceOptions(del.command('prepare')
             .description('Prepare an invoice soft delete')
             .option('--fid <fid>', 'invoice fid')
             .option('--scope <scope>', 'personal or enterprise'))
@@ -288,9 +326,9 @@ export const invoiceShortcut = {
             await executeAndPrint(ctx, 'invoice.delete.prepare', await inputFrom(options, {
                 fid: opts.fid,
                 scope: opts.scope,
-            }));
+            }), projectionFrom(options));
         }));
-        withJsonInputOptions(del.command('apply')
+        withInvoiceOptions(del.command('apply')
             .description('Apply a prepared invoice soft delete')
             .option('--continuation <token>', 'continuation token from prepare')
             .option('--yes', 'confirm the write operation'))
@@ -299,7 +337,7 @@ export const invoiceShortcut = {
             await executeAndPrint(ctx, 'invoice.delete.apply', await inputFrom(options, {
                 continuation: opts.continuation,
                 confirm: opts.yes === true ? true : undefined,
-            }));
+            }), projectionFrom(options));
         }));
     },
 };