cc-devflow 1.0.1

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

@@ -0,0 +1,39 @@
+/**
+ * T034: QwenEmitter - Qwen 平台输出
+ *
+ * 输出格式: TOML
+ * 目录: .qwen/commands/
+ * 字段: description, prompt
+ */
+const toml = require('@iarna/toml');
+const BaseEmitter = require('./base-emitter.js');
+
+class QwenEmitter extends BaseEmitter {
+  get name() {
+    return 'qwen';
+  }
+
+  get outputDir() {
+    return '.qwen/commands';
+  }
+
+  get fileExtension() {
+    return '.toml';
+  }
+
+  /**
+   * 格式化为 Qwen TOML 格式
+   * - description: 命令描述
+   * - prompt: Markdown 正文
+   */
+  format(ir, transformedContent) {
+    const tomlObj = {
+      description: ir.frontmatter.description,
+      prompt: transformedContent
+    };
+
+    return toml.stringify(tomlObj);
+  }
+}
+
+module.exports = QwenEmitter;

package/lib/compiler/errors.js

@@ -0,0 +1,119 @@
+/**
+ * T024: Compiler Error Types
+ *
+ * Custom error classes for Command Emitter:
+ * - CompilerError: Base class
+ * - MissingFrontmatterError: File lacks YAML frontmatter
+ * - InvalidFrontmatterError: Frontmatter validation failed
+ * - UnknownAliasError: {SCRIPT:alias} references undefined alias
+ * - UnknownTemplateAliasError: {TEMPLATE:alias} references undefined alias
+ * - UnknownGuideAliasError: {GUIDE:alias} references undefined alias
+ * - WriteError: File write operation failed
+ * - ContentTooLargeError: Content exceeds platform limit
+ */
+
+// ============================================================
+// CompilerError - 基类
+// ============================================================
+class CompilerError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = 'CompilerError';
+    Error.captureStackTrace(this, this.constructor);
+  }
+}
+
+// ============================================================
+// MissingFrontmatterError - 缺少 frontmatter
+// ============================================================
+class MissingFrontmatterError extends CompilerError {
+  constructor(filePath) {
+    super(`Missing YAML frontmatter in file: ${filePath}`);
+    this.name = 'MissingFrontmatterError';
+    this.filePath = filePath;
+  }
+}
+
+// ============================================================
+// InvalidFrontmatterError - frontmatter 格式错误
+// ============================================================
+class InvalidFrontmatterError extends CompilerError {
+  constructor(filePath, reason) {
+    super(`Invalid frontmatter in ${filePath}: ${reason}`);
+    this.name = 'InvalidFrontmatterError';
+    this.filePath = filePath;
+    this.reason = reason;
+  }
+}
+
+// ============================================================
+// UnknownAliasError - 未知 script alias
+// ============================================================
+class UnknownAliasError extends CompilerError {
+  constructor(filePath, alias) {
+    super(`Unknown script alias '${alias}' in file: ${filePath}`);
+    this.name = 'UnknownAliasError';
+    this.filePath = filePath;
+    this.alias = alias;
+  }
+}
+
+// ============================================================
+// UnknownTemplateAliasError - 未知 template alias
+// ============================================================
+class UnknownTemplateAliasError extends CompilerError {
+  constructor(filePath, alias) {
+    super(`Unknown template alias '${alias}' in file: ${filePath}`);
+    this.name = 'UnknownTemplateAliasError';
+    this.filePath = filePath;
+    this.alias = alias;
+  }
+}
+
+// ============================================================
+// UnknownGuideAliasError - 未知 guide alias
+// ============================================================
+class UnknownGuideAliasError extends CompilerError {
+  constructor(filePath, alias) {
+    super(`Unknown guide alias '${alias}' in file: ${filePath}`);
+    this.name = 'UnknownGuideAliasError';
+    this.filePath = filePath;
+    this.alias = alias;
+  }
+}
+
+// ============================================================
+// WriteError - 写入失败
+// ============================================================
+class WriteError extends CompilerError {
+  constructor(filePath, cause) {
+    super(`Failed to write file ${filePath}: ${cause}`);
+    this.name = 'WriteError';
+    this.filePath = filePath;
+    this.cause = cause;
+  }
+}
+
+// ============================================================
+// ContentTooLargeError - 内容超限
+// ============================================================
+class ContentTooLargeError extends CompilerError {
+  constructor(filePath, actualSize, limit) {
+    super(`Content too large in ${filePath}: ${actualSize} chars exceeds limit of ${limit}`);
+    this.name = 'ContentTooLargeError';
+    this.filePath = filePath;
+    this.actualSize = actualSize;
+    this.limit = limit;
+  }
+}
+
+module.exports = {
+  CompilerError,
+  MissingFrontmatterError,
+  InvalidFrontmatterError,
+  UnknownAliasError,
+  UnknownTemplateAliasError,
+  UnknownGuideAliasError,
+  WriteError,
+  ContentTooLargeError
+};

package/lib/compiler/index.js

@@ -0,0 +1,256 @@
+/**
+ * Compiler Entry Point (v2.0)
+ *
+ * 编译器主入口:
+ * - compile(options): 编译命令文件到目标平台
+ * - 协调 parser, transformer, emitters, manifest
+ * - 复制资源文件并重写路径
+ * - 生成 skills-registry.json 和规则入口文件
+ *
+ * v2.0 (REQ-006): 支持 --rules, --skills 参数
+ */
+const path = require('path');
+
+const { parseAllCommands } = require('./parser.js');
+const { transformForPlatform } = require('./transformer.js');
+const { getEmitter, getAllEmitters, PLATFORMS } = require('./emitters/index.js');
+const {
+  loadManifest,
+  saveManifest,
+  needsRecompile,
+  addEntry,
+  createEntry,
+  createManifest,
+  hashContent,
+  migrateToV2,
+  addSkillEntry,
+  addRulesEntry,
+  needsSkillRecompile,
+  needsRulesRecompile,
+  MANIFEST_PATH
+} = require('./manifest.js');
+const {
+  collectReferencedResources,
+  copyResourcesForAllPlatforms,
+  mapPathToPlatform
+} = require('./resource-copier.js');
+const { generateSkillsRegistryV2, writeSkillsRegistry } = require('./skills-registry.js');
+const { getRulesEmitter, emitAllRules } = require('./rules-emitters/index.js');
+
+// ============================================================
+// compile - 编译主函数
+// ============================================================
+async function compile(options = {}) {
+  const {
+    sourceDir = '.claude/commands/',
+    skillsDir = '.claude/skills/',
+    outputBaseDir = '.',
+    platforms = PLATFORMS,
+    verbose = false,
+    check = false,
+    rules = true,
+    skills = true
+  } = options;
+
+  // 验证平台参数
+  for (const platform of platforms) {
+    if (!PLATFORMS.includes(platform)) {
+      throw new Error(`Unknown platform: ${platform}`);
+    }
+  }
+
+  const result = {
+    success: true,
+    platforms: platforms,
+    filesCompiled: 0,
+    filesSkipped: 0,
+    resourcesCopied: 0,
+    resourcesSkipped: 0,
+    rulesGenerated: 0,
+    skillsRegistered: 0,
+    errors: []
+  };
+
+  // 加载 manifest 并迁移到 v2.0
+  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
+    };
+  }
+
+  // 生成 skills registry
+  let registry = null;
+  if (skills) {
+    try {
+      registry = await generateSkillsRegistryV2(skillsDir);
+      await writeSkillsRegistry(registry);
+      result.skillsRegistered = registry.skills.length;
+
+      // 更新 manifest 中的技能记录
+      for (const skill of registry.skills) {
+        const skillHash = hashContent(JSON.stringify(skill));
+        addSkillEntry(manifest, {
+          name: skill.name,
+          sourceHash: skillHash,
+          timestamp: new Date().toISOString()
+        });
+      }
+
+      if (verbose) {
+        console.log(`Generated skills-registry.json with ${registry.skills.length} skills`);
+      }
+    } catch (error) {
+      result.errors.push(`Skills registry: ${error.message}`);
+    }
+  }
+
+  // 解析所有命令文件
+  const absoluteSourceDir = path.resolve(sourceDir);
+  let irs = [];
+  try {
+    irs = await parseAllCommands(absoluteSourceDir);
+  } catch (error) {
+    result.success = false;
+    result.errors.push(error.message);
+    return result;
+  }
+
+  if (verbose) {
+    console.log(`Found ${irs.length} command files`);
+  }
+
+  // 生成规则入口文件
+  if (rules && registry) {
+    try {
+      const commands = irs.map(ir => ({
+        name: ir.source.filename.replace(/\.md$/, ''),
+        description: ir.frontmatter?.description || ''
+      }));
+
+      const rulesResults = await emitAllRules(registry, commands, { platforms });
+
+      for (const ruleResult of rulesResults) {
+        if (ruleResult.error) {
+          result.errors.push(`Rules ${ruleResult.platform}: ${ruleResult.error}`);
+        } else {
+          result.rulesGenerated++;
+
+          // 更新 manifest
+          addRulesEntry(manifest, ruleResult.platform, {
+            path: ruleResult.path,
+            hash: ruleResult.hash,
+            timestamp: ruleResult.timestamp
+          });
+
+          if (verbose) {
+            console.log(`Generated rules entry: ${ruleResult.path}`);
+          }
+        }
+      }
+    } catch (error) {
+      result.errors.push(`Rules generation: ${error.message}`);
+    }
+  }
+
+  // 复制资源文件到各平台目录
+  const copyResult = await copyResourcesForAllPlatforms(irs, platforms, { verbose });
+  result.resourcesCopied = copyResult.totalCopied;
+  result.resourcesSkipped = copyResult.totalSkipped;
+
+  if (verbose && copyResult.totalCopied > 0) {
+    console.log(`Copied ${copyResult.totalCopied} resource files (${copyResult.totalSkipped} unchanged)`);
+  }
+
+  // 为每个平台构建路径映射
+  const platformPathMaps = copyResult.allPathMaps;
+
+  // 编译每个文件到每个平台
+  for (const ir of irs) {
+    for (const platform of platforms) {
+      // 检查是否需要重新编译
+      const sourceRelative = path.relative(outputBaseDir, ir.source.path);
+      if (!needsRecompile(sourceRelative, ir.source.hash, manifest, platform)) {
+        result.filesSkipped++;
+        if (verbose) {
+          console.log(`Skipped: ${ir.source.filename} -> ${platform} (unchanged)`);
+        }
+        continue;
+      }
+
+      try {
+        // 获取该平台的路径映射
+        const pathMap = platformPathMaps[platform] || {};
+
+        // 转换（传入 pathMap 以重写路径）
+        const transformed = transformForPlatform(ir, platform, { pathMap });
+
+        // 获取 emitter
+        const emitter = getEmitter(platform);
+
+        // 格式化
+        const formatted = emitter.format(ir, transformed.body);
+
+        // 处理拆分文件（Antigravity 可能返回数组）
+        if (Array.isArray(formatted)) {
+          for (const part of formatted) {
+            const emitResult = await emitter.emit(part.filename, part.content);
+
+            // 更新 manifest
+            addEntry(manifest, createEntry({
+              source: sourceRelative,
+              target: emitResult.path,
+              sourceHash: ir.source.hash,
+              targetHash: emitResult.hash,
+              platform
+            }));
+
+            if (verbose) {
+              console.log(`Compiled: ${ir.source.filename} -> ${platform} (${part.filename})`);
+            }
+          }
+        } else {
+          const emitResult = await emitter.emit(ir.source.filename, formatted);
+
+          // 更新 manifest
+          addEntry(manifest, createEntry({
+            source: sourceRelative,
+            target: emitResult.path,
+            sourceHash: ir.source.hash,
+            targetHash: emitResult.hash,
+            platform
+          }));
+
+          if (verbose) {
+            console.log(`Compiled: ${ir.source.filename} -> ${platform}`);
+          }
+        }
+
+        result.filesCompiled++;
+      } catch (error) {
+        result.success = false;
+        result.errors.push(`${ir.source.filename} -> ${platform}: ${error.message}`);
+      }
+    }
+  }
+
+  // 保存 manifest
+  manifest.generatedAt = new Date().toISOString();
+  await saveManifest(manifest, manifestPath);
+
+  return result;
+}
+
+module.exports = {
+  compile,
+  PLATFORMS
+};

package/lib/compiler/manifest.js

@@ -0,0 +1,242 @@
+/**
+ * T039: Manifest Module (v2.0)
+ *
+ * 管理编译清单:
+ * - hashContent(): 计算 SHA-256 哈希
+ * - loadManifest() / saveManifest(): 持久化
+ * - needsRecompile(): 增量编译判断
+ * - addEntry(): 添加/更新条目
+ * - checkDrift(): 漂移检测
+ *
+ * v2.0 新增 (REQ-006):
+ * - skills: 技能编译记录
+ * - rulesEntry: 规则入口文件记录
+ * - migrateToV2(): v1.0 → v2.0 迁移
+ */
+const fs = require('fs');
+const path = require('path');
+const crypto = require('crypto');
+
+const MANIFEST_PATH = 'devflow/.generated/manifest.json';
+const MANIFEST_VERSION = '2.0';
+
+// ============================================================
+// hashContent - 计算 SHA-256 哈希
+// ============================================================
+function hashContent(content) {
+  return crypto.createHash('sha256').update(content).digest('hex');
+}
+
+// ============================================================
+// createEntry - 创建 manifest 条目
+// ============================================================
+function createEntry({ source, target, sourceHash, targetHash, platform }) {
+  return {
+    source,
+    target,
+    hash: sourceHash,
+    timestamp: new Date().toISOString(),
+    platform
+  };
+}
+
+// ============================================================
+// loadManifest - 加载现有 manifest
+// ============================================================
+async function loadManifest(manifestPath = MANIFEST_PATH) {
+  try {
+    const content = await fs.promises.readFile(manifestPath, 'utf8');
+    return JSON.parse(content);
+  } catch (error) {
+    if (error.code === 'ENOENT') {
+      return null;
+    }
+    throw error;
+  }
+}
+
+// ============================================================
+// saveManifest - 保存 manifest
+// ============================================================
+async function saveManifest(manifest, manifestPath = MANIFEST_PATH) {
+  const dir = path.dirname(manifestPath);
+  await fs.promises.mkdir(dir, { recursive: true });
+  await fs.promises.writeFile(manifestPath, JSON.stringify(manifest, null, 2), 'utf8');
+}
+
+// ============================================================
+// needsRecompile - 检查是否需要重新编译
+// ============================================================
+function needsRecompile(sourcePath, sourceHash, manifest, platform) {
+  if (!manifest || !manifest.entries) {
+    return true;
+  }
+
+  const entry = manifest.entries.find(e => e.source === sourcePath && e.platform === platform);
+  if (!entry) {
+    return true;
+  }
+
+  return entry.hash !== sourceHash;
+}
+
+// ============================================================
+// addEntry - 添加或更新条目
+// ============================================================
+function addEntry(manifest, entry) {
+  const existingIndex = manifest.entries.findIndex(e => e.source === entry.source && e.platform === entry.platform);
+
+  if (existingIndex >= 0) {
+    manifest.entries[existingIndex] = entry;
+  } else {
+    manifest.entries.push(entry);
+  }
+}
+
+// ============================================================
+// checkDrift - 检查漂移（目标文件被手动修改）
+// ============================================================
+async function checkDrift(manifest) {
+  const driftReport = [];
+
+  if (!manifest || !manifest.entries) {
+    return driftReport;
+  }
+
+  for (const entry of manifest.entries) {
+    try {
+      // 读取目标文件当前内容
+      const targetContent = await fs.promises.readFile(entry.target, 'utf8');
+      const targetCurrentHash = hashContent(targetContent);
+
+      // 漂移检测：比较目标文件当前哈希与 manifest 记录的哈希
+      // 如果不一致，说明目标文件被手动修改了
+      if (targetCurrentHash !== entry.hash) {
+        driftReport.push({
+          source: entry.source,
+          target: entry.target,
+          issue: 'target file modified since last compile'
+        });
+      }
+    } catch (error) {
+      if (error.code === 'ENOENT') {
+        driftReport.push({
+          source: entry.source,
+          target: entry.target,
+          issue: 'target file missing'
+        });
+      }
+    }
+  }
+
+  return driftReport;
+}
+
+// ============================================================
+// createManifest - 创建新的空 manifest (v2.0)
+// ============================================================
+function createManifest() {
+  return {
+    version: MANIFEST_VERSION,
+    generatedAt: new Date().toISOString(),
+    entries: [],
+    skills: [],
+    rulesEntry: {}
+  };
+}
+
+// ============================================================
+// migrateToV2 - 从 v1.0 迁移到 v2.0
+// ============================================================
+function migrateToV2(manifest) {
+  if (!manifest) {
+    return createManifest();
+  }
+
+  // 已是 v2.0
+  if (manifest.version === '2.0' || manifest.version === MANIFEST_VERSION) {
+    return manifest;
+  }
+
+  // v1.0 → v2.0 迁移
+  return {
+    version: MANIFEST_VERSION,
+    generatedAt: manifest.generatedAt || new Date().toISOString(),
+    entries: manifest.entries || [],
+    skills: [],
+    rulesEntry: {}
+  };
+}
+
+// ============================================================
+// addSkillEntry - 添加或更新技能记录
+// ============================================================
+function addSkillEntry(manifest, skillEntry) {
+  if (!manifest.skills) {
+    manifest.skills = [];
+  }
+
+  const existingIndex = manifest.skills.findIndex(s => s.name === skillEntry.name);
+
+  if (existingIndex >= 0) {
+    manifest.skills[existingIndex] = skillEntry;
+  } else {
+    manifest.skills.push(skillEntry);
+  }
+}
+
+// ============================================================
+// addRulesEntry - 添加或更新规则入口文件记录
+// ============================================================
+function addRulesEntry(manifest, platform, rulesEntry) {
+  if (!manifest.rulesEntry) {
+    manifest.rulesEntry = {};
+  }
+
+  manifest.rulesEntry[platform] = rulesEntry;
+}
+
+// ============================================================
+// needsSkillRecompile - 检查技能是否需要重新编译
+// ============================================================
+function needsSkillRecompile(skillName, sourceHash, manifest) {
+  if (!manifest || !manifest.skills) {
+    return true;
+  }
+
+  const entry = manifest.skills.find(s => s.name === skillName);
+  if (!entry) {
+    return true;
+  }
+
+  return entry.sourceHash !== sourceHash;
+}
+
+// ============================================================
+// needsRulesRecompile - 检查规则入口是否需要重新编译
+// ============================================================
+function needsRulesRecompile(platform, sourceHash, manifest) {
+  if (!manifest || !manifest.rulesEntry || !manifest.rulesEntry[platform]) {
+    return true;
+  }
+
+  return manifest.rulesEntry[platform].hash !== sourceHash;
+}
+
+module.exports = {
+  MANIFEST_PATH,
+  MANIFEST_VERSION,
+  hashContent,
+  createEntry,
+  loadManifest,
+  saveManifest,
+  needsRecompile,
+  addEntry,
+  checkDrift,
+  createManifest,
+  migrateToV2,
+  addSkillEntry,
+  addRulesEntry,
+  needsSkillRecompile,
+  needsRulesRecompile
+};