cc-devflow 4.3.0 → 4.5.0

package/lib/compiler/index.js

@@ -1,25 +1,18 @@
 /**
- * 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
+ * Compiler Entry Point (v2.0)
  *
  * 编译器主入口:
- * - compile(options): 编译命令文件到目标平台
- * - compileMultiModule(options): 编译所有模块到目标平台 (v3.0)
+ * - compile(options): 编译 skills-first 工作流到目标平台
  * - 协调 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 path = require('path');
 
-const { parseAllCommands } = require('./parser.js');
+const { parseAllPromptFiles } = require('./parser.js');
 const { transformForPlatform } = require('./transformer.js');
 const { getEmitter, getAllEmitters, PLATFORMS } = require('./emitters/index.js');
 const {
@@ -33,7 +26,6 @@ const {
   migrateToV2,
   addSkillEntry,
   addRulesEntry,
-  pruneCommandEntries,
   needsSkillRecompile,
   needsRulesRecompile,
   MANIFEST_PATH
@@ -41,298 +33,32 @@ const {
 const {
   collectReferencedResources,
   copyResourcesForAllPlatforms,
-  mapPathToPlatform
+  mapPathToPlatform,
+  mirrorSkillDirectoriesForPlatform
 } = 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');
+const DISTRIBUTION_CONFIG = require('../../config/distributable-skills.json');
 
-// ============================================================
-// DEFAULT_MODULES - 默认编译的模块
-// ============================================================
-const DEFAULT_MODULES = ['skills', 'commands', 'agents', 'rules'];
+const DISTRIBUTED_SKILLS = new Set(
+  DISTRIBUTION_CONFIG.distributedSkills || DISTRIBUTION_CONFIG.publicSkills || []
+);
+const CODEX_MANAGED_SKILLS_PATH = '.codex/.cc-devflow-managed-skills.json';
 
-// ============================================================
-// 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');
+function getDistributedCodexSkillNames(registry) {
+  return (registry?.skills || [])
+    .map((skill) => skill.name)
+    .filter((skillName) => DISTRIBUTED_SKILLS.has(skillName));
 }
 
-function getHooksTargetDir(config) {
-  return config.folder;
-}
-
-// ============================================================
-// emitPlatformModules - 编译 Skills/Agents/Rules/Hooks 模块
-// ============================================================
-async function emitPlatformModules(sourceBaseDir, platforms, options = {}) {
-  const {
-    includeSkills = true,
-    includeAgents = true,
-    includeRules = true,
-    includeHooks = true,
-    verbose = false
-  } = options;
-
-  const summary = {
-    skillsEmitted: 0,
-    agentsEmitted: 0,
-    moduleRulesEmitted: 0,
-    hooksEmitted: 0,
-    errors: []
-  };
-
-  for (const platform of platforms) {
-    const emitter = getEmitter(platform);
-    const platformConfig = getPlatformConfig(platform);
-
-    if (includeSkills) {
-      try {
-        const skillsSourceDir = path.join(sourceBaseDir, 'skills');
-        const skillsTargetDir = getSkillsTargetDir(platform, platformConfig);
-
-        if (fs.existsSync(skillsSourceDir)) {
-          const skillResults = await emitter.emitSkills(skillsSourceDir, skillsTargetDir);
-          summary.skillsEmitted += skillResults.length;
-
-          if (verbose && skillResults.length > 0) {
-            console.log(`Emitted skills: ${platform} (${skillResults.length})`);
-          }
-        }
-      } catch (error) {
-        summary.errors.push(`${platform}/skills: ${error.message}`);
-      }
-    }
-
-    if (includeAgents) {
-      try {
-        const agentsSourceDir = path.join(sourceBaseDir, 'agents');
-        const agentsTargetPath = getAgentsTargetPath(platform, platformConfig);
-
-        if (fs.existsSync(agentsSourceDir)) {
-          const agentResults = await emitter.emitAgents(agentsSourceDir, agentsTargetPath);
-          summary.agentsEmitted += agentResults.length;
-
-          if (verbose && agentResults.length > 0) {
-            console.log(`Emitted agents: ${platform} (${agentResults.length})`);
-          }
-        }
-      } catch (error) {
-        summary.errors.push(`${platform}/agents: ${error.message}`);
-      }
-    }
-
-    if (includeRules) {
-      try {
-        const rulesSourceDir = path.join(sourceBaseDir, 'rules');
-        const rulesTargetPath = getRulesTargetPath(platform, platformConfig);
-
-        if (fs.existsSync(rulesSourceDir)) {
-          const ruleResults = await emitter.emitRules(rulesSourceDir, rulesTargetPath);
-          summary.moduleRulesEmitted += ruleResults.length;
-
-          if (verbose && ruleResults.length > 0) {
-            console.log(`Emitted module rules: ${platform} (${ruleResults.length})`);
-          }
-        }
-      } catch (error) {
-        summary.errors.push(`${platform}/rules: ${error.message}`);
-      }
-    }
-
-    if (includeHooks && isModuleSupported(platform, 'hooks')) {
-      try {
-        const hooksSourceDir = path.join(sourceBaseDir, 'hooks');
-        const hooksTargetDir = getHooksTargetDir(platformConfig);
-
-        if (fs.existsSync(hooksSourceDir)) {
-          const hookResults = await emitter.emitHooks(hooksSourceDir, hooksTargetDir);
-          summary.hooksEmitted += hookResults.length;
-
-          if (verbose && hookResults.length > 0) {
-            console.log(`Emitted hooks: ${platform} (${hookResults.length})`);
-          }
-        }
-      } catch (error) {
-        summary.errors.push(`${platform}/hooks: ${error.message}`);
-      }
-    }
-  }
-
-  return summary;
+async function saveManagedCodexSkills(skillNames) {
+  const managedPath = path.resolve(CODEX_MANAGED_SKILLS_PATH);
+  await fs.promises.mkdir(path.dirname(managedPath), { recursive: true, mode: 0o755 });
+  await fs.promises.writeFile(
+    managedPath,
+    `${JSON.stringify({ skills: skillNames }, null, 2)}\n`,
+    'utf8'
+  );
 }
 
 // ============================================================
@@ -340,7 +66,9 @@ async function emitPlatformModules(sourceBaseDir, platforms, options = {}) {
 // ============================================================
 async function compile(options = {}) {
   const {
-    sourceDir = '.claude/commands/',
+    sourceDir,
+    promptsDir,
+    commandsDir = '.claude/commands/',
     skillsDir = '.claude/skills/',
     outputBaseDir = '.',
     platforms = PLATFORMS,
@@ -349,6 +77,7 @@ async function compile(options = {}) {
     rules = true,
     skills = true
   } = options;
+  const effectivePromptsDir = promptsDir || commandsDir || sourceDir || '.claude/commands/';
 
   // 验证平台参数
   for (const platform of platforms) {
@@ -364,16 +93,10 @@ async function compile(options = {}) {
     filesSkipped: 0,
     resourcesCopied: 0,
     resourcesSkipped: 0,
-    skillsEmitted: 0,
-    agentsEmitted: 0,
-    moduleRulesEmitted: 0,
-    hooksEmitted: 0,
     rulesGenerated: 0,
     skillsRegistered: 0,
     errors: []
   };
-  const absoluteOutputBaseDir = path.resolve(outputBaseDir);
-  const toManifestPath = (absolutePath) => path.relative(absoluteOutputBaseDir, absolutePath).replace(/\\/g, '/');
 
   // 加载 manifest 并迁移到 v2.0
   const manifestPath = path.join(outputBaseDir, MANIFEST_PATH);
@@ -418,26 +141,11 @@ async function compile(options = {}) {
     }
   }
 
-  // 编译多模块产物（skills / agents / rules / hooks）
-  const sourceBaseDir = path.resolve(path.dirname(sourceDir));
-  const moduleSummary = await emitPlatformModules(sourceBaseDir, platforms, {
-    includeSkills: skills,
-    includeAgents: true,
-    includeRules: rules,
-    includeHooks: true,
-    verbose
-  });
-  result.skillsEmitted = moduleSummary.skillsEmitted;
-  result.agentsEmitted = moduleSummary.agentsEmitted;
-  result.moduleRulesEmitted = moduleSummary.moduleRulesEmitted;
-  result.hooksEmitted = moduleSummary.hooksEmitted;
-  result.errors.push(...moduleSummary.errors);
-
-  // 解析所有命令文件
-  const absoluteSourceDir = path.resolve(sourceDir);
-  let irs = [];
+  // 解析可选提示词文件
+  const absolutePromptsDir = path.resolve(effectivePromptsDir);
+  let promptIrs = [];
   try {
-    irs = await parseAllCommands(absoluteSourceDir);
+    promptIrs = await parseAllPromptFiles(absolutePromptsDir);
   } catch (error) {
     result.success = false;
     result.errors.push(error.message);
@@ -445,26 +153,17 @@ async function compile(options = {}) {
   }
 
   if (verbose) {
-    console.log(`Found ${irs.length} command files`);
-  }
-
-  // 清理已删除命令文件的旧 manifest 条目，避免多平台漂移噪音
-  const sourcePrefix = toManifestPath(absoluteSourceDir).replace(/\/+$/, '');
-  const activeSources = new Set(irs.map(ir => toManifestPath(ir.source.path)));
-  const prunedEntries = pruneCommandEntries(manifest, {
-    sourcePrefix,
-    activeSources,
-    platforms
-  });
-
-  if (verbose && prunedEntries > 0) {
-    console.log(`Pruned ${prunedEntries} stale command entries from manifest`);
+    if (promptIrs.length > 0) {
+      console.log(`Found ${promptIrs.length} prompt files`);
+    } else {
+      console.log('No .claude/commands found; generating skills-first outputs only');
+    }
   }
 
   // 生成规则入口文件
   if (rules && registry) {
     try {
-      const commands = irs.map(ir => ({
+      const commands = promptIrs.map(ir => ({
         name: ir.source.filename.replace(/\.md$/, ''),
         description: ir.frontmatter?.description || ''
       }));
@@ -495,7 +194,7 @@ async function compile(options = {}) {
   }
 
   // 复制资源文件到各平台目录
-  const copyResult = await copyResourcesForAllPlatforms(irs, platforms, { verbose });
+  const copyResult = await copyResourcesForAllPlatforms(promptIrs, platforms, { verbose });
   result.resourcesCopied = copyResult.totalCopied;
   result.resourcesSkipped = copyResult.totalSkipped;
 
@@ -503,14 +202,38 @@ async function compile(options = {}) {
     console.log(`Copied ${copyResult.totalCopied} resource files (${copyResult.totalSkipped} unchanged)`);
   }
 
+  // Codex 需要独立 skill 目录，而不是只有聚合入口
+  if (registry && platforms.includes('codex')) {
+    try {
+      const codexSkillNames = getDistributedCodexSkillNames(registry);
+      const codexSkillResult = await mirrorSkillDirectoriesForPlatform(
+        skillsDir,
+        'codex',
+        codexSkillNames,
+        { verbose }
+      );
+      await saveManagedCodexSkills(codexSkillNames);
+
+      result.resourcesCopied += codexSkillResult.copied;
+      result.resourcesSkipped += codexSkillResult.skipped;
+
+      for (const error of codexSkillResult.errors) {
+        result.errors.push(`Codex skill mirror ${error.skill}: ${error.error}`);
+      }
+    } catch (error) {
+      result.success = false;
+      result.errors.push(`Codex skill mirror: ${error.message}`);
+    }
+  }
+
   // 为每个平台构建路径映射
   const platformPathMaps = copyResult.allPathMaps;
 
   // 编译每个文件到每个平台
-  for (const ir of irs) {
+  for (const ir of promptIrs) {
     for (const platform of platforms) {
       // 检查是否需要重新编译
-      const sourceRelative = toManifestPath(ir.source.path);
+      const sourceRelative = path.relative(outputBaseDir, ir.source.path);
       if (!needsRecompile(sourceRelative, ir.source.hash, manifest, platform)) {
         result.filesSkipped++;
         if (verbose) {
@@ -579,13 +302,10 @@ async function compile(options = {}) {
   manifest.generatedAt = new Date().toISOString();
   await saveManifest(manifest, manifestPath);
 
-  result.success = result.errors.length === 0;
   return result;
 }
 
 module.exports = {
   compile,
-  compileMultiModule,
-  PLATFORMS,
-  DEFAULT_MODULES
+  PLATFORMS
 };

package/lib/compiler/manifest.js

@@ -31,19 +31,13 @@ function hashContent(content) {
 // createEntry - 创建 manifest 条目
 // ============================================================
 function createEntry({ source, target, sourceHash, targetHash, platform }) {
-  const entry = {
+  return {
     source,
     target,
-    hash: targetHash || sourceHash,
+    hash: sourceHash,
     timestamp: new Date().toISOString(),
     platform
   };
-
-  if (sourceHash) {
-    entry.sourceHash = sourceHash;
-  }
-
-  return entry;
 }
 
 // ============================================================
@@ -78,29 +72,19 @@ function needsRecompile(sourcePath, sourceHash, manifest, platform) {
     return true;
   }
 
-  const scopedEntries = manifest.entries.filter(
-    entry => entry.source === sourcePath && entry.platform === platform
-  );
-  if (scopedEntries.length === 0) {
-    return true;
-  }
-
-  // Legacy entries (v1/v2 early) stored source hash in `hash`.
-  // Force one-time recompile to migrate to explicit `sourceHash`.
-  if (scopedEntries.some(entry => !entry.sourceHash)) {
+  const entry = manifest.entries.find(e => e.source === sourcePath && e.platform === platform);
+  if (!entry) {
     return true;
   }
 
-  return scopedEntries.some(entry => entry.sourceHash !== sourceHash);
+  return entry.hash !== sourceHash;
 }
 
 // ============================================================
 // addEntry - 添加或更新条目
 // ============================================================
 function addEntry(manifest, entry) {
-  const existingIndex = manifest.entries.findIndex(
-    e => e.source === entry.source && e.platform === entry.platform && e.target === entry.target
-  );
+  const existingIndex = manifest.entries.findIndex(e => e.source === entry.source && e.platform === entry.platform);
 
   if (existingIndex >= 0) {
     manifest.entries[existingIndex] = entry;
@@ -109,51 +93,6 @@ function addEntry(manifest, entry) {
   }
 }
 
-// ============================================================
-// pruneCommandEntries - 清理已删除命令文件对应的旧条目
-// ============================================================
-function pruneCommandEntries(manifest, options = {}) {
-  if (!manifest || !Array.isArray(manifest.entries) || manifest.entries.length === 0) {
-    return 0;
-  }
-
-  const {
-    sourcePrefix = '.claude/commands',
-    activeSources = new Set(),
-    platforms = null
-  } = options;
-
-  const normalizePath = (value) => String(value || '').replace(/\\/g, '/');
-  const normalizedPrefix = normalizePath(sourcePrefix).replace(/\/+$/, '');
-  const normalizedActiveSources = new Set(
-    Array.from(activeSources).map(source => normalizePath(source))
-  );
-  const platformSet = Array.isArray(platforms) ? new Set(platforms) : null;
-
-  let removed = 0;
-  manifest.entries = manifest.entries.filter(entry => {
-    if (platformSet && !platformSet.has(entry.platform)) {
-      return true;
-    }
-
-    const source = normalizePath(entry.source);
-    const inScope = source === normalizedPrefix || source.startsWith(`${normalizedPrefix}/`);
-
-    if (!inScope) {
-      return true;
-    }
-
-    if (normalizedActiveSources.has(source)) {
-      return true;
-    }
-
-    removed += 1;
-    return false;
-  });
-
-  return removed;
-}
-
 // ============================================================
 // checkDrift - 检查漂移（目标文件被手动修改）
 // ============================================================
@@ -298,7 +237,6 @@ module.exports = {
   migrateToV2,
   addSkillEntry,
   addRulesEntry,
-  pruneCommandEntries,
   needsSkillRecompile,
   needsRulesRecompile
 };