kld-sdd 2.4.17 → 2.4.19

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);
+        }
       }
     }
 
@@ -547,8 +565,8 @@ function hookCommandText(hook) {
 
 function isSddClaudeHook(hook) {
   const text = hookCommandText(hook);
-  return /(?:^|\s|["'])\.claude[\\/]+hooks[\\/]+sdd-(?:prompt|pre-tool|post-tool|stop|apply-gate|skill-apply-gate)\.(?:cjs|js)(?=$|\s|["'])/i.test(text) ||
-    /(?:^|\s|["'])\$\{CLAUDE_PROJECT_DIR\}[\\/]+\.claude[\\/]+hooks[\\/]+sdd-(?:prompt|pre-tool|post-tool|stop|apply-gate|skill-apply-gate)\.(?:cjs|js)(?=$|\s|["'])/i.test(text);
+  return /(?:^|\s|["'])\.claude[\\/]+hooks[\\/]+sdd-(?:prompt|pre-tool|post-tool|stop|apply-gate|apply-test-gate|skill-apply-gate)\.(?:cjs|js)(?=$|\s|["'])/i.test(text) ||
+    /(?:^|\s|["'])\$\{CLAUDE_PROJECT_DIR\}[\\/]+\.claude[\\/]+hooks[\\/]+sdd-(?:prompt|pre-tool|post-tool|stop|apply-gate|apply-test-gate|skill-apply-gate)\.(?:cjs|js)(?=$|\s|["'])/i.test(text);
 }
 
 function sameHookCommand(left, right) {
@@ -804,7 +822,15 @@ function deployTelemetryDataDir() {
     console.log(`   ⚠️  Telemetry CLI 源文件缺失: ${telemetrySrc}`);
   }
 
+  const worktreeFinishSrc = path.join(pkgPath, 'skywalk-sdd', 'apply-worktree-finish.cjs');
+  const worktreeFinishDst = path.join(dataDir, 'apply-worktree-finish.cjs');
+  if (fs.existsSync(worktreeFinishSrc)) {
+    fs.copyFileSync(worktreeFinishSrc, worktreeFinishDst);
+    console.log('   ✓ 部署 skywalk-sdd/apply-worktree-finish.cjs（Apply 收尾脚本）');
+  }
+
   console.log('   ✓ 调用方式: node skywalk-sdd/log.cjs start|end|metrics');
+  console.log('   ✓ Apply worktree: record-base 在 §1.5；收尾 apply-worktree-finish.cjs --change=<name>');
   console.log('✅ Telemetry 已就绪（数据存储在 skywalk-sdd/，无需配置 MCP）');
   return true;
 }
@@ -911,7 +937,8 @@ function updateGitignore() {
     '.agents/commands/personal-*',
     'skywalk-sdd/events/',
     'skywalk-sdd/reports/',
-    'skywalk-sdd/state/'
+    'skywalk-sdd/state/',
+    '.worktrees/'
   ];
 
   const sddConfig = `
@@ -928,6 +955,9 @@ function updateGitignore() {
 skywalk-sdd/events/
 skywalk-sdd/reports/
 skywalk-sdd/state/
+
+# SDD Apply 隔离 worktree（本地临时目录）
+.worktrees/
 `;
 
   if (fs.existsSync(gitignorePath)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kld-sdd",
-  "version": "2.4.17",
+  "version": "2.4.19",
   "description": "KLD SDD OpenSpec 项目初始化工具 - 一键部署 SDD skills",
   "main": "index.js",
   "bin": {
@@ -31,6 +31,7 @@
     "lib/",
     "templates/",
     "skywalk-sdd/index.cjs",
+    "skywalk-sdd/apply-worktree-finish.cjs",
     "README.md"
   ]
 }