kld-sdd 2.6.12 → 2.6.14

package/skywalk-sdd/reporting/change-report-renderer.cjs

@@ -0,0 +1,425 @@
+'use strict';
+
+const { buildChangeReportModel } = require('./change-report-model.cjs');
+
+function escapeHtml(value) {
+  return String(value ?? '').replace(/[&<>"']/g, (char) => ({
+    '&': '&amp;',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#39;',
+  }[char]));
+}
+
+function percent(value, digits = 2) {
+  return Number.isFinite(value) ? `${(value * 100).toFixed(digits)}%` : '暂无数据';
+}
+
+function duration(value) {
+  if (!Number.isFinite(value)) return '暂无数据';
+  const totalSeconds = Math.round(value / 1000);
+  const hours = Math.floor(totalSeconds / 3600);
+  const minutes = Math.floor((totalSeconds % 3600) / 60);
+  const seconds = totalSeconds % 60;
+  return [hours ? `${hours}小时` : '', minutes ? `${minutes}分` : '', `${seconds}秒`].filter(Boolean).join('');
+}
+
+function fraction(value, total) {
+  return value == null || total == null ? '暂无数据' : `${value} / ${total}`;
+}
+
+function durationMetricHtml(value) {
+  if (!Number.isFinite(value)) return '<span class="muted-null">null</span>';
+  return `${Math.round(value / 60000)}<span class="unit">分钟</span>`;
+}
+
+function statusTone(status) {
+  if (['trusted', 'complete', 'passed', 'verified', 'implemented'].includes(status)) return 'good';
+  if (['attention', 'incomplete', 'provisional', 'needs_input', 'open'].includes(status)) return 'warn';
+  if (['failed', 'blocked', 'error'].includes(status)) return 'bad';
+  return 'neutral';
+}
+
+function metricCard({ name, code, value, state, explanation, source }) {
+  return `<article class="metric-card">
+    <div class="metric-top"><span>${escapeHtml(name)}</span><span class="metric-code">${escapeHtml(code)}</span></div>
+    <strong>${escapeHtml(value)}</strong>
+    <div class="metric-state ${statusTone(state)}">${escapeHtml(state || '暂定')}</div>
+    <p>${escapeHtml(explanation)}</p>
+    <button class="info-btn" type="button" data-info="${escapeHtml(source || explanation)}" data-drawer-title="${escapeHtml(`${name} · ${code}`)}" data-drawer-body="${escapeHtml(source || explanation)}">查看计算口径与证据</button>
+  </article>`;
+}
+
+function renderChangeReportHtml(report) {
+  report = buildChangeReportModel(report);
+  const metrics = report.metrics || {};
+  const efficiency = metrics.efficiency || {};
+  const quality = metrics.quality || {};
+  const processMetrics = metrics.process || {};
+  const telemetry = metrics.telemetry_health || {};
+  const summary = report.change_summary || {};
+  const tests = summary.tests || {};
+  const tasks = summary.tasks || {};
+  const evidence = summary.evidence || { categories: [] };
+  const changed = report.changed_files || {};
+  const artifacts = report.artifacts?.files || {};
+  const minSet = report.minimum_metric_set || {};
+  const totalDuration = efficiency.total_duration_ms
+    ?? efficiency.effective_stage_duration_including_rework_ms
+    ?? efficiency.e1_lead_time_ms;
+  const e1 = efficiency.e1_scenario_delivery_efficiency_ms;
+  const e2 = efficiency.e2_coding_time_ratio_including_rework ?? efficiency.e2_coding_time_ratio;
+  const e3 = efficiency.e3_spec_time_ratio_including_rework ?? efficiency.e3_spec_time_ratio;
+  const conclusionTone = statusTone(report.conclusion?.status);
+  const evidenceCategories = Array.isArray(evidence.categories) ? evidence.categories : [];
+  const stageNodes = report.stage_timeline?._available && Array.isArray(report.stage_timeline.nodes)
+    ? report.stage_timeline.nodes
+    : [];
+  const activeLinks = report.attribution_audit?.active_links || [];
+  const candidateIds = report.attribution_audit?.unassigned_candidate_event_ids || [];
+  const knownWarnings = report.known_risks?.warnings || [];
+  const warningDetails = knownWarnings.flatMap((warning) => (
+    Array.isArray(warning.items) ? warning.items : []
+  ));
+  const telemetryWarnings = report.telemetry_warnings?.by_type || {};
+  const artifactRows = Object.entries(artifacts).map(([name, item]) => `
+    <tr>
+      <td>${escapeHtml({
+        markdown_report: 'Markdown 报告',
+        html_report: 'HTML 报告',
+        json_report: 'JSON 报告',
+        execution_log: '执行日志',
+        manifest: '归档清单',
+        archive_zip: '归档包',
+      }[name] || name)}</td>
+      <td><span class="state ${item?.exists ? 'good' : 'neutral'}">${item?.exists ? '已生成' : '未生成'}</span></td>
+      <td class="path">${escapeHtml(item?.path || '—')}</td>
+      <td>${item?.size_bytes == null ? '—' : escapeHtml(`${item.size_bytes} B`)}</td>
+    </tr>`).join('');
+  const evidenceRows = evidenceCategories.map((group) => `
+    <article class="issue-row">
+      <div><span class="issue-count">${escapeHtml(group.occurrence_count)}</span></div>
+      <div>
+        <h3>${escapeHtml(group.label)}</h3>
+        <p>${escapeHtml(group.affected_tasks?.length || 0)} 个关联任务 · ${escapeHtml(group.event_ids?.length || 0)} 个可定位事件</p>
+      </div>
+      <button class="text-button drawer-trigger" type="button"
+        data-drawer-title="${escapeHtml(group.label)}"
+        data-drawer-body="${escapeHtml(`规则编码：${group.code}\n关联任务：${(group.affected_tasks || []).join('、') || '无'}\n事件：${(group.event_ids || []).join('、') || '无'}\n处置：${JSON.stringify(group.dispositions || {})}`)}">查看详情</button>
+    </article>`).join('');
+  const stageRows = stageNodes.map((node) => {
+    const stage = node.stage || node.command || '未知阶段';
+    const round = node.round || 1;
+    const start = node.start_ts ? new Date(node.start_ts).toLocaleTimeString('zh-CN', { hour: '2-digit', minute: '2-digit' }) : '—';
+    const end = node.end_ts ? new Date(node.end_ts).toLocaleTimeString('zh-CN', { hour: '2-digit', minute: '2-digit' }) : '—';
+    return `
+    <tr class="tl-node">
+      <td>${escapeHtml(stage)}${round > 1 ? '²' : ''}${round > 1 ? '<span class="tl-repeat">R</span>' : ''}</td>
+      <td>${escapeHtml(node.round || 1)}</td>
+      <td><span class="tl-time">${escapeHtml(start)}→${escapeHtml(end)}</span><br>${escapeHtml(duration(node.duration_ms))}</td>
+      <td><span class="state ${statusTone(node.result === 'success' ? 'passed' : node.result)}">${escapeHtml(node.result || '未知')}</span></td>
+    </tr>`;
+  }).join('');
+
+  const metricCards = [
+    {
+      name: '每个场景平均用时',
+      code: 'E1',
+      value: Number.isFinite(e1) ? `${duration(e1)} / 场景` : '暂无数据',
+      state: (
+        minSet.evidence_status?.e1 === 'trusted'
+        || minSet.trusted_metrics?.includes?.('e1')
+        || minSet.trusted?.includes?.('e1')
+      ) ? '可信' : '需补证',
+      explanation: '七个标准阶段总耗时（含返工）÷ 验收场景数。',
+      source: `公式：标准阶段总耗时 ÷ 场景数。场景数：${efficiency.scenario_count ?? '未知'}；当前值：${e1 ?? '不可计算'} ms。`,
+    },
+    {
+      name: '规约检查得分',
+      code: 'Q3',
+      value: quality.q3_spec_quality_score == null ? '暂无数据' : `${quality.q3_spec_quality_score} / 100`,
+      state: quality.q3_score_status === 'verified' ? '已验证' : '临时',
+      explanation: '最新规约检查结果；独立复核后才标记为已验证。',
+      source: `评审独立性：${quality.q3_reviewer_independence || '未知'}；证据状态：${quality.q3_score_status || '未知'}。`,
+    },
+    {
+      name: '编码前已完成检查',
+      code: 'P4',
+      value: percent(processMetrics.p4_quality_gate_enforcement_rate),
+      state: Number.isFinite(processMetrics.p4_quality_gate_enforcement_rate) ? '可计算' : '需补证',
+      explanation: '编码前是否先检查：首次进入编码前，是否存在已配对且成功或部分通过的检查。',
+      source: '只接受能与 check 开始事件配对、且发生在首次 apply 之前的成功或部分通过结果。',
+    },
+    {
+      name: '阶段重复次数',
+      code: 'P-R',
+      value: processMetrics.rework_summary?.total_rework_attempts == null
+        ? '暂无数据'
+        : `${processMetrics.rework_summary.total_rework_attempts} 次`,
+      state: processMetrics.rework_summary ? '可计算' : '需补证',
+      explanation: '七个标准阶段中，首次执行之后的重复尝试次数。',
+      source: '辅助 test / explore 阶段不计入标准阶段返工总数。',
+    },
+    {
+      name: '执行记录完整度',
+      code: 'P-H',
+      value: telemetry.p_h_telemetry_health_score == null
+        ? '暂无数据'
+        : `${telemetry.p_h_telemetry_health_score} / 100`,
+      state: telemetry.p_h_telemetry_health_score == null ? '需补证' : '可计算',
+      explanation: '执行记录是否完整：标准阶段的身份、开始结束配对和数据质量综合评分。',
+      source: '沿用既有权重，但只以 propose、spec、design、task、check、apply、archive 七阶段为计算范围。',
+    },
+  ].map(metricCard).join('');
+
+  return `<!doctype html>
+<html lang="zh-CN" data-theme="light">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>SDD 效果度量报告 · ${escapeHtml(report.change)}</title>
+<style>
+:root{--ink:#16213a;--muted:#68758c;--line:#dfe5ef;--paper:#fff;--canvas:#eef2f7;--blue:#175cd3;--blue-soft:#edf4ff;--good:#067647;--good-soft:#ecfdf3;--warn:#b54708;--warn-soft:#fffaeb;--bad:#b42318;--bad-soft:#fef3f2;--shadow:0 18px 54px rgba(31,43,66,.1)}
+*{box-sizing:border-box}
+[hidden]{display:none!important}
+body{margin:0;min-width:1040px;background:var(--canvas);color:var(--ink);font:14px/1.55 "Segoe UI","Microsoft YaHei",sans-serif}
+button{font:inherit}
+.shell{width:min(1280px,calc(100% - 56px));margin:26px auto 46px}
+.report-head{position:sticky;top:0;z-index:20;background:rgba(255,255,255,.96);border:1px solid var(--line);border-radius:18px 18px 0 0;box-shadow:var(--shadow);backdrop-filter:blur(12px)}
+.identity{display:flex;align-items:center;justify-content:space-between;padding:22px 26px 16px;gap:24px}
+.eyebrow{color:var(--blue);font-weight:750;font-size:12px;letter-spacing:.08em}
+h1{font-size:26px;line-height:1.2;margin:3px 0 7px;letter-spacing:-.025em}
+.meta,.micro{color:var(--muted);font-size:12px}.meta code{color:#35425a}
+.freshness{text-align:right}.freshness strong{display:block;color:var(--good);font-size:13px}
+.tabs{display:flex;padding:0 18px;border-top:1px solid #eef1f5}
+.tabs button{border:0;border-bottom:3px solid transparent;background:none;color:#56647b;padding:14px 18px 12px;cursor:pointer;font-weight:650}
+.tabs button:hover{color:var(--blue)}.tabs button:focus-visible{outline:3px solid #b2ccff;outline-offset:-3px}
+.tabs button[aria-selected="true"]{color:var(--blue);border-color:var(--blue)}
+.panel{background:#f8fafc;border:1px solid var(--line);border-top:0;border-radius:0 0 18px 18px;padding:22px;min-height:560px}
+.hero{display:grid;grid-template-columns:1.55fr .45fr;gap:16px;margin-bottom:16px}
+.card{background:var(--paper);border:1px solid var(--line);border-radius:14px;padding:18px}
+.conclusion{background:linear-gradient(135deg,#f7faff,#eef5ff);border-color:#c8d9f5}
+.conclusion h2,.section-head h2{margin:0}.conclusion p{font-size:18px;font-weight:680;color:#203e73;margin:10px 0 0}
+.scope{display:flex;flex-direction:column;justify-content:center}.scope strong{font-size:19px}.scope span{color:var(--muted);margin-top:4px}
+.summary-grid{display:grid;grid-template-columns:repeat(4,1fr);gap:12px}
+.summary-card{background:#fff;border:1px solid var(--line);border-radius:14px;padding:16px;min-height:112px}
+.summary-card span{color:var(--muted);font-size:12px}.summary-card strong{display:block;font-size:24px;margin:7px 0 2px;font-variant-numeric:tabular-nums}.summary-card p{margin:0;color:var(--muted);font-size:11px}
+.section{margin-top:16px}.section-head{display:flex;align-items:end;justify-content:space-between;margin-bottom:11px}.section-head p{margin:0;color:var(--muted);font-size:12px}
+.metric-grid{display:grid;grid-template-columns:repeat(5,1fr);gap:12px}
+.metric-card{background:#fff;border:1px solid var(--line);border-radius:14px;padding:15px;min-height:210px;display:flex;flex-direction:column}
+.metric-top{display:flex;justify-content:space-between;gap:8px;color:#344054;font-weight:700}.metric-code{color:var(--blue);background:var(--blue-soft);border-radius:999px;padding:1px 7px;font-size:11px;white-space:nowrap}
+.metric-card>strong{font-size:21px;margin:15px 0 5px}.metric-card p{color:var(--muted);font-size:12px;margin:10px 0;flex:1}
+.metric-state,.state{display:inline-flex;width:max-content;border-radius:999px;padding:2px 8px;font-size:11px;font-weight:700;background:#f2f4f7;color:#475467}
+.good{background:var(--good-soft)!important;color:var(--good)!important}.warn{background:var(--warn-soft)!important;color:var(--warn)!important}.bad{background:var(--bad-soft)!important;color:var(--bad)!important}.neutral{background:#f2f4f7!important;color:#475467!important}
+.text-button{border:0;background:none;color:var(--blue);padding:0;cursor:pointer;text-align:left;font-weight:650;font-size:12px}.text-button:hover{text-decoration:underline}.text-button:focus-visible{outline:3px solid #b2ccff;outline-offset:3px}
+.info-btn{border:0;background:none;color:var(--blue);padding:0;cursor:pointer;text-align:left;font-weight:650;font-size:12px}.muted-null{color:var(--muted)}
+.two-col{display:grid;grid-template-columns:1fr 1fr;gap:16px}.wide-card{background:#fff;border:1px solid var(--line);border-radius:14px;padding:18px}
+table{width:100%;border-collapse:collapse}th,td{padding:11px 10px;border-bottom:1px solid #edf0f4;text-align:left;vertical-align:top}th{font-size:12px;color:var(--muted)}tr:last-child td{border-bottom:0}.path{max-width:420px;overflow-wrap:anywhere;color:#475467;font-family:Consolas,monospace;font-size:11px}
+.issue-summary{display:flex;align-items:center;gap:12px;background:var(--warn-soft);border:1px solid #fedf89;border-radius:14px;padding:15px 18px;margin-bottom:12px}.issue-summary strong{font-size:18px}.issue-summary p{margin:0;color:#7a2e0e}
+.issue-row{display:grid;grid-template-columns:52px 1fr auto;align-items:center;gap:14px;padding:15px 4px;border-bottom:1px solid #edf0f4}.issue-row:last-child{border-bottom:0}.issue-count{display:grid;place-items:center;width:42px;height:42px;border-radius:12px;background:var(--warn-soft);color:var(--warn);font-weight:800}.issue-row h3{margin:0 0 2px}.issue-row p{margin:0;color:var(--muted);font-size:12px}
+.callout{border-left:4px solid var(--blue);background:var(--blue-soft);padding:12px 14px;border-radius:0 10px 10px 0;color:#344054}
+.drawer-backdrop{position:fixed;inset:0;z-index:40;background:rgba(15,23,42,.42);display:none}.drawer-backdrop.open{display:block}
+.drawer{position:absolute;right:0;top:0;height:100%;width:520px;background:#fff;padding:26px;box-shadow:-20px 0 70px rgba(15,23,42,.22);overflow:auto}
+.drawer-head{display:flex;justify-content:space-between;gap:16px;align-items:start}.drawer h2{margin:0}.drawer pre{white-space:pre-wrap;word-break:break-word;background:#f8fafc;border:1px solid var(--line);border-radius:12px;padding:15px;color:#344054}
+.icon-button{border:1px solid var(--line);background:#fff;border-radius:9px;width:34px;height:34px;cursor:pointer}.icon-button:focus-visible{outline:3px solid #b2ccff}
+@media print{body{min-width:0;background:#fff}.shell{width:100%;margin:0}.report-head{position:static;box-shadow:none}.tabs{display:none}.panel{display:block!important;border:0;min-height:0;break-before:page}.drawer-backdrop{display:none!important}}
+</style>
+</head>
+<body>
+<main class="shell">
+  <header class="report-head">
+    <div class="identity">
+      <div>
+        <div class="eyebrow">SDD · 单次变更报告</div>
+        <h1>${escapeHtml(report.change)}</h1>
+        <div class="meta">仅展示本次变更 · Schema ${escapeHtml(report.schema_version)} · 指标契约 ${escapeHtml(report.metrics_contract)}</div>
+      </div>
+      <div class="freshness"><strong>数据范围已锁定</strong><span class="micro">生成于 ${escapeHtml(report.generated_at || '未知')}</span></div>
+    </div>
+    <nav class="tabs" role="tablist" aria-label="报告章节">
+      <button role="tab" id="tab-overview" aria-controls="panel-overview" aria-selected="true" tabindex="0">概览</button>
+      <button role="tab" id="tab-metrics" aria-controls="panel-metrics" aria-selected="false" tabindex="-1">指标与阶段</button>
+      <button role="tab" id="tab-evidence" aria-controls="panel-evidence" aria-selected="false" tabindex="-1">问题与证据</button>
+      <button role="tab" id="tab-artifacts" aria-controls="panel-artifacts" aria-selected="false" tabindex="-1">产物与追溯</button>
+    </nav>
+  </header>
+
+  <section class="panel" role="tabpanel" id="panel-overview" aria-labelledby="tab-overview">
+    <div class="hero">
+      <article class="card conclusion">
+        <span class="state ${conclusionTone}">${escapeHtml(report.conclusion?.status === 'trusted' ? '结论可信' : '需要关注')}</span>
+        <h2>一句话结论</h2>
+        <p>${escapeHtml(report.conclusion?.text || '当前证据不足，暂不能形成可信结论。')}</p>
+      </article>
+      <article class="card scope"><span>七个标准阶段总耗时</span><strong>${escapeHtml(duration(totalDuration))}</strong><span>辅助阶段不进入效率分母</span></article>
+    </div>
+    <div class="summary-grid">
+      <article class="summary-card"><span>最终测试</span><strong>${escapeHtml(fraction(tests.passed, tests.total))}</strong><p>${tests.status === 'passed' ? '最终权威运行全部通过' : '暂无可验证的最终运行'}</p></article>
+      <article class="summary-card"><span>文档任务完成</span><strong>${escapeHtml(fraction(tasks.document?.completed, tasks.document?.total))}</strong><p>来自 tasks 文档状态</p></article>
+      <article class="summary-card"><span>事件可追溯</span><strong>${escapeHtml(fraction(tasks.traceability?.verified, tasks.traceability?.total))}</strong><p>来自严格 task/test 事件对账</p></article>
+      <article class="summary-card"><span>证据问题</span><strong>${escapeHtml(evidence.category_count ?? 0)} 类</strong><p>${escapeHtml(evidence.occurrence_count ?? 0)} 次规则命中，不等于独立缺陷数</p></article>
+    </div>
+    <div class="section">
+      <div class="section-head"><h2>核心指标</h2><p>中文业务名称为主，编码仅作定位标签</p></div>
+      <div class="metric-grid">${metricCards}</div>
+    </div>
+    <div class="section card">
+      <div class="section-head"><h2>需要处理</h2><p>证据问题已归并到“问题与证据”页签</p></div>
+      <p class="${evidence.category_count ? 'warn' : 'good'} state">${evidence.category_count ? `${escapeHtml(evidence.category_count)} 类问题待处置` : '当前无需处理'}</p>
+      ${telemetryWarnings.task_update_reuse > 0 ? '<div class="quality-alert">检测到 task_update 复用；相关可信度已降级。</div>' : ''}
+    </div>
+  </section>
+
+  <section class="panel" role="tabpanel" id="panel-metrics" aria-labelledby="tab-metrics" hidden>
+    <div class="section-head"><div><h2>指标与阶段</h2><p>本页只解释本次变更的计算口径和阶段执行。</p></div></div>
+    <div class="two-col">
+      <article class="wide-card">
+        <h3>效率拆分</h3>
+        <table><tbody>
+          <tr><td>七阶段总耗时</td><td><strong>${escapeHtml(duration(totalDuration))}</strong></td></tr>
+          <tr><td>每个场景平均用时 <span class="metric-code">E1</span></td><td>${escapeHtml(Number.isFinite(e1) ? `${duration(e1)} / 场景` : '暂无数据')}</td></tr>
+          <tr><td>编码时间占比 <span class="metric-code">E2</span></td><td>${escapeHtml(percent(e2))}</td></tr>
+          <tr><td>规划与规约时间占比 <span class="metric-code">E3</span></td><td>${escapeHtml(percent(e3))}</td></tr>
+        </tbody></table>
+      </article>
+      <article class="wide-card">
+        <h3>时间线与阶段执行明细</h3>
+        <table><thead><tr><th>阶段</th><th>轮次</th><th>耗时</th><th>结果</th></tr></thead><tbody>${stageRows || '<tr><td colspan="4">暂无阶段明细</td></tr>'}</tbody></table>
+      </article>
+    </div>
+    <p class="callout">标准阶段固定为：提案、规格、设计、任务拆解、检查、实现、归档。测试和探索属于辅助阶段，不计入效率分母。</p>
+    <details class="legacy-appendix">
+      <summary>历史兼容数据（默认折叠，仅供旧版消费者对照）</summary>
+      <div class="two-col wide-card section">
+        <div>
+          <h3>Legacy 效率指标</h3>
+          <p>一次成码率：${escapeHtml(percent(efficiency.e4_ai_code_first_pass_rate))}</p>
+          <h3>Legacy 质量指标</h3>
+          <p>规约符合度：${escapeHtml(quality.q1_spec_conformance_score ?? '暂无数据')}</p>
+          <h3>Legacy 过程指标</h3>
+          <p>阶段重复执行：${escapeHtml(processMetrics.rework_summary?.total_rework_attempts ?? '暂无数据')}</p>
+          <p>阶段间等待：${durationMetricHtml(efficiency.idle_time_ms)}</p>
+          <p>Q1 规约符合度：${escapeHtml(quality.q1_spec_conformance_score ?? '暂无数据')}${quality.q1_human_status === 'unverified' ? '（自评·待人工确认）' : ''}</p>
+          <p>E4 一次成码率：${escapeHtml(percent(efficiency.e4_ai_code_first_pass_rate))}（基于 task_update 信号判定，非代码 diff）${telemetryWarnings.task_update_reuse > 0 ? '；受 task_update 复用影响，已扣分' : ''}</p>
+          <p>过程记录事件：${escapeHtml(report.process_notes?.total ?? 0)} 条</p>
+          ${changed._available ? '' : '<p><span class="muted-null">null</span>：旧版文件统计不可用</p>'}
+        </div>
+        <div>
+          <h3>重复执行原因</h3>
+          <p>${escapeHtml((processMetrics.rework_summary?.reasons?.details || []).map((item) => item.reason === 'pre-archive-recheck' ? '归档前强制复检' : item.reason).join('、') || '无')}</p>
+        </div>
+      </div>
+    </details>
+  </section>
+
+  <section class="panel" role="tabpanel" id="panel-evidence" aria-labelledby="tab-evidence" hidden>
+    <div class="section-head"><div><h2>问题与证据</h2><p>按问题类别聚合；展开后再查看任务和事件，不把规则命中误称为独立缺陷。</p></div></div>
+    <div class="issue-summary"><strong>${escapeHtml(evidence.category_count ?? 0)} 类问题</strong><p>${escapeHtml(evidence.occurrence_count ?? 0)} 次规则命中</p></div>
+    <article class="wide-card">${evidenceRows || '<p class="micro">当前没有证据问题。</p>'}</article>
+    ${warningDetails.length > 0 ? `<article class="wide-card section"><h3>已知风险明细</h3>${warningDetails.map((item) => `<p>${escapeHtml(item.description || '待确认项')}${item.target ? `（${escapeHtml(item.target)}）` : ''}</p>`).join('')}</article>` : ''}
+    <p class="callout">${escapeHtml(evidence.note || '同一任务可能命中多条规则，命中次数不等于独立缺陷数。')}</p>
+  </section>
+
+  <section class="panel" role="tabpanel" id="panel-artifacts" aria-labelledby="tab-artifacts" hidden>
+    <div class="section-head"><div><h2>产物与追溯</h2><p>文件口径、变更归因和实际落盘产物均独立展示。</p></div></div>
+    <div class="two-col">
+      <article class="wide-card">
+        <h3>变更文件 · 双口径</h3>
+        <table><tbody>
+          <tr><td>任务事件累计文件</td><td><strong>${escapeHtml(changed.task_event_files_changed ?? '暂无数据')}</strong></td></tr>
+          <tr><td>最终输出快照文件</td><td><strong>${escapeHtml(changed.final_output_files_changed ?? '暂无数据')}</strong></td></tr>
+          <tr><td>新增 / 删除行</td><td>${escapeHtml(changed.added_lines ?? '暂无数据')} / ${escapeHtml(changed.deleted_lines ?? '暂无数据')}</td></tr>
+          <tr><td>数据来源</td><td>${escapeHtml(changed.diff_source || '未知')}</td></tr>
+        </tbody></table>
+        <p class="micro">${escapeHtml(changed.reconciliation_note || '暂无口径说明。')}</p>
+      </article>
+      <article class="wide-card">
+        <h3>归因审计</h3>
+        <table><tbody>
+          <tr><td>显式关联历史事件</td><td>${escapeHtml(report.attribution_audit?.linked_source_event_count ?? activeLinks.length)}</td></tr>
+          <tr><td>有效关联</td><td>${escapeHtml(activeLinks.length)}</td></tr>
+          <tr><td>未归属候选</td><td>${escapeHtml(candidateIds.length)}</td></tr>
+        </tbody></table>
+        <button class="text-button drawer-trigger" type="button" data-drawer-title="归因审计详情" data-drawer-body="${escapeHtml(`有效关联：${JSON.stringify(activeLinks)}\n未归属候选：${candidateIds.join('、') || '无'}`)}">查看归因事件</button>
+      </article>
+    </div>
+    <article class="wide-card section">
+      <h3>产物清单 · 实际产物 · 归档结果</h3>
+      <table><thead><tr><th>产物</th><th>状态</th><th>路径</th><th>大小</th></tr></thead><tbody>${artifactRows}</tbody></table>
+    </article>
+    <article class="wide-card section"><h3>已知风险</h3><p>${knownWarnings.length ? `${escapeHtml(knownWarnings.length)} 组风险记录，详情见“问题与证据”。` : '严重问题：0 · 无需修复。'}</p><p class="micro">${escapeHtml(report.archive_result?.archive_path || report.artifacts?.archive_path || '归档目录暂不可用')}</p></article>
+  </section>
+</main>
+
+<div class="drawer-backdrop" id="drawerBackdrop" aria-hidden="true">
+  <aside class="drawer" role="dialog" aria-modal="true" aria-labelledby="drawerTitle" aria-describedby="drawerBody" tabindex="-1">
+    <div class="drawer-head"><div><div class="eyebrow">报告详情</div><h2 id="drawerTitle">详情</h2></div><button class="icon-button" id="drawerClose" type="button" aria-label="关闭详情">×</button></div>
+    <pre id="drawerBody"></pre>
+  </aside>
+</div>
+<noscript><p class="callout">当前浏览器未启用脚本；请打印本报告或查看 Markdown / JSON 产物。查看证据时可使用“问题与证据”章节。</p></noscript>
+<script>
+(function(){
+  var tabs=Array.prototype.slice.call(document.querySelectorAll('[role="tab"]'));
+  var panels=Array.prototype.slice.call(document.querySelectorAll('[role="tabpanel"]'));
+  function activate(tab,focus){
+    tabs.forEach(function(item){
+      var selected=item===tab;
+      item.setAttribute('aria-selected',selected?'true':'false');
+      item.tabIndex=selected?0:-1;
+      document.getElementById(item.getAttribute('aria-controls')).hidden=!selected;
+    });
+    if(focus)tab.focus();
+  }
+  tabs.forEach(function(tab,index){
+    tab.addEventListener('click',function(){activate(tab,false);});
+    tab.addEventListener('keydown',function(event){
+      var next=index;
+      if(event.key === 'ArrowRight')next=(index+1)%tabs.length;
+      else if(event.key==='ArrowLeft')next=(index-1+tabs.length)%tabs.length;
+      else if(event.key==='Home')next=0;
+      else if(event.key==='End')next=tabs.length-1;
+      else return;
+      event.preventDefault();activate(tabs[next],true);
+    });
+  });
+  var backdrop=document.getElementById('drawerBackdrop');
+  var drawer=backdrop.querySelector('.drawer');
+  var drawerTitle=document.getElementById('drawerTitle');
+  var drawerBody=document.getElementById('drawerBody');
+  var lastTrigger=null;
+  function closeDrawer(){
+    if(!backdrop.classList.contains('open'))return;
+    backdrop.classList.remove('open');backdrop.setAttribute('aria-hidden','true');
+    if(lastTrigger)lastTrigger.focus();
+  }
+  document.querySelectorAll('.drawer-trigger,.info-btn').forEach(function(button){
+    button.addEventListener('click',function(){
+      lastTrigger=button;drawerTitle.textContent=button.dataset.drawerTitle||'详情';
+      drawerBody.textContent=button.dataset.drawerBody||'暂无详情';
+      backdrop.classList.add('open');backdrop.setAttribute('aria-hidden','false');drawer.focus();
+    });
+  });
+  document.getElementById('drawerClose').addEventListener('click',closeDrawer);
+  backdrop.addEventListener('click',function(event){if(event.target===backdrop)closeDrawer();});
+  document.addEventListener('keydown',function(event){
+    if(event.key === 'Escape')closeDrawer();
+    var e=event;
+    if(e.key==='Tab'&&backdrop.classList.contains('open')){
+      var items=drawer.querySelectorAll('button,[href],[tabindex]:not([tabindex="-1"])');
+      var first=items[0],last=items[items.length-1];
+      if(event.shiftKey&&document.activeElement===first){event.preventDefault();last.focus();}
+      else if(!event.shiftKey&&document.activeElement===last){event.preventDefault();first.focus();}
+    }
+  });
+})();
+</script>
+</body>
+</html>`;
+}
+
+module.exports = {
+  escapeHtml,
+  renderChangeReportHtml,
+};

package/skywalk-sdd/runtime-metadata.cjs

@@ -0,0 +1,21 @@
+'use strict';
+
+const path = require('path');
+
+/**
+ * 解析运行时元数据，返回 producer 身份信息。
+ *
+ * 开发/测试模式：直接读取上级 package.json 的 version 字段。
+ * 部署模式：init.js 会生成一个版本号写死的 runtime-metadata.cjs 覆盖此文件。
+ *
+ * @returns {{ version: string, producer: string }}
+ */
+function resolveRuntimeMetadata() {
+  const pkg = require(path.join(__dirname, '..', 'package.json'));
+  return {
+    version: pkg.version,
+    producer: `kld-sdd@${pkg.version}`,
+  };
+}
+
+module.exports = { resolveRuntimeMetadata };

package/templates/hooks/claude/hooks/sdd-apply-test-gate.cjs

@@ -144,6 +144,26 @@ function isRealTestDetails(testResults) {
   return false;
 }
 
+function isPassingTestDetails(testResults) {
+  if (!isRealTestDetails(testResults)) return false;
+  const failed = Number(testResults.failed);
+  const exitCode = Number(testResults.exit_code);
+  return (!Number.isFinite(failed) || failed === 0)
+    && (!Number.isFinite(exitCode) || exitCode === 0);
+}
+
+function isStrictTestEvidence(event, changeName) {
+  const testResults = event?.details?.test_results;
+  if (event?.type !== 'test_result' || event.change !== changeName) return false;
+  if (!event.run_id || !event.source || testResults?.evidence_tier !== 'strict') return false;
+  if (!['green', 'refactor', 'regression'].includes(testResults.tdd_phase)) return false;
+  if (!Number.isInteger(testResults.exit_code) || testResults.counts_known !== true) return false;
+  return event.result === 'success'
+    && testResults.exit_code === 0
+    && Number(testResults.failed) === 0
+    && isPassingTestDetails(testResults);
+}
+
 function loadChangeEvents(projectRoot, changeName) {
   const safe = safeChangeName(changeName);
   const dir = path.join(projectRoot, 'skywalk-sdd', 'events', safe);
@@ -170,33 +190,36 @@ function loadChangeEvents(projectRoot, changeName) {
 function hasRealTestExecution(projectRoot, changeName, capability, sinceTimestamp) {
   const since = sinceTimestamp ? new Date(sinceTimestamp).getTime() : 0;
   const events = loadChangeEvents(projectRoot, changeName);
+  let legacyEvidence = null;
 
   for (const event of events) {
     const ts = new Date(event.timestamp || 0).getTime();
     if (since && ts < since) continue;
 
-    if (event.type === 'stage_end' && event.command === 'test' &&
-        (event.result === 'success' || event.result === 'failure')) {
-      return { kind: 'opsx-test', event };
+    if (event.type === 'stage_end' && event.command === 'test' && event.result === 'success') {
+      legacyEvidence ||= { kind: 'legacy-opsx-test', event };
     }
 
     if (event.type === 'test_result') {
       const tr = event.details && event.details.test_results;
-      if (isRealTestDetails(tr)) {
-        return { kind: 'test_result', event };
+      if (isStrictTestEvidence(event, changeName)) {
+        return { kind: 'strict-test-result', event };
+      }
+      if (event.result === 'success' && isPassingTestDetails(tr)) {
+        legacyEvidence ||= { kind: 'legacy-test-result', event };
       }
     }
 
     if (event.type === 'task_update' && (event.command === 'apply' || !event.command)) {
       const tr = event.details && event.details.test_results;
-      if (isRealTestDetails(tr)) {
+      if (event.result !== 'failure' && isPassingTestDetails(tr)) {
         if (!capability || !event.capability || event.capability === capability) {
-          return { kind: 'task_update', event };
+          legacyEvidence ||= { kind: 'legacy-task-update', event };
         }
       }
     }
   }
-  return null;
+  return legacyEvidence;
 }
 
 function isApplyCompletionBash(command) {
@@ -281,9 +304,10 @@ function shouldGate(projectRoot, applyEvent) {
     applyEvent.capability,
     applyEvent.timestamp
   );
-  if (evidence) {
+  if (evidence?.kind === 'strict-test-result') {
     return null;
   }
+  if (evidence) return { strategy, changeName: applyEvent.change, capability: applyEvent.capability, legacyEvidence: evidence };
   return { strategy, changeName: applyEvent.change, capability: applyEvent.capability };
 }
 
@@ -441,6 +465,11 @@ if (require.main === module) {
   if (!gate) {
     process.exit(0);
   }
+  if (gate.legacyEvidence) {
+    recordWarning(projectRoot, { ...activeApply, test_strategy: gate.strategy }, 'legacy_test_evidence',
+      '仅检测到旧版测试证据；本次兼容放行，请补录包含 run-id、exit code、TDD phase 和严格身份字段的 test_result');
+    process.exit(0);
+  }
 
   const reason = buildReason(gate.strategy, gate.changeName, gate.capability);
   recordWarning(projectRoot, { ...activeApply, test_strategy: gate.strategy }, 'apply_test_missing', 'Apply test gate blocked: no unit test evidence');
@@ -458,5 +487,6 @@ module.exports = {
   detectMissingTddRed,
   hasExistingWarning,
   isRealTestDetails,
+  isStrictTestEvidence,
   requiresUnitTests,
 };