cc-devflow 2.4.6 → 4.1.0

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;

package/lib/compiler/index.js

@@ -1,15 +1,23 @@
 /**
- * Compiler Entry Point (v2.0)
+ * Compiler Entry Point (v3.0)
+ *
+ * [INPUT]: .claude/commands/, .claude/skills/, .claude/agents/, .claude/rules/, .claude/hooks/
+ * [OUTPUT]: 各平台目录 (.codex/, .cursor/, .qwen/, .agent/)
+ * [POS]: 编译器主入口，协调多模块编译流程
+ * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
  *
  * 编译器主入口:
  * - compile(options): 编译命令文件到目标平台
+ * - compileMultiModule(options): 编译所有模块到目标平台 (v3.0)
  * - 协调 parser, transformer, emitters, manifest
  * - 复制资源文件并重写路径
  * - 生成 skills-registry.json 和规则入口文件
  *
  * v2.0 (REQ-006): 支持 --rules, --skills 参数
+ * v3.0: 支持多模块编译 (skills, commands, agents, rules, hooks)
  */
 const path = require('path');
+const fs = require('fs');
 
 const { parseAllCommands } = require('./parser.js');
 const { transformForPlatform } = require('./transformer.js');
@@ -36,6 +44,191 @@ const {
 } = require('./resource-copier.js');
 const { generateSkillsRegistryV2, writeSkillsRegistry } = require('./skills-registry.js');
 const { getRulesEmitter, emitAllRules } = require('./rules-emitters/index.js');
+const { getPlatformConfig, MODULE_TYPES, isModuleSupported } = require('./platforms.js');
+
+// ============================================================
+// DEFAULT_MODULES - 默认编译的模块
+// ============================================================
+const DEFAULT_MODULES = ['skills', 'commands', 'agents', 'rules'];
+
+// ============================================================
+// compileMultiModule - 多模块编译主函数 (v3.0)
+// ============================================================
+async function compileMultiModule(options = {}) {
+  const {
+    sourceBaseDir = '.claude/',
+    outputBaseDir = '.',
+    platforms = PLATFORMS,
+    modules = DEFAULT_MODULES,
+    verbose = false,
+    check = false
+  } = options;
+
+  // 验证平台参数
+  for (const platform of platforms) {
+    if (!PLATFORMS.includes(platform)) {
+      throw new Error(`Unknown platform: ${platform}`);
+    }
+  }
+
+  const result = {
+    success: true,
+    platforms: platforms,
+    modules: modules,
+    skillsEmitted: 0,
+    commandsEmitted: 0,
+    agentsEmitted: 0,
+    rulesEmitted: 0,
+    hooksEmitted: 0,
+    errors: []
+  };
+
+  // 加载 manifest
+  const manifestPath = path.join(outputBaseDir, MANIFEST_PATH);
+  let manifest = await loadManifest(manifestPath);
+  manifest = migrateToV2(manifest);
+
+  // 如果是 check 模式，只做漂移检测
+  if (check) {
+    const { checkDrift } = require('./manifest.js');
+    const drift = await checkDrift(manifest);
+    return {
+      ...result,
+      check: true,
+      drift,
+      success: drift.length === 0
+    };
+  }
+
+  // 为每个平台编译每个模块
+  for (const platform of platforms) {
+    const emitter = getEmitter(platform);
+    const platformConfig = getPlatformConfig(platform);
+
+    if (verbose) {
+      console.log(`\nCompiling for ${platformConfig.name}...`);
+    }
+
+    // 编译 Skills
+    if (modules.includes('skills')) {
+      try {
+        const skillsSourceDir = path.join(sourceBaseDir, 'skills');
+        const skillsTargetDir = getSkillsTargetDir(platform, platformConfig);
+
+        if (fs.existsSync(skillsSourceDir)) {
+          const skillResults = await emitter.emitSkills(skillsSourceDir, skillsTargetDir);
+          result.skillsEmitted += skillResults.length;
+
+          if (verbose && skillResults.length > 0) {
+            console.log(`  Skills: ${skillResults.length} emitted to ${skillsTargetDir}`);
+          }
+        }
+      } catch (error) {
+        result.errors.push(`${platform}/skills: ${error.message}`);
+      }
+    }
+
+    // 编译 Agents
+    if (modules.includes('agents')) {
+      try {
+        const agentsSourceDir = path.join(sourceBaseDir, 'agents');
+        const agentsTargetPath = getAgentsTargetPath(platform, platformConfig);
+
+        if (fs.existsSync(agentsSourceDir)) {
+          const agentResults = await emitter.emitAgents(agentsSourceDir, agentsTargetPath);
+          result.agentsEmitted += agentResults.length;
+
+          if (verbose && agentResults.length > 0) {
+            console.log(`  Agents: ${agentResults.length} emitted to ${agentsTargetPath}`);
+          }
+        }
+      } catch (error) {
+        result.errors.push(`${platform}/agents: ${error.message}`);
+      }
+    }
+
+    // 编译 Rules
+    if (modules.includes('rules')) {
+      try {
+        const rulesSourceDir = path.join(sourceBaseDir, 'rules');
+        const rulesTargetPath = getRulesTargetPath(platform, platformConfig);
+
+        if (fs.existsSync(rulesSourceDir)) {
+          const ruleResults = await emitter.emitRules(rulesSourceDir, rulesTargetPath);
+          result.rulesEmitted += ruleResults.length;
+
+          if (verbose && ruleResults.length > 0) {
+            console.log(`  Rules: ${ruleResults.length} emitted to ${rulesTargetPath}`);
+          }
+        }
+      } catch (error) {
+        result.errors.push(`${platform}/rules: ${error.message}`);
+      }
+    }
+
+    // 编译 Hooks (仅 Cursor 支持)
+    if (modules.includes('hooks') && isModuleSupported(platform, 'hooks')) {
+      try {
+        const hooksSourceDir = path.join(sourceBaseDir, 'hooks');
+        const hooksTargetDir = platformConfig.folder;
+
+        if (fs.existsSync(hooksSourceDir)) {
+          const hookResults = await emitter.emitHooks(hooksSourceDir, hooksTargetDir);
+          result.hooksEmitted += hookResults.length;
+
+          if (verbose && hookResults.length > 0) {
+            console.log(`  Hooks: ${hookResults.length} emitted to ${hooksTargetDir}`);
+          }
+        }
+      } catch (error) {
+        result.errors.push(`${platform}/hooks: ${error.message}`);
+      }
+    }
+  }
+
+  // 保存 manifest
+  manifest.generatedAt = new Date().toISOString();
+  await saveManifest(manifest, manifestPath);
+
+  // 设置成功状态
+  result.success = result.errors.length === 0;
+
+  return result;
+}
+
+// ============================================================
+// Helper Functions - 获取目标路径
+// ============================================================
+
+function getSkillsTargetDir(platform, config) {
+  const skillsConfig = config.skills;
+  if (!skillsConfig) {
+    return path.join(config.folder, 'skills');
+  }
+  return path.join(config.folder, skillsConfig.dir || 'skills');
+}
+
+function getAgentsTargetPath(platform, config) {
+  const agentsConfig = config.agents;
+  if (!agentsConfig) {
+    return 'AGENTS.md';
+  }
+  if (agentsConfig.outputFile) {
+    return agentsConfig.outputFile;
+  }
+  return path.join(config.folder, agentsConfig.dir || 'agents');
+}
+
+function getRulesTargetPath(platform, config) {
+  const rulesConfig = config.rules;
+  if (!rulesConfig) {
+    return path.join(config.folder, 'rules');
+  }
+  if (rulesConfig.outputFile) {
+    return rulesConfig.outputFile;
+  }
+  return path.join(config.folder, rulesConfig.dir || 'rules');
+}
 
 // ============================================================
 // compile - 编译主函数
@@ -252,5 +445,7 @@ async function compile(options = {}) {
 
 module.exports = {
   compile,
-  PLATFORMS
+  compileMultiModule,
+  PLATFORMS,
+  DEFAULT_MODULES
 };