cc-devflow 4.2.0 → 4.4.1

package/lib/compiler/parser.js

@@ -1,19 +1,19 @@
 /**
  * T025: Parser Module
  *
- * Parses .claude/commands/*.md files:
+ * Parses optional .claude/commands/*.md files:
  * - Extracts YAML frontmatter using gray-matter
  * - Validates frontmatter with Zod schema
  * - Detects placeholders ({SCRIPT:*}, {TEMPLATE:*}, {GUIDE:*}, {AGENT_SCRIPT}, $ARGUMENTS)
  * - Computes SHA-256 content hash
- * - Returns CommandIR structure
+ * - Returns PromptIR structure
  */
 const fs = require('fs');
 const path = require('path');
 const crypto = require('crypto');
 const matter = require('gray-matter');
 
-const { FrontmatterSchema, CommandIRSchema } = require('./schemas.js');
+const { FrontmatterSchema, PromptIRSchema } = require('./schemas.js');
 const {
   MissingFrontmatterError,
   InvalidFrontmatterError,
@@ -35,7 +35,6 @@ const TEMPLATE_PATTERN = /\{TEMPLATE:([^}]+)\}/g;
 const GUIDE_PATTERN = /\{GUIDE:([^}]+)\}/g;
 const AGENT_SCRIPT_PATTERN = /\{AGENT_SCRIPT\}/g;
 const ARGUMENTS_PATTERN = /\$ARGUMENTS/g;
-const IGNORED_MARKDOWN_FILES = new Set(['CLAUDE.MD']);
 
 // ============================================================
 // hashContent - 计算 SHA-256 哈希
@@ -147,9 +146,9 @@ function validateGuideAliases(placeholders, guides, filePath) {
 }
 
 // ============================================================
-// parseCommand - 解析单个命令文件
+// parsePromptFile - 解析单个提示词文件
 // ============================================================
-function parseCommand(filePath) {
+function parsePromptFile(filePath) {
   // 读取文件内容
   const absolutePath = path.resolve(filePath);
 
@@ -199,8 +198,8 @@ function parseCommand(filePath) {
   // 验证 GUIDE alias 存在性
   validateGuideAliases(placeholders, frontmatter.guides, filePath);
 
-  // 构建 CommandIR
-  const ir = {
+  // 构建 PromptIR
+  const promptIr = {
     source: {
       path: absolutePath,
       filename: path.basename(filePath, '.md'),
@@ -211,33 +210,38 @@ function parseCommand(filePath) {
     placeholders
   };
 
-  // 最终验证 CommandIR
-  const irResult = CommandIRSchema.safeParse(ir);
+  // 最终验证 PromptIR
+  const irResult = PromptIRSchema.safeParse(promptIr);
   if (!irResult.success) {
-    throw new InvalidFrontmatterError(filePath, 'Invalid CommandIR structure');
+    throw new InvalidFrontmatterError(filePath, 'Invalid PromptIR structure');
   }
 
   return irResult.data;
 }
 
 // ============================================================
-// parseAllCommands - 批量解析命令目录
+// parseAllPromptFiles - 批量解析提示词目录
 // ============================================================
-async function parseAllCommands(dirPath) {
+async function parseAllPromptFiles(dirPath) {
   const absoluteDir = path.resolve(dirPath);
 
-  const mdFiles = collectMarkdownFiles(absoluteDir, absoluteDir);
+  // skills-first 仓库可以没有 .claude/commands；此时只生成 skill/rules 产物。
+  if (!fs.existsSync(absoluteDir)) {
+    return [];
+  }
 
-  // 解析每个文件（保留相对路径，支持分层输出）
-  const results = [];
-  for (const filePath of mdFiles) {
-    try {
-      const ir = parseCommand(filePath);
+  // 读取目录中的所有文件
+  const files = fs.readdirSync(absoluteDir);
 
-      // 输出文件名使用 commands 根目录相对路径（不含扩展名）
-      const relativePath = path.relative(absoluteDir, filePath).replace(/\\/g, '/');
-      ir.source.filename = relativePath.replace(/\.md$/i, '');
+  // 过滤 .md 文件
+  const mdFiles = files.filter(file => file.endsWith('.md'));
 
+  // 解析每个文件
+  const results = [];
+  for (const file of mdFiles) {
+    const filePath = path.join(absoluteDir, file);
+    try {
+      const ir = parsePromptFile(filePath);
       results.push(ir);
     } catch (error) {
       // 重新抛出以便调用者处理
@@ -248,48 +252,12 @@ async function parseAllCommands(dirPath) {
   return results;
 }
 
-// ============================================================
-// collectMarkdownFiles - 递归收集 Markdown 文件
-// ============================================================
-function collectMarkdownFiles(rootDir, currentDir) {
-  const results = [];
-  const entries = fs.readdirSync(currentDir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    // 跳过隐藏目录与 "_" 前缀目录
-    if (entry.isDirectory()) {
-      if (entry.name.startsWith('.') || entry.name.startsWith('_')) {
-        continue;
-      }
-
-      const childFiles = collectMarkdownFiles(rootDir, path.join(currentDir, entry.name));
-      results.push(...childFiles);
-      continue;
-    }
-
-    if (!entry.isFile() || !entry.name.endsWith('.md')) {
-      continue;
-    }
-
-    if (IGNORED_MARKDOWN_FILES.has(entry.name.toUpperCase())) {
-      continue;
-    }
-
-    results.push(path.join(currentDir, entry.name));
-  }
-
-  // 统一排序，确保输出稳定
-  if (currentDir === rootDir) {
-    results.sort((a, b) => a.localeCompare(b));
-  }
-
-  return results;
-}
-
 module.exports = {
-  parseCommand,
-  parseAllCommands,
-  collectMarkdownFiles,
+  parsePromptFile,
+  parseAllPromptFiles,
+  // 兼容旧命名，避免历史调用方立即断裂。
+  parseCommand: parsePromptFile,
+  parseAllCommands: parseAllPromptFiles,
   hashContent,
   detectPlaceholders,
   validateScriptAliases,

package/lib/compiler/platforms.js

@@ -1,258 +1,66 @@
 /**
- * T001: Platform Configuration Registry (v2.0)
- *
- * [INPUT]: 无外部依赖
- * [OUTPUT]: PLATFORM_CONFIG, PLATFORMS, getPlatformConfig, isValidPlatform, getRulesEntryPath
- * [POS]: 编译器核心配置，定义四个目标平台的完整编译配置
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
+ * T001: Platform Configuration Registry
  *
  * 定义四个目标平台的编译配置:
- * - 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/)
+ * - cursor: Cursor IDE (.mdc format)
+ * - codex: Codex CLI (SKILL.md format)
+ * - qwen: Qwen Code (.toml format)
+ * - antigravity: Antigravity (.md with 12K limit)
  *
- * v2.0: 支持完整功能模块 (skills, commands, agents, rules, hooks)
+ * Reference: data-model.md#PlatformConfig
  */
 
 // ============================================================
-// MODULE_TYPES - 支持的模块类型
-// ============================================================
-const MODULE_TYPES = ['skills', 'commands', 'agents', 'rules', 'hooks'];
-
-// ============================================================
-// PLATFORM_CONFIG - 平台配置注册表 (v2.0)
+// PLATFORM_CONFIG - 平台配置注册表
 // ============================================================
 const PLATFORM_CONFIG = {
-  // ----------------------------------------------------------
-  // 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: 'skills/cc-devflow/SKILL.md',
-      format: 'markdown'
-    },
-    commandsDir: 'prompts/',
-    commandExt: '.md',
-    argumentPattern: '$ARGUMENTS',
-    hasHooks: false,
-    limits: {}
-  },
-
-  // ----------------------------------------------------------
-  // 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: 'rules/devflow.mdc',
       format: 'mdc'
     },
-    commandsDir: 'commands/',
-    commandExt: '.md',
+    promptsDir: 'commands/',
+    promptExt: '.md',
     argumentPattern: '$ARGUMENTS',
-    hasHooks: true,
+    hasHooks: false,
+    limits: {}
+  },
+
+  codex: {
+    name: 'Codex CLI',
+    folder: '.codex/',
+    promptsDir: 'prompts/',
+    promptExt: '.md',
+    argumentPattern: '$ARGUMENTS',
+    hasHooks: false,
     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'
     },
-    commandsDir: 'commands/',
-    commandExt: '.toml',
+    promptsDir: 'commands/',
+    promptExt: '.toml',
     argumentPattern: '{{args}}',
     hasHooks: false,
     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'
     },
-    commandsDir: 'workflows/',
-    commandExt: '.md',
+    promptsDir: 'workflows/',
+    promptExt: '.md',
     argumentPattern: '$ARGUMENTS',
     hasHooks: false,
     limits: {
@@ -261,6 +69,11 @@ const PLATFORM_CONFIG = {
   }
 };
 
+for (const config of Object.values(PLATFORM_CONFIG)) {
+  config.commandsDir = config.promptsDir;
+  config.commandExt = config.promptExt;
+}
+
 // ============================================================
 // PLATFORMS - 平台名称列表
 // ============================================================
@@ -289,74 +102,16 @@ function isValidPlatform(platform) {
 // ============================================================
 function getRulesEntryPath(platform) {
   const config = getPlatformConfig(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) {
+  if (!config.rulesEntry) {
     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;
+  return `${config.folder}${config.rulesEntry.path}`;
 }
 
 module.exports = {
   PLATFORM_CONFIG,
   PLATFORMS,
-  MODULE_TYPES,
   getPlatformConfig,
   isValidPlatform,
-  getRulesEntryPath,
-  getModuleConfig,
-  isModuleSupported,
-  getOutputPath
+  getRulesEntryPath
 };