@epoint-testtech/ep-stage-skill 0.0.4-alpha.0 → 0.0.5

package/dist/src/testcase/prd-button-mapper.d.ts

@@ -0,0 +1,72 @@
+/**
+ * PRD 功能条目 → 自定义按钮 的确定性映射与模板渲染。
+ *
+ * 职责：
+ * 1. 根据 code_list.implementedScope 把列表页 action='custom' 按钮映射到 PRD 功能条目。
+ * 2. 没有 implementedScope 时，使用 label↔featureName 精确/包含匹配作为兜底。
+ * 3. 将 PRD 字段渲染成中文用例 steps / assertion / businessIntent。
+ *
+ * 设计取舍：
+ * - 全程纯代码逻辑，不调用 LLM，保证幂等。
+ * - PRD 映射优先于 button-interaction-inference 的 assertion，因为 PRD 的 output/result
+ *   是业务期望的事实源；inference 的 steps 仍优先用于 UI 机械步骤。
+ * - 无法映射时返回 undefined，由调用方继续使用 inference 或通用兜底。
+ */
+import type { PrdFunctionEntry } from '../extractors/prd-extractor.js';
+/** code_list 中 implementedScope 的单项。 */
+export type ImplementedScopeItem = {
+    featureId: string;
+    featureName: string;
+    implementationStatus?: string;
+    implementedBy: string[];
+    note?: string;
+};
+/** 列表页自定义按钮的精简描述。 */
+export type CustomButtonRef = {
+    label: string;
+    customAction?: string;
+    actionName?: string;
+    backendMethod?: string | null;
+};
+/** 映射结果。 */
+export type PrdButtonMapping = {
+    featureId: string;
+    featureName: string;
+    matchedBy: 'implementedScope' | 'label-exact' | 'label-contains';
+};
+/**
+ * 把自定义按钮映射到 PRD 功能条目。
+ *
+ * 映射优先级：
+ * 1. implementedScope.implementedBy 命中按钮的 customAction / actionName / backendMethod。
+ * 2. 按钮 label 与 featureName 精确相等。
+ * 3. featureName 包含 label 或 label 包含 featureName（按 PRD 顺序取第一个）。
+ *
+ * @param button - 按钮元数据。
+ * @param prdFunctions - PRD 提取出的功能条目。
+ * @param implementedScope - code_list 中的实现范围（可选）。
+ * @returns 映射结果；未命中时返回 undefined。
+ */
+export declare function mapButtonToPrdFunction(button: CustomButtonRef, prdFunctions: PrdFunctionEntry[], implementedScope?: ImplementedScopeItem[]): PrdButtonMapping | undefined;
+/**
+ * 根据 PRD 功能条目渲染 businessIntent。
+ */
+export declare function renderPrdBusinessIntent(entry: PrdFunctionEntry, label: string): string;
+/**
+ * 根据 PRD 功能条目渲染执行步骤。
+ *
+ * 优先使用 entry.processingLogic；若为空则使用 entry.inputConditions。
+ */
+export declare function renderPrdSteps(entry: PrdFunctionEntry, label: string): string;
+/**
+ * 根据 PRD 功能条目渲染断言。
+ *
+ * 从 outputResult 中提取成功/失败结果，组合成选择型断言。
+ * 若 outputResult 为空，则使用 businessRules 兜底。
+ */
+export declare function renderPrdAssertion(entry: PrdFunctionEntry, label: string): string;
+/**
+ * 获取 PRD 功能条目的输出结果文本（用于 trace / 测试断言）。
+ */
+export declare function getPrdOutputResultText(entry: PrdFunctionEntry): string;
+//# sourceMappingURL=prd-button-mapper.d.ts.map

package/dist/src/testcase/prd-button-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prd-button-mapper.d.ts","sourceRoot":"","sources":["../../../src/testcase/prd-button-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,wCAAwC;AACxC,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,qBAAqB;AACrB,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,YAAY;AACZ,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,kBAAkB,GAAG,aAAa,GAAG,gBAAgB,CAAC;CAClE,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,eAAe,EACvB,YAAY,EAAE,gBAAgB,EAAE,EAChC,gBAAgB,CAAC,EAAE,oBAAoB,EAAE,GACxC,gBAAgB,GAAG,SAAS,CAsB9B;AA+CD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMtF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAkB7E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAiBjF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAEtE"}

package/dist/src/testcase/prd-button-mapper.js

@@ -0,0 +1,148 @@
+/**
+ * PRD 功能条目 → 自定义按钮 的确定性映射与模板渲染。
+ *
+ * 职责：
+ * 1. 根据 code_list.implementedScope 把列表页 action='custom' 按钮映射到 PRD 功能条目。
+ * 2. 没有 implementedScope 时，使用 label↔featureName 精确/包含匹配作为兜底。
+ * 3. 将 PRD 字段渲染成中文用例 steps / assertion / businessIntent。
+ *
+ * 设计取舍：
+ * - 全程纯代码逻辑，不调用 LLM，保证幂等。
+ * - PRD 映射优先于 button-interaction-inference 的 assertion，因为 PRD 的 output/result
+ *   是业务期望的事实源；inference 的 steps 仍优先用于 UI 机械步骤。
+ * - 无法映射时返回 undefined，由调用方继续使用 inference 或通用兜底。
+ */
+/**
+ * 把自定义按钮映射到 PRD 功能条目。
+ *
+ * 映射优先级：
+ * 1. implementedScope.implementedBy 命中按钮的 customAction / actionName / backendMethod。
+ * 2. 按钮 label 与 featureName 精确相等。
+ * 3. featureName 包含 label 或 label 包含 featureName（按 PRD 顺序取第一个）。
+ *
+ * @param button - 按钮元数据。
+ * @param prdFunctions - PRD 提取出的功能条目。
+ * @param implementedScope - code_list 中的实现范围（可选）。
+ * @returns 映射结果；未命中时返回 undefined。
+ */
+export function mapButtonToPrdFunction(button, prdFunctions, implementedScope) {
+    // 1. Primary：implementedScope
+    if (implementedScope && implementedScope.length > 0) {
+        const actionKeys = collectButtonActionKeys(button);
+        for (const scope of implementedScope) {
+            for (const implementedBy of scope.implementedBy) {
+                const segments = implementedBy.split('.').map((s) => s.trim());
+                for (const segment of segments) {
+                    if (segment && actionKeys.includes(segment)) {
+                        return {
+                            featureId: scope.featureId,
+                            featureName: scope.featureName,
+                            matchedBy: 'implementedScope',
+                        };
+                    }
+                }
+            }
+        }
+    }
+    // 2. Fallback：label 匹配
+    return mapByLabel(button.label, prdFunctions);
+}
+/**
+ * 收集可用于匹配 implementedScope 的按钮动作键。
+ */
+function collectButtonActionKeys(button) {
+    const keys = new Set();
+    if (button.customAction)
+        keys.add(button.customAction);
+    if (button.actionName)
+        keys.add(button.actionName);
+    if (button.backendMethod)
+        keys.add(button.backendMethod);
+    return Array.from(keys).filter(Boolean);
+}
+/**
+ * 按 label↔featureName 匹配。
+ */
+function mapByLabel(label, prdFunctions) {
+    const normalizedLabel = label.trim();
+    // 精确匹配
+    const exact = prdFunctions.find((f) => f.featureName.trim() === normalizedLabel);
+    if (exact) {
+        return { featureId: exact.featureId, featureName: exact.featureName, matchedBy: 'label-exact' };
+    }
+    // 包含匹配：featureName 包含 label
+    const contains = prdFunctions.find((f) => f.featureName.includes(normalizedLabel));
+    if (contains) {
+        return { featureId: contains.featureId, featureName: contains.featureName, matchedBy: 'label-contains' };
+    }
+    // 包含匹配：label 包含 featureName
+    const containedBy = prdFunctions.find((f) => normalizedLabel.includes(f.featureName));
+    if (containedBy) {
+        return {
+            featureId: containedBy.featureId,
+            featureName: containedBy.featureName,
+            matchedBy: 'label-contains',
+        };
+    }
+    return undefined;
+}
+/**
+ * 根据 PRD 功能条目渲染 businessIntent。
+ */
+export function renderPrdBusinessIntent(entry, label) {
+    const description = entry.description?.trim();
+    if (description) {
+        return `覆盖列表页「${label}」按钮的控件功能：${description}`;
+    }
+    return `覆盖列表页「${label}」按钮的控件功能（featureId=${entry.featureId}）。`;
+}
+/**
+ * 根据 PRD 功能条目渲染执行步骤。
+ *
+ * 优先使用 entry.processingLogic；若为空则使用 entry.inputConditions。
+ */
+export function renderPrdSteps(entry, label) {
+    const steps = [];
+    steps.push(`1. 在目标页面定位并点击「${label}」按钮。`);
+    const logic = entry.processingLogic.filter(Boolean);
+    if (logic.length > 0) {
+        logic.forEach((item, index) => {
+            steps.push(`${index + 2}. ${item}。`);
+        });
+    }
+    else if (entry.inputConditions) {
+        const input = entry.inputConditions.trim();
+        if (input && input !== '无') {
+            steps.push(`2. 确保满足输入条件：${input}。`);
+        }
+    }
+    steps.push(`${steps.length + 1}. 观察并记录页面反馈。`);
+    return steps.join(' ');
+}
+/**
+ * 根据 PRD 功能条目渲染断言。
+ *
+ * 从 outputResult 中提取成功/失败结果，组合成选择型断言。
+ * 若 outputResult 为空，则使用 businessRules 兜底。
+ */
+export function renderPrdAssertion(entry, label) {
+    const outputs = entry.outputResult.filter(Boolean);
+    if (outputs.length > 0) {
+        // 若 outputResult 有 2 条以上，通常对应成功/失败分支，用「；或」连接。
+        if (outputs.length >= 2) {
+            return `页面出现${outputs[0]}；或出现${outputs[1]}。`;
+        }
+        return `页面出现${outputs[0]}。`;
+    }
+    const rules = entry.businessRules.filter(Boolean);
+    if (rules.length > 0) {
+        return `点击「${label}」按钮后，${rules.join('；')}。`;
+    }
+    return `点击「${label}」按钮后，页面应出现与该功能对应的可见响应（如提示信息、弹窗确认或数据刷新）。`;
+}
+/**
+ * 获取 PRD 功能条目的输出结果文本（用于 trace / 测试断言）。
+ */
+export function getPrdOutputResultText(entry) {
+    return renderPrdAssertion(entry, entry.featureName);
+}

package/dist/src/testcase/runtime-context.d.ts

@@ -0,0 +1,9 @@
+/**
+ * testcase 当前执行所需的运行上下文。
+ */
+export type RuntimeContext = {
+    testProjectDir: string;
+    caseDir: string;
+    specPath: string;
+};
+//# sourceMappingURL=runtime-context.d.ts.map

package/dist/src/testcase/runtime-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-context.d.ts","sourceRoot":"","sources":["../../../src/testcase/runtime-context.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC"}

package/dist/src/testcase/runtime-context.js

@@ -0,0 +1 @@
+export {};

package/dist/src/testcase/test-access.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 开发阶段测试访问配置。
+ */
+export type TestAccessRole = {
+    role: string;
+    username?: string;
+    password?: string;
+    permissions: string[];
+};
+/**
+ * 单个业务系统的测试访问配置。
+ */
+export type TestAccessSystem = {
+    systemName: string;
+    loginUrl?: string;
+    roles: TestAccessRole[];
+};
+/**
+ * testcase / code_list 可复用的测试访问配置。
+ */
+export type TestAccessConfig = {
+    /** 运行访问数据文件引用；新链路默认指向同目录 credentials.json5。 */
+    credentialRef?: string;
+    /** 用例执行所需角色清单，供审阅与运行前门禁使用。 */
+    requiredRoles?: string[];
+    /** 兼容旧链路的内嵌系统账号结构；新链路不作为主路径。 */
+    systems?: TestAccessSystem[];
+};
+/**
+ * 归一化并校验测试访问配置。
+ *
+ * @param raw - 原始输入。
+ * @param fieldPrefix - 顶层字段前缀，用于生成清晰错误信息。
+ * @returns 归一化后的测试访问配置。
+ * @throws Error 结构非法时抛错。
+ */
+export declare function normalizeTestAccessConfig(raw: unknown, fieldPrefix?: string): TestAccessConfig;
+//# sourceMappingURL=test-access.d.ts.map

package/dist/src/testcase/test-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-access.d.ts","sourceRoot":"","sources":["../../../src/testcase/test-access.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,gCAAgC;IAChC,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC9B,CAAC;AAoDF;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,SAAe,GAAG,gBAAgB,CAyDpG"}

package/dist/src/testcase/test-access.js

@@ -0,0 +1,106 @@
+/**
+ * 断言值为非空字符串。
+ *
+ * @param value - 待校验值。
+ * @param field - 错误提示字段名。
+ * @throws Error 字段不是非空字符串时抛错。
+ */
+function requireNonEmptyString(value, field) {
+    if (typeof value !== 'string' || !value) {
+        throw new Error(`${field} 必须为非空字符串`);
+    }
+    return value;
+}
+/**
+ * 断言值若存在则必须为字符串。
+ *
+ * @param value - 待校验值。
+ * @param field - 错误提示字段名。
+ * @returns 合法字符串或 undefined。
+ * @throws Error 字段存在但不是字符串时抛错。
+ */
+function requireOptionalString(value, field) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value !== 'string') {
+        throw new Error(`${field} 必须为字符串`);
+    }
+    return value;
+}
+/**
+ * 断言权限列表为字符串数组；缺省时归一为空数组。
+ *
+ * @param value - 待校验值。
+ * @param field - 错误提示字段名。
+ * @returns 归一化后的权限数组。
+ * @throws Error 字段不是字符串数组时抛错。
+ */
+function normalizePermissions(value, field) {
+    if (value === undefined) {
+        return [];
+    }
+    if (!Array.isArray(value) || value.some((item) => typeof item !== 'string' || !item)) {
+        throw new Error(`${field} 必须为字符串数组`);
+    }
+    return value;
+}
+/**
+ * 归一化并校验测试访问配置。
+ *
+ * @param raw - 原始输入。
+ * @param fieldPrefix - 顶层字段前缀，用于生成清晰错误信息。
+ * @returns 归一化后的测试访问配置。
+ * @throws Error 结构非法时抛错。
+ */
+export function normalizeTestAccessConfig(raw, fieldPrefix = 'testAccess') {
+    if (!raw || typeof raw !== 'object') {
+        throw new Error(`${fieldPrefix} 必须为对象`);
+    }
+    const input = raw;
+    const credentialRef = requireOptionalString(input.credentialRef, `${fieldPrefix}.credentialRef`);
+    const requiredRoles = normalizePermissions(input.requiredRoles, `${fieldPrefix}.requiredRoles`);
+    if (input.systems === undefined) {
+        if (!credentialRef) {
+            throw new Error(`${fieldPrefix}.credentialRef 或 ${fieldPrefix}.systems 必须至少提供一个`);
+        }
+        return {
+            credentialRef,
+            ...(requiredRoles.length > 0 ? { requiredRoles } : {}),
+        };
+    }
+    if (!Array.isArray(input.systems)) {
+        throw new Error(`${fieldPrefix}.systems 必须为数组`);
+    }
+    return {
+        ...(credentialRef ? { credentialRef } : {}),
+        ...(requiredRoles.length > 0 ? { requiredRoles } : {}),
+        systems: input.systems.map((system, systemIndex) => {
+            const systemField = `${fieldPrefix}.systems[${systemIndex}]`;
+            if (!system || typeof system !== 'object') {
+                throw new Error(`${systemField} 必须为对象`);
+            }
+            const rawSystem = system;
+            if (!Array.isArray(rawSystem.roles)) {
+                throw new Error(`${systemField}.roles 必须为数组`);
+            }
+            return {
+                systemName: requireNonEmptyString(rawSystem.systemName, `${systemField}.systemName`),
+                loginUrl: requireOptionalString(rawSystem.loginUrl, `${systemField}.loginUrl`),
+                roles: rawSystem.roles.map((role, roleIndex) => {
+                    const roleField = `${systemField}.roles[${roleIndex}]`;
+                    if (!role || typeof role !== 'object') {
+                        throw new Error(`${roleField} 必须为对象`);
+                    }
+                    const rawRole = role;
+                    return {
+                        role: requireNonEmptyString(rawRole.role, `${roleField}.role`),
+                        username: requireOptionalString(rawRole.username, `${roleField}.username`),
+                        password: requireOptionalString(rawRole.password, `${roleField}.password`),
+                        permissions: normalizePermissions(rawRole.permissions, `${roleField}.permissions`),
+                    };
+                }),
+            };
+        }),
+    };
+}

package/dist/src/testcase/testcase-execution-fields.d.ts

@@ -0,0 +1,10 @@
+/**
+ * testcase 执行阶段补充字段。
+ */
+export type TestcaseExecutionFields = {
+    queryKey?: string;
+    precondition?: string;
+    steps?: string;
+    assertion?: string;
+};
+//# sourceMappingURL=testcase-execution-fields.d.ts.map

package/dist/src/testcase/testcase-execution-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testcase-execution-fields.d.ts","sourceRoot":"","sources":["../../../src/testcase/testcase-execution-fields.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC"}

package/dist/src/testcase/testcase-execution-fields.js

@@ -0,0 +1 @@
+export {};

package/dist/src/testcase/testcase-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testcase-generator.d.ts","sourceRoot":"","sources":["../../../src/testcase/testcase-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EAEb,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAOvF;;;;;;;;;GASG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,kBAAkB,CAAC,EAAE,YAAY,EAAE,CAAC;IACpC,YAAY,EAAE,iBAAiB,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;GAUG;AAKH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,2BAA2B,CA2GpG"}
+{"version":3,"file":"testcase-generator.d.ts","sourceRoot":"","sources":["../../../src/testcase/testcase-generator.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EAEb,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAOvF;;;;;;;;;GASG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,kBAAkB,CAAC,EAAE,YAAY,EAAE,CAAC;IACpC,YAAY,EAAE,iBAAiB,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;GAUG;AAKH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,2BAA2B,CA2GpG"}

package/dist/src/testcase/testcase-generator.js

@@ -1,3 +1,9 @@
+/**
+ * @deprecated 旧 v2 协议 testcase 生成器（generateGlueTestcases）。
+ * 新 glue 链路已改用 `assembleJson5ContractAndTestcase`（见
+ * `src/testcase/contract-testcase-assembler.ts`）；本文件仍被 gap-pipeline
+ * （run-gap-pipeline）使用，故保留，待该子系统迁移后整体清理。
+ */
 import { readFileSync } from 'node:fs';
 import { mapContractToCrudTestcaseSlots, renderGlueTestcaseSkeleton, selectTestcaseSkeletonByScenario, } from './testcase-skeleton.js';
 /**

package/dist/src/testcase/testcase-markdown.d.ts

@@ -0,0 +1,11 @@
+import type { EpStageTestcaseV1Draft } from './testcase-v1-draft.js';
+import type { EpStageContractV1Draft } from '../contracts/glue-contract-v1.js';
+/**
+ * 把 testcase.json5 渲染成统一单表的 testcase.md 审阅视图（含头部槽位映射信息）。
+ *
+ * @param testcase - testcase.json5 事实源。
+ * @param contract - contract.json5 事实源（可选，用于渲染占位符映射表）。
+ * @returns 完整的 Markdown 文本。
+ */
+export declare function renderUnifiedTestcaseMarkdown(testcase: EpStageTestcaseV1Draft, contract?: EpStageContractV1Draft): string;
+//# sourceMappingURL=testcase-markdown.d.ts.map

package/dist/src/testcase/testcase-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testcase-markdown.d.ts","sourceRoot":"","sources":["../../../src/testcase/testcase-markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAkD/E;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,sBAAsB,EAChC,QAAQ,CAAC,EAAE,sBAAsB,GAChC,MAAM,CA2JR"}

package/dist/src/testcase/testcase-markdown.js

@@ -0,0 +1,181 @@
+/**
+ * 把生成策略翻译成审阅表格中的中文文案。
+ *
+ * @param strategy - testcase.json5 中的生成策略。
+ * @returns 中文生成策略标签。
+ */
+function strategyLabel(strategy) {
+    return strategy === 'glue' ? '胶水组装' : 'AI 推理';
+}
+/**
+ * 规整 Markdown 表格单元格，避免空值和换行破坏表格结构。
+ *
+ * @param value - 原始字段值。
+ * @returns 可直接写入 Markdown 表格的文本。
+ */
+function escapeCell(value) {
+    return (value || '待补充').replaceAll('|', '\\|').replace(/\s+/g, ' ').trim();
+}
+/**
+ * 从 locator xpath 表达式中提取按钮文本。
+ *
+ * @param locator - Playwright locator 表达式。
+ * @returns 按钮中文文本或占位符。
+ */
+function extractButtonLabel(locator) {
+    if (!locator)
+        return '待运行态确认';
+    // xpath=//a[contains(@class,'mini-button')][normalize-space()='新增场所信息管理']
+    const normalizeSpaceMatch = locator.match(/normalize-space\(\)='([^']+)'/);
+    if (normalizeSpaceMatch)
+        return normalizeSpaceMatch[1];
+    // xpath=//span[text()='搜索']
+    const textMatch = locator.match(/text\(\)='([^']+)'/);
+    if (textMatch)
+        return textMatch[1];
+    // text=确定
+    const simpleTextMatch = locator.match(/^text=(.+)$/);
+    if (simpleTextMatch)
+        return simpleTextMatch[1];
+    // xpath=//*[@data-tooltip='修改']
+    const tooltipMatch = locator.match(/@data-tooltip='([^']+)'/);
+    if (tooltipMatch)
+        return tooltipMatch[1];
+    return '待运行态确认';
+}
+/**
+ * 把 testcase.json5 渲染成统一单表的 testcase.md 审阅视图（含头部槽位映射信息）。
+ *
+ * @param testcase - testcase.json5 事实源。
+ * @param contract - contract.json5 事实源（可选，用于渲染占位符映射表）。
+ * @returns 完整的 Markdown 文本。
+ */
+export function renderUnifiedTestcaseMarkdown(testcase, contract) {
+    const rows = [];
+    // 标题
+    rows.push(`# ${testcase.moduleName} 胶水测试用例`);
+    rows.push('');
+    rows.push('用例文件事实源：testcase.json5');
+    rows.push('');
+    // 环境信息（从 contract 和 testcase 提取）
+    if (contract) {
+        rows.push('## 环境信息');
+        rows.push('');
+        rows.push(`- **直达链接**：${contract.base.navigation.directUrl || '待补充'}`);
+        rows.push(`- **凭据文件**：${testcase.testAccess?.credentialRef || 'credentials.json5'}（含登录地址、账号、密码）`);
+        const roles = testcase.testAccess?.requiredRoles || [];
+        if (roles.length > 0) {
+            rows.push(`- **测试角色**：${roles.join('、')}`);
+        }
+        const crud = contract.scenario.skeletonSlots?.crud;
+        const frames = crud?.frames;
+        if (frames?.listIframeSrcKeyword) {
+            rows.push(`- **列表页关键字**：${frames.listIframeSrcKeyword}`);
+        }
+        rows.push('');
+    }
+    // 查询字段清单（从 testcase cases 和 contract searchConditions 提取）
+    if (contract) {
+        rows.push('## 查询字段');
+        rows.push('');
+        const queryKeys = [...new Set(testcase.cases.map((c) => c.queryKey).filter(Boolean))];
+        const crud = contract.scenario.skeletonSlots?.crud;
+        const searchConditions = (crud?.searchConditions || []);
+        queryKeys.forEach((key, idx) => {
+            const condition = searchConditions.find((c) => c.label === key);
+            const component = condition?.component || 'unknown';
+            rows.push(`${idx + 1}. ${key}（${component}）`);
+        });
+        rows.push('');
+    }
+    // 动作关联按钮（占位符映射表）
+    if (contract) {
+        rows.push('## 动作关联按钮（占位符映射表）');
+        rows.push('');
+        rows.push('### Glue 胶水组装命中的按钮');
+        rows.push('');
+        const crud = contract.scenario.skeletonSlots?.crud;
+        const locators = (crud?.locators || {});
+        rows.push(`- \`{{新增按钮}}\` = "${extractButtonLabel(locators.createButton)}"`);
+        rows.push(`- \`{{删除按钮}}\` = "${extractButtonLabel(locators.listDeleteButton)}"`);
+        rows.push(`- \`{{保存按钮}}\` = "${extractButtonLabel(locators.addSaveButton)}"`);
+        rows.push(`- \`{{查询按钮}}\` = "${extractButtonLabel(locators.listSearchSubmit)}"`);
+        rows.push(`- \`{{修改按钮}}\` = "${extractButtonLabel(locators.listEditActionLocatorTemplate)}"`);
+        rows.push(`- \`{{确认按钮}}\` = "${extractButtonLabel(locators.deleteConfirmButton)}"`);
+        // 导出按钮（从 export slots 或 gapCandidates 提取）
+        const exportSlots = contract.scenario.skeletonSlots?.export;
+        if (exportSlots) {
+            rows.push(`- \`{{导出按钮}}\` = "${exportSlots.label || '导出'}"`);
+            rows.push(`- \`{{导出确认按钮}}\` = "导出"（弹窗内确认按钮）`);
+        }
+        const frames = crud?.frames;
+        const listKeyword = frames?.listIframeSrcKeyword || '待补充';
+        rows.push(`- \`{{列表页}}\` = 返回列表页（iframe: ${listKeyword}）`);
+        rows.push('');
+        // AI 推理候选按钮
+        const aiCandidates = testcase.uncoveredCandidates.filter((c) => c.generationStrategy === 'ai' && c.coverageStatus !== 'blocked');
+        if (aiCandidates.length > 0) {
+            rows.push('### AI 推理候选按钮');
+            rows.push('');
+            aiCandidates.forEach((c) => {
+                rows.push(`- ${c.label}`);
+            });
+            rows.push('');
+        }
+        // Blocked 候选（PRD 提到但未实现）
+        const blockedCandidates = testcase.uncoveredCandidates.filter((c) => c.coverageStatus === 'blocked');
+        if (blockedCandidates.length > 0) {
+            rows.push('### 已阻断候选（PRD 提到但未实现）');
+            rows.push('');
+            blockedCandidates.forEach((c) => {
+                rows.push(`- ${c.label}`);
+            });
+            rows.push('');
+        }
+    }
+    // 用例清单表格
+    rows.push('## 用例清单');
+    rows.push('');
+    rows.push('| 用例 ID | 生成策略 | 用例标题 | 查询主键 | 前置条件 | 执行步骤 | 执行断言 |');
+    rows.push('|---|---|---|---|---|---|---|');
+    for (const item of testcase.cases) {
+        rows.push([
+            item.caseId,
+            strategyLabel(item.generationStrategy),
+            item.title,
+            item.queryKey,
+            item.precondition,
+            item.steps,
+            item.assertion,
+        ]
+            .map(escapeCell)
+            .join(' | ')
+            .replace(/^/, '| ')
+            .replace(/$/, ' |'));
+    }
+    for (const item of testcase.uncoveredCandidates) {
+        rows.push([
+            item.caseId,
+            strategyLabel(item.generationStrategy),
+            item.label,
+            item.queryKey,
+            item.precondition,
+            item.steps,
+            item.assertion,
+        ]
+            .map(escapeCell)
+            .join(' | ')
+            .replace(/^/, '| ')
+            .replace(/$/, ' |'));
+    }
+    rows.push('');
+    // 审阅引导
+    rows.push('## 审阅引导');
+    rows.push('');
+    rows.push('1. **占位符含义**：表格中 `{{xxx}}` 占位符的实际值见上方"动作关联按钮"映射表。');
+    rows.push('2. **调整方式**：需修改时请告知要改哪条用例，由 Agent 更新 testcase.json5 后重新渲染。');
+    rows.push('3. **凭据信息**：登录账号密码存储在 credentials.json5，不显示在本审阅视图。');
+    rows.push('4. **证据追溯**：具体定位器表达式、iframe 关键字、业务规则详见 contract.json5。');
+    rows.push('5. **Blocked 候选**：标记为 blocked 的用例不会生成 spec 代码，仅记录在 trace 中供人工确认。');
+    return `${rows.join('\n')}\n`;
+}

package/dist/src/testcase/testcase-skeleton.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @deprecated 旧 v2 协议 testcase skeleton 渲染（mapContractToCrudTestcaseSlots 等）。
+ * 新 glue 链路不引用；仅被旧 testcase-generator（gap-pipeline 子系统）使用，故保留。
+ */
 import type { CrudBusinessModuleContract } from '../contracts/crud-business-module.js';
 import type { PageScenario } from '../contracts/observable-chain.js';
 /**

package/dist/src/testcase/testcase-skeleton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testcase-skeleton.d.ts","sourceRoot":"","sources":["../../../src/testcase/testcase-skeleton.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAOrE;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,UAAU,EAAE,2BAA2B,CAAC;IACxC,YAAY,EAAE,2BAA2B,CAAC;IAC1C,QAAQ,EAAE,kBAAkB,GAAG,aAAa,CAAC;CAC9C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,0BAA0B,CAAC,iBAAiB,CAAC,CAAC;IAC/D,QAAQ,EAAE,YAAY,CAAC;IACvB,YAAY,EAAE,WAAW,GAAG,cAAc,CAAC;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,mCAAmC,GAAG;IAChD,QAAQ,EAAE,0BAA0B,CAAC;IACrC,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,YAAY,GAAG,yBAAyB,CAUlG;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,mCAAmC,GAAG,iBAAiB,CA4E5G;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAS7F"}
+{"version":3,"file":"testcase-skeleton.d.ts","sourceRoot":"","sources":["../../../src/testcase/testcase-skeleton.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAOrE;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,UAAU,EAAE,2BAA2B,CAAC;IACxC,YAAY,EAAE,2BAA2B,CAAC;IAC1C,QAAQ,EAAE,kBAAkB,GAAG,aAAa,CAAC;CAC9C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,0BAA0B,CAAC,iBAAiB,CAAC,CAAC;IAC/D,QAAQ,EAAE,YAAY,CAAC;IACvB,YAAY,EAAE,WAAW,GAAG,cAAc,CAAC;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,mCAAmC,GAAG;IAChD,QAAQ,EAAE,0BAA0B,CAAC;IACrC,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,YAAY,GAAG,yBAAyB,CAUlG;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,mCAAmC,GAAG,iBAAiB,CA4E5G;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAS7F"}

package/dist/src/testcase/testcase-spec-assembly.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @deprecated 旧 v2 协议 testcase → spec 装配（validateGlueTestcaseDocumentForSpecAssembly）。
+ * 新 glue 链路不引用；保留作历史参考与 gap-pipeline 兼容。
+ */
 import type { CrudBusinessModuleContract } from '../contracts/crud-business-module.js';
 import type { GlueTestcaseDocument } from '../contracts/observable-chain.js';
 /**

package/dist/src/testcase/testcase-spec-assembly.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testcase-spec-assembly.d.ts","sourceRoot":"","sources":["../../../src/testcase/testcase-spec-assembly.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAI7E;;;;;;GAMG;AACH,wBAAgB,2CAA2C,CACzD,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,EAAE,0BAA0B,GACnC,IAAI,CAkBN"}
+{"version":3,"file":"testcase-spec-assembly.d.ts","sourceRoot":"","sources":["../../../src/testcase/testcase-spec-assembly.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAI7E;;;;;;GAMG;AACH,wBAAgB,2CAA2C,CACzD,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,EAAE,0BAA0B,GACnC,IAAI,CAkBN"}