@tea-agent/loop-agent 0.25.4 → 0.25.5

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

@@ -0,0 +1,138 @@
+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 rows = Object.entries(metrics.metrics)
+        .map(([name, metric]) => `<tr><td>${escapeHtml(name)}</td><td>${metric.numerator ?? "-"} / ${metric.denominator ?? "-"}</td><td>${escapeHtml(metricValue(metric))}</td><td class="${metric.status}">${escapeHtml(metric.status.toUpperCase())}</td><td>${escapeHtml(metric.reason ?? "-")}</td></tr>`)
+        .join("");
+    const blocking = metrics.blockingItems.length
+        ? metrics.blockingItems.map((item) => `<li>${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>body{font:15px system-ui,"Microsoft YaHei",sans-serif;background:#f5f7fb;color:#172033;margin:0}main{max-width:1100px;margin:auto;padding:32px}.card{background:#fff;border-radius:14px;padding:24px;margin:16px 0;box-shadow:0 6px 24px #10182812}.decision{font-size:28px;font-weight:800;color:${metrics.status === "ready" ? "#067647" : "#b42318"}}table{width:100%;border-collapse:collapse}th,td{text-align:left;padding:12px;border-bottom:1px solid #e4e7ec}.pass{color:#067647}.fail{color:#b42318}.unavailable{color:#946200}code{font-family:ui-monospace,SFMono-Regular,Menlo,monospace}</style></head><body><main><section class="card"><h1>前端测试 L-5 报告</h1><div class="decision">${metrics.status === "ready" ? "READY" : "NOT READY"}</div><p>Result v1 outcome：<code>${escapeHtml(result.outcome)}</code></p></section><section class="card"><h2>指标</h2><table><thead><tr><th>指标</th><th>分子 / 分母</th><th>比例</th><th>状态</th><th>原因</th></tr></thead><tbody>${rows}</tbody></table></section><section class="card"><h2>阻塞项</h2><ul>${blocking}</ul><p>前端 DAG 当前没有可信的 line/branch 代码覆盖产物，因此这两项为 unavailable，不得推断。</p></section></main></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 };
+}