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

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+ba01f81
+version: 2026-08-12+2f7c618
 argument-hint: "<testcase.json5绝对/相对路径>"
 compatibility: 需要由 stage-create 生成的 glue 模式 Playwright 项目 + 已审过的 `testcase.json5` + 同目录 `credentials.json5`。
 metadata:
@@ -215,7 +215,7 @@ 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` | 失败时才产；含失败分类与摘要，待人审确认 |
-| `<projectDir>/e2e/glue-code-mvp/glue-report/<run-timestamp>/` | run 子命令产；执行账本（`run-output.log` 完整执行输出 + `run-info.json`） |
+| `<projectDir>/e2e/glue-code-mvp/glue-report/<run-timestamp>/` | run 子命令产；执行账本（`index.html` glue 风格综合报告（全部用例）+ `playwright-results.json` + `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） |
 
@@ -241,7 +241,8 @@ Step 7 全部通过后，按以下中文格式呈现：
 > Spec：`<projectDir>/src/tests/<需求名>/crud.spec.ts`（glue 骨架 + Agent snippet 合并）
 > AI Runtime Trace：`<projectDir>/src/tests/<需求名>/.ep-stage/ai-runtime-trace.json5`
 > 报告目录：`<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）
+> 综合报告：`<projectDir>/e2e/glue-code-mvp/glue-report/<run-timestamp>/index.html`（glue 风格，覆盖全部用例）
+> 技术细节：`<projectDir>/playwright-report/index.html`（trace/截图/视频）+ `<projectDir>/stage-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,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"}
+{"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,CAuD1E;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

@@ -42,6 +42,9 @@ export async function main(argv = process.argv) {
                 `report: ${result.reportDir}`,
                 `trace: ${result.aiRuntimeTracePath}`,
             ];
+            if (result.comprehensiveReportPath) {
+                lines.push(`综合报告: ${result.comprehensiveReportPath}`);
+            }
             if (result.repairReportPath) {
                 lines.push(`repair: ${result.repairReportPath}`);
             }

package/dist/src/cli/run-report.d.ts

@@ -0,0 +1,43 @@
+/**
+ * run-report.ts — run 子命令的综合报告渲染（glue 风格单文件 HTML）。
+ *
+ * 输入：Playwright JSON reporter 产物（PLAYWRIGHT_JSON_OUTPUT_NAME 指定落盘）。
+ * 输出：<reportDir>/index.html —— 与脚手架 stage-glue 报告同款样式
+ * （概览 + 统计卡片 + 状态色卡片 + 页脚原生报告入口），
+ * 但数据来自 Playwright 真实执行结果（覆盖全部用例，含 AI snippet）。
+ */
+export type RunReportTestItem = {
+    title: string;
+    suitePath: string;
+    projectName: string;
+    status: 'passed' | 'failed' | 'flaky' | 'skipped';
+    durationMs: number;
+    location?: string;
+    errorMessage?: string;
+};
+export type RunReportData = {
+    suiteTitle: string;
+    startedAt: string;
+    durationMs: number;
+    specFile?: string;
+    items: RunReportTestItem[];
+    /** AI 任务标题集合（命中者标记为 Agent 推理执行）。 */
+    aiTaskTitles: string[];
+    /** 相对 reportDir 的链接。 */
+    playwrightReportHref?: string;
+    stageReportHref?: string;
+};
+/**
+ * 把 Playwright JSON reporter 输出摊平为报告用例条目。
+ */
+export declare function parsePlaywrightJsonResults(jsonText: string): {
+    suiteTitle: string;
+    durationMs: number;
+    startedAt: string;
+    items: RunReportTestItem[];
+};
+/**
+ * 渲染 glue 风格综合报告（单文件、内联样式、无外部依赖）。
+ */
+export declare function renderRunReportHtml(data: RunReportData): string;
+//# sourceMappingURL=run-report.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-report.d.ts","sourceRoot":"","sources":["../../../src/cli/run-report.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,oCAAoC;IACpC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,wBAAwB;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AA4CF;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B,CAwCA;AA4DD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAkL/D"}

package/dist/src/cli/run-report.js

@@ -0,0 +1,292 @@
+/**
+ * run-report.ts — run 子命令的综合报告渲染（glue 风格单文件 HTML）。
+ *
+ * 输入：Playwright JSON reporter 产物（PLAYWRIGHT_JSON_OUTPUT_NAME 指定落盘）。
+ * 输出：<reportDir>/index.html —— 与脚手架 stage-glue 报告同款样式
+ * （概览 + 统计卡片 + 状态色卡片 + 页脚原生报告入口），
+ * 但数据来自 Playwright 真实执行结果（覆盖全部用例，含 AI snippet）。
+ */
+function escapeHtml(value) {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+function mapTestStatus(status) {
+    switch (status) {
+        case 'expected':
+            return 'passed';
+        case 'unexpected':
+            return 'failed';
+        case 'flaky':
+            return 'flaky';
+        default:
+            return 'skipped';
+    }
+}
+/**
+ * 把 Playwright JSON reporter 输出摊平为报告用例条目。
+ */
+export function parsePlaywrightJsonResults(jsonText) {
+    const parsed = JSON.parse(jsonText);
+    const items = [];
+    const walk = (suite, trail) => {
+        const nextTrail = suite.title ? [...trail, suite.title] : trail;
+        for (const spec of suite.specs ?? []) {
+            for (const test of spec.tests ?? []) {
+                const lastResult = test.results?.[test.results.length - 1];
+                const errorMessage = lastResult?.error?.message ?? lastResult?.errors?.[0]?.message;
+                items.push({
+                    title: spec.title,
+                    suitePath: nextTrail.join(' › '),
+                    projectName: test.projectName ?? '',
+                    status: mapTestStatus(test.status),
+                    durationMs: lastResult?.duration ?? 0,
+                    location: spec.file !== undefined && spec.line !== undefined
+                        ? `${spec.file}:${spec.line}`
+                        : spec.file,
+                    errorMessage: errorMessage?.split('\n').slice(0, 12).join('\n'),
+                });
+            }
+        }
+        for (const child of suite.suites ?? []) {
+            walk(child, nextTrail);
+        }
+    };
+    for (const suite of parsed.suites ?? []) {
+        walk(suite, []);
+    }
+    return {
+        suiteTitle: parsed.suites?.[0]?.title ?? 'Playwright 测试套件',
+        durationMs: Math.round(parsed.stats?.duration ?? 0),
+        startedAt: parsed.stats?.startTime ?? '',
+        items,
+    };
+}
+const STATUS_LABEL = {
+    passed: '通过',
+    failed: '失败',
+    flaky: '不稳定',
+    skipped: '跳过',
+};
+const STATUS_BADGE_CLASS = {
+    passed: 'passed',
+    failed: 'failed',
+    flaky: 'needs_review',
+    skipped: 'unresolved',
+};
+function formatDuration(ms) {
+    if (ms >= 60_000) {
+        return `${Math.floor(ms / 60_000)}m ${Math.round((ms % 60_000) / 1000)}s`;
+    }
+    if (ms >= 1000) {
+        return `${(ms / 1000).toFixed(1)}s`;
+    }
+    return `${ms}ms`;
+}
+function formatDisplayTimestamp(iso) {
+    if (!iso)
+        return '-';
+    const d = new Date(iso);
+    if (Number.isNaN(d.getTime()))
+        return iso;
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
+}
+function renderTestCard(item, strategy) {
+    const errorHtml = item.errorMessage
+        ? `<div class="error"><strong>错误信息：</strong><pre>${escapeHtml(item.errorMessage)}</pre></div>`
+        : '';
+    return `
+    <article class="workflow workflow--${escapeHtml(STATUS_BADGE_CLASS[item.status])}" data-strategy="${escapeHtml(strategy)}" data-status="${escapeHtml(item.status)}">
+      <header class="workflow__header">
+        <div class="workflow__title">
+          <h2>${escapeHtml(item.title)}</h2>
+          <code class="workflow__id">${escapeHtml(item.location ?? '')}</code>
+        </div>
+        <div class="workflow__meta">
+          <span class="badge badge--kind">${escapeHtml(item.projectName)}</span>
+          <span class="badge badge--source">${escapeHtml(strategy === 'agent_inferred' ? 'Agent推理执行' : '胶水编码执行')}</span>
+          <span class="badge badge--status badge--${escapeHtml(STATUS_BADGE_CLASS[item.status])}">${escapeHtml(STATUS_LABEL[item.status])}</span>
+        </div>
+      </header>
+      <dl class="workflow__body">
+        <dt>套件路径</dt><dd>${escapeHtml(item.suitePath)}</dd>
+        <dt>耗时</dt><dd>${escapeHtml(formatDuration(item.durationMs))}</dd>
+      </dl>
+      ${errorHtml}
+    </article>
+  `;
+}
+/**
+ * 渲染 glue 风格综合报告（单文件、内联样式、无外部依赖）。
+ */
+export function renderRunReportHtml(data) {
+    const count = (s) => data.items.filter((i) => i.status === s).length;
+    const agentCount = data.items.filter((i) => data.aiTaskTitles.includes(i.title)).length;
+    const overviewRows = [
+        ['测试套件', data.suiteTitle],
+        ['执行时间', formatDisplayTimestamp(data.startedAt)],
+        ['执行耗时', formatDuration(data.durationMs)],
+        ['Spec 文件', data.specFile ?? '-'],
+    ];
+    const overviewHtml = overviewRows
+        .map(([label, value]) => `<tr><th>${escapeHtml(label)}</th><td>${escapeHtml(value)}</td></tr>`)
+        .join('');
+    const strategyCards = [
+        ['总测试流程', data.items.length, 'total', ''],
+        ['胶水编码执行', data.items.length - agentCount, 'glue', 'glue_code'],
+        ['Agent推理执行', agentCount, 'agent', 'agent_inferred'],
+    ];
+    const resultCards = [
+        ['通过', count('passed'), 'passed', 'passed'],
+        ['失败', count('failed'), 'failed', 'failed'],
+        ['不稳定', count('flaky'), 'review', 'flaky'],
+        ['跳过', count('skipped'), 'unresolved', 'skipped'],
+    ];
+    const renderCards = (cards, filterGroup) => cards
+        .map(([label, value, kind, filterValue]) => `
+        <div class="summary-card summary-card--${kind}" data-filter-group="${filterGroup}" data-filter-value="${filterValue}" role="button" tabindex="0">
+          <div class="summary-card__value">${value}</div>
+          <div class="summary-card__label">${escapeHtml(label)}</div>
+        </div>`)
+        .join('');
+    const workflowsHtml = data.items.length
+        ? data.items
+            .map((item) => renderTestCard(item, data.aiTaskTitles.includes(item.title) ? 'agent_inferred' : 'glue_code'))
+            .join('\n')
+        : '<p class="muted">（本次运行未发现任何用例结果）</p>';
+    const footerLinks = [
+        data.playwrightReportHref
+            ? `<a class="pw-link" href="${escapeHtml(data.playwrightReportHref)}" target="_blank" rel="noopener">Playwright 原生报告（trace / 截图 / 视频）</a>`
+            : '',
+        data.stageReportHref
+            ? `<a class="pw-link pw-link--secondary" href="${escapeHtml(data.stageReportHref)}" target="_blank" rel="noopener">stage-core 流程报告（PDF）</a>`
+            : '',
+    ]
+        .filter(Boolean)
+        .join(' ');
+    const style = `
+    body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", sans-serif; background: #f7f8fa; color: #1f2933; margin: 0; padding: 24px; }
+    h1 { margin: 0 0 16px; font-size: 22px; }
+    h2 { font-size: 16px; margin: 16px 0 8px; }
+    section.overview { background: #fff; border-radius: 8px; padding: 20px; box-shadow: 0 1px 3px rgba(0,0,0,0.05); margin-bottom: 24px; }
+    .overview-table { width: 100%; border-collapse: collapse; margin-bottom: 16px; }
+    .overview-table th, .overview-table td { text-align: left; padding: 6px 12px; border-bottom: 1px solid #eee; font-size: 13px; }
+    .overview-table th { width: 140px; color: #52606d; font-weight: 600; }
+    .summary-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(140px, 1fr)); gap: 12px; }
+    .summary-card { background: #f0f4f8; border-radius: 6px; padding: 12px; text-align: center; cursor: pointer; transition: box-shadow 0.15s, transform 0.1s; }
+    .summary-card:hover { box-shadow: 0 2px 6px rgba(0,0,0,0.1); transform: translateY(-1px); }
+    .summary-card--active { box-shadow: 0 0 0 2px #2563eb; }
+    .summary-card__value { font-size: 22px; font-weight: 600; }
+    .summary-card__label { font-size: 12px; color: #52606d; margin-top: 4px; }
+    .summary-card--passed { background: #e3fcec; }
+    .summary-card--failed { background: #ffe3e3; }
+    .summary-card--review { background: #fff4d6; }
+    .summary-card--unresolved { background: #f0e8ff; }
+    article.workflow { background: #fff; border-radius: 8px; padding: 16px 20px; margin-bottom: 16px; box-shadow: 0 1px 3px rgba(0,0,0,0.05); border-left: 4px solid #cbd2d9; }
+    article.workflow--passed { border-left-color: #2f9e44; }
+    article.workflow--failed { border-left-color: #e03131; }
+    article.workflow--needs_review { border-left-color: #f59f00; }
+    article.workflow--unresolved { border-left-color: #7048e8; }
+    .workflow__header { display: flex; justify-content: space-between; align-items: flex-start; flex-wrap: wrap; gap: 12px; }
+    .workflow__title h2 { margin: 0; font-size: 16px; }
+    .workflow__id { font-size: 12px; color: #52606d; }
+    .workflow__meta { display: flex; gap: 8px; flex-wrap: wrap; }
+    .badge { display: inline-block; padding: 2px 8px; font-size: 12px; border-radius: 12px; background: #e4e7eb; color: #1f2933; }
+    .badge--passed { background: #2f9e44; color: #fff; }
+    .badge--failed { background: #e03131; color: #fff; }
+    .badge--needs_review { background: #f59f00; color: #fff; }
+    .badge--unresolved { background: #7048e8; color: #fff; }
+    dl.workflow__body { display: grid; grid-template-columns: 100px 1fr; gap: 6px 12px; margin: 12px 0 4px; font-size: 13px; }
+    dl.workflow__body dt { color: #52606d; font-weight: 600; }
+    code { background: #f0f4f8; padding: 1px 4px; border-radius: 3px; font-size: 12px; }
+    .error pre { background: #fff5f5; color: #c92a2a; padding: 8px; border-radius: 4px; overflow-x: auto; font-size: 12px; white-space: pre-wrap; }
+    .muted { color: #829ab1; font-size: 13px; }
+    footer.footer { background: #fff; border-radius: 8px; padding: 16px 20px; margin-top: 16px; box-shadow: 0 1px 3px rgba(0,0,0,0.05); }
+    .pw-link { display: inline-block; padding: 8px 16px; background: #2563eb; color: #fff; border-radius: 4px; text-decoration: none; font-size: 14px; margin-right: 8px; }
+    .pw-link:hover { background: #1d4ed8; }
+    .pw-link--secondary { background: #334e68; }
+    .workflow-toolbar { display: flex; align-items: center; justify-content: space-between; gap: 12px; flex-wrap: wrap; margin: 16px 0 8px; }
+    .workflow-toolbar h2 { margin: 0; }
+    .workflow-filters { display: flex; gap: 8px; }
+    .workflow-filters select { padding: 4px 8px; font-size: 13px; border: 1px solid #cbd2d9; border-radius: 4px; background: #fff; color: #1f2933; }
+    .summary-section-title { font-size: 13px; color: #52606d; margin: 12px 0 4px; font-weight: 600; }
+  `;
+    return `<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width,initial-scale=1.0" />
+  <title>胶水编码-测试执行</title>
+  <style>${style}</style>
+</head>
+<body>
+  <section class="overview">
+    <h1>胶水编码-测试执行（综合报告）</h1>
+    <table class="overview-table">${overviewHtml}</table>
+    <h3 class="summary-section-title">执行策略</h3>
+    <div class="summary-grid summary-grid--strategy">${renderCards(strategyCards, 'strategy')}</div>
+    <h3 class="summary-section-title">执行结果</h3>
+    <div class="summary-grid summary-grid--result">${renderCards(resultCards, 'status')}</div>
+  </section>
+  <section class="workflows">
+    <div class="workflow-toolbar">
+      <h2>用例执行明细</h2>
+      <div class="workflow-filters">
+        <select id="filter-strategy">
+          <option value="">全部执行策略</option>
+          <option value="glue_code">胶水编码执行</option>
+          <option value="agent_inferred">Agent推理执行</option>
+        </select>
+        <select id="filter-status">
+          <option value="">全部执行结果</option>
+          <option value="passed">通过</option>
+          <option value="failed">失败</option>
+          <option value="flaky">不稳定</option>
+          <option value="skipped">跳过</option>
+        </select>
+      </div>
+    </div>
+    ${workflowsHtml}
+  </section>
+  <footer class="footer">
+    ${footerLinks || '<p class="muted">本次未发现关联报告产物</p>'}
+  </footer>
+  <script>
+    (function() {
+      var fs = document.getElementById('filter-strategy');
+      var fst = document.getElementById('filter-status');
+      var cards = document.querySelectorAll('article.workflow');
+      var summaryCards = document.querySelectorAll('.summary-card');
+      function apply() {
+        var s = fs.value, st = fst.value;
+        for (var i = 0; i < cards.length; i++) {
+          var c = cards[i];
+          var show = (!s || c.dataset.strategy === s) && (!st || c.dataset.status === st);
+          c.style.display = show ? '' : 'none';
+        }
+        for (var j = 0; j < summaryCards.length; j++) {
+          var card = summaryCards[j];
+          var select = card.dataset.filterGroup === 'strategy' ? fs : fst;
+          card.classList.toggle('summary-card--active', select.value !== '' && select.value === card.dataset.filterValue);
+        }
+      }
+      fs.addEventListener('change', apply);
+      fst.addEventListener('change', apply);
+      for (var j = 0; j < summaryCards.length; j++) {
+        (function(card) {
+          card.addEventListener('click', function() {
+            var select = card.dataset.filterGroup === 'strategy' ? fs : fst;
+            select.value = select.value === card.dataset.filterValue ? '' : card.dataset.filterValue;
+            apply();
+          });
+        })(summaryCards[j]);
+      }
+    })();
+  </script>
+</body>
+</html>
+`;
+}

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

@@ -21,6 +21,7 @@ export type RunArgs = {
  * @property version - 'v1'：已接入 Agent snippets 合并、spec 执行和 repair 回路。
  * @property aiRuntimeTracePath - 落盘的 .ep-stage/ai-runtime-trace.json5（含 tasks 与 results）。
  * @property repairReportPath - 执行失败时落盘的 repair-report.md；成功时为 undefined。
+ * @property comprehensiveReportPath - glue 风格综合报告 <reportDir>/index.html；渲染失败时为 undefined。
  */
 export type RunResult = {
     specPath: string;
@@ -29,6 +30,7 @@ export type RunResult = {
     version: 'v1';
     aiRuntimeTracePath?: string;
     repairReportPath?: string;
+    comprehensiveReportPath?: string;
 };
 /**
  * runRun 的可注入依赖（测试即契约：允许单测替换推理与执行，避免触发真机）。

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

@@ -5,6 +5,7 @@ import JSON5 from 'json5';
 import { validateTestcase } from '../validation/testcase.js';
 import { classifyRunFailure, createInitialAiRuntimeTrace, nextRepairRound, writeAiRuntimeTrace, writeRepairReport, } from '../runtime/ai-runtime-trace.js';
 import { runSpec } from './spec.js';
+import { parsePlaywrightJsonResults, renderRunReportHtml } from './run-report.js';
 /**
  * AI 追加段分隔标记。重跑时 detect 已有标记则覆盖（保证幂等）。
  *
@@ -121,10 +122,11 @@ export function buildPlaywrightCommand(input) {
     const escapedBasename = basename.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
     const specArg = `.*${escapedBasename}`;
     // 枚举多个 reporter：list 保证控制台有可被 classifyRunFailure 消费的原生输出；
+    // json 落机器可读结果（经 PLAYWRIGHT_JSON_OUTPUT_NAME 指定文件）供 glue 风格综合报告渲染；
     // 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'];
+    const args = ['playwright', 'test', specArg, '--reporter=list,json,html,@epoint-testtech/stage-core/reporter'];
     if (!input.headless) {
         args.push('--headed');
     }
@@ -148,6 +150,9 @@ async function defaultExecuteFullSpec(input) {
         cwd: cmd.cwd,
         encoding: 'utf8',
         shell: true,
+        env: input.resultsJsonPath
+            ? { ...process.env, PLAYWRIGHT_JSON_OUTPUT_NAME: input.resultsJsonPath }
+            : process.env,
     });
     const stdout = spawned.stdout ?? '';
     const stderr = spawned.stderr ?? '';
@@ -504,12 +509,17 @@ export async function runRun(args, deps) {
     }
     appendAiSnippets(paths.specPath, aiRuntimeTasks, resolvedResults);
     writeAiRuntimeTrace(tracePath, trace);
+    // 报告目录先于执行创建：json reporter 结果文件落这里，供 glue 风格综合报告渲染。
+    const reportDir = path.join(paths.projectDir, 'e2e/glue-code-mvp/glue-report', new Date().toISOString().replace(/[:.]/g, '-'));
+    mkdirSync(reportDir, { recursive: true });
+    const resultsJsonPath = path.join(reportDir, 'playwright-results.json');
     // 执行完整 spec。
     const executor = deps?.executeFullSpec ?? defaultExecuteFullSpec;
     const execution = await executor({
         projectDir: paths.projectDir,
         specPath: paths.specPath,
         headless: args.headless,
+        resultsJsonPath,
     });
     // 失败时分类并写 repair report，停止等待人审；成功时 repairReportPath 留空。
     let repairReportPath;
@@ -535,8 +545,6 @@ export async function runRun(args, deps) {
     }
     // 报告目录：落执行账本（完整执行输出 + 机器可读 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,
@@ -545,6 +553,29 @@ export async function runRun(args, deps) {
         repairReportPath,
         executedAt: new Date().toISOString(),
     }, null, 2)}\n`);
+    // glue 风格综合报告（index.html）：数据来自 Playwright JSON 结果，
+    // 覆盖全部用例（含 AI snippet）；渲染失败只降级缺省，不阻断主流程。
+    let comprehensiveReportPath;
+    try {
+        if (existsSync(resultsJsonPath)) {
+            const parsedResults = parsePlaywrightJsonResults(readFileSync(resultsJsonPath, 'utf8'));
+            const html = renderRunReportHtml({
+                suiteTitle: parsedResults.suiteTitle,
+                startedAt: parsedResults.startedAt,
+                durationMs: parsedResults.durationMs,
+                specFile: paths.specPath,
+                items: parsedResults.items,
+                aiTaskTitles: aiRuntimeTasks.map((task) => task.title),
+                playwrightReportHref: '../../../../playwright-report/index.html',
+                stageReportHref: '../../../../stage-report/report.pdf',
+            });
+            comprehensiveReportPath = path.join(reportDir, 'index.html');
+            writeFileSync(comprehensiveReportPath, html);
+        }
+    }
+    catch {
+        comprehensiveReportPath = undefined;
+    }
     // credentials.json5 消费边界声明。
     const credentialsNotice = loadCredentialsNotice(testcase, paths.testcasePath);
     return {
@@ -554,5 +585,6 @@ export async function runRun(args, deps) {
         version: 'v1',
         aiRuntimeTracePath: tracePath,
         repairReportPath,
+        comprehensiveReportPath,
     };
 }

package/package.json

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