kld-sdd 2.6.14 → 2.6.15

package/README.md

@@ -104,24 +104,26 @@ npx kld-sdd
 
 初始化完成后，打开你的 AI 编辑器，激活 `opsx-*` skills 开始工作。
 
-### 提效评估报告（SkyWalk V3）
+### 提效评估报告（SkyWalk；单次变更为 v4）
 
-归档与独立 `report` 命令会基于同一 Report Model 生成 Markdown / HTML / JSON 三份同源产物（`schema_version=sdd-efficiency-report/v3`）。单次变更 HTML 使用桌面方案 A，只展示当前 change 的四个页签：概览、指标与阶段、问题与证据、产物与追溯，不混入跨变更趋势。
+归档与独立 `report --change=` 会基于同一 Report Model 生成 Markdown / HTML / JSON 三份同源产物（`schema_version=sdd-efficiency-report/v4`，指标契约 `4.0`）。**仅 change 级**破坏性删除公开 `legacy_metrics`、无折叠兼容附录；变更类型仅 `config|transaction|report|composite`。单次变更 HTML 使用桌面方案 A，只展示当前 change 的四个页签：概览、指标与阶段、问题与证据、产物与追溯，不混入跨变更趋势。
+
+`--period=biweekly|monthly` 等**项目/周期报告**仍使用既有长模板（可含历史兼容附录）。若要对 project 级同步去 legacy，须另开 change，勿在本发行中半迁移。
 
 报告中的业务名称优先于缩写：E1=每个验收场景平均用时，Q3=规约检查得分，P4=编码前检查覆盖，P-R=标准阶段重复次数，P-H=执行记录完整度。标准测量阶段固定为 propose、spec、design、task、check、apply、archive；test、explore 是辅助阶段，可展示但不进入效率分母。
 
 ```bash
-# 单变更报告（默认 html；可指定 markdown/json）
+# 单变更报告（默认 html；可指定 markdown/json）→ v4
 node skywalk-sdd/log.cjs report --project=. --change=<name> --format=json --output=reports/demo.json
 
-# 双周 / 月度周期对比（需完整窗口）
+# 双周 / 月度周期对比（需完整窗口）→ 仍为项目级模板
 node skywalk-sdd/log.cjs report --project=. --period=biweekly --date-from=YYYY-MM-DD --date-to=YYYY-MM-DD
 node skywalk-sdd/log.cjs report --project=. --period=monthly --date-from=YYYY-MM-DD --date-to=YYYY-MM-DD
 ```
 
 `propose` 须确认 `change-type`；所有阶段必须显式携带 change，历史 general 事件只能通过 `scope_link` 归属。`check_result` 应携带 reviewer 独立性与 warning 处置元数据；归档 `archive_result` 只列真实写入成功的 `report_path` / `report_html_path` / `report_json_path`。
 
-任务采用两个不可混淆的口径：“文档完成度”来自 tasks checkbox，“事件可追溯度”来自严格 task/test 证据。问题同时显示“类别数”和“规则命中次数”；指标同时显示“可计算性”和“可信度”。旧 E4/P1/P2/Q5 与旧 Q3 构建一次通过率仅出现在 legacy 区。
+任务采用两个不可混淆的口径：“文档完成度”来自 tasks checkbox，“事件可追溯度”来自严格 task/test 证据。问题同时显示“类别数”和“规则命中次数”；指标同时显示“可计算性”和“可信度”。change 级主视图不再渲染旧 E4/P1/P2/Q5；上述旧指标若仍出现，只可能在**项目级**兼容附录中。
 
 ---
 

package/lib/init.js

@@ -845,6 +845,8 @@ function deployTelemetryDataDir(targetCwd = process.cwd()) {
   if (fs.existsSync(reportingSrc)) {
     copyDir(reportingSrc, reportingDst);
     console.log('   ✓ 部署 skywalk-sdd/reporting/（V3 单次变更报告）');
+  } else {
+    throw new Error(`E_INIT_MISSING_CRITICAL: reporting/ 目录缺失: ${reportingSrc}（归档报告生成将失败）`);
   }
 
   const contextClientSrc = path.join(pkgPath, 'skywalk-sdd', 'context-client.cjs');
@@ -870,6 +872,8 @@ function deployTelemetryDataDir(targetCwd = process.cwd()) {
   if (fs.existsSync(worktreeFinishSrc)) {
     fs.copyFileSync(worktreeFinishSrc, worktreeFinishDst);
     console.log('   ✓ 部署 skywalk-sdd/apply-worktree-finish.cjs（Apply 收尾脚本）');
+  } else {
+    console.log('   ⚠️  apply-worktree-finish.cjs 源文件缺失，Apply 阶段收尾需要手动执行');
   }
 
   const openspecShimSrc = path.join(pkgPath, 'skywalk-sdd', 'openspec-shim.cjs');
@@ -877,6 +881,8 @@ function deployTelemetryDataDir(targetCwd = process.cwd()) {
   if (fs.existsSync(openspecShimSrc)) {
     fs.copyFileSync(openspecShimSrc, openspecShimDst);
     console.log('   ✓ 部署 skywalk-sdd/openspec-shim.cjs（openspec 包裹包路径 shim）');
+  } else {
+    console.log('   ⚠️  openspec-shim.cjs 源文件缺失，openspec 命令需要手动 cd 到 spec 包执行');
   }
 
   console.log('   ✓ 调用方式: node skywalk-sdd/log.cjs start|end|metrics|semantic-identity|semantic-reconcile|semantic-check');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kld-sdd",
-  "version": "2.6.14",
+  "version": "2.6.15",
   "description": "KLD SDD OpenSpec 项目初始化工具 - 一键部署 SDD skills",
   "main": "index.js",
   "bin": {
@@ -8,7 +8,7 @@
     "kld-sdd-init": "bin/kld-sdd-init.js"
   },
   "scripts": {
-    "test": "node test/external-key.cjs && node test/change-key.cjs && node test/modules-and-sdd-config.cjs && node test/active-changes.cjs && node test/hook-layouts.cjs && node test/spec-package-init.cjs && node test/workspace-layout.cjs && node test/ontology-release-blockers.cjs && node test/ontology-semantic-core.cjs && node test/ontology-identity-versioning.cjs && node test/ontology-identity-continuity.cjs && node test/ontology-state-transaction.cjs && node test/ontology-process-concurrency.cjs && node test/ontology-observer-convergence.cjs && node test/ontology-working-runtime.cjs && node test/ontology-stage-materialization.cjs && node test/ontology-template-contract.cjs && node test/ontology-cli-archive.cjs && node test/archive-package-producer.cjs && node --test test/change-report-correctness.cjs test/report-metrics-correctness.cjs test/change-report-model-ui.cjs && node test/validate-skills-bundle.cjs && node test/tool-profiles.cjs && node test/settings-merge.cjs && node test/command-bridge.cjs && node test/codebuddy-hooks.cjs && node test/skill-content-contract.cjs && node test/init-agent-profiles.cjs && node test/init-report-runtime.cjs"
+    "test": "node test/external-key.cjs && node test/change-key.cjs && node test/modules-and-sdd-config.cjs && node test/active-changes.cjs && node test/hook-layouts.cjs && node test/spec-package-init.cjs && node test/workspace-layout.cjs && node test/ontology-release-blockers.cjs && node test/ontology-semantic-core.cjs && node test/ontology-identity-versioning.cjs && node test/ontology-identity-continuity.cjs && node test/ontology-state-transaction.cjs && node test/ontology-process-concurrency.cjs && node test/ontology-observer-convergence.cjs && node test/ontology-working-runtime.cjs && node test/ontology-stage-materialization.cjs && node test/ontology-template-contract.cjs && node test/ontology-cli-archive.cjs && node test/archive-package-producer.cjs && node --test test/evidence-integrity-oracle.cjs test/evidence-integrity-wiring.cjs test/change-report-correctness.cjs test/report-metrics-correctness.cjs test/change-report-model-ui.cjs && node test/validate-skills-bundle.cjs && node test/tool-profiles.cjs && node test/settings-merge.cjs && node test/command-bridge.cjs && node test/codebuddy-hooks.cjs && node test/skill-content-contract.cjs && node test/init-agent-profiles.cjs && node test/init-report-runtime.cjs"
   },
   "keywords": [
     "kld",