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

package/dist/pipeline/record.test.js

@@ -0,0 +1,109 @@
+import assert from 'node:assert/strict';
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { allTools, ToolRegistry, resolveWrite } from '@xihe-lab/tapd-core';
+import YAML from 'yaml';
+import { historyPath, readHistory, recordCommandHistory } from './history.js';
+import { buildTemplateFromHistory, renderTemplateYaml } from './record.js';
+import { parseTemplate, resolveTemplatePath } from './template.js';
+import { validateTemplate } from './validate.js';
+const sandboxDir = mkdtempSync(path.join(tmpdir(), 'tapd-history-test-'));
+const sandboxFile = path.join(sandboxDir, 'history.jsonl');
+const originalPath = process.env.TAPD_HISTORY_PATH;
+process.env.TAPD_HISTORY_PATH = sandboxFile;
+const registry = new ToolRegistry();
+registry.register(allTools);
+const audit = (tool, ok = true) => ({
+    ts: new Date().toISOString(),
+    entry: 'cli',
+    tool,
+    args: { id: '1001' },
+    ok,
+    durationMs: 5,
+});
+const checks = [
+    ['recordCommandHistory: 成功命令追加 JSONL，失败命令不记录', () => {
+            recordCommandHistory(audit('tapd_get_stories'));
+            recordCommandHistory(audit('tapd_update_story'));
+            recordCommandHistory(audit('tapd_get_bugs', false));
+            const entries = readHistory(10);
+            assert.deepEqual(entries.map(e => e.tool), ['tapd_get_stories', 'tapd_update_story']);
+            assert.equal(entries[0].args.id, '1001');
+            assert.ok(historyPath().startsWith(sandboxDir));
+        }],
+    ['readHistory: --last 截取最近 N 条', () => {
+            const entries = readHistory(1);
+            assert.equal(entries.length, 1);
+            assert.equal(entries[0].tool, 'tapd_update_story');
+        }],
+    ['readHistory: 损坏行被跳过', () => {
+            writeFileSync(sandboxFile, readHistory(10).map(e => JSON.stringify(e)).concat('{broken').join('\n') + '\n');
+            assert.equal(readHistory(10).length, 2);
+        }],
+    ['buildTemplateFromHistory: 写命令经 write-policy 判定 → 模板自动 write: true', () => {
+            const entries = readHistory(10);
+            const isWrite = (tool) => {
+                const def = registry.get(tool);
+                return def ? resolveWrite(def) : false;
+            };
+            const template = buildTemplateFromHistory(entries, { name: 'recorded', title: '录制' }, isWrite);
+            assert.equal(template.write, true, 'tapd_update_story 命中写策略');
+            assert.equal(template.name, 'recorded');
+            assert.equal(template.steps.length, 2);
+            assert.equal(template.steps[1].uses, 'tapd_update_story');
+        }],
+    ['buildTemplateFromHistory: 全只读历史 → 模板不带 write 标记', () => {
+            const isWrite = (tool) => {
+                const def = registry.get(tool);
+                return def ? resolveWrite(def) : false;
+            };
+            const template = buildTemplateFromHistory([{ ts: 't', tool: 'tapd_get_bugs', args: {}, durationMs: 1 }], { name: 'read-only-rec' }, isWrite);
+            assert.equal(template.write, undefined);
+        }],
+    ['录制产物闭环: record → yaml → parse → validate 全绿', () => {
+            const isWrite = (tool) => {
+                const def = registry.get(tool);
+                return def ? resolveWrite(def) : false;
+            };
+            const template = buildTemplateFromHistory(readHistory(10), { name: 'recorded-roundtrip' }, isWrite);
+            const yaml = renderTemplateYaml(template);
+            const reparsed = parseTemplate(yaml, 'roundtrip');
+            assert.equal(reparsed.name, 'recorded-roundtrip');
+            const result = validateTemplate(reparsed, registry);
+            assert.equal(result.ok, true, JSON.stringify(result.errors));
+            const roundtrip = YAML.parse(yaml);
+            assert.equal(roundtrip.steps[0].args.id, '1001');
+        }],
+    ['resolveTemplatePath: 录制产物写入内置目录后可用裸名解析（临时目录模拟）', () => {
+            // 不真的写入包目录（避免污染仓库），只验证解析逻辑对扩展名回退的行为
+            assert.throws(() => resolveTemplatePath('definitely-not-a-template'), Error);
+        }],
+];
+let failed = 0;
+try {
+    for (const [name, fn] of checks) {
+        try {
+            await fn();
+            console.log(`ok - ${name}`);
+        }
+        catch (error) {
+            failed++;
+            console.error(`FAIL - ${name}`);
+            console.error(error);
+        }
+    }
+}
+finally {
+    if (originalPath === undefined)
+        delete process.env.TAPD_HISTORY_PATH;
+    else
+        process.env.TAPD_HISTORY_PATH = originalPath;
+    rmSync(sandboxDir, { recursive: true, force: true });
+}
+if (failed > 0) {
+    console.error(`\n${failed}/${checks.length} failed`);
+    process.exit(1);
+}
+console.log(`\n${checks.length}/${checks.length} passed`);
+//# sourceMappingURL=record.test.js.map

package/dist/pipeline/record.test.js.map

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

package/dist/pipeline/template.d.ts

@@ -0,0 +1,24 @@
+import { type PipelineTemplate } from './types.js';
+/** 内置模板目录：dist/commands → packages/cli/templates（src 同深度，tsx 下同样成立） */
+export declare function builtinTemplatesDir(): string;
+export declare function parseTemplate(source: string, label: string): PipelineTemplate;
+/**
+ * 解析模板位置：
+ *   1. 裸名（iteration-review）→ 内置模板目录
+ *   2. 相对/绝对路径（templates/pm/risk-scan.yaml）→ 相对 cwd；不存在时回退内置目录
+ *      （cwd 形如 "templates/xxx.yaml" 时，内置目录侧自动剥掉 templates/ 前缀再试）
+ * 内置目录命中支持缺省扩展名。
+ */
+export declare function resolveTemplatePath(ref: string): string;
+export declare function loadTemplate(ref: string): {
+    template: PipelineTemplate;
+    path: string;
+};
+/** 内置模板清单（tapd pipeline list / 后续 pm 层复用） */
+export declare function listBuiltinTemplates(): {
+    name: string;
+    title: string;
+    write: boolean;
+    file: string;
+}[];
+//# sourceMappingURL=template.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/pipeline/template.ts"],"names":[],"mappings":"AAOA,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAElE,uEAAuE;AACvE,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAoCD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,CA+B7E;AAID;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmBvD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAUtF;AAED,6CAA6C;AAC7C,wBAAgB,oBAAoB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAatG"}

package/dist/pipeline/template.js

@@ -0,0 +1,134 @@
+// 模板加载：yaml/json 解析、结构校验、内置模板解析（裸名 / templates/ 相对名 / 绝对路径）
+import { readFileSync, existsSync, statSync, readdirSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+import YAML from 'yaml';
+import { z } from 'zod';
+import { PipelineError } from './types.js';
+/** 内置模板目录：dist/commands → packages/cli/templates（src 同深度，tsx 下同样成立） */
+export function builtinTemplatesDir() {
+    return fileURLToPath(new URL('../../templates/', import.meta.url));
+}
+const stepSchema = z
+    .object({
+    id: z.string().min(1),
+    uses: z.string().min(1).optional(),
+    expr: z.string().min(1).optional(),
+    args: z.record(z.unknown()).optional(),
+    where: z.string().optional(),
+    filter: z.string().optional(),
+    depends_on: z.array(z.string()).optional(),
+})
+    .strict()
+    .refine(step => Boolean(step.uses) !== Boolean(step.expr), {
+    message: '步骤必须且只能声明 uses（工具步骤）或 expr（本地表达式步骤）之一',
+});
+const templateSchema = z
+    .object({
+    name: z.string().min(1),
+    title: z.string().optional(),
+    write: z.boolean().optional(),
+    domain: z.string().optional(),
+    unwrap: z.boolean().optional(),
+    vars: z.record(z.unknown()).optional(),
+    steps: z.array(stepSchema).min(1, { message: 'steps 不能为空' }),
+    report: z
+        .object({
+        format: z.enum(['markdown', 'text', 'json']).optional(),
+        template: z.string().optional(),
+    })
+        .strict()
+        .optional(),
+})
+    .strict();
+export function parseTemplate(source, label) {
+    let raw;
+    try {
+        raw = YAML.parse(source);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message.split('\n')[0] : String(error);
+        throw new PipelineError('TEMPLATE_INVALID', `模板解析失败（${label}）: ${message}`);
+    }
+    const parsed = templateSchema.safeParse(raw);
+    if (!parsed.success) {
+        const issues = parsed.error.issues.map(issue => `${issue.path.join('.') || '(root)'}: ${issue.message}`);
+        throw new PipelineError('TEMPLATE_INVALID', `模板结构不合法（${label}）`, issues);
+    }
+    const doc = parsed.data;
+    const ids = new Set();
+    for (const step of doc.steps) {
+        if (ids.has(step.id)) {
+            throw new PipelineError('TEMPLATE_INVALID', `模板结构不合法（${label}）`, [`步骤 id 重复: ${step.id}`]);
+        }
+        ids.add(step.id);
+    }
+    for (const step of doc.steps) {
+        for (const dep of step.depends_on ?? []) {
+            if (!ids.has(dep)) {
+                throw new PipelineError('TEMPLATE_INVALID', `模板结构不合法（${label}）`, [
+                    `steps.${step.id}.depends_on 引用了不存在的步骤: ${dep}`,
+                ]);
+            }
+        }
+    }
+    return doc;
+}
+const TEMPLATE_EXTS = ['.yaml', '.yml', '.json'];
+/**
+ * 解析模板位置：
+ *   1. 裸名（iteration-review）→ 内置模板目录
+ *   2. 相对/绝对路径（templates/pm/risk-scan.yaml）→ 相对 cwd；不存在时回退内置目录
+ *      （cwd 形如 "templates/xxx.yaml" 时，内置目录侧自动剥掉 templates/ 前缀再试）
+ * 内置目录命中支持缺省扩展名。
+ */
+export function resolveTemplatePath(ref) {
+    const looksLikePath = ref.includes('/') || ref.includes('\\') || TEMPLATE_EXTS.includes(path.extname(ref));
+    const candidates = [];
+    if (looksLikePath) {
+        candidates.push(path.isAbsolute(ref) ? ref : path.resolve(process.cwd(), ref));
+        const normalized = ref.replace(/^[\\/]+/, '').replace(/^templates[\\/]/, '');
+        for (const ext of TEMPLATE_EXTS) {
+            candidates.push(path.resolve(builtinTemplatesDir(), `${normalized.replace(/\.(yaml|yml|json)$/, '')}${ext}`));
+        }
+    }
+    else {
+        for (const ext of TEMPLATE_EXTS) {
+            candidates.push(path.resolve(builtinTemplatesDir(), `${ref}${ext}`));
+        }
+    }
+    const hit = candidates.find(c => existsSync(c) && statSync(c).isFile());
+    if (!hit) {
+        throw new PipelineError('IO', `找不到模板: ${ref}（已尝试 ${candidates.join(', ')}）`);
+    }
+    return hit;
+}
+export function loadTemplate(ref) {
+    const file = resolveTemplatePath(ref);
+    let source;
+    try {
+        source = readFileSync(file, 'utf8');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new PipelineError('IO', `读取模板失败（${file}）: ${message}`);
+    }
+    return { template: parseTemplate(source, file), path: file };
+}
+/** 内置模板清单（tapd pipeline list / 后续 pm 层复用） */
+export function listBuiltinTemplates() {
+    const dir = builtinTemplatesDir();
+    let entries;
+    try {
+        entries = readdirSync(dir).filter(f => TEMPLATE_EXTS.includes(path.extname(f))).sort();
+    }
+    catch {
+        return []; // 目录不存在（如被裁剪的安装），按空清单处理
+    }
+    return entries.map(file => {
+        const full = path.join(dir, file);
+        const tpl = parseTemplate(readFileSync(full, 'utf8'), full);
+        return { name: tpl.name, title: tpl.title ?? '', write: Boolean(tpl.write), file };
+    });
+}
+//# sourceMappingURL=template.js.map

package/dist/pipeline/template.js.map

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

package/dist/pipeline/template.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=template.test.d.ts.map

package/dist/pipeline/template.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.test.d.ts","sourceRoot":"","sources":["../../src/pipeline/template.test.ts"],"names":[],"mappings":""}

package/dist/pipeline/template.test.js

@@ -0,0 +1,94 @@
+import assert from 'node:assert/strict';
+import { listBuiltinTemplates, parseTemplate, resolveTemplatePath } from './template.js';
+import { PipelineError } from './types.js';
+const checks = [
+    ['parseTemplate: 合法模板完整解析（name/title/write/vars/steps/report）', () => {
+            const tpl = parseTemplate(`
+name: demo
+title: 演示模板
+write: true
+vars:
+  iteration_id: "1001"
+steps:
+  - id: a
+    uses: tapd_get_stories
+    args: { iteration_id: "${'$'}{vars.iteration_id}" }
+    filter: "!item.name.startsWith('zzz')"
+  - id: b
+    uses: tapd_update_story
+    args: { id: "1", status: developing }
+    depends_on: [a]
+report:
+  format: markdown
+  template: |
+    # 报告 ${'$'}{steps.a.data | length}
+`, 'inline');
+            assert.equal(tpl.name, 'demo');
+            assert.equal(tpl.write, true);
+            assert.equal(tpl.vars?.iteration_id, '1001');
+            assert.equal(tpl.steps.length, 2);
+            assert.equal(tpl.steps[1].depends_on?.[0], 'a');
+            assert.equal(tpl.report?.format, 'markdown');
+        }],
+    ['parseTemplate: json 源同样可解析（YAML 是 JSON 超集）', () => {
+            const tpl = parseTemplate(JSON.stringify({ name: 'j', steps: [{ id: 's', uses: 'tapd_get_bugs' }] }), 'inline');
+            assert.equal(tpl.name, 'j');
+            assert.equal(tpl.steps[0].uses, 'tapd_get_bugs');
+        }],
+    ['parseTemplate: yaml 语法错误 → TEMPLATE_INVALID', () => {
+            assert.throws(() => parseTemplate('name: [unclosed', 'inline'), (error) => error instanceof PipelineError && error.code === 'TEMPLATE_INVALID');
+        }],
+    ['parseTemplate: 缺 name / 空 steps → TEMPLATE_INVALID', () => {
+            assert.throws(() => parseTemplate('steps: [{ id: a, uses: x }]', 'inline'), (error) => error instanceof PipelineError && error.code === 'TEMPLATE_INVALID');
+            assert.throws(() => parseTemplate('name: demo, steps: []'.replace(',', '\n'), 'inline'), (error) => error instanceof PipelineError && error.code === 'TEMPLATE_INVALID');
+        }],
+    ['parseTemplate: 步骤缺 uses/expr 或两者同存 → TEMPLATE_INVALID', () => {
+            assert.throws(() => parseTemplate('name: d\nsteps:\n  - id: a\n    args: {}', 'inline'), (error) => error instanceof PipelineError && error.code === 'TEMPLATE_INVALID');
+            assert.throws(() => parseTemplate('name: d\nsteps:\n  - id: a\n    uses: tapd_get_bugs\n    expr: "1+1"', 'inline'), (error) => error instanceof PipelineError && error.code === 'TEMPLATE_INVALID');
+        }],
+    ['parseTemplate: 步骤 id 重复 → TEMPLATE_INVALID', () => {
+            assert.throws(() => parseTemplate('name: d\nsteps:\n  - id: a\n    uses: tapd_get_bugs\n  - id: a\n    uses: tapd_get_bugs', 'inline'), (error) => error instanceof PipelineError && error.code === 'TEMPLATE_INVALID');
+        }],
+    ['parseTemplate: depends_on 指向缺失步骤 → TEMPLATE_INVALID', () => {
+            assert.throws(() => parseTemplate('name: d\nsteps:\n  - id: a\n    uses: tapd_get_bugs\n    depends_on: [ghost]', 'inline'), (error) => error instanceof PipelineError && error.code === 'TEMPLATE_INVALID');
+        }],
+    ['parseTemplate: 未知顶层字段 → TEMPLATE_INVALID（strict）', () => {
+            assert.throws(() => parseTemplate('name: d\nsteps:\n  - id: a\n    uses: tapd_get_bugs\nbogus: 1', 'inline'), (error) => error instanceof PipelineError && error.code === 'TEMPLATE_INVALID');
+        }],
+    ['resolveTemplatePath: 内置模板裸名与 templates/ 相对名都可解析', () => {
+            const bare = resolveTemplatePath('iteration-review');
+            const rel = resolveTemplatePath('templates/iteration-review.yaml');
+            assert.ok(bare.endsWith('templates/iteration-review.yaml'), bare);
+            assert.equal(bare, rel);
+        }],
+    ['resolveTemplatePath: 找不到 → IO 错误并列出尝试路径', () => {
+            assert.throws(() => resolveTemplatePath('no-such-template'), (error) => error instanceof PipelineError && error.code === 'IO' && error.message.includes('no-such-template'));
+        }],
+    ['listBuiltinTemplates: 三个内置模板齐全且声明正确的 write 标记', () => {
+            const list = listBuiltinTemplates();
+            const byName = Object.fromEntries(list.map(t => [t.name, t]));
+            assert.deepEqual(Object.keys(byName).sort(), ['deliver-story', 'iteration-review', 'triage-bugs']);
+            assert.equal(byName['iteration-review'].write, false);
+            assert.equal(byName['deliver-story'].write, true);
+            assert.equal(byName['triage-bugs'].write, true);
+            assert.ok(byName['iteration-review'].title.length > 0);
+        }],
+];
+let failed = 0;
+for (const [name, fn] of checks) {
+    try {
+        await fn();
+        console.log(`ok - ${name}`);
+    }
+    catch (error) {
+        failed++;
+        console.error(`FAIL - ${name}`);
+        console.error(error);
+    }
+}
+if (failed > 0) {
+    console.error(`\n${failed}/${checks.length} failed`);
+    process.exit(1);
+}
+console.log(`\n${checks.length}/${checks.length} passed`);
+//# sourceMappingURL=template.test.js.map

package/dist/pipeline/template.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.test.js","sourceRoot":"","sources":["../../src/pipeline/template.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,MAAM,GAA2C;IACrD,CAAC,6DAA6D,EAAE,GAAG,EAAE;YACnE,MAAM,GAAG,GAAG,aAAa,CACvB;;;;;;;;;6BASuB,GAAG;;;;;;;;;WASrB,GAAG;CACb,EACK,QAAQ,CACT,CAAC;YACF,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC/B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAC9B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;YAC7C,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAClC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAChD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;QAC/C,CAAC,CAAC;IACF,CAAC,4CAA4C,EAAE,GAAG,EAAE;YAClD,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;YAChH,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC5B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QACnD,CAAC,CAAC;IACF,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACnD,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CAAC,aAAa,CAAC,iBAAiB,EAAE,QAAQ,CAAC,EAChD,CAAC,KAAc,EAAE,EAAE,CAAC,KAAK,YAAY,aAAa,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,CACxF,CAAC;QACJ,CAAC,CAAC;IACF,CAAC,oDAAoD,EAAE,GAAG,EAAE;YAC1D,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CAAC,aAAa,CAAC,6BAA6B,EAAE,QAAQ,CAAC,EAC5D,CAAC,KAAc,EAAE,EAAE,CAAC,KAAK,YAAY,aAAa,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,CACxF,CAAC;YACF,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CAAC,aAAa,CAAC,uBAAuB,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,QAAQ,CAAC,EACzE,CAAC,KAAc,EAAE,EAAE,CAAC,KAAK,YAAY,aAAa,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,CACxF,CAAC;QACJ,CAAC,CAAC;IACF,CAAC,uDAAuD,EAAE,GAAG,EAAE;YAC7D,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CAAC,aAAa,CAAC,0CAA0C,EAAE,QAAQ,CAAC,EACzE,CAAC,KAAc,EAAE,EAAE,CAAC,KAAK,YAAY,aAAa,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,CACxF,CAAC;YACF,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CAAC,aAAa,CAAC,sEAAsE,EAAE,QAAQ,CAAC,EACrG,CAAC,KAAc,EAAE,EAAE,CAAC,KAAK,YAAY,aAAa,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,CACxF,CAAC;QACJ,CAAC,CAAC;IACF,CAAC,4CAA4C,EAAE,GAAG,EAAE;YAClD,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CAAC,aAAa,CAAC,yFAAyF,EAAE,QAAQ,CAAC,EACxH,CAAC,KAAc,EAAE,EAAE,CAAC,KAAK,YAAY,aAAa,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,CACxF,CAAC;QACJ,CAAC,CAAC;IACF,CAAC,qDAAqD,EAAE,GAAG,EAAE;YAC3D,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CAAC,aAAa,CAAC,8EAA8E,EAAE,QAAQ,CAAC,EAC7G,CAAC,KAAc,EAAE,EAAE,CAAC,KAAK,YAAY,aAAa,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,CACxF,CAAC;QACJ,CAAC,CAAC;IACF,CAAC,kDAAkD,EAAE,GAAG,EAAE;YACxD,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CAAC,aAAa,CAAC,+DAA+D,EAAE,QAAQ,CAAC,EAC9F,CAAC,KAAc,EAAE,EAAE,CAAC,KAAK,YAAY,aAAa,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,CACxF,CAAC;QACJ,CAAC,CAAC;IACF,CAAC,iDAAiD,EAAE,GAAG,EAAE;YACvD,MAAM,IAAI,GAAG,mBAAmB,CAAC,kBAAkB,CAAC,CAAC;YACrD,MAAM,GAAG,GAAG,mBAAmB,CAAC,iCAAiC,CAAC,CAAC;YACnE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,iCAAiC,CAAC,EAAE,IAAI,CAAC,CAAC;YAClE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC1B,CAAC,CAAC;IACF,CAAC,yCAAyC,EAAE,GAAG,EAAE;YAC/C,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,EAC7C,CAAC,KAAc,EAAE,EAAE,CAAC,KAAK,YAAY,aAAa,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CACxH,CAAC;QACJ,CAAC,CAAC;IACF,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACrD,MAAM,IAAI,GAAG,oBAAoB,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9D,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,EAAE,kBAAkB,EAAE,aAAa,CAAC,CAAC,CAAC;YACnG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACtD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAClD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAChD,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACzD,CAAC,CAAC;CACH,CAAC;AAEF,IAAI,MAAM,GAAG,CAAC,CAAC;AACf,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,EAAE,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,EAAE,CAAC;QACT,OAAO,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AACD,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;IACf,OAAO,CAAC,KAAK,CAAC,KAAK,MAAM,IAAI,MAAM,CAAC,MAAM,SAAS,CAAC,CAAC;IACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AACD,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,SAAS,CAAC,CAAC"}

package/dist/pipeline/types.d.ts

@@ -0,0 +1,99 @@
+/** 模板报告渲染声明 */
+export interface PipelineReport {
+    /** 输出格式：markdown/text 按模板插值渲染；json 输出全量运行摘要 */
+    format?: 'markdown' | 'text' | 'json';
+    /** 报告正文模板，支持 ${vars.x} / ${steps.<id>.data...} 插值与 | length 等过滤器 */
+    template?: string;
+}
+/** 单个步骤。uses 与 expr 二选一：uses 走 toolRegistry.exec，expr 为本地表达式计算（不触 API） */
+export interface PipelineStep {
+    id: string;
+    /** 既有原子命令对应的工具名，如 tapd_get_stories（必走 registry.exec 通道） */
+    uses?: string;
+    /** 本地表达式步骤：在 { vars, steps } 上下文中求值，返回值存为步骤输出 */
+    expr?: string;
+    /** 工具参数，字符串值支持 ${...} 插值 */
+    args?: Record<string, unknown>;
+    /** 条件执行：表达式为假时跳过该步骤 */
+    where?: string;
+    /** 结果过滤：数组结果逐项过滤（上下文含 item/index/vars/today） */
+    filter?: string;
+    /** 显式依赖（会与 ${steps.<id>} 隐式引用合并） */
+    depends_on?: string[];
+}
+export interface PipelineTemplate {
+    name: string;
+    title?: string;
+    /** 模板写标记：任一步骤为写操作时必须为 true（validate 强制） */
+    write?: boolean;
+    /** pm 层域标记（可选元数据）：pipeline run/validate 原生接受，tapd pm 借此路由域分组 */
+    domain?: string;
+    /** 工具步骤取回数据后统一解包 TAPD 包裹形态（{Story:{...}} → {...,__entity:'Story'}），过滤/表达式按扁平字段书写 */
+    unwrap?: boolean;
+    /** 模板变量（可被 --input 注入覆盖） */
+    vars?: Record<string, unknown>;
+    steps: PipelineStep[];
+    report?: PipelineReport;
+}
+/** 步骤运行结果 */
+export interface StepOutcome {
+    id: string;
+    uses?: string;
+    write: boolean;
+    status: 'ok' | 'failed' | 'skipped' | 'pending';
+    /** 跳过原因：dry-run / write-gate / where / upstream-failed */
+    skipReason?: string;
+    durationMs?: number;
+    data?: unknown;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+/** dry-run 预览行（写闸门与 --dry-run 共用） */
+export interface PlanEntry {
+    wave: number;
+    id: string;
+    uses?: string;
+    expr?: string;
+    write: boolean;
+    args: Record<string, unknown>;
+    where?: string;
+    filter?: string;
+    dependsOn: string[];
+}
+export interface RunSummary {
+    ok: boolean;
+    pipeline: string;
+    dryRun: boolean;
+    /** 写闸门拦截：含写步骤且未 --yes（退出码 2，走用法错误） */
+    gateBlocked: boolean;
+    preview?: PlanEntry[];
+    steps: StepOutcome[];
+    report?: string;
+    durationMs: number;
+}
+/** 事件流 JSONL 单行（--events <file.jsonl>） */
+export interface PipelineEvent {
+    ts: string;
+    event: 'pipeline.start' | 'pipeline.dry-run' | 'pipeline.gate-blocked' | 'pipeline.end' | 'step.start' | 'step.end' | 'step.skip';
+    pipeline: string;
+    step?: string;
+    uses?: string;
+    write?: boolean;
+    ok?: boolean;
+    skipReason?: string;
+    errorCode?: string;
+    durationMs?: number;
+}
+export type PipelineErrorCode = 'TEMPLATE_INVALID' | 'UNKNOWN_COMMAND' | 'SCHEMA_MISMATCH' | 'WRITE_MARKER_MISSING' | 'DEPENDENCY_CYCLE' | 'REF_UNKNOWN' | 'EXPR_ERROR' | 'WRITE_GATE' | 'STEP_FAILED' | 'IO';
+/** pipeline 专属错误：command 层据此路由退出码（USAGE=2 / RUNTIME=1） */
+export declare class PipelineError extends Error {
+    readonly code: PipelineErrorCode;
+    readonly details: string[];
+    constructor(code: PipelineErrorCode, message: string, details?: string[]);
+    get exitCode(): number;
+    /** 与 CliError.render 同前缀风格：error: <code>: <message>，details 逐行缩进 */
+    render(): string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/pipeline/types.js

@@ -0,0 +1,31 @@
+// pipeline 模板与运行期类型（S1 引擎本体，S2 pm 层复用）
+// 设计依据：tapd-2.0.0-pm-layer-design.md §3、tapd-cli-upgrade-prd.md §6 F8
+/** pipeline 专属错误：command 层据此路由退出码（USAGE=2 / RUNTIME=1） */
+export class PipelineError extends Error {
+    code;
+    details;
+    constructor(code, message, details = []) {
+        super(message);
+        this.code = code;
+        this.details = details;
+    }
+    get exitCode() {
+        switch (this.code) {
+            case 'TEMPLATE_INVALID':
+            case 'UNKNOWN_COMMAND':
+            case 'SCHEMA_MISMATCH':
+            case 'WRITE_MARKER_MISSING':
+            case 'DEPENDENCY_CYCLE':
+            case 'REF_UNKNOWN':
+            case 'WRITE_GATE':
+                return 2; // 用法错误：修正模板或补 --yes 后重跑
+            default:
+                return 1; // 运行错误（STEP_FAILED/EXPR_ERROR/IO）
+        }
+    }
+    /** 与 CliError.render 同前缀风格：error: <code>: <message>，details 逐行缩进 */
+    render() {
+        return [`error: ${this.code}: ${this.message}`, ...this.details.map(d => `  - ${d}`)].join('\n');
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/pipeline/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pipeline/types.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,sEAAsE;AAiHtE,0DAA0D;AAC1D,MAAM,OAAO,aAAc,SAAQ,KAAK;IAEpB;IAEA;IAHlB,YACkB,IAAuB,EACvC,OAAe,EACC,UAAoB,EAAE;QAEtC,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAmB;QAEvB,YAAO,GAAP,OAAO,CAAe;IAGxC,CAAC;IAED,IAAI,QAAQ;QACV,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,kBAAkB,CAAC;YACxB,KAAK,iBAAiB,CAAC;YACvB,KAAK,iBAAiB,CAAC;YACvB,KAAK,sBAAsB,CAAC;YAC5B,KAAK,kBAAkB,CAAC;YACxB,KAAK,aAAa,CAAC;YACnB,KAAK,YAAY;gBACf,OAAO,CAAC,CAAC,CAAC,wBAAwB;YACpC;gBACE,OAAO,CAAC,CAAC,CAAC,kCAAkC;QAChD,CAAC;IACH,CAAC;IAED,oEAAoE;IACpE,MAAM;QACJ,OAAO,CAAC,UAAU,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnG,CAAC;CACF"}

package/dist/pipeline/unwrap.d.ts

@@ -0,0 +1,3 @@
+/** 数组逐项解包；单对象同样处理；其余原样返回（count 等小写键不受影响） */
+export declare function unwrapEntities(data: unknown): unknown;
+//# sourceMappingURL=unwrap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unwrap.d.ts","sourceRoot":"","sources":["../../src/pipeline/unwrap.ts"],"names":[],"mappings":"AAqBA,4CAA4C;AAC5C,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAGrD"}

package/dist/pipeline/unwrap.js

@@ -0,0 +1,26 @@
+// TAPD API 实体包裹形态解包：[{Story:{...}}] → [{...,__entity:'Story'}]
+//
+// 真实 API（与 MCP 同源）返回单键包裹形态，如 {"Story":{"id":...}} / {"Iteration":{...}}；
+// 模板的 filter/expr/插值按扁平字段书写（item.name / item.status）。
+// 模板声明 `unwrap: true` 后，引擎在每个工具步骤取回数据后、过滤前统一拍平，
+// 并以 __entity 保留原包裹键便于溯源与按类型分组。
+/** 单个对象：恰好一个首字母大写的键且值为对象 → 展开该对象并附 __entity */
+function unwrapOne(item) {
+    if (item !== null && typeof item === 'object' && !Array.isArray(item)) {
+        const keys = Object.keys(item);
+        if (keys.length === 1 && /^[A-Z][A-Za-z0-9]*$/.test(keys[0])) {
+            const inner = item[keys[0]];
+            if (inner !== null && typeof inner === 'object' && !Array.isArray(inner)) {
+                return { ...inner, __entity: keys[0] };
+            }
+        }
+    }
+    return item;
+}
+/** 数组逐项解包；单对象同样处理；其余原样返回（count 等小写键不受影响） */
+export function unwrapEntities(data) {
+    if (Array.isArray(data))
+        return data.map(unwrapOne);
+    return unwrapOne(data);
+}
+//# sourceMappingURL=unwrap.js.map

package/dist/pipeline/unwrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unwrap.js","sourceRoot":"","sources":["../../src/pipeline/unwrap.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,EAAE;AACF,yEAAyE;AACzE,sDAAsD;AACtD,gDAAgD;AAChD,gCAAgC;AAEhC,+CAA+C;AAC/C,SAAS,SAAS,CAAC,IAAa;IAC9B,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,MAAM,KAAK,GAAI,IAAgC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACzD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzE,OAAO,EAAE,GAAI,KAAiC,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACpD,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/dist/pipeline/unwrap.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=unwrap.test.d.ts.map

package/dist/pipeline/unwrap.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unwrap.test.d.ts","sourceRoot":"","sources":["../../src/pipeline/unwrap.test.ts"],"names":[],"mappings":""}

package/dist/pipeline/unwrap.test.js

@@ -0,0 +1,36 @@
+// unwrapEntities 单元测试：TAPD 包裹形态拍平（真机 L2 冒烟暴露的形态差异，2026-09-11）
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { unwrapEntities } from './unwrap.js';
+void test('数组逐项解包并附 __entity', () => {
+    const data = [
+        { Story: { id: '1', name: 'a' } },
+        { Story: { id: '2', name: 'b' } },
+    ];
+    assert.deepEqual(unwrapEntities(data), [
+        { id: '1', name: 'a', __entity: 'Story' },
+        { id: '2', name: 'b', __entity: 'Story' },
+    ]);
+});
+void test('单对象解包（按 id 查询返回）', () => {
+    assert.deepEqual(unwrapEntities({ Iteration: { id: '9', name: 'it' } }), { id: '9', name: 'it', __entity: 'Iteration' });
+});
+void test('小写单键对象不动（count 等非实体形态）', () => {
+    assert.deepEqual(unwrapEntities({ count: 3 }), { count: 3 });
+    assert.equal(unwrapEntities(42), 42);
+    assert.equal(unwrapEntities('x'), 'x');
+    assert.equal(unwrapEntities(null), null);
+});
+void test('多键对象不动（已扁平/混合形态）', () => {
+    const flat = { id: '1', name: 'a', status: 'planning' };
+    assert.deepEqual(unwrapEntities(flat), flat);
+});
+void test('包裹值为标量不动（单键值为原始类型的陷阱形态）', () => {
+    assert.deepEqual(unwrapEntities({ Code: 'x' }), { Code: 'x' });
+});
+void test('混合数组：能解的解，不能解的保原样', () => {
+    const out = unwrapEntities([{ Bug: { id: '1' } }, { note: 'plain' }]);
+    assert.deepEqual(out[0], { id: '1', __entity: 'Bug' });
+    assert.deepEqual(out[1], { note: 'plain' });
+});
+//# sourceMappingURL=unwrap.test.js.map