fix: restore web sentinel recovery diagnostics (#980)

Co-authored-by: Codex <codex@noreply.local>
This commit is contained in:
Lyon
2026-06-26 14:04:37 +08:00
committed by GitHub
parent fc6d3bdaf9
commit bdec05729d
8 changed files with 409 additions and 161 deletions
@@ -1,4 +1,4 @@
/* SPEC: PJ2026-01060508 Web哨兵 draft-2026-06-26-p7-web-probe-sentinel-dashboard. */
/* SPEC: PJ2026-01060508 Web哨兵 draft-2026-06-26-p8-web-probe-sentinel-recovery. */
/* Responsibility: Responsive visual foundation for the web-probe sentinel dashboard. */
:root {
color-scheme: light;
@@ -1,4 +1,4 @@
// SPEC: PJ2026-01060508 Web哨兵 draft-2026-06-26-p7-web-probe-sentinel-dashboard.
// SPEC: PJ2026-01060508 Web哨兵 draft-2026-06-26-p8-web-probe-sentinel-recovery.
// Responsibility: Browser-side API client, formatting, auto refresh, and base dashboard rendering.
/**
@@ -258,7 +258,7 @@ async function selectRun(runId) {
syncLocationQuery();
renderRuns();
refs.detailSubtitle.textContent = runId;
refs.detailContent.innerHTML = '<div class="empty-state">Loading</div>';
refs.detailContent.innerHTML = '<div class="empty-state">加载中</div>';
try {
const [detail, views] = await Promise.all([
dashboardApi.runDetail(runId),
@@ -292,14 +292,14 @@ function renderDashboard() {
function renderOverview() {
const overview = state.overview || {};
const status = overview.status || (overview.ok ? "healthy" : "degraded");
refs.statusPill.textContent = status;
refs.statusPill.textContent = displayStatus(status);
refs.statusPill.className = `status-pill ${statusClass(status)}`;
refs.overall.textContent = status;
refs.overall.textContent = displayStatus(status);
refs.origin.textContent = overview.publicOrigin || root.dataset.publicOrigin || "-";
const latest = overview.latestRun || null;
refs.latestRun.textContent = latest?.runId || latest?.id || "-";
refs.latestAge.textContent = latest?.updatedAt ? `${formatRelative(latest.updatedAt)} updated` : "-";
refs.latestAge.textContent = latest?.updatedAt ? `${formatRelative(latest.updatedAt)} 更新` : "-";
const severityCounts = overview.severityCounts || {};
const totalFindings = Object.values(severityCounts).reduce((sum, value) => sum + Number(value || 0), 0);
@@ -308,31 +308,31 @@ function renderOverview() {
const scheduler = overview.scheduler || {};
const heartbeat = scheduler.heartbeat || {};
refs.scheduler.textContent = heartbeat.at ? formatRelative(heartbeat.at) : "unknown";
refs.scheduler.textContent = heartbeat.at ? formatRelative(heartbeat.at) : "未知";
const maxSeconds = overview.targetValidation?.maxSeconds ?? 120;
refs.budget.textContent = `targetValidation ${maxSeconds}s`;
refs.budget.textContent = `targetValidation 预算 ${maxSeconds}s`;
const checks = overview.health?.checks || {};
renderCheckChip(refs.checkConfig, "config", checks.config?.ok, checks.config?.status);
renderCheckChip(refs.checkPvc, "pvc", checks.pvc?.ok, checks.pvc?.stateRoot);
renderCheckChip(refs.checkAnalyzer, "analyzer", checks.analyzer?.ok, "observe analyze");
renderCheckChip(refs.checkPublic, "public", Boolean(overview.publicOrigin), overview.publicOrigin || "-");
renderCheckChip(refs.checkConfig, "配置", checks.config?.ok, checks.config?.status);
renderCheckChip(refs.checkPvc, "PVC", checks.pvc?.ok, checks.pvc?.stateRoot);
renderCheckChip(refs.checkAnalyzer, "分析器", checks.analyzer?.ok, "observe analyze");
renderCheckChip(refs.checkPublic, "公开入口", Boolean(overview.publicOrigin), overview.publicOrigin || "-");
const maintenance = overview.maintenance || {};
renderCheckChip(refs.checkMaintenance, "maintenance", maintenance.active !== true, maintenance.active ? "active" : "inactive");
renderCheckChip(refs.checkMaintenance, "维护窗口", maintenance.active !== true, maintenance.active ? "生效中" : "未生效");
}
function renderTimeline() {
refs.timelineCount.textContent = `${state.runs.length} recent`;
refs.timelineCount.textContent = `最近 ${formatNumber(state.runs.length)} `;
if (state.runs.length === 0) {
refs.timeline.innerHTML = '<div class="empty-state">No timeline</div>';
refs.timeline.innerHTML = '<div class="empty-state">暂无时间线</div>';
return;
}
refs.timeline.innerHTML = state.runs.slice(0, 20).map((run) => {
const runId = run.runId || run.id || "-";
const title = `${run.status || "-"} · ${run.findingCount ?? 0} findings · ${run.updatedAt ? formatRelative(run.updatedAt) : "-"}`;
const title = `${displayStatus(run.status)} · ${run.findingCount ?? 0} 个发现 · ${run.updatedAt ? formatRelative(run.updatedAt) : "-"}`;
return `<button class="timeline-node ${statusClass(run.status)}" type="button" data-run-id="${escapeAttr(runId)}" title="${escapeAttr(title)}">
<span class="timeline-dot"></span>
<span class="timeline-label">${escapeHtml(run.status || "-")}</span>
<span class="timeline-label">${escapeHtml(displayStatus(run.status))}</span>
</button>`;
}).join("");
for (const node of refs.timeline.querySelectorAll("[data-run-id]")) {
@@ -341,9 +341,9 @@ function renderTimeline() {
}
function renderRuns() {
refs.runsCount.textContent = `${state.runs.length} visible`;
refs.runsCount.textContent = `${formatNumber(state.runs.length)} 条可见`;
if (state.runs.length === 0) {
refs.runsBody.innerHTML = '<tr><td class="empty-state" colspan="5">No runs</td></tr>';
refs.runsBody.innerHTML = '<tr><td class="empty-state" colspan="5">暂无运行</td></tr>';
return;
}
refs.runsBody.innerHTML = state.runs.map((run) => {
@@ -351,10 +351,10 @@ function renderRuns() {
const selected = state.selectedRunId === runId ? " selected-row" : "";
return `<tr class="${selected}" data-run-id="${escapeAttr(runId)}">
<td><div class="mono">${escapeHtml(runId)}</div><small>${escapeHtml(run.observerId || "-")}</small></td>
<td><span class="status-pill ${statusClass(run.status)}">${escapeHtml(run.status || "-")}</span></td>
<td><span class="status-pill ${statusClass(run.status)}">${escapeHtml(displayStatus(run.status))}</span></td>
<td>${escapeHtml(run.scenarioId || "-")}</td>
<td>${escapeHtml(String(run.findingCount ?? 0))}${run.maxSeverity ? ` <span class="severity-pill ${severityClass(run.maxSeverity)}">${escapeHtml(run.maxSeverity)}</span>` : ""}</td>
<td><span>${escapeHtml(run.updatedAt ? formatRelative(run.updatedAt) : "-")}</span><small>${escapeHtml(run.maintenance ? "maintenance" : "")}</small></td>
<td>${escapeHtml(String(run.findingCount ?? 0))}${run.maxSeverity ? ` <span class="severity-pill ${severityClass(run.maxSeverity)}">${escapeHtml(displaySeverity(run.maxSeverity))}</span>` : ""}</td>
<td><span>${escapeHtml(run.updatedAt ? formatRelative(run.updatedAt) : "-")}</span><small>${escapeHtml(run.maintenance ? "维护窗口" : "")}</small></td>
</tr>`;
}).join("");
for (const row of refs.runsBody.querySelectorAll("tr[data-run-id]")) {
@@ -364,28 +364,30 @@ function renderRuns() {
function renderFindings() {
renderFindingAggregation();
refs.findingsCount.textContent = `${state.findings.length} groups`;
refs.findingsCount.textContent = `${formatNumber(state.findings.length)} `;
if (state.findings.length === 0) {
refs.findingsList.innerHTML = '<div class="empty-state">No findings</div>';
refs.findingsList.innerHTML = '<div class="empty-state">暂无发现项</div>';
return;
}
refs.findingsList.innerHTML = state.findings.map((item) => {
const code = item.code || item.findingId || "finding";
const latestRunId = item.latestRunId || "-";
const hasLatestRun = latestRunId !== "-";
const codeLabel = displayFindingCode(code);
return `<article class="finding-item" data-finding-run-id="${escapeAttr(latestRunId)}">
<div class="finding-row">
<span class="finding-title">${escapeHtml(code)}</span>
<span class="severity-pill ${severityClass(item.severity)}">${escapeHtml(item.severity || "unknown")}</span>
<span class="finding-title">${escapeHtml(codeLabel)}${codeLabel === code ? "" : ` <small class="mono">${escapeHtml(code)}</small>`}</span>
<span class="severity-pill ${severityClass(item.severity)}">${escapeHtml(displaySeverity(item.severity))}</span>
</div>
<div class="finding-actions" aria-label="Finding filters">
<div class="finding-actions" aria-label="发现项过滤">
<button type="button" class="filter-chip" data-finding-filter="code" data-filter-value="${escapeAttr(code)}">${escapeHtml(code)}</button>
<button type="button" class="filter-chip" data-finding-filter="scenario" data-filter-value="${escapeAttr(item.scenarioId || "")}">${escapeHtml(item.scenarioId || "-")}</button>
</div>
<div class="finding-meta">count=${escapeHtml(String(item.count ?? 0))} · runs=${escapeHtml(String(item.runCount ?? 0))} · latest=${escapeHtml(item.latestAt ? formatRelative(item.latestAt) : "-")}</div>
<div class="finding-meta">次数=${escapeHtml(String(item.count ?? 0))} · 运行=${escapeHtml(String(item.runCount ?? 0))} · 最近=${escapeHtml(item.latestAt ? formatRelative(item.latestAt) : "-")}</div>
<div class="finding-meta mono">run=${escapeHtml(latestRunId)} report=${escapeHtml(item.latestReportJsonSha256 || "-")}</div>
<div class="finding-meta">${escapeHtml(shortText(item.summary || "", 180))}</div>
<button type="button" class="link-button" data-open-finding-run="${escapeAttr(latestRunId)}"${hasLatestRun ? "" : " disabled"}>Open latest run</button>
<div class="finding-meta">${escapeHtml(shortText(displayFindingSummary(code, item.summary || ""), 180))}</div>
<div class="finding-meta">${escapeHtml(findingNextAction(code))}</div>
<button type="button" class="link-button" data-open-finding-run="${escapeAttr(latestRunId)}"${hasLatestRun ? "" : " disabled"}>打开最近运行</button>
</article>`;
}).join("");
for (const button of refs.findingsList.querySelectorAll("[data-open-finding-run]")) {
@@ -398,17 +400,17 @@ function renderFindings() {
function renderFindingAggregation() {
if (state.findings.length === 0) {
refs.findingAggregation.innerHTML = '<div class="empty-state compact">No finding aggregation</div>';
refs.findingAggregation.innerHTML = '<div class="empty-state compact">暂无发现聚合</div>';
return;
}
const severityEntries = aggregateFindings((item) => item.severity || "unknown").slice(0, 5);
const codeEntries = aggregateFindings((item) => item.code || item.findingId || "unknown").slice(0, 5);
const scenarioEntries = aggregateFindings((item) => item.scenarioId || "unknown").slice(0, 5);
refs.findingAggregation.innerHTML = [
aggregationGroup("Severity", severityEntries, "severity"),
aggregationGroup("Code", codeEntries, "code"),
aggregationGroup("Scenario", scenarioEntries, "scenario"),
`<div class="aggregation-group"><span>Window</span><button type="button" class="filter-chip active">${escapeHtml(state.findingFilters.window || "all")}</button></div>`,
aggregationGroup("严重级别", severityEntries.map((item) => ({ ...item, label: displaySeverity(item.key) })), "severity"),
aggregationGroup("代码", codeEntries.map((item) => ({ ...item, label: displayFindingCode(item.key) })), "code"),
aggregationGroup("场景", scenarioEntries, "scenario"),
`<div class="aggregation-group"><span>窗口</span><button type="button" class="filter-chip active">${escapeHtml(state.findingFilters.window || "全部")}</button></div>`,
].join("");
for (const button of refs.findingAggregation.querySelectorAll("[data-finding-filter]")) {
button.addEventListener("click", () => applyFindingFilter(button.dataset.findingFilter, button.dataset.filterValue || ""));
@@ -418,7 +420,7 @@ function renderFindingAggregation() {
function aggregationGroup(label, entries, filterKey) {
const chips = entries.length === 0
? '<span class="finding-meta">-</span>'
: entries.map((entry) => `<button type="button" class="filter-chip" data-finding-filter="${escapeAttr(filterKey)}" data-filter-value="${escapeAttr(entry.key)}">${escapeHtml(entry.key)} ${formatNumber(entry.count)}</button>`).join("");
: entries.map((entry) => `<button type="button" class="filter-chip" data-finding-filter="${escapeAttr(filterKey)}" data-filter-value="${escapeAttr(entry.key)}">${escapeHtml(entry.label || entry.key)} ${formatNumber(entry.count)}</button>`).join("");
return `<div class="aggregation-group"><span>${escapeHtml(label)}</span>${chips}</div>`;
}
@@ -445,8 +447,8 @@ function applyFindingFilter(key, value) {
function renderDetail() {
if (!state.selectedRunId || !state.runDetail) {
refs.detailSubtitle.textContent = "No run selected";
refs.detailContent.innerHTML = '<div class="empty-state">Select a run</div>';
refs.detailSubtitle.textContent = "未选择运行";
refs.detailContent.innerHTML = '<div class="empty-state">请选择一条运行</div>';
return;
}
const detail = state.runDetail;
@@ -457,29 +459,29 @@ function renderDetail() {
const turnSummaryView = selectedView(state.runViews, "turn-summary");
refs.detailSubtitle.textContent = run.runId || state.selectedRunId;
refs.detailContent.innerHTML = [
detailBlock("Traceability", [
detailBlock("追溯信息", [
["run", run.runId || "-"],
["observer", run.observerId || "-"],
["stateDir", run.stateDir || "-"],
["report", run.reportJsonSha256 || "-"],
]),
detailBlock("Summary", [
["status", run.status || "-"],
detailBlock("摘要", [
["status", displayStatus(run.status)],
["scenario", run.scenarioId || "-"],
["findings", String(run.findingCount ?? 0)],
["artifacts", String(run.artifactCount ?? 0)],
["updated", run.updatedAt || "-"],
["views", Array.isArray(detail.viewsAvailable) ? detail.viewsAvailable.join(", ") : "-"],
]),
detailBlock("Report Summary", safeSummaryRows(detail.summary), "detail-block-wide"),
detailBlock("报告摘要", safeSummaryRows(detail.summary), "detail-block-wide"),
detailFindings(findings),
detailArtifacts(artifacts),
detailCommands(commands),
detailTurnSummary(turnSummaryView),
detailTraceReader(state.runViews, commands),
detailEvidence(detail, artifacts),
detailBlock("Redaction", [
["values", detail.valuesRedacted === true ? "redacted" : "-"],
detailBlock("脱敏", [
["values", detail.valuesRedacted === true ? "已脱敏" : "-"],
["prompt", detail.redaction?.prompt || "-"],
["assistant", detail.redaction?.assistantFinal || "-"],
]),
@@ -495,16 +497,16 @@ function detailBlock(title, rows, className = "") {
}
function detailFindings(findings) {
if (findings.length === 0) return detailBlock("Run Findings", [["status", "none"]], "detail-block-wide");
return `<article class="detail-block detail-block-wide"><strong>Run Findings</strong>
if (findings.length === 0) return detailBlock("运行发现项", [["status", ""]], "detail-block-wide");
return `<article class="detail-block detail-block-wide"><strong>运行发现项</strong>
<div class="detail-table-frame">
<table class="detail-table">
<thead><tr><th>Severity</th><th>Code</th><th>Count</th><th>Summary</th><th>Report</th></tr></thead>
<thead><tr><th>严重级别</th><th>代码</th><th>次数</th><th>摘要</th><th>报告</th></tr></thead>
<tbody>${findings.map((item) => `<tr>
<td><span class="severity-pill ${severityClass(item.severity)}">${escapeHtml(item.severity || "-")}</span></td>
<td><span class="severity-pill ${severityClass(item.severity)}">${escapeHtml(displaySeverity(item.severity))}</span></td>
<td class="mono">${escapeHtml(item.finding_id || item.findingId || "-")}</td>
<td>${escapeHtml(String(item.count ?? 0))}</td>
<td>${escapeHtml(shortText(item.summary || "", 220))}</td>
<td>${escapeHtml(shortText(displayFindingSummary(item.finding_id || item.findingId || "", item.summary || ""), 220))}</td>
<td class="mono">${escapeHtml(shortText(item.report_json_sha256 || item.reportJsonSha256 || "-", 24))}</td>
</tr>`).join("")}</tbody>
</table>
@@ -514,7 +516,7 @@ function detailFindings(findings) {
function detailArtifacts(artifacts) {
const screenshot = artifacts.screenshot || {};
return detailBlock("Artifacts", [
return detailBlock("产物", [
["artifactCount", String(artifacts.artifactCount ?? "-")],
["reportJsonSha256", artifacts.reportJsonSha256 || "-"],
["screenshotPath", screenshot.path || "-"],
@@ -529,17 +531,17 @@ function detailCommands(commands) {
["turn-summary", commands.turnSummary || "-"],
["trace-frame", commands.traceFrame || "-"],
];
return `<article class="detail-block detail-block-wide"><strong>CLI Commands</strong>
return `<article class="detail-block detail-block-wide"><strong>CLI 对照命令</strong>
<div class="command-list">${rows.map(([label, command]) => `<div><span>${escapeHtml(label)}</span><code>${escapeHtml(command)}</code></div>`).join("")}</div>
</article>`;
}
function detailTurnSummary(view) {
if (!view) return detailBlock("Turn Summary - Layer 1", [["status", "not indexed"]], "detail-block-wide");
if (view.ok === false) return detailBlock("Turn Summary - Layer 1", [["status", view.error || "unavailable"]], "detail-block-wide");
if (!view) return detailBlock("多轮摘要 - 第一层", [["status", "未索引"]], "detail-block-wide");
if (view.ok === false) return detailBlock("多轮摘要 - 第一层", [["status", view.error || "不可用"]], "detail-block-wide");
const text = redactDisplayText(view.renderedText || "");
const note = `${formatNumber(view.renderedTextBytes || text.length)} bytes${view.truncated ? " truncated" : ""}`;
return `<article class="detail-block detail-block-wide"><strong>Turn Summary - Layer 1</strong>
const note = `${formatNumber(view.renderedTextBytes || text.length)} bytes${view.truncated ? " 已截断" : ""}`;
return `<article class="detail-block detail-block-wide"><strong>多轮摘要 - 第一层</strong>
<div class="view-note">${escapeHtml(note)}</div>
<pre class="detail-pre">${escapeHtml(text || "-")}</pre>
</article>`;
@@ -550,25 +552,25 @@ function detailTraceReader(response, commands) {
const traceView = selectedView(response, "trace-frame");
const choices = traceChoices(turnView?.renderedText || "", traceView?.renderedText || "");
const selectedIndex = Math.min(state.selectedTraceChoiceIndex, Math.max(0, choices.length - 1));
const selected = choices[selectedIndex] || { label: "stored trace-frame", meta: "current run", key: "stored" };
const selected = choices[selectedIndex] || { label: "已保存 trace-frame", meta: "当前运行", key: "stored" };
const traceText = traceView?.ok === false ? "" : redactDisplayText(traceView?.renderedText || "");
const traceNote = traceView
? `${formatNumber(traceView.renderedTextBytes || traceText.length)} bytes${traceView.truncated ? " truncated" : ""}`
: "trace-frame view not indexed";
return `<article class="detail-block detail-block-wide trace-reader"><strong>Trace Frame - Layer 2</strong>
? `${formatNumber(traceView.renderedTextBytes || traceText.length)} bytes${traceView.truncated ? " 已截断" : ""}`
: "trace-frame 未索引";
return `<article class="detail-block detail-block-wide trace-reader"><strong>Trace Frame - 第二层</strong>
<div class="trace-reader-grid">
<section class="trace-turn-picker" aria-label="Turn summary trace choices">
<div class="view-note">Turn / trace / sample choices</div>
<section class="trace-turn-picker" aria-label="turn、trace、sample 选择">
<div class="view-note">选择 turn / trace / sample</div>
<div class="trace-choice-list">${choices.map((choice, index) => `<button type="button" class="trace-choice ${index === selectedIndex ? "active" : ""}" data-trace-choice-index="${escapeAttr(String(index))}">
<span>${escapeHtml(choice.label)}</span>
<small>${escapeHtml(choice.meta)}</small>
</button>`).join("")}</div>
</section>
<section class="trace-frame-view" aria-label="Trace frame text view">
<div class="view-note">Selected: ${escapeHtml(selected.label)} · ${escapeHtml(traceNote)}</div>
<pre class="detail-pre trace-frame-pre">${escapeHtml(traceText || (traceView?.ok === false ? traceView.error || "trace-frame unavailable" : "trace-frame view not indexed"))}</pre>
<section class="trace-frame-view" aria-label="trace-frame 文字视图">
<div class="view-note">已选择: ${escapeHtml(selected.label)} · ${escapeHtml(traceNote)}</div>
<pre class="detail-pre trace-frame-pre">${escapeHtml(traceText || (traceView?.ok === false ? traceView.error || "trace-frame 不可用" : "trace-frame 未索引"))}</pre>
${finalResponseBlock(traceView)}
<div class="trace-source-note mono">source=${escapeHtml(commands.traceFrame || "-")} · analyzer findings do not rewrite this text</div>
<div class="trace-source-note mono">source=${escapeHtml(commands.traceFrame || "-")} · analyzer finding 不改写此文字证据</div>
</section>
</div>
</article>`;
@@ -576,17 +578,17 @@ function detailTraceReader(response, commands) {
function finalResponseBlock(traceView) {
if (!traceView) {
return `<section class="final-response-block unavailable"><strong>Final Response</strong><div>trace-frame view not indexed</div></section>`;
return `<section class="final-response-block unavailable"><strong>Final Response</strong><div>trace-frame 未索引</div></section>`;
}
if (traceView.ok === false) {
return `<section class="final-response-block unavailable"><strong>Final Response</strong><div>${escapeHtml(traceView.error || "trace-frame unavailable")}</div></section>`;
return `<section class="final-response-block unavailable"><strong>Final Response</strong><div>${escapeHtml(traceView.error || "trace-frame 不可用")}</div></section>`;
}
const block = traceView.finalResponse || {};
const text = block.empty === true ? "(空内容)" : redactDisplayText(block.text || "");
const bytes = Number(block.byteCount || 0);
return `<section class="final-response-block ${block.empty === true ? "empty" : ""}">
<strong>Final Response</strong>
<div class="view-note">${block.empty === true ? "empty" : "available"} · ${formatNumber(bytes)} bytes · values redacted</div>
<div class="view-note">${block.empty === true ? "空内容" : "有内容"} · ${formatNumber(bytes)} bytes · 已脱敏</div>
<pre class="final-response-text">${escapeHtml(text || "(空内容)")}</pre>
</section>`;
}
@@ -602,19 +604,19 @@ function traceChoices(turnSummaryText, traceFrameText) {
.map((line) => line.trim())
.filter((line) => /(trace|sample|total=|final response)/iu.test(line))
.slice(0, 12);
if (lines.length === 0) return [{ label: "stored trace-frame", meta: "current run", key: "stored" }];
if (lines.length === 0) return [{ label: "已保存 trace-frame", meta: "当前运行", key: "stored" }];
return lines.map((line, index) => {
const trace = line.match(/trace(?:Id)?[=: ]+([A-Za-z0-9_.:-]+)/u)?.[1] || line.match(/\btrc_[A-Za-z0-9_.:-]+/u)?.[0] || null;
const sample = line.match(/sample(?:Seq)?[=: ]+([0-9]+)/u)?.[1] || null;
const turn = line.match(/turn[=: #]+([0-9A-Za-z_.:-]+)/iu)?.[1] || null;
const meta = [turn ? `turn ${turn}` : null, trace ? `trace ${trace}` : null, sample ? `sample ${sample}` : null].filter(Boolean).join(" · ") || `line ${index + 1}`;
const meta = [turn ? `turn ${turn}` : null, trace ? `trace ${trace}` : null, sample ? `sample ${sample}` : null].filter(Boolean).join(" · ") || ` ${index + 1}`;
return { label: shortText(redactDisplayText(line), 120), meta, key: `${trace || "line"}-${sample || index}` };
});
}
function detailEvidence(detail, artifacts) {
const traceability = detail.traceability || {};
return detailBlock("Evidence", [
return detailBlock("证据", [
["source", traceability.source || "-"],
["stateRoot", traceability.stateRoot || "-"],
["stateDir", traceability.stateDir || "-"],
@@ -625,7 +627,7 @@ function detailEvidence(detail, artifacts) {
}
function selectedView(response, viewName) {
if (response?.ok === false) return { ok: false, error: response.error || "unavailable", view: viewName };
if (response?.ok === false) return { ok: false, error: response.error || "不可用", view: viewName };
const views = Array.isArray(response?.views) ? response.views : [];
return views.find((item) => item.view === viewName) || null;
}
@@ -645,7 +647,7 @@ function renderLoading(show) {
}
function renderCheckChip(element, label, ok, detail) {
const status = ok ? "ok" : "blocked";
const status = ok ? "正常" : "阻塞";
element.textContent = `${label} ${status}${detail ? ` · ${shortText(detail, 34)}` : ""}`;
element.className = `check-chip ${ok ? "check-ok" : "check-blocked"}`;
}
@@ -772,7 +774,7 @@ function safeSummaryRows(summary) {
if (rows.length >= 8) break;
rows.push([key, safeDisplayValue(value)]);
}
return rows.length === 0 ? [["status", "not indexed"]] : rows;
return rows.length === 0 ? [["status", "未索引"]] : rows;
}
function safeDisplayKey(key) {
@@ -782,25 +784,25 @@ function safeDisplayKey(key) {
function safeDisplayValue(value) {
if (value === null || typeof value === "undefined") return "-";
if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return String(value);
if (Array.isArray(value)) return `${value.length} items`;
if (Array.isArray(value)) return `${value.length} `;
const entries = Object.entries(value).filter(([key]) => safeDisplayKey(key)).slice(0, 4);
if (entries.length === 0) return "redacted object";
if (entries.length === 0) return "已脱敏对象";
return entries.map(([key, item]) => `${key}=${primitiveValue(item)}`).join(", ");
}
function primitiveValue(value) {
if (value === null || typeof value === "undefined") return "-";
if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return shortText(String(value), 80);
if (Array.isArray(value)) return `${value.length} items`;
return "object";
if (Array.isArray(value)) return `${value.length} `;
return "对象";
}
function redactDisplayText(value) {
return String(value || "")
.split("\n")
.map((line) => {
if (/(prompt|cookie|token|authorization|provider|payload|api[_-]?key|password|secret|stdout|stderr)/iu.test(line)) return "[redacted]";
if (/assistant/iu.test(line) && line.length > 180) return "[assistant text redacted]";
if (/(prompt|cookie|token|authorization|provider|payload|api[_-]?key|password|secret|stdout|stderr)/iu.test(line)) return "[已脱敏]";
if (/assistant/iu.test(line) && line.length > 180) return "[assistant 正文已脱敏]";
return shortText(line, 360);
})
.join("\n");
@@ -827,14 +829,97 @@ function severityClass(value) {
return "severity-unknown";
}
function displayStatus(value) {
const normalized = String(value || "idle").toLowerCase();
const labels = {
healthy: "健康",
observed: "已观察",
analyzed: "已分析",
pass: "通过",
ok: "正常",
warning: "警告",
degraded: "降级",
planned: "已计划",
running: "运行中",
queued: "排队中",
blocked: "阻塞",
failed: "失败",
error: "错误",
timeout: "超时",
interrupted: "已中断",
idle: "空闲",
};
return labels[normalized] || String(value || "-");
}
function displaySeverity(value) {
const normalized = String(value || "unknown").toLowerCase();
const labels = {
red: "红色",
critical: "严重",
error: "错误",
warning: "警告",
amber: "警告",
info: "信息",
unknown: "未知",
};
return labels[normalized] || String(value || "-");
}
function displayFindingCode(code) {
const normalized = String(code || "").toLowerCase();
const labels = {
"quick-verify-no-business-turn": "quick verify 未触达业务 turn",
"observer-command-failed": "观察器控制命令失败",
"runtime-requestfailed": "运行时请求失败",
"runtime-console-alerts": "运行时控制台告警",
"browser-console-or-page-errors": "浏览器控制台或页面错误",
"browser-timeout": "页面 readiness 超时",
"target-page-readiness-timeout": "页面 readiness 超时",
"network-or-api-fetch-bug": "网络或 API 请求异常",
};
return labels[normalized] || String(code || "finding");
}
function displayFindingSummary(code, summary) {
const normalized = String(code || "").toLowerCase();
const summaries = {
"quick-verify-no-business-turn": "quick verify 没有形成 sendPrompt、session、trace rows 或 Final Response;不能把公开 dashboard 200 当作 HWLAB 恢复证据。",
"observer-command-failed": "observe control command 失败,需要查看 observer timeline 和 failed command 文件确认是 readiness、session API、超时还是 runner shutdown。",
"runtime-requestfailed": "页面运行时存在请求失败,需要按路径聚合确认是 asset/provenance 噪声、public origin、auth/session 还是 Workbench API。",
"runtime-console-alerts": "页面控制台出现告警,需要结合 run detail 的 network/console 证据判断是否影响业务 turn。",
"browser-console-or-page-errors": "浏览器页面报错,需要先看 finalUrl、readiness、session create 和 API 证据,再判断是否是前端缺陷。",
"browser-timeout": "页面或 Workbench readiness 超时,不应默认判断为浏览器安装环境问题。",
"target-page-readiness-timeout": "页面或 Workbench readiness 超时,不应默认判断为浏览器安装环境问题。",
};
const translated = summaries[normalized];
if (!translated) return String(summary || "");
const source = String(summary || "").trim();
return source && !source.includes(translated) ? `${translated} 原始摘要: ${source}` : translated;
}
function findingNextAction(code) {
const normalized = String(code || "").toLowerCase();
const actions = {
"quick-verify-no-business-turn": "下一步: 打开该 run 的 turn-summary/trace-frame,并用 CLI 对照命令确认没有业务 turn。",
"observer-command-failed": "下一步: 查看 observe collect timeline 和 failed command 文件,定位失败阶段。",
"runtime-requestfailed": "下一步: 按请求路径聚合失败,区分网络、auth/session、API 或静态资源问题。",
"runtime-console-alerts": "下一步: 结合 console 样本与业务 trace 判断是否为阻塞级。",
"browser-console-or-page-errors": "下一步: 先查 Workbench readiness 和 session create,再决定是否修前端。",
"browser-timeout": "下一步: 查 finalUrl、loading、session create、network requestfailed 和 reportPath,不先改浏览器安装。",
"target-page-readiness-timeout": "下一步: 查 finalUrl、loading、session create、network requestfailed 和 reportPath,不先改浏览器安装。",
};
return actions[normalized] || "下一步: 打开最近运行详情,并用 CLI 对照命令复核同一 run/observer/report。";
}
function formatSeveritySummary(counts) {
const entries = Object.entries(counts || {}).filter(([, value]) => Number(value || 0) > 0);
if (entries.length === 0) return "none";
return entries.map(([key, value]) => `${key} ${formatNumber(Number(value || 0))}`).join(" · ");
if (entries.length === 0) return "";
return entries.map(([key, value]) => `${displaySeverity(key)} ${formatNumber(Number(value || 0))}`).join(" · ");
}
function formatNumber(value) {
return new Intl.NumberFormat("en-US").format(Number(value || 0));
return new Intl.NumberFormat("zh-CN").format(Number(value || 0));
}
function shortText(value, limit) {
@@ -846,12 +931,13 @@ function formatRelative(iso) {
const ms = Date.parse(String(iso || ""));
if (!Number.isFinite(ms)) return "-";
const seconds = Math.max(0, Math.floor((Date.now() - ms) / 1000));
if (seconds < 60) return `${seconds}s ago`;
if (seconds < 5) return "刚刚";
if (seconds < 60) return `${seconds} 秒前`;
const minutes = Math.floor(seconds / 60);
if (minutes < 60) return `${minutes}m ago`;
if (minutes < 60) return `${minutes} 分钟前`;
const hours = Math.floor(minutes / 60);
if (hours < 24) return `${hours}h ago`;
return `${Math.floor(hours / 24)}d ago`;
if (hours < 24) return `${hours} 小时前`;
return `${Math.floor(hours / 24)} 天前`;
}
function escapeHtml(value) {
+4 -1
View File
@@ -1,4 +1,5 @@
// SPEC: PJ2026-01060505 Workbench Performance draft-2026-06-17-p0.
// SPEC: PJ2026-01060508 Web哨兵 draft-2026-06-26-p8-web-probe-sentinel-recovery.
// Responsibility: Redacted web-probe summaries and issue-ready compaction helpers.
function record(value: unknown): Record<string, unknown> {
@@ -392,7 +393,8 @@ function webProbeRunFailureKind(degradedReason: string | null, promptValidation:
if (degradedReason === "agent-terminal-timeout") return "agent-runtime-timeout";
if (/trace-fetch|api|fetch|http|network/iu.test(degradedReason)) return "network-or-api-fetch-bug";
if (/auth|login|credential/iu.test(degradedReason)) return "target-auth-bug";
if (/browser|timeout|playwright|chromium/iu.test(degradedReason)) return "browser-environment-bug";
if (/browser-timeout|selector-timeout|readiness|session|composer|navigation|load-jitter|timeout/iu.test(degradedReason)) return "target-page-readiness-timeout";
if (/browser|playwright|chromium/iu.test(degradedReason)) return "browser-environment-bug";
const failures = Array.isArray(promptValidation.failures) ? promptValidation.failures.join(" ") : "";
if (/final-response|agent-message|markdown|completed/iu.test(failures)) return "unmet-expectation";
return "user-facing-web-bug";
@@ -424,6 +426,7 @@ function webProbeRunNextAction(
if (failureKind === "network-or-api-fetch-bug") return "Inspect trace/session API fetch fields in reportPath and retry after checking target API availability.";
if (failureKind === "agent-runtime-timeout") return "Inspect summary.traceId/sessionId and the corresponding Code Agent/AgentRun runtime; the browser probe submitted the prompt and observed trace events, but no terminal agent response arrived before the wait boundary.";
if (failureKind === "target-auth-bug") return "Inspect credential sourceRef/fingerprint and /auth/login status; do not print secrets.";
if (failureKind === "target-page-readiness-timeout") return "Inspect finalUrl, readiness/session-create state, Workbench loading indicators, network request failures, and session API evidence in reportPath before changing browser launcher settings.";
if (failureKind === "browser-environment-bug") return "Inspect browser launcher and Playwright availability on the target workspace.";
if (promptSubmitted && !traceRequested) return "Rerun with trace sampling if trace evidence is required.";
return degradedReason === null ? null : "Inspect reportPath for full redacted details, then rerun the same node/lane entry.";
+95 -10
View File
@@ -1,4 +1,5 @@
// SPEC: PJ2026-01060508 Web哨兵 draft-2026-06-25-p0-web-probe-sentinel.
// SPEC: PJ2026-01060508 Web哨兵 draft-2026-06-26-p8-web-probe-sentinel-recovery.
// Responsibility: YAML-first CI/CD, image, GitOps and Argo command plan for the web-probe sentinel.
import { createHash, randomUUID } from "node:crypto";
import { existsSync, readFileSync } from "node:fs";
@@ -1353,10 +1354,28 @@ function sentinelPayloadFromLogs(logsTail: string): Record<string, unknown> {
return {};
}
function sentinelElapsedWarnings(value: unknown): string[] {
function sentinelElapsedWarnings(value: unknown, subject = "sentinel confirmed operation"): string[] {
const elapsedMs = typeof value === "number" && Number.isFinite(value) ? value : null;
if (elapsedMs === null || elapsedMs <= 120_000) return [];
return [`sentinel confirmed operation exceeded 120s (${Math.round(elapsedMs / 1000)}s); investigate env-reuse/git mirror/source build path before treating this as normal.`];
return [`${subject} exceeded 120s (${Math.round(elapsedMs / 1000)}s); treat this as a severe timeout and investigate env-reuse/git mirror/source build path plus the current wait stage before retrying.`];
}
function mergeWarnings(...items: readonly (readonly unknown[] | unknown)[]): string[] {
const warnings: string[] = [];
for (const item of items) {
const values = Array.isArray(item) ? item : [item];
for (const value of values) {
if (value === undefined || value === null || value === "") continue;
const warning = text(value).trim();
if (warning.length > 0 && warning !== "-" && !warnings.includes(warning)) warnings.push(warning);
}
}
return warnings;
}
function withWarnings(payload: Record<string, unknown>, warnings: readonly unknown[]): Record<string, unknown> {
const merged = mergeWarnings(payload.warnings, warnings);
return merged.length === 0 ? payload : { ...payload, warnings: merged, valuesRedacted: true };
}
function sentinelProgressEvent(event: string, payload: Record<string, unknown>): void {
@@ -1469,6 +1488,7 @@ function runSentinelMaintenance(state: SentinelCicdState, options: Extract<WebPr
function runSentinelValidate(state: SentinelCicdState, options: Extract<WebProbeSentinelOptions, { kind: "validate" }>): RenderedCliResult {
const command = "web-probe sentinel validate";
const startedAt = Date.now();
const initialHealth = callSentinelService(state, "GET", "/api/health", null, options.timeoutSeconds);
let quickVerify: Record<string, unknown> | null = null;
if (options.quickVerify) {
@@ -1508,6 +1528,9 @@ function runSentinelValidate(state: SentinelCicdState, options: Extract<WebProbe
const report = callSentinelService(state, "GET", "/api/report?view=summary", null, options.timeoutSeconds);
const publicExposure = probeSentinelPublicExposure(state, options.timeoutSeconds);
const publicDashboard = probeSentinelPublicDashboard(state, options.timeoutSeconds);
if (quickVerify !== null) {
quickVerify = withWarnings(quickVerify, sentinelElapsedWarnings(Date.now() - startedAt, "sentinel validate quick verify confirm-wait"));
}
const ok = health.ok
&& record(health.bodyJson).ok === true
&& metrics.ok
@@ -1572,6 +1595,9 @@ function renderAsyncP5Job(state: SentinelCicdState, subcommand: readonly string[
}
function runSentinelQuickVerify(state: SentinelCicdState, reason: string, timeoutSeconds: number): Record<string, unknown> {
const startedAt = Date.now();
const elapsedMs = () => Date.now() - startedAt;
const elapsedWarnings = () => sentinelElapsedWarnings(elapsedMs(), "quick verify confirm-wait");
const scenarioId = stringAt(state.cicd, "targetValidation.scenarioId");
const maxSeconds = numberAt(state.cicd, "targetValidation.maxSeconds");
const scenario = findScenario(state, scenarioId);
@@ -1595,6 +1621,7 @@ function runSentinelQuickVerify(state: SentinelCicdState, reason: string, timeou
steps.push({ phase: "observe-start", ok: started.ok, result: started.result });
const observerId = observerIdFromText(String(record(started.result).stdoutPreview ?? ""));
if (!started.ok || observerId === null) {
const findings = quickVerifyControlFindings("observe-start-failed", 0, null, null);
return recordQuickVerify(state, {
ok: false,
runId,
@@ -1602,8 +1629,12 @@ function runSentinelQuickVerify(state: SentinelCicdState, reason: string, timeou
reason,
status: "blocked",
observerId,
elapsedMs: elapsedMs(),
steps,
failure: "observe-start-failed",
findingCount: findings.length,
findings,
warnings: elapsedWarnings(),
valuesRedacted: true,
});
}
@@ -1621,7 +1652,8 @@ function runSentinelQuickVerify(state: SentinelCicdState, reason: string, timeou
promptIndex,
steps,
failure: "quick-verify-timeout-over-120s",
warnings: ["quick verify exceeded the configured 120s targetValidation budget; investigate env-reuse/git mirror/source build path before retrying."],
elapsedMs: elapsedMs(),
warnings: mergeWarnings("quick verify exceeded the configured 120s targetValidation budget; investigate env-reuse/git mirror/source build path before retrying.", elapsedWarnings()),
promptSource: prompts.summary,
}));
}
@@ -1642,6 +1674,8 @@ function runSentinelQuickVerify(state: SentinelCicdState, reason: string, timeou
promptIndex,
steps,
failure: `observe-command-${type}-failed`,
elapsedMs: elapsedMs(),
warnings: elapsedWarnings(),
promptSource: prompts.summary,
}));
}
@@ -1658,7 +1692,8 @@ function runSentinelQuickVerify(state: SentinelCicdState, reason: string, timeou
steps,
failure: text(waitResult.failure ?? "observe-turn-terminal-wait-failed"),
promptSource: prompts.summary,
warnings: Array.isArray(waitResult.warnings) ? waitResult.warnings : [],
elapsedMs: elapsedMs(),
warnings: mergeWarnings(Array.isArray(waitResult.warnings) ? waitResult.warnings : [], elapsedWarnings()),
}));
}
}
@@ -1670,7 +1705,11 @@ function runSentinelQuickVerify(state: SentinelCicdState, reason: string, timeou
const artifactSummary = indexEntry === null ? { ok: false, reason: "observe-index-entry-missing", observerId, valuesRedacted: true } : readAnalysisSummaryFromWorkspace(state, indexEntry.stateDir, remainingSeconds(deadline, 30));
const turnSummary = collectObserveView(state, observerId, "turn-summary", null, remainingSeconds(deadline, 30));
const traceFrame = collectObserveView(state, observerId, "trace-frame", promptIndex > 0 ? promptIndex : null, remainingSeconds(deadline, 30));
const ok = analysis.ok && record(artifactSummary).ok === true;
const controlFindings = quickVerifyControlFindings(null, promptIndex, turnSummary, traceFrame);
const artifactSummaryRecord = record(artifactSummary);
const artifactFindings = Array.isArray(artifactSummaryRecord.findings) ? artifactSummaryRecord.findings.map(record) : [];
const findings = mergeFindingRecords(artifactFindings, controlFindings);
const ok = analysis.ok && record(artifactSummary).ok === true && controlFindings.length === 0;
return recordQuickVerify(state, {
ok,
runId,
@@ -1678,10 +1717,12 @@ function runSentinelQuickVerify(state: SentinelCicdState, reason: string, timeou
reason,
status: ok ? "analyzed" : "blocked",
observerId,
elapsedMs: elapsedMs(),
stateDir: indexEntry?.stateDir ?? null,
reportJsonSha256: stringAtNullable(artifactSummary, "reportJsonSha256"),
findingCount: numberAtNullable(artifactSummary, "findingCount") ?? 0,
findingCount: findings.length,
artifactCount: numberAtNullable(artifactSummary, "artifactCount") ?? 0,
failure: controlFindings.length > 0 ? "quick-verify-no-business-turn" : null,
promptSource: prompts.summary,
steps,
analysis: artifactSummary,
@@ -1690,9 +1731,10 @@ function runSentinelQuickVerify(state: SentinelCicdState, reason: string, timeou
"turn-summary": { renderedText: typeof turnSummary.renderedText === "string" ? turnSummary.renderedText : null, ok: turnSummary.ok },
"trace-frame": { renderedText: typeof traceFrame.renderedText === "string" ? traceFrame.renderedText : null, ok: traceFrame.ok },
},
findings: Array.isArray(record(artifactSummary).findings) ? record(artifactSummary).findings : [],
findings,
screenshot: record(artifactSummary).screenshot,
publicOrigin: stringAt(state.publicExposure, "publicBaseUrl"),
warnings: elapsedWarnings(),
valuesRedacted: true,
});
}
@@ -1706,6 +1748,7 @@ function finalizeQuickVerifyFailure(state: SentinelCicdState, input: {
readonly steps: readonly Record<string, unknown>[];
readonly failure: string;
readonly promptSource?: Record<string, unknown>;
readonly elapsedMs?: number;
readonly warnings?: readonly unknown[];
}): Record<string, unknown> {
const cleanupSteps: Record<string, unknown>[] = [];
@@ -1741,6 +1784,10 @@ function finalizeQuickVerifyFailure(state: SentinelCicdState, input: {
: readAnalysisSummaryFromWorkspace(state, indexEntry.stateDir, 30);
const turnSummary = collectObserveView(state, input.observerId, "turn-summary", null, 30);
const traceFrame = collectObserveView(state, input.observerId, "trace-frame", input.promptIndex > 0 ? input.promptIndex : null, 30);
const controlFindings = quickVerifyControlFindings(input.failure, input.promptIndex, turnSummary, traceFrame);
const artifactSummaryRecord = record(artifactSummary);
const artifactFindings = Array.isArray(artifactSummaryRecord.findings) ? artifactSummaryRecord.findings.map(record) : [];
const findings = mergeFindingRecords(artifactFindings, controlFindings);
return {
ok: false,
runId: input.runId,
@@ -1748,9 +1795,10 @@ function finalizeQuickVerifyFailure(state: SentinelCicdState, input: {
reason: input.reason,
status: "blocked",
observerId: input.observerId,
elapsedMs: input.elapsedMs ?? null,
stateDir: indexEntry?.stateDir ?? null,
reportJsonSha256: stringAtNullable(artifactSummary, "reportJsonSha256"),
findingCount: numberAtNullable(artifactSummary, "findingCount") ?? 0,
findingCount: findings.length,
artifactCount: numberAtNullable(artifactSummary, "artifactCount") ?? 0,
failure: input.failure,
promptSource: input.promptSource,
@@ -1761,10 +1809,10 @@ function finalizeQuickVerifyFailure(state: SentinelCicdState, input: {
"turn-summary": { renderedText: typeof turnSummary.renderedText === "string" ? turnSummary.renderedText : null, ok: turnSummary.ok },
"trace-frame": { renderedText: typeof traceFrame.renderedText === "string" ? traceFrame.renderedText : null, ok: traceFrame.ok },
},
findings: Array.isArray(record(artifactSummary).findings) ? record(artifactSummary).findings : [],
findings,
screenshot: record(artifactSummary).screenshot,
publicOrigin: stringAt(state.publicExposure, "publicBaseUrl"),
warnings: Array.isArray(input.warnings) ? input.warnings.map(text) : [],
warnings: mergeWarnings(Array.isArray(input.warnings) ? input.warnings : [], sentinelElapsedWarnings(input.elapsedMs ?? null, "quick verify confirm-wait")),
valuesRedacted: true,
};
}
@@ -1782,6 +1830,9 @@ function recordQuickVerify(state: SentinelCicdState, payload: Record<string, unk
summary: {
reason: payload.reason,
status: payload.status,
elapsedMs: payload.elapsedMs,
failure: payload.failure,
warnings: Array.isArray(payload.warnings) ? payload.warnings : [],
analysis: payload.analysis,
promptSource: payload.promptSource,
steps: payload.steps,
@@ -2464,6 +2515,40 @@ function displayPath(pathValue: string): string {
return pathValue;
}
function mergeFindingRecords(primary: readonly Record<string, unknown>[], extra: readonly Record<string, unknown>[]): Record<string, unknown>[] {
const merged: Record<string, unknown>[] = [];
const seen = new Set<string>();
for (const item of [...primary, ...extra]) {
const id = stringAtNullable(item, "id") ?? stringAtNullable(item, "kind") ?? stringAtNullable(item, "code") ?? stringAtNullable(item, "finding_id") ?? "finding";
const severity = stringAtNullable(item, "severity") ?? stringAtNullable(item, "level") ?? "unknown";
const key = `${id}\0${severity}`;
if (seen.has(key)) continue;
seen.add(key);
merged.push(item);
}
return merged;
}
function quickVerifyControlFindings(failure: string | null, promptIndex: number, turnSummary: Record<string, unknown> | null, traceFrame: Record<string, unknown> | null): Record<string, unknown>[] {
const rendered = [
typeof turnSummary?.renderedText === "string" ? turnSummary.renderedText : "",
typeof traceFrame?.renderedText === "string" ? traceFrame.renderedText : "",
].join("\n");
const noPrompt = promptIndex <= 0 || /无\s*sendPrompt|no\s+sendPrompt/iu.test(rendered);
const noTrace = /无\s*trace\s*rows|no\s+trace\s+rows|traceId=-|routeSession=-|activeSession=-/iu.test(rendered);
const emptyFinal = /Final Response[\s\S]*\(空内容\)/iu.test(rendered);
if (!noPrompt && !noTrace && !emptyFinal && failure !== "observe-start-failed") return [];
return [{
id: "quick-verify-no-business-turn",
severity: "red",
count: 1,
summary: "quick verify did not reach a durable business turn/session/trace rows/final response; public dashboard health cannot be treated as HWLAB recovery.",
failure: failure ?? null,
promptIndex,
valuesRedacted: true,
}];
}
function compactCommandWithTail(result: CommandResult): CompactCommandResult & { stdoutTail: string; stderrTail: string } {
return {
...compactCommand(result),
@@ -1,4 +1,4 @@
// SPEC: PJ2026-01060508 Web哨兵 draft-2026-06-26-p7-web-probe-sentinel-dashboard.
// SPEC: PJ2026-01060508 Web哨兵 draft-2026-06-26-p8-web-probe-sentinel-recovery.
// Responsibility: Static dashboard shell and asset serving for the web-probe sentinel frontend.
import { readFileSync } from "node:fs";
import { rootPath } from "./config";
@@ -11,7 +11,7 @@ interface DashboardShellConfig {
}
const DASHBOARD_ASSET_ROOT = "scripts/assets/web-probe-sentinel-dashboard";
const DASHBOARD_CONTRACT_VERSION = "draft-2026-06-26-p7-web-probe-sentinel-dashboard";
const DASHBOARD_CONTRACT_VERSION = "draft-2026-06-26-p8-web-probe-sentinel-recovery";
export function renderWebProbeSentinelDashboardHtml(config: DashboardShellConfig): string {
const publicOrigin = stringOrNull(config.publicExposure.publicBaseUrl) ?? "";
@@ -20,7 +20,7 @@ export function renderWebProbeSentinelDashboardHtml(config: DashboardShellConfig
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>HWLAB Web Probe Sentinel</title>
<title>HWLAB Web哨兵</title>
<link rel="stylesheet" href="/dashboard/assets/dashboard.css">
</head>
<body>
@@ -33,58 +33,58 @@ export function renderWebProbeSentinelDashboardHtml(config: DashboardShellConfig
data-config-ready="${config.plan.ok ? "true" : "false"}"
data-contract-version="${DASHBOARD_CONTRACT_VERSION}"
>
<section class="sentinel-topbar" aria-label="Web probe sentinel overview">
<section class="sentinel-topbar" aria-label="Web哨兵概览">
<div class="sentinel-title">
<div class="sentinel-mark" aria-hidden="true"></div>
<div>
<h1>HWLAB Web Probe Sentinel</h1>
<h1>HWLAB Web哨兵</h1>
<p id="sentinel-subtitle">${escapeHtml(config.node)} / ${escapeHtml(config.lane)}</p>
</div>
</div>
<div class="sentinel-toolbar" aria-label="Dashboard controls">
<span id="status-pill" class="status-pill status-idle">idle</span>
<div class="sentinel-toolbar" aria-label="监控面板控制">
<span id="status-pill" class="status-pill status-idle"></span>
<label class="refresh-toggle">
<input id="auto-refresh-enabled" type="checkbox">
<span>Auto refresh</span>
<span></span>
</label>
<select id="auto-refresh-interval" aria-label="Auto refresh interval">
<select id="auto-refresh-interval" aria-label="自动刷新间隔">
<option value="5">5s</option>
<option value="10">10s</option>
<option value="30">30s</option>
</select>
<button id="manual-refresh" class="icon-button" type="button" title="Refresh" aria-label="Refresh">
<span aria-hidden="true">Refresh</span>
<button id="manual-refresh" class="icon-button" type="button" title="刷新" aria-label="刷新">
<span aria-hidden="true"></span>
</button>
</div>
</section>
<section id="loading-banner" class="banner banner-muted">Loading</section>
<section id="loading-banner" class="banner banner-muted"></section>
<section id="error-banner" class="banner banner-danger" hidden></section>
<section class="metric-grid" aria-label="Sentinel status metrics">
<section class="metric-grid" aria-label="哨兵状态指标">
<article class="metric-card">
<span class="metric-label">Overall</span>
<span class="metric-label"></span>
<strong id="metric-overall">-</strong>
<small id="metric-origin">-</small>
</article>
<article class="metric-card">
<span class="metric-label">Latest run</span>
<span class="metric-label"></span>
<strong id="metric-latest-run">-</strong>
<small id="metric-latest-age">-</small>
</article>
<article class="metric-card">
<span class="metric-label">Findings</span>
<span class="metric-label"></span>
<strong id="metric-findings">0</strong>
<small id="metric-findings-note">-</small>
</article>
<article class="metric-card">
<span class="metric-label">Scheduler</span>
<span class="metric-label"></span>
<strong id="metric-scheduler">-</strong>
<small id="metric-budget">-</small>
</article>
</section>
<section class="overview-checks" aria-label="Sentinel health checks">
<section class="overview-checks" aria-label="哨兵健康检查">
<span id="check-config" class="check-chip">config -</span>
<span id="check-pvc" class="check-chip">pvc -</span>
<span id="check-analyzer" class="check-chip">analyzer -</span>
@@ -94,7 +94,7 @@ export function renderWebProbeSentinelDashboardHtml(config: DashboardShellConfig
<section class="panel timeline-panel" aria-labelledby="timeline-heading">
<div class="panel-header">
<h2 id="timeline-heading">Run Timeline</h2>
<h2 id="timeline-heading">线</h2>
<span id="timeline-count" class="panel-subtitle">-</span>
</div>
<div id="run-timeline" class="run-timeline"></div>
@@ -103,34 +103,34 @@ export function renderWebProbeSentinelDashboardHtml(config: DashboardShellConfig
<section class="dashboard-grid">
<section class="panel panel-wide" aria-labelledby="runs-heading">
<div class="panel-header">
<h2 id="runs-heading">Runs</h2>
<h2 id="runs-heading"></h2>
<span id="runs-count" class="panel-subtitle">-</span>
</div>
<form id="runs-filter" class="runs-filter">
<label>
<span>Status</span>
<span></span>
<select id="filter-status" name="status">
<option value="">Any</option>
<option value="planned">planned</option>
<option value="running">running</option>
<option value="analyzed">analyzed</option>
<option value="blocked">blocked</option>
<option value="interrupted">interrupted</option>
<option value=""></option>
<option value="planned"></option>
<option value="running"></option>
<option value="analyzed"></option>
<option value="blocked"></option>
<option value="interrupted"></option>
</select>
</label>
<label>
<span>Severity</span>
<span></span>
<select id="filter-severity" name="severity">
<option value="">Any</option>
<option value="red">red</option>
<option value="warning">warning</option>
<option value="info">info</option>
<option value=""></option>
<option value="red"></option>
<option value="warning"></option>
<option value="info"></option>
</select>
</label>
<label>
<span>Time</span>
<span></span>
<select id="filter-window" name="window">
<option value="">All</option>
<option value=""></option>
<option value="1h">1h</option>
<option value="6h">6h</option>
<option value="24h">24h</option>
@@ -138,29 +138,29 @@ export function renderWebProbeSentinelDashboardHtml(config: DashboardShellConfig
</select>
</label>
<label>
<span>Sort</span>
<span></span>
<select id="filter-sort" name="sort">
<option value="updated">updated</option>
<option value="created">created</option>
<option value="findings">findings</option>
<option value="severity">severity</option>
<option value="updated"></option>
<option value="created"></option>
<option value="findings"></option>
<option value="severity"></option>
</select>
</label>
<label class="filter-search">
<span>Search</span>
<input id="filter-search" name="search" type="search" placeholder="run, observer, report">
<span></span>
<input id="filter-search" name="search" type="search" placeholder="runobserverreport">
</label>
<button id="clear-filters" class="icon-button" type="button">Clear</button>
<button id="clear-filters" class="icon-button" type="button"></button>
</form>
<div class="table-frame">
<table class="runs-table">
<thead>
<tr>
<th>Run</th>
<th>Status</th>
<th>Scenario</th>
<th>Findings</th>
<th>Updated</th>
<th></th>
<th></th>
<th></th>
<th></th>
<th></th>
</tr>
</thead>
<tbody id="runs-body"></tbody>
@@ -170,38 +170,38 @@ export function renderWebProbeSentinelDashboardHtml(config: DashboardShellConfig
<section class="panel" aria-labelledby="findings-heading">
<div class="panel-header">
<h2 id="findings-heading">Findings</h2>
<h2 id="findings-heading"></h2>
<span id="findings-count" class="panel-subtitle">-</span>
</div>
<form id="findings-filter" class="findings-filter">
<label>
<span>Severity</span>
<span></span>
<select id="finding-filter-severity" name="fseverity">
<option value="">Any</option>
<option value="red">red</option>
<option value="warning">warning</option>
<option value="info">info</option>
<option value=""></option>
<option value="red"></option>
<option value="warning"></option>
<option value="info"></option>
</select>
</label>
<label>
<span>Window</span>
<span></span>
<select id="finding-filter-window" name="fwindow">
<option value="24h">24h</option>
<option value="1h">1h</option>
<option value="6h">6h</option>
<option value="7d">7d</option>
<option value="">All</option>
<option value=""></option>
</select>
</label>
<label>
<span>Code</span>
<span></span>
<input id="finding-filter-code" name="fcode" type="search" placeholder="finding code">
</label>
<label>
<span>Scenario</span>
<span></span>
<input id="finding-filter-scenario" name="fscenario" type="search" placeholder="scenario">
</label>
<button id="finding-clear-filters" class="icon-button" type="button">Clear</button>
<button id="finding-clear-filters" class="icon-button" type="button"></button>
</form>
<div id="finding-aggregation" class="finding-aggregation"></div>
<div id="findings-list" class="finding-list"></div>
@@ -210,8 +210,8 @@ export function renderWebProbeSentinelDashboardHtml(config: DashboardShellConfig
<section class="panel detail-panel" aria-labelledby="detail-heading" role="dialog" aria-modal="false">
<div class="panel-header">
<h2 id="detail-heading">Run Detail</h2>
<span id="detail-subtitle" class="panel-subtitle">No run selected</span>
<h2 id="detail-heading"></h2>
<span id="detail-subtitle" class="panel-subtitle"></span>
</div>
<div id="detail-content" class="detail-content"></div>
</section>
@@ -1,5 +1,6 @@
// SPEC: PJ2026-01060508 Web哨兵 draft-2026-06-25-p0-web-probe-sentinel.
// SPEC: PJ2026-01060508 Web哨兵 draft-2026-06-26-p7-web-probe-sentinel-dashboard.
// SPEC: PJ2026-01060508 Web哨兵 draft-2026-06-26-p8-web-probe-sentinel-recovery.
// Responsibility: Persistent HTTP wrapper service for web-probe observe scheduling, index, health, metrics, maintenance, and dashboard.
import { Buffer } from "node:buffer";
import { createHash, randomUUID } from "node:crypto";
@@ -11,7 +12,7 @@ import { renderWebProbeSentinelDashboardHtml, webProbeSentinelDashboardAssetResp
import { webProbeSentinelConfigPlan, type WebProbeSentinelConfigPlan } from "./hwlab-node-web-sentinel-config";
import type { HwlabRuntimeLaneSpec } from "./hwlab-node-lanes";
const DASHBOARD_CONTRACT_VERSION = "draft-2026-06-26-p7-web-probe-sentinel-dashboard";
const DASHBOARD_CONTRACT_VERSION = "draft-2026-06-26-p8-web-probe-sentinel-recovery";
const DASHBOARD_MAX_TEXT_BYTES = 16_000;
export interface WebProbeSentinelServiceConfig {