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

package/dist/pm/iteration.test.js

@@ -0,0 +1,125 @@
+// 迭代缺省解析测试（S2）：mock registry，不触真实 API
+import assert from 'node:assert/strict';
+import { z } from 'zod';
+import { ToolRegistry } from '@xihe-lab/tapd-core';
+import { pickLatestOpenIteration, probeDefaultIteration } from './iteration.js';
+const OPEN_ITERATIONS = {
+    data: [
+        { id: '3001', name: 'Sprint A', startdate: '2026-09-01', status: 'open' },
+        { id: '2999', name: 'Old', startdate: '2026-08-01', status: 'done' },
+        { id: '3003', name: 'zzz-delete-me 老迭代', startdate: '2026-12-31', status: 'open' },
+        { id: '3002', name: 'Sprint B', startdate: '2026-09-10', status: 'open' },
+    ],
+};
+function makeRegistry(mode = 'ok') {
+    const record = { calls: 0, args: [], mode };
+    const tools = [
+        {
+            name: 'tapd_get_iterations',
+            description: 'mock: 迭代查询',
+            inputSchema: z.object({
+                workspace_id: z.number().optional(),
+                id: z.string().optional(),
+                status: z.string().optional(),
+                fields: z.string().optional(),
+                order: z.string().optional(),
+            }),
+            handler: (_client, params) => {
+                record.calls++;
+                record.args.push(params);
+                if (record.mode === 'auth-error') {
+                    return Promise.reject(new Error('missing TAPD_ACCESS_TOKEN'));
+                }
+                if (record.mode === 'api-error') {
+                    return Promise.reject(new Error('TAPD API error: 403'));
+                }
+                return Promise.resolve(OPEN_ITERATIONS);
+            },
+        },
+    ];
+    const registry = new ToolRegistry();
+    registry.register(tools);
+    return { registry, record };
+}
+const clientFactory = () => ({});
+const checks = [
+    ['pickLatestOpenIteration：过滤 zzz-delete-me* 与非 open 由调用侧保证，startdate 最新优先', () => {
+            const picked = pickLatestOpenIteration(OPEN_ITERATIONS.data);
+            assert.ok(picked);
+            assert.equal(picked.id, '3002', 'zzz-delete-me(2026-12-31) 必须被过滤，取 startdate 最新的 3002');
+            assert.equal(picked.name, 'Sprint B');
+        }],
+    ['pickLatestOpenIteration：兼容 { data: [...] } / 数组 / 空值形态', () => {
+            assert.equal(pickLatestOpenIteration(OPEN_ITERATIONS).id, '3002');
+            assert.equal(pickLatestOpenIteration([]), undefined);
+            assert.equal(pickLatestOpenIteration({ data: [] }), undefined);
+            assert.equal(pickLatestOpenIteration({ data: [{ id: '1', name: 'zzz-delete-me', startdate: '2030-01-01' }] }), undefined);
+            assert.equal(pickLatestOpenIteration(null), undefined);
+            assert.equal(pickLatestOpenIteration('nope'), undefined);
+            assert.equal(pickLatestOpenIteration([{ id: '9', name: '唯一', startdate: '' }]).id, '9');
+        }],
+    ['probeDefaultIteration：status=open + fields 只读探测，defaultArgs 兜底合并', async () => {
+            const { registry, record } = makeRegistry();
+            const probe = await probeDefaultIteration(registry, clientFactory, {
+                defaultArgs: { workspace_id: 39814312 },
+                timeoutMs: 5_000,
+            });
+            assert.equal(probe.status, 'resolved');
+            assert.equal(probe.status === 'resolved' ? probe.iteration.id : '', '3002');
+            assert.equal(record.calls, 1);
+            assert.equal(record.args[0].status, 'open');
+            assert.equal(record.args[0].fields, 'id,name,startdate,status');
+            assert.equal(record.args[0].workspace_id, 39814312);
+        }],
+    ['probeDefaultIteration：无可用迭代 → none（不抛错）', async () => {
+            // 全 zzz-delete-me 的迭代列表同样归 none
+            const empty = new ToolRegistry();
+            empty.register([
+                {
+                    name: 'tapd_get_iterations',
+                    description: 'mock empty',
+                    inputSchema: z.object({ status: z.string().optional(), fields: z.string().optional() }),
+                    handler: () => Promise.resolve({ data: [] }),
+                },
+            ]);
+            const probeEmpty = await probeDefaultIteration(empty, clientFactory);
+            assert.equal(probeEmpty.status, 'none');
+            const allZzz = new ToolRegistry();
+            allZzz.register([
+                {
+                    name: 'tapd_get_iterations',
+                    description: 'mock all filtered',
+                    inputSchema: z.object({ status: z.string().optional(), fields: z.string().optional() }),
+                    handler: () => Promise.resolve([{ id: '1', name: 'zzz-delete-me', startdate: '2030-01-01' }]),
+                },
+            ]);
+            const probeZzz = await probeDefaultIteration(allZzz, clientFactory);
+            assert.equal(probeZzz.status, 'none');
+        }],
+    ['probeDefaultIteration：探测失败（auth/API）→ failed + 消息，不抛错不中断场景', async () => {
+            for (const mode of ['auth-error', 'api-error']) {
+                const { registry } = makeRegistry(mode);
+                const probe = await probeDefaultIteration(registry, clientFactory);
+                assert.equal(probe.status, 'failed');
+                assert.ok(probe.status === 'failed' && probe.message.length > 0, `${mode} 应带错误消息`);
+            }
+        }],
+];
+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=iteration.test.js.map

package/dist/pm/iteration.test.js.map

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

package/dist/pm/pm-command.test.d.ts

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

package/dist/pm/pm-command.test.d.ts.map

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

package/dist/pm/pm-command.test.js

@@ -0,0 +1,321 @@
+// tapd pm 命令组集成测试（S2）：别名路由到 pipeline 引擎 / help 分组 / list / 写闸门 / 迭代注入
+// fixture 模板写测试临时目录（TAPD_USER_TEMPLATES_DIR），registry 为 mock，不触真实 API。
+import assert from 'node:assert/strict';
+import { mkdtempSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { z } from 'zod';
+import { ToolRegistry } from '@xihe-lab/tapd-core';
+import { buildProgram } from '../program.js';
+import { CliError } from '../errors.js';
+// ---- fixture 模板（用户目录，覆盖 env 注入） ----
+const RISK_SCAN = `name: risk-scan
+domain: risk
+title: 风险扫描（fixture）
+write: false
+vars:
+  iteration_id: ""
+steps:
+  - id: iterations
+    uses: tapd_get_iterations
+    args: { status: open, fields: "id,name,startdate" }
+    filter: "!item.name.startsWith('zzz-delete-me')"
+  - id: stories
+    uses: tapd_get_stories
+    args: { iteration_id: "${'$'}{vars.iteration_id}", fields: "id,name" }
+    filter: "!item.name.startsWith('zzz-delete-me')"
+`;
+const SCOPE_CLOSE = `name: scope-close
+domain: scope
+title: 迭代关闭（fixture 写场景）
+write: true
+vars:
+  iteration_id: ""
+steps:
+  - id: close
+    uses: tapd_update_story
+    args: { id: "${'$'}{vars.iteration_id}", status: closed }
+`;
+const PROCUREMENT_AUDIT = `name: procurement-audit
+domain: procurement
+title: 外部依赖台账（自定义域 fixture）
+steps:
+  - id: stories
+    uses: tapd_get_stories
+`;
+// ---- mock registry ----
+const OPEN_ITERATIONS = {
+    data: [
+        { id: '3001', name: 'Sprint A', startdate: '2026-09-01', status: 'open' },
+        { id: '3003', name: 'zzz-delete-me 老迭代', startdate: '2026-12-31', status: 'open' },
+        { id: '3002', name: 'Sprint B', startdate: '2026-09-10', status: 'open' },
+    ],
+};
+function makeRegistry() {
+    const tracker = { probes: [], storyArgs: [], updateArgs: [] };
+    const tools = [
+        {
+            name: 'tapd_get_iterations',
+            description: 'mock: 迭代查询（pm 缺省迭代探测数据源）',
+            inputSchema: z.object({
+                workspace_id: z.number().optional(),
+                status: z.string().optional(),
+                fields: z.string().optional(),
+            }),
+            handler: (_client, params) => {
+                tracker.probes.push(params);
+                return Promise.resolve(OPEN_ITERATIONS);
+            },
+        },
+        {
+            name: 'tapd_get_stories',
+            description: 'mock: 需求查询（记录入参，含 1 条 zzz 脏数据）',
+            inputSchema: z.object({
+                workspace_id: z.number().optional(),
+                iteration_id: z.string().optional(),
+                fields: z.string().optional(),
+            }),
+            handler: (_client, params) => {
+                tracker.storyArgs.push(params);
+                return Promise.resolve([
+                    { id: 's1', name: 'story-1' },
+                    { id: 's2', name: 'zzz-delete-me 脏数据' },
+                ]);
+            },
+        },
+        {
+            name: 'tapd_update_story',
+            description: 'mock: 写操作',
+            write: true,
+            inputSchema: z.object({
+                workspace_id: z.number().optional(),
+                id: z.string(),
+                status: z.string().optional(),
+            }),
+            handler: (_client, params) => {
+                tracker.updateArgs.push(params);
+                return Promise.resolve({ id: params.id });
+            },
+        },
+    ];
+    const registry = new ToolRegistry();
+    registry.register(tools);
+    return { registry, tracker };
+}
+function captureIo(run) {
+    const out = [];
+    const err = [];
+    const origOut = process.stdout.write.bind(process.stdout);
+    const origErr = process.stderr.write.bind(process.stderr);
+    process.stdout.write = (chunk) => {
+        out.push(String(chunk));
+        return true;
+    };
+    process.stderr.write = (chunk) => {
+        err.push(String(chunk));
+        return true;
+    };
+    return run().then(() => {
+        process.stdout.write = origOut;
+        process.stderr.write = origErr;
+        return { out: out.join(''), err: err.join('') };
+    }, error => {
+        process.stdout.write = origOut;
+        process.stderr.write = origErr;
+        throw error;
+    });
+}
+async function withExitCode(fn) {
+    const prev = process.exitCode;
+    try {
+        return await fn();
+    }
+    finally {
+        process.exitCode = prev;
+    }
+}
+async function runCli(registry, args, config = {}) {
+    const program = buildProgram(registry, config);
+    // commander parse 约定 argv[0]=node argv[1]=script，真实参数从下标 2 开始
+    return captureIo(async () => {
+        await program.parseAsync(['node', 'tapd', ...args]);
+    });
+}
+/**
+ * help 路径（--help）：exitOverride 下 commander 打印后抛 helpDisplayed，
+ * 输出已经落 stdout，吞掉该错误只取输出。
+ * 注意 commander v13 的 addHelpText 走事件流，helpInformation() 不含 after 文本，
+ * 必须经 parseAsync 才能拿到完整 help。
+ */
+async function runHelp(registry, args) {
+    const program = buildProgram(registry, {});
+    const out = [];
+    const origOut = process.stdout.write.bind(process.stdout);
+    process.stdout.write = (chunk) => {
+        out.push(String(chunk));
+        return true;
+    };
+    try {
+        await program.parseAsync(['node', 'tapd', ...args]);
+    }
+    catch {
+        // helpDisplayed / help 事件后的 CommanderError 属预期
+    }
+    finally {
+        process.stdout.write = origOut;
+    }
+    return { out: out.join(''), err: '' };
+}
+// ---- fixture 目录 ----
+const root = mkdtempSync(path.join(tmpdir(), 'tapd-pm-command-'));
+mkdirSync(path.join(root, 'pm'), { recursive: true });
+writeFileSync(path.join(root, 'pm', 'risk-scan.yaml'), RISK_SCAN);
+writeFileSync(path.join(root, 'pm', 'scope-close.yaml'), SCOPE_CLOSE);
+writeFileSync(path.join(root, 'pm', 'procurement-audit.yaml'), PROCUREMENT_AUDIT);
+const prevEnv = process.env.TAPD_USER_TEMPLATES_DIR;
+process.env.TAPD_USER_TEMPLATES_DIR = root;
+// mock registry 不触 HTTP，但 registry.exec 会先构建 client（fromEnv 无凭证即抛 AUTH_MISSING）
+const prevToken = process.env.TAPD_ACCESS_TOKEN;
+process.env.TAPD_ACCESS_TOKEN = 'pm-test-token';
+const checks = [
+    ['tapd pm --help：八域分组（中文+章节号）、场景清单、自定义域归「其他」', async () => {
+            const { registry } = makeRegistry();
+            const program = buildProgram(registry, {});
+            const pmCmd = program.commands.find(c => c.name() === 'pm');
+            assert.ok(pmCmd, 'pm 命令已注册');
+            // 域子命令逐一注册（含自定义域 procurement）
+            for (const sub of ['list', 'integration', 'scope', 'schedule', 'cost', 'quality', 'communication', 'risk', 'stakeholder', 'procurement']) {
+                assert.ok(pmCmd.commands.some(c => c.name() === sub), `pm 缺子命令 ${sub}`);
+            }
+            const io = await runHelp(registry, ['pm', '--help']);
+            const help = io.out;
+            for (const fragment of [
+                'integration', 'scope', 'schedule', 'cost', 'quality', 'communication', 'risk', 'stakeholder',
+                '整合管理（第8章）', '进度管理（第10章）', '沟通管理（第14章）', '干系人管理（第17章）',
+                'scan              风险扫描（fixture） [read]',
+                'close             迭代关闭（fixture 写场景） [write]',
+                '其他', 'procurement/audit',
+                '通用 flags:', '--iteration <id>', '--dry-run', '--yes', 'zzz-delete-me',
+            ]) {
+                assert.ok(help.includes(fragment), `help 缺片段: ${fragment}`);
+            }
+            const otherIdx = help.indexOf('其他');
+            assert.ok(otherIdx > help.indexOf('stakeholder'), '「其他」组排在域表之后');
+        }],
+    ['tapd pm <domain> --help：该域场景清单', async () => {
+            const { registry } = makeRegistry();
+            const io = await runHelp(registry, ['pm', 'risk', '--help']);
+            assert.ok(io.out.includes('risk 风险管理（第15章） 场景:'), io.out);
+            assert.ok(io.out.includes('scan              风险扫描（fixture） [read]'));
+            assert.ok(io.out.includes('用法: tapd pm risk <scenario>'));
+        }],
+    ['tapd pm：裸命令输出分组 help，退出码 0', async () => {
+            const { registry } = makeRegistry();
+            const io = await withExitCode(() => runCli(registry, ['pm']));
+            assert.ok(io.out.includes('域分组:'), io.err);
+        }],
+    ['tapd pm list：域/场景/读写/来源列；--domain 过滤；--output json', async () => {
+            const { registry } = makeRegistry();
+            const io = await withExitCode(() => runCli(registry, ['pm', 'list']));
+            assert.ok(io.out.includes('domain') && io.out.includes('scenario'));
+            assert.match(io.out, /^risk\s+scan\s+read\s+user\s+风险扫描（fixture）/m);
+            assert.match(io.out, /^scope\s+close\s+write\s+user\s+迭代关闭（fixture 写场景）/m);
+            const filtered = await withExitCode(() => runCli(registry, ['pm', 'list', '--domain', 'risk']));
+            assert.ok(filtered.out.includes('scan') && !/\bclose\b/.test(filtered.out), '--domain 过滤');
+            await assert.rejects(withExitCode(() => runCli(registry, ['pm', 'list', '--domain', 'nope'])), (error) => error instanceof CliError && error.message.includes('未知域 "nope"'));
+            const json = await withExitCode(() => runCli(registry, ['pm', 'list', '--output', 'json']));
+            const entries = JSON.parse(json.out);
+            assert.ok(entries.length >= 3);
+            for (const e of entries) {
+                for (const key of ['domain', 'scenario', 'name', 'write', 'file', 'source']) {
+                    assert.ok(key in e, `json 条目缺 ${key}`);
+                }
+            }
+            assert.ok(entries.some(e => e.source === 'user' && e.domain === 'procurement'));
+        }],
+    ['别名执行 --dry-run：缺省迭代自动解析（3002）并注入 vars 预览，探测只读', async () => {
+            const { registry, tracker } = makeRegistry();
+            const io = await withExitCode(() => runCli(registry, ['pm', 'risk', 'scan', '--dry-run']));
+            assert.ok(io.out.includes('dry-run'), io.out);
+            assert.ok(io.out.includes('"iteration_id": "3002"'), `预览应注入探测到的迭代: ${io.out}`);
+            assert.ok(io.out.includes('[read]  stories (tapd_get_stories)'));
+            assert.equal(tracker.probes.length, 1, '探测恰一次');
+            assert.equal(tracker.probes[0].status, 'open');
+            assert.equal(tracker.storyArgs.length, 0, 'dry-run 不执行业务步骤');
+            assert.ok(io.err.includes('iteration: 自动选择 open 迭代 3002（Sprint B）'), io.err);
+            assert.ok(tracker.probes[0].fields === 'id,name,startdate,status');
+        }],
+    ['--iteration 显式注入：跳过缺省探测', async () => {
+            const { registry, tracker } = makeRegistry();
+            const io = await withExitCode(() => runCli(registry, ['pm', 'risk', 'scan', '--dry-run', '--iteration', '1001']));
+            assert.equal(tracker.probes.length, 0, '显式 --iteration 不应探测');
+            assert.ok(io.out.includes('"iteration_id": "1001"'), io.out);
+            assert.ok(!io.err.includes('自动选择'));
+        }],
+    ['别名路由到 pipeline 引擎：真实执行 + zzz 过滤 + workspace_id 兜底注入', async () => {
+            const { registry, tracker } = makeRegistry();
+            const io = await withExitCode(() => runCli(registry, ['pm', 'risk', 'scan', '--workspace-id', '39814312']));
+            assert.equal(tracker.storyArgs.length, 1);
+            assert.deepEqual(tracker.storyArgs[0], { iteration_id: '3002', fields: 'id,name', workspace_id: 39814312 });
+            // 默认 report：无模板 report 块时输出运行摘要（zzz 过滤后 stories 1 条；iterations 返回对象 → ok）
+            assert.ok(io.out.includes('stories (tapd_get_stories): 1 条'), io.out);
+            assert.ok(io.out.includes('iterations (tapd_get_iterations): ok'), io.out);
+        }],
+    ['写闸门：含写场景未 --yes 拒绝落库（退出码 2）+ 预览；--yes 后才执行', async () => {
+            const { registry, tracker } = makeRegistry();
+            const blocked = await withExitCode(() => runCli(registry, ['pm', 'scope', 'close']));
+            assert.ok(blocked.err.includes('WRITE_GATE'), blocked.err);
+            assert.ok(blocked.out.includes('write gate'));
+            assert.equal(tracker.updateArgs.length, 0, '未 --yes 不得执行写步骤');
+            const allowed = await withExitCode(() => runCli(registry, ['pm', 'scope', 'close', '--yes']));
+            assert.equal(tracker.updateArgs.length, 1);
+            assert.deepEqual(tracker.updateArgs[0], { id: '3002', status: 'closed' }, '写步骤拿到探测迭代注入的 vars');
+            assert.ok(!allowed.err.includes('WRITE_GATE'));
+        }],
+    ['未知场景：CliError 列出该域可用场景', async () => {
+            const { registry } = makeRegistry();
+            await assert.rejects(withExitCode(() => runCli(registry, ['pm', 'risk', 'nope'])), (error) => error instanceof CliError &&
+                error.code === 'INVALID_ARGS' &&
+                error.message.includes('域 risk 下没有场景 "nope"') &&
+                error.message.includes('可用场景') &&
+                error.message.includes('scan'));
+        }],
+    ['自定义域可执行：pm procurement audit 走同一条别名链路', async () => {
+            const { registry, tracker } = makeRegistry();
+            const io = await withExitCode(() => runCli(registry, ['pm', 'procurement', 'audit', '--dry-run']));
+            assert.ok(io.out.includes('procurement-audit'), io.out);
+            assert.ok(io.out.includes('dry-run'));
+            assert.ok(tracker.storyArgs.length === 0);
+        }],
+];
+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 (prevEnv === undefined)
+        delete process.env.TAPD_USER_TEMPLATES_DIR;
+    else
+        process.env.TAPD_USER_TEMPLATES_DIR = prevEnv;
+    if (prevToken === undefined)
+        delete process.env.TAPD_ACCESS_TOKEN;
+    else
+        process.env.TAPD_ACCESS_TOKEN = prevToken;
+    rmSync(root, { 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=pm-command.test.js.map

package/dist/pm/pm-command.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm-command.test.js","sourceRoot":"","sources":["../../src/pm/pm-command.test.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,uEAAuE;AAEvE,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,uCAAuC;AAEvC,MAAM,SAAS,GAAG;;;;;;;;;;;;;6BAaW,GAAG;;CAE/B,CAAC;AAEF,MAAM,WAAW,GAAG;;;;;;;;;mBASD,GAAG;CACrB,CAAC;AAEF,MAAM,iBAAiB,GAAG;;;;;;CAMzB,CAAC;AAEF,0BAA0B;AAE1B,MAAM,eAAe,GAAG;IACtB,IAAI,EAAE;QACJ,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE;QACzE,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE;QAClF,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE;KAC1E;CACF,CAAC;AAQF,SAAS,YAAY;IACnB,MAAM,OAAO,GAAY,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IACvE,MAAM,KAAK,GAAc;QACvB;YACE,IAAI,EAAE,qBAAqB;YAC3B,WAAW,EAAE,0BAA0B;YACvC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;aAC9B,CAAC;YACF,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC3B,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAiC,CAAC,CAAC;gBACvD,OAAO,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;YAC1C,CAAC;SACF;QACD;YACE,IAAI,EAAE,kBAAkB;YACxB,WAAW,EAAE,gCAAgC;YAC7C,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBACnC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;aAC9B,CAAC;YACF,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC3B,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,MAAiC,CAAC,CAAC;gBAC1D,OAAO,OAAO,CAAC,OAAO,CAAC;oBACrB,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;oBAC7B,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,mBAAmB,EAAE;iBACxC,CAAC,CAAC;YACL,CAAC;SACF;QACD;YACE,IAAI,EAAE,mBAAmB;YACzB,WAAW,EAAE,WAAW;YACxB,KAAK,EAAE,IAAI;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBACnC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;gBACd,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;aAC9B,CAAC;YACF,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC3B,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,MAAiC,CAAC,CAAC;gBAC3D,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,EAAG,MAAyB,CAAC,EAAE,EAAE,CAAC,CAAC;YAChE,CAAC;SACF;KACF,CAAC;IACF,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACzB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC;AASD,SAAS,SAAS,CAAC,GAAwB;IACzC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1D,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,KAAc,EAAW,EAAE;QACjD,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IACF,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,KAAc,EAAW,EAAE;QACjD,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IACF,OAAO,GAAG,EAAE,CAAC,IAAI,CACf,GAAG,EAAE;QACH,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC;QAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC;QAC/B,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IAClD,CAAC,EACD,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC;QAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC;QAC/B,MAAM,KAAK,CAAC;IACd,CAAC,CACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,YAAY,CAAI,EAAoB;IACjD,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC9B,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,QAAsB,EAAE,IAAc,EAAE,MAAM,GAAG,EAAE;IACvE,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/C,8DAA8D;IAC9D,OAAO,SAAS,CAAC,KAAK,IAAI,EAAE;QAC1B,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,OAAO,CAAC,QAAsB,EAAE,IAAc;IAC3D,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1D,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,KAAc,EAAW,EAAE;QACjD,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IACF,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,+CAA+C;IACjD,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC;IACjC,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;AACxC,CAAC;AAED,uBAAuB;AAEvB,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAClE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACtD,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,gBAAgB,CAAC,EAAE,SAAS,CAAC,CAAC;AAClE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,kBAAkB,CAAC,EAAE,WAAW,CAAC,CAAC;AACtE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,wBAAwB,CAAC,EAAE,iBAAiB,CAAC,CAAC;AAClF,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;AACpD,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,IAAI,CAAC;AAC3C,gFAAgF;AAChF,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;AAChD,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,eAAe,CAAC;AAEhD,MAAM,MAAM,GAA2C;IACrD,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;YACxD,MAAM,EAAE,QAAQ,EAAE,GAAG,YAAY,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC;YAC5D,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;YAC7B,8BAA8B;YAC9B,KAAK,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,CAAC,EAAE,CAAC;gBACzI,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,WAAW,GAAG,EAAE,CAAC,CAAC;YAC1E,CAAC;YACD,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;YACrD,MAAM,IAAI,GAAG,EAAE,CAAC,GAAG,CAAC;YACpB,KAAK,MAAM,QAAQ,IAAI;gBACrB,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa;gBAC7F,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa;gBACtD,wCAAwC;gBACxC,6CAA6C;gBAC7C,IAAI,EAAE,mBAAmB;gBACzB,WAAW,EAAE,kBAAkB,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe;aACvE,EAAE,CAAC;gBACF,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,QAAQ,EAAE,CAAC,CAAC;YAC9D,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACpC,MAAM,CAAC,EAAE,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC,CAAC;QACnE,CAAC,CAAC;IACF,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;YAC5C,MAAM,EAAE,QAAQ,EAAE,GAAG,YAAY,EAAE,CAAC;YACpC,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;YAC7D,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;YAC1D,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,wCAAwC,CAAC,CAAC,CAAC;YACrE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,6BAA6B,CAAC,CAAC,CAAC;QAC5D,CAAC,CAAC;IACF,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;YACxC,MAAM,EAAE,QAAQ,EAAE,GAAG,YAAY,EAAE,CAAC;YACpC,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC9D,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;QAC7C,CAAC,CAAC;IACF,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;YAChE,MAAM,EAAE,QAAQ,EAAE,GAAG,YAAY,EAAE,CAAC;YACpC,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;YACtE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;YACpE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,6CAA6C,CAAC,CAAC;YACpE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,oDAAoD,CAAC,CAAC;YAE3E,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;YAChG,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,CAAC;YAE3F,MAAM,MAAM,CAAC,OAAO,CAClB,YAAY,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,EACxE,CAAC,KAAc,EAAE,EAAE,CAAC,KAAK,YAAY,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CACtF,CAAC;YAEF,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;YAC5F,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAA8B,CAAC;YAClE,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;YAC/B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,KAAK,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;oBAC5E,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,YAAY,GAAG,EAAE,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC;YACD,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC;QAClF,CAAC,CAAC;IACF,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;YAC3D,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,YAAY,EAAE,CAAC;YAC7C,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;YAC3F,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;YAC9C,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,gBAAgB,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;YAC/E,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,oCAAoC,CAAC,CAAC,CAAC;YACjE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;YAChD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC/C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,iBAAiB,CAAC,CAAC;YAC7D,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,wCAAwC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;YAC7E,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,0BAA0B,CAAC,CAAC;QACrE,CAAC,CAAC;IACF,CAAC,yBAAyB,EAAE,KAAK,IAAI,EAAE;YACrC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,YAAY,EAAE,CAAC;YAC7C,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;YAClH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,qBAAqB,CAAC,CAAC;YAC9D,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;YAC7D,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QACtC,CAAC,CAAC;IACF,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;YACjE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,YAAY,EAAE,CAAC;YAC7C,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,CACjC,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,UAAU,CAAC,CAAC,CACvE,CAAC;YACF,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC1C,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC5G,0EAA0E;YAC1E,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,iCAAiC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;YACtE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,sCAAsC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;QAC7E,CAAC,CAAC;IACF,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;YACxD,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,YAAY,EAAE,CAAC;YAC7C,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;YACrF,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;YAC3D,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;YAC9C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,iBAAiB,CAAC,CAAC;YAE9D,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;YAC9F,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC3C,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,mBAAmB,CAAC,CAAC;YAC/F,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;QACjD,CAAC,CAAC;IACF,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;YACpC,MAAM,EAAE,QAAQ,EAAE,GAAG,YAAY,EAAE,CAAC;YACpC,MAAM,MAAM,CAAC,OAAO,CAClB,YAAY,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAC5D,CAAC,KAAc,EAAE,EAAE,CACjB,KAAK,YAAY,QAAQ;gBACzB,KAAK,CAAC,IAAI,KAAK,cAAc;gBAC7B,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC;gBAC3C,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAC9B,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CACnC,CAAC;QACJ,CAAC,CAAC;IACF,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;YACnD,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,YAAY,EAAE,CAAC;YAC7C,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;YACnG,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;YACxD,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;YACtC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;QAC5C,CAAC,CAAC;CACH,CAAC;AAEF,IAAI,MAAM,GAAG,CAAC,CAAC;AACf,IAAI,CAAC;IACH,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,EAAE,EAAE,CAAC;YACX,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,EAAE,CAAC;YACT,OAAO,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;YAChC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;AACH,CAAC;QAAS,CAAC;IACT,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;;QACjE,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,OAAO,CAAC;IACnD,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;;QAC7D,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAC/C,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACjD,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/pm/render.d.ts

@@ -0,0 +1,17 @@
+import { type PmCatalog, type PmTemplateEntry } from './discovery.js';
+export interface PmDomainGroup {
+    /** 域键；「其他」组为空串 */
+    key: string;
+    label: string;
+    known: boolean;
+    entries: PmTemplateEntry[];
+}
+/** 按域表序分组；未知 domain 归「其他」（置于最后） */
+export declare function groupByDomain(entries: PmTemplateEntry[]): PmDomainGroup[];
+/** `tapd pm --help` 的域分组块（commander addHelpText('after') 用） */
+export declare function renderPmHelp(catalog: PmCatalog): string;
+/** `tapd pm <domain> --help` 的场景清单块 */
+export declare function renderDomainHelp(domainKey: string, catalog: PmCatalog): string;
+/** `tapd pm list` 明细行（域 / 场景 / 是否写 / 来源 / 标题） */
+export declare function renderPmList(entries: PmTemplateEntry[]): string;
+//# sourceMappingURL=render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/pm/render.ts"],"names":[],"mappings":"AAKA,OAAO,EAAsB,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE1F,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,mCAAmC;AACnC,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,aAAa,EAAE,CAazE;AAaD,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,CA8BvD;AAED,uCAAuC;AACvC,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,MAAM,CAW9E;AAED,iDAAiD;AACjD,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CAe/D"}

package/dist/pm/render.js

@@ -0,0 +1,82 @@
+// pm help / list 渲染：分组由「模板 × 域表」动态合成（设计 §2 / 验收 1）
+// 域表见 domains.ts；场景清单来自 discovery —— 后续波次只往 templates/pm/ 丢 yaml，
+// 分组与场景列表自动更新，零注册代码。
+import { PM_DOMAINS, PM_OTHER_DOMAIN_LABEL, domainLabel, findDomain } from './domains.js';
+import { userPmTemplatesDir } from './discovery.js';
+/** 按域表序分组；未知 domain 归「其他」（置于最后） */
+export function groupByDomain(entries) {
+    const groups = PM_DOMAINS.map(d => ({
+        key: d.key,
+        label: `${d.zh}（${d.chapter}）`,
+        known: true,
+        entries: [],
+    }));
+    const other = { key: '', label: PM_OTHER_DOMAIN_LABEL, known: false, entries: [] };
+    for (const e of entries) {
+        const meta = findDomain(e.domain);
+        (meta ? groups.find(g => g.key === e.domain) : other).entries.push(e);
+    }
+    return [...groups, other];
+}
+function pad(value, width) {
+    return value.length >= width ? value : value + ' '.repeat(width - value.length);
+}
+function scenarioLine(prefix, entry) {
+    const mark = entry.write ? '[write]' : '[read] ';
+    const title = entry.title ? `${entry.title} ` : '';
+    const userTag = entry.source === 'user' ? ' （用户覆盖）' : '';
+    return `${prefix}${pad(entry.scenario, 18)}${title}${mark}${userTag}`;
+}
+/** `tapd pm --help` 的域分组块（commander addHelpText('after') 用） */
+export function renderPmHelp(catalog) {
+    const lines = [
+        '管理语义层（软考高项第4版知识域）：每个场景 = 一份 pipeline 模板的语义别名',
+        '  tapd pm <domain> <scenario>  ≡  tapd pipeline run templates/pm/<domain>-<scenario>.yaml',
+        '',
+        '域分组:',
+    ];
+    for (const g of groupByDomain(catalog.entries)) {
+        lines.push(`  ${pad(g.key || 'other', 14)}${g.label}`);
+        if (g.entries.length === 0) {
+            lines.push(`      （暂无场景模板——放置 templates/pm/<domain>-<scenario>.yaml 即自动收录）`);
+            continue;
+        }
+        for (const e of g.entries) {
+            // 「其他」组带域前缀，方便定位是哪个自定义域
+            const prefix = g.known ? '      ' : `      ${e.domain || '无域'}/`;
+            lines.push(scenarioLine(prefix, e));
+        }
+    }
+    lines.push('', '通用 flags:', '  --iteration <id>  迭代作用域（缺省自动取最新 open 迭代，过滤 zzz-delete-me*）', '  --input <json>    模板变量注入（JSON 对象），如 --input \'{"owner":"xu"}\'', '  --dry-run         只打印执行计划预览，不执行任何步骤', '  --yes             确认执行写步骤（含写步骤的场景缺省 dry-run 闸门拒绝落库）', '', `用户模板目录: ${userPmTemplatesDir()}（同名覆盖内置；tapd pm list 查看清单）`);
+    return lines.join('\n');
+}
+/** `tapd pm <domain> --help` 的场景清单块 */
+export function renderDomainHelp(domainKey, catalog) {
+    const meta = findDomain(domainKey);
+    const head = meta ? `${domainKey} ${domainLabel(domainKey)}` : `${domainKey}（自定义域）`;
+    const lines = [`${head} 场景:`];
+    const inDomain = catalog.entries.filter(e => e.domain === domainKey);
+    if (inDomain.length === 0) {
+        lines.push('  （暂无场景模板——放置 templates/pm/<domain>-<scenario>.yaml 即自动收录）');
+    }
+    for (const e of inDomain)
+        lines.push(scenarioLine('  ', e));
+    lines.push(`用法: tapd pm ${domainKey} <scenario> [--iteration <id>] [--dry-run] [--yes]`);
+    return lines.join('\n');
+}
+/** `tapd pm list` 明细行（域 / 场景 / 是否写 / 来源 / 标题） */
+export function renderPmList(entries) {
+    if (entries.length === 0) {
+        return `（暂无 pm 场景模板——放置 ${userPmTemplatesDir()}/ 或随包 templates/pm/ 即自动收录）`;
+    }
+    const domainWidth = Math.max('domain'.length, ...entries.map(e => e.domain.length));
+    const scenarioWidth = Math.max('scenario'.length, ...entries.map(e => e.scenario.length));
+    const lines = [
+        `${pad('domain', domainWidth)}  ${pad('scenario', scenarioWidth)}  mode   source   title`,
+    ];
+    for (const e of entries) {
+        lines.push(`${pad(e.domain, domainWidth)}  ${pad(e.scenario, scenarioWidth)}  ${e.write ? 'write' : 'read '}  ${pad(e.source, 6)}  ${e.title}${e.source === 'user' ? ' （用户覆盖内置）' : ''}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=render.js.map

package/dist/pm/render.js.map

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

package/dist/pm/tpl-communication-stakeholder.test.d.ts

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

package/dist/pm/tpl-communication-stakeholder.test.d.ts.map

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