kld-sdd 2.6.13 → 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/skills/kld-sdd/opsx-archive/checklist.md

@@ -21,7 +21,7 @@ description: "opsx-archive 前后日志/总结自检清单 — 仅在 archive
 
 - [ ] 归档目录 `openspec/changes/archive/<日期>-<变更名称>/` 存在
 - [ ] `openspec/changes/archive/<日期>-<变更名称>/` 下 `archive-ontology.json`、`canonical-facts.json`、`conversion-report.json` 和 `archive-manifest.json` 均存在
-- [ ] 活动 change 目录下的 `artifacts/*.ontology.json` 与 `artifact-index.json` 已随归档目录一并迁移
+- [ ] 活动 change 目录下的 `artifacts/*.ontology.json` 与 `ontology/artifact-index.json` 已随归档目录一并迁移
 - [ ] `archive-manifest.json` 为 `kld-sdd-archive-manifest/v2`，且 `files` 精确覆盖 ZIP 内除 manifest 自身外的全部文件
 - [ ] `openspec/changes/archive/<日期>-<变更名称>.zip` 存在并可由知识库 `ArchivePackageReader` 读取
 - [ ] canonical facts 中每个实体/关系均能通过 `source.file`、`source.anchor_id`、`source.content_hash` 定向展开到包内原文

package/templates/skills/kld-sdd/opsx-check/SKILL.md

@@ -305,7 +305,7 @@ node "$(cat .sdd-spec-root)/skywalk-sdd/log.cjs" record --type=conformance_revie
 `opsx-check` **不联网提问**。Agent 应在 propose/spec 已问完；本阶段只验证并入既有 apply 前门禁：
 
 - Continuity=`iteration` 时每个 CAP 具备 KB 回传 `entity-id` / `version-id`
-- 已写 spec 的 Capability：场景 `external-ref` 与 `continuity-resolution.json` 决议一致；同 key+同锚点未偷偷换 entity_id
+- 已写 spec 的 Capability：场景 `external-ref` 与 `ontology/continuity-resolution.json` 决议一致；同 key+同锚点未偷偷换 entity_id
 - 用户选「原对象」却仍用新 id、或选「新对象」却仍共用旧锚点 → 失败（`CONTINUITY_IDENTITY_MISMATCH` / `EXTERNAL_REF_CONFLICT`）
 - 决议缺失 / pending / 与产物不一致 → `CONTINUITY_DECISION_REQUIRED`
 - **编号诊断码**（并入五维报告与 apply gate）：
@@ -333,7 +333,7 @@ node "$(cat .sdd-spec-root)/skywalk-sdd/log.cjs" semantic-check --project=. --ch
 - `added` 必须使用全新实体/版本 UUID；`modified/removed` 必须复用实体 UUID并指向直接前序版本；`unchanged` 必须复用历史实体和版本 UUID且不得复制历史正文。
 - 文件观察结果只能作为快速上下文，check 必须重新全量 semantic-reconcile。
 - propose/spec/design/task 对应工作态 JSON 应已在各作者阶段生成；check 不负责首次生成业务事实，只重新解析 Markdown、核对各 JSON 与同一 revision，并在全部通过时把派生 revision 更新为 `review_status=pending`。
-- Check 只读是指不修改 proposal/spec/design/tasks 原文；允许原子刷新 `openspec/changes/<变更名称>/` 下可再生的 `working-ontology.json`、`artifact-index.json` 与 `artifacts/*.ontology.json`。
+- Check 只读是指不修改 proposal/spec/design/tasks 原文；允许原子刷新 `openspec/changes/<变更名称>/` 下可再生的 `ontology/working-ontology.json`、`ontology/artifact-index.json` 与 `artifacts/*.ontology.json`。
 
 ## Guardrails
 

package/templates/skills/kld-sdd/opsx-check/checklist.md

@@ -57,5 +57,5 @@ description: "opsx-check 阶段日志自检清单 — 仅在 check 自检时读
 
 ## F. 语义门禁与工作态
 
-- [ ] `openspec/changes/<变更名称>/artifact-index.json` 已覆盖当前全部 proposal/spec/design/tasks，且每份 `artifacts/*.ontology.json` 与 `working-ontology.json` revision 一致
+- [ ] `openspec/changes/<变更名称>/ontology/artifact-index.json` 已覆盖当前全部 proposal/spec/design/tasks，且每份 `artifacts/*.ontology.json` 与 `ontology/working-ontology.json` revision 一致
 - [ ] 全部语义门禁通过时工作态 JSON 已从 draft 刷新为 pending；check 未修改任何 Markdown 原文

package/templates/skills/kld-sdd/opsx-kb-ingest/SKILL.md

@@ -49,6 +49,20 @@ Task Progress:
 
 入库时：用户指定目标 KB（从 `targets` 中选择），仅对选中的 KB 执行上传。
 
+### 3.5 兜底：确保 project-identity.json 存在（上传前必做）
+
+> 正常情况下 `project-identity.json` 已在 `opsx-ontology-query` 首次配置 KB 时创建。
+> 本步是兜底：如果用户跳过了 ontology-query（如选择 archive 降级路径），直接来做入库，需要确保文件存在且 `project_id` 正确。
+
+1. 读取 spec 包裹包路径：
+   ```bash
+   SPEC_ROOT=$(node "$(cat .sdd-spec-root)/skywalk-sdd/ontology/cli.cjs" spec-root)
+   ```
+2. 检查 `$SPEC_ROOT/skywalk-sdd/project-identity.json`：
+   - **不存在** → 从 `targets[0].spaceKey` 创建（格式同 `opsx-ontology-query` Step 3.5）
+   - **已存在但 `project_id !== targets[0].spaceKey`** → 提示用户：`⚠️ project_id 与 Space spaceKey 不一致，入库将报 PROJECT_SPACE_MISMATCH。是否更新？`
+   - **已存在且一致** → 跳过
+
 ### 4. 入库操作
 
 路径前缀：`/api/v1/spaces/{spaceId}/knowledge-bases/{kbId}/ingestions`

package/templates/skills/kld-sdd/opsx-ontology-query/SKILL.md

@@ -56,6 +56,37 @@ Task Progress:
 
 **选择空间/KB**：`GET $API/v1/spaces?tenantKey=…` → 对每个 space `GET …/knowledge-bases` → 展示清单**允许多选** → 写入共享 `../.shared/kb-state.json` 的 `targets`。
 
+### 3.5 写入项目身份文件（首次配置 Space 后）
+
+> `project-identity.json` 是 spec 仓 Git 中的**团队共享**文件，记录 `project_id`（= KB Space 的 `spaceKey`）。Archive 阶段 `archive-docs` 读取此文件生成 `archive-manifest.json`，kb-ingest 上传时 KB 校验 `project_id === spaceKey`。
+
+选择 Space 完成后（Step 3 写入 `targets` 后），执行以下逻辑：
+
+1. 读取 spec 包裹包路径：
+   ```bash
+   SPEC_ROOT=$(node "$(cat .sdd-spec-root)/skywalk-sdd/ontology/cli.cjs" spec-root)
+   ```
+2. 检查 `$SPEC_ROOT/skywalk-sdd/project-identity.json` 是否已存在
+3. **不存在** → 创建（取 `targets[0].spaceKey` 作为 `project_id`）：
+   ```json
+   {
+     "schema_version": "kld-sdd-project-identity/v1",
+     "project_id": "<targets[0].spaceKey>",
+     "created_at": "<ISO timestamp>",
+     "kb_space_id": "<targets[0].spaceId>",
+     "kb_space_name": "<targets[0].spaceName>"
+   }
+   ```
+   输出：`✓ 已创建 skywalk-sdd/project-identity.json（project_id: <spaceKey>），请提交到 spec 仓 Git 以便团队共享`
+4. **已存在但 `project_id` 与 `targets[0].spaceKey` 不一致** → 用 AskUserQuestion 询问：
+   > "project-identity.json 中的 project_id 与当前选择的 KB Space spaceKey 不一致：
+   > - 文件中：`<existing project_id>`
+   > - 当前 Space：`<spaceKey>`
+   > 是否更新？"
+   - 用户确认 → 更新 `project_id` + `kb_space_id` + `kb_space_name`
+   - 用户拒绝 → 保留原值（可能入库时报 `PROJECT_SPACE_MISMATCH`）
+5. **已存在且一致** → 跳过，不输出
+
 > state.json 字段 schema、鉴权细节、列表接口 → [reference.md](reference.md)。
 
 ## 查询

package/templates/skills/kld-sdd/opsx-propose/SKILL.md

@@ -229,9 +229,9 @@ node "$(cat .sdd-spec-root)/skywalk-sdd/context-client.cjs" --mode=resolve \
 5. 若申报了 feature-id：额外 `objectType=feature` resolve 一次，展示「该功能下已有能力 n 个（存活 m / 失效 k）」辅助勾选 CAP 范围；不改变 Continuity 判定优先级。
 6. 按 KB 结果确认 Continuity：`iteration` / `similar-reference` / `new`；勾选本次涉及的 CAP。
 7. 写入 proposal frontmatter：`requirement-refs`（含 `feature-id`）/ `numbering-waiver` + `continuity`。**禁止**写本地 archive 文件夹名作为 `base-archive`。
-8. CAP 级「同 key + 同锚点、不同 entity_id」当场问 A/B/C；决议写入 `continuity-resolution.json` 的 `capabilities[]`。
+8. CAP 级「同 key + 同锚点、不同 entity_id」当场问 A/B/C；决议写入 `ontology/continuity-resolution.json` 的 `capabilities[]`。
 9. KB 不可用 → `degraded` 继续，**禁止**扫本地 `archive/` 抄 UUID。KB degraded（用户选择跳过）时走路径 B（archive 降级）：
-   - 扫描 `openspec/changes/archive/*/ontology-identities.json` 匹配 canonicalKey
+   - 扫描 `openspec/changes/archive/*/ontology/ontology-identities.json` 匹配 canonicalKey
    - path B 的所有 entity-id 来源在 sdd-output.md 知识库使用表中必须标注 `source: archive(degraded)`，与 `source: KB current` 明确区分。
    - ⚠️ **降级风险**：archive 中的 version-id 可能已过时（如果该 capability 在 archive 之后又有新版本入库到 KB）。path B 的 predecessor-version 不保证是 KB current。入库时可能触发 `VERSION_CONFLICT`。
 10. **不得**在本阶段生成 STMT/AC/场景或裁决场景身份；**不得**铸/改 REQ/FEAT 号。
@@ -254,7 +254,7 @@ resolve(canonicalKey=CAP-USER-REGISTRATION) → CREATE_NEW
 ```
 # 扫描归档（仅 KB degraded 时）
 Read openspec/changes/archive/*/proposal.md 的能力分解章节
-Read openspec/changes/archive/*/ontology-identities.json
+Read openspec/changes/archive/*/ontology/ontology-identities.json
 
 # 匹配结果示例：
 # "账号锁定从内存迁到DB" → 匹配归档 CAP-ACCOUNT-LOCKOUT (entity-id: 3d18c60e, version: 29e7f242)

package/templates/skills/kld-sdd/opsx-spec/SKILL.md

@@ -170,7 +170,7 @@ node "$(cat .sdd-spec-root)/skywalk-sdd/context-client.cjs" \
   2. 新场景：`SCN-<slug>-<NNN>`；slug=kebab-case 小写 ≤40；NNN=该 REQ 命名空间内 max+1（已用集合=KB 回传 ∪ 本 Change 已写键，含 removed 墓碑）。
   3. removed 号是墓碑：永不复用、永不重排；序号达 999 → 硬错误，回需求系统拆分需求，不扩位。
   4. 写完立即用 `cli.cjs external-key --validate … --type scenario` 校验；REQ 前缀必须 ∈ proposal `requirement-refs`。
-- 场景级「同 SCN key + 同锚点、不同 entity_id」当场问 A/B/C；未决不得进入下一 CAP / design。决议追加到 `continuity-resolution.json` 的 `scenarios[]`；决议中的 `externalKey` 必须是归一化形态。
+- 场景级「同 SCN key + 同锚点、不同 entity_id」当场问 A/B/C；未决不得进入下一 CAP / design。决议追加到 `ontology/continuity-resolution.json` 的 `scenarios[]`；决议中的 `externalKey` 必须是归一化形态。
 - 优先消费 `reuseBundles[].statements`；`designElements` 只作理解上下文，不能写成 Spec 的 How。
 - 所有知识库内容均为 advisory；与用户确认 / proposal 冲突时以当前确认与 proposal 为准。
 - **禁止**铸/改 REQ/FEAT；**禁止**自动重排/回收 SCN。