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

package/dist/src/inference/source-analysis.js

@@ -0,0 +1,258 @@
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+/**
+ * 判断 docsDir 下是否存在 PRD markdown 文件。
+ *
+ * PRD 判定规则（满足任一）：
+ * - 文件名包含 `prd`（大小写不敏感）。
+ * - 文件正文包含 `## 4. 功能需求` 标题。
+ *
+ * @param docsDir - 需求文档目录。
+ * @returns PRD 文件绝对路径；不存在时返回 undefined。
+ */
+function findPrdMarkdown(docsDir) {
+    if (!existsSync(docsDir)) {
+        return undefined;
+    }
+    const candidates = readdirSync(docsDir).filter((file) => file.endsWith('.md'));
+    for (const file of candidates) {
+        const fullPath = path.join(docsDir, file);
+        if (/prd/i.test(file)) {
+            return fullPath;
+        }
+    }
+    // 文件名不含 prd 时回落到正文匹配。
+    for (const file of candidates) {
+        const fullPath = path.join(docsDir, file);
+        const content = readFileSync(fullPath, 'utf8');
+        if (/##\s*4\.\s*功能需求/.test(content)) {
+            return fullPath;
+        }
+    }
+    return undefined;
+}
+/**
+ * 判断 docsDir 或 code_list 物料引用中是否存在 spec.yaml。
+ *
+ * @param codeList - code_list 摘要。
+ * @param docsDir - 需求文档目录。
+ * @returns spec.yaml 绝对路径；不存在时返回 undefined。
+ */
+function findSpecYaml(codeList, docsDir) {
+    const fromRefs = codeList.materialRefs.find((ref) => ref.kind === 'spec' && ref.exists);
+    if (fromRefs) {
+        return fromRefs.path;
+    }
+    if (existsSync(docsDir)) {
+        const direct = readdirSync(docsDir).find((file) => file.endsWith('spec.yaml'));
+        if (direct) {
+            return path.join(docsDir, direct);
+        }
+    }
+    return undefined;
+}
+/**
+ * 把 HTML 页面字段登记为 UI 信号。
+ *
+ * @param pages - 已抽取的 HTML 页面列表。
+ * @returns UI 信号数组（字段、按钮、表格列、弹窗）。
+ */
+function collectUiSignals(pages) {
+    const signals = [];
+    for (const page of pages) {
+        for (const field of page.fields) {
+            signals.push({
+                pageId: page.pageId,
+                kind: 'field',
+                label: field.label,
+                value: field.name
+            });
+        }
+        for (const button of page.buttons) {
+            signals.push({
+                pageId: page.pageId,
+                kind: 'button',
+                label: button.label
+            });
+        }
+        for (const grid of page.grids) {
+            for (const column of grid.dataColumns) {
+                signals.push({
+                    pageId: page.pageId,
+                    kind: 'gridColumn',
+                    label: column.headerText || column.field,
+                    value: column.field
+                });
+            }
+        }
+        for (const dialog of page.dialogs) {
+            signals.push({
+                pageId: page.pageId,
+                kind: 'dialog',
+                label: dialog.title,
+                value: dialog.pagePath
+            });
+        }
+    }
+    return signals;
+}
+/**
+ * 把 Java Action 登记为后端信号。
+ *
+ * @param actions - 已抽取的 Java Action 列表。
+ * @returns 后端信号数组（方法名、callback 消息）。
+ */
+function collectBackendSignals(actions) {
+    const signals = [];
+    for (const action of actions) {
+        for (const method of action.methods) {
+            signals.push({
+                controllerName: action.controllerName,
+                kind: 'method',
+                value: method
+            });
+        }
+        for (const message of action.messages) {
+            signals.push({
+                controllerName: action.controllerName,
+                kind: 'callbackMessage',
+                value: message
+            });
+        }
+    }
+    return signals;
+}
+/**
+ * 跨页面汇总字段名候选（去重）。
+ *
+ * @param pages - 已抽取的 HTML 页面列表。
+ * @returns 去重后的字段名数组。
+ */
+function collectFieldNames(pages) {
+    const names = new Set();
+    for (const page of pages) {
+        for (const field of page.fields) {
+            if (field.name) {
+                names.add(field.name);
+            }
+        }
+        for (const grid of page.grids) {
+            for (const column of grid.dataColumns) {
+                if (column.field) {
+                    names.add(column.field);
+                }
+            }
+        }
+    }
+    return Array.from(names);
+}
+/**
+ * 从 Java callback 消息中提取业务规则线索。
+ *
+ * @param actions - 已抽取的 Java Action 列表。
+ * @returns 业务规则描述数组。
+ */
+function collectBusinessRules(actions) {
+    const rules = [];
+    for (const action of actions) {
+        for (const message of action.messages) {
+            if (/不可删除|不允许删除|禁止删除/.test(message)) {
+                rules.push(`删除受业务规则限制：${message}`);
+            }
+        }
+    }
+    return Array.from(new Set(rules));
+}
+/**
+ * 构建 sourceAnalysis 章节。
+ *
+ * 实现规则：
+ * - docsDir 下存在 PRD markdown（文件名含 prd 或正文含 `## 4. 功能需求`）时登记 prd_markdown source。
+ * - HTML 页面登记为 uiSignals（字段、按钮、表格列、弹窗）。
+ * - Java Action 登记为 backendSignals（方法名、callback 消息）。
+ * - 无 spec.yaml 时 mode='prd+html+java'；有 spec.yaml 时 mode='extracted'。
+ *
+ * @param input - 输入参数（codeListPath、docsDir、codeList、pages、actions）。
+ * @returns 源分析快照。
+ */
+export function buildSourceAnalysis(input) {
+    const sources = [];
+    const unresolved = [];
+    const prdPath = findPrdMarkdown(input.docsDir);
+    if (prdPath) {
+        sources.push({
+            kind: 'prd_markdown',
+            path: prdPath,
+            provides: ['businessRules', 'featureList', 'fieldDescriptions']
+        });
+    }
+    else {
+        unresolved.push('docsDir 下未找到 PRD markdown');
+    }
+    const specYamlPath = findSpecYaml(input.codeList, input.docsDir);
+    if (specYamlPath) {
+        sources.push({
+            kind: 'spec_yaml',
+            path: specYamlPath,
+            provides: ['contractSlots', 'fieldContracts', 'flowContracts']
+        });
+    }
+    for (const page of input.pages) {
+        sources.push({
+            kind: 'html',
+            path: page.path,
+            provides: ['searchFields', 'gridColumns', 'buttons', 'dialogs']
+        });
+    }
+    for (const action of input.actions) {
+        sources.push({
+            kind: 'java_action',
+            path: action.path,
+            provides: ['backendMethods', 'callbackMessages', 'deletePolicyEvidence']
+        });
+    }
+    const uiSignals = collectUiSignals(input.pages);
+    const backendSignals = collectBackendSignals(input.actions);
+    const fields = collectFieldNames(input.pages);
+    const businessRules = collectBusinessRules(input.actions);
+    const hasPrd = Boolean(prdPath);
+    const hasHtml = input.pages.length > 0;
+    const hasJava = input.actions.length > 0;
+    const hasSpec = Boolean(specYamlPath);
+    let mode;
+    if (hasSpec) {
+        mode = 'extracted';
+    }
+    else if (hasPrd && hasHtml && hasJava) {
+        mode = 'prd+html+java';
+    }
+    else if (hasHtml || hasJava) {
+        mode = 'inferred';
+    }
+    else {
+        mode = 'mixed';
+    }
+    let confidence;
+    if (hasSpec) {
+        confidence = 'high';
+    }
+    else if (hasPrd && hasHtml && hasJava) {
+        confidence = 'medium';
+    }
+    else if (hasHtml || hasJava) {
+        confidence = 'medium';
+    }
+    else {
+        confidence = 'low';
+    }
+    return {
+        mode,
+        confidence,
+        sources,
+        fields,
+        businessRules,
+        uiSignals,
+        backendSignals,
+        unresolved
+    };
+}

package/dist/src/normalizers/crud-contract.d.ts

@@ -1,4 +1,7 @@
 /**
+ * @deprecated 旧 v2 协议 Normalizer（buildCrudBusinessModuleContract）。
+ * 新 glue 链路不引用；仍被 gap-pipeline（run-gap-pipeline / dev/extract-contract）使用，故保留。
+ *
  * CRUD 业务模块契约 Normalizer
  *
  * 核心职责：

package/dist/src/normalizers/crud-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crud-contract.d.ts","sourceRoot":"","sources":["../../../src/normalizers/crud-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAIV,0BAA0B,EAQ1B,WAAW,EASZ,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAAuB,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACzF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAExE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,EAAE,wBAAwB,CAAC;IACnC,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAuhCF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,sBAAsB,GAAG,0BAA0B,CAmDzG"}
+{"version":3,"file":"crud-contract.d.ts","sourceRoot":"","sources":["../../../src/normalizers/crud-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAIV,0BAA0B,EAQ1B,WAAW,EASZ,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAAuB,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACzF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAExE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,EAAE,wBAAwB,CAAC;IACnC,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAuhCF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,sBAAsB,GAAG,0BAA0B,CAmDzG"}

package/dist/src/normalizers/crud-contract.js

@@ -1,4 +1,7 @@
 /**
+ * @deprecated 旧 v2 协议 Normalizer（buildCrudBusinessModuleContract）。
+ * 新 glue 链路不引用；仍被 gap-pipeline（run-gap-pipeline / dev/extract-contract）使用，故保留。
+ *
  * CRUD 业务模块契约 Normalizer
  *
  * 核心职责：

package/dist/src/runtime/ai-runtime-trace.d.ts

@@ -0,0 +1,88 @@
+export type AiRuntimeTaskStatus = 'pending' | 'resolved' | 'blocked' | 'needs_review' | 'failed';
+export type AiRuntimeTask = {
+    caseId: string;
+    title: string;
+    role: string;
+    businessIntent: string;
+    assertionExpectation: string;
+    entryContext: Record<string, unknown>;
+    knownContext: Record<string, unknown>;
+    codingRules: Record<string, unknown>;
+    status: AiRuntimeTaskStatus;
+};
+export type AiRuntimeResult = {
+    caseId: string;
+    status: AiRuntimeTaskStatus;
+    observation?: Record<string, unknown>;
+    decision?: Record<string, unknown>;
+    actionFlow?: string[];
+    verification?: Record<string, unknown>;
+    specSnippet?: string;
+    evidence?: Array<{
+        source: string;
+        note: string;
+    }>;
+};
+export type RepairRound = {
+    round: number;
+    status: 'failed' | 'repaired' | 'blocked' | 'needs_review';
+    failureType: string;
+    summary: string;
+};
+export type AiRuntimeTrace = {
+    schemaVersion: 'ep-stage-ai-runtime-trace/v1';
+    testcasePath: string;
+    createdAt: string;
+    tasks: AiRuntimeTask[];
+    results: AiRuntimeResult[];
+    repairRounds: RepairRound[];
+};
+/**
+ * 创建 AI Runtime Trace 初始结构。
+ *
+ * @param input - testcase 路径和本轮待执行任务。
+ * @returns 初始 trace。
+ */
+export declare function createInitialAiRuntimeTrace(input: {
+    testcasePath: string;
+    tasks: AiRuntimeTask[];
+}): AiRuntimeTrace;
+/**
+ * 写入 AI Runtime Trace 文件。
+ *
+ * @param tracePath - trace 文件路径。
+ * @param trace - 待写入 trace 内容。
+ */
+export declare function writeAiRuntimeTrace(tracePath: string, trace: AiRuntimeTrace): void;
+/**
+ * 将 Playwright 执行输出归类为需要人工确认的修补方向。
+ *
+ * @param output - Playwright stdout/stderr 合并输出。
+ * @returns 失败类型、中文摘要和是否需要人工确认。
+ */
+export declare function classifyRunFailure(output: string): {
+    failureType: string;
+    summary: string;
+    needsHumanDirection: boolean;
+};
+/**
+ * 计算下一个 repair round 编号。
+ *
+ * @param caseDir - 当前需求目录。
+ * @returns 从 1 开始递增的 repair round 编号。
+ */
+export declare function nextRepairRound(caseDir: string): number;
+/**
+ * 写入等待人审的修补报告。
+ *
+ * @param input - 需求目录、轮次、失败分类和执行输出。
+ * @returns repair-report.md 路径。
+ */
+export declare function writeRepairReport(input: {
+    caseDir: string;
+    round: number;
+    failureType: string;
+    summary: string;
+    output: string;
+}): string;
+//# sourceMappingURL=ai-runtime-trace.d.ts.map

package/dist/src/runtime/ai-runtime-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-runtime-trace.d.ts","sourceRoot":"","sources":["../../../src/runtime/ai-runtime-trace.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,cAAc,GAAG,QAAQ,CAAC;AAEjG,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,mBAAmB,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,cAAc,CAAC;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,aAAa,EAAE,8BAA8B,CAAC;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB,GAAG,cAAc,CASjB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAGlF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,OAAO,CAAC;CAC9B,CAmCA;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQvD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CAyBT"}

package/dist/src/runtime/ai-runtime-trace.js

@@ -0,0 +1,119 @@
+import { existsSync, mkdirSync, readdirSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import JSON5 from 'json5';
+/**
+ * 创建 AI Runtime Trace 初始结构。
+ *
+ * @param input - testcase 路径和本轮待执行任务。
+ * @returns 初始 trace。
+ */
+export function createInitialAiRuntimeTrace(input) {
+    return {
+        schemaVersion: 'ep-stage-ai-runtime-trace/v1',
+        testcasePath: input.testcasePath,
+        createdAt: new Date().toISOString(),
+        tasks: input.tasks,
+        results: [],
+        repairRounds: [],
+    };
+}
+/**
+ * 写入 AI Runtime Trace 文件。
+ *
+ * @param tracePath - trace 文件路径。
+ * @param trace - 待写入 trace 内容。
+ */
+export function writeAiRuntimeTrace(tracePath, trace) {
+    mkdirSync(path.dirname(tracePath), { recursive: true });
+    writeFileSync(tracePath, `${JSON5.stringify(trace, null, 2)}\n`, 'utf8');
+}
+/**
+ * 将 Playwright 执行输出归类为需要人工确认的修补方向。
+ *
+ * @param output - Playwright stdout/stderr 合并输出。
+ * @returns 失败类型、中文摘要和是否需要人工确认。
+ */
+export function classifyRunFailure(output) {
+    // 断言失败优先于 iframe/locator 关键字，因为 Playwright 错误信息里常同时包含这些词。
+    if (/expect\(.*\)\.(toHaveCount|toBe|toContain|toEqual|toHaveText|toBeVisible)/i.test(output)) {
+        return {
+            failureType: 'assertion_failure',
+            summary: '业务断言未通过（如行数、文本值不匹配）',
+            needsHumanDirection: true,
+        };
+    }
+    if (/frame|iframe/i.test(output)) {
+        return {
+            failureType: 'iframe_context_error',
+            summary: '疑似 iframe 上下文错误',
+            needsHumanDirection: true,
+        };
+    }
+    if (/locator|strict mode|Timeout/i.test(output)) {
+        return {
+            failureType: 'locator_or_wait_error',
+            summary: '疑似定位或等待时机错误',
+            needsHumanDirection: true,
+        };
+    }
+    if (/permission|403|unauthorized/i.test(output)) {
+        return {
+            failureType: 'permission_blocked',
+            summary: '疑似权限不足',
+            needsHumanDirection: true,
+        };
+    }
+    return {
+        failureType: 'unknown_failure',
+        summary: '未分类执行失败',
+        needsHumanDirection: true,
+    };
+}
+/**
+ * 计算下一个 repair round 编号。
+ *
+ * @param caseDir - 当前需求目录。
+ * @returns 从 1 开始递增的 repair round 编号。
+ */
+export function nextRepairRound(caseDir) {
+    const repairRoot = path.join(caseDir, '.ep-stage', 'repair-runs');
+    if (!existsSync(repairRoot))
+        return 1;
+    const maxRound = readdirSync(repairRoot, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory() && /^\d+$/.test(entry.name))
+        .map((entry) => Number(entry.name))
+        .reduce((max, current) => Math.max(max, current), 0);
+    return maxRound + 1;
+}
+/**
+ * 写入等待人审的修补报告。
+ *
+ * @param input - 需求目录、轮次、失败分类和执行输出。
+ * @returns repair-report.md 路径。
+ */
+export function writeRepairReport(input) {
+    const roundName = String(input.round).padStart(3, '0');
+    const reportDir = path.join(input.caseDir, '.ep-stage', 'repair-runs', roundName);
+    mkdirSync(reportDir, { recursive: true });
+    const reportPath = path.join(reportDir, 'repair-report.md');
+    const body = [
+        `# 第 ${input.round} 轮修补报告`,
+        '',
+        `失败用例：完整 Playwright spec 执行失败`,
+        `失败类型：${input.failureType}`,
+        `失败摘要：${input.summary}`,
+        '',
+        '## 失败输出',
+        '',
+        '```text',
+        input.output.slice(0, 4000),
+        '```',
+        '',
+        '## 需要你确认',
+        '',
+        '请确认修补方向。Agent 不会在未确认时静默改变测试意图。',
+        '',
+    ].join('\n');
+    writeFileSync(reportPath, body, 'utf8');
+    return reportPath;
+}

package/dist/src/testcase/button-interaction-inference.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 前端按钮交互行为推理器。
+ *
+ * 职责：
+ * 1. 从 code_list.json5 的 sourceRoot + pages.list.path 定位列表页 HTML；
+ * 2. 解析 HTML 中自定义按钮的 onclick 属性及同页内联脚本中的函数体；
+ * 3. 判断交互模式（确认弹窗 / toast / 异步调用 / 打开弹窗 / 通用）；
+ * 4. 为每个 custom 按钮生成精确的中文步骤与断言；
+ * 5. 当 HTML 不可读、解析失败或模式未知时，回退到通用描述并记录原因。
+ */
+import type { ExtractedCodeListJson5 } from '../extractors/code-list-json5.js';
+/** 按钮交互模式。 */
+export type ButtonInteractionPattern = 'confirm_then_execute' | 'toast' | 'async_call' | 'open_dialog' | 'generic';
+/** 单按钮推理结果。 */
+export type ButtonInteractionInference = {
+    label: string;
+    pattern: ButtonInteractionPattern;
+    functionName?: string;
+    steps: string;
+    assertion: string;
+    evidence: string[];
+    fallbackReason?: string;
+};
+/** 推理选项。 */
+export type InferButtonInteractionsOptions = {
+    /** 覆盖 code_list.sourceRoot.root 的源码根目录。 */
+    sourceRootOverride?: string;
+};
+/**
+ * 推理所有 custom 按钮的交互行为。
+ *
+ * @param codeList - 解析后的 code_list.json5。
+ * @param options - 可选覆盖。
+ * @returns label -> 推理结果 的映射。
+ */
+export declare function inferButtonInteractions(codeList: ExtractedCodeListJson5, options?: InferButtonInteractionsOptions): Map<string, ButtonInteractionInference>;
+//# sourceMappingURL=button-interaction-inference.d.ts.map

package/dist/src/testcase/button-interaction-inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"button-interaction-inference.d.ts","sourceRoot":"","sources":["../../../src/testcase/button-interaction-inference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAE/E,cAAc;AACd,MAAM,MAAM,wBAAwB,GAChC,sBAAsB,GACtB,OAAO,GACP,YAAY,GACZ,aAAa,GACb,SAAS,CAAC;AAEd,eAAe;AACf,MAAM,MAAM,0BAA0B,GAAG;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,wBAAwB,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,YAAY;AACZ,MAAM,MAAM,8BAA8B,GAAG;IAC3C,2CAA2C;IAC3C,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AA0QF;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,sBAAsB,EAChC,OAAO,CAAC,EAAE,8BAA8B,GACvC,GAAG,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAqIzC"}