weaver-work-cli 0.1.1 → 0.1.4

package/dist/shortcuts/plan/index.js

@@ -0,0 +1,150 @@
+import { readFile } from 'node:fs/promises';
+import { ExitCode, isCliError, toErrorEnvelope } from '../../core/errors.js';
+import { createPlanContinuationSigner } from './continuation.js';
+import { planValidationError } from './errors.js';
+import { createPlanHost } from './host.js';
+import { planManifest } from './manifest.js';
+import { executePlanOperation } from './operations.js';
+function asOptions(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+function stripBom(value) {
+    return value.replace(/^\uFEFF+/, '');
+}
+export async function inputFrom(options, extra = {}) {
+    const opts = asOptions(options);
+    let input = {};
+    if (opts.input && opts.inputJson) {
+        throw planValidationError('input_conflict', '不能同时传 --input 和 --input-json');
+    }
+    if (opts.inputJson) {
+        input = parseJsonInput(String(opts.inputJson), '--input-json');
+    }
+    if (opts.input) {
+        let raw;
+        try {
+            raw = stripBom(opts.input === '-' ? await readStdin() : await readFile(String(opts.input), 'utf8'));
+        }
+        catch {
+            throw planValidationError('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(stripBom(raw));
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            throw new Error('input must be an object');
+        }
+        return parsed;
+    }
+    catch {
+        throw planValidationError('input_invalid', `${label} 不是合法 JSON 对象`);
+    }
+}
+export function successEnvelope(operation, result) {
+    return {
+        schemaVersion: 1,
+        ok: true,
+        operation,
+        data: result.data === undefined ? null : result.data,
+        ...(result.meta ? { meta: result.meta } : {}),
+        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 executePlanOperation(operation, input, {
+            ctx,
+            host: createPlanHost(ctx),
+            continuation: createPlanContinuationSigner(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;
+    }
+}
+export const planShortcut = {
+    name: 'plan',
+    description: '泛微E10计划报告 CLI（查询/新建/修改/发布/撤回/提交提醒/评论）',
+    category: 'shortcut',
+    register({ program, action }) {
+        const plan = program.command('plan').description('泛微E10计划报告（报告详情/列表/新建/修改/发布/撤回/提交提醒/评论）');
+        plan.command('schema')
+            .description('Print plan operation manifest for agents')
+            .action(action((ctx) => {
+            ctx.output.write(planManifest, { json: true });
+        }));
+        plan.command('run')
+            .description('Run a plan operation with JSON input')
+            .argument('<operation>', 'operation name, e.g. plan.report.get')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .option('--input-json <json>', 'inline JSON input object')
+            .action(action(async (ctx, operation, options) => {
+            await executeAndPrint(ctx, String(operation), await inputFrom(options));
+        }));
+        // 高频便捷命令
+        plan.command('route')
+            .description('判定当前租户报告接口链路（plan.version.check 薄包装）')
+            .option('--refresh', '忽略 1 天租户缓存，强制重新判定')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'plan.version.check', opts.refresh ? { refresh: true } : {});
+        }));
+        plan.command('get')
+            .description('查询单份报告详情（plan.report.get 薄包装）')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .option('--input-json <json>', 'inline JSON input object')
+            .option('--id <id>', '报告 id')
+            .option('--year <year>', '报告年份')
+            .option('--type <type>', '报告类型：week/month/season/halfYear/year')
+            .option('--serial-number <n>', '报告周期')
+            .option('--creator-user-id <id>', '报告创建人 id')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'plan.report.get', await inputFrom(options, {
+                id: opts.id,
+                year: opts.year,
+                type: opts.type,
+                serialNumber: opts.serialNumber,
+                creatorUserId: opts.creatorUserId,
+            }));
+        }));
+        plan.command('list')
+            .description('分页查询报告列表（plan.report.page 薄包装）')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .option('--input-json <json>', 'inline JSON input object')
+            .option('--page-no <n>', '页码')
+            .option('--page-size <n>', '每页条数')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'plan.report.page', await inputFrom(options, {
+                pageNo: opts.pageNo,
+                pageSize: opts.pageSize,
+            }));
+        }));
+    },
+};

package/dist/shortcuts/plan/manifest.js

@@ -0,0 +1,53 @@
+import { planOperationDefinitions } from './operations/registry.js';
+/**
+ * 禁用边界：源资料未提供以下能力的实现依据，因此不生成对应 operation，或只能限定在某一链路。
+ * - eb 链路「撤回报告」为 ESB 动作流，源资料未给出动作流唯一标识（uniqueIndent）。
+ * - eb 链路未提供报告提交提醒、报告评论接口。
+ */
+const WITHHELD = [
+    {
+        name: 'plan.report.withdraw.eb',
+        reason: 'eb 链路撤回报告通过 ESB 动作流「eb撤回报告」实现，源资料未提供动作流 uniqueIndent，无法在本模块内触发；改由 weaver-e10-customesb-execute skill 执行同名动作流',
+    },
+    {
+        name: 'plan.report.remind.eb',
+        reason: 'eb 链路报告提交提醒接口未在源资料中给出，plan.report.remind.* 仅支持标准版链路',
+    },
+    {
+        name: 'plan.comment.list.eb',
+        reason: 'eb 链路报告评论接口未在源资料中给出，plan.comment.list 仅支持标准版链路',
+    },
+];
+function buildOperations() {
+    return planOperationDefinitions().map((definition) => ({
+        name: definition.name,
+        resource: definition.resource,
+        summary: definition.summary,
+        ...(definition.capability ? { capability: definition.capability } : {}),
+        risk: definition.risk,
+        ...(definition.requiresConfirmation ? { requiresConfirmation: true } : {}),
+        inputSchema: definition.inputSchema,
+    }));
+}
+export const planManifest = {
+    schemaVersion: 1,
+    name: 'plan',
+    title: '泛微E10计划报告（报告查询/新建/修改/发布/撤回/提交提醒/评论）',
+    version: '0.1.0',
+    host: 'e10-plan',
+    status: 'builtin',
+    sourceSkill: 'weaver-e10-plan',
+    capabilities: ['plan'],
+    /** 报告侧接口链路路由：先读租户缓存（1 天），未命中调用 plan_searchAppver 读取 ver_name。 */
+    linkRouting: {
+        versionInterface: 'plan_searchAppver',
+        versionField: 'ver_name',
+        ebWhen: 'V2',
+        cacheKeyPrefix: 'plan:version:',
+        cacheTtlSeconds: 86400,
+        ebFormTag: 'uf_plan_work_report',
+        ebAppTag: 'weaver-wrplan-eb',
+    },
+    operations: buildOperations(),
+    withheldOperations: WITHHELD,
+};

package/dist/shortcuts/plan/operations/link.js

@@ -0,0 +1,256 @@
+import { isPlanErrorType, planApiError } from '../errors.js';
+import { businessMessage, isDatajsonSuccess } from '../host.js';
+import { compact, ebMainTables, normalizeEbReport, normalizeStandardReport, optionValue, } from './shared.js';
+const PLAN_APP_TAG = 'weaver-wrplan-eb';
+export const PLAN_EB_FORM_TAG = 'uf_plan_work_report';
+const VERSION_CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+/** 源资料固定映射：租户 tt1pa2w2i3 的报告详情 eb 表单 id（idobjId）无需动态获取。 */
+const EB_FORM_ID_FIXED = {
+    tt1pa2w2i3: '1029659181695361024',
+};
+export function versionCacheKey(tenantKey) {
+    return `plan:version:${tenantKey}`;
+}
+export function ebFormCacheKey(tenantKey) {
+    return `plan:ebform:${tenantKey}`;
+}
+/**
+ * 版本路由：优先读租户缓存（1 天），未命中则调用 plan_searchAppver 读取 ver_name。
+ * `ver_name === 'V2'` → e10-ebuilder 链路；其它情况 → e10 标准版链路。
+ * 只有真正拿到版本答案时才写缓存；接口不可用时降级为标准版并提示，不写缓存。
+ */
+export async function resolveLink(host, options = {}) {
+    const session = await host.getSession();
+    const key = versionCacheKey(session.tenantKey);
+    if (!options.refresh) {
+        const cached = await host.getCache(key);
+        const value = cached && typeof cached === 'object' ? cached : null;
+        if (value && (value.link === 'standard' || value.link === 'eb')) {
+            return {
+                link: value.link,
+                verName: value.verName ?? null,
+                tenantKey: session.tenantKey,
+                cached: true,
+                degraded: false,
+                reason: null,
+                checkedAt: typeof value.checkedAt === 'string' ? value.checkedAt : new Date().toISOString(),
+            };
+        }
+    }
+    let verName = null;
+    let degraded = false;
+    let reason = null;
+    try {
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/ebuilder/form/formdata/v2/getFormDataList/plan_searchAppver',
+            operation: 'plan.version.check',
+            body: {
+                datajson: {
+                    mainTable: {},
+                    pageInfo: { pageNo: '1', pageSize: '10' },
+                    header: { operator: session.userId },
+                },
+            },
+        });
+        const mainTable = ebMainTables(response)[0];
+        verName = optionValue(mainTable?.ver_name) ?? null;
+    }
+    catch (error) {
+        if (isPlanErrorType(error, 'api')) {
+            degraded = true;
+            reason = error.message;
+        }
+        else {
+            throw error;
+        }
+    }
+    const link = verName === 'V2' ? 'eb' : 'standard';
+    const info = {
+        link,
+        verName,
+        tenantKey: session.tenantKey,
+        cached: false,
+        degraded,
+        reason,
+        checkedAt: new Date().toISOString(),
+    };
+    if (!degraded)
+        await host.setCache(key, info, VERSION_CACHE_TTL_MS);
+    return info;
+}
+function firstId(value) {
+    if (Array.isArray(value) && value.length > 0) {
+        const first = value[0];
+        if (typeof first === 'string' || typeof first === 'number')
+            return String(first);
+        if (first && typeof first === 'object') {
+            const record = first;
+            const candidate = record.id ?? record.idobjId ?? record.objId ?? record.value;
+            if (candidate !== undefined && candidate !== null && candidate !== '')
+                return String(candidate);
+        }
+    }
+    if (typeof value === 'string' || typeof value === 'number')
+        return String(value);
+    return undefined;
+}
+/** 获取 eb 报告详情页所需的表单 id（源资料：eb 表单 id 指 idobjId）。 */
+export async function resolveEbFormId(host) {
+    const session = await host.getSession();
+    const fixed = EB_FORM_ID_FIXED[session.tenantKey];
+    const templateOf = (idobjId) => `/sp/ebdfpage/card/0/${idobjId}/{reportId}`;
+    if (fixed) {
+        return {
+            appTag: PLAN_APP_TAG,
+            appId: null,
+            formTag: PLAN_EB_FORM_TAG,
+            idobjId: fixed,
+            source: 'fixed',
+            detailUrlTemplate: templateOf(fixed),
+        };
+    }
+    const key = ebFormCacheKey(session.tenantKey);
+    const cached = await host.getCache(key);
+    const cachedValue = cached && typeof cached === 'object' ? cached : null;
+    if (cachedValue && typeof cachedValue.idobjId === 'string' && cachedValue.idobjId) {
+        return {
+            appTag: PLAN_APP_TAG,
+            appId: typeof cachedValue.appId === 'string' ? cachedValue.appId : null,
+            formTag: PLAN_EB_FORM_TAG,
+            idobjId: cachedValue.idobjId,
+            source: 'cache',
+            detailUrlTemplate: templateOf(cachedValue.idobjId),
+        };
+    }
+    const appIdsResponse = await host.request({
+        method: 'GET',
+        path: '/api/bs/ebuilder/app/tags/getAppIds',
+        query: { tag: PLAN_APP_TAG },
+        operation: 'plan.eb.form.resolve',
+    }).catch(() => undefined);
+    const appId = firstId(appIdsResponse?.data);
+    if (!appId) {
+        throw planApiError('eb_app_not_found', '未检测到「计划报告」ebuilder 应用（appTag: weaver-wrplan-eb），无法生成报告详情页链接');
+    }
+    const formResponse = await host.request({
+        method: 'GET',
+        path: '/api/ebuilder/form/obj/getObjsByTag',
+        query: { tag: PLAN_EB_FORM_TAG, appId },
+        operation: 'plan.eb.form.resolve',
+    }).catch(() => undefined);
+    const idobjId = firstId(formResponse?.data);
+    if (!idobjId) {
+        throw planApiError('eb_form_not_found', '未找到报告详情 ebuilder 表单（tag: uf_plan_work_report），无法生成报告详情页链接');
+    }
+    const info = {
+        appTag: PLAN_APP_TAG,
+        appId,
+        formTag: PLAN_EB_FORM_TAG,
+        idobjId,
+        source: 'dynamic',
+        detailUrlTemplate: templateOf(idobjId),
+    };
+    // 源资料：取得当前租户报告详情 eb 表单 id 后长期缓存，后续不再动态获取。
+    await host.setCache(key, { appId, idobjId });
+    return info;
+}
+/** 生成报告详情页链接：标准版 /sp/plan/detail/{id}；eb 版 /sp/ebdfpage/card/0/{表单id}/{id}。 */
+export async function buildDetailUrl(host, link, reportId) {
+    if (!reportId)
+        return null;
+    if (link === 'standard')
+        return `/sp/plan/detail/${reportId}`;
+    const form = await resolveEbFormId(host);
+    return `/sp/ebdfpage/card/0/${form.idobjId}/${reportId}`;
+}
+function hasOwn(value, key) {
+    return Boolean(value && typeof value === 'object' && Object.prototype.hasOwnProperty.call(value, key));
+}
+/**
+ * 查询单个报告详情。
+ * 标准版：POST /api/workrelate/plan/workreport/view，按 id 或按周期（year+serialNumber+type+creatorUserId）。
+ * eb 版：POST plan_queryPlan，只支持按周期（creator+f_year+f_type+f_serial_number）。
+ */
+export async function lookupReport(host, link, query) {
+    const session = await host.getSession();
+    const warnings = [];
+    if (query.id) {
+        if (link === 'standard') {
+            const response = await host.request({
+                method: 'POST',
+                path: '/api/workrelate/plan/workreport/view',
+                query: { id: query.id },
+                operation: 'plan.report.get',
+            });
+            const hasReport = Boolean(hasOwn(response, 'workReport') && response.workReport);
+            const report = hasReport
+                ? normalizeStandardReport(response.workReport, await buildDetailUrl(host, 'standard', query.id))
+                : null;
+            return { link, exists: hasReport, report, precheck: 'checked', warnings };
+        }
+        // eb 版没有按 id 查询的详情接口：能拿到周期信息时用周期查询做一次校验，否则跳过预检。
+        if (query.year === undefined || !query.type || query.serialNumber === undefined) {
+            warnings.push('eb 链路没有按报告 id 查询详情的接口，缺少 year/type/serialNumber 时无法做写入前校验');
+            return { link, exists: null, report: null, precheck: 'skipped', warnings };
+        }
+        const byPeriod = await lookupReport(host, 'eb', {
+            year: query.year,
+            type: query.type,
+            serialNumber: query.serialNumber,
+            creatorUserId: query.creatorUserId,
+        });
+        if (byPeriod.report && byPeriod.report.reportId && byPeriod.report.reportId !== query.id) {
+            warnings.push(`按周期查询到的报告 id（${byPeriod.report.reportId}）与传入的 id（${query.id}）不一致`);
+            return { link, exists: false, report: null, precheck: 'checked', warnings };
+        }
+        return { ...byPeriod, warnings: [...warnings, ...byPeriod.warnings] };
+    }
+    if (query.year === undefined || !query.type || query.serialNumber === undefined) {
+        throw planApiError('lookup_incomplete', '按周期查询报告详情必须同时提供 year、type、serialNumber');
+    }
+    const creator = query.creatorUserId || session.userId;
+    if (link === 'standard') {
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/workrelate/plan/workreport/view',
+            query: {
+                year: query.year,
+                serialNumber: query.serialNumber,
+                type: query.type,
+                creatorUserId: creator,
+            },
+            operation: 'plan.report.get',
+        });
+        const hasReport = Boolean(hasOwn(response, 'workReport') && response.workReport);
+        const report = hasReport
+            ? normalizeStandardReport(response.workReport, await buildDetailUrl(host, 'standard', String(response.workReport.id ?? '')))
+            : null;
+        return { link, exists: hasReport, report, precheck: 'checked', warnings };
+    }
+    const response = await host.request({
+        method: 'POST',
+        path: '/api/ebuilder/form/formdata/v2/getFormDataByPk/plan_queryPlan',
+        operation: 'plan.report.get',
+        body: {
+            datajson: {
+                mainTable: compact({
+                    creator,
+                    f_year: query.year,
+                    f_type: query.type,
+                    f_serial_number: query.serialNumber,
+                }),
+                header: { operator: session.userId },
+            },
+        },
+    });
+    if (!isDatajsonSuccess(response)) {
+        throw planApiError('business_error', businessMessage(response), { response: businessMessage(response) });
+    }
+    const mainTable = ebMainTables(response)[0];
+    const exists = Boolean(mainTable && mainTable.id);
+    const report = exists
+        ? normalizeEbReport(mainTable, await buildDetailUrl(host, 'eb', String(mainTable.id)))
+        : null;
+    return { link, exists, report, precheck: 'checked', warnings };
+}