@epoint-testtech/ep-stage-skill 0.0.5 → 0.0.6

package/codex-skill/ep-stage/glue-run-test/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: glue-run-test
 description: 使用时机：当用户对某需求要「跑测试 / 验证 / 端到端执行 / 跑胶水测试 / 看报告」或显式触发 `/glue-run-test <testcase.json5路径>` 时使用。
-version: 2026-08-12+925f4c4
+version: 2026-08-12+ba01f81
 argument-hint: "<testcase.json5绝对/相对路径>"
 compatibility: 需要由 stage-create 生成的 glue 模式 Playwright 项目 + 已审过的 `testcase.json5` + 同目录 `credentials.json5`。
 metadata:
@@ -215,7 +215,9 @@ CLI 非 0 退出 → 复述 stderr，不进 Step 7。
 | `<projectDir>/src/tests/<需求名>/.ep-stage/ai-runtime-trace.json5` | prepare-tasks 先写 tasks；run 回写 results / repairRounds |
 | `<projectDir>/src/tests/<需求名>/.ep-stage/elementmap.json` | Agent O-D-A-V 落的页面控件定位清单（含 grid columns）；run 不触碰 |
 | `<projectDir>/src/tests/<需求名>/.ep-stage/repair-runs/<round>/repair-report.md` | 失败时才产；含失败分类与摘要，待人审确认 |
-| `e2e/glue-code-mvp/glue-report/<run-timestamp>/` | run 子命令产；执行结果账本目录 |
+| `<projectDir>/e2e/glue-code-mvp/glue-report/<run-timestamp>/` | run 子命令产；执行账本（`run-output.log` 完整执行输出 + `run-info.json`） |
+| `<projectDir>/playwright-report/index.html` | run 子命令随执行产；Playwright 综合报告（用例状态/错误/截图/trace 回放），`npx playwright show-report` 打开 |
+| `<projectDir>/stage-report/` | run 子命令随执行产；stage-core 流程视角报告（index.html + report.pdf） |
 
 ## 4. 错误处理
 
@@ -238,7 +240,8 @@ Step 7 全部通过后，按以下中文格式呈现：
 > 需求：`<需求名>`／项目：`<projectDir>`
 > Spec：`<projectDir>/src/tests/<需求名>/crud.spec.ts`（glue 骨架 + Agent snippet 合并）
 > AI Runtime Trace：`<projectDir>/src/tests/<需求名>/.ep-stage/ai-runtime-trace.json5`
-> 报告目录：`e2e/glue-code-mvp/glue-report/<run-timestamp>/`
+> 报告目录：`<projectDir>/e2e/glue-code-mvp/glue-report/<run-timestamp>/`（run-output.log + run-info.json）
+> 综合报告：`<projectDir>/playwright-report/index.html` + `<projectDir>/stage-report/`（index.html + report.pdf）
 > 运行版本：`version = v1`
 >
 > 下一步：① 调整 `testcase.json5` / `contract.json5` 后重跑 `/glue-run-test <testcase.json5路径>`；② 失败时查看 repair-report.md 确认修补方向后再重跑。

package/dist/src/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":";AAOA;;;;;;;;;;;GAWG;AACH,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CA+B1E;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAchC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAS3F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":";AAOA;;;;;;;;;;;GAWG;AACH,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAoD1E;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAchC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAS3F"}

package/dist/src/cli/index.js

@@ -34,8 +34,29 @@ export async function main(argv = process.argv) {
             ].join('\n'));
             return result;
         }
-        case 'run':
-            return runRun(parseRunArgs(args));
+        case 'run': {
+            const result = await runRun(parseRunArgs(args));
+            // 结果摘要回显（此前 run 静默退出，自动化无法感知成败）。
+            const lines = [
+                `spec: ${result.specPath}`,
+                `report: ${result.reportDir}`,
+                `trace: ${result.aiRuntimeTracePath}`,
+            ];
+            if (result.repairReportPath) {
+                lines.push(`repair: ${result.repairReportPath}`);
+            }
+            if (result.credentialsNotice) {
+                lines.push(result.credentialsNotice);
+            }
+            console.log(lines.join('\n'));
+            // 执行失败（已落修补报告）以非 0 退出，对齐 skill 文档「CLI 非 0 退出 → 复述 stderr」契约；
+            // 修补流程本身不受影响，人审确认方向后重跑即可。
+            if (result.repairReportPath) {
+                console.error(`执行失败：已落修补报告 ${result.repairReportPath}，待人审确认修补方向`);
+                process.exitCode = 1;
+            }
+            return result;
+        }
         case undefined:
         case '--help':
         case '-h':

package/dist/src/cli/run.d.ts.map

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

package/dist/src/cli/run.js

@@ -120,9 +120,11 @@ export function buildPlaywrightCommand(input) {
     const basename = path.basename(input.specPath);
     const escapedBasename = basename.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
     const specArg = `.*${escapedBasename}`;
-    // 追加 list reporter 保证控制台有可被 classifyRunFailure 消费的原生输出；
-    // stage-core 等 reporter 会吞并原生输出，导致失败信息为空。
-    const args = ['playwright', 'test', specArg, '--reporter=list'];
+    // 枚举多个 reporter：list 保证控制台有可被 classifyRunFailure 消费的原生输出；
+    // html 与 stage-core reporter 让综合报告（playwright-report / stage-report）随 run 一并生成，
+    // 避免执行完还要手工补跑才能拿到汇总报告。CLI --reporter 会整体覆盖项目 config，
+    // 所以必须在同一条参数里显式枚举，不能只加 list。
+    const args = ['playwright', 'test', specArg, '--reporter=list,html,@epoint-testtech/stage-core/reporter'];
     if (!input.headless) {
         args.push('--headed');
     }
@@ -511,8 +513,10 @@ export async function runRun(args, deps) {
     });
     // 失败时分类并写 repair report，停止等待人审；成功时 repairReportPath 留空。
     let repairReportPath;
+    let failureType;
     if (!execution.passed) {
         const classification = classifyRunFailure(execution.output);
+        failureType = classification.failureType;
         const round = nextRepairRound(paths.caseDir);
         repairReportPath = writeRepairReport({
             caseDir: paths.caseDir,
@@ -529,9 +533,18 @@ export async function runRun(args, deps) {
         });
         writeAiRuntimeTrace(tracePath, trace);
     }
-    // 报告目录。
+    // 报告目录：落执行账本（完整执行输出 + 机器可读 run 信息），
+    // 修补报告只截失败输出片段，完整证据以这里为准。
     const reportDir = path.join(paths.projectDir, 'e2e/glue-code-mvp/glue-report', new Date().toISOString().replace(/[:.]/g, '-'));
     mkdirSync(reportDir, { recursive: true });
+    writeFileSync(path.join(reportDir, 'run-output.log'), execution.output);
+    writeFileSync(path.join(reportDir, 'run-info.json'), `${JSON.stringify({
+        specPath: paths.specPath,
+        passed: execution.passed,
+        failureType,
+        repairReportPath,
+        executedAt: new Date().toISOString(),
+    }, null, 2)}\n`);
     // credentials.json5 消费边界声明。
     const credentialsNotice = loadCredentialsNotice(testcase, paths.testcasePath);
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epoint-testtech/ep-stage-skill",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "type": "module",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",