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

package/dist/pm/discovery.test.js

@@ -0,0 +1,147 @@
+// pm 模板发现 / 用户覆盖 / 别名解析 / 元数据剥离测试（S2）
+// fixture 模板写在测试临时目录（TAPD_USER_TEMPLATES_DIR 注入），不污染 templates/pm/。
+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 { PipelineError } from '../pipeline/types.js';
+import { CliError } from '../errors.js';
+import { discoverPmTemplates, loadPmTemplate, mergePmEntries, resolvePmEntry, userPmTemplatesDir, } from './discovery.js';
+import { builtinPmTemplatesDir } from './discovery.js';
+const RISK_SCAN = `# 多源风险扫描（fixture）
+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: overdue
+    uses: tapd_get_stories
+    args: { iteration_id: "${'$'}{vars.iteration_id}" }
+`;
+const prevEnv = process.env.TAPD_USER_TEMPLATES_DIR;
+function makeEntry(partial) {
+    return {
+        domain: 'risk',
+        scenario: 'scan',
+        name: 'risk-scan',
+        title: '',
+        write: false,
+        file: '/tmp/x.yaml',
+        source: 'builtin',
+        domainKnown: true,
+        ...partial,
+    };
+}
+const checks = [
+    ['内置目录 = builtinTemplatesDir()/pm，用户目录默认 ~/.tapd/templates/pm', () => {
+            assert.ok(builtinPmTemplatesDir().endsWith(path.join('templates', 'pm')));
+            assert.ok(userPmTemplatesDir().endsWith(path.join('pm')));
+        }],
+    ['发现：扫描用户目录，frontmatter domain 命中域表；坏文件降级为 warning 不炸', () => {
+            process.env.TAPD_USER_TEMPLATES_DIR = root;
+            try {
+                const catalog = discoverPmTemplates();
+                const scan = catalog.entries.find(e => e.scenario === 'scan');
+                assert.ok(scan, 'risk-scan 应被收录');
+                assert.equal(scan.domain, 'risk');
+                assert.equal(scan.domainKnown, true);
+                assert.equal(scan.source, 'user');
+                assert.equal(scan.write, false);
+                assert.equal(scan.name, 'risk-scan');
+                assert.equal(scan.title, '风险扫描（fixture）');
+                // broken.yaml（非法 yaml）与 no-steps.yaml（缺 steps）只产 warning
+                assert.equal(catalog.warnings.length, 2);
+                assert.ok(catalog.warnings.some(w => w.includes('broken.yaml')));
+                assert.ok(catalog.warnings.some(w => w.includes('no-steps.yaml')));
+                // 自定义域 procurement：domainKnown=false，仍被收录（可执行，help 归「其他」）
+                const audit = catalog.entries.find(e => e.scenario === 'audit');
+                assert.ok(audit);
+                assert.equal(audit.domain, 'procurement');
+                assert.equal(audit.domainKnown, false);
+            }
+            finally {
+                if (prevEnv === undefined)
+                    delete process.env.TAPD_USER_TEMPLATES_DIR;
+                else
+                    process.env.TAPD_USER_TEMPLATES_DIR = prevEnv;
+            }
+        }],
+    ['用户同名覆盖内置（mergePmEntries 同别名 user 胜出）', () => {
+            const builtin = [
+                makeEntry({ source: 'builtin', file: '/builtin/risk-scan.yaml' }),
+                makeEntry({ domain: 'scope', scenario: 'drift-check', name: 'scope-drift-check', file: '/builtin/scope-drift-check.yaml' }),
+            ];
+            const user = [makeEntry({ source: 'user', file: '/user/risk-scan.yaml', title: '用户版' })];
+            const merged = mergePmEntries(builtin, user);
+            assert.equal(merged.length, 2, '同别名只保留一份');
+            const scan = merged.find(e => e.scenario === 'scan');
+            assert.equal(scan.source, 'user');
+            assert.equal(scan.title, '用户版');
+            assert.equal(merged.find(e => e.scenario === 'drift-check').source, 'builtin');
+            // 排序：域表序在前
+            assert.ok(merged.findIndex(e => e.domain === 'scope') < merged.findIndex(e => e.domain === 'risk'));
+        }],
+    ['别名解析：命中 / 未知域 / 已知域缺场景（错误信息给可操作指引）', () => {
+            const catalog = {
+                entries: [
+                    makeEntry({ domain: 'risk', scenario: 'scan' }),
+                    makeEntry({ domain: 'risk', scenario: 'register', name: 'risk-register', write: true }),
+                ],
+                warnings: [],
+            };
+            const hit = resolvePmEntry(catalog, 'risk', 'scan');
+            assert.equal(hit.file, '/tmp/x.yaml');
+            // name 兜底匹配 <domain>-<scenario>
+            assert.equal(resolvePmEntry(catalog, 'risk', 'register').write, true);
+            assert.throws(() => resolvePmEntry(catalog, 'procurement', 'audit'), (error) => error instanceof CliError && error.code === 'INVALID_ARGS' && error.message.includes('未知域 "procurement"') && error.message.includes('integration, scope'));
+            assert.throws(() => resolvePmEntry(catalog, 'risk', 'nope'), (error) => error instanceof CliError && error.message.includes('域 risk 下没有场景 "nope"') && error.message.includes('scan, register'));
+            // 空目录的已知域：指引放模板即收录
+            assert.throws(() => resolvePmEntry({ entries: [], warnings: [] }, 'risk', 'scan'), (error) => error instanceof CliError && error.message.includes('放置 templates/pm'));
+        }],
+    ['loadPmTemplate：剥离 frontmatter domain 后交 S1 严格校验；坏结构抛 TEMPLATE_INVALID', () => {
+            const ok = loadPmTemplate({ ...makeEntry({}), file: path.join(root, 'pm', 'risk-scan.yaml') });
+            assert.equal(ok.template.name, 'risk-scan');
+            assert.equal(ok.template.write, false);
+            assert.equal(ok.template.steps.length, 2);
+            assert.equal(ok.template.domain, undefined, 'domain 字段必须被剥离');
+            assert.equal(ok.path, path.join(root, 'pm', 'risk-scan.yaml'));
+            assert.throws(() => loadPmTemplate({ ...makeEntry({}), file: path.join(root, 'pm', 'broken.yaml') }), (error) => error instanceof PipelineError && error.code === 'TEMPLATE_INVALID');
+            assert.throws(() => loadPmTemplate({ ...makeEntry({}), file: '/nonexistent/nope.yaml' }), (error) => error instanceof PipelineError && error.code === 'IO');
+        }],
+];
+// ---- fixture 准备 ----
+const root = mkdtempSync(path.join(tmpdir(), 'tapd-pm-discovery-'));
+mkdirSync(path.join(root, 'pm'), { recursive: true });
+writeFileSync(path.join(root, 'pm', 'risk-scan.yaml'), RISK_SCAN);
+writeFileSync(path.join(root, 'pm', 'procurement-audit.yaml'), 'name: procurement-audit\ndomain: procurement\ntitle: 外部依赖台账\nsteps:\n  - id: a\n    uses: tapd_get_stories\n');
+writeFileSync(path.join(root, 'pm', 'broken.yaml'), 'name: [broken\n  steps: {{{');
+writeFileSync(path.join(root, 'pm', 'no-steps.yaml'), 'name: no-steps\ntitle: 没有 steps\n');
+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 {
+    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=discovery.test.js.map

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

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

package/dist/pm/domains.d.ts

@@ -0,0 +1,15 @@
+export interface PmDomainMeta {
+    /** 命令域键：tapd pm <key> <scenario> */
+    key: string;
+    /** 域中文名 */
+    zh: string;
+    /** 高项第4版章节号 */
+    chapter: string;
+}
+export declare const PM_DOMAINS: readonly PmDomainMeta[];
+/** frontmatter domain 不在域表中的模板在 help 分组里归入的组 */
+export declare const PM_OTHER_DOMAIN_LABEL = "\u5176\u4ED6";
+export declare function findDomain(key: string): PmDomainMeta | undefined;
+/** '风险管理（第15章）'；未知域返回分组名「其他」 */
+export declare function domainLabel(key: string): string;
+//# sourceMappingURL=domains.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../../src/pm/domains.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW;IACX,EAAE,EAAE,MAAM,CAAC;IACX,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,UAAU,EAAE,SAAS,YAAY,EAS7C,CAAC;AAEF,gDAAgD;AAChD,eAAO,MAAM,qBAAqB,iBAAO,CAAC;AAE1C,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEhE;AAED,gCAAgC;AAChC,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG/C"}

package/dist/pm/domains.js

@@ -0,0 +1,27 @@
+// pm 域元数据表（S2 框架所有，硬编码）
+// 软考高项第4版知识域 → pm 命令域键。采购（第16章）场景过弱不设域、绩效监控（第18章）
+// 由 integration/cost/quality 组合覆盖 —— 口径来源 tapd-2.0.0-pm-layer-design.md §2。
+//
+// 本表只描述「域」本身；场景清单由模板发现动态渲染（S3-S6 往 templates/pm/ 丢 yaml 即被
+// 收录，无需改本文件或任何注册代码）。
+export const PM_DOMAINS = [
+    { key: 'integration', zh: '整合管理', chapter: '第8章' },
+    { key: 'scope', zh: '范围管理', chapter: '第9章' },
+    { key: 'schedule', zh: '进度管理', chapter: '第10章' },
+    { key: 'cost', zh: '成本管理', chapter: '第11章' },
+    { key: 'quality', zh: '质量管理', chapter: '第12章' },
+    { key: 'communication', zh: '沟通管理', chapter: '第14章' },
+    { key: 'risk', zh: '风险管理', chapter: '第15章' },
+    { key: 'stakeholder', zh: '干系人管理', chapter: '第17章' },
+];
+/** frontmatter domain 不在域表中的模板在 help 分组里归入的组 */
+export const PM_OTHER_DOMAIN_LABEL = '其他';
+export function findDomain(key) {
+    return PM_DOMAINS.find(d => d.key === key);
+}
+/** '风险管理（第15章）'；未知域返回分组名「其他」 */
+export function domainLabel(key) {
+    const d = findDomain(key);
+    return d ? `${d.zh}（${d.chapter}）` : PM_OTHER_DOMAIN_LABEL;
+}
+//# sourceMappingURL=domains.js.map

package/dist/pm/domains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domains.js","sourceRoot":"","sources":["../../src/pm/domains.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,kDAAkD;AAClD,4EAA4E;AAC5E,EAAE;AACF,2DAA2D;AAC3D,qBAAqB;AAWrB,MAAM,CAAC,MAAM,UAAU,GAA4B;IACjD,EAAE,GAAG,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE;IAClD,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE;IAC5C,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;IAChD,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;IAC5C,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;IAC/C,EAAE,GAAG,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;IACrD,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;IAC5C,EAAE,GAAG,EAAE,aAAa,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE;CACrD,CAAC;AAEF,gDAAgD;AAChD,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAE1C,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,qBAAqB,CAAC;AAC7D,CAAC"}

package/dist/pm/domains.test.d.ts

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

package/dist/pm/domains.test.d.ts.map

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

package/dist/pm/domains.test.js

@@ -0,0 +1,141 @@
+// pm 域元数据表与分组渲染测试（S2）
+import assert from 'node:assert/strict';
+import { PM_DOMAINS, PM_OTHER_DOMAIN_LABEL, domainLabel, findDomain } from './domains.js';
+import { groupByDomain, renderDomainHelp, renderPmHelp, renderPmList } from './render.js';
+import { pmAliasKey, splitAlias } from './discovery.js';
+function entry(partial) {
+    return {
+        domain: 'risk',
+        scenario: 'scan',
+        name: 'risk-scan',
+        title: '',
+        write: false,
+        file: '/tmp/risk-scan.yaml',
+        source: 'builtin',
+        domainKnown: true,
+        ...partial,
+    };
+}
+const emptyCatalog = { entries: [], warnings: [] };
+const checks = [
+    ['域表：8 域、键唯一、章节号格式、与设计 §2 顺序一致', () => {
+            assert.equal(PM_DOMAINS.length, 8);
+            assert.deepEqual(PM_DOMAINS.map(d => d.key), ['integration', 'scope', 'schedule', 'cost', 'quality', 'communication', 'risk', 'stakeholder']);
+            assert.equal(new Set(PM_DOMAINS.map(d => d.key)).size, 8);
+            for (const d of PM_DOMAINS) {
+                assert.match(d.chapter, /^第\d+章$/);
+                assert.ok(d.zh.length > 0);
+            }
+            assert.deepEqual(PM_DOMAINS.map(d => d.chapter), ['第8章', '第9章', '第10章', '第11章', '第12章', '第14章', '第15章', '第17章']);
+        }],
+    ['domainLabel：命中域表出中文名+章节号，未知归「其他」', () => {
+            assert.equal(domainLabel('risk'), '风险管理（第15章）');
+            assert.equal(domainLabel('communication'), '沟通管理（第14章）');
+            assert.equal(domainLabel('procurement'), PM_OTHER_DOMAIN_LABEL);
+            assert.equal(findDomain('nope'), undefined);
+        }],
+    ['groupByDomain：域表序在前，「其他」永远最后', () => {
+            const groups = groupByDomain([
+                entry({ domain: 'risk', scenario: 'scan' }),
+                entry({ domain: 'procurement', scenario: 'audit', domainKnown: false }),
+                entry({ domain: 'stakeholder', scenario: 'map' }),
+                entry({ domain: '', scenario: 'orphan', domainKnown: false }),
+            ]);
+            const keys = groups.map(g => g.key);
+            assert.deepEqual(keys, ['integration', 'scope', 'schedule', 'cost', 'quality', 'communication', 'risk', 'stakeholder', '']);
+            assert.deepEqual(groups.at(-1).label, PM_OTHER_DOMAIN_LABEL);
+            // 「其他」收编未知域与无域模板，known 域各归其位
+            assert.deepEqual(groups.at(-1).entries.map(e => e.scenario), ['audit', 'orphan']);
+            assert.equal(groups.find(g => g.key === 'risk').entries.length, 1);
+            assert.equal(groups.find(g => g.key === 'integration').entries.length, 0);
+        }],
+    ['renderPmHelp：空目录也有八域骨架与收录提示（零代码注册入口）', () => {
+            const help = renderPmHelp(emptyCatalog);
+            for (const key of ['integration', 'scope', 'schedule', 'cost', 'quality', 'communication', 'risk', 'stakeholder']) {
+                assert.ok(help.includes(key), `help 缺域键 ${key}`);
+            }
+            assert.ok(help.includes('整合管理（第8章）'));
+            assert.ok(help.includes('干系人管理（第17章）'));
+            assert.ok(help.includes('自动收录'));
+            assert.ok(help.includes('--iteration'));
+            assert.ok(help.includes('--dry-run'));
+            assert.ok(help.includes('--yes'));
+            assert.ok(help.includes('zzz-delete-me'));
+        }],
+    ['renderPmHelp：场景行带标题与 read/write 标记；未知域归「其他」且带域前缀', () => {
+            const help = renderPmHelp({
+                entries: [
+                    entry({ domain: 'risk', scenario: 'scan', title: '风险扫描（软考第15章）' }),
+                    entry({ domain: 'scope', scenario: 'baseline', write: true, title: '范围基线冻结' }),
+                    entry({ domain: 'procurement', scenario: 'audit', domainKnown: false }),
+                ],
+                warnings: [],
+            });
+            assert.ok(help.includes('scan              风险扫描（软考第15章） [read]'));
+            assert.ok(help.includes('baseline          范围基线冻结 [write]'));
+            assert.ok(help.includes('procurement/audit'));
+            const otherIdx = help.indexOf(PM_OTHER_DOMAIN_LABEL);
+            const stakeholderIdx = help.indexOf('stakeholder');
+            assert.ok(otherIdx > stakeholderIdx, '「其他」组必须排在域表之后');
+        }],
+    ['renderDomainHelp：域标题带中文与章节号，场景对齐+写标记', () => {
+            const help = renderDomainHelp('risk', {
+                entries: [
+                    entry({ domain: 'risk', scenario: 'register', write: true, title: '登记册维护' }),
+                    entry({ domain: 'risk', scenario: 'scan', title: '风险扫描' }),
+                ],
+                warnings: [],
+            });
+            assert.ok(help.startsWith('risk 风险管理（第15章） 场景:'));
+            assert.ok(help.includes('register          登记册维护 [write]'));
+            assert.ok(help.includes('scan              风险扫描 [read]'));
+            assert.ok(help.includes('用法: tapd pm risk <scenario>'));
+            // 自定义域无域表元数据
+            const custom = renderDomainHelp('procurement', { entries: [], warnings: [] });
+            assert.ok(custom.includes('procurement（自定义域）'));
+            assert.ok(custom.includes('暂无场景模板'));
+        }],
+    ['renderPmList：列头与域/场景/读写/来源/标题', () => {
+            const list = renderPmList([
+                entry({ domain: 'risk', scenario: 'scan', title: '风险扫描', source: 'builtin' }),
+                entry({ domain: 'risk', scenario: 'register', title: '登记册', write: true, source: 'user' }),
+            ]);
+            const lines = list.split('\n');
+            assert.equal(lines.length, 3);
+            assert.match(lines[0], /^domain\s+scenario\s+mode\s+source\s+title$/);
+            assert.match(lines[1], /^risk\s+scan\s+read\s+builtin\s+风险扫描$/);
+            assert.match(lines[2], /^risk\s+register\s+write\s+user\s+登记册/);
+            assert.ok(list.includes('用户覆盖内置'));
+        }],
+    ['renderPmList：空清单给收录指引', () => {
+            const list = renderPmList([]);
+            assert.ok(list.includes('暂无 pm 场景模板'));
+            assert.ok(list.includes('自动收录'));
+        }],
+    ['splitAlias / pmAliasKey：文件名首个 - 拆域；frontmatter domain 优先', () => {
+            assert.deepEqual(splitAlias('risk-scan'), { domain: 'risk', scenario: 'scan' });
+            assert.deepEqual(splitAlias('scope-drift-check'), { domain: 'scope', scenario: 'drift-check' });
+            assert.deepEqual(splitAlias('standup', 'schedule'), { domain: 'schedule', scenario: 'standup' });
+            assert.deepEqual(splitAlias('drift-check', 'scope'), { domain: 'scope', scenario: 'drift-check' });
+            assert.deepEqual(splitAlias('orphan'), { domain: '', scenario: 'orphan' });
+            assert.equal(pmAliasKey({ domain: 'risk', scenario: 'scan' }), 'risk::scan');
+        }],
+];
+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=domains.test.js.map

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

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

package/dist/pm/index.d.ts

@@ -0,0 +1,9 @@
+export { PM_DOMAINS, PM_OTHER_DOMAIN_LABEL, findDomain, domainLabel } from './domains.js';
+export type { PmDomainMeta } from './domains.js';
+export { PM_TEMPLATE_EXTS, builtinPmTemplatesDir, userTemplatesRoot, userPmTemplatesDir, pmAliasKey, splitAlias, discoverPmTemplates, mergePmEntries, resolvePmEntry, loadPmTemplate, } from './discovery.js';
+export type { PmTemplateEntry, PmCatalog } from './discovery.js';
+export { groupByDomain, renderPmHelp, renderDomainHelp, renderPmList } from './render.js';
+export type { PmDomainGroup } from './render.js';
+export { pickLatestOpenIteration, probeDefaultIteration } from './iteration.js';
+export type { ResolvedIteration, IterationProbe } from './iteration.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pm/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC1F,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1F,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAChF,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/pm/index.js

@@ -0,0 +1,6 @@
+// pm 管理语义层框架公共出口（S2；S3-S6 域模板与 S7 advisor 域轴从这里取接口）
+export { PM_DOMAINS, PM_OTHER_DOMAIN_LABEL, findDomain, domainLabel } from './domains.js';
+export { PM_TEMPLATE_EXTS, builtinPmTemplatesDir, userTemplatesRoot, userPmTemplatesDir, pmAliasKey, splitAlias, discoverPmTemplates, mergePmEntries, resolvePmEntry, loadPmTemplate, } from './discovery.js';
+export { groupByDomain, renderPmHelp, renderDomainHelp, renderPmList } from './render.js';
+export { pickLatestOpenIteration, probeDefaultIteration } from './iteration.js';
+//# sourceMappingURL=index.js.map

package/dist/pm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pm/index.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE1F,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE1F,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/pm/iteration.d.ts

@@ -0,0 +1,26 @@
+import type { TapdClient, ToolRegistry } from '@xihe-lab/tapd-core';
+export interface ResolvedIteration {
+    id: string;
+    name: string;
+    startdate: string;
+}
+export type IterationProbe = {
+    status: 'resolved';
+    iteration: ResolvedIteration;
+} | {
+    status: 'none';
+} | {
+    status: 'failed';
+    message: string;
+};
+/**
+ * 从 tapd_get_iterations 的返回中选默认迭代：
+ * 兼容数组与 { data: [...] } 两种包裹；过滤 zzz-delete-me*；startdate 最新优先。
+ */
+export declare function pickLatestOpenIteration(rows: unknown): ResolvedIteration | undefined;
+/** 只读探测默认迭代；探测失败不抛错（部分场景不依赖迭代），由调用方决定提示与降级 */
+export declare function probeDefaultIteration(registry: ToolRegistry, clientFactory: () => TapdClient, opts?: {
+    defaultArgs?: Record<string, unknown>;
+    timeoutMs?: number;
+}): Promise<IterationProbe>;
+//# sourceMappingURL=iteration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"iteration.d.ts","sourceRoot":"","sources":["../../src/pm/iteration.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,iBAAiB,CAAA;CAAE,GACpD;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAS1C;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAWpF;AAED,8CAA8C;AAC9C,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,YAAY,EACtB,aAAa,EAAE,MAAM,UAAU,EAC/B,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACvE,OAAO,CAAC,cAAc,CAAC,CAkBzB"}

package/dist/pm/iteration.js

@@ -0,0 +1,50 @@
+// 迭代缺省解析（pm 通用 --iteration 的兜底逻辑）
+//
+// 口径（设计 §2.1）：用户未传 --iteration 时，用一个只读步骤 tapd_get_iterations
+// 取 status=open 迭代，过滤 zzz-delete-me*，按 startdate 取最新一个，把 id 注入
+// vars.iteration_id。探测走 toolRegistry.exec（与 pipeline 步骤同一通道），因此可用
+// mock registry 直接测试。
+/** unknown 字段的安全字符串化（拒绝 [object Object]） */
+function toStr(value) {
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    return '';
+}
+/**
+ * 从 tapd_get_iterations 的返回中选默认迭代：
+ * 兼容数组与 { data: [...] } 两种包裹；过滤 zzz-delete-me*；startdate 最新优先。
+ */
+export function pickLatestOpenIteration(rows) {
+    const list = Array.isArray(rows) ? rows : (rows?.data ?? undefined);
+    if (!Array.isArray(list))
+        return undefined;
+    const cleaned = list.filter((row) => {
+        if (!row || typeof row !== 'object' || Array.isArray(row))
+            return false;
+        return !toStr(row.name).startsWith('zzz-delete-me');
+    });
+    if (cleaned.length === 0)
+        return undefined;
+    const sorted = [...cleaned].sort((a, b) => toStr(b.startdate).localeCompare(toStr(a.startdate)));
+    const top = sorted[0];
+    return { id: toStr(top.id), name: toStr(top.name), startdate: toStr(top.startdate) };
+}
+/** 只读探测默认迭代；探测失败不抛错（部分场景不依赖迭代），由调用方决定提示与降级 */
+export async function probeDefaultIteration(registry, clientFactory, opts = {}) {
+    let result;
+    try {
+        result = await registry.exec('tapd_get_iterations', { status: 'open', fields: 'id,name,startdate,status', ...(opts.defaultArgs ?? {}) }, { entry: 'cli', timeoutMs: opts.timeoutMs }, clientFactory);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { status: 'failed', message };
+    }
+    if (!result.ok) {
+        return { status: 'failed', message: `${result.error?.code}: ${result.error?.message}` };
+    }
+    const picked = pickLatestOpenIteration(result.data);
+    return picked ? { status: 'resolved', iteration: picked } : { status: 'none' };
+}
+//# sourceMappingURL=iteration.js.map

package/dist/pm/iteration.js.map

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

package/dist/pm/iteration.test.d.ts

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

package/dist/pm/iteration.test.d.ts.map

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