kld-sdd 2.6.14 → 2.6.16

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');
@@ -888,64 +894,115 @@ function deployTelemetryDataDir(targetCwd = process.cwd()) {
   return true;
 }
 
-function installGitHookShim(cwd, hookName, scriptPath, options = {}) {
+/**
+ * 安装 SDD shell hook（多脚本调用型 hook，如 pre-commit / pre-push / commit-msg）。
+ * 直接部署完整的 shell 脚本到 .git/hooks/，脚本内部远程引用 spec 仓的 .cjs 脚本。
+ *
+ * shell hook 运行时通过 git config sdd.specPath / .sdd-spec-root / 向上搜索
+ * 定位 spec 仓的 skywalk-sdd/git-hooks/ 目录，兼容单仓/多仓/mono 布局。
+ *
+ * @param {string} cwd - Git 仓库根目录
+ * @param {string} hookName - hook 名称（如 'pre-commit'、'pre-push'）
+ * @param {string} pkgPath - kld-sdd 包路径（用于读取模板）
+ */
+function installSddShellHook(cwd, hookName, pkgPath = getPackagePath()) {
   const hooksDir = path.join(cwd, '.git', 'hooks');
   if (!fs.existsSync(hooksDir)) {
     return;
   }
 
+  const templatePath = path.join(pkgPath, 'templates', 'git-hooks', hookName);
+  if (!fs.existsSync(templatePath)) {
+    console.log(`   ⚠️  Hook 模板不存在: ${templatePath}`);
+    return;
+  }
+
   const hookPath = path.join(hooksDir, hookName);
   const marker = 'KLD SDD quality gate';
-  // Git 把 commit-msg 文件路径放在 $1；--project 等额外参数必须跟在 "$@" 后面，
-  // 否则 trailer 脚本会把 --project=… 误当成 message 文件（argv[2]）。
-  const extraArgs = options.extraArgs || '';
-  // Windows 反斜杠路径在 #!/bin/sh（Git for Windows MSYS2）中不被 [ -f ] 和 node 识别，
-  // 统一转为正斜杠，确保 hook shim 跨平台可执行。
-  const shScriptPath = scriptPath.replace(/\\/g, '/');
-  const shExtraArgs = extraArgs.replace(/\\/g, '/');
-  const nodeLine = shExtraArgs
-    ? `  node "${shScriptPath}" "$@" ${shExtraArgs}`
-    : `  node "${shScriptPath}" "$@"`;
-  const shim = [
-    '#!/bin/sh',
-    `# ${marker}`,
-    `if [ -f "${shScriptPath}" ]; then`,
-    nodeLine,
-    'else',
-    `  echo "[kld-sdd] Hook 脚本不存在: ${shScriptPath}" >&2`,
-    '  exit 1',
-    'fi',
-    '',
-  ].join('\n');
+  const content = fs.readFileSync(templatePath, 'utf8');
 
   if (fs.existsSync(hookPath)) {
     const existing = fs.readFileSync(hookPath, 'utf8');
     if (existing.includes(marker)) {
-      // 已是 SDD shim：若指向路径变化（如改为引用 spec 仓），允许覆盖升级
-      if (existing.includes(shScriptPath) && (!shExtraArgs || existing.includes(shExtraArgs.trim()))) {
-        console.log(`   ✓ .git/hooks/${hookName} 已包含 SDD 质量门禁`);
-        return;
-      }
-      fs.writeFileSync(hookPath, shim, 'utf8');
+      // 已是 SDD hook：允许覆盖升级
+      fs.writeFileSync(hookPath, content, 'utf8');
       try {
         fs.chmodSync(hookPath, 0o755);
       } catch {
         // ignore
       }
-      console.log(`   ✓ 更新 .git/hooks/${hookName} SDD 质量门禁`);
+      console.log(`   ✓ 更新 .git/hooks/${hookName} SDD 质量门禁（多脚本）`);
       return;
     }
-    console.log(`   ℹ️  .git/hooks/${hookName} 已存在，已保留不覆盖；可手动调用 ${scriptPath}`);
+    console.log(`   ℹ️  .git/hooks/${hookName} 已存在且非 SDD 受管 hook，已保留不覆盖`);
     return;
   }
 
-  fs.writeFileSync(hookPath, shim, 'utf8');
+  fs.writeFileSync(hookPath, content, 'utf8');
   try {
     fs.chmodSync(hookPath, 0o755);
   } catch {
-    // Windows 上 chmod 可能没有实际效果，不影响 Git Bash 执行文本 hook。
+    // Windows 上 chmod 可能没有实际效果
+  }
+  console.log(`   ✓ 安装 .git/hooks/${hookName} SDD 质量门禁（多脚本）`);
+}
+
+/**
+ * 部署代码仓全部 Git hooks（commit-msg + pre-commit + pre-push）。
+ *
+ * 统一入口，封装三种 hook 的部署逻辑。代码仓**不落 skywalk-sdd/**，
+ * 只在 .git/hooks/ 安装 shell hook 模板，远程引用 spec 仓的 .cjs 脚本：
+ *
+ * - **spec 仓**：确保 skywalk-sdd/git-hooks/ 下有全部 .cjs 脚本
+ *   （commit-msg-sdd-trailer + pre-commit-* + pre-push-* + ontology）。
+ * - **代码仓 .git/hooks/**：仅安装 3 个 shell hook 模板，运行时通过
+ *   git config sdd.specPath / .sdd-spec-root / 向上搜索定位 spec 仓的脚本。
+ *
+ * @param {string} codeRepoRoot - 代码仓根目录
+ * @param {string} specRepoRoot - spec 包裹包根目录
+ * @param {object} options - { pkgPath }
+ * @returns {{ ok: boolean, message?: string }}
+ */
+function deployCodeRepoHooks(codeRepoRoot, specRepoRoot, options = {}) {
+  const cwd = path.resolve(codeRepoRoot);
+  const specRoot = path.resolve(specRepoRoot);
+  const pkgPath = options.pkgPath || getPackagePath();
+
+  if (!workspaceLayout.isGitRepo(cwd)) {
+    return { ok: false, message: '不是 Git 仓库' };
+  }
+
+  // ── 1. 确保 spec 仓有全部 hook 脚本 + ontology ──
+  // commit-msg .cjs + ontology（ensureSpecCommitMsgScript 已处理）
+  ensureSpecCommitMsgScript(specRoot, pkgPath);
+  // pre-commit / pre-push .cjs 脚本
+  const specHooksDir = path.join(specRoot, 'skywalk-sdd', 'git-hooks');
+  const gitHooksTemplateDir = path.join(pkgPath, 'templates', 'git-hooks');
+  if (!fs.existsSync(specHooksDir)) {
+    fs.mkdirSync(specHooksDir, { recursive: true });
+  }
+  const hookScripts = [
+    'pre-commit-sdd-check.cjs',
+    'pre-commit-consistency-check.cjs',
+    'pre-push-sdd-check.cjs',
+    'pre-push-consistency-check.cjs',
+  ];
+  for (const script of hookScripts) {
+    const src = path.join(gitHooksTemplateDir, script);
+    const dst = path.join(specHooksDir, script);
+    if (fs.existsSync(src) && !fs.existsSync(dst)) {
+      fs.copyFileSync(src, dst);
+    }
   }
-  console.log(`   ✓ 安装 .git/hooks/${hookName} SDD 质量门禁`);
+  console.log(`   ✓ 确保 spec 仓 skywalk-sdd/git-hooks/ 脚本齐全`);
+
+  // ── 2. 安装三个 shell hooks 到代码仓 .git/hooks/ ──
+  // 模板 hook 运行时自动定位 spec 仓的 .cjs 脚本
+  installSddShellHook(cwd, 'commit-msg', pkgPath);
+  installSddShellHook(cwd, 'pre-commit', pkgPath);
+  installSddShellHook(cwd, 'pre-push', pkgPath);
+
+  return { ok: true };
 }
 
 /**
@@ -970,22 +1027,6 @@ function ensureSpecCommitMsgScript(specRepoRoot, pkgPath = getPackagePath()) {
   return { ok: true, scriptPath, deployed: true };
 }
 
-/**
- * 代码仓 commit-msg：只写 .git/hooks，脚本与 ontology 一律用 spec 仓那一份。
- */
-function installCodeRepoCommitMsgHook(codeRepoRoot, specRepoRoot, options = {}) {
-  const cwd = path.resolve(codeRepoRoot);
-  const ensured = ensureSpecCommitMsgScript(specRepoRoot, options.pkgPath || getPackagePath());
-  if (!ensured.ok) {
-    console.log(`   ⚠️  ${ensured.message}`);
-    return false;
-  }
-  installGitHookShim(cwd, 'commit-msg', ensured.scriptPath, {
-    extraArgs: `"--project=${cwd}"`,
-  });
-  return true;
-}
-
 /**
  * 部署 Git hooks / CI 兜底模板
  * 这些脚本只做质量门禁和 CI 补充记录，不替代 OPSX 主采集链路。
@@ -993,7 +1034,7 @@ function installCodeRepoCommitMsgHook(codeRepoRoot, specRepoRoot, options = {})
  * @param {string} [targetCwd]
  * @param {{ mode?: 'full'|'commit-msg-only' }} [options]
  *   full: spec 包裹包（pre-commit/pre-push/commit-msg + CI）
- *   commit-msg-only: 单仓 Git 根（本仓落 skywalk-sdd/git-hooks；多仓代码仓请用 installCodeRepoCommitMsgHook）
+ *   commit-msg-only: 仅安装 commit-msg hook（跳过 pre-commit/pre-push）
  */
 function deployQualityGateTemplates(targetCwd = process.cwd(), options = {}) {
   const pkgPath = getPackagePath();
@@ -1024,18 +1065,18 @@ function deployQualityGateTemplates(targetCwd = process.cwd(), options = {}) {
   }
 
   if (mode === 'full') {
-    installGitHookShim(cwd, 'pre-commit', 'skywalk-sdd/git-hooks/pre-commit-sdd-check.cjs');
-    installGitHookShim(cwd, 'pre-push', 'skywalk-sdd/git-hooks/pre-push-sdd-check.cjs');
+    installSddShellHook(cwd, 'pre-commit', pkgPath);
+    installSddShellHook(cwd, 'pre-push', pkgPath);
   }
-  installGitHookShim(cwd, 'commit-msg', 'skywalk-sdd/git-hooks/commit-msg-sdd-trailer.cjs');
+  installSddShellHook(cwd, 'commit-msg', pkgPath);
 
   console.log('✅ Git hooks 已就绪');
   return true;
 }
 
 /**
- * 代码仓轻量接入：只写 .sdd.yaml + sdd.specPath + .git/hooks/commit-msg。
- * 不在代码仓落 skywalk-sdd/——Hook 脚本与 ontology 引用 spec 包裹包那一份。
+ * 代码仓轻量接入：写 .sdd.yaml + sdd.specPath + .git/hooks/（commit-msg + pre-commit + pre-push）。
+ * 代码仓不落 skywalk-sdd/，shell hook 远程引用 spec 仓 skywalk-sdd/git-hooks/ 下的 .cjs 脚本。
  */
 function attachCodeRepoLite(codeRepoRoot, specRepoRoot, options = {}) {
   const cwd = path.resolve(codeRepoRoot);
@@ -1049,7 +1090,7 @@ function attachCodeRepoLite(codeRepoRoot, specRepoRoot, options = {}) {
     return { ok: false, repo: label, message: `spec 路径不是 Git 仓库: ${specRoot}` };
   }
 
-  console.log(`🔗 轻量接入代码仓（无 skywalk-sdd/、无 skills）: ${label}`);
+  console.log(`🔗 轻量接入代码仓（commit-msg + pre-commit + pre-push）: ${label}`);
 
   const remote = sddConfig.gitRemoteUrl(specRoot) || 'git@gitlab.example.com:biz/xxx-sdd-specs.git';
   const sddYamlPath = path.join(cwd, '.sdd.yaml');
@@ -1075,8 +1116,8 @@ function attachCodeRepoLite(codeRepoRoot, specRepoRoot, options = {}) {
   }
   console.log(`   ✓ sdd.specPath = ${linked.path}`);
 
-  installCodeRepoCommitMsgHook(cwd, specRoot, options);
-  console.log('   ✓ commit-msg → spec 仓 skywalk-sdd/git-hooks/（代码仓不落 skywalk-sdd/）');
+  // 部署代码仓全部 Git hooks（commit-msg + pre-commit + pre-push）
+  deployCodeRepoHooks(cwd, specRoot, options);
 
   return { ok: true, repo: label, path: cwd, specPath: linked.path };
 }
@@ -1549,8 +1590,9 @@ async function main() {
         removeOuterSkywalk(workspaceRoot);
 
         deployMonoSddYaml(workspaceRoot, { specPathRelative: specPackage.name });
-        // Hook 装在 Git 根，脚本在包裹包内（Git 根不落 skywalk-sdd/）
-        installCodeRepoCommitMsgHook(workspaceRoot, specPackage.abs);
+        // 部署代码仓全部 Git hooks（commit-msg + pre-commit + pre-push）
+        // 单仓 mono：hook 通过 .sdd-spec-root 定位包裹包的 skywalk-sdd/git-hooks/
+        deployCodeRepoHooks(workspaceRoot, specPackage.abs);
         const linked = sddConfig.setSpecPath(workspaceRoot, specPackage.abs, {
           allowNestedPackage: true,
         });
@@ -1643,7 +1685,7 @@ async function main() {
     console.log('  📌 .sdd-spec-root → 包裹包；无根目录 skywalk-sdd/');
   }
   if (selectedTools.includes('kunlunzhima')) {
-    console.log('  📎 .kunlunzhima/commands/opsx/    # KunlunZhima OPSX command bridge（11 个）');
+    console.log('  📎 .kunlunzhima/commands/opsx/    # KunlunZhima OPSX command bridge（12 个）');
     console.log('  ℹ️  KunlunZhima 通过 commands/skills 入口使用 SDD，未启用自动 Hook');
   }
   if (selectedTools.includes('codebuddy')) {
@@ -1655,18 +1697,19 @@ async function main() {
   console.log();
   
   // 统一的 skill 格式说明
-  console.log('可用 skills（opsx-* 系列，11 个 SDD skills）:');
-  console.log('  opsx-propose   - 创建业务意图文档（Why）');
-  console.log('  opsx-spec      - 创建技术契约文档（What）');
-  console.log('  opsx-design    - 创建技术实现方案（How）');
-  console.log('  opsx-task      - 拆解AI编码任务（Do）');
-  console.log('  opsx-check     - 质量门禁检查（Verify）');
-  console.log('  opsx-apply     - 申请变更实施（Apply）');
-  console.log('  opsx-test      - 执行单元测试（Test）');
-  console.log('  opsx-archive   - 归档变更（Archive）');
-  console.log('  opsx-explore   - 浏览变更状态（Explore）');
-  console.log('  opsx-knowledge - 业务知识库检索（辅助）');
-  console.log('  opsx-rules     - 生成/更新 Agent 规则（辅助）');
+  console.log('可用 skills（opsx-* 系列，14 个 SDD skills）:');
+  console.log('  opsx-propose           - 创建业务意图文档（Why）');
+  console.log('  opsx-spec              - 创建技术契约文档（What）');
+  console.log('  opsx-design            - 创建技术实现方案（How）');
+  console.log('  opsx-task              - 拆解AI编码任务（Do）');
+  console.log('  opsx-check             - 质量门禁检查（Verify）');
+  console.log('  opsx-apply             - 申请变更实施（Apply）');
+  console.log('  opsx-test              - 执行单元测试（Test）');
+  console.log('  opsx-archive           - 归档变更（Archive）');
+  console.log('  opsx-explore           - 浏览变更状态（Explore）');
+  console.log('  opsx-knowledge         - 业务知识库检索（辅助）');
+  console.log('  opsx-rules             - 生成/更新 Agent 规则（辅助）');
+  console.log('  opsx-consistency-check - Spec 一致性校验（代码 vs spec）');
     
   console.log();
   console.log('后续步骤:');
@@ -1723,5 +1766,7 @@ module.exports = {
   syncWorkspaceRepos,
   copyDirRendered,
   parseSelectedTools,
+  installSddShellHook,
+  deployCodeRepoHooks,
   TOOL_CONFIGS,
 };

package/lib/skills-bundle.js

@@ -22,6 +22,8 @@ const OPSX_SKILL_DIRS = [
   // Engineering KB 依赖技能（随 init 部署；propose/spec/archive 硬依赖）
   'opsx-ontology-query',
   'opsx-kb-ingest',
+  // Spec 一致性校验技能
+  'opsx-consistency-check',
 ];
 
 const PKG_ROOT = path.resolve(__dirname, '..');
@@ -102,6 +104,7 @@ const KUNLUN_SLASH_COMMANDS = [
   'explore',
   'ontology-query',
   'kb-ingest',
+  'consistency-check',
 ];
 
 function transformKunlunSlashCommands(content) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kld-sdd",
-  "version": "2.6.14",
+  "version": "2.6.16",
   "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",
@@ -36,6 +36,7 @@
     "skywalk-sdd/runtime-metadata.cjs",
     "skywalk-sdd/reporting/",
     "skywalk-sdd/context-client.cjs",
+    "skywalk-sdd/openspec-shim.cjs",
     "skywalk-sdd/ontology/",
     "skywalk-sdd/apply-worktree-finish.cjs",
     "README.md"