/** * commands/schedule/trigger.ts — 手动触发定时任务 (v2.1+ 三层接入) * * API: POST /api/scheduletask/white/trigger * * v2.1+ (2026-07-21) 三层接入: * L1: --verbose / --json (trigger result 仅 stdout, 无 id 生成, 不走 runCommandAutoFix 但走 stdout 三模式) * L3: 触发结果落 CommandLog, 失败也落 (W11-D4 手动触发验证的可见性) */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { setupOutputFilter, printCommandEnd } from '../_output_filter.ts' // v2.1+ (2026-07-21): stdout 三模式 + CommandLog 落盘 interface TriggerOpts { id: string verbose?: boolean json?: boolean } export function buildScheduleTriggerCommand(): Command { const cmd = new Command('trigger') .description('手动触发定时任务 (白名单, 不等 cron)') .requiredOption('--id ', '定时任务 id') .option('--verbose', '完整输出 (含 step machine、API 调用等过程日志)', false) .option('--json', '原始 JSON 输出', false) .action(async (opts: TriggerOpts) => { // v2.1+ L1: stdout 三模式 setupOutputFilter(opts) const c = await JnpfClient.fromToken() const startTime = Date.now() const r = await c.postJson('/scheduletask/white/trigger', { id: opts.id }) if (r.code !== 200) { log.error(`schedule trigger 失败: ${r.msg}`) // v2.1+ L3: 失败落 CommandLog printCommandEnd({ command: 'schedule trigger', appCode: c.appCode, result: 'failure', summary: { id: opts.id }, error: r.msg || `code=${r.code}`, duration_ms: Date.now() - startTime, verbose: opts.verbose, json: opts.json, }) process.exit(1) } log.ok(`✓ 定时任务 id=${opts.id} 已触发`) // v2.1+ L3: 成功落 CommandLog printCommandEnd({ command: 'schedule trigger', appCode: c.appCode, summary: { id: opts.id }, duration_ms: Date.now() - startTime, verbose: opts.verbose, json: opts.json, }) }) installHelpHook(cmd, { purpose: '手动触发定时任务 (不等 cron, 立即跑)', required: { '--id': '定时任务 id' }, example: 'dacli schedule trigger --id=1234567890', source: { web: 'web/apps/jnpf-web-apps-main/src/views/teamwork/schedule/Form.vue', api: 'POST /api/scheduletask/white/trigger', ref: 'doc/v0.8-endpoints.md §2.5', }, notes: [ '**W11-D4**: 验证定时任务真触发走此命令 + schedule log 拉日志', ], }) return cmd }