weaver-work-cli 0.1.8 → 0.1.20

package/dist/shortcuts/contract/index.js

@@ -0,0 +1,318 @@
+import { readFile } from 'node:fs/promises';
+import { ExitCode, isCliError, toErrorEnvelope } from '../../core/errors.js';
+import { createContractContinuationSigner } from './continuation.js';
+import { contractValidationError } from './errors.js';
+import { createContractHost } from './host.js';
+import { contractManifest } from './manifest.js';
+import { executeContractOperation } from './operations.js';
+function asOptions(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+function optionName(flag) {
+    const match = /--([^<\s[]+)/u.exec(flag);
+    if (!match)
+        return flag;
+    const parts = match[1].split('-');
+    return parts[0] + parts.slice(1).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join('');
+}
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(Buffer.isBuffer(chunk) ? Buffer.from(chunk) : chunk);
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+export async function inputFrom(options, extra = {}) {
+    const opts = asOptions(options);
+    let input = {};
+    if (opts.input && opts.inputJson) {
+        throw contractValidationError('input_conflict', '不能同时传 --input 和 --input-json');
+    }
+    if (opts.inputJson)
+        input = parseJsonInput(String(opts.inputJson), '--input-json');
+    if (opts.input) {
+        let raw;
+        try {
+            raw = opts.input === '-' ? await readStdin() : await readFile(String(opts.input), 'utf8');
+        }
+        catch {
+            throw contractValidationError('input_unreadable', `无法读取 --input：${String(opts.input)}`);
+        }
+        input = parseJsonInput(raw, '--input');
+    }
+    return {
+        ...input,
+        ...Object.fromEntries(Object.entries(extra).filter(([, value]) => value !== undefined && value !== '')),
+    };
+}
+function parseJsonInput(raw, label) {
+    try {
+        const parsed = JSON.parse(raw.replace(/^/u, ''));
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            throw new Error('input must be an object');
+        }
+        return parsed;
+    }
+    catch {
+        throw contractValidationError('input_invalid', `${label} 不是合法 JSON 对象`);
+    }
+}
+function mapOptions(options, specs) {
+    const opts = asOptions(options);
+    const result = {};
+    for (const spec of specs) {
+        if (!spec.key)
+            continue;
+        const value = opts[optionName(spec.flag)];
+        if (value === undefined || value === null || value === '')
+            continue;
+        if (spec.kind === 'int') {
+            const parsed = Number(value);
+            if (Number.isInteger(parsed))
+                result[spec.key] = parsed;
+        }
+        else if (spec.kind === 'bool') {
+            if (typeof value === 'boolean')
+                result[spec.key] = value;
+        }
+        else {
+            result[spec.key] = String(value);
+        }
+    }
+    return result;
+}
+function successEnvelope(operation, result) {
+    return {
+        schemaVersion: 1,
+        ok: true,
+        operation,
+        data: result.data,
+        meta: { status: result.status },
+        warnings: [],
+    };
+}
+function failureEnvelope(error) {
+    const structured = error;
+    return {
+        schemaVersion: 1,
+        ok: false,
+        ...(structured?.partialData === undefined ? {} : { data: structured.partialData }),
+        error: toErrorEnvelope(error),
+    };
+}
+async function executeAndPrint(ctx, operation, input) {
+    try {
+        const result = await executeContractOperation(operation, input, {
+            host: createContractHost(ctx),
+            continuation: createContractContinuationSigner(ctx),
+        });
+        ctx.output.write(successEnvelope(operation, result), { json: true });
+    }
+    catch (error) {
+        console.error(JSON.stringify(failureEnvelope(error), null, 2));
+        process.exitCode = isCliError(error) ? error.exitCode : ExitCode.GeneralError;
+    }
+}
+const JSON_INPUT_FLAGS = [
+    { flag: '--input <path>', description: 'JSON input file, or - for stdin' },
+    { flag: '--input-json <json>', description: 'inline JSON input object' },
+];
+const CONTINUATION_FLAGS = [
+    { flag: '--continuation <token>', description: 'continuation token from prepare', key: 'continuation' },
+    { flag: '--yes', description: 'confirm the write operation', key: 'confirm', kind: 'bool' },
+];
+export const contractShortcut = {
+    name: 'contract',
+    description: '泛微E10今承达合同管理 CLI',
+    category: 'shortcut',
+    register({ program, action }) {
+        const wrap = (handler) => action(handler);
+        const registerCommand = (parent, name, description, operation, specs = []) => {
+            const command = parent.command(name).description(description);
+            for (const spec of [...specs, ...JSON_INPUT_FLAGS])
+                command.option(spec.flag, spec.description);
+            command.action(wrap(async (ctx, options) => {
+                await executeAndPrint(ctx, operation, await inputFrom(options, mapOptions(options, specs)));
+            }));
+            return command;
+        };
+        const contract = program.command('contract').description('泛微E10今承达合同管理');
+        contract.command('schema')
+            .description('Print contract operation manifest for agents')
+            .action(wrap((ctx) => {
+            ctx.output.write(contractManifest, { json: true });
+        }));
+        const run = contract.command('run')
+            .description('Run a contract operation with JSON input')
+            .argument('<operation>', 'operation name, e.g. contract.type.tree');
+        for (const spec of JSON_INPUT_FLAGS)
+            run.option(spec.flag, spec.description);
+        run.action(wrap(async (ctx, operation, options) => {
+            await executeAndPrint(ctx, String(operation), await inputFrom(options));
+        }));
+        const type = contract.command('type').description('Contract type commands');
+        registerCommand(type, 'tree', 'List all contract types', 'contract.type.tree');
+        const template = contract.command('template').description('Contract template commands');
+        registerCommand(template, 'tree', 'List template category tree', 'contract.template.tree', [
+            { flag: '--tree-name <name>', description: 'tree name filter', key: 'treeName' },
+            { flag: '--parent-id <id>', description: 'parent node id', key: 'parentId' },
+            { flag: '--tree-type <type>', description: 'tree type', key: 'treeType', kind: 'int' },
+            { flag: '--app-id <id>', description: 'application id', key: 'appId' },
+        ]);
+        registerCommand(template, 'list', 'List templates with paging', 'contract.template.list', [
+            { flag: '--template-name <name>', description: 'template name keyword', key: 'templateName' },
+            { flag: '--belong-id <id>', description: 'template category id', key: 'belongId' },
+            { flag: '--contract-type <id>', description: 'contract type id', key: 'contractType' },
+            { flag: '--template-status <status>', description: '0 disabled, 1 enabled', key: 'templateStatus', kind: 'int' },
+            { flag: '--page-no <n>', description: 'page number', key: 'pageNo', kind: 'int' },
+            { flag: '--page-size <n>', description: 'page size', key: 'pageSize', kind: 'int' },
+        ]);
+        registerCommand(template, 'detail', 'Get template detail by id', 'contract.template.detail', [
+            { flag: '--id <id>', description: 'template id', key: 'id' },
+        ]);
+        const clause = contract.command('clause').description('Contract clause commands');
+        registerCommand(clause, 'tree', 'List clause category tree', 'contract.clause.tree');
+        registerCommand(clause, 'list', 'List clauses with paging', 'contract.clause.list', [
+            { flag: '--belong-id <id>', description: 'clause category id', key: 'belongId' },
+            { flag: '--clause-name <name>', description: 'clause name keyword', key: 'clauseName' },
+            { flag: '--contract-type <id>', description: 'contract type id', key: 'contractType' },
+            { flag: '--page-no <n>', description: 'page number', key: 'pageNo', kind: 'int' },
+            { flag: '--page-size <n>', description: 'page size', key: 'pageSize', kind: 'int' },
+        ]);
+        registerCommand(clause, 'groups', 'List clause groups', 'contract.clause.group.list', [
+            { flag: '--belong-id <id>', description: 'clause category id', key: 'belongId' },
+            { flag: '--contract-type <id>', description: 'contract type id', key: 'contractType' },
+            { flag: '--page-no <n>', description: 'page number', key: 'pageNo', kind: 'int' },
+            { flag: '--page-size <n>', description: 'page size', key: 'pageSize', kind: 'int' },
+        ]);
+        registerCommand(clause, 'search', 'Search clauses', 'contract.clause.search', [
+            { flag: '--title <title>', description: 'clause title keyword', key: 'title' },
+            { flag: '--tag-id <id>', description: 'clause tag id', key: 'tagId' },
+            { flag: '--content <text>', description: 'clause content keyword', key: 'content' },
+            { flag: '--page-num <n>', description: 'page number', key: 'pageNum', kind: 'int' },
+            { flag: '--page-size <n>', description: 'page size', key: 'pageSize', kind: 'int' },
+        ]);
+        registerCommand(clause, 'tags', 'List clause tags', 'contract.clause.tags', [
+            { flag: '--label <label>', description: 'tag label', key: 'label' },
+            { flag: '--page-num <n>', description: 'page number', key: 'pageNum', kind: 'int' },
+            { flag: '--page-size <n>', description: 'page size', key: 'pageSize', kind: 'int' },
+        ]);
+        const reference = clause.command('reference').description('Clause reference commands');
+        registerCommand(reference, 'get', 'Query referenced clauses of a contract document', 'contract.clause.reference.get', [
+            { flag: '--file-id <id>', description: 'contract file id', key: 'fileId' },
+            { flag: '--request-id <id>', description: 'workflow request id', key: 'requestId' },
+            { flag: '--clause-id <id>', description: 'clause id', key: 'clauseId' },
+            { flag: '--page-num <n>', description: 'page number', key: 'pageNum', kind: 'int' },
+            { flag: '--page-size <n>', description: 'page size', key: 'pageSize', kind: 'int' },
+        ]);
+        registerCommand(reference, 'save-prepare', 'Prepare clause reference write', 'contract.clause.reference.save.prepare', [
+            { flag: '--file-id <id>', description: 'contract file id', key: 'fileId' },
+            { flag: '--request-id <id>', description: 'workflow request id', key: 'requestId' },
+            { flag: '--file-name <name>', description: 'contract file name', key: 'fileName' },
+            { flag: '--request-name <name>', description: 'workflow request name', key: 'requestName' },
+        ]);
+        registerCommand(reference, 'save-apply', 'Apply a prepared clause reference write', 'contract.clause.reference.save.apply', [
+            { flag: '--file-id <id>', description: 'contract file id', key: 'fileId' },
+            { flag: '--request-id <id>', description: 'workflow request id', key: 'requestId' },
+            { flag: '--file-name <name>', description: 'contract file name', key: 'fileName' },
+            { flag: '--request-name <name>', description: 'workflow request name', key: 'requestName' },
+            ...CONTINUATION_FLAGS,
+        ]);
+        const subject = contract.command('subject').description('Signing subject commands');
+        registerCommand(subject, 'app', 'Resolve application id by tag', 'contract.subject.app', [
+            { flag: '--tag <tag>', description: 'application tag, default 合同管理', key: 'tag' },
+        ]);
+        registerCommand(subject, 'form', 'Resolve form object by tag', 'contract.subject.form', [
+            { flag: '--app-id <id>', description: 'application id', key: 'appId' },
+            { flag: '--tag <tag>', description: 'form tag', key: 'tag' },
+        ]);
+        registerCommand(subject, 'fields', 'Read form field definitions', 'contract.subject.fields', [
+            { flag: '--app-id <id>', description: 'application id', key: 'appId' },
+            { flag: '--obj-id <id>', description: 'form object id', key: 'objId' },
+        ]);
+        registerCommand(subject, 'options', 'Read selectable field options', 'contract.subject.options', [
+            { flag: '--app-id <id>', description: 'application id', key: 'appId' },
+            { flag: '--obj-id <id>', description: 'form object id', key: 'objId' },
+            { flag: '--field-name <id>', description: 'field metadata id', key: 'fieldName' },
+        ]);
+        registerCommand(subject, 'query', 'Query signing subject records', 'contract.subject.query', [
+            { flag: '--obj-id <id>', description: 'form object id', key: 'objId' },
+            { flag: '--page-no <n>', description: 'page number', key: 'pageNo', kind: 'int' },
+            { flag: '--page-size <n>', description: 'page size', key: 'pageSize', kind: 'int' },
+            { flag: '--return-detail <y|n>', description: 'return detail tables', key: 'isReturnDetail' },
+        ]);
+        registerCommand(subject, 'create-prepare', 'Prepare signing subject creation', 'contract.subject.create.prepare', [
+            { flag: '--obj-id <id>', description: 'form object id', key: 'objId' },
+        ]);
+        registerCommand(subject, 'create-apply', 'Apply a prepared signing subject creation', 'contract.subject.create.apply', [
+            { flag: '--obj-id <id>', description: 'form object id', key: 'objId' },
+            ...CONTINUATION_FLAGS,
+        ]);
+        const workflow = contract.command('workflow').description('Workflow metadata commands');
+        registerCommand(workflow, 'query', 'Query workflow by name', 'contract.workflow.query', [
+            { flag: '--workflow-name <name>', description: 'workflow name', key: 'workflowName' },
+            { flag: '--workflow-type <type>', description: 'workflow type id', key: 'workflowType' },
+            { flag: '--status <status>', description: '1 enabled, 2 history, 5 disabled, 9 template', key: 'status' },
+        ]);
+        registerCommand(workflow, 'list', 'List workflows the user can create', 'contract.workflow.list', [
+            { flag: '--wfp-code <code>', description: '0 personal, 1 team', key: 'wfpCode', kind: 'int' },
+            { flag: '--filter-hide <value>', description: 'pass 1 to filter hidden', key: 'filterHide' },
+        ]);
+        registerCommand(workflow, 'form-info', 'Read workflow form definition', 'contract.workflow.form.info', [
+            { flag: '--workflow-id <id>', description: 'workflow id', key: 'workflowId' },
+        ]);
+        registerCommand(workflow, 'field-options', 'Read selectable field options', 'contract.workflow.field.options', [
+            { flag: '--field-id <id>', description: 'field id', key: 'fieldId' },
+            { flag: '--page-no <n>', description: 'page number', key: 'pageNo', kind: 'int' },
+            { flag: '--page-size <n>', description: 'page size', key: 'pageSize', kind: 'int' },
+        ]);
+        const request = contract.command('request').description('Contract approval request commands');
+        registerCommand(request, 'create-prepare', 'Prepare workflow request creation', 'contract.request.create.prepare', [
+            { flag: '--workflow-id <id>', description: 'workflow id', key: 'workflowId' },
+            { flag: '--requestname <name>', description: 'request title', key: 'requestname' },
+            { flag: '--remark <text>', description: 'remark', key: 'remark' },
+        ]);
+        registerCommand(request, 'create-apply', 'Apply a prepared workflow request creation', 'contract.request.create.apply', [
+            { flag: '--workflow-id <id>', description: 'workflow id', key: 'workflowId' },
+            { flag: '--requestname <name>', description: 'request title', key: 'requestname' },
+            { flag: '--remark <text>', description: 'remark', key: 'remark' },
+            ...CONTINUATION_FLAGS,
+        ]);
+        registerCommand(request, 'save-prepare', 'Prepare workflow form data save', 'contract.request.save.prepare', [
+            { flag: '--request-id <id>', description: 'request id', key: 'requestId' },
+            { flag: '--workflow-id <id>', description: 'workflow id', key: 'workflowId' },
+        ]);
+        registerCommand(request, 'save-apply', 'Apply a prepared workflow form data save', 'contract.request.save.apply', [
+            { flag: '--request-id <id>', description: 'request id', key: 'requestId' },
+            { flag: '--workflow-id <id>', description: 'workflow id', key: 'workflowId' },
+            ...CONTINUATION_FLAGS,
+        ]);
+        registerCommand(request, 'submit-prepare', 'Prepare contract approval submission', 'contract.request.submit.prepare', [
+            { flag: '--request-id <id>', description: 'request id', key: 'requestId' },
+            { flag: '--request-name <name>', description: 'request title', key: 'requestName' },
+            { flag: '--remark <text>', description: 'remark', key: 'remark' },
+        ]);
+        registerCommand(request, 'submit-apply', 'Apply a prepared contract approval submission', 'contract.request.submit.apply', [
+            { flag: '--request-id <id>', description: 'request id', key: 'requestId' },
+            { flag: '--request-name <name>', description: 'request title', key: 'requestName' },
+            { flag: '--remark <text>', description: 'remark', key: 'remark' },
+            ...CONTINUATION_FLAGS,
+        ]);
+        registerCommand(request, 'supervise-prepare', 'Prepare approval reminder', 'contract.request.supervise.prepare', [
+            { flag: '--request-id <id>', description: 'request id', key: 'requestId' },
+            { flag: '--remark <text>', description: 'reminder remark', key: 'remark' },
+        ]);
+        registerCommand(request, 'supervise-apply', 'Apply a prepared approval reminder', 'contract.request.supervise.apply', [
+            { flag: '--request-id <id>', description: 'request id', key: 'requestId' },
+            { flag: '--remark <text>', description: 'reminder remark', key: 'remark' },
+            ...CONTINUATION_FLAGS,
+        ]);
+        registerCommand(request, 'status', 'Read workflow request status', 'contract.request.status', [
+            { flag: '--request-id <id>', description: 'request id', key: 'requestId' },
+        ]);
+        registerCommand(request, 'log', 'Read workflow request logs', 'contract.request.log', [
+            { flag: '--request-id <id>', description: 'request id', key: 'requestId' },
+            { flag: '--other-params <json>', description: 'paging params JSON', key: 'otherParams' },
+        ]);
+    },
+};