kld-sdd 2.5.0 → 2.5.2

package/lib/tool-profiles.js

@@ -0,0 +1,270 @@
+/**
+ * Agent capability profiles for KLD SDD init deployment.
+ * Single source of truth for per-agent paths and capabilities.
+ */
+
+const path = require('path');
+
+const TOOL_PROFILES = Object.freeze({
+  cursor: {
+    id: 'cursor',
+    agentType: 'cursor',
+    surface: 'ide',
+    configDir: '.cursor',
+    skillsDir: '.cursor/skills',
+    commandsDir: '.cursor/commands',
+    opsxCommandsDir: '.cursor/commands/opsx',
+    projectContextFile: null,
+    requiresCommandBridge: false,
+    hookProvider: 'none',
+    rulesDir: '.cursor/rules',
+    rulesFormat: 'mdc',
+    rulesWiring: 'none',
+    templateVariables: {
+      SKILL_RUNTIME_DIR: '.cursor/skills',
+      HOOK_GATE_DESCRIPTION: '本项目未为此 Agent 部署自动 Hook 门禁；请遵循 Skill 自检与 CI/Git 证据门禁。',
+      SHELL_GUIDANCE: '在 Windows 上优先使用 PowerShell；如需 Bash 请使用 Git Bash。',
+    },
+  },
+  claude: {
+    id: 'claude',
+    agentType: 'claude-code',
+    surface: 'cli',
+    configDir: '.claude',
+    skillsDir: '.claude/skills',
+    commandsDir: '.claude/commands',
+    opsxCommandsDir: '.claude/commands/opsx',
+    projectContextFile: 'CLAUDE.md',
+    requiresCommandBridge: false,
+    hookProvider: 'claude',
+    rulesDir: '.claude/rules',
+    rulesFormat: 'md',
+    rulesWiring: 'none',
+    templateVariables: {
+      SKILL_RUNTIME_DIR: '.claude/skills',
+      HOOK_GATE_DESCRIPTION: 'Claude Code 已部署 SDD Hook Pack（.claude/hooks + settings.json），自动门禁与遥测增强已启用。',
+      SHELL_GUIDANCE: '在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径；如必须使用绝对路径，请写成正斜杠路径或加引号。',
+    },
+  },
+  codebuddy: {
+    id: 'codebuddy',
+    agentType: 'codebuddy',
+    surface: 'cli',
+    configDir: '.codebuddy',
+    skillsDir: '.codebuddy/skills',
+    commandsDir: '.codebuddy/commands',
+    opsxCommandsDir: '.codebuddy/commands/opsx',
+    projectContextFile: 'CODEBUDDY.md',
+    requiresCommandBridge: false,
+    hookProvider: 'codebuddy',
+    rulesDir: '.codebuddy/rules',
+    rulesFormat: 'md',
+    rulesWiring: 'none',
+    templateVariables: {
+      SKILL_RUNTIME_DIR: '.codebuddy/skills',
+      HOOK_GATE_DESCRIPTION: 'CodeBuddy CLI 已部署 SDD Hook Pack（.codebuddy/hooks + settings.json），初始化后自动生效。',
+      SHELL_GUIDANCE: 'CodeBuddy Hooks 在 Windows 上通过 Git Bash 执行；命令使用 node "$CODEBUDDY_PROJECT_DIR/..." 引用项目路径。',
+    },
+  },
+  qoder: {
+    id: 'qoder',
+    agentType: 'qoder',
+    surface: 'ide',
+    configDir: '.qoder',
+    skillsDir: '.qoder/skills',
+    commandsDir: '.qoder/commands',
+    opsxCommandsDir: '.qoder/commands/opsx',
+    projectContextFile: null,
+    requiresCommandBridge: false,
+    hookProvider: 'none',
+    rulesDir: '.qoder/rules',
+    rulesFormat: 'md',
+    rulesWiring: 'none',
+    templateVariables: {
+      SKILL_RUNTIME_DIR: '.qoder/skills',
+      HOOK_GATE_DESCRIPTION: '本项目未为此 Agent 部署自动 Hook 门禁；请遵循 Skill 自检与 CI/Git 证据门禁。',
+      SHELL_GUIDANCE: '在 Windows 上优先使用 PowerShell；如需 Bash 请使用 Git Bash。',
+    },
+  },
+  opencode: {
+    id: 'opencode',
+    agentType: 'opencode',
+    surface: 'cli',
+    configDir: '.opencode',
+    skillsDir: '.opencode/skills',
+    commandsDir: '.opencode/commands',
+    // opsxCommandsDir: schema 对齐用；OpenCode 不部署嵌套 command bridge（skill 即斜杠命令）
+    opsxCommandsDir: '.opencode/commands/opsx',
+    // nativeCommandDir: legacy OpenSpec 单数 command/ 目录清理
+    nativeCommandDir: '.opencode/command',
+    projectContextFile: null,
+    requiresCommandBridge: false,
+    hookProvider: 'none',
+    rulesDir: null,
+    rulesFormat: 'md',
+    rulesWiring: 'opencode-config',
+    templateVariables: {
+      SKILL_RUNTIME_DIR: '.opencode/skills',
+      HOOK_GATE_DESCRIPTION: '本项目未为此 Agent 部署自动 Hook 门禁；请遵循 Skill 自检与 CI/Git 证据门禁。',
+      SHELL_GUIDANCE: '在 Windows 上优先使用 PowerShell；OpenCode 可通过环境变量 OPENCODE_GIT_BASH_PATH 指定 Git Bash；如需 Bash 请使用 Git Bash。',
+    },
+  },
+  kunlunzhima: {
+    id: 'kunlunzhima',
+    agentType: 'kunlunzhima',
+    surface: 'ide',
+    configDir: '.kunlunzhima',
+    skillsDir: '.kunlunzhima/skills',
+    commandsDir: '.kunlunzhima/commands',
+    opsxCommandsDir: '.kunlunzhima/commands/opsx',
+    projectContextFile: 'KunLunZhiMa.md',
+    requiresCommandBridge: true,
+    hookProvider: 'none',
+    rulesDir: '.kunlunzhima/.rules',
+    rulesFormat: 'mdc-kunlun',
+    rulesWiring: 'none',
+    templateVariables: {
+      SKILL_RUNTIME_DIR: '.kunlunzhima/skills',
+      HOOK_GATE_DESCRIPTION: 'KunlunZhima IDE 不支持自动 Hook 门禁；请通过 Skill 自检、commands 入口与 CI/Git 证据门禁保障质量。',
+      SHELL_GUIDANCE: 'KunlunZhima IDE 通过 commands/skills 入口使用 SDD；相对引用以 Skill 目录解析。',
+    },
+  },
+  workbuddy: {
+    id: 'workbuddy',
+    agentType: 'workbuddy',
+    surface: 'ide',
+    configDir: '.workbuddy',
+    skillsDir: '.workbuddy/skills',
+    commandsDir: '.workbuddy/commands',
+    opsxCommandsDir: '.workbuddy/commands/opsx',
+    projectContextFile: null,
+    requiresCommandBridge: false,
+    hookProvider: 'none',
+    rulesDir: '.workbuddy/rules',
+    rulesFormat: 'md',
+    rulesWiring: 'context-file',
+    templateVariables: {
+      SKILL_RUNTIME_DIR: '.workbuddy/skills',
+      HOOK_GATE_DESCRIPTION: '本项目未为此 Agent 部署自动 Hook 门禁；请遵循 Skill 自检与 CI/Git 证据门禁。',
+      SHELL_GUIDANCE: '在 Windows 上优先使用 PowerShell；如需 Bash 请使用 Git Bash。',
+    },
+  },
+  codex: {
+    id: 'codex',
+    agentType: 'codex',
+    surface: 'cli',
+    configDir: '.agents',
+    skillsDir: '.agents/skills',
+    commandsDir: '.agents/commands',
+    opsxCommandsDir: '.agents/commands/opsx',
+    projectContextFile: null,
+    requiresCommandBridge: false,
+    hookProvider: 'none',
+    rulesDir: null,
+    rulesFormat: 'md',
+    rulesWiring: 'agents-md',
+    templateVariables: {
+      SKILL_RUNTIME_DIR: '.agents/skills',
+      HOOK_GATE_DESCRIPTION: '本项目未为此 Agent 部署自动 Hook 门禁；请遵循 Skill 自检与 CI/Git 证据门禁。',
+      SHELL_GUIDANCE: '在 Windows 上优先使用 PowerShell；如需 Bash 请使用 Git Bash。',
+    },
+  },
+});
+
+const PATH_FIELDS = ['configDir', 'skillsDir', 'commandsDir', 'opsxCommandsDir', 'nativeCommandDir', 'rulesDir'];
+const VALID_RULES_FORMATS = ['md', 'mdc', 'mdc-kunlun'];
+const VALID_RULES_WIRING = ['none', 'opencode-config', 'agents-md', 'context-file'];
+
+function isSafeRelativePath(value) {
+  if (typeof value !== 'string' || value.length === 0) return false;
+  if (path.isAbsolute(value)) return false;
+  if (value.includes('..')) return false;
+  return !/[\\]/.test(value);
+}
+
+function validateToolProfiles() {
+  const errors = [];
+  for (const [id, profile] of Object.entries(TOOL_PROFILES)) {
+    if (profile.id !== id) {
+      errors.push(`${id}: profile.id mismatch (${profile.id})`);
+    }
+    for (const field of PATH_FIELDS) {
+      if (profile[field] == null) continue;
+      if (!isSafeRelativePath(profile[field])) {
+        errors.push(`${id}: invalid path in ${field} (${profile[field]})`);
+      }
+    }
+    if (!['cli', 'ide'].includes(profile.surface)) {
+      errors.push(`${id}: invalid surface (${profile.surface})`);
+    }
+    if (!['claude', 'codebuddy', 'none'].includes(profile.hookProvider)) {
+      errors.push(`${id}: invalid hookProvider (${profile.hookProvider})`);
+    }
+    if (typeof profile.requiresCommandBridge !== 'boolean') {
+      errors.push(`${id}: requiresCommandBridge must be boolean`);
+    }
+    if (!VALID_RULES_FORMATS.includes(profile.rulesFormat)) {
+      errors.push(`${id}: invalid rulesFormat (${profile.rulesFormat})`);
+    }
+    if (!VALID_RULES_WIRING.includes(profile.rulesWiring)) {
+      errors.push(`${id}: invalid rulesWiring (${profile.rulesWiring})`);
+    }
+  }
+  return errors;
+}
+
+function getToolProfile(id) {
+  if (!id || typeof id !== 'string') {
+    throw new Error('缺少 tool id');
+  }
+  const profile = TOOL_PROFILES[id];
+  if (!profile) {
+    throw new Error(`不支持的编辑器: ${id}`);
+  }
+  return profile;
+}
+
+function listToolProfileIds() {
+  return Object.keys(TOOL_PROFILES);
+}
+
+const DEFAULT_TOOL_DISPLAY_NAMES = {
+  cursor: 'Cursor',
+  claude: 'Claude Code',
+  codebuddy: 'CodeBuddy',
+  qoder: 'Qoder',
+  opencode: 'OpenCode',
+  kunlunzhima: 'KunlunZhima',
+  workbuddy: 'WorkBuddy',
+  codex: 'Codex',
+};
+
+function buildToolConfigs(displayNames = DEFAULT_TOOL_DISPLAY_NAMES) {
+  const configs = {};
+  for (const id of listToolProfileIds()) {
+    const profile = TOOL_PROFILES[id];
+    const entry = {
+      name: displayNames[id] || id,
+      configDir: profile.configDir,
+      commandsDir: profile.commandsDir,
+      opsxDir: profile.opsxCommandsDir,
+      skillsDir: profile.skillsDir,
+      agentType: profile.agentType,
+    };
+    if (profile.nativeCommandDir) {
+      entry.nativeCommandDir = profile.nativeCommandDir;
+    }
+    configs[id] = entry;
+  }
+  return configs;
+}
+
+module.exports = {
+  TOOL_PROFILES,
+  getToolProfile,
+  listToolProfileIds,
+  validateToolProfiles,
+  isSafeRelativePath,
+  buildToolConfigs,
+  DEFAULT_TOOL_DISPLAY_NAMES,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kld-sdd",
-  "version": "2.5.0",
+  "version": "2.5.2",
   "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/validate-skills-bundle.cjs"
+    "test": "node test/ontology-release-blockers.cjs && node test/ontology-semantic-core.cjs && node test/ontology-identity-versioning.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-template-contract.cjs && node test/ontology-cli-archive.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"
   },
   "keywords": [
     "kld",
@@ -30,7 +30,9 @@
     "bin/",
     "lib/",
     "templates/",
+    "kld-sdd-guide.html",
     "skywalk-sdd/index.cjs",
+    "skywalk-sdd/ontology/",
     "skywalk-sdd/apply-worktree-finish.cjs",
     "README.md"
   ]