kld-sdd 2.4.18 → 2.5.0

package/lib/init.js

@@ -350,23 +350,40 @@ function copyDirRendered(source, target, config, toolKey) {
   }
 }
 
+/** OpenSpec init 生成的 4 个官方 slash command（KLD-SDD 使用 skills，不保留 command） */
+const NATIVE_OPSX_CMDS_HYPHEN = [
+  'opsx-propose.md',
+  'opsx-apply.md',
+  'opsx-archive.md',
+  'opsx-explore.md'
+];
+const NATIVE_OPSX_CMDS_SLASH = ['propose.md', 'apply.md', 'archive.md', 'explore.md'];
+
 /**
- * 清理原生 openspec 命令（opsx-*.md），避免与 opsx:* 命令混淆
- * 同时清理 openspec 遗留的 JSON 文件
- * 
+ * SDD 自定义 command 标记（init 不部署；用户手动维护时保留）
+ */
+function isSddCustomCommand(content) {
+  return content.includes('# SDD') || content.includes('skywalk-sdd/log.cjs');
+}
+
+/**
+ * 清理原生 openspec 命令，所有编辑器与 Cursor 行为一致：初始化时删除官方 command。
+ * 同时清理 openspec 遗留的 JSON 文件。
+ *
+ * 覆盖 TOOL_CONFIGS 中的全部编辑器（cursor/claude/codebuddy/qoder/opencode/kunlunzhima/workbuddy/codex），
+ * 与 Cursor 行为一致：初始化时删除 OpenSpec 官方 command，仅保留 skills。
+ *
  * openspec 对不同工具生成的目录结构：
  * - Cursor: commands/opsx-*.md（根目录，连字符）
- * - Claude/CodeBuddy/Qoder: commands/opsx/*.md（opsx 子目录）
- * - OpenCode: command/opsx-*.md（command 单数目录）
- * 
+ * - Claude/CodeBuddy/Qoder 等: commands/opsx/*.md（opsx 子目录）
+ * - OpenCode: command/opsx-*.md（command 单数目录，整目录删除）
+ *
  * @param {string[]} selectedTools - 用户选择的编辑器列表
  */
 function cleanupNativeOpenspecCommands(selectedTools = Object.keys(TOOL_CONFIGS)) {
-  console.log('🗑  正在清理原生 openspec 命令（避免与 opsx:* 命令混淆）...');
+  console.log('🗑  正在清理原生 openspec 命令（所有编辑器与 Cursor 一致，仅保留 skills）...');
 
   const cwd = process.cwd();
-  // 原生 openspec 根目录命令文件（使用连字符，与 opsx:* 冒号命令混淆）
-  const nativeCmds = ['opsx-propose.md', 'opsx-apply.md', 'opsx-archive.md', 'opsx-explore.md'];
 
   for (const toolKey of selectedTools) {
     const config = TOOL_CONFIGS[toolKey];
@@ -392,40 +409,41 @@ function cleanupNativeOpenspecCommands(selectedTools = Object.keys(TOOL_CONFIGS)
         console.log(`   🗑  ${config.name}: 删除 ${deletedJson} 个 JSON 命令文件`);
       }
 
-      // 删除 commands/ 目录下的原生 opsx-* 命令（Cursor 和其他工具都可能有）
+      // 删除 commands/ 根目录下的原生 opsx-* 命令（Cursor 等，与 Claude 行为一致）
       let deletedCmds = 0;
-      for (const cmd of nativeCmds) {
-        const filePath = path.join(commandsDir, cmd);
-        if (fs.existsSync(filePath)) {
-          fs.unlinkSync(filePath);
-          deletedCmds++;
-        }
+      for (const file of fs.readdirSync(commandsDir)) {
+        const isNativeHyphen = NATIVE_OPSX_CMDS_HYPHEN.includes(file) || /^opsx-.*\.md$/i.test(file);
+        if (!isNativeHyphen) continue;
+        const filePath = path.join(commandsDir, file);
+        if (!fs.statSync(filePath).isFile()) continue;
+        const content = fs.readFileSync(filePath, 'utf-8');
+        if (isSddCustomCommand(content)) continue;
+        fs.unlinkSync(filePath);
+        deletedCmds++;
       }
       if (deletedCmds > 0) {
         console.log(`   ✓ ${config.name}: 删除 ${deletedCmds} 个原生 opsx-* 命令（commands/）`);
       }
 
-      // 删除 commands/opsx/ 子目录下的原生命令（Claude/CodeBuddy/Qoder）
+      // 删除 commands/opsx/ 子目录下的官方命令（Claude/CodeBuddy/Qoder 等，与 Cursor 一致无条件删除）
       const opsxDir = path.join(commandsDir, 'opsx');
       if (fs.existsSync(opsxDir)) {
-        const opsxFiles = fs.readdirSync(opsxDir);
         let deletedOpsxCmds = 0;
-        // 只删除原生的 4 个命令，保留其他可能存在的文件
-        const nativeOpsxCmds = ['propose.md', 'apply.md', 'archive.md', 'explore.md'];
-        for (const file of nativeOpsxCmds) {
+        for (const file of NATIVE_OPSX_CMDS_SLASH) {
           const filePath = path.join(opsxDir, file);
-          if (fs.existsSync(filePath)) {
-            // 检查是否是原生命令（不含 YAML frontmatter 中的 SDD 标记）
-            const content = fs.readFileSync(filePath, 'utf-8');
-            if (!content.includes('# SDD') && !content.includes('OPSX:')) {
-              fs.unlinkSync(filePath);
-              deletedOpsxCmds++;
-            }
-          }
+          if (!fs.existsSync(filePath)) continue;
+          const content = fs.readFileSync(filePath, 'utf-8');
+          if (isSddCustomCommand(content)) continue;
+          fs.unlinkSync(filePath);
+          deletedOpsxCmds++;
         }
         if (deletedOpsxCmds > 0) {
           console.log(`   ✓ ${config.name}: 删除 ${deletedOpsxCmds} 个原生命令（commands/opsx/）`);
         }
+        // 子目录为空则移除
+        if (fs.readdirSync(opsxDir).length === 0) {
+          fs.rmdirSync(opsxDir);
+        }
       }
     }
 
@@ -764,7 +782,7 @@ function initGlobalOverview() {
 
 /**
  * 部署 SDD Telemetry 数据目录
- * 创建本地数据目录用于存储事件和报告
+ * 创建本地数据目录用于存储事件和活跃状态（最终报告落 openspec/changes/<change>/reports/，不再写 skywalk-sdd/reports/）
  */
 function deployTelemetryDataDir() {
   console.log('📊 正在初始化 SDD Telemetry 数据目录...');
@@ -777,18 +795,13 @@ function deployTelemetryDataDir() {
     fs.mkdirSync(dataDir, { recursive: true });
   }
 
-  // 创建本地数据目录（事件和报告存储）
+  // 创建本地数据目录（事件和活跃状态存储；报告落 change 子目录，不在此创建）
   const eventsDir = path.join(dataDir, 'events');
-  const reportsDir = path.join(dataDir, 'reports');
   const stateDir = path.join(dataDir, 'state');
   if (!fs.existsSync(eventsDir)) {
     fs.mkdirSync(eventsDir, { recursive: true });
     console.log('   ✓ 创建 skywalk-sdd/events/ 数据目录');
   }
-  if (!fs.existsSync(reportsDir)) {
-    fs.mkdirSync(reportsDir, { recursive: true });
-    console.log('   ✓ 创建 skywalk-sdd/reports/ 报告目录');
-  }
   if (!fs.existsSync(stateDir)) {
     fs.mkdirSync(stateDir, { recursive: true });
     console.log('   ✓ 创建 skywalk-sdd/state/ 活跃阶段状态目录');
@@ -858,10 +871,14 @@ function installGitHookShim(cwd, hookName, scriptPath) {
  * 这些脚本只做质量门禁和 CI 补充记录，不替代 OPSX 主采集链路。
  */
 function deployQualityGateTemplates() {
-  console.log('🧰 正在部署 SDD Git hooks / CI 兜底模板...');
-
   const pkgPath = getPackagePath();
   const cwd = process.cwd();
+  // U4: 非 Git 项目跳过 Git hooks / CI 兜底模板（按需部署，不污染非 Git 项目根）
+  if (!fs.existsSync(path.join(cwd, '.git'))) {
+    console.log('🧰 非 Git 项目，跳过 Git hooks / CI 兜底模板部署');
+    return false;
+  }
+  console.log('🧰 正在部署 SDD Git hooks / CI 兜底模板...');
   const dataDir = path.join(cwd, 'skywalk-sdd');
   const gitHooksTemplateDir = path.join(pkgPath, 'templates', 'git-hooks');
   const ciTemplateDir = path.join(pkgPath, 'templates', 'ci');
@@ -918,7 +935,6 @@ function updateGitignore() {
     '.workbuddy/commands/personal-*',
     '.agents/commands/personal-*',
     'skywalk-sdd/events/',
-    'skywalk-sdd/reports/',
     'skywalk-sdd/state/',
     '.worktrees/'
   ];
@@ -933,9 +949,8 @@ function updateGitignore() {
 .workbuddy/commands/personal-*
 .agents/commands/personal-*
 
-# SDD Telemetry 数据（本地度量，可选提交）
+# SDD Telemetry 数据（本地度量，可选提交；最终报告落 openspec/changes/<change>/reports/ 随 change 提交）
 skywalk-sdd/events/
-skywalk-sdd/reports/
 skywalk-sdd/state/
 
 # SDD Apply 隔离 worktree（本地临时目录）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kld-sdd",
-  "version": "2.4.18",
+  "version": "2.5.0",
   "description": "KLD SDD OpenSpec 项目初始化工具 - 一键部署 SDD skills",
   "main": "index.js",
   "bin": {