kld-sdd 2.6.14 → 2.6.16

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

@@ -1,6 +1,7 @@
 'use strict';
 
 const { buildChangeReportModel } = require('./change-report-model.cjs');
+const { buildChangeReportViewModel } = require('./change-report-view-model.cjs');
 
 function escapeHtml(value) {
   return String(value ?? '').replace(/[&<>"']/g, (char) => ({
@@ -12,28 +13,6 @@ function escapeHtml(value) {
   }[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';
@@ -52,38 +31,33 @@ function metricCard({ name, code, value, state, explanation, source }) {
 }
 
 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 || {};
+  if (!report.change_summary || !report.artifacts?.files) {
+    report = buildChangeReportModel(report);
+  }
+  const view = buildChangeReportViewModel(report);
+  const overviewSection = view.sections.overview;
+  const metricsSection = view.sections['metrics-stages'];
+  const issueSection = view.sections['issues-evidence'];
+  const artifactSection = view.sections['artifacts-trace'];
   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 evidence = {
+    ...(summary.evidence || {}),
+    categories: issueSection.categories || [],
+    issues: issueSection.issues || [],
+  };
+  const changed = artifactSection.changed_files || {};
+  const artifacts = artifactSection.artifacts || [];
+  const conclusionTone = statusTone(view.conclusion?.status);
+  const evidenceCategories = evidence.categories;
+  const stageNodes = metricsSection.stages || [];
+  const activeLinks = artifactSection.attribution?.active_links || [];
+  const candidateIds = artifactSection.attribution?.unassigned_candidate_event_ids || [];
+  const knownWarnings = view.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]) => `
+  const telemetryWarnings = view.telemetry_warnings?.by_type || {};
+  const artifactRows = artifacts.map((item) => `
     <tr>
       <td>${escapeHtml({
         markdown_report: 'Markdown 报告',
@@ -92,12 +66,27 @@ function renderChangeReportHtml(report) {
         execution_log: '执行日志',
         manifest: '归档清单',
         archive_zip: '归档包',
-      }[name] || name)}</td>
+      }[item.name] || item.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>
+      <td>${item?.size_display
+        ? escapeHtml(item.size_display)
+        : (item?.size_bytes == null ? '—' : escapeHtml(item.size_bytes))}</td>
     </tr>`).join('');
-  const evidenceRows = evidenceCategories.map((group) => `
+  const evidenceRows = evidenceCategories.map((group) => {
+    const issueDetails = (group.issues || []).map((issue) => [
+      `问题：${issue.issue_id}`,
+      `对象：${issue.subject || '本次变更'}`,
+      `状态：${issue.status}`,
+      `判定：${issue.verdict}`,
+      `根因：${issue.root_cause}`,
+      `预期：${issue.expected}`,
+      `实际：${issue.actual}`,
+      `影响：${issue.impact}`,
+      `修复建议：${issue.remediation}`,
+      `证据事件：${(issue.evidence_event_ids || []).join('、') || '暂无可定位事件'}`,
+    ].join('\n')).join('\n\n');
+    return `
     <article class="issue-row">
       <div><span class="issue-count">${escapeHtml(group.occurrence_count)}</span></div>
       <div>
@@ -106,78 +95,33 @@ function renderChangeReportHtml(report) {
       </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('');
+        data-drawer-body="${escapeHtml(`${issueDetails || `规则编码：${group.code}\n状态：open\n根因：当前证据未满足规则\n预期：规则证据完整\n实际：证据不足\n修复建议：补充真实证据`}\n\n规则编码：${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' }) : '—';
+    const stage = node.display_stage;
+    const round = node.display_round;
     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>
+      <td>${escapeHtml(round)}</td>
+      <td><span class="tl-time">${escapeHtml(node.display_start)}→${escapeHtml(node.display_end)}</span><br>${escapeHtml(node.display_duration)}</td>
+      <td><span class="state ${statusTone(node.display_result === 'success' ? 'passed' : node.display_result)}">${escapeHtml(node.display_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('');
+  const metricCards = (metricsSection.metric_cards || []).map(metricCard).join('');
+  const summaryCards = (overviewSection.cards || []).map((card) => `
+      <article class="summary-card"><span>${escapeHtml(card.label)}</span><strong>${escapeHtml(card.value)}</strong></article>`).join('');
+  const metricRows = (metricsSection.metric_rows || []).map((row) => `
+          <tr><td>${escapeHtml(row.label)}${row.code ? ` <span class="metric-code">${escapeHtml(row.code)}</span>` : ''}</td><td>${escapeHtml(row.value)}</td></tr>`).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">
+<meta name="sdd-semantic-digest" content="${view.semantic_digest}">
 <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)}
@@ -248,18 +192,13 @@ table{width:100%;border-collapse:collapse}th,td{padding:11px 10px;border-bottom:
   <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>
+        <span class="state ${conclusionTone}">${escapeHtml(view.conclusion?.status === 'trusted' ? '结论可信' : '需要关注')}</span>
         <h2>一句话结论</h2>
-        <p>${escapeHtml(report.conclusion?.text || '当前证据不足，暂不能形成可信结论。')}</p>
+        <p>${escapeHtml(view.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>
+      <article class="card scope"><span>七个标准阶段总耗时</span><strong>${escapeHtml(overviewSection.scope_duration)}</strong><span>辅助阶段不进入效率分母</span></article>
     </div>
+    <div class="summary-grid">${summaryCards}</div>
     <div class="section">
       <div class="section-head"><h2>核心指标</h2><p>中文业务名称为主，编码仅作定位标签</p></div>
       <div class="metric-grid">${metricCards}</div>
@@ -276,12 +215,7 @@ table{width:100%;border-collapse:collapse}th,td{padding:11px 10px;border-bottom:
     <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>
+        <table><tbody>${metricRows}</tbody></table>
       </article>
       <article class="wide-card">
         <h3>时间线与阶段执行明细</h3>
@@ -289,35 +223,25 @@ table{width:100%;border-collapse:collapse}th,td{padding:11px 10px;border-bottom:
       </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>` : ''}
+    <article class="wide-card section">
+      <h3>已知风险</h3>
+      <p>严重问题：${escapeHtml(view.known_risks?._available ? (view.known_risks.severe_issues?.length ?? 0) : '无数据')}</p>
+      ${warningDetails.length > 0
+        ? warningDetails.map((item) => `<p>${escapeHtml(item.description || '待确认项')}${item.target ? `（${escapeHtml(item.target)}）` : ''}</p>`).join('')
+        : '<p class="micro">无需修复</p>'}
+    </article>
+    ${Array.isArray(view.process_notes?.notes) && view.process_notes.notes.length > 0 ? `
+    <article class="wide-card section">
+      <h3>过程记录事件</h3>
+      <p>过程事件总数：${escapeHtml(view.process_notes.total ?? 0)}</p>
+      ${view.process_notes.notes.slice(0, 40).map((note) => `<p>[${escapeHtml(note.stage || 'unknown')}] ${escapeHtml(note.kind || 'note')}${note.round ? ` R${escapeHtml(note.round)}` : ''}：${escapeHtml(note.summary || '')}</p>`).join('')}
+    </article>` : ''}
     <p class="callout">${escapeHtml(evidence.note || '同一任务可能命中多条规则，命中次数不等于独立缺陷数。')}</p>
   </section>
 
@@ -337,9 +261,9 @@ table{width:100%;border-collapse:collapse}th,td{padding:11px 10px;border-bottom:
       <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>
+          <tr><td>显式关联历史事件</td><td>${escapeHtml(artifactSection.attribution_summary.linked_source_event_count)}</td></tr>
+          <tr><td>有效关联</td><td>${escapeHtml(artifactSection.attribution_summary.active_link_count)}</td></tr>
+          <tr><td>未归属候选</td><td>${escapeHtml(artifactSection.attribution_summary.unassigned_candidate_count)}</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>
@@ -348,7 +272,7 @@ table{width:100%;border-collapse:collapse}th,td{padding:11px 10px;border-bottom:
       <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>
+    <article class="wide-card section"><h3>产物备注</h3><p class="micro">归档目录：${escapeHtml(report.archive_result?.archive_path || report.artifacts?.archive_path || '暂不可用')}</p><p class="micro">已知风险明细仅在“问题与证据”页展示，本页不重复列表。</p></article>
   </section>
 </main>