@tea-agent/loop-agent 0.25.2 → 0.25.4

package/dist/commands/run-dag-progress.js

@@ -0,0 +1,109 @@
+export const DEFAULT_RUN_DAG_PROGRESS_INTERVAL_MS = 30_000;
+function formatDuration(durationMs) {
+    const totalSeconds = Math.max(0, Math.floor(durationMs / 1_000));
+    const hours = Math.floor(totalSeconds / 3_600);
+    const minutes = Math.floor((totalSeconds % 3_600) / 60);
+    const seconds = totalSeconds % 60;
+    if (hours > 0)
+        return `${hours}h${String(minutes).padStart(2, "0")}m`;
+    if (minutes > 0)
+        return `${minutes}m${String(seconds).padStart(2, "0")}s`;
+    return `${seconds}s`;
+}
+function countStatuses(state) {
+    const counts = { finished: 0, running: 0, pending: 0, error: 0, skipped: 0 };
+    for (const node of Object.values(state.nodes)) {
+        if (node.status === "FINISHED")
+            counts.finished += 1;
+        else if (node.status === "RUNNING")
+            counts.running += 1;
+        else if (node.status === "ERROR")
+            counts.error += 1;
+        else if (node.status === "SKIPPED")
+            counts.skipped += 1;
+        else
+            counts.pending += 1;
+    }
+    return `finished=${counts.finished} running=${counts.running} pending=${counts.pending} error=${counts.error} skipped=${counts.skipped}`;
+}
+function nodeElapsedMs(node, now) {
+    const startedAt = node.startedAt ? Date.parse(node.startedAt) : Number.NaN;
+    return Number.isFinite(startedAt) ? Math.max(0, now - startedAt) : 0;
+}
+function activeNodeSummary(state, now) {
+    const running = Object.values(state.nodes).filter((node) => node.status === "RUNNING");
+    if (running.length === 0)
+        return "nodes=none";
+    return running
+        .map((node) => {
+        const details = [
+            `${node.id}(${formatDuration(nodeElapsedMs(node, now))}`,
+            node.livenessStatus ? `liveness=${node.livenessStatus}` : undefined,
+            node.currentAttempt ? `attempt=${node.currentAttempt}` : undefined,
+        ]
+            .filter(Boolean)
+            .join(" ");
+        return `${details})`;
+    })
+        .join(",");
+}
+/**
+ * Human-readable CLI progress written to stderr. The final run-dag JSON remains
+ * the only stdout payload, so machine callers can continue parsing stdout.
+ */
+export function createRunDagProgressObserver(options = {}) {
+    const intervalMs = options.intervalMs ?? DEFAULT_RUN_DAG_PROGRESS_INTERVAL_MS;
+    const write = options.write ?? ((text) => process.stderr.write(text));
+    const now = options.now ?? Date.now;
+    let latestState;
+    let timer;
+    const emit = (message) => {
+        try {
+            write(`[run-dag] ${message}\n`);
+        }
+        catch {
+            // Progress is a derived CLI view and must never decide DAG execution.
+        }
+    };
+    const stop = () => {
+        if (timer)
+            clearInterval(timer);
+        timer = undefined;
+    };
+    const start = () => {
+        if (timer || intervalMs <= 0)
+            return;
+        timer = setInterval(() => {
+            if (!latestState)
+                return;
+            emit(`heartbeat run=${latestState.runId} ${countStatuses(latestState)} ${activeNodeSummary(latestState, now())}`);
+        }, intervalMs);
+        timer.unref?.();
+    };
+    const observer = {
+        onRunStart: (state) => {
+            latestState = state;
+            emit(`started run=${state.runId} nodes=${Object.keys(state.nodes).length} title=${JSON.stringify(state.title)}`);
+            start();
+        },
+        onNodeStart: (nodeId, state) => {
+            latestState = state;
+            const node = state.nodes[nodeId];
+            emit(`node-started run=${state.runId} node=${nodeId} executor=${node?.executor ?? "unknown"} ${countStatuses(state)}`);
+        },
+        onNodeOutput: (_nodeId, _chunk, state) => {
+            latestState = state;
+        },
+        onNodeFinish: (nodeId, state) => {
+            latestState = state;
+            const node = state.nodes[nodeId];
+            emit(`node-finished run=${state.runId} node=${nodeId} status=${node?.status ?? "unknown"} duration=${formatDuration(node?.durationMs ?? 0)} ${countStatuses(state)}`);
+        },
+        onRunFinish: (state) => {
+            latestState = state;
+            stop();
+            emit(`finished run=${state.runId} status=${state.status} ${countStatuses(state)}`);
+        },
+    };
+    return { observer, dispose: stop };
+}

package/dist/commands/run-dag.js

@@ -1,11 +1,22 @@
 import { parseRunDagArgs } from "../application/dag/args.js";
 import { runDagUseCase } from "../application/dag/run-dag.js";
+import { createRunDagProgressObserver } from "./run-dag-progress.js";
 export { parseRunDagArgs };
 export async function runRunDag(repoRoot, rawArgs) {
     const parsed = parseRunDagArgs(rawArgs, repoRoot);
-    const result = await runDagUseCase({
-        repoRoot,
-        ...parsed,
-    });
-    console.log(JSON.stringify(result, null, 2));
+    const { quiet, progressIntervalMs, ...runInput } = parsed;
+    const progress = quiet || parsed.dryRun || parsed.initOnly
+        ? undefined
+        : createRunDagProgressObserver({ intervalMs: progressIntervalMs });
+    try {
+        const result = await runDagUseCase({
+            repoRoot,
+            ...runInput,
+            observer: progress?.observer,
+        });
+        console.log(JSON.stringify(result, null, 2));
+    }
+    finally {
+        progress?.dispose();
+    }
 }

package/dist/executors/shell-executor.js

@@ -10,6 +10,8 @@ import { materializeBackendTestAnalysisContract } from "../workflows/dag/backend
 import { extractBackendTestContractEnvelope } from "../workflows/dag/backend-test-contract-envelope.js";
 import { materializeFrontendImplementationContract } from "../workflows/dag/frontend-implementation-contract.js";
 import { materializeFrontendTestResult, validateFrontendCaseEvidence, } from "../workflows/dag/frontend-test-result-contract.js";
+import { validateFrontendCaseChecklist } from "../workflows/dag/frontend-test-case-checklist.js";
+import { renderFrontendTestHtmlReport } from "../workflows/dag/frontend-test-html-report.js";
 import { formatFrontendVerificationTraceStdout, runFrontendVerificationTraceGate, } from "../workflows/dag/frontend-verification-trace.js";
 import { formatFrontendWorktreeDiffStdout, runFrontendWorktreeDiffGate, } from "../workflows/dag/frontend-worktree-diff.js";
 import { formatFrontendFailureAssessStdout, formatFrontendRepairContractStdout, runFrontendFailureAssessGate, runFrontendRepairContractGate, } from "../workflows/dag/frontend-repair.js";
@@ -1143,6 +1145,30 @@ async function executeFrontendVerificationBundle(input, meta) {
         };
     }
 }
+async function executeFrontendTestCaseChecklist(input, meta) {
+    const started = Date.now();
+    try {
+        const declaredAcIds = (meta.spec.sourceBinding?.requirementIds ?? []).filter((id) => /^AC(?:-[A-Z0-9]+)+$/i.test(id));
+        const result = await validateFrontendCaseChecklist({ workspaceRoot: input.cwd, declaredAcIds });
+        if (result.issues.length) {
+            return { ok: false, stdout: "", stderr: `frontend-test checklist blocked: ${JSON.stringify(result.issues)}`, failureCategory: "invalid-output", durationMs: Date.now() - started };
+        }
+        return { ok: true, stdout: `frontend-test checklist ok cases=${result.caseCount} source=${path.basename(result.manifestPath)}`, stderr: "", failureCategory: "success", durationMs: Date.now() - started };
+    }
+    catch (error) {
+        return { ok: false, stdout: "", stderr: error instanceof Error ? error.message : String(error), failureCategory: "invalid-output", durationMs: Date.now() - started };
+    }
+}
+async function executeFrontendTestHtmlReport(input, meta) {
+    const started = Date.now();
+    try {
+        const output = await renderFrontendTestHtmlReport({ workspaceRoot: input.cwd, runDir: meta.runDir });
+        return { ok: true, stdout: `Frontend test report: ${output.htmlPath}\nMarkdown: ${output.markdownPath}\nOutcome: ${output.outcome}\nCases: ${output.caseCount}`, stderr: "", failureCategory: "success", durationMs: Date.now() - started };
+    }
+    catch (error) {
+        return { ok: false, stdout: "", stderr: error instanceof Error ? error.message : String(error), failureCategory: "invalid-output", durationMs: Date.now() - started };
+    }
+}
 async function executeFrontendTestEvidenceValidation(input) {
     const started = Date.now();
     try {
@@ -1275,9 +1301,15 @@ export async function executeDagShellNode(input, meta) {
             return { ok: false, stdout: "", stderr: error instanceof Error ? error.message : String(error), failureCategory: "invalid-output", durationMs: Date.now() - started };
         }
     }
+    if (shell?.frontendTestCaseChecklist) {
+        return executeFrontendTestCaseChecklist(input, meta);
+    }
     if (shell?.frontendTestEvidenceValidation) {
         return executeFrontendTestEvidenceValidation(input);
     }
+    if (shell?.frontendTestHtmlReport) {
+        return executeFrontendTestHtmlReport(input, meta);
+    }
     if (shell?.backendTestPipeline) {
         return executeBackendTestPipelineWithWriteGuard(input, meta);
     }

package/dist/workflows/dag/backend-test-markdown-workflow.js

@@ -7,7 +7,11 @@ import path from "node:path";
 import { promisify } from "node:util";
 import { parseJacocoXml, } from "./backend-test-coverage-contract.js";
 const execFileAsync = promisify(execFile);
-const CASE_ID = /\bBE-[A-Z0-9]+(?:-[A-Z0-9]+)*-\d{3}\b/g;
+// Canonical contract is three digits (BE-MODULE-001). Readers accept legacy/
+// model-drift two-digit suffixes and canonicalize them in memory so one bad
+// heading width cannot collapse the whole manifest/report to zero cases.
+const CASE_ID = /\bBE-[A-Z0-9_-]+-\d{2,3}\b/g;
+const CANONICAL_CASE_ID = /\bBE-[A-Z0-9]+(?:-[A-Z0-9]+)*-\d{3}\b/;
 const AC_ID = /\bAC-[A-Z0-9]+(?:-[A-Z0-9]+)*\b/g;
 const SECRET = /(?:password|passwd|secret|token|api[_-]?key|private[_-]?key|authorization)\s*[:=]\s*\S+/i;
 const SECRET_ASSIGNMENT = /\b(password|passwd|secret|token|api[_-]?key|private[_-]?key|authorization|cookie|set-cookie|credential)\b\s*[:=]\s*([^\r\n,;]+)/gi;
@@ -178,12 +182,27 @@ async function markdownFiles(root) {
         .map((entry) => path.join(directory, entry.name))
         .sort();
 }
+function canonicalBackendCaseId(value) {
+    const upper = value.toUpperCase();
+    const match = upper.match(/^(BE-[A-Z0-9_-]+)-(\d{2,3})$/);
+    if (!match)
+        return upper;
+    const modulePart = match[1]
+        .replaceAll("_", "-")
+        .replace(/-+/g, "-")
+        .replace(/-$/, "");
+    return `${modulePart}-${match[2].padStart(3, "0")}`;
+}
+function caseIdsInText(value) {
+    return unique((value.match(CASE_ID) ?? []).map(canonicalBackendCaseId));
+}
 function splitCases(markdown) {
     const headings = [
-        ...markdown.matchAll(/^##\s+(BE-[A-Z0-9]+(?:-[A-Z0-9]+)*-\d{3})\b.*$/gm),
+        ...markdown.matchAll(/^##\s+(BE-[A-Z0-9_-]+-\d{2,3})\b.*$/gm),
     ];
     return headings.map((match, index) => ({
-        id: match[1],
+        id: canonicalBackendCaseId(match[1]),
+        rawId: match[1],
         body: markdown.slice(match.index, headings[index + 1]?.index ?? markdown.length),
     }));
 }
@@ -396,6 +415,9 @@ export async function validateBackendMarkdownCases(input) {
         }
         for (const testCase of cases) {
             caseCount += 1;
+            if (!CANONICAL_CASE_ID.test(testCase.rawId)) {
+                findings.push(`${testCase.rawId} uses a non-canonical Case ID; use ${testCase.id} (hyphen-separated module, three-digit sequence)`);
+            }
             const previous = seen.get(testCase.id);
             if (previous) {
                 findings.push(`duplicate case id ${testCase.id}: ${previous} and ${relativeFile}`);
@@ -545,8 +567,10 @@ function testFunctionRegion(input) {
         .join("\n");
 }
 function symbolCaseId(symbol) {
-    const match = symbol.match(/^test_(BE(?:_[A-Z0-9]+)+?_\d{3})(?:_|$)/i);
-    return match ? match[1].replaceAll("_", "-").toUpperCase() : undefined;
+    const match = symbol.match(/^test_(BE(?:_[A-Z0-9]+)+?_\d{2,3})(?:_|$)/i);
+    return match
+        ? canonicalBackendCaseId(match[1].replaceAll("_", "-"))
+        : undefined;
 }
 export async function validateBackendMarkdownTraceability(workspaceRoot) {
     const files = await markdownFiles(workspaceRoot);
@@ -606,7 +630,7 @@ export async function validateBackendMarkdownTraceability(workspaceRoot) {
                 functionIndex: match.index,
                 functionHeaderEnd: match.index + match[0].length,
             });
-            const associatedIds = new Set(region.match(CASE_ID) ?? []);
+            const associatedIds = new Set(caseIdsInText(region));
             const fromSymbol = symbolCaseId(symbol);
             if (fromSymbol)
                 associatedIds.add(fromSymbol);
@@ -711,7 +735,8 @@ export async function collectBackendTestMappedPytestScripts(workspaceRoot) {
 function cleanCaseTitle(rawHeading, id) {
     return rawHeading
         .replace(/^##\s+/, "")
-        .replace(new RegExp(`^${escapeRegExp(id)}\\s*(?:[｜|—–-]\\s*)?`), "")
+        // Strip either canonical or compatible two-digit heading ID.
+        .replace(/^BE-[A-Z0-9_-]+-\d{2,3}\s*(?:[｜|—–-]\s*)?/i, "")
         .trim() || id;
 }
 export async function collectBackendTestHumanCaseCatalog(workspaceRoot) {
@@ -755,7 +780,7 @@ export async function collectBackendTestHumanCaseCatalog(workspaceRoot) {
         for (const match of content.matchAll(/^(\s*)(?:async\s+)?def\s+(test_[A-Za-z0-9_]+)\s*\([^)]*\)\s*(?:->\s*[^:\r\n]+)?\s*:/gm)) {
             const symbol = match[2];
             const region = testFunctionRegion({ source: content, functionIndex: match.index, functionHeaderEnd: match.index + match[0].length });
-            const ids = new Set(region.match(CASE_ID) ?? []);
+            const ids = new Set(caseIdsInText(region));
             const fromSymbol = symbolCaseId(symbol);
             if (fromSymbol)
                 ids.add(fromSymbol);
@@ -772,13 +797,13 @@ export async function collectBackendTestHumanCaseCatalog(workspaceRoot) {
     return [...catalog.values()].sort((left, right) => left.id.localeCompare(right.id));
 }
 function junitCaseId(name) {
-    return symbolCaseId(name) ?? name.match(CASE_ID)?.[0];
+    return symbolCaseId(name) ?? caseIdsInText(name)[0];
 }
 /** Prefer function-name Case ID; fall back to first BE-* in free text (docstring/log). */
 function extractCaseIdFromText(value) {
     if (!value?.trim())
         return undefined;
-    return junitCaseId(value) ?? value.match(CASE_ID)?.[0];
+    return junitCaseId(value) ?? caseIdsInText(value)[0];
 }
 function resolveReportCaseId(result, catalog) {
     const fromName = extractCaseIdFromText(result.name);
@@ -1175,6 +1200,43 @@ function renderHttpCallCard(call) {
         : "";
     return `<div style="border:1px solid #eef0f3;border-radius:10px;padding:12px 14px;margin-top:10px;background:#fcfdff">${header}${requestBlock}${responseBlock}</div>`;
 }
+function analyzeBackendTestFailure(result) {
+    const evidence = [result.message, result.details].filter(Boolean).join("\n");
+    const statusPatterns = [
+        { pattern: /实际(?:\s*HTTP)?\s*状态码\s*[:：]?\s*(\d{3})[\s\S]{0,80}?预期(?:\s*HTTP)?\s*状态码?\s*[:：]?\s*(\d{3})/i, actualGroup: 1, expectedGroup: 2 },
+        { pattern: /预期(?:\s*HTTP)?\s*状态码\s*[:：]?\s*(\d{3})[\s\S]{0,80}?实际(?:\s*HTTP)?\s*状态码?\s*[:：]?\s*(\d{3})/i, actualGroup: 2, expectedGroup: 1 },
+        { pattern: /assert\s+(\d{3})\s*==\s*(\d{3})/i, actualGroup: 1, expectedGroup: 2 },
+        { pattern: /expected\s*[:=]?\s*(\d{3})[\s\S]{0,80}?(?:actual|received|got)\s*[:=]?\s*(\d{3})/i, actualGroup: 2, expectedGroup: 1 },
+    ];
+    for (const candidate of statusPatterns) {
+        const match = evidence.match(candidate.pattern);
+        if (match) {
+            const actual = match[candidate.actualGroup];
+            const expected = match[candidate.expectedGroup];
+            if (actual && expected) {
+                return `HTTP 状态码不符合预期：期望 ${expected}，实际 ${actual}。建议核对接口错误码契约、异常映射与测试前置数据。`;
+            }
+        }
+    }
+    const contentTypeMatch = evidence.match(/assert\s+(['"])(.*?)\1\.startswith\(\s*(['"])application\/json\3\s*\)/i);
+    if (contentTypeMatch) {
+        const actual = contentTypeMatch[2];
+        const actualLabel = actual ? `为 ${actual}` : "为空值";
+        return `响应 Content-Type 不符合预期：期望以 application/json 开头，实际${actualLabel}。建议核对接口响应头设置。`;
+    }
+    const assertionEvidence = (result.details ?? "")
+        .split(/\r?\n/)
+        .map((line) => line.trim().replace(/^E\s+/, ""))
+        .find((line) => /^assert\b/i.test(line));
+    const rawMessage = /^\d+:\s*AssertionError\s*$/i.test(result.message?.trim() ?? "") && assertionEvidence
+        ? assertionEvidence
+        : result.message || assertionEvidence || humanStatus(result.status);
+    const message = rawMessage.replace(/\s+/g, " ").trim().slice(0, 240);
+    if (result.status === "error") {
+        return `测试执行发生错误：${message}。建议优先检查 fixture、依赖导入、环境连接与运行时异常。`;
+    }
+    return `断言未满足：${message}。建议结合失败详情及请求/响应证据核对接口行为与用例预期。`;
+}
 export function renderBackendTestHtml(input) {
     const failed = input.parsed.failed + input.parsed.errors > 0;
     const passRate = input.parsed.tests > 0 ? input.parsed.passed / input.parsed.tests : 0;
@@ -1183,7 +1245,15 @@ export function renderBackendTestHtml(input) {
     const traceability = parseAdvisorySummary(input.traceabilitySummary);
     const failures = input.parsed.cases.filter((result) => result.status !== "passed");
     const headColor = failed ? { fg: "#b42318", bg: "linear-gradient(135deg,#fef3f2 0,#fee4e2 100%)", border: "#fda29b", icon: "✗" } : { fg: "#067647", bg: "linear-gradient(135deg,#ecfdf3 0,#d1fadf 100%)", border: "#abefc6", icon: "✓" };
-    const caseCards = input.parsed.cases.map((result) => {
+    const orderedCases = input.parsed.cases
+        .map((result, index) => ({ result, index }))
+        .sort((left, right) => {
+        const leftFailed = left.result.status === "failure" || left.result.status === "error" ? 0 : 1;
+        const rightFailed = right.result.status === "failure" || right.result.status === "error" ? 0 : 1;
+        return leftFailed - rightFailed || left.index - right.index;
+    })
+        .map(({ result }) => result);
+    const caseCards = orderedCases.map((result) => {
         const caseId = resolveReportCaseId(result, catalog);
         const item = caseId === "未关联" ? undefined : catalog.get(caseId);
         const io = requestResponseSummary(result);
@@ -1201,20 +1271,23 @@ export function renderBackendTestHtml(input) {
     const metricCard = (label, value, valueColor = "#172033") => `<div style="padding:14px 16px;border:1px solid #e3e8ef;border-radius:12px;background:#fbfcfe"><span style="color:#667085;font-size:0.78rem">${escapeHtml(label)}</span><div style="font-size:22px;font-weight:700;color:${valueColor}">${value}</div></div>`;
     const metrics = `<div style="display:grid;grid-template-columns:repeat(auto-fit,minmax(130px,1fr));gap:12px;margin-top:14px">${metricCard("用例总数", input.parsed.tests)}${metricCard("通过", input.parsed.passed, "#067647")}${metricCard("失败", input.parsed.failed)}${metricCard("错误", input.parsed.errors)}${metricCard("跳过", input.parsed.skipped)}<div style="padding:14px 16px;border:1px solid #e3e8ef;border-radius:12px;background:#fbfcfe"><span style="color:#667085;font-size:0.78rem">通过率</span><div style="font-size:22px;font-weight:700;color:#067647">${(passRate * 100).toFixed(2)}%</div><span style="color:#667085;font-size:0.78rem">耗时 ${formatDuration(input.parsed.durationMs)}</span></div></div>`;
     const summaryBanner = `<div style="display:flex;align-items:center;gap:16px;padding:16px 18px;border-radius:14px;background:${headColor.bg};border:1px solid ${headColor.border}"><div style="flex:0 0 auto;width:44px;height:44px;border-radius:999px;background:${headColor.fg};display:flex;align-items:center;justify-content:center;color:#fff;font-size:24px;font-weight:900;box-shadow:0 4px 12px ${headColor.fg}4d">${headColor.icon}</div><div><div style="color:${headColor.fg};font-size:1.05rem;font-weight:800;line-height:1.3">${failed ? "本轮测试未通过" : "本轮测试通过"}</div><div style="color:${headColor.fg};font-size:0.88rem;margin-top:2px">${failed ? `${input.parsed.failed + input.parsed.errors} 条用例失败或错误` : `${input.parsed.passed} 条用例全部执行成功`}</div></div></div>`;
-    const qualityBlock = `<div style="margin-top:18px"><div style="color:#17365d;font-size:16px;font-weight:700;margin:0 4px 6px">质量校验</div><div style="display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:12px;margin-top:8px">${renderQualityCard("Markdown 用例校验", caseValidation)}${renderQualityCard("Markdown → pytest 追溯", traceability)}</div></div>`;
+    const qualityBlock = `<div style="margin-top:18px"><div style="color:#17365d;font-size:16px;font-weight:700;margin:0 4px 6px">质量校验</div><div style="display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:12px;margin-top:8px">${renderQualityCard("Markdown 用例校验", caseValidation, input.caseValidationSummary)}${renderQualityCard("Markdown → pytest 追溯", traceability, input.traceabilitySummary)}</div></div>`;
     const failureOverview = failures.length > 0
         ? `<div style="margin-top:18px"><div style="color:#17365d;font-size:16px;font-weight:700;margin:0 4px 6px">失败概览</div><div style="display:grid;gap:10px;margin-top:8px">${failures.map((result) => {
             const caseId = resolveReportCaseId(result, catalog);
             const c = statusColor(result.status);
-            return `<div style="border-left:4px solid ${c.fg};background:${c.bg};padding:10px 12px;border-radius:8px"><div style="font-weight:600;color:#172033;font-size:0.88rem">${escapeHtml(caseId)} · ${escapeHtml(catalog.get(caseId)?.title ?? result.name)}</div><div style="color:${c.fg};font-size:0.82rem;margin-top:2px">${escapeHtml(result.message || humanStatus(result.status))}</div></div>`;
+            return `<div style="border-left:4px solid ${c.fg};background:${c.bg};padding:10px 12px;border-radius:8px"><div style="font-weight:600;color:#172033;font-size:0.88rem">${escapeHtml(caseId)} · ${escapeHtml(catalog.get(caseId)?.title ?? result.name)}</div><div style="color:${c.fg};font-size:0.82rem;margin-top:4px"><strong>原始失败：</strong>${escapeHtml(result.message || humanStatus(result.status))}</div><div style="color:#475467;font-size:0.82rem;margin-top:5px"><strong style="color:#17365d">原因分析：</strong>${escapeHtml(analyzeBackendTestFailure(result))}</div></div>`;
         }).join("")}</div></div>`
         : "";
     return `<!doctype html><html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>${escapeHtml(input.title)}</title></head><body style="margin:0;background:linear-gradient(180deg,#eef2f7 0,#f7f9fc 40rem);color:#172033;font-family:system-ui,'Microsoft YaHei','PingFang SC',sans-serif;line-height:1.6"><div style="max-width:1000px;margin:0 auto;padding:32px 22px 56px"><div style="padding:8px 0 4px"><div style="color:#315f93;font-weight:700;letter-spacing:0.06em;font-size:0.76rem">后端自动化测试报告</div><h1 style="margin:6px 0 0;color:#17365d;font-size:24px;line-height:1.35">${escapeHtml(input.title)}</h1><p style="color:#667085;margin:8px 0 0;font-size:0.9rem">执行事实来自同一次 pytest 执行；用例默认折叠，点击任意用例可展开执行日志（接口、请求参数、响应结果）与检查点。</p></div><div style="background:#fff;border:1px solid #e3e8ef;border-radius:16px;padding:18px 20px;margin-top:16px;box-shadow:0 1px 2px rgba(16,24,40,0.04)">${summaryBanner}${metrics}</div><div style="background:#fff;border:1px solid #e3e8ef;border-radius:16px;padding:18px 20px;margin-top:16px;box-shadow:0 1px 2px rgba(16,24,40,0.04)">${qualityBlock}<div style="margin-top:12px;padding:10px 12px;background:#f6f8fa;border-radius:8px;font-size:0.82rem;color:#475467"><strong style="color:#667085">执行环境</strong>：${escapeHtml((input.environmentSummary || "不可用").split("\n").slice(0, 3).join(" ").slice(0, 200))}</div></div>${failureOverview}<div style="margin-top:18px"><div style="display:flex;align-items:baseline;justify-content:space-between;margin:0 4px 6px"><span style="color:#17365d;font-size:16px;font-weight:700">用例执行明细</span><span style="color:#98a2b3;font-size:0.8rem">共 ${input.parsed.cases.length} 条 · 点击展开</span></div>${caseCards || '<div style="padding:16px;border:1px dashed #e3e8ef;border-radius:12px;color:#667085;background:#fbfcfe;text-align:center">未发现可展示的用例。</div>'}</div></div></body></html>`;
 }
-function renderQualityCard(title, summary) {
+function renderQualityCard(title, summary, rawSummary) {
     const colors = summary.status === "PASS" ? { fg: "#067647", bg: "#ecfdf3" } : summary.status === "FAIL" ? { fg: "#b42318", bg: "#fef3f2" } : { fg: "#9a6700", bg: "#fffaeb" };
     const label = summary.status === "Unavailable" ? "不可用" : summary.status;
-    return `<div style="padding:12px 14px;border:1px solid #e3e8ef;border-radius:10px;background:#fbfcfe"><div style="display:flex;align-items:center;justify-content:space-between;margin-bottom:6px"><strong style="color:#17365d;font-size:0.88rem">${escapeHtml(title)}</strong><span style="display:inline-block;padding:2px 9px;border-radius:999px;font-weight:700;font-size:0.72rem;color:${colors.fg};background:${colors.bg}">${label}</span></div><div style="color:#667085;font-size:0.78rem">Findings：${summary.findings ?? "不可用"}</div><div style="color:#475467;font-size:0.8rem;margin-top:2px">${escapeHtml(summary.firstFinding)}</div></div>`;
+    const details = rawSummary?.trim()
+        ? `<details style="margin-top:9px;padding-top:8px;border-top:1px solid #e3e8ef"><summary style="cursor:pointer;color:#315f93;font-size:0.78rem;font-weight:700">查看详情 · ${escapeHtml(title)}详情</summary><pre style="white-space:pre-wrap;overflow-wrap:anywhere;background:#f6f8fa;color:#1f2937;padding:10px 12px;border-radius:8px;font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:0.74rem;margin:7px 0 0;border:1px solid #eceef2;line-height:1.55">${escapeHtml(rawSummary.trim())}</pre></details>`
+        : "";
+    return `<div style="padding:12px 14px;border:1px solid #e3e8ef;border-radius:10px;background:#fbfcfe"><div style="display:flex;align-items:center;justify-content:space-between;margin-bottom:6px"><strong style="color:#17365d;font-size:0.88rem">${escapeHtml(title)}</strong><span style="display:inline-block;padding:2px 9px;border-radius:999px;font-weight:700;font-size:0.72rem;color:${colors.fg};background:${colors.bg}">${label}</span></div><div style="color:#667085;font-size:0.78rem">Findings：${summary.findings ?? "不可用"}</div><div style="color:#475467;font-size:0.8rem;margin-top:2px">${escapeHtml(summary.firstFinding)}</div>${details}</div>`;
 }
 /**
  * Dump JaCoCo execution data over TCP from a JaCoCo tcpserver agent, convert

package/dist/workflows/dag/backend-test-result-contract.js

@@ -359,12 +359,36 @@ const HTML_ENTITY_MAP = {
     "&lt;": "<",
     "&gt;": ">",
     "&quot;": '"',
-    "&#34;": '"',
-    "&#39;": "'",
     "&apos;": "'",
 };
+/** Decode one HTML entity layer. Safe for the outer data-jsonblob attribute. */
 function decodeHtmlEntities(value) {
-    return value.replace(/&(?:amp|lt|gt|quot|#34|#39|apos);/g, (entity) => HTML_ENTITY_MAP[entity] ?? entity);
+    return value.replace(/&(?:amp|lt|gt|quot|apos|#\d+|#x[0-9a-f]+);/gi, (entity) => {
+        const named = HTML_ENTITY_MAP[entity.toLowerCase()];
+        if (named !== undefined)
+            return named;
+        const hex = entity.match(/^&#x([0-9a-f]+);$/i)?.[1];
+        const decimal = entity.match(/^&#(\d+);$/)?.[1];
+        const codePoint = hex
+            ? Number.parseInt(hex, 16)
+            : decimal
+                ? Number.parseInt(decimal, 10)
+                : Number.NaN;
+        return Number.isFinite(codePoint)
+            ? String.fromCodePoint(codePoint)
+            : entity;
+    });
+}
+/** Decode nested entities only after JSON parsing; bounded to avoid overwork. */
+function decodeHtmlEntitiesDeep(value) {
+    let current = value;
+    for (let index = 0; index < 3; index += 1) {
+        const decoded = decodeHtmlEntities(current);
+        if (decoded === current)
+            break;
+        current = decoded;
+    }
+    return current;
 }
 function parseDurationLabelMs(raw) {
     if (!raw)
@@ -432,6 +456,7 @@ export function parsePytestHtmlReport(html) {
         const filePathFields = filePath ? { filePath } : {};
         const durationMs = parseDurationLabelMs(record.duration);
         const capturedLog = record.log ?? "";
+        const decodedCapturedLog = decodeHtmlEntitiesDeep(capturedLog);
         // pytest-html collapses captured stdout/stderr into a single `log` field
         // annotated with section markers. Preserve the whole log as stdout so the
         // HTTP_REQUEST/HTTP_RESPONSE lines stay reachable for the per-case card.
@@ -462,7 +487,7 @@ export function parsePytestHtmlReport(html) {
                 durationMs,
                 status: "failure",
                 message: summary,
-                details: capturedLog || summary,
+                details: decodedCapturedLog || summary,
                 ...(stdout ? { stdout } : {}),
                 ...(stderr ? { stderr } : {}),
             });
@@ -479,7 +504,7 @@ export function parsePytestHtmlReport(html) {
                 durationMs,
                 status: "error",
                 message: summary,
-                details: capturedLog || summary,
+                details: decodedCapturedLog || summary,
                 ...(stdout ? { stdout } : {}),
                 ...(stderr ? { stderr } : {}),
             });
@@ -509,7 +534,7 @@ export function parsePytestHtmlReport(html) {
                 durationMs,
                 status: "error",
                 message: summary,
-                details: capturedLog || summary,
+                details: decodedCapturedLog || summary,
                 ...(stdout ? { stdout } : {}),
                 ...(stderr ? { stderr } : {}),
             });
@@ -572,7 +597,7 @@ function splitPytestHtmlLogSections(log) {
     // pytest-html HTML-entity-escapes the captured log content (e.g. `&quot;`
     // for `"`). Decode entities first so downstream HTTP log parsers see the
     // real JSON/kv payload rather than escaped markup.
-    const decoded = decodeHtmlEntities(log);
+    const decoded = decodeHtmlEntitiesDeep(log);
     // pytest-html interleaves captured stdout/stderr with section markers like
     // "----------------------------- Captured stdout call -----------------------------".
     // String.split includes capture-group matches in the result array, so the
@@ -601,16 +626,17 @@ function splitPytestHtmlLogSections(log) {
 function extractPytestHtmlFailureMessage(log) {
     if (!log)
         return "";
+    const decoded = decodeHtmlEntitiesDeep(log);
     // pytest-html failure logs contain assertion lines prefixed with "E   " and a
     // trailing location line like "test_x.py:N: AssertionError". Prefer the
     // explicit AssertionError/Error line; fall back to the last "E   " line.
-    const assertionLine = log
+    const assertionLine = decoded
         .split(/\r?\n/)
         .map((line) => line.trim())
         .find((line) => /:\s*AssertionError/.test(line));
     if (assertionLine)
         return assertionLine.replace(/^.*?:\s*/, "");
-    const eLines = log
+    const eLines = decoded
         .split(/\r?\n/)
         .filter((line) => /^E\s+/.test(line))
         .map((line) => line.replace(/^E\s+/, "").trim());

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

@@ -0,0 +1,71 @@
+import { readFile, stat } from "node:fs/promises";
+import path from "node:path";
+async function exists(file) {
+    try {
+        return (await stat(file)).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+export async function validateFrontendCaseChecklist(input) {
+    const root = path.join(input.workspaceRoot, "testcase/frontend/cases");
+    const draft = path.join(root, "manifest.draft.json");
+    const final = path.join(root, "manifest.json");
+    const manifestPath = await exists(draft) ? draft : await exists(final) ? final : "";
+    if (!manifestPath)
+        throw new Error("checklist: missing manifest.draft.json or manifest.json");
+    const manifest = JSON.parse(await readFile(manifestPath, "utf8"));
+    if (!Array.isArray(manifest.cases) || manifest.cases.length === 0)
+        throw new Error("checklist: empty cases");
+    const declaredAc = new Set(input.declaredAcIds ?? []);
+    const issues = [];
+    const caseIdRe = /^FE-[A-Za-z0-9][A-Za-z0-9-]*$/;
+    const acIdRe = /^AC(?:-[A-Z0-9]+)+$/i;
+    const openRe = /playwright-cli\s+open\s+--browser=chrome\s+--headed\s+https?:\/\/\S+/i;
+    const productionHostRe = /(^|[.-])(prod|production)([.-]|$)/i;
+    for (const raw of manifest.cases) {
+        const item = raw;
+        const id = typeof item?.caseId === "string" ? item.caseId : "?";
+        if (typeof item?.caseId !== "string" || !caseIdRe.test(item.caseId))
+            issues.push({ ruleId: "case-id-shape", caseId: id, detail: "caseId must be FE-<FEATURE>-<NNN>-<dimension>, never AC-FE-*" });
+        if (typeof item?.caseId === "string" && /^AC-/i.test(item.caseId))
+            issues.push({ ruleId: "case-id-is-ac", caseId: id, detail: "caseId must not be an acceptance id" });
+        const casePath = typeof item?.casePath === "string" ? item.casePath : "";
+        const expectedPath = typeof item?.caseId === "string" ? `testcase/frontend/cases/${item.caseId}.md` : "";
+        const absolute = path.resolve(input.workspaceRoot, casePath);
+        const relative = path.relative(input.workspaceRoot, absolute);
+        if (!casePath || relative.startsWith("..") || path.isAbsolute(relative) || !(await exists(absolute))) {
+            issues.push({ ruleId: "case-file-missing", caseId: id, detail: casePath || "missing casePath" });
+            continue;
+        }
+        if (expectedPath && casePath.replaceAll("\\", "/") !== expectedPath)
+            issues.push({ ruleId: "case-path-mismatch", caseId: id, detail: `${casePath} must equal ${expectedPath}` });
+        const body = await readFile(absolute, "utf8");
+        if (!openRe.test(body))
+            issues.push({ ruleId: "open-prefix", caseId: id, detail: "missing playwright-cli open --browser=chrome --headed <absolute-url>" });
+        const match = body.match(/playwright-cli\s+open\s+--browser=chrome\s+--headed\s+(https?:\/\/\S+)/i);
+        if (match) {
+            try {
+                const url = new URL(match[1].replace(/[)\]},.\"'`]+$/, ""));
+                if (productionHostRe.test(url.hostname))
+                    issues.push({ ruleId: "production-url", caseId: id, detail: match[1] });
+            }
+            catch {
+                issues.push({ ruleId: "production-url", caseId: id, detail: match[1] });
+            }
+        }
+        if (!Array.isArray(item?.acIds) || item.acIds.length === 0) {
+            issues.push({ ruleId: "ac-mapping", caseId: id, detail: "acIds required" });
+        }
+        else {
+            for (const ac of item.acIds) {
+                if (typeof ac !== "string" || !acIdRe.test(ac))
+                    issues.push({ ruleId: "ac-id-shape", caseId: id, detail: String(ac) });
+                else if (declaredAc.size > 0 && !declaredAc.has(ac))
+                    issues.push({ ruleId: "unknown-ac", caseId: id, detail: `${ac} not in sourceBinding` });
+            }
+        }
+    }
+    return { caseCount: manifest.cases.length, manifestPath, issues };
+}