cc-devflow 2.5.0 → 4.1.1

package/lib/compiler/emitters/cursor-emitter.js

@@ -1,10 +1,26 @@
 /**
- * T033: CursorEmitter - Cursor 平台输出
+ * T033: CursorEmitter - Cursor 平台输出 (v2.0)
  *
- * 输出格式: 纯 Markdown (无 frontmatter)
- * 目录: .cursor/commands/
+ * [INPUT]: CommandIR, SKILL.md, agents/*.md, rules/*.md, hooks/*.ts
+ * [OUTPUT]: .cursor/commands/*.md, .cursor/rules/*.mdc, .cursor/subagents/*.md, hooks.json
+ * [POS]: Cursor IDE 平台编译器，支持完整功能模块
+ * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
+ *
+ * 输出格式:
+ * - Commands: 纯 Markdown → .cursor/commands/
+ * - Skills: MDC (YAML frontmatter) → .cursor/rules/
+ * - Agents: Subagents (YAML frontmatter) → .cursor/subagents/
+ * - Rules: MDC → .cursor/rules/
+ * - Hooks: hooks.json + hooks/*.sh
+ *
+ * v2.0: 支持多模块编译
  */
+const fs = require('fs');
+const path = require('path');
+const yaml = require('js-yaml');
+const matter = require('gray-matter');
 const BaseEmitter = require('./base-emitter.js');
+const { ContextExpander } = require('../context-expander.js');
 
 class CursorEmitter extends BaseEmitter {
   get name() {
@@ -26,6 +42,294 @@ class CursorEmitter extends BaseEmitter {
   format(ir, transformedContent) {
     return transformedContent;
   }
+
+  // ----------------------------------------------------------
+  // Multi-Module Emit Methods (v2.0)
+  // ----------------------------------------------------------
+
+  /**
+   * 编译 Skills 模块
+   * .claude/skills/[name]/SKILL.md -> .cursor/rules/[name].mdc
+   */
+  async emitSkills(sourceDir, targetDir) {
+    const results = [];
+
+    if (!fs.existsSync(sourceDir)) {
+      return results;
+    }
+
+    // 扫描技能分组目录
+    const groupDirs = await fs.promises.readdir(sourceDir, { withFileTypes: true });
+
+    for (const groupEntry of groupDirs) {
+      if (!groupEntry.isDirectory() || groupEntry.name.startsWith('_')) {
+        continue;
+      }
+
+      const groupDir = path.join(sourceDir, groupEntry.name);
+      const skillEntries = await fs.promises.readdir(groupDir, { withFileTypes: true });
+
+      for (const skillEntry of skillEntries) {
+        if (!skillEntry.isDirectory() || skillEntry.name.startsWith('_')) {
+          continue;
+        }
+
+        const skillDir = path.join(groupDir, skillEntry.name);
+        const skillMdPath = path.join(skillDir, 'SKILL.md');
+
+        if (!fs.existsSync(skillMdPath)) {
+          continue;
+        }
+
+        try {
+          const result = await this._emitSkillAsRule(
+            skillEntry.name,
+            skillDir,
+            skillMdPath,
+            targetDir
+          );
+          results.push(result);
+        } catch (error) {
+          console.warn(`Warning: Failed to emit skill ${skillEntry.name}: ${error.message}`);
+        }
+      }
+    }
+
+    return results;
+  }
+
+  /**
+   * 将 Skill 转换为 Cursor Rule (.mdc)
+   */
+  async _emitSkillAsRule(skillName, skillDir, skillMdPath, targetDir) {
+    let content = await fs.promises.readFile(skillMdPath, 'utf8');
+    const parsed = matter(content);
+
+    // 展开 context.jsonl (Cursor 使用 @file 引用)
+    const contextExpanded = ContextExpander.expandFromSkillDir(skillDir, 'cursor');
+
+    // 构建 MDC frontmatter
+    const frontmatterData = {
+      description: parsed.data.description || `${skillName} skill`,
+      globs: this._inferGlobs(skillName, parsed.data),
+      alwaysApply: parsed.data.alwaysApply || false
+    };
+
+    const yamlStr = yaml.dump(frontmatterData, {
+      lineWidth: -1,
+      quotingType: '"',
+      forceQuotes: false
+    });
+
+    // 组合最终内容
+    let body = parsed.content;
+    if (contextExpanded) {
+      body = contextExpanded + '\n' + body;
+    }
+
+    const finalContent = `---\n${yamlStr}---\n\n${body}`;
+
+    // 输出到 .cursor/rules/<skill-name>.mdc
+    const targetPath = path.join(targetDir, `${skillName}.mdc`);
+    const result = await this.emitToPath(targetPath, finalContent);
+
+    return { ...result, skillName };
+  }
+
+  /**
+   * 推断 globs 模式
+   */
+  _inferGlobs(skillName, frontmatter) {
+    if (frontmatter.globs) {
+      return frontmatter.globs;
+    }
+
+    // 根据技能名推断
+    if (skillName.includes('flow-')) {
+      return ['devflow/**/*', '.claude/**/*'];
+    }
+
+    return ['**/*'];
+  }
+
+  /**
+   * 编译 Agents 模块
+   * .claude/agents/[name].md -> .cursor/subagents/[name].md
+   */
+  async emitAgents(sourceDir, targetDir) {
+    const results = [];
+
+    if (!fs.existsSync(sourceDir)) {
+      return results;
+    }
+
+    const entries = await fs.promises.readdir(sourceDir, { withFileTypes: true });
+
+    for (const entry of entries) {
+      if (!entry.isFile() || !entry.name.endsWith('.md')) {
+        continue;
+      }
+
+      const filePath = path.join(sourceDir, entry.name);
+      const content = await fs.promises.readFile(filePath, 'utf8');
+      const parsed = matter(content);
+      const agentName = entry.name.replace('.md', '');
+
+      // 构建 Cursor subagent frontmatter
+      const frontmatterData = {
+        name: parsed.data.name || agentName,
+        description: parsed.data.description || `${agentName} agent`
+      };
+
+      // 添加 tools 字段（如果有）
+      if (parsed.data.tools) {
+        frontmatterData.tools = parsed.data.tools;
+      }
+
+      const yamlStr = yaml.dump(frontmatterData, {
+        lineWidth: -1,
+        quotingType: '"',
+        forceQuotes: false
+      });
+
+      const finalContent = `---\n${yamlStr}---\n\n${parsed.content}`;
+
+      const targetPath = path.join(targetDir, `${agentName}.md`);
+      const result = await this.emitToPath(targetPath, finalContent);
+      results.push({ ...result, agentName });
+    }
+
+    return results;
+  }
+
+  /**
+   * 编译 Rules 模块
+   * .claude/rules/[name].md -> .cursor/rules/[name].mdc
+   */
+  async emitRules(sourceDir, targetDir) {
+    const results = [];
+
+    if (!fs.existsSync(sourceDir)) {
+      return results;
+    }
+
+    const entries = await fs.promises.readdir(sourceDir, { withFileTypes: true });
+
+    for (const entry of entries) {
+      if (!entry.isFile() || !entry.name.endsWith('.md')) {
+        continue;
+      }
+
+      const filePath = path.join(sourceDir, entry.name);
+      const content = await fs.promises.readFile(filePath, 'utf8');
+      const parsed = matter(content);
+      const ruleName = entry.name.replace('.md', '');
+
+      // 构建 MDC frontmatter
+      const frontmatterData = {
+        description: parsed.data.description || `${ruleName} rule`,
+        alwaysApply: parsed.data.alwaysApply || true
+      };
+
+      if (parsed.data.globs) {
+        frontmatterData.globs = parsed.data.globs;
+      }
+
+      const yamlStr = yaml.dump(frontmatterData, {
+        lineWidth: -1,
+        quotingType: '"',
+        forceQuotes: false
+      });
+
+      const finalContent = `---\n${yamlStr}---\n\n${parsed.content}`;
+
+      const targetPath = path.join(targetDir, `${ruleName}.mdc`);
+      const result = await this.emitToPath(targetPath, finalContent);
+      results.push({ ...result, ruleName });
+    }
+
+    return results;
+  }
+
+  /**
+   * 编译 Hooks 模块
+   * .claude/hooks/[name].ts -> .cursor/hooks.json + .cursor/hooks/[name].sh
+   */
+  async emitHooks(sourceDir, targetDir) {
+    const results = [];
+
+    if (!fs.existsSync(sourceDir)) {
+      return results;
+    }
+
+    const entries = await fs.promises.readdir(sourceDir, { withFileTypes: true });
+    const hooksConfig = { version: 1, hooks: {} };
+
+    // Claude hook 事件 → Cursor hook 事件映射
+    const eventMap = {
+      'PreToolUse': 'preToolUse',
+      'PostToolUse': 'postToolUse',
+      'UserPromptSubmit': 'sessionStart'
+    };
+
+    for (const entry of entries) {
+      if (!entry.isFile()) {
+        continue;
+      }
+
+      // 跳过 TypeScript 类型定义文件
+      if (entry.name.endsWith('.d.ts')) {
+        continue;
+      }
+
+      const filePath = path.join(sourceDir, entry.name);
+      const hookName = entry.name.replace(/\.(ts|js)$/, '');
+
+      // 尝试从文件名推断事件类型
+      let event = null;
+      for (const [claudeEvent, cursorEvent] of Object.entries(eventMap)) {
+        if (hookName.toLowerCase().includes(claudeEvent.toLowerCase())) {
+          event = cursorEvent;
+          break;
+        }
+      }
+
+      if (!event) {
+        // 默认为 sessionStart
+        event = 'sessionStart';
+      }
+
+      // 创建 shell wrapper
+      const shellScript = `#!/bin/bash
+# Auto-generated from ${entry.name}
+# Original hook: ${filePath}
+
+# Note: TypeScript hooks need to be manually converted
+echo "Hook ${hookName} triggered"
+`;
+
+      const shellPath = path.join(targetDir, 'hooks', `${hookName}.sh`);
+      await this.emitToPath(shellPath, shellScript);
+
+      // 添加到 hooks.json
+      if (!hooksConfig.hooks[event]) {
+        hooksConfig.hooks[event] = [];
+      }
+      hooksConfig.hooks[event].push({
+        command: `./hooks/${hookName}.sh`
+      });
+    }
+
+    // 写入 hooks.json
+    if (Object.keys(hooksConfig.hooks).length > 0) {
+      const configPath = path.join(targetDir, 'hooks.json');
+      const configContent = JSON.stringify(hooksConfig, null, 2);
+      const result = await this.emitToPath(configPath, configContent);
+      results.push(result);
+    }
+
+    return results;
+  }
 }
 
 module.exports = CursorEmitter;

package/lib/compiler/emitters/qwen-emitter.js

@@ -1,12 +1,25 @@
 /**
- * T034: QwenEmitter - Qwen 平台输出
+ * T034: QwenEmitter - Qwen 平台输出 (v2.0)
  *
- * 输出格式: TOML
- * 目录: .qwen/commands/
- * 字段: description, prompt
+ * [INPUT]: CommandIR, SKILL.md, agents, rules
+ * [OUTPUT]: .qwen/commands/*.toml, .qwen/agents/*.md, CONTEXT.md
+ * [POS]: Qwen Code 平台编译器，支持完整功能模块
+ * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
+ *
+ * 输出格式:
+ * - Commands: TOML -> .qwen/commands/
+ * - Skills: TOML -> .qwen/commands/
+ * - Agents: Markdown (YAML frontmatter) -> .qwen/agents/
+ * - Rules: 合并到 CONTEXT.md
+ *
+ * v2.0: 支持多模块编译
  */
+const fs = require('fs');
+const path = require('path');
 const toml = require('@iarna/toml');
+const matter = require('gray-matter');
 const BaseEmitter = require('./base-emitter.js');
+const { ContextExpander } = require('../context-expander.js');
 
 class QwenEmitter extends BaseEmitter {
   get name() {
@@ -34,6 +47,185 @@ class QwenEmitter extends BaseEmitter {
 
     return toml.stringify(tomlObj);
   }
+
+  // ----------------------------------------------------------
+  // Multi-Module Emit Methods (v2.0)
+  // ----------------------------------------------------------
+
+  /**
+   * 编译 Skills 模块
+   * .claude/skills/[name]/SKILL.md -> .qwen/commands/[name].toml
+   */
+  async emitSkills(sourceDir, targetDir) {
+    const results = [];
+
+    if (!fs.existsSync(sourceDir)) {
+      return results;
+    }
+
+    // 扫描技能分组目录
+    const groupDirs = await fs.promises.readdir(sourceDir, { withFileTypes: true });
+
+    for (const groupEntry of groupDirs) {
+      if (!groupEntry.isDirectory() || groupEntry.name.startsWith('_')) {
+        continue;
+      }
+
+      const groupDir = path.join(sourceDir, groupEntry.name);
+      const skillEntries = await fs.promises.readdir(groupDir, { withFileTypes: true });
+
+      for (const skillEntry of skillEntries) {
+        if (!skillEntry.isDirectory() || skillEntry.name.startsWith('_')) {
+          continue;
+        }
+
+        const skillDir = path.join(groupDir, skillEntry.name);
+        const skillMdPath = path.join(skillDir, 'SKILL.md');
+
+        if (!fs.existsSync(skillMdPath)) {
+          continue;
+        }
+
+        try {
+          const result = await this._emitSkillAsToml(
+            skillEntry.name,
+            skillDir,
+            skillMdPath,
+            targetDir
+          );
+          results.push(result);
+        } catch (error) {
+          console.warn(`Warning: Failed to emit skill ${skillEntry.name}: ${error.message}`);
+        }
+      }
+    }
+
+    return results;
+  }
+
+  /**
+   * 将 Skill 转换为 Qwen TOML 命令
+   */
+  async _emitSkillAsToml(skillName, skillDir, skillMdPath, targetDir) {
+    let content = await fs.promises.readFile(skillMdPath, 'utf8');
+    const parsed = matter(content);
+
+    // 展开 context.jsonl
+    const contextExpanded = ContextExpander.expandFromSkillDir(skillDir, 'qwen');
+
+    // 构建 TOML 对象
+    let prompt = parsed.content;
+    if (contextExpanded) {
+      prompt = contextExpanded + '\n' + prompt;
+    }
+
+    // 替换变量占位符为 Qwen 格式
+    prompt = prompt.replace(/\$ARGUMENTS/g, '{{args}}');
+
+    const tomlObj = {
+      description: parsed.data.description || `${skillName} skill`,
+      prompt: prompt
+    };
+
+    const tomlContent = toml.stringify(tomlObj);
+
+    // 输出到 .qwen/commands/<skill-name>.toml
+    const targetPath = path.join(targetDir, `${skillName}.toml`);
+    const result = await this.emitToPath(targetPath, tomlContent);
+
+    return { ...result, skillName };
+  }
+
+  /**
+   * 编译 Agents 模块
+   * .claude/agents/[name].md -> .qwen/agents/[name].md
+   */
+  async emitAgents(sourceDir, targetDir) {
+    const results = [];
+
+    if (!fs.existsSync(sourceDir)) {
+      return results;
+    }
+
+    const entries = await fs.promises.readdir(sourceDir, { withFileTypes: true });
+
+    for (const entry of entries) {
+      if (!entry.isFile() || !entry.name.endsWith('.md')) {
+        continue;
+      }
+
+      const filePath = path.join(sourceDir, entry.name);
+      const content = await fs.promises.readFile(filePath, 'utf8');
+      const parsed = matter(content);
+      const agentName = entry.name.replace('.md', '');
+
+      // Qwen agents 支持 ${variable} 模板
+      let body = parsed.content;
+      // 转换 $ARGUMENTS 为 ${args}
+      body = body.replace(/\$ARGUMENTS/g, '${args}');
+
+      // 重新构建带 frontmatter 的内容
+      const frontmatterData = {
+        name: parsed.data.name || agentName,
+        description: parsed.data.description || `${agentName} agent`
+      };
+
+      if (parsed.data.tools) {
+        frontmatterData.tools = parsed.data.tools;
+      }
+
+      const yaml = require('js-yaml');
+      const yamlStr = yaml.dump(frontmatterData, {
+        lineWidth: -1,
+        quotingType: '"',
+        forceQuotes: false
+      });
+
+      const finalContent = `---\n${yamlStr}---\n\n${body}`;
+
+      const targetPath = path.join(targetDir, `${agentName}.md`);
+      const result = await this.emitToPath(targetPath, finalContent);
+      results.push({ ...result, agentName });
+    }
+
+    return results;
+  }
+
+  /**
+   * 编译 Rules 模块
+   * .claude/rules/[name].md -> CONTEXT.md (合并)
+   */
+  async emitRules(sourceDir, targetPath) {
+    const results = [];
+
+    if (!fs.existsSync(sourceDir)) {
+      return results;
+    }
+
+    const entries = await fs.promises.readdir(sourceDir, { withFileTypes: true });
+    const sections = [];
+
+    for (const entry of entries) {
+      if (!entry.isFile() || !entry.name.endsWith('.md')) {
+        continue;
+      }
+
+      const filePath = path.join(sourceDir, entry.name);
+      const content = await fs.promises.readFile(filePath, 'utf8');
+      const parsed = matter(content);
+      const ruleName = entry.name.replace('.md', '');
+
+      sections.push(`## ${ruleName}\n\n${parsed.content}`);
+    }
+
+    if (sections.length > 0) {
+      const merged = `# Project Context\n\n${sections.join('\n\n---\n\n')}`;
+      const result = await this.emitToPath(targetPath, merged);
+      results.push(result);
+    }
+
+    return results;
+  }
 }
 
 module.exports = QwenEmitter;