kld-sdd 2.4.7 → 2.4.9

package/lib/init.js

@@ -28,28 +28,32 @@ const TOOL_CONFIGS = {
     configDir: '.cursor',
     commandsDir: '.cursor/commands',
     opsxDir: '.cursor/commands/opsx',
-    skillsDir: '.cursor/skills'
+    skillsDir: '.cursor/skills',
+    agentType: 'cursor'
   },
   claude: {
     name: 'Claude Code',
     configDir: '.claude',
     commandsDir: '.claude/commands',
     opsxDir: '.claude/commands/opsx',
-    skillsDir: '.claude/skills'
+    skillsDir: '.claude/skills',
+    agentType: 'claude-code'
   },
   codebuddy: {
     name: 'CodeBuddy',
     configDir: '.codebuddy',
     commandsDir: '.codebuddy/commands',
     opsxDir: '.codebuddy/commands/opsx',
-    skillsDir: '.codebuddy/skills'
+    skillsDir: '.codebuddy/skills',
+    agentType: 'codebuddy'
   },
   qoder: {
     name: 'Qoder',
     configDir: '.qoder',
     commandsDir: '.qoder/commands',
     opsxDir: '.qoder/commands/opsx',
-    skillsDir: '.qoder/skills'
+    skillsDir: '.qoder/skills',
+    agentType: 'qoder'
   },
   opencode: {
     name: 'OpenCode',
@@ -57,6 +61,7 @@ const TOOL_CONFIGS = {
     commandsDir: '.opencode/commands',
     opsxDir: '.opencode/commands/opsx',
     skillsDir: '.opencode/skills',
+    agentType: 'opencode',
     // opencode 原生命令使用 command/（单数），需要额外清理
     nativeCommandDir: '.opencode/command'
   },
@@ -65,21 +70,24 @@ const TOOL_CONFIGS = {
     configDir: '.kunlunzhima',
     commandsDir: '.kunlunzhima/commands',
     opsxDir: '.kunlunzhima/commands/opsx',
-    skillsDir: '.kunlunzhima/skills'
+    skillsDir: '.kunlunzhima/skills',
+    agentType: 'kunlunzhima'
   },
   workbuddy: {
     name: 'WorkBuddy',
     configDir: '.workbuddy',
     commandsDir: '.workbuddy/commands',
     opsxDir: '.workbuddy/commands/opsx',
-    skillsDir: '.workbuddy/skills'
+    skillsDir: '.workbuddy/skills',
+    agentType: 'workbuddy'
   },
   codex: {
     name: 'Codex',
     configDir: '.agents',
     commandsDir: '.agents/commands',
     opsxDir: '.agents/commands/opsx',
-    skillsDir: '.agents/skills'
+    skillsDir: '.agents/skills',
+    agentType: 'codex'
   }
 };
 
@@ -318,6 +326,32 @@ function copyDir(source, target) {
   }
 }
 
+function renderTemplate(content, config, toolKey) {
+  return content
+    .replace(/^\uFEFF/, '')
+    .replace(/<Agent(?:\u7c7b\u578b|\u7eeb\u8bf2\u7037)>/g, config.agentType || toolKey);
+}
+
+function copyDirRendered(source, target, config, toolKey) {
+  if (!fs.existsSync(target)) {
+    fs.mkdirSync(target, { recursive: true });
+  }
+
+  const files = fs.readdirSync(source);
+  for (const file of files) {
+    const srcPath = path.join(source, file);
+    const tgtPath = path.join(target, file);
+
+    const stat = fs.statSync(srcPath);
+    if (stat.isDirectory()) {
+      copyDirRendered(srcPath, tgtPath, config, toolKey);
+    } else {
+      const rendered = renderTemplate(fs.readFileSync(srcPath, 'utf8'), config, toolKey);
+      fs.writeFileSync(tgtPath, rendered, 'utf8');
+    }
+  }
+}
+
 /**
  * 清理原生 openspec 命令（opsx-*.md），避免与 opsx:* 命令混淆
  * 同时清理 openspec 遗留的 JSON 文件
@@ -459,7 +493,8 @@ function overrideOpsxCommands(selectedTools = Object.keys(TOOL_CONFIGS)) {
       const targetFile = path.join(targetOpsxDir, cmd);
       
       if (fs.existsSync(sourceFile)) {
-        fs.copyFileSync(sourceFile, targetFile);
+        const rendered = renderTemplate(fs.readFileSync(sourceFile, 'utf8'), config, toolKey);
+        fs.writeFileSync(targetFile, rendered, 'utf8');
         console.log(`     ✓ ${cmd}`);
       }
     }
@@ -518,9 +553,8 @@ function deployOpsxSkills(selectedTools = Object.keys(TOOL_CONFIGS)) {
         fs.mkdirSync(targetDir, { recursive: true });
       }
       
-      const skillFile = path.join(sourceDir, 'SKILL.md');
-      if (fs.existsSync(skillFile)) {
-        fs.copyFileSync(skillFile, path.join(targetDir, 'SKILL.md'));
+      if (fs.existsSync(sourceDir)) {
+        copyDirRendered(sourceDir, targetDir, config, toolKey);
         console.log(`     ✓ ${skillDir}`);
       }
     }
@@ -530,6 +564,71 @@ function deployOpsxSkills(selectedTools = Object.keys(TOOL_CONFIGS)) {
   return true;
 }
 
+/**
+ * 部署 Claude Code Hook Pack（可选增强）
+ * Hook 只调用 skywalk-sdd/log.js，不写私有日志，不替代 OPSX 模板采集。
+ */
+function deployClaudeHookPack(selectedTools = Object.keys(TOOL_CONFIGS)) {
+  if (!selectedTools.includes('claude')) {
+    return true;
+  }
+
+  console.log('🪝 正在部署 Claude Code SDD Hook Pack...');
+
+  const pkgPath = getPackagePath();
+  const cwd = process.cwd();
+  const hookTemplateDir = path.join(pkgPath, 'templates', 'hooks', 'claude');
+  const hookSourceDir = path.join(hookTemplateDir, 'hooks');
+  const settingsTemplatePath = path.join(hookTemplateDir, 'settings.json');
+
+  if (!fs.existsSync(hookSourceDir) || !fs.existsSync(settingsTemplatePath)) {
+    console.log(`   ⚠️  Claude Hook 模板缺失: ${hookTemplateDir}`);
+    return false;
+  }
+
+  const claudeDir = path.join(cwd, '.claude');
+  const targetHookDir = path.join(claudeDir, 'hooks');
+  if (!fs.existsSync(targetHookDir)) {
+    fs.mkdirSync(targetHookDir, { recursive: true });
+  }
+
+  copyDir(hookSourceDir, targetHookDir);
+  console.log('   ✓ 部署 .claude/hooks/sdd-*.js');
+
+  const targetSettingsPath = path.join(claudeDir, 'settings.json');
+  const templateSettings = JSON.parse(fs.readFileSync(settingsTemplatePath, 'utf8'));
+  let existingSettings = {};
+  if (fs.existsSync(targetSettingsPath)) {
+    try {
+      existingSettings = JSON.parse(fs.readFileSync(targetSettingsPath, 'utf8'));
+    } catch {
+      const backupPath = `${targetSettingsPath}.backup`;
+      fs.copyFileSync(targetSettingsPath, backupPath);
+      console.log(`   ℹ️  settings.json 不是合法 JSON，已备份到 ${backupPath}`);
+      existingSettings = {};
+    }
+  }
+
+  existingSettings.hooks = existingSettings.hooks || {};
+  for (const [eventName, entries] of Object.entries(templateSettings.hooks || {})) {
+    existingSettings.hooks[eventName] = existingSettings.hooks[eventName] || [];
+    for (const entry of entries) {
+      const templateCommands = (entry.hooks || []).map(h => h.command).filter(Boolean);
+      const exists = existingSettings.hooks[eventName].some(existingEntry => {
+        return (existingEntry.hooks || []).some(h => templateCommands.includes(h.command));
+      });
+      if (!exists) {
+        existingSettings.hooks[eventName].push(entry);
+      }
+    }
+  }
+
+  fs.writeFileSync(targetSettingsPath, JSON.stringify(existingSettings, null, 2) + '\n', 'utf8');
+  console.log('   ✓ 合并 .claude/settings.json hooks 配置');
+  console.log('✅ Claude Code SDD Hook Pack 已就绪（可选增强，核心采集仍由 OPSX 模板完成）');
+  return true;
+}
+
 /**
  * 清理原生 openspec-* skills（防止残留）
  * 仅负责删除 openspec init 产生的原生 skills。
@@ -676,6 +775,7 @@ function deployTelemetryDataDir() {
   // 创建本地数据目录（事件和报告存储）
   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/ 数据目录');
@@ -684,6 +784,10 @@ function deployTelemetryDataDir() {
     fs.mkdirSync(reportsDir, { recursive: true });
     console.log('   ✓ 创建 skywalk-sdd/reports/ 报告目录');
   }
+  if (!fs.existsSync(stateDir)) {
+    fs.mkdirSync(stateDir, { recursive: true });
+    console.log('   ✓ 创建 skywalk-sdd/state/ 活跃阶段状态目录');
+  }
 
   // 部署项目内 Telemetry CLI（不依赖 npm 发布）
   const telemetrySrc = path.join(pkgPath, 'skywalk-sdd', 'index.js');
@@ -700,6 +804,78 @@ function deployTelemetryDataDir() {
   return true;
 }
 
+function installGitHookShim(cwd, hookName, scriptPath) {
+  const hooksDir = path.join(cwd, '.git', 'hooks');
+  if (!fs.existsSync(hooksDir)) {
+    return;
+  }
+
+  const hookPath = path.join(hooksDir, hookName);
+  const marker = 'KLD SDD quality gate';
+  const shim = [
+    '#!/bin/sh',
+    `# ${marker}`,
+    `if [ -f "${scriptPath}" ]; then`,
+    `  node "${scriptPath}" "$@"`,
+    'fi',
+    '',
+  ].join('\n');
+
+  if (fs.existsSync(hookPath)) {
+    const existing = fs.readFileSync(hookPath, 'utf8');
+    if (existing.includes(marker)) {
+      console.log(`   ✓ .git/hooks/${hookName} 已包含 SDD 质量门禁`);
+    } else {
+      console.log(`   ℹ️  .git/hooks/${hookName} 已存在，已保留不覆盖；可手动调用 ${scriptPath}`);
+    }
+    return;
+  }
+
+  fs.writeFileSync(hookPath, shim, 'utf8');
+  try {
+    fs.chmodSync(hookPath, 0o755);
+  } catch {
+    // Windows 上 chmod 可能没有实际效果，不影响 Git Bash 执行文本 hook。
+  }
+  console.log(`   ✓ 安装 .git/hooks/${hookName} SDD 质量门禁`);
+}
+
+/**
+ * 部署 Git hooks / CI 兜底模板
+ * 这些脚本只做质量门禁和 CI 补充记录，不替代 OPSX 主采集链路。
+ */
+function deployQualityGateTemplates() {
+  console.log('🧰 正在部署 SDD Git hooks / CI 兜底模板...');
+
+  const pkgPath = getPackagePath();
+  const cwd = process.cwd();
+  const dataDir = path.join(cwd, 'skywalk-sdd');
+  const gitHooksTemplateDir = path.join(pkgPath, 'templates', 'git-hooks');
+  const ciTemplateDir = path.join(pkgPath, 'templates', 'ci');
+  const targetGitHooksDir = path.join(dataDir, 'git-hooks');
+  const targetCiDir = path.join(dataDir, 'ci');
+
+  if (fs.existsSync(gitHooksTemplateDir)) {
+    copyDir(gitHooksTemplateDir, targetGitHooksDir);
+    console.log('   ✓ 部署 skywalk-sdd/git-hooks/');
+  } else {
+    console.log(`   ⚠️  Git hooks 模板缺失: ${gitHooksTemplateDir}`);
+  }
+
+  if (fs.existsSync(ciTemplateDir)) {
+    copyDir(ciTemplateDir, targetCiDir);
+    console.log('   ✓ 部署 skywalk-sdd/ci/');
+  } else {
+    console.log(`   ⚠️  CI 模板缺失: ${ciTemplateDir}`);
+  }
+
+  installGitHookShim(cwd, 'pre-commit', 'skywalk-sdd/git-hooks/pre-commit-sdd-check.js');
+  installGitHookShim(cwd, 'pre-push', 'skywalk-sdd/git-hooks/pre-push-sdd-check.js');
+
+  console.log('✅ Git hooks / CI 兜底模板已就绪');
+  return true;
+}
+
 /**
  * 检测当前项目已初始化的 AI 编辑器
  */
@@ -729,7 +905,8 @@ function updateGitignore() {
     '.workbuddy/commands/personal-*',
     '.agents/commands/personal-*',
     'skywalk-sdd/events/',
-    'skywalk-sdd/reports/'
+    'skywalk-sdd/reports/',
+    'skywalk-sdd/state/'
   ];
 
   const sddConfig = `
@@ -745,6 +922,7 @@ function updateGitignore() {
 # SDD Telemetry 数据（本地度量，可选提交）
 skywalk-sdd/events/
 skywalk-sdd/reports/
+skywalk-sdd/state/
 `;
 
   if (fs.existsSync(gitignorePath)) {
@@ -847,9 +1025,15 @@ async function main() {
     // 4.1 清理原生 openspec-* skills（防止残留）
     cleanupNativeOpenspecSkills(selectedTools);
 
+    // 4.2 部署 Claude Code Hook Pack（可选增强）
+    deployClaudeHookPack(selectedTools);
+
     // 5. 部署 SDD Telemetry 数据目录
     deployTelemetryDataDir();
 
+    // 5.1 部署 Git hooks / CI 兜底模板
+    deployQualityGateTemplates();
+
     // 6. 复制标准文档模版到项目（供参考）
     copyTemplatesToProject();
     
@@ -873,7 +1057,12 @@ async function main() {
   console.log('  🌐 openspec/specs/overview.md     # 全局架构约束（数据字典、接口规范）');
   console.log('  📄 openspec-templates/           # 标准文档模版（参考用）');
   console.log('  🔧 .*/commands/opsx/             # 9 个 SDD 命令');
+  if (selectedTools.includes('claude')) {
+    console.log('  🪝 .claude/hooks/                 # Claude Code SDD Hook Pack（可选增强）');
+  }
   console.log('  📊 skywalk-sdd/                  # SDD Telemetry 数据目录');
+  console.log('  🧰 skywalk-sdd/git-hooks/        # Git hooks 质量门禁模板');
+  console.log('  🧪 skywalk-sdd/ci/               # CI 兜底采集模板');
   console.log();
   
   // 统一的命令格式说明

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kld-sdd",
-  "version": "2.4.7",
+  "version": "2.4.9",
   "description": "KLD SDD OpenSpec 项目初始化工具 - 内置模版一键初始化",
   "main": "index.js",
   "bin": {