@xihe-lab/tapd-cli 2.0.0-rc.1 → 2.0.0-rc.2

package/dist/advisor/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/advisor/render.ts"],"names":[],"mappings":"AAAA,qDAAqD;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,wDAAwD;AACxD,MAAM,UAAU,kBAAkB,CAAC,IAAwB;IACzD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QAC3B,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;QAC7B,WAAW,EAAE,GAAG,CAAC,WAAW;KAC7B,CAAC,CAAC,CAAC;IACJ,OAAO,WAAW,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CACR,iBAAiB,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,4BAA4B,CAC/E,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,OAAO,OAAO,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,6EAA6E,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,WAAW,CAAC,IAAwB;IAClD,OAAO,IAAI,CAAC,SAAS,CACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACf,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5D,CAAC,CAAC,EACH,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,CAAC;AACX,CAAC"}

package/dist/commands/advisor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"advisor.d.ts","sourceRoot":"","sources":["../../src/commands/advisor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMxD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAwBrF"}
+{"version":3,"file":"advisor.d.ts","sourceRoot":"","sources":["../../src/commands/advisor.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAiBxD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CA+BrF"}

package/dist/commands/advisor.js

@@ -1,29 +1,47 @@
-import { buildAdvisorIndex, recommend } from '@xihe-lab/tapd-core';
-import { renderTable } from '../output/table.js';
+// tapd advisor（S7 增量，TAPD 需求 1139814312001001545）：
+// 在 core 轻量召回之上加「域轴 + 角色轴」——
+//   域轴：查询命中知识域关键词 → 该域 `tapd pm <domain> <scenario>` 候选置顶
+//         （场景清单经 pm/discovery 动态发现，templates/pm/ 无模板的域自动跳过）；
+//   角色轴：--persona dev|qa|pm 同一意图按角色重排（角色进排序特征，不进命名空间）。
+// 原子候选仍走 core recommend 召回，附 domain 特征字段（F9 LLM 排序预置特征）。
+import { buildAdvisorIndex } from '@xihe-lab/tapd-core';
+import { advisorJson, advisorNotes, advise, parsePersona, renderAdvisorTable, } from '../advisor/index.js';
+import { discoverPmTemplates } from '../pm/index.js';
 const DEFAULT_LIMIT = 10;
+function stderr(line) {
+    process.stderr.write(line + '\n');
+}
 export function registerAdvisorCommand(program, registry) {
-    const advisor = program.command('advisor').description('自然语言命令推荐（规则召回，零 LLM）');
+    const advisor = program.command('advisor').description('自然语言命令推荐（规则召回，零 LLM；命中知识域时优先 pm 场景）');
     advisor
         .argument('<query...>', '想完成的操作描述，中英文均可')
         .option('--json', '以 JSON 输出推荐结果')
+        .option('--persona <role>', '按角色重排候选: dev | qa | pm（角色进排序特征，不进命名空间）')
         .action((queryParts, options) => {
         const query = queryParts.join(' ').trim();
+        const persona = parsePersona(options.persona);
+        const catalog = discoverPmTemplates();
+        for (const w of catalog.warnings)
+            stderr(`warning: ${w}`);
         const index = buildAdvisorIndex(registry);
-        const hits = recommend(query, index, DEFAULT_LIMIT);
-        if (hits.length === 0) {
-            process.stderr.write(`advisor: 未找到与「${query}」相关的命令，可尝试英文关键词（如 story list、status update）\n`);
+        const result = advise(query, index, { persona, catalog, limit: DEFAULT_LIMIT });
+        if (result.hits.length === 0) {
+            const noTemplate = result.matchedDomains.length > 0
+                ? `（域 ${result.matchedDomains.join(' / ')} 暂无已收录的 pm 场景模板，放置 templates/pm/<domain>-<scenario>.yaml 即自动收录）`
+                : '';
+            stderr(`advisor: 未找到与「${query}」相关的命令，可尝试英文关键词（如 story list、status update）${noTemplate}`);
             return;
         }
         if (options.json) {
-            process.stdout.write(JSON.stringify(hits, null, 2) + '\n');
+            // stdout 保持裸数组机器可读；说明行走 stderr
+            for (const note of advisorNotes(result))
+                stderr(note);
+            process.stdout.write(advisorJson(result.hits));
             return;
         }
-        const rows = hits.map(hit => ({
-            COMMAND: hit.command,
-            WRITE: hit.write ? '✓' : '',
-            DESCRIPTION: hit.description,
-        }));
-        process.stdout.write(renderTable(rows, ['COMMAND', 'WRITE', 'DESCRIPTION']) + '\n');
+        process.stdout.write(renderAdvisorTable(result.hits) + '\n');
+        for (const note of advisorNotes(result))
+            process.stdout.write(note + '\n');
     });
 }
 //# sourceMappingURL=advisor.js.map

package/dist/commands/advisor.js.map

@@ -1 +1 @@
-{"version":3,"file":"advisor.js","sourceRoot":"","sources":["../../src/commands/advisor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB,MAAM,UAAU,sBAAsB,CAAC,OAAgB,EAAE,QAAsB;IAC7E,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC;IAC/E,OAAO;SACJ,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;SACxC,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC;SACjC,MAAM,CAAC,CAAC,UAAoB,EAAE,OAA2B,EAAE,EAAE;QAC5D,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;QACpD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,KAAK,+CAA+C,CAAC,CAAC;YAC5F,OAAO;QACT,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YAC3D,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YAC3B,WAAW,EAAE,GAAG,CAAC,WAAW;SAC7B,CAAC,CAAC,CAAC;QACJ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"advisor.js","sourceRoot":"","sources":["../../src/commands/advisor.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,6BAA6B;AAC7B,0DAA0D;AAC1D,6DAA6D;AAC7D,uDAAuD;AACvD,yDAAyD;AAIzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,WAAW,EACX,YAAY,EACZ,MAAM,EACN,YAAY,EACZ,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAgB,EAAE,QAAsB;IAC7E,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,qCAAqC,CAAC,CAAC;IAC9F,OAAO;SACJ,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;SACxC,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC;SACjC,MAAM,CAAC,kBAAkB,EAAE,wCAAwC,CAAC;SACpE,MAAM,CAAC,CAAC,UAAoB,EAAE,OAA6C,EAAE,EAAE;QAC9E,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;QACtC,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ;YAAE,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;QAEhF,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,UAAU,GACd,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;gBAC9B,CAAC,CAAC,MAAM,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,iEAAiE;gBAC1G,CAAC,CAAC,EAAE,CAAC;YACT,MAAM,CAAC,iBAAiB,KAAK,8CAA8C,UAAU,EAAE,CAAC,CAAC;YACzF,OAAO;QACT,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,+BAA+B;YAC/B,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,MAAM,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QAC7D,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,MAAM,CAAC;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/pipeline.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from 'commander';
+import { type TapdConfig, type ToolRegistry } from '@xihe-lab/tapd-core';
+export declare function registerPipelineCommand(program: Command, registry: ToolRegistry, config: TapdConfig): void;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/commands/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/commands/pipeline.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAA+B,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAiEtG,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CA8I1G"}

package/dist/commands/pipeline.js

@@ -0,0 +1,178 @@
+// tapd pipeline 命令组：run / validate / record / list（S1 引擎本体的 CLI 入口）
+// PipelineError 由 main 的 handleError 统一渲染（render() 与 CliError 同前缀风格）。
+import { writeFileSync } from 'node:fs';
+import { resolveConfig, resolveWrite } from '@xihe-lab/tapd-core';
+import { addGlobalOptions, makeClientFactory, parseOutputMode } from '../flags.js';
+import { CliError } from '../errors.js';
+import { EXIT } from '../exit-codes.js';
+import { assertTemplateValid, buildTemplateFromHistory, formatIssues, listBuiltinTemplates, loadTemplate, readHistory, renderTemplateYaml, runPipeline, validateTemplate, } from '../pipeline/index.js';
+function stderr(line) {
+    process.stderr.write(line + '\n');
+}
+function parseJsonInput(raw) {
+    if (!raw)
+        return {};
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message.split('\n')[0] : String(error);
+        throw new CliError('INVALID_ARGS', `--input 必须是合法 JSON: ${message}`);
+    }
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new CliError('INVALID_ARGS', '--input 必须是 JSON 对象（模板变量表），如 --input \'{"iteration_id":"123"}\'');
+    }
+    return parsed;
+}
+function writeEventsFile(filePath, content) {
+    writeFileSync(filePath, content);
+}
+function renderSummaryJson(summary) {
+    return JSON.stringify({
+        pipeline: summary.pipeline,
+        ok: summary.ok,
+        dryRun: summary.dryRun,
+        gateBlocked: summary.gateBlocked,
+        durationMs: summary.durationMs,
+        steps: summary.steps.map(s => ({
+            id: s.id,
+            uses: s.uses,
+            write: s.write,
+            status: s.status,
+            ...(s.skipReason ? { skipReason: s.skipReason } : {}),
+            ...(s.error ? { error: s.error } : {}),
+            ...(s.status === 'ok' ? { data: s.data } : {}),
+        })),
+        ...(summary.preview ? { preview: summary.preview } : {}),
+        ...(summary.report !== undefined ? { report: summary.report } : {}),
+    }, null, 2);
+}
+export function registerPipelineCommand(program, registry, config) {
+    const pipeline = program.command('pipeline').description('工作流编排引擎（yaml/json 模板，F8）');
+    addGlobalOptions(pipeline);
+    const run = pipeline
+        .command('run')
+        .description('执行工作流模板（写步骤默认 dry-run 闸门，--yes 确认落库）')
+        .argument('<file>', '模板路径，或内置模板名（如 iteration-review）')
+        .option('--input <json>', '模板变量注入（JSON 对象），优先级高于模板 vars')
+        .option('--iteration <id>', '迭代 ID 便捷注入（等价 --input \'{"iteration_id":"<id>"}\'）')
+        .option('--dry-run', '只打印执行计划预览，不执行任何步骤')
+        .option('--yes', '确认执行写步骤（含写步骤的模板缺省时强制 dry-run 并拒绝落库）')
+        .option('--events <file>', '事件流 JSONL 输出路径');
+    run.addHelpText('after', [
+        'Examples:',
+        '  $ tapd pipeline run templates/iteration-review.yaml --iteration 1001',
+        '  $ tapd pipeline run deliver-story --input \'{"story_id":"1140..."}\' --yes',
+        '  $ tapd pipeline run triage-bugs.yaml --dry-run --events run.jsonl',
+    ].join('\n'));
+    addGlobalOptions(run);
+    run.action(async (file, options, command) => {
+        const globals = { ...program.opts(), ...command.opts() };
+        const input = parseJsonInput(options.input);
+        const vars = {
+            ...(options.iteration ? { iteration_id: options.iteration } : {}),
+            ...input,
+        };
+        const { template } = loadTemplate(file);
+        assertTemplateValid(template, registry);
+        const resolved = resolveConfig(globals, config);
+        const summary = await runPipeline(template, {
+            registry,
+            clientFactory: makeClientFactory(globals),
+            vars,
+            defaultArgs: globals.workspaceId !== undefined ? { workspace_id: globals.workspaceId } : {},
+            readOnly: resolved.readOnly,
+            timeoutMs: resolved.timeoutMs,
+            dryRun: Boolean(options.dryRun),
+            yes: Boolean(options.yes),
+            eventsPath: options.events,
+            log: line => stderr(line),
+        }, writeEventsFile);
+        const outputMode = parseOutputMode(globals.output);
+        if (outputMode === 'json') {
+            process.stdout.write(renderSummaryJson(summary) + '\n');
+        }
+        else if (summary.report !== undefined) {
+            process.stdout.write(summary.report + '\n');
+        }
+        if (summary.gateBlocked) {
+            stderr('error: WRITE_GATE: 含写步骤的模板未加 --yes，已拒绝落库（确认后重跑，或保持 --dry-run 仅预览）');
+            process.exitCode = EXIT.USAGE;
+            return;
+        }
+        if (!summary.ok) {
+            const failedSteps = summary.steps.filter(s => s.status === 'failed');
+            stderr(`error: STEP_FAILED: pipeline 中断，${failedSteps.length} 个步骤失败: ${failedSteps.map(s => s.id).join(', ')}`);
+            process.exitCode = EXIT.RUNTIME;
+        }
+    });
+    const validate = pipeline
+        .command('validate')
+        .description('静态校验模板：命令存在性、参数 zod schema、写步骤标记、表达式语法、引用完整性')
+        .argument('<file>', '模板路径，或内置模板名')
+        .option('--json', '以 JSON 输出校验结果');
+    addGlobalOptions(validate);
+    validate.action((file, options) => {
+        const { template, path } = loadTemplate(file);
+        const result = validateTemplate(template, registry);
+        if (options.json) {
+            process.stdout.write(JSON.stringify({ ok: result.ok, template: template.name, path, errors: result.errors, warnings: result.warnings, writeSteps: result.writeSteps }, null, 2) + '\n');
+        }
+        else {
+            const lines = [
+                `template: ${template.name} (${path})`,
+                `write steps: ${result.writeSteps.length ? result.writeSteps.join(', ') : '(none)'}`,
+            ];
+            if (result.errors.length)
+                lines.push(formatIssues(result.errors));
+            if (result.warnings.length)
+                lines.push(formatIssues(result.warnings));
+            lines.push(result.ok ? '✓ 校验通过' : `✗ 校验未通过（${result.errors.length} 个错误）`);
+            process.stdout.write(lines.join('\n') + '\n');
+        }
+        if (!result.ok)
+            process.exitCode = EXIT.USAGE;
+    });
+    const record = pipeline
+        .command('record')
+        .description('把最近执行的 CLI 命令历史录制为 yaml 模板（数据源 ~/.tapd/history.jsonl）')
+        .option('--last <n>', '取最近 N 条成功命令', '20')
+        .option('--name <name>', '模板名', 'recorded-pipeline')
+        .option('--title <title>', '模板标题')
+        .option('--out <file>', '写入文件而非 stdout');
+    addGlobalOptions(record);
+    record.action((options) => {
+        const limit = Number.parseInt(options.last, 10);
+        if (Number.isNaN(limit) || limit <= 0) {
+            throw new CliError('INVALID_ARGS', `--last 必须是正整数，got "${String(options.last)}"`);
+        }
+        const entries = readHistory(limit);
+        if (entries.length === 0) {
+            stderr('error: STEP_FAILED: 命令历史为空，先执行若干 tapd 命令再录制（TAPD_CLI_NO_HISTORY=1 会关闭记录）');
+            process.exitCode = EXIT.RUNTIME;
+            return;
+        }
+        const template = buildTemplateFromHistory(entries, { name: options.name, title: options.title }, tool => {
+            const def = registry.get(tool);
+            return def ? resolveWrite(def) : false;
+        });
+        const yaml = renderTemplateYaml(template);
+        const out = options.out;
+        if (out) {
+            writeFileSync(out, yaml);
+            process.stdout.write(`recorded ${entries.length} command(s) → ${out}\n`);
+        }
+        else {
+            process.stdout.write(yaml);
+        }
+    });
+    const list = pipeline.command('list').description('列出内置模板');
+    addGlobalOptions(list);
+    list.action(() => {
+        for (const tpl of listBuiltinTemplates()) {
+            process.stdout.write(`${tpl.write ? '[write]' : '[read] '} ${tpl.name}${tpl.title ? ` — ${tpl.title}` : ''}\n`);
+        }
+    });
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/commands/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/commands/pipeline.ts"],"names":[],"mappings":"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"}

package/dist/commands/pm.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from 'commander';
+import { type TapdConfig, type ToolRegistry } from '@xihe-lab/tapd-core';
+export declare function registerPmCommand(program: Command, registry: ToolRegistry, config: TapdConfig): void;
+//# sourceMappingURL=pm.d.ts.map

package/dist/commands/pm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm.d.ts","sourceRoot":"","sources":["../../src/commands/pm.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAiB,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AA6DxF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAqDpG"}

package/dist/commands/pm.js

@@ -0,0 +1,175 @@
+// tapd pm 命令组：管理语义层框架（S2，TAPD 需求 1139814312001001540）
+//
+// 红线（tapd-2.0.0-pm-layer-design.md §1.2）：pm 是编排层不是新实体——每个场景命令
+// = 一份 pipeline 模板的语义别名，执行复用 S1 runPipeline 引擎，不直接实现新 API 调用。
+//
+// 结构：
+//   tapd pm list [--domain <d>]              场景清单（域/场景/是否写/来源）
+//   tapd pm <domain> <scenario> [flags]      别名执行（域子命令按目录发现动态注册）
+//   tapd pm --help                           八域分组（中文 + 高项第4版章节号）
+//   tapd pm <domain> --help                  该域场景清单
+//
+// 零代码注册：help 分组与域子命令清单由「模板发现 × 域表」动态渲染，后续波次往
+// templates/pm/ 丢 yaml 即被收录（templates/pm/README.md 有约定说明）。
+import { resolveConfig } from '@xihe-lab/tapd-core';
+import { addGlobalOptions, makeClientFactory, parseOutputMode } from '../flags.js';
+import { CliError } from '../errors.js';
+import { EXIT } from '../exit-codes.js';
+import { PM_DOMAINS, findDomain } from '../pm/index.js';
+import { discoverPmTemplates, loadPmTemplate, resolvePmEntry, } from '../pm/index.js';
+import { probeDefaultIteration } from '../pm/index.js';
+import { renderDomainHelp, renderPmHelp, renderPmList } from '../pm/index.js';
+import { assertTemplateValid, runPipeline } from '../pipeline/index.js';
+function stderr(line) {
+    process.stderr.write(line + '\n');
+}
+// 与 commands/pipeline.ts 的同名局部函数保持同构（该文件归 S1 所有，避免跨波次 diff）
+function parseJsonInput(raw) {
+    if (!raw)
+        return {};
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message.split('\n')[0] : String(error);
+        throw new CliError('INVALID_ARGS', `--input 必须是合法 JSON: ${message}`);
+    }
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new CliError('INVALID_ARGS', '--input 必须是 JSON 对象（模板变量表），如 --input \'{"iteration_id":"123"}\'');
+    }
+    return parsed;
+}
+function renderSummaryJson(summary) {
+    return JSON.stringify({
+        pipeline: summary.pipeline,
+        ok: summary.ok,
+        dryRun: summary.dryRun,
+        gateBlocked: summary.gateBlocked,
+        durationMs: summary.durationMs,
+        steps: summary.steps.map(s => ({
+            id: s.id,
+            uses: s.uses,
+            write: s.write,
+            status: s.status,
+            ...(s.skipReason ? { skipReason: s.skipReason } : {}),
+            ...(s.error ? { error: s.error } : {}),
+            ...(s.status === 'ok' ? { data: s.data } : {}),
+        })),
+        ...(summary.preview ? { preview: summary.preview } : {}),
+        ...(summary.report !== undefined ? { report: summary.report } : {}),
+    }, null, 2);
+}
+export function registerPmCommand(program, registry, config) {
+    const catalog = discoverPmTemplates();
+    const pm = program.command('pm').description('管理语义层（软考高项知识域场景，编排既有原子命令）');
+    addGlobalOptions(pm);
+    pm.addHelpText('after', renderPmHelp(catalog));
+    pm.action(() => {
+        pm.outputHelp();
+    });
+    // ---- tapd pm list ----
+    const list = pm
+        .command('list')
+        .description('列出可用的 pm 场景模板（内置 + 用户覆盖），显示 域/场景名/是否写')
+        .option('--domain <key>', '按域过滤');
+    addGlobalOptions(list);
+    list.action((options, command) => {
+        const globals = { ...program.opts(), ...command.opts() };
+        for (const w of catalog.warnings)
+            stderr(`warning: ${w}`);
+        let entries = catalog.entries;
+        const domainFilter = options.domain;
+        if (domainFilter) {
+            if (!findDomain(domainFilter) && !entries.some(e => e.domain === domainFilter)) {
+                throw new CliError('INVALID_ARGS', `未知域 "${domainFilter}"，可用域: ${PM_DOMAINS.map(d => d.key).join(', ')}`);
+            }
+            entries = entries.filter(e => e.domain === domainFilter);
+        }
+        const outputMode = parseOutputMode(globals.output);
+        if (outputMode === 'json') {
+            process.stdout.write(JSON.stringify(entries, null, 2) + '\n');
+        }
+        else {
+            process.stdout.write(renderPmList(entries) + '\n');
+        }
+    });
+    // ---- tapd pm <domain> <scenario> ----
+    // 域子命令 = 域表 8 域 ∪ 目录中发现的自定义域（后者 help 归「其他」，但同样可执行）
+    const domainKeys = [...PM_DOMAINS.map(d => d.key), ...new Set(catalog.entries.filter(e => !e.domainKnown).map(e => e.domain))];
+    for (const key of domainKeys) {
+        const meta = findDomain(key);
+        const sub = pm
+            .command(key)
+            .description(meta ? `${meta.zh}（高项第4版 ${meta.chapter}）场景命令` : '自定义域场景命令')
+            .argument('<scenario>', `场景名（tapd pm ${key} --help 查看清单）`)
+            .option('--iteration <id>', '迭代 ID 作用域（缺省自动取最新 open 迭代，过滤 zzz-delete-me*）')
+            .option('--input <json>', '模板变量注入（JSON 对象），优先级低于 --iteration')
+            .option('--dry-run', '只打印执行计划预览，不执行任何步骤')
+            .option('--yes', '确认执行写步骤（含写步骤的模板缺省强制 dry-run 并拒绝落库）');
+        addGlobalOptions(sub);
+        sub.addHelpText('after', renderDomainHelp(key, catalog));
+        sub.action(async (scenario, options, command) => {
+            await runScenario(program, registry, config, catalog, key, scenario, options, command);
+        });
+    }
+}
+/** 别名执行：解析模板 → 校验 → --iteration 缺省解析 → runPipeline（与 pipeline run 同构） */
+async function runScenario(program, registry, config, catalog, domainKey, scenario, options, command) {
+    for (const w of catalog.warnings)
+        stderr(`warning: ${w}`);
+    const entry = resolvePmEntry(catalog, domainKey, scenario);
+    const { template } = loadPmTemplate(entry);
+    assertTemplateValid(template, registry);
+    const globals = { ...program.opts(), ...command.opts() };
+    const vars = parseJsonInput(options.input);
+    if (options.iteration) {
+        vars.iteration_id = options.iteration;
+    }
+    else {
+        const probe = await probeDefaultIteration(registry, makeClientFactory(globals), {
+            defaultArgs: globals.workspaceId !== undefined ? { workspace_id: globals.workspaceId } : {},
+            timeoutMs: resolveConfig(globals, config).timeoutMs,
+        });
+        if (probe.status === 'resolved') {
+            vars.iteration_id = probe.iteration.id;
+            stderr(`iteration: 自动选择 open 迭代 ${probe.iteration.id}${probe.iteration.name ? `（${probe.iteration.name}）` : ''}，可用 --iteration 覆盖`);
+        }
+        else if (probe.status === 'none') {
+            stderr('warning: 未提供 --iteration 且未找到可用的 open 迭代（已过滤 zzz-delete-me*），模板将收到空迭代变量');
+        }
+        else {
+            stderr(`warning: 默认迭代探测失败（${probe.message}），未注入迭代变量；可用 --iteration 显式指定`);
+        }
+    }
+    const resolved = resolveConfig(globals, config);
+    const summary = await runPipeline(template, {
+        registry,
+        clientFactory: makeClientFactory(globals),
+        vars,
+        defaultArgs: globals.workspaceId !== undefined ? { workspace_id: globals.workspaceId } : {},
+        readOnly: resolved.readOnly,
+        timeoutMs: resolved.timeoutMs,
+        dryRun: Boolean(options.dryRun),
+        yes: Boolean(options.yes),
+        log: line => stderr(line),
+    });
+    const outputMode = parseOutputMode(globals.output);
+    if (outputMode === 'json') {
+        process.stdout.write(renderSummaryJson(summary) + '\n');
+    }
+    else if (summary.report !== undefined) {
+        process.stdout.write(summary.report + '\n');
+    }
+    if (summary.gateBlocked) {
+        stderr('error: WRITE_GATE: 含写步骤的场景未加 --yes，已拒绝落库（确认后重跑，或保持 --dry-run 仅预览）');
+        process.exitCode = EXIT.USAGE;
+        return;
+    }
+    if (!summary.ok) {
+        const failedSteps = summary.steps.filter(s => s.status === 'failed');
+        stderr(`error: STEP_FAILED: 场景执行中断，${failedSteps.length} 个步骤失败: ${failedSteps.map(s => s.id).join(', ')}`);
+        process.exitCode = EXIT.RUNTIME;
+    }
+}
+//# sourceMappingURL=pm.js.map

package/dist/commands/pm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm.js","sourceRoot":"","sources":["../../src/commands/pm.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export { buildProgram } from './program.js';
 export { CliError } from './errors.js';
 export { EXIT } from './exit-codes.js';
+export * from './pipeline/index.js';
+export * from './pm/index.js';
 export declare function main(argv?: string[]): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBvE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAE9B,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBvE"}

package/dist/index.js

@@ -3,9 +3,12 @@ import { allTools, ToolRegistry, applyConfigToEnv, loadConfig } from '@xihe-lab/
 import { buildProgram } from './program.js';
 import { CliError } from './errors.js';
 import { EXIT } from './exit-codes.js';
+import { PipelineError } from './pipeline/types.js';
 export { buildProgram } from './program.js';
 export { CliError } from './errors.js';
 export { EXIT } from './exit-codes.js';
+export * from './pipeline/index.js';
+export * from './pm/index.js';
 export async function main(argv = process.argv) {
     const start = process.hrtime.bigint();
     const registry = new ToolRegistry();
@@ -30,6 +33,11 @@ function handleError(error) {
         process.exitCode = error.exitCode;
         return;
     }
+    if (error instanceof PipelineError) {
+        process.stderr.write(`${error.render()}\n`);
+        process.exitCode = error.exitCode;
+        return;
+    }
     if (error instanceof CommanderError) {
         const isHelp = error.code === 'commander.helpDisplayed' || error.code === 'commander.version';
         process.exitCode = isHelp ? EXIT.OK : EXIT.USAGE;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAmB,MAAM,qBAAqB,CAAC;AAC5G,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,OAAiB,OAAO,CAAC,IAAI;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5B,MAAM,MAAM,GAAe,UAAU,EAAE,CAAC;IACxC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/C,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,GAAG,EAAE,CAAC;QACxC,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;QACzD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,WAAW,CAAC,CAAC;IAC9G,CAAC;IACD,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC5C,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAClC,OAAO;IACT,CAAC;IACD,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,KAAK,yBAAyB,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,CAAC;QAC9F,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QACjD,OAAO;IACT,CAAC;IACD,MAAM,KAAK,CAAC;AACd,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAmB,MAAM,qBAAqB,CAAC;AAC5G,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAE9B,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,OAAiB,OAAO,CAAC,IAAI;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5B,MAAM,MAAM,GAAe,UAAU,EAAE,CAAC;IACxC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/C,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,GAAG,EAAE,CAAC;QACxC,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;QACzD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,WAAW,CAAC,CAAC;IAC9G,CAAC;IACD,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC5C,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAClC,OAAO;IACT,CAAC;IACD,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;QACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC5C,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAClC,OAAO;IACT,CAAC;IACD,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,KAAK,yBAAyB,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,CAAC;QAC9F,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QACjD,OAAO;IACT,CAAC;IACD,MAAM,KAAK,CAAC;AACd,CAAC"}

package/dist/pipeline/engine.d.ts

@@ -0,0 +1,38 @@
+import type { TapdClient, ToolRegistry } from '@xihe-lab/tapd-core';
+import type { PipelineTemplate, PlanEntry, RunSummary } from './types.js';
+export interface RunOptions {
+    registry: ToolRegistry;
+    clientFactory: () => TapdClient;
+    /** 最终变量表（模板 vars ← --iteration ← --input 合并后的结果） */
+    vars?: Record<string, unknown>;
+    /** 注入每个工具步骤的兜底参数（如全局 --workspace-id），步骤 args 显式值优先 */
+    defaultArgs?: Record<string, unknown>;
+    readOnly?: boolean;
+    timeoutMs?: number;
+    /** 显式 --dry-run（打印预览、不执行、退出码 0） */
+    dryRun?: boolean;
+    /** 写闸门放行标记（--yes） */
+    yes?: boolean;
+    /** 事件流 JSONL 输出路径 */
+    eventsPath?: string;
+    /** 进度输出（人类可读，走 stderr，保证 stdout 管道纯净） */
+    log?: (line: string) => void;
+}
+interface StepNode {
+    id: string;
+    uses?: string;
+    expr?: string;
+    args: Record<string, unknown>;
+    where?: string;
+    filter?: string;
+    deps: string[];
+    write: boolean;
+}
+/** Kahn 分层：无依赖关系的步骤进入同一波次并发执行 */
+export declare function planWaves(nodes: StepNode[]): string[][];
+/** 生成执行计划（dry-run / 写闸门预览）：vars 尽力插值，步骤间引用保留原表达式 */
+export declare function buildPreview(template: PipelineTemplate, registry: ToolRegistry, vars: Record<string, unknown>): PlanEntry[];
+export declare function renderPreview(template: PipelineTemplate, preview: PlanEntry[], headline: string): string;
+export declare function runPipeline(template: PipelineTemplate, opts: RunOptions, writeEvents?: (path: string, content: string) => void): Promise<RunSummary>;
+export {};
+//# sourceMappingURL=engine.d.ts.map

package/dist/pipeline/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/pipeline/engine.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAe,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIjF,OAAO,KAAK,EAAiB,gBAAgB,EAAE,SAAS,EAAE,UAAU,EAAe,MAAM,YAAY,CAAC;AAItG,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,YAAY,CAAC;IACvB,aAAa,EAAE,MAAM,UAAU,CAAC;IAChC,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qBAAqB;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,qBAAqB;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,UAAU,QAAQ;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AA0BD,iCAAiC;AACjC,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,EAAE,CAoCvD;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CA0B3H;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAuBxG;AA0BD,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,UAAU,EAChB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GACpD,OAAO,CAAC,UAAU,CAAC,CAgIrB"}