@tea-agent/loop-agent 0.1.0-fe-test.0

package/dist/workflows/dag/frontend-test-case-quality.js

@@ -0,0 +1,105 @@
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import path from "node:path";
+const CASE_ID = /^FE-[A-Za-z0-9][A-Za-z0-9-]*-\d{3}-[a-z][a-z0-9-]{0,31}$/;
+const AC_ID = /^AC(?:-[A-Z0-9]+)+$/i;
+const PLACEHOLDER = /\b(?:TODO|TBD|FIXME)\b|结果正确|页面正常|按实际情况处理|验证成功/i;
+const SECTION_ALIASES = {
+    purpose: ["Test Purpose", "测试目的", "测试场景"],
+    source: ["Source References", "需求依据"],
+    preconditions: ["Preconditions", "前置条件"],
+    steps: ["Steps", "操作步骤"],
+    expected: ["Expected Results", "预期结果"],
+    automation: ["Automation Notes", "自动化映射", "自动化说明"],
+};
+function section(body, names) {
+    const marker = new RegExp(`^###\\s+(?:${names.map((v) => v.replace(/[.*+?^${}()|[\\]\\]/g, "\\$&")).join("|")})\\s*$`, "mi");
+    const hit = marker.exec(body);
+    if (!hit)
+        return "";
+    const rest = body.slice(hit.index + hit[0].length);
+    const next = /^###\s+/m.exec(rest);
+    return rest.slice(0, next?.index ?? rest.length).trim();
+}
+function hasList(value) { return /^\s*(?:\d+[.)]|[-*+])\s+\S+/m.test(value); }
+function hasAssertion(value) { return /(?:status|状态|包含|显示|等于|为|可见|不可见|跳转|错误|成功|失败|should|expect|assert|must)/i.test(value); }
+export async function validateFrontendCaseContent(input) {
+    const root = path.join(input.workspaceRoot, "testcase/frontend/cases");
+    const manifestPath = path.join(root, "manifest.json");
+    const findings = [];
+    let manifest;
+    try {
+        manifest = JSON.parse(await readFile(manifestPath, "utf8"));
+    }
+    catch {
+        findings.push({ ruleId: "manifest-unavailable", detail: "manifest.json is missing or invalid" });
+        return render(findings);
+    }
+    if (!Array.isArray(manifest.cases) || manifest.cases.length === 0) {
+        findings.push({ ruleId: "empty-cases", detail: "cases must be a non-empty array" });
+        return render(findings);
+    }
+    const seen = new Set();
+    const covered = new Set();
+    for (const item of manifest.cases) {
+        const id = typeof item?.caseId === "string" ? item.caseId : "?";
+        if (seen.has(id))
+            findings.push({ ruleId: "duplicate-case-id", caseId: id, detail: "caseId is duplicated" });
+        seen.add(id);
+        if (!CASE_ID.test(id))
+            findings.push({ ruleId: "case-id-shape", caseId: id, detail: "caseId must match FE-<FEATURE>-<NNN>-<dimension>" });
+        const acIds = Array.isArray(item?.acIds) ? item.acIds : [];
+        for (const ac of acIds) {
+            if (typeof ac !== "string" || !AC_ID.test(ac))
+                findings.push({ ruleId: "ac-id-shape", caseId: id, detail: `invalid AC id: ${String(ac)}` });
+            else {
+                covered.add(ac);
+                if (input.requiredAcIds?.length && !input.requiredAcIds.includes(ac))
+                    findings.push({ ruleId: "unknown-ac", caseId: id, detail: `${ac} is not declared by the task` });
+            }
+        }
+        const file = path.join(input.workspaceRoot, item?.casePath || `testcase/frontend/cases/${id}.md`);
+        let body = "";
+        try {
+            body = await readFile(file, "utf8");
+        }
+        catch {
+            findings.push({ ruleId: "case-file-missing", caseId: id, detail: `missing case file: ${item?.casePath || file}` });
+            continue;
+        }
+        if (PLACEHOLDER.test(body))
+            findings.push({ ruleId: "placeholder-wording", caseId: id, detail: "case contains placeholder or non-assertable wording" });
+        for (const [key, names] of Object.entries(SECTION_ALIASES))
+            if (!section(body, names))
+                findings.push({ ruleId: `missing-${key}`, caseId: id, detail: `missing section: ${names.join(" or ")}` });
+        const steps = section(body, SECTION_ALIASES.steps), expected = section(body, SECTION_ALIASES.expected);
+        if (!hasList(steps))
+            findings.push({ ruleId: "unstructured-steps", caseId: id, detail: "steps should contain numbered or bulleted executable actions" });
+        if (!hasList(expected) || !hasAssertion(expected))
+            findings.push({ ruleId: "unassertable-expected", caseId: id, detail: "expected results should contain structured, assertable outcomes" });
+        for (const ac of acIds)
+            if (typeof ac === "string" && !body.includes(ac))
+                findings.push({ ruleId: "ac-not-in-case", caseId: id, detail: `${ac} is not explicitly referenced by the case body` });
+        if (acIds.length && !acIds.some((ac) => body.includes(ac) && (steps.includes(ac) || expected.includes(ac))))
+            findings.push({ ruleId: "ac-not-linked-to-verification", caseId: id, detail: "AC is not linked to steps or expected results" });
+    }
+    for (const ac of input.requiredAcIds ?? [])
+        if (!covered.has(ac))
+            findings.push({ ruleId: "missing-ac-coverage", detail: `${ac} is not covered by any frontend case` });
+    return render(findings);
+}
+function render(findings) {
+    const status = findings.length ? "FAIL" : "PASS";
+    const lines = ["# Frontend Test Case Quality Advisory", "", "## Status", "", status, "", `- Findings: ${findings.length}`, "- Enforcement: advisory; findings do not block execution", "", "## Findings", "", ...(findings.length ? findings.map((f) => `- [${f.ruleId}]${f.caseId ? ` ${f.caseId}` : ""}: ${f.detail}`) : ["- None"]), ""];
+    const markdown = lines.join("\n");
+    const esc = (v) => v.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;");
+    const html = `<!doctype html><html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>前端测试用例质量建议报告</title><style>body{font:16px system-ui,"Microsoft YaHei","PingFang SC",sans-serif;margin:0;padding:2rem;color:#172033;background:#f6f8fb}main{max-width:1100px;margin:auto;background:white;padding:2rem;border-radius:16px;box-shadow:0 8px 28px rgba(23,32,51,.08)}h1{color:#17365d;margin-top:0}.badge{display:inline-block;padding:.35rem .7rem;border-radius:999px;background:${findings.length ? "#fff3cd" : "#ecfdf3"};color:${findings.length ? "#946200" : "#067647"}}li{margin:.7rem 0}code{color:#667085}p{line-height:1.7}</style></head><body><main><h1>前端测试用例质量建议报告</h1><p><span class="badge">${findings.length ? "发现问题" : "检查通过"}</span> <strong>仅供改进</strong>：以下问题属于建议性检查结果，不会阻塞后续测试执行。</p><p>问题数量：${findings.length}</p><h2>建议项明细</h2><ul>${findings.length ? findings.map((f) => `<li><code>${esc(f.ruleId)}</code> ${f.caseId ? `<strong>${esc(f.caseId)}</strong> ` : ""}${esc(f.detail)}</li>`).join("") : "<li>未发现问题。</li>"}</ul></main></body></html>`;
+    return { findings, markdown, html };
+}
+export async function writeFrontendCaseQualityReports(input) {
+    const result = await validateFrontendCaseContent(input);
+    const dir = path.join(input.workspaceRoot, input.outputDir ?? "testcase/frontend/reports");
+    await mkdir(dir, { recursive: true });
+    await writeFile(path.join(dir, "frontend-test-case-quality-advisory.md"), result.markdown, "utf8");
+    await writeFile(path.join(dir, "frontend-test-case-quality-advisory.html"), result.html, "utf8");
+    return result;
+}

package/dist/workflows/dag/frontend-test-html-report.js

@@ -0,0 +1,174 @@
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { frontendTestResultContractSchema } from "./frontend-test-result-contract.js";
+function escapeHtml(value) {
+    return String(value ?? "").replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+}
+function statusLabel(status) {
+    return status === "passed" ? "通过" : status === "failed" ? "失败" : "阻塞";
+}
+function statusColor(status) {
+    return status === "passed"
+        ? { fg: "#067647", bg: "#ecfdf3", border: "#abefc6" }
+        : status === "failed"
+            ? { fg: "#b42318", bg: "#fef3f2", border: "#fda29b" }
+            : { fg: "#946200", bg: "#fffaeb", border: "#fedf89" };
+}
+function listMarkdown(items) {
+    return items.length ? items.map((item, index) => `${index + 1}. ${item}`).join("\n") : "- 无";
+}
+function listHtml(items) {
+    return items.length ? `<ol>${items.map((item) => `<li>${escapeHtml(item)}</li>`).join("")}</ol>` : `<p class="muted">无</p>`;
+}
+function writeMetric(label, value, color = "#172033") {
+    return `<div class="metric"><span>${escapeHtml(label)}</span><strong style="color:${color}">${escapeHtml(value)}</strong></div>`;
+}
+function renderCaseCard(item) {
+    const colors = statusColor(item.status);
+    const rerun = typeof item.rerunAttempt === "number" && item.rerunAttempt > 0
+        ? `<span class="badge" style="color:#175cd3;background:#eff8ff">重跑 ${item.rerunAttempt}</span>`
+        : "";
+    const error = item.status === "passed"
+        ? ""
+        : `<div class="error-box"><strong>原因分析</strong><p>${escapeHtml(item.errorAnalysis ?? item.blockedReason ?? "用例未能完成执行。")}</p></div>`;
+    const testPoints = item.testPoints ?? [];
+    const executionSummary = item.executionSummary ?? "";
+    const executionSteps = item.executionSteps ?? [];
+    const hasExecution = executionSummary.trim().length > 0 || executionSteps.length > 0;
+    const execution = !hasExecution
+        ? ""
+        : `<div class="execution-box"><strong>执行记录</strong>${executionSummary.trim().length > 0
+            ? `<p>${escapeHtml(executionSummary)}</p>`
+            : ""}${executionSteps.length > 0
+            ? listHtml(executionSteps)
+            : ""}</div>`;
+    const testPointsHtml = testPoints.length
+        ? `<div><h3>测试点</h3>${listHtml(testPoints)}</div>`
+        : "";
+    return `<details class="case-card" data-status="${item.status}" ${item.status !== "passed" ? "open" : ""}>
+    <summary><span class="case-id">${escapeHtml(item.caseId)}</span><span class="case-title">${escapeHtml(item.caseContent.purpose || "未提供测试目的")}</span><span class="badge" style="color:${colors.fg};background:${colors.bg}">${statusLabel(item.status)}</span>${rerun}<span class="chevron">▾</span></summary>
+    <div class="case-body">
+      <div class="case-meta"><span>验收标准</span><strong>${item.acIds.map(escapeHtml).join("、") || "—"}</strong></div>
+      <div class="case-grid">
+        <div><h3>测试目的</h3><p>${escapeHtml(item.caseContent.purpose)}</p></div>
+        ${testPointsHtml}
+        <div><h3>前置条件</h3>${listHtml(item.caseContent.preconditions)}</div>
+        <div><h3>测试步骤</h3>${listHtml(item.caseContent.steps)}</div>
+        <div><h3>预期结果</h3>${listHtml(item.caseContent.expectedResults)}</div>
+      </div>
+      ${execution}
+      ${error}
+    </div>
+  </details>`;
+}
+async function writePairAtomic(markdownPath, markdown, htmlPath, html) {
+    await mkdir(path.dirname(markdownPath), { recursive: true });
+    const nonce = `${process.pid}-${Date.now()}`;
+    const markdownTemp = `${markdownPath}.${nonce}.tmp`;
+    const htmlTemp = `${htmlPath}.${nonce}.tmp`;
+    try {
+        await writeFile(markdownTemp, markdown, "utf8");
+        await writeFile(htmlTemp, html, "utf8");
+        await rename(markdownTemp, markdownPath);
+        await rename(htmlTemp, htmlPath);
+    }
+    finally {
+        await rm(markdownTemp, { force: true });
+        await rm(htmlTemp, { force: true });
+    }
+}
+export async function renderFrontendTestHtmlReport(input) {
+    const resultPath = path.join(input.runDir, "contracts", "frontend-test-result.json");
+    const result = frontendTestResultContractSchema.parse(JSON.parse(await readFile(resultPath, "utf8")));
+    const outputDir = path.join(input.workspaceRoot, "testcase", "frontend", "reports");
+    const markdownPath = path.join(outputDir, "frontend-test-report.md");
+    const htmlPath = path.join(outputDir, "frontend-test-report.html");
+    const outcomeLabel = result.outcome === "passed" ? "测试通过" : result.outcome === "failed" ? "测试失败" : "测试未完成";
+    const failedCount = result.totals.failed + result.totals.blocked;
+    const passRate = result.totals.cases > 0 ? (result.totals.passed / result.totals.cases) * 100 : 0;
+    const coverageRate = result.sourceBinding.requirementIds.length > 0
+        ? (result.acceptanceCoverage.covered.length / result.sourceBinding.requirementIds.length) * 100
+        : 0;
+    const outcomeColors = result.outcome === "passed" ? statusColor("passed") : result.outcome === "failed" ? statusColor("failed") : statusColor("blocked");
+    const markdownCases = result.cases.map((item) => {
+        const testPoints = item.testPoints ?? [];
+        const executionSummary = item.executionSummary ?? "";
+        const executionSteps = item.executionSteps ?? [];
+        return [
+            `## ${item.caseId}`,
+            "",
+            `- 执行结果：${statusLabel(item.status)}`,
+            `- 验收标准：${item.acIds.join("、")}`,
+            ...(typeof item.rerunAttempt === "number" && item.rerunAttempt > 0
+                ? [`- 重跑次数：${item.rerunAttempt}`]
+                : []),
+            "",
+            "### 测试目的", "", item.caseContent.purpose,
+            ...(testPoints.length ? ["", "### 测试点", "", listMarkdown(testPoints)] : []),
+            "", "### 前置条件", "", listMarkdown(item.caseContent.preconditions),
+            "", "### 测试步骤", "", listMarkdown(item.caseContent.steps),
+            "", "### 预期结果", "", listMarkdown(item.caseContent.expectedResults),
+            ...(executionSummary.trim().length || executionSteps.length
+                ? ["", "### 执行记录", "", executionSummary.trim(), ...(executionSteps.length ? ["", listMarkdown(executionSteps)] : [])]
+                : []),
+            ...(item.status === "passed" ? [] : ["", "### 错误分析", "", item.errorAnalysis ?? item.blockedReason ?? "用例未能完成执行。"]),
+        ];
+    }).map((lines) => lines.filter((line) => line !== undefined).join("\n")).join("\n\n");
+    const markdown = [
+        "# 前端功能测试报告", "",
+        `- 测试结论：${outcomeLabel}`,
+        `- 用例总数：${result.totals.cases}`,
+        `- 通过：${result.totals.passed}`,
+        `- 失败：${result.totals.failed}`,
+        `- 阻塞：${result.totals.blocked}`,
+        `- AC 覆盖：${result.acceptanceCoverage.covered.length}/${result.sourceBinding.requirementIds.length}`,
+        "", markdownCases, "",
+    ].join("\n");
+    const caseCards = result.cases.map(renderCaseCard).join("");
+    const missingAc = result.acceptanceCoverage.missing.length
+        ? `<div class="finding-list"><strong>未覆盖 AC</strong>${listHtml(result.acceptanceCoverage.missing)}</div>`
+        : `<div class="success-note">全部声明的 AC 均已覆盖。</div>`;
+    const failureOverview = failedCount > 0
+        ? `<section class="panel"><div class="section-heading"><h2>失败概览</h2><span>${failedCount} 条未通过用例</span></div><div class="failure-list">${result.cases.filter((item) => item.status !== "passed").map((item) => `<div class="failure-row"><span class="case-id">${escapeHtml(item.caseId)}</span><span>${escapeHtml(item.errorAnalysis ?? item.blockedReason ?? "用例未能完成执行。")}</span></div>`).join("")}</div></section>`
+        : "";
+    const html = `<!doctype html><html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta http-equiv="Content-Security-Policy" content="default-src 'none'; style-src 'unsafe-inline'"><title>前端功能测试报告</title><style>
+body{margin:0;background:radial-gradient(circle at 8% 0,#edf4ff 0,transparent 36rem),#f5f7fb;color:#17243b;font:15px/1.6 Inter,system-ui,-apple-system,BlinkMacSystemFont,'Segoe UI','Microsoft YaHei',sans-serif}main{max-width:1180px;margin:0 auto;padding:42px 28px 72px}.hero{padding:30px 34px;border:1px solid #294b78;border-radius:24px;background:linear-gradient(125deg,#102849 0%,#173d6d 57%,#245b91 100%);box-shadow:0 18px 40px rgba(16,40,73,.18);display:flex;align-items:flex-start;justify-content:space-between;gap:28px}.eyebrow{color:#9fc6ee;font-size:11px;font-weight:800;letter-spacing:.2em}.hero h1{margin:10px 0 8px;color:#f7fbff;font-size:clamp(28px,3.8vw,44px);line-height:1.1}.hero p{margin:0;color:#bdd2e9;font-size:13px}.decision{min-width:190px;padding:15px 17px;border:1px solid ${outcomeColors.border};border-radius:16px;background:${outcomeColors.bg};color:${outcomeColors.fg}}.decision strong{display:block;font-size:17px}.decision span{display:block;margin-top:4px;font-size:12px}.panel{background:#fff;border:1px solid #e0e7f0;border-radius:15px;box-shadow:0 7px 20px rgba(25,53,92,.04);padding:22px;margin-top:18px}.metrics{display:grid;grid-template-columns:repeat(5,1fr);gap:12px;margin-top:18px}.metric{position:relative;min-height:92px;padding:17px 18px;background:#fff;border:1px solid #e1e8f2;border-radius:13px}.metric:before{content:'';position:absolute;top:0;left:0;right:0;height:3px;background:#4775ef;border-radius:13px 13px 0 0}.metric span{display:block;color:#748198;font-size:12px}.metric strong{display:block;margin-top:12px;font-size:28px;line-height:1;font-weight:800}.section-heading{display:flex;align-items:baseline;justify-content:space-between;gap:12px;margin-bottom:12px}.section-heading h2{margin:0;color:#17365d;font-size:19px}.section-heading span{color:#718097;font-size:12px}.signal-grid{display:grid;grid-template-columns:1fr 1fr;gap:12px}.signal{padding:14px;border:1px solid #e4e9f1;border-radius:11px;background:#fbfcfe}.signal header{display:flex;justify-content:space-between;color:#2a3c5a;font-size:12px}.bar{height:7px;margin:10px 0 6px;background:#edf1f6;border-radius:99px;overflow:hidden}.bar i{display:block;height:100%;border-radius:inherit}.signal small{color:#718097;font-size:11px}.case-card{border:1px solid #e4e9f1;border-radius:13px;background:#fff;overflow:hidden;margin-top:10px}.case-card summary{display:flex;align-items:center;gap:12px;padding:14px 16px;cursor:pointer;list-style:none}.case-card summary::-webkit-details-marker{display:none}.case-id{color:#2b3a55;font:700 12px ui-monospace,SFMono-Regular,Menlo,monospace;white-space:nowrap}.case-title{flex:1;min-width:0;color:#172033;font-weight:650;overflow:hidden;text-overflow:ellipsis}.badge{padding:3px 10px;border-radius:999px;font-size:11px;font-weight:800;white-space:nowrap}.chevron{color:#aab2bf}.case-body{padding:3px 16px 17px;border-top:1px solid #f0f3f7}.case-meta{margin-top:12px;padding:9px 11px;background:#f6f8fa;border-radius:8px;color:#667085;font-size:11px}.case-meta strong{margin-left:8px;color:#344054}.case-grid{display:grid;grid-template-columns:1fr 1fr;gap:10px;margin-top:13px}.case-grid>div{padding:11px 12px;border:1px solid #edf0f4;border-radius:9px;background:#fbfcfe}.case-grid h3{margin:0 0 5px;color:#667085;font-size:11px}.case-grid p,.case-grid ol{margin:0;color:#475467;font-size:13px}.case-grid ol{padding-left:20px}.muted{color:#98a2b3!important}.error-box{margin-top:13px;padding:11px 13px;border:1px solid #fda29b;border-radius:9px;background:#fef3f2;color:#b42318}.execution-box{margin-top:13px;padding:11px 13px;border:1px solid #b9d6f5;border-radius:9px;background:#f5f9ff;color:#1f4e79}.execution-box strong{font-size:12px}.execution-box p{margin:4px 0 0;white-space:pre-wrap;font-size:13px}.execution-box ol{margin:6px 0 0;padding-left:20px;color:#28456b;font-size:13px}.error-box strong{font-size:12px}.error-box p{margin:4px 0 0;white-space:pre-wrap;font-size:13px}.failure-list{display:grid;gap:9px}.failure-row{display:flex;align-items:baseline;gap:12px;padding:10px 12px;border-left:4px solid #d34661;border-radius:8px;background:#fff8f9;color:#475467;font-size:13px}.success-note{padding:11px 13px;border-radius:9px;background:#ecfdf3;color:#067647;font-size:13px}.finding-list{padding:11px 13px;border-radius:9px;background:#fffaeb;color:#946200;font-size:13px}.finding-list ol{margin:5px 0 0;padding-left:20px}@media(max-width:850px){.hero{display:block}.decision{margin-top:20px;min-width:0}.metrics{grid-template-columns:repeat(2,1fr)}.signal-grid,.case-grid{grid-template-columns:1fr}}@media(max-width:520px){main{padding:22px 14px 42px}.metrics{grid-template-columns:1fr}.case-card summary{flex-wrap:wrap}.case-title{order:3;flex-basis:100%}}
+
+.filter-bar{display:flex;flex-wrap:wrap;gap:8px;align-items:center;margin:12px 0 16px}
+.filter-label{font-size:13px;color:#475467}
+.filter-btn{border:1px solid #d0d5dd;background:#fff;border-radius:999px;padding:6px 12px;cursor:pointer;font-size:13px}
+.filter-btn.active{background:#eff8ff;border-color:#84caff;color:#175cd3}
+.case-card[hidden]{display:none !important}
+</style></head><body><main>
+<header class="hero"><div><div class="eyebrow">FRONTEND TEST · EXECUTION VIEW</div><h1>前端功能测试报告</h1><p>基于本轮 frontend-test DAG 的真实用例结果生成；用例默认折叠，点击任意用例查看测试内容与失败分析。</p></div><div class="decision"><strong>${outcomeLabel}</strong><span>${failedCount > 0 ? `${failedCount} 条用例未通过` : `${result.totals.passed} 条用例全部执行成功`}</span></div></header>
+<section class="filter-bar" id="status-filter">
+  <span class="filter-label">按状态过滤</span>
+  <button type="button" class="filter-btn active" data-filter="all">全部</button>
+  <button type="button" class="filter-btn" data-filter="passed">通过</button>
+  <button type="button" class="filter-btn" data-filter="failed">失败</button>
+  <button type="button" class="filter-btn" data-filter="blocked">阻塞</button>
+</section>
+<section class="metrics">${writeMetric("用例总数", result.totals.cases)}${writeMetric("通过", result.totals.passed, "#067647")}${writeMetric("失败", result.totals.failed, result.totals.failed ? "#b42318" : "#172033")}${writeMetric("阻塞", result.totals.blocked, result.totals.blocked ? "#946200" : "#172033")}${writeMetric("通过率", `${passRate.toFixed(2)}%`, passRate === 100 ? "#067647" : "#b42318")}</section>
+<section class="panel"><div class="section-heading"><h2>质量信号</h2><span>需求覆盖与执行结果</span></div><div class="signal-grid"><div class="signal"><header><span>AC 验收覆盖</span><strong>${coverageRate.toFixed(2)}%</strong></header><div class="bar"><i style="width:${Math.min(coverageRate, 100)}%;background:${coverageRate >= 100 ? "#15815c" : "#4775ef"}"></i></div><small>${result.acceptanceCoverage.covered.length} / ${result.sourceBinding.requirementIds.length} · 目标 100%</small></div><div class="signal"><header><span>集成模式</span><strong>${result.integrationMode === "real" ? "真实联调" : "未联调"}</strong></header><div class="bar"><i style="width:${result.integrationMode === "real" ? 100 : 0}%;background:#15815c"></i></div><small>${result.integrationMode === "real" ? "已执行真实后端调用" : "本轮未证明真实后端已联通"}</small></div></div>${missingAc}</section>
+${failureOverview}<section class="panel"><div class="section-heading"><h2>用例执行明细</h2><span>共 ${result.cases.length} 条 · 点击展开</span></div>${caseCards || "<div class=muted>未发现可展示的用例。</div>"}</section>
+</main>
+<script>
+(function(){
+  var bar=document.getElementById('status-filter');
+  if(!bar) return;
+  bar.addEventListener('click', function(ev){
+    var btn=ev.target.closest('[data-filter]');
+    if(!btn) return;
+    var filter=btn.getAttribute('data-filter')||'all';
+    bar.querySelectorAll('.filter-btn').forEach(function(b){ b.classList.toggle('active', b===btn); });
+    document.querySelectorAll('.case-card[data-status]').forEach(function(card){
+      var st=card.getAttribute('data-status');
+      card.hidden = !(filter==='all' || st===filter);
+    });
+  });
+})();
+</script>
+</body></html>`;
+    await writePairAtomic(markdownPath, markdown, htmlPath, html);
+    return { markdownPath, htmlPath, outcome: result.outcome, caseCount: result.cases.length };
+}

package/dist/workflows/dag/frontend-test-l5-report.js

@@ -0,0 +1,177 @@
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { frontendTestResultContractSchema, } from "./frontend-test-result-contract.js";
+function ratioMetric(numerator, denominator, threshold, label) {
+    if (denominator === 0) {
+        return { numerator, denominator, ratio: null, threshold, status: "unavailable", reason: `${label}-denominator-is-zero` };
+    }
+    const ratio = numerator / denominator;
+    return {
+        numerator,
+        denominator,
+        ratio,
+        threshold,
+        status: ratio >= threshold ? "pass" : "fail",
+        reason: ratio >= threshold ? null : `${label}-below-threshold`,
+    };
+}
+function unavailable(reason, threshold) {
+    return { numerator: null, denominator: null, ratio: null, threshold, status: "unavailable", reason };
+}
+/** Compute the shared L-5 gates from the authoritative frontend result contract. */
+export function computeFrontendL5ReportMetrics(result) {
+    const executed = result.totals.passed + result.totals.failed;
+    const acTotal = result.acceptanceCoverage.covered.length + result.acceptanceCoverage.missing.length;
+    const automationExecuted = executed;
+    const criticalRiskCount = result.acceptanceCoverage.missing.length + result.advisoryFindings.filter((finding) => /critical|blocking|unsafe|missing-ac/i.test(finding.ruleId)).length;
+    const metrics = {
+        passRate: ratioMetric(result.totals.passed, executed, 1, "pass-rate"),
+        acCoverage: ratioMetric(result.acceptanceCoverage.covered.length, acTotal, 1, "ac-coverage"),
+        automationCoverage: ratioMetric(automationExecuted, result.totals.cases, 0.9, "automation-coverage"),
+        lineCoverage: unavailable("frontend-code-coverage-missing", 0.8),
+        branchCoverage: unavailable("frontend-code-coverage-missing", 0.7),
+        skipped: {
+            numerator: result.totals.blocked,
+            denominator: result.totals.blocked,
+            ratio: result.totals.blocked === 0 ? 1 : 0,
+            threshold: 1,
+            status: result.totals.blocked === 0 ? "pass" : "fail",
+            reason: result.totals.blocked === 0 ? null : "skipped-tests-present",
+        },
+        criticalRisks: {
+            numerator: criticalRiskCount,
+            denominator: criticalRiskCount,
+            ratio: criticalRiskCount === 0 ? 1 : 0,
+            threshold: 1,
+            status: criticalRiskCount === 0 ? "pass" : "fail",
+            reason: criticalRiskCount === 0 ? null : "critical-risk-present",
+        },
+    };
+    const blockingItems = Object.entries(metrics)
+        .filter(([, metric]) => metric.status !== "pass")
+        .map(([name, metric]) => `${name}:${metric.reason ?? metric.status}`);
+    return {
+        status: blockingItems.length === 0 ? "ready" : "not-ready",
+        metrics,
+        blockingItems,
+    };
+}
+function escapeHtml(value) {
+    return String(value ?? "")
+        .replaceAll("&", "&")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&#39;");
+}
+function metricValue(metric) {
+    if (metric.ratio === null)
+        return "unavailable";
+    return `${(metric.ratio * 100).toFixed(1)}%`;
+}
+function metricRow(label, metric) {
+    return `| ${label} | ${metric.numerator ?? "-"} / ${metric.denominator ?? "-"} | ${metricValue(metric)} | ${metric.status.toUpperCase()} | ${metric.reason ?? "-"} |`;
+}
+function renderMarkdown(result, metrics) {
+    const m = metrics.metrics;
+    return [
+        "# 前端测试 L-5 报告",
+        "",
+        `- L-5 结论：**${metrics.status === "ready" ? "READY" : "NOT READY"}**`,
+        `- Result v1 outcome：${result.outcome}`,
+        "",
+        "| 指标 | 分子 / 分母 | 比例 | 状态 | 原因 |",
+        "| --- | ---: | ---: | --- | --- |",
+        metricRow("测试通过率", m.passRate),
+        metricRow("AC 验收覆盖", m.acCoverage),
+        metricRow("自动化覆盖率", m.automationCoverage),
+        metricRow("Line 代码覆盖", m.lineCoverage),
+        metricRow("Branch 代码覆盖", m.branchCoverage),
+        metricRow("阻塞/跳过用例", m.skipped),
+        metricRow("Critical 风险", m.criticalRisks),
+        "",
+        "## 判定规则",
+        "",
+        "测试通过率=100%、AC 覆盖=100%、自动化覆盖率≥90%、Line≥80%、Branch≥70%、阻塞/跳过=0 且无 Critical 风险时才为 READY。",
+        "前端 DAG 当前没有可信的 line/branch 代码覆盖产物，因此这两项保持 unavailable，不得推断。",
+        "",
+        "## 阻塞项",
+        "",
+        ...(metrics.blockingItems.length ? metrics.blockingItems.map((item) => `- ${item}`) : ["- 无"]),
+        "",
+    ].join("\n");
+}
+function renderHtml(result, metrics) {
+    const m = metrics.metrics;
+    const decision = metrics.status === "ready"
+        ? { text: "READY", color: "#15815c", bg: "rgba(21,129,92,.12)", border: "rgba(120,200,170,.4)", small: "所有 L-5 门禁达标" }
+        : { text: "NOT READY", color: "#d34661", bg: "rgba(211,70,97,.12)", border: "rgba(255,177,192,.4)", small: `${metrics.blockingItems.length} 个阻断项需要处理` };
+    const executed = result.totals.passed + result.totals.failed;
+    const passRate = m.passRate.ratio === null ? "—" : `${(m.passRate.ratio * 100).toFixed(2)}%`;
+    const acRate = m.acCoverage.ratio === null ? "—" : `${(m.acCoverage.ratio * 100).toFixed(2)}%`;
+    const automationRate = m.automationCoverage.ratio === null ? "—" : `${(m.automationCoverage.ratio * 100).toFixed(2)}%`;
+    const circ = 2 * Math.PI * 46;
+    const passLen = executed > 0 ? (result.totals.passed / executed) * circ : 0;
+    const failLen = executed > 0 ? (result.totals.failed / executed) * circ : 0;
+    const statusColor = (status) => status === "pass" ? "#15815c" : status === "fail" ? "#d34661" : "#c87918";
+    const statusBg = (status) => status === "pass" ? "#e7f7f0" : status === "fail" ? "#fff0f3" : "#fff7e8";
+    const gate = (label, metric, value, target, detail, evidence = "") => {
+        const color = statusColor(metric.status);
+        const width = metric.ratio === null ? 0 : Math.min(100, metric.ratio * 100);
+        const statusLabel = metric.status === "unavailable" ? "不可用" : metric.status === "pass" ? "达标" : "未达标";
+        const evidenceBlock = evidence
+            ? `<details style="margin-top:10px;padding-top:9px;border-top:1px solid #e5ebf3"><summary style="color:#4775ef;font-size:12px;font-weight:750;cursor:pointer;list-style:none">查看依据</summary><div style="margin-top:7px;color:#718097;font-size:12px">${evidence}</div></details>`
+            : "";
+        return `<div style="padding:14px 15px;border:1px solid #e5ebf3;border-radius:11px;background:#fcfdff;margin-top:8px"><div style="display:flex;align-items:center;gap:10px"><span style="flex:1;color:#263c5e;font-size:13px;font-weight:750">${escapeHtml(label)}</span><strong style="color:${color};font-size:15px">${escapeHtml(value)}</strong><span style="padding:3px 9px;border-radius:999px;color:${color};background:${statusBg(metric.status)};font-size:11px;font-weight:800">${statusLabel}</span></div><div style="height:6px;margin:10px 0 7px;background:#e7edf5;border-radius:99px;overflow:hidden"><i style="display:block;height:100%;width:${width}%;border-radius:inherit;background:${color}"></i></div><div style="display:flex;justify-content:space-between;color:#718097;font-size:12px"><span>${escapeHtml(detail)}</span><span>${escapeHtml(target)}</span></div>${evidenceBlock}</div>`;
+    };
+    const cases = result.cases.length > 0
+        ? result.cases.map((item) => {
+            const passed = item.status === "passed";
+            const color = passed ? "#15815c" : item.status === "blocked" ? "#c87918" : "#d34661";
+            const bg = passed ? "#e7f7f0" : item.status === "blocked" ? "#fff7e8" : "#fff0f3";
+            return `<details style="border:1px solid ${passed ? "#d7ece2" : "#ecd4d9"};border-radius:13px;background:${passed ? "#fbfffd" : "#fffdfd"};overflow:hidden;margin-top:10px"${passed ? "" : " open"}><summary style="display:flex;align-items:center;gap:10px;padding:15px;cursor:pointer;list-style:none"><span style="color:#17365d;font:700 12px ui-monospace,SFMono-Regular,Menlo,monospace">${escapeHtml(item.caseId)}</span><span style="flex:1;color:#17365d;font-size:14px;font-weight:750">${escapeHtml(item.caseContent.purpose)}</span><span style="padding:3px 9px;border-radius:999px;color:${color};background:${bg};font-size:11px;font-weight:800">${escapeHtml(item.status.toUpperCase())}</span></summary><div style="padding:0 15px 15px;border-top:1px solid #edf1f6"><div style="display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:9px;margin-top:14px"><div style="padding:9px 10px;border-radius:8px;background:#f6f8fa"><label style="display:block;color:#718097;font-size:11px">AC 映射</label><span style="display:block;margin-top:2px;color:#172033;font-size:12px;font-weight:650">${escapeHtml(item.acIds.join(", ") || "未关联")}</span></div><div style="padding:9px 10px;border-radius:8px;background:#f6f8fa"><label style="display:block;color:#718097;font-size:11px">浏览器证据</label><span style="display:block;margin-top:2px;color:#172033;font-size:12px;font-weight:650">${item.evidence.length} 条</span></div></div></div></details>`;
+        }).join("")
+        : `<div style="color:#718097;font-size:13px">无用例执行数据</div>`;
+    const blocking = metrics.blockingItems.length > 0
+        ? metrics.blockingItems.map((item) => `<li style="margin:6px 0">${escapeHtml(item)}</li>`).join("")
+        : "<li>无阻断项</li>";
+    return `<!doctype html><html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta http-equiv="Content-Security-Policy" content="default-src 'none';style-src 'unsafe-inline'"><title>前端测试 · L-5</title><style>summary::-webkit-details-marker{display:none}@media(max-width:760px){.hero,.split,.gates{grid-template-columns:1fr!important}.kpis{grid-template-columns:repeat(2,1fr)!important}}@media(max-width:480px){.page{padding:24px 14px!important}.kpis{grid-template-columns:1fr!important}.hero-header{flex-direction:column!important}.case-meta{grid-template-columns:1fr!important}}</style></head><body style="margin:0;background:radial-gradient(circle at 8% 0,#edf4ff 0,transparent 36rem),#f5f7fb;color:#17243b;font:15px/1.6 Inter,system-ui,-apple-system,BlinkMacSystemFont,'Segoe UI','Microsoft YaHei',sans-serif"><div class="page" style="max-width:1180px;margin:0 auto;padding:42px 28px 72px">
+    <header class="hero-header" style="position:relative;overflow:hidden;padding:34px 38px;border:1px solid #294b78;border-radius:26px;background:linear-gradient(125deg,#102849 0%,#173d6d 57%,#245b91 100%);box-shadow:0 18px 40px rgba(16,40,73,.18);display:flex;align-items:flex-start;justify-content:space-between;gap:28px"><div><div style="color:#9fc6ee;font-size:11px;font-weight:800;letter-spacing:.2em">FRONTEND TEST · L-5 QUALITY VIEW</div><h1 style="margin:12px 0 10px;color:#f7fbff;font-size:clamp(30px,3.8vw,46px);font-weight:800;letter-spacing:-.055em;line-height:1.1">前端测试 L-5 报告</h1><p style="color:#bdd2e9;font-size:13px;margin:0">${escapeHtml(result.sourceBinding.taskId)} · ${result.totals.cases} 个用例</p></div><div style="min-width:220px;padding:16px 18px;border:1px solid ${decision.border};border-radius:18px;background:${decision.bg};box-shadow:0 8px 24px rgba(0,0,0,.08)"><div style="display:flex;align-items:center;gap:9px;color:${decision.color};font-size:17px;font-weight:800"><i style="width:11px;height:11px;border-radius:50%;background:${decision.color};box-shadow:0 0 0 5px ${decision.color}1a;display:inline-block"></i>L-5 ${decision.text}</div><small style="display:block;margin:7px 0 0 20px;color:${decision.color};opacity:.85;font-size:12px">${decision.small}</small></div></header>
+    <section class="kpis" style="display:grid;grid-template-columns:repeat(4,1fr);gap:14px;margin-top:18px">
+      ${[["测试通过率", passRate, `${result.totals.passed} / ${executed} · 目标 100%`, "#4775ef"], ["AC 验收覆盖", acRate, `${m.acCoverage.numerator ?? "—"} / ${m.acCoverage.denominator ?? "—"} · 目标 100%`, "#c87918"], ["自动化覆盖率", automationRate, `${m.automationCoverage.numerator ?? "—"} / ${m.automationCoverage.denominator ?? "—"} · 目标 ≥90%`, "#7589d9"], ["Critical 风险", String(m.criticalRisks.numerator ?? 0), m.criticalRisks.status === "pass" ? "无阻断项" : "阻断级风险", m.criticalRisks.status === "pass" ? "#15815c" : "#d34661"]].map(([label, value, foot, color]) => `<div style="position:relative;min-height:132px;padding:21px 22px;overflow:hidden;background:#fff;border:1px solid #e1e8f2;border-radius:15px;box-shadow:0 6px 18px rgba(25,53,92,.045)"><i style="position:absolute;top:0;left:0;right:0;height:3px;background:${color};display:block"></i><div style="color:#748198;font-size:13px;font-weight:650">${label}</div><div style="margin-top:19px;color:#13213a;font-size:35px;font-weight:800;letter-spacing:-.06em;line-height:1">${value}</div><div style="margin-top:9px;color:${color};font-size:12px">${foot}</div></div>`).join("")}
+    </section>
+    <section class="split" style="display:grid;grid-template-columns:1fr 1.35fr;gap:12px;margin-top:18px">
+      <div style="padding:20px 22px;border:1px solid #dfe7f1;border-radius:15px;background:rgba(255,255,255,.82);box-shadow:0 7px 20px rgba(25,53,92,.04)"><div><span style="color:#8796aa;font-size:10px;font-weight:800;letter-spacing:.16em">RUN OUTCOME</span><h2 style="margin:3px 0 0;color:#17365d;font-size:17px">本轮执行结果</h2></div><div style="position:relative;display:flex;align-items:center;gap:20px;margin-top:15px"><svg viewBox="0 0 120 120" style="width:116px;height:116px;flex:0 0 116px;transform:rotate(-90deg)" aria-label="${result.totals.passed} 通过，${result.totals.failed} 失败"><circle cx="60" cy="60" r="46" fill="none" stroke="#edf1f6" stroke-width="12"></circle><circle cx="60" cy="60" r="46" fill="none" stroke="#15815c" stroke-width="12" stroke-dasharray="${passLen.toFixed(2)} ${circ.toFixed(2)}" stroke-linecap="round"></circle><circle cx="60" cy="60" r="46" fill="none" stroke="#d34661" stroke-width="12" stroke-dasharray="${failLen.toFixed(2)} ${circ.toFixed(2)}" stroke-dashoffset="${(-passLen).toFixed(2)}"></circle></svg><div style="position:absolute;display:flex;width:116px;height:116px;flex-direction:column;align-items:center;justify-content:center;pointer-events:none"><strong style="color:#17365d;font-size:20px">${passRate}</strong><span style="color:#718097;font-size:10px">通过率</span></div><div style="display:grid;gap:6px;flex:1"><div style="color:#718097;font-size:12px">通过 <strong style="float:right;color:#17243b">${result.totals.passed}</strong></div><div style="color:#718097;font-size:12px">失败 <strong style="float:right;color:#17243b">${result.totals.failed}</strong></div><div style="color:#718097;font-size:12px">阻塞 <strong style="float:right;color:#17243b">${result.totals.blocked}</strong></div></div></div></div>
+      <div style="padding:20px 22px;border:1px solid #dfe7f1;border-radius:15px;background:rgba(255,255,255,.82);box-shadow:0 7px 20px rgba(25,53,92,.04)"><div style="display:flex;align-items:flex-start;justify-content:space-between;gap:16px"><div><span style="color:#8796aa;font-size:10px;font-weight:800;letter-spacing:.16em">QUALITY SIGNALS</span><h2 style="margin:3px 0 0;color:#17365d;font-size:17px">质量信号</h2></div><span style="color:#718097;font-size:11px">按 L-5 门槛判定</span></div>${gate("测试通过率", m.passRate, passRate, "目标 100%", `${result.totals.passed} / ${executed} 个已执行用例`, `失败 ${result.totals.failed}，阻塞 ${result.totals.blocked}。<code style="color:#17365d;font:11px ui-monospace,SFMono-Regular,Menlo,monospace">frontend-test-result-v1</code>`)}${gate("AC 验收覆盖", m.acCoverage, acRate, "目标 100%", `${m.acCoverage.numerator ?? "—"} / ${m.acCoverage.denominator ?? "—"}`, "来自 frontend-test-result-v1 acceptanceCoverage")}${gate("自动化覆盖率", m.automationCoverage, automationRate, "目标 ≥90%", `${m.automationCoverage.numerator ?? "—"} / ${m.automationCoverage.denominator ?? "—"}`, "由已执行 Case 与总 Case 确定性计算")}${gate("用例跳过数", m.skipped, String(result.totals.blocked), "目标 0", `${result.totals.blocked} / ${result.totals.cases}`, m.skipped.reason ?? "无阻塞用例")}${gate("Line 代码覆盖", m.lineCoverage, m.lineCoverage.ratio === null ? "—" : metricValue(m.lineCoverage), "目标 ≥80%", m.lineCoverage.reason ?? "validated coverage artifact", "前端测试当前未提供可信代码覆盖产物")}${gate("Branch 代码覆盖", m.branchCoverage, m.branchCoverage.ratio === null ? "—" : metricValue(m.branchCoverage), "目标 ≥70%", m.branchCoverage.reason ?? "validated coverage artifact", "前端测试当前未提供可信代码覆盖产物")}</div>
+    </section>
+    <section class="gates" style="display:grid;grid-template-columns:1.28fr .86fr;gap:20px;margin-top:20px"><div style="background:#fff;border:1px solid #e0e7f0;border-radius:15px;box-shadow:0 7px 20px rgba(25,53,92,.04);padding:22px"><div style="display:flex;align-items:center;justify-content:space-between;gap:14px;margin-bottom:18px"><h2 style="margin:0;color:#17365d;font-size:19px">L-5 门禁摘要</h2><span style="color:#718097;font-size:13px">阻断项与执行门槛</span></div>${gate("测试通过率", m.passRate, passRate, "目标 100%", `${result.totals.passed} / ${executed}`, `失败 ${result.totals.failed}，阻塞 ${result.totals.blocked}。<code style="color:#17365d;font:11px ui-monospace,SFMono-Regular,Menlo,monospace">frontend-test-result-v1</code>`)}${gate("AC 验收覆盖", m.acCoverage, acRate, "目标 100%", `${m.acCoverage.numerator ?? "—"} / ${m.acCoverage.denominator ?? "—"}`, "来自 frontend-test-result-v1 acceptanceCoverage")}${gate("自动化覆盖率", m.automationCoverage, automationRate, "目标 ≥90%", `${m.automationCoverage.numerator ?? "—"} / ${m.automationCoverage.denominator ?? "—"}`, "由已执行 Case 与总 Case 确定性计算")}${gate("阻塞/跳过用例", m.skipped, String(result.totals.blocked), "目标 0", `${result.totals.blocked} / ${result.totals.cases}`, m.skipped.reason ?? "无阻塞用例")}${gate("Line 代码覆盖", m.lineCoverage, m.lineCoverage.ratio === null ? "—" : metricValue(m.lineCoverage), "目标 ≥80%", m.lineCoverage.reason ?? "validated coverage artifact", "前端测试当前未提供可信代码覆盖产物")}${gate("Branch 代码覆盖", m.branchCoverage, m.branchCoverage.ratio === null ? "—" : metricValue(m.branchCoverage), "目标 ≥70%", m.branchCoverage.reason ?? "validated coverage artifact", "前端测试当前未提供可信代码覆盖产物")}</div><div style="background:#fff;border:1px solid #e0e7f0;border-radius:15px;box-shadow:0 7px 20px rgba(25,53,92,.04);padding:22px"><div style="display:flex;align-items:center;justify-content:space-between;gap:14px;margin-bottom:18px"><h2 style="margin:0;color:#17365d;font-size:19px">阻断项</h2><span style="color:#718097;font-size:13px">${metrics.blockingItems.length} 条</span></div><ul style="margin:0;padding-left:20px;color:#718097;font-size:12px">${blocking}</ul><div style="margin-top:16px;padding:12px;border-radius:10px;background:#fff7e8;color:#8b641f;font-size:12px">前端 DAG 当前没有可信的 line/branch coverage artifact，必须保持 unavailable，不得推断。</div></div></section>
+    <section style="background:#fff;border:1px solid #e0e7f0;border-radius:15px;box-shadow:0 7px 20px rgba(25,53,92,.04);padding:22px;margin-top:20px"><div style="display:flex;align-items:center;justify-content:space-between;gap:14px;margin-bottom:12px"><h2 style="margin:0;color:#17365d;font-size:19px">用例执行明细</h2><span style="color:#718097;font-size:13px">${result.cases.length} 条 · Result v1</span></div>${cases}</section>
+    <section style="background:#fff;border:1px solid #e0e7f0;border-radius:15px;box-shadow:0 7px 20px rgba(25,53,92,.04);padding:22px;margin-top:20px"><p style="margin:0;color:#718097;font-size:12px">报告由 frontend-test L-5 shell 节点基于 <code style="color:#17365d;font:11px ui-monospace,SFMono-Regular,Menlo,monospace">frontend-test-result-v1</code> 确定性渲染。L-5 判定依据：pass=100%、AC=100%、automation≥90%、line≥80%、branch≥70%、blocked=0 且无阻断级 Critical 风险。</p></section>
+  </div></body></html>`;
+}
+async function writePairAtomic(markdownPath, markdown, htmlPath, html) {
+    await mkdir(path.dirname(markdownPath), { recursive: true });
+    const nonce = `${process.pid}-${Date.now()}`;
+    const markdownTemp = `${markdownPath}.${nonce}.tmp`;
+    const htmlTemp = `${htmlPath}.${nonce}.tmp`;
+    try {
+        await writeFile(markdownTemp, markdown, "utf8");
+        await writeFile(htmlTemp, html, "utf8");
+        await rename(markdownTemp, markdownPath);
+        await rename(htmlTemp, htmlPath);
+    }
+    finally {
+        await rm(markdownTemp, { force: true });
+        await rm(htmlTemp, { force: true });
+    }
+}
+export async function renderFrontendTestL5Report(input) {
+    const resultPath = path.join(input.runDir, "contracts", "frontend-test-result.json");
+    const result = frontendTestResultContractSchema.parse(JSON.parse(await readFile(resultPath, "utf8")));
+    const metrics = computeFrontendL5ReportMetrics(result);
+    const outputDir = path.join(input.workspaceRoot, "testcase", "frontend", "reports");
+    const markdownPath = path.join(outputDir, "frontend-test-l5-dashboard.md");
+    const htmlPath = path.join(outputDir, "frontend-test-l5-dashboard.html");
+    await writePairAtomic(markdownPath, renderMarkdown(result, metrics), htmlPath, renderHtml(result, metrics));
+    return { metrics, markdownPath, htmlPath };
+}