cc-devflow 4.3.0 → 4.4.1

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

@@ -1,28 +1,13 @@
 /**
- * T035: AntigravityEmitter - Antigravity 平台输出 (v2.0)
+ * T035: AntigravityEmitter - Antigravity 平台输出
  *
- * [INPUT]: CommandIR, SKILL.md, agents, rules
- * [OUTPUT]: .agent/workflows/*.md, .agent/skills/*, .agent/rules/*.md, AGENTS.md
- * [POS]: Antigravity 平台编译器，支持完整功能模块
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- *
- * 输出格式:
- * - Commands: Markdown + YAML frontmatter -> .agent/workflows/
- * - Skills: SKILL.md (YAML frontmatter) -> .agent/skills/
- * - Agents: 索引摘要写入 AGENTS.md（保留用户内容）
- * - Rules: Markdown -> .agent/rules/
- *
- * 限制: 单文件 <= 12,000 字符，超限时自动拆分
- *
- * v2.0: 支持多模块编译
+ * 输出格式: Markdown + YAML frontmatter
+ * 目录: .agent/workflows/
+ * 限制: 单文件 <= 12,000 字符
+ * 超限时自动拆分
  */
-const fs = require('fs');
-const path = require('path');
 const yaml = require('js-yaml');
-const matter = require('gray-matter');
 const BaseEmitter = require('./base-emitter.js');
-const { ContextExpander } = require('../context-expander.js');
-const { discoverSkillEntries } = require('../skill-discovery.js');
 
 const CONTENT_LIMIT = 12000;
 const DESCRIPTION_LIMIT = 250;
@@ -181,199 +166,6 @@ class AntigravityEmitter extends BaseEmitter {
       content: this.createFrontmatter(description, index + 1, totalParts) + body
     }));
   }
-
-  // ----------------------------------------------------------
-  // Multi-Module Emit Methods (v2.0)
-  // ----------------------------------------------------------
-
-  /**
-   * 编译 Skills 模块
-   * .claude/skills/[name]/SKILL.md -> .agent/skills/[name]/SKILL.md
-   */
-  async emitSkills(sourceDir, targetDir) {
-    const results = [];
-
-    if (!fs.existsSync(sourceDir)) {
-      return results;
-    }
-
-    const skills = discoverSkillEntries(sourceDir);
-
-    for (const skill of skills) {
-      try {
-        const result = await this._emitSingleSkill(
-          skill.name,
-          skill.skillDir,
-          skill.skillMdPath,
-          targetDir
-        );
-        results.push(result);
-      } catch (error) {
-        console.warn(`Warning: Failed to emit skill ${skill.name}: ${error.message}`);
-      }
-    }
-
-    return results;
-  }
-
-  /**
-   * 编译单个 Skill
-   */
-  async _emitSingleSkill(skillName, skillDir, skillMdPath, targetDir) {
-    let content = await fs.promises.readFile(skillMdPath, 'utf8');
-    const parsed = matter(content);
-
-    // 展开 context.jsonl
-    const contextExpanded = ContextExpander.expandFromSkillDir(skillDir, 'antigravity');
-
-    // 构建 frontmatter (Antigravity 支持 metadata)
-    const frontmatterData = {
-      name: parsed.data.name || skillName,
-      description: (parsed.data.description || '').substring(0, DESCRIPTION_LIMIT)
-    };
-
-    // 添加 metadata (如果有)
-    if (parsed.data.metadata) {
-      frontmatterData.metadata = parsed.data.metadata;
-    }
-
-    const yamlStr = yaml.dump(frontmatterData, {
-      lineWidth: -1,
-      quotingType: '"',
-      forceQuotes: false
-    });
-
-    // 组合最终内容：frontmatter + context + body
-    let body = parsed.content;
-    if (contextExpanded) {
-      body = contextExpanded + '\n' + body;
-    }
-
-    const finalContent = `---\n${yamlStr}---\n\n${body}`;
-
-    // 输出到 .agent/skills/<skill-name>/SKILL.md
-    const targetSkillDir = path.join(targetDir, skillName);
-    const targetPath = path.join(targetSkillDir, 'SKILL.md');
-
-    const result = await this.emitToPath(targetPath, finalContent);
-
-    // 复制 scripts/ 和 references/ 目录
-    try {
-      await this._copySkillResources(skillDir, targetSkillDir);
-    } catch (error) {
-      // 资源复制失败不阻塞主 SKILL.md 产物
-      console.warn(`Warning: Failed to copy resources for skill ${skillName}: ${error.message}`);
-    }
-
-    return { ...result, skillName };
-  }
-
-  /**
-   * 复制 Skill 资源目录
-   */
-  async _copySkillResources(sourceSkillDir, targetSkillDir) {
-    const resourceDirs = ['scripts', 'references', 'assets', 'examples', 'resources'];
-
-    for (const dir of resourceDirs) {
-      const sourceResDir = path.join(sourceSkillDir, dir);
-      const targetResDir = path.join(targetSkillDir, dir);
-
-      if (fs.existsSync(sourceResDir)) {
-        await this._copyDir(sourceResDir, targetResDir);
-      }
-    }
-  }
-
-  /**
-   * 递归复制目录
-   */
-  async _copyDir(src, dest) {
-    await fs.promises.mkdir(dest, { recursive: true, mode: 0o755 });
-    const entries = await fs.promises.readdir(src, { withFileTypes: true });
-
-    for (const entry of entries) {
-      const srcPath = path.join(src, entry.name);
-      const destPath = path.join(dest, entry.name);
-
-      if (entry.isDirectory()) {
-        await this._copyDir(srcPath, destPath);
-      } else if (entry.isSymbolicLink()) {
-        try {
-          const resolvedPath = await fs.promises.realpath(srcPath);
-          const resolvedStats = await fs.promises.stat(resolvedPath);
-          await fs.promises.rm(destPath, { force: true, recursive: true });
-
-          if (resolvedStats.isDirectory()) {
-            await this._copyDir(resolvedPath, destPath);
-          } else {
-            await fs.promises.copyFile(resolvedPath, destPath);
-          }
-        } catch (error) {
-          console.warn(`Warning: Skip broken symlink ${srcPath}: ${error.message}`);
-        }
-      } else {
-        await fs.promises.copyFile(srcPath, destPath);
-      }
-    }
-  }
-
-  /**
-   * 编译 Agents 模块
-   * .claude/agents/[name].md -> AGENTS.md (短索引，受管块)
-   */
-  async emitAgents(sourceDir, targetPath) {
-    const results = [];
-    const agentNames = await this.readMarkdownEntryNames(sourceDir);
-
-    if (agentNames.length === 0) {
-      return results;
-    }
-
-    const summary = [
-      '## CC-DevFlow Agents',
-      '',
-      '- Scope: `.claude/agents/*.md`',
-      `- Count: ${agentNames.length}`,
-      `- Entries: ${this.formatCompactList(agentNames)}`,
-      '- Policy: Keep AGENTS.md concise; detailed agent instructions stay in source files.'
-    ].join('\n');
-
-    const result = await this.upsertManagedBlock(targetPath, 'antigravity-agents', summary);
-    results.push({ ...result, count: agentNames.length });
-
-    return results;
-  }
-
-  /**
-   * 编译 Rules 模块
-   * .claude/rules/[name].md -> .agent/rules/[name].md
-   */
-  async emitRules(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 ruleName = entry.name.replace('.md', '');
-
-      // Antigravity rules 是纯 Markdown
-      const targetPath = path.join(targetDir, `${ruleName}.md`);
-      const result = await this.emitToPath(targetPath, content);
-      results.push({ ...result, ruleName });
-    }
-
-    return results;
-  }
 }
 
 module.exports = AntigravityEmitter;

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

@@ -1,10 +1,5 @@
 /**
- * T031: BaseEmitter - Emitter 基类 (v2.0)
- *
- * [INPUT]: 平台配置 (platforms.js)
- * [OUTPUT]: 编译后的文件
- * [POS]: 编译器核心，定义 Emitter 接口和多模块编译能力
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
+ * T031: BaseEmitter - Emitter 基类
  *
  * 定义 Emitter 接口:
  * - name: 平台名称
@@ -12,8 +7,6 @@
  * - fileExtension: 文件扩展名
  * - format(ir, transformedContent): 格式化输出
  * - emit(filename, content): 写入文件
- *
- * v2.0: 支持多模块编译 (skills, commands, agents, rules, hooks)
  */
 const fs = require('fs');
 const path = require('path');
@@ -23,18 +16,6 @@ const crypto = require('crypto');
 // SECURITY CONFIGURATION (FINDING-003)
 // ============================================================
 const MAX_OUTPUT_SIZE = 2 * 1024 * 1024; // 2MB limit
-const MANAGED_BLOCK_PREFIX = 'cc-devflow';
-
-// ============================================================
-// MODULE_TYPES - 支持的模块类型
-// ============================================================
-const MODULE_TYPES = {
-  SKILLS: 'skills',
-  COMMANDS: 'commands',
-  AGENTS: 'agents',
-  RULES: 'rules',
-  HOOKS: 'hooks'
-};
 
 class BaseEmitter {
   // ----------------------------------------------------------
@@ -53,7 +34,7 @@ class BaseEmitter {
   }
 
   // ----------------------------------------------------------
-  // format() - 子类必须实现 (Commands 格式化)
+  // format() - 子类必须实现
   // ----------------------------------------------------------
   format(ir, transformedContent) {
     throw new Error('Not implemented');
@@ -71,11 +52,9 @@ class BaseEmitter {
     const outputDir = this.outputDir;
     const ext = this.fileExtension;
     const filePath = path.join(outputDir, `${filename}${ext}`);
-    const fileDir = path.dirname(filePath);
 
     // ✅ SECURITY FIX (FINDING-005): Set explicit directory permissions
-    // 支持带子路径的文件名（例如 flow/new）
-    await fs.promises.mkdir(fileDir, { recursive: true, mode: 0o755 });
+    await fs.promises.mkdir(outputDir, { recursive: true, mode: 0o755 });
 
     // ✅ SECURITY FIX (FINDING-005): Set explicit file permissions
     await fs.promises.writeFile(filePath, content, { encoding: 'utf8', mode: 0o644 });
@@ -89,280 +68,6 @@ class BaseEmitter {
       timestamp: new Date().toISOString()
     };
   }
-
-  // ----------------------------------------------------------
-  // emitToPath() - 写入文件到指定路径
-  // ----------------------------------------------------------
-  async emitToPath(filePath, content) {
-    if (content.length > MAX_OUTPUT_SIZE) {
-      throw new Error(`Output too large: ${filePath} (${content.length} bytes > ${MAX_OUTPUT_SIZE} bytes)`);
-    }
-
-    const outputDir = path.dirname(filePath);
-    await fs.promises.mkdir(outputDir, { recursive: true, mode: 0o755 });
-    await fs.promises.writeFile(filePath, content, { encoding: 'utf8', mode: 0o644 });
-
-    const hash = crypto.createHash('sha256').update(content).digest('hex');
-
-    return {
-      path: filePath,
-      hash,
-      timestamp: new Date().toISOString()
-    };
-  }
-
-  // ----------------------------------------------------------
-  // Multi-Module Emit Methods (v2.0)
-  // 子类可覆盖以实现平台特定逻辑
-  // ----------------------------------------------------------
-
-  /**
-   * 编译 Skills 模块
-   * @param {string} sourceDir - 源目录 (.claude/skills/)
-   * @param {string} targetDir - 目标目录
-   * @returns {Promise<Array>} 编译结果
-   */
-  async emitSkills(sourceDir, targetDir) {
-    // 默认实现: 复制 SKILL.md 文件
-    return this._defaultSkillsEmit(sourceDir, targetDir);
-  }
-
-  /**
-   * 编译 Commands 模块
-   * @param {Array} irs - 命令 IR 数组
-   * @param {string} targetDir - 目标目录
-   * @returns {Promise<Array>} 编译结果
-   */
-  async emitCommands(irs, targetDir) {
-    // 默认实现: 使用现有 format/emit 逻辑
-    const results = [];
-    for (const ir of irs) {
-      const formatted = this.format(ir, ir.body);
-      const result = await this.emit(ir.source.filename, formatted);
-      results.push(result);
-    }
-    return results;
-  }
-
-  /**
-   * 编译 Agents 模块
-   * @param {string} sourceDir - 源目录 (.claude/agents/)
-   * @param {string} targetPath - 目标路径 (文件或目录)
-   * @returns {Promise<Array>} 编译结果
-   */
-  async emitAgents(sourceDir, targetPath) {
-    // 默认实现: 合并到 AGENTS.md
-    return this._defaultAgentsEmit(sourceDir, targetPath);
-  }
-
-  /**
-   * 编译 Rules 模块
-   * @param {string} sourceDir - 源目录 (.claude/rules/)
-   * @param {string} targetPath - 目标路径 (文件或目录)
-   * @returns {Promise<Array>} 编译结果
-   */
-  async emitRules(sourceDir, targetPath) {
-    // 默认实现: 复制或合并
-    return this._defaultRulesEmit(sourceDir, targetPath);
-  }
-
-  /**
-   * 编译 Hooks 模块
-   * @param {string} sourceDir - 源目录 (.claude/hooks/)
-   * @param {string} targetDir - 目标目录
-   * @returns {Promise<Array>} 编译结果
-   */
-  async emitHooks(sourceDir, targetDir) {
-    // 默认实现: 不支持
-    return [];
-  }
-
-  // ----------------------------------------------------------
-  // Default Implementations
-  // ----------------------------------------------------------
-
-  async _defaultSkillsEmit(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.isDirectory() || entry.name.startsWith('_')) {
-        continue;
-      }
-
-      const skillDir = path.join(sourceDir, entry.name);
-      const skillMdPath = path.join(skillDir, 'SKILL.md');
-
-      if (!fs.existsSync(skillMdPath)) {
-        continue;
-      }
-
-      const content = await fs.promises.readFile(skillMdPath, 'utf8');
-      const targetSkillDir = path.join(targetDir, entry.name);
-      const targetPath = path.join(targetSkillDir, 'SKILL.md');
-
-      const result = await this.emitToPath(targetPath, content);
-      results.push({ ...result, skillName: entry.name });
-    }
-
-    return results;
-  }
-
-  async _defaultAgentsEmit(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 agentName = entry.name.replace('.md', '');
-
-      sections.push(`## ${agentName}\n\n${content}`);
-    }
-
-    if (sections.length > 0) {
-      const merged = `# Agents\n\n${sections.join('\n\n---\n\n')}`;
-      const result = await this.emitToPath(targetPath, merged);
-      results.push(result);
-    }
-
-    return results;
-  }
-
-  async _defaultRulesEmit(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 ruleName = entry.name.replace('.md', '');
-
-      sections.push(`## ${ruleName}\n\n${content}`);
-    }
-
-    if (sections.length > 0) {
-      const merged = `# Rules\n\n${sections.join('\n\n---\n\n')}`;
-      const result = await this.emitToPath(targetPath, merged);
-      results.push(result);
-    }
-
-    return results;
-  }
-
-  // ----------------------------------------------------------
-  // Utility Methods
-  // ----------------------------------------------------------
-
-  /**
-   * 计算内容哈希
-   */
-  hashContent(content) {
-    return crypto.createHash('sha256').update(content).digest('hex');
-  }
-
-  /**
-   * 读取目录下的 Markdown 文件名（去掉 .md）
-   */
-  async readMarkdownEntryNames(sourceDir) {
-    if (!fs.existsSync(sourceDir)) {
-      return [];
-    }
-
-    const entries = await fs.promises.readdir(sourceDir, { withFileTypes: true });
-
-    return entries
-      .filter(entry => entry.isFile() && entry.name.endsWith('.md'))
-      .map(entry => entry.name.replace(/\.md$/, ''))
-      .sort((a, b) => a.localeCompare(b));
-  }
-
-  /**
-   * 格式化短列表，避免全局记忆文件过长
-   */
-  formatCompactList(items, maxItems = 12) {
-    if (!items || items.length === 0) {
-      return '`(none)`';
-    }
-
-    const visible = items.slice(0, maxItems).map(item => `\`${item}\``);
-    const hiddenCount = items.length - visible.length;
-
-    if (hiddenCount > 0) {
-      visible.push(`... (+${hiddenCount} more)`);
-    }
-
-    return visible.join(', ');
-  }
-
-  /**
-   * 受管块写入：仅替换指定区块，保留用户原有内容
-   */
-  async upsertManagedBlock(targetPath, blockId, body) {
-    const startMarker = `<!-- ${MANAGED_BLOCK_PREFIX}:${blockId}:start -->`;
-    const endMarker = `<!-- ${MANAGED_BLOCK_PREFIX}:${blockId}:end -->`;
-    const managedBlock = `${startMarker}\n${body.trim()}\n${endMarker}`;
-
-    let existing = '';
-    if (fs.existsSync(targetPath)) {
-      existing = await fs.promises.readFile(targetPath, 'utf8');
-    }
-
-    const merged = this._replaceManagedBlock(existing, startMarker, endMarker, managedBlock);
-    return this.emitToPath(targetPath, merged);
-  }
-
-  _replaceManagedBlock(existing, startMarker, endMarker, managedBlock) {
-    const startIndex = existing.indexOf(startMarker);
-    const endIndex = existing.indexOf(endMarker);
-
-    if (startIndex !== -1 && endIndex !== -1 && endIndex > startIndex) {
-      const before = existing.slice(0, startIndex).trimEnd();
-      const after = existing.slice(endIndex + endMarker.length).trimStart();
-
-      return this._joinBlocks(before, managedBlock, after);
-    }
-
-    if (!existing.trim()) {
-      return `${managedBlock}\n`;
-    }
-
-    return `${existing.trimEnd()}\n\n${managedBlock}\n`;
-  }
-
-  _joinBlocks(...blocks) {
-    const validBlocks = blocks.filter(block => block && block.trim().length > 0);
-    if (validBlocks.length === 0) {
-      return '';
-    }
-    return `${validBlocks.join('\n\n')}\n`;
-  }
 }
 
 module.exports = BaseEmitter;
-module.exports.MODULE_TYPES = MODULE_TYPES;