@epoint-testtech/ep-stage-skill 0.0.3-alpha.1

package/dist/src/generators/agent-inferred-workflow-script.js

@@ -0,0 +1,230 @@
+/**
+ * Agent 推理 Custom workflow 测试片段生成器。
+ *
+ * 渲染 executionSource='agent_inferred' 的 Playwright test 片段，
+ * 并提供幂等追加函数，避免重复追加到同一 spec。
+ */
+function singleQuoted(value) {
+    return `'${value.replaceAll('\\', '\\\\').replaceAll("'", "\\'")}'`;
+}
+function locatorLiteral(value) {
+    return JSON.stringify(value);
+}
+function arrayLiteral(values) {
+    return `[${values.map(singleQuoted).join(', ')}]`;
+}
+function evidenceSourceByKind(kind) {
+    if (kind.startsWith('html_') || kind === 'grid_row_action') {
+        return 'upstream_html';
+    }
+    if (kind.startsWith('java_')) {
+        return 'upstream_java_action';
+    }
+    if (kind === 'test_policy_hint') {
+        return 'module_hints';
+    }
+    return 'agent_reasoning';
+}
+/**
+ * 将 EvidenceRef.kind 映射为 GlueEvidenceSource 值。
+ * 确保所有映射结果都在 GlueEvidenceSource 值域内。
+ */
+function evidenceSources(workflow) {
+    const mapped = workflow.evidence.map((item) => evidenceSourceByKind(item.kind));
+    if (workflow.resolvedRuntime?.locator || workflow.resolvedRuntime?.pageSnapshotPath) {
+        mapped.push('runtime_page');
+    }
+    return Array.from(new Set([...mapped, 'agent_reasoning']));
+}
+function renderEvidenceRefs(workflow) {
+    const rendered = workflow.evidence.map((item) => {
+        const properties = [
+            `source: ${singleQuoted(evidenceSourceByKind(item.kind))}`,
+            `file: ${singleQuoted(item.path)}`,
+            item.locator ? `selector: ${singleQuoted(item.locator)}` : undefined,
+            item.evidenceText ? `text: ${singleQuoted(item.evidenceText)}` : undefined,
+            `note: ${singleQuoted(`上游证据 ${item.kind}${item.evidenceText ? `：${item.evidenceText}` : ''}`)}`,
+        ].filter((value) => Boolean(value));
+        return `          { ${properties.join(', ')} }`;
+    });
+    if (workflow.resolvedRuntime?.locator || workflow.resolvedRuntime?.pageSnapshotPath) {
+        rendered.push(`          { source: 'runtime_page', note: 'gap-executor 在真实页面确认按钮可见并完成定位收敛' }`);
+        if (workflow.resolvedRuntime.iframeSrcKeyword) {
+            rendered.push(`          { source: 'runtime_page', selector: ${singleQuoted(`iframe[src*="${workflow.resolvedRuntime.iframeSrcKeyword}"]`)}, note: 'gap-executor 确认该动作位于业务 iframe 内' }`);
+        }
+        if (workflow.resolvedRuntime.exploration?.networkResponses?.length) {
+            const networkSummary = workflow.resolvedRuntime.exploration.networkResponses.slice(0, 3).join(' | ');
+            rendered.push(`          { source: 'runtime_page', note: ${singleQuoted(`运行态观察到网络响应：${networkSummary}`)} }`);
+        }
+    }
+    rendered.push(`          { source: 'agent_reasoning', note: 'gap-executor 在真实页面确认按钮可见并可点击' }`);
+    return `[\n${rendered.join(',\n')}\n        ]`;
+}
+function variableName(label) {
+    return `repoBtn${label.replace(/[^\p{L}\p{N}]/gu, '')}`;
+}
+function frameVariableName(label) {
+    return `repoIFrame${label.replace(/[^\p{L}\p{N}]/gu, '')}`;
+}
+function confirmButtonVariableName(label) {
+    return `repoBtn${label.replace(/[^\p{L}\p{N}]/gu, '')}确认`;
+}
+function feedbackVariableName(label) {
+    return `repoMsgBox${label.replace(/[^\p{L}\p{N}]/gu, '')}反馈`;
+}
+function actualFeedbackVariableName(label) {
+    return `实际${label.replace(/[^\p{L}\p{N}]/gu, '')}反馈文案`;
+}
+function resolvedLocator(workflow) {
+    const locator = workflow.resolvedRuntime?.locator ?? workflow.actionCandidates[0]?.locator;
+    if (!locator) {
+        throw new Error(`workflow ${workflow.workflowId} 缺少 resolved locator，不能生成 Custom test`);
+    }
+    return locator;
+}
+function assertRenderableWorkflow(workflow) {
+    if (workflow.status !== 'planned' && workflow.status !== 'resolved') {
+        throw new Error(`workflow ${workflow.workflowId} 状态为 ${workflow.status}，不能生成 Custom test`);
+    }
+    if (workflow.businessIntent.status !== 'resolved') {
+        throw new Error(`workflow ${workflow.workflowId} 缺少 resolved businessIntent`);
+    }
+    if (workflow.elementActions.status !== 'resolved') {
+        throw new Error(`workflow ${workflow.workflowId} 缺少 resolved elementActions`);
+    }
+    if (workflow.assertionExpectation.status !== 'resolved') {
+        throw new Error(`workflow ${workflow.workflowId} 缺少 resolved assertionExpectation`);
+    }
+}
+function renderGapFindingBlock(workflow, label, assertion) {
+    const observed = workflow.resolvedRuntime?.exploration?.observedMessage?.replace(/\s+/g, ' ').trim();
+    if (!observed || observed.includes(assertion)) {
+        return '';
+    }
+    const kind = /暂未实现|未实现|未配置|联系管理员/.test(observed)
+        ? 'feature_incomplete'
+        : 'behavior_mismatch';
+    return `
+        gapFinding: {
+          kind: ${singleQuoted(kind)},
+          summary: ${singleQuoted(`运行态推理发现「${label}」未满足业务预期。`)},
+          observed: ${singleQuoted(observed)},
+        },`;
+}
+function renderRuntimeAwareAssertionBlock(input) {
+    const exploration = input.workflow.resolvedRuntime?.exploration;
+    if (!exploration) {
+        return `
+        await expect(${input.repoVariable}).toBeVisible();
+        await ${input.repoVariable}.click();
+
+        await expect(page.getByText(${singleQuoted(input.assertion)})).toBeVisible({ timeout: 30000 });`;
+    }
+    const confirmVariable = confirmButtonVariableName(input.label);
+    const feedbackVariable = feedbackVariableName(input.label);
+    const actualVariable = actualFeedbackVariableName(input.label);
+    const runtimeObserved = exploration.observedMessage?.replace(/\s+/g, ' ').trim() ?? '';
+    const confirmBlock = exploration.confirmDialogPresent
+        ? `
+
+        const ${confirmVariable} = ${input.locatorOwner}
+          .locator("xpath=//*[contains(@class,'mini-messagebox')]//a[normalize-space()='确定' or normalize-space()='确认']")
+          .first();
+        await expect(${confirmVariable}).toBeVisible({ timeout: 15000 });
+        await ${confirmVariable}.click();`
+        : '';
+    return `
+        await expect(${input.repoVariable}).toBeVisible();
+        await ${input.repoVariable}.click();${confirmBlock}
+
+        const runtimeObserved反馈文案 = ${singleQuoted(runtimeObserved)};
+        const ${feedbackVariable} = ${input.locatorOwner}.locator("xpath=//*[contains(@class,'mini-messagebox') or contains(@class,'mini-tips')]");
+        await page.waitForTimeout(1000);
+        const 反馈文本列表 = (await ${feedbackVariable}.allInnerTexts())
+          .map((text) => text.replace(/\\s+/g, ' ').trim())
+          .filter(Boolean);
+        const ${actualVariable} =
+          反馈文本列表.find((text) => runtimeObserved反馈文案 && text.includes(runtimeObserved反馈文案)) ??
+          反馈文本列表.find((text) => text.includes(${singleQuoted(input.assertion)})) ??
+          runtimeObserved反馈文案 ??
+          反馈文本列表.sort((a, b) => b.length - a.length)[0] ??
+          '';
+        expect(
+          ${actualVariable}.includes(${singleQuoted(input.assertion)}),
+          ${singleQuoted(`${input.label}未达成业务预期：期望出现「${input.assertion}」，系统实际反馈「`)} + ${actualVariable} + '」',
+        ).toBe(true);`;
+}
+export function renderAgentWorkflowTest(options) {
+    const { workflow } = options;
+    assertRenderableWorkflow(workflow);
+    const title = workflow.resolvedRuntime?.playwrightTestTitle ?? `Custom：${workflow.actionCandidates[0]?.label ?? workflow.workflowId}`;
+    const label = workflow.actionCandidates[0]?.label ?? workflow.workflowId;
+    const locator = resolvedLocator(workflow);
+    const repoVariable = variableName(label);
+    const frameVariable = frameVariableName(label);
+    const intent = workflow.businessIntent.value;
+    const actions = workflow.elementActions.value;
+    const assertion = workflow.assertionExpectation.value;
+    const iframeSrcKeyword = workflow.resolvedRuntime?.iframeSrcKeyword;
+    const locatorOwner = iframeSrcKeyword ? frameVariable : 'page';
+    const gapFindingBlock = renderGapFindingBlock(workflow, label, assertion);
+    const assertionBlock = renderRuntimeAwareAssertionBlock({
+        label,
+        locatorOwner,
+        repoVariable,
+        assertion,
+        workflow,
+    });
+    const iframeSetup = iframeSrcKeyword
+        ? `
+        const ${frameVariable} = page.locator(${singleQuoted(`iframe[src*="${iframeSrcKeyword}"]`)}).contentFrame();
+`
+        : '';
+    return `
+  test(${singleQuoted(title)}, async ({ page }) => {
+    test.slow();
+
+    await runRecordedWorkflow(
+      recorder,
+      {
+        moduleId: ${singleQuoted(options.moduleId)},
+        workflowId: ${singleQuoted(workflow.workflowId)},
+        workflowKind: 'custom',
+        workflowName: ${singleQuoted(label)},
+        executionSource: 'agent_inferred',
+        businessIntent: ${singleQuoted(intent)},
+        elementActions: ${arrayLiteral(actions)},
+        assertionExpectation: ${singleQuoted(assertion)},
+        evidenceSources: ${arrayLiteral(evidenceSources(workflow))},
+        evidenceRefs: ${renderEvidenceRefs(workflow)},
+        reviewReason: ${singleQuoted(workflow.reviewReason ?? '该工作流由 gap-planner 识别为自定义业务动作。')},
+        playwrightSuiteTitle: ${singleQuoted(options.suiteTitle)},
+        playwrightTestTitle: ${singleQuoted(title)},
+${gapFindingBlock}
+      },
+      async () => {
+        await openModule(page);
+${iframeSetup}
+        const ${repoVariable} = ${locatorOwner}.locator(${locatorLiteral(locator)});
+${assertionBlock}
+      },
+    );
+  });
+`;
+}
+export function appendAgentWorkflowTest(options) {
+    if (options.source.includes(options.workflowId) || options.source.includes(`test('${options.testTitle}'`)) {
+        return options.source;
+    }
+    const marker = '  // @stage-gap-append';
+    const markerIndex = options.source.indexOf(marker);
+    if (markerIndex !== -1) {
+        return `${options.source.slice(0, markerIndex)}${options.testSource}\n${options.source.slice(markerIndex)}`;
+    }
+    const closingMarker = '\n});\n';
+    const index = options.source.lastIndexOf(closingMarker);
+    if (index === -1) {
+        throw new Error('目标 spec 文件未找到 gap 追加标记或 test.describe 结束标记');
+    }
+    return `${options.source.slice(0, index)}${options.testSource}${options.source.slice(index)}`;
+}

package/dist/src/generators/stage-skeleton-script.d.ts

@@ -0,0 +1,107 @@
+/**
+ * stage-skeleton CRUD 骨架脚本生成器。
+ *
+ * 核心职责：
+ * - 将 crud-business-module/v1 契约映射为胶水模板骨架使用的 CrudFlowSlots
+ * - 生成调用 LoginPage、MenuPage、CrudPage 的 Playwright 测试文件
+ * - 避免直接拼接 page.fill/page.click，保证测试流程复用骨架层
+ */
+import type { CrudBusinessModuleContract } from '../contracts/crud-business-module.js';
+export type StageSkeletonCrudDeletePolicy = 'success_delete' | 'blocked_by_business_rule';
+export type StageSkeletonCrudDataValueStrategy = 'timestamp_prefix' | 'fixed_value';
+export type StageSkeletonCrudListboxSelectionSlot = {
+    field: string;
+    label: string;
+    value: string;
+};
+export type StageSkeletonCrudInputSearchConditionSlot = {
+    component: 'input';
+    field: string;
+    label: string;
+    seedValue: string;
+    strategy?: StageSkeletonCrudDataValueStrategy;
+    fixedValue?: string;
+    updatePrefix?: string;
+    addLocator: string;
+    editLocator: string;
+    listLocator: string;
+    searchSeedValue?: string;
+};
+export type StageSkeletonCrudListboxSearchConditionSlot = {
+    component: 'listbox';
+    field: string;
+    label: string;
+    value: string;
+    createSelections?: StageSkeletonCrudListboxSelectionSlot[];
+};
+export type StageSkeletonCrudSearchConditionSlot = StageSkeletonCrudInputSearchConditionSlot | StageSkeletonCrudListboxSearchConditionSlot;
+/**
+ * stage-skeleton CRUD 骨架槽位。
+ *
+ * 该类型与 `packages/stage-create/templates/glue/src/skeletons/crud.skeleton.ts`
+ * 中的 CrudFlowSlots 保持结构一致。
+ */
+export type StageSkeletonCrudFlowSlots = {
+    moduleId: string;
+    searchConditions: StageSkeletonCrudSearchConditionSlot[];
+    frames: {
+        listIframeSrcKeyword: string;
+        addIframeSrcKeyword: string;
+        editIframeSrcKeyword: string;
+    };
+    locators: {
+        createButton: string;
+        addAutofillTrigger?: string;
+        addSaveButton: string;
+        listSearchSubmit: string;
+        listResultValueLocatorTemplate: string;
+        listEditActionLocatorTemplate: string;
+        editSaveButton: string;
+        listRowSelectLocatorTemplate: string;
+        listDeleteButton: string;
+        deleteConfirmButton?: string;
+    };
+    assertions: {
+        deletePolicy: StageSkeletonCrudDeletePolicy;
+        blockedDeleteMessage?: string;
+    };
+};
+/**
+ * 生成 stage-skeleton 测试脚本的输入参数。
+ *
+ * @property contract CRUD 业务模块契约
+ * @property menuNavigation 菜单路径，传给 MenuPage.navigateToMenu
+ * @property testName 生成的测试用例名称
+ */
+export type StageSkeletonScriptOptions = {
+    contract: CrudBusinessModuleContract;
+    menuNavigation: string;
+    testName?: string;
+};
+/**
+ * 将 CRUD 业务模块契约映射为 stage-skeleton 的 CrudFlowSlots。
+ *
+ * @param contract CRUD 业务模块契约
+ * @returns 可传给 CrudPage 的槽位对象
+ * @throws 当关键页面、字段或策略缺失时抛出异常
+ */
+export declare function mapContractToStageSkeletonCrudSlots(contract: CrudBusinessModuleContract): StageSkeletonCrudFlowSlots;
+/**
+ * 将 CrudFlowSlots 渲染为 TypeScript 对象字面量。
+ *
+ * @param slots CRUD 骨架槽位
+ * @returns TypeScript 对象源码
+ */
+export declare function renderStageSkeletonCrudSlots(slots: StageSkeletonCrudFlowSlots): string;
+/**
+ * 生成动作级 CRUD + Export Playwright 测试脚本。
+ *
+ * 每个标准工作流（Create / Read / Update / Delete / Export）独立输出为
+ * 一个 test case，使用 GlueWorkflowRecorder 记录执行报告。
+ * 末尾保留 `// @stage-gap-append` 标记供 gap Custom test 追加。
+ *
+ * @param options 生成参数
+ * @returns 完整的 `.spec.ts` 源码
+ */
+export declare function generateStageSkeletonCrudSpec(options: StageSkeletonScriptOptions): string;
+//# sourceMappingURL=stage-skeleton-script.d.ts.map

package/dist/src/generators/stage-skeleton-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-skeleton-script.d.ts","sourceRoot":"","sources":["../../../src/generators/stage-skeleton-script.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAiF,MAAM,sCAAsC,CAAC;AAEtK,MAAM,MAAM,6BAA6B,GAAG,gBAAgB,GAAG,0BAA0B,CAAC;AAC1F,MAAM,MAAM,kCAAkC,GAAG,kBAAkB,GAAG,aAAa,CAAC;AAEpF,MAAM,MAAM,qCAAqC,GAAG;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,yCAAyC,GAAG;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,kCAAkC,CAAC;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,2CAA2C,GAAG;IACxD,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,qCAAqC,EAAE,CAAC;CAC5D,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAC5C,yCAAyC,GACzC,2CAA2C,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,oCAAoC,EAAE,CAAC;IACzD,MAAM,EAAE;QACN,oBAAoB,EAAE,MAAM,CAAC;QAC7B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,QAAQ,EAAE;QACR,YAAY,EAAE,MAAM,CAAC;QACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,8BAA8B,EAAE,MAAM,CAAC;QACvC,6BAA6B,EAAE,MAAM,CAAC;QACtC,cAAc,EAAE,MAAM,CAAC;QACvB,4BAA4B,EAAE,MAAM,CAAC;QACrC,gBAAgB,EAAE,MAAM,CAAC;QACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,UAAU,EAAE;QACV,YAAY,EAAE,6BAA6B,CAAC;QAC5C,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;CACH,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AA+QF;;;;;;GAMG;AACH,wBAAgB,mCAAmC,CAAC,QAAQ,EAAE,0BAA0B,GAAG,0BAA0B,CA0CpH;AA6DD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,0BAA0B,GAAG,MAAM,CAwBtF;AAwBD;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,0BAA0B,GAAG,MAAM,CAoMzF"}