cc-devflow 2.5.0 → 4.1.1

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
 };

package/lib/compiler/platforms.js

@@ -1,50 +1,196 @@
 /**
- * T001: Platform Configuration Registry
+ * T001: Platform Configuration Registry (v2.0)
+ *
+ * [INPUT]: 无外部依赖
+ * [OUTPUT]: PLATFORM_CONFIG, PLATFORMS, getPlatformConfig, isValidPlatform, getRulesEntryPath
+ * [POS]: 编译器核心配置，定义四个目标平台的完整编译配置
+ * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
  *
  * 定义四个目标平台的编译配置:
- * - cursor: Cursor IDE (.mdc format)
- * - codex: Codex CLI (SKILL.md format)
- * - qwen: Qwen Code (.toml format)
- * - antigravity: Antigravity (.md with 12K limit)
+ * - cursor: Cursor IDE (.mdc rules, subagents, hooks)
+ * - codex: Codex CLI (skills/, prompts/, AGENTS.md)
+ * - qwen: Qwen Code (.toml commands, agents/)
+ * - antigravity: Antigravity (skills/, workflows/, rules/)
  *
- * Reference: data-model.md#PlatformConfig
+ * v2.0: 支持完整功能模块 (skills, commands, agents, rules, hooks)
  */
 
 // ============================================================
-// PLATFORM_CONFIG - 平台配置注册表
+// MODULE_TYPES - 支持的模块类型
+// ============================================================
+const MODULE_TYPES = ['skills', 'commands', 'agents', 'rules', 'hooks'];
+
+// ============================================================
+// PLATFORM_CONFIG - 平台配置注册表 (v2.0)
 // ============================================================
 const PLATFORM_CONFIG = {
-  cursor: {
-    name: 'Cursor IDE',
-    folder: '.cursor/',
+  // ----------------------------------------------------------
+  // Codex CLI
+  // ----------------------------------------------------------
+  codex: {
+    name: 'Codex CLI',
+    folder: '.codex/',
+
+    // Skills 配置
+    skills: {
+      dir: 'skills/',
+      file: 'SKILL.md',
+      frontmatter: 'yaml',
+      supportsScripts: true,
+      supportsReferences: true
+    },
+
+    // Commands → Prompts
+    commands: {
+      dir: 'prompts/',
+      ext: '.md',
+      frontmatter: 'yaml',
+      argumentPattern: '$ARGUMENTS'
+    },
+
+    // Agents → AGENTS.md (项目根目录合并)
+    agents: {
+      outputFile: 'AGENTS.md',
+      mergeMode: 'append'
+    },
+
+    // Rules → AGENTS.md (合并到 agents)
+    rules: {
+      outputFile: 'AGENTS.md',
+      mergeMode: 'append'
+    },
+
+    // Hooks: 不支持
+    hooks: {
+      supported: false
+    },
+
+    // 旧版兼容字段
     rulesEntry: {
-      path: 'rules/devflow.mdc',
-      format: 'mdc'
+      path: 'skills/cc-devflow/SKILL.md',
+      format: 'markdown'
     },
-    commandsDir: 'commands/',
+    commandsDir: 'prompts/',
     commandExt: '.md',
     argumentPattern: '$ARGUMENTS',
     hasHooks: false,
     limits: {}
   },
 
-  codex: {
-    name: 'Codex CLI',
-    folder: '.codex/',
+  // ----------------------------------------------------------
+  // Cursor IDE
+  // ----------------------------------------------------------
+  cursor: {
+    name: 'Cursor IDE',
+    folder: '.cursor/',
+
+    // Skills → Rules (.mdc)
+    skills: {
+      dir: 'rules/',
+      ext: '.mdc',
+      frontmatter: 'yaml',
+      supportsGlobs: true,
+      supportsAlwaysApply: true
+    },
+
+    // Commands
+    commands: {
+      dir: 'commands/',
+      ext: '.md',
+      frontmatter: null,
+      argumentPattern: '$ARGUMENTS'
+    },
+
+    // Agents → Subagents
+    agents: {
+      dir: 'subagents/',
+      ext: '.md',
+      frontmatter: 'yaml',
+      supportsTools: true
+    },
+
+    // Rules → Rules (.mdc)
+    rules: {
+      dir: 'rules/',
+      ext: '.mdc',
+      frontmatter: 'yaml'
+    },
+
+    // Hooks: 支持
+    hooks: {
+      supported: true,
+      configFile: 'hooks.json',
+      scriptsDir: 'hooks/',
+      events: ['sessionStart', 'preToolUse', 'postToolUse', 'afterFileEdit']
+    },
+
+    // MCP 配置
+    mcp: {
+      supported: true,
+      configFile: 'mcp.json'
+    },
+
+    // 项目级指令
+    projectFile: 'AGENTS.md',
+
+    // 旧版兼容字段
     rulesEntry: {
-      path: 'skills/cc-devflow/SKILL.md',
-      format: 'markdown'
+      path: 'rules/devflow.mdc',
+      format: 'mdc'
     },
-    commandsDir: 'prompts/',
+    commandsDir: 'commands/',
     commandExt: '.md',
     argumentPattern: '$ARGUMENTS',
-    hasHooks: false,
+    hasHooks: true,
     limits: {}
   },
 
+  // ----------------------------------------------------------
+  // Qwen Code
+  // ----------------------------------------------------------
   qwen: {
     name: 'Qwen Code',
     folder: '.qwen/',
+
+    // Skills → Commands (.toml)
+    skills: {
+      dir: 'commands/',
+      ext: '.toml',
+      frontmatter: 'toml',
+      supportsNesting: true
+    },
+
+    // Commands (.toml)
+    commands: {
+      dir: 'commands/',
+      ext: '.toml',
+      frontmatter: 'toml',
+      argumentPattern: '{{args}}'
+    },
+
+    // Agents
+    agents: {
+      dir: 'agents/',
+      ext: '.md',
+      frontmatter: 'yaml',
+      supportsTemplating: true
+    },
+
+    // Rules → CONTEXT.md
+    rules: {
+      outputFile: 'CONTEXT.md',
+      mergeMode: 'append'
+    },
+
+    // Hooks: 不支持
+    hooks: {
+      supported: false
+    },
+
+    // 配置文件
+    configFile: 'settings.json',
+
+    // 旧版兼容字段
     rulesEntry: {
       path: 'commands/devflow.toml',
       format: 'toml'
@@ -56,9 +202,51 @@ const PLATFORM_CONFIG = {
     limits: {}
   },
 
+  // ----------------------------------------------------------
+  // Antigravity
+  // ----------------------------------------------------------
   antigravity: {
     name: 'Antigravity',
     folder: '.agent/',
+
+    // Skills
+    skills: {
+      dir: 'skills/',
+      file: 'SKILL.md',
+      frontmatter: 'yaml',
+      supportsScripts: true,
+      supportsReferences: true,
+      supportsMetadata: true
+    },
+
+    // Commands → Workflows
+    commands: {
+      dir: 'workflows/',
+      ext: '.md',
+      frontmatter: 'yaml',
+      argumentPattern: '$ARGUMENTS',
+      supportsTurbo: true
+    },
+
+    // Agents → AGENTS.md
+    agents: {
+      outputFile: 'AGENTS.md',
+      mergeMode: 'append'
+    },
+
+    // Rules
+    rules: {
+      dir: 'rules/',
+      ext: '.md',
+      frontmatter: null
+    },
+
+    // Hooks: 不支持
+    hooks: {
+      supported: false
+    },
+
+    // 旧版兼容字段
     rulesEntry: {
       path: 'rules/rules.md',
       format: 'markdown'
@@ -104,10 +292,71 @@ function getRulesEntryPath(platform) {
   return `${config.folder}${config.rulesEntry.path}`;
 }
 
+// ============================================================
+// getModuleConfig - 获取特定模块的配置
+// ============================================================
+function getModuleConfig(platform, moduleType) {
+  const config = getPlatformConfig(platform);
+  const moduleConfig = config[moduleType];
+
+  if (!moduleConfig) {
+    return null;
+  }
+
+  return moduleConfig;
+}
+
+// ============================================================
+// isModuleSupported - 检查平台是否支持特定模块
+// ============================================================
+function isModuleSupported(platform, moduleType) {
+  const moduleConfig = getModuleConfig(platform, moduleType);
+
+  if (!moduleConfig) {
+    return false;
+  }
+
+  // hooks 模块需要检查 supported 字段
+  if (moduleType === 'hooks') {
+    return moduleConfig.supported === true;
+  }
+
+  return true;
+}
+
+// ============================================================
+// getOutputPath - 获取模块输出路径
+// ============================================================
+function getOutputPath(platform, moduleType, filename = '') {
+  const config = getPlatformConfig(platform);
+  const moduleConfig = config[moduleType];
+
+  if (!moduleConfig) {
+    return null;
+  }
+
+  // 合并模式 (AGENTS.md, CONTEXT.md)
+  if (moduleConfig.outputFile) {
+    return moduleConfig.outputFile;
+  }
+
+  // 目录模式
+  if (moduleConfig.dir) {
+    const ext = moduleConfig.ext || '';
+    return `${config.folder}${moduleConfig.dir}${filename}${ext}`;
+  }
+
+  return null;
+}
+
 module.exports = {
   PLATFORM_CONFIG,
   PLATFORMS,
+  MODULE_TYPES,
   getPlatformConfig,
   isValidPlatform,
-  getRulesEntryPath
+  getRulesEntryPath,
+  getModuleConfig,
+  isModuleSupported,
+  getOutputPath
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "cc-devflow",
-    "version": "2.5.0",
+    "version": "4.1.1",
     "description": "DevFlow CLI tool",
     "main": "bin/cc-devflow.js",
     "bin": {
@@ -47,4 +47,4 @@
     "engines": {
         "node": ">=18"
     }
-}
+}