cc-devflow 1.0.1

package/lib/compiler/__tests__/transformer.test.js

@@ -0,0 +1,286 @@
+/**
+ * T012: Transformer Tests
+ * Tests for placeholder expansion and argument mapping
+ * Expected: All tests FAIL (transformer not implemented)
+ */
+
+// ============================================================
+// Transformer imports - will fail until lib/compiler/transformer.js exists
+// ============================================================
+let transformer;
+let errors;
+try {
+  transformer = require('../transformer.js');
+  errors = require('../errors.js');
+} catch (e) {
+  transformer = null;
+  errors = null;
+}
+
+// Sample CommandIR for testing
+const createTestIR = (overrides = {}) => ({
+  source: {
+    path: '/test/flow-test.md',
+    filename: 'flow-test',
+    hash: 'sha256:abc123'
+  },
+  frontmatter: {
+    name: 'flow-test',
+    description: 'Test command',
+    scripts: {
+      prereq: '.claude/scripts/check-prerequisites.sh',
+      validate: '.claude/scripts/validate.sh'
+    },
+    ...overrides.frontmatter
+  },
+  body: overrides.body || 'Run {SCRIPT:prereq} and validate with {SCRIPT:validate}',
+  placeholders: overrides.placeholders || [
+    { type: 'SCRIPT', raw: '{SCRIPT:prereq}', alias: 'prereq', position: { start: 4, end: 19 } },
+    { type: 'SCRIPT', raw: '{SCRIPT:validate}', alias: 'validate', position: { start: 40, end: 57 } }
+  ]
+});
+
+describe('Transformer Module', () => {
+  beforeEach(() => {
+    if (!transformer) {
+      throw new Error('transformer.js not implemented');
+    }
+  });
+
+  // ----------------------------------------------------------
+  // AC1: {SCRIPT:prereq} expanded to "bash .claude/scripts/..."
+  // ----------------------------------------------------------
+  describe('AC1: SCRIPT placeholder expansion', () => {
+    it('should expand {SCRIPT:prereq} to bash path', () => {
+      const ir = createTestIR({
+        body: 'Run {SCRIPT:prereq}',
+        placeholders: [
+          { type: 'SCRIPT', raw: '{SCRIPT:prereq}', alias: 'prereq', position: { start: 4, end: 19 } }
+        ]
+      });
+      const result = transformer.transformForPlatform(ir, 'codex');
+      expect(result.body).toContain('bash .claude/scripts/check-prerequisites.sh');
+      expect(result.body).not.toContain('{SCRIPT:prereq}');
+    });
+
+    it('should expand multiple {SCRIPT:*} placeholders', () => {
+      const ir = createTestIR();
+      const result = transformer.transformForPlatform(ir, 'codex');
+      expect(result.body).toContain('bash .claude/scripts/check-prerequisites.sh');
+      expect(result.body).toContain('bash .claude/scripts/validate.sh');
+      expect(result.body).not.toContain('{SCRIPT:');
+    });
+  });
+
+  // ----------------------------------------------------------
+  // AC2: $ARGUMENTS -> {{args}} for Qwen
+  // ----------------------------------------------------------
+  describe('AC2: $ARGUMENTS -> {{args}} for Qwen', () => {
+    it('should map $ARGUMENTS to {{args}} for Qwen', () => {
+      const ir = createTestIR({
+        body: 'Input: $ARGUMENTS',
+        placeholders: [
+          { type: 'ARGUMENTS', raw: '$ARGUMENTS', position: { start: 7, end: 17 } }
+        ]
+      });
+      const result = transformer.transformForPlatform(ir, 'qwen');
+      expect(result.body).toContain('{{args}}');
+      expect(result.body).not.toContain('$ARGUMENTS');
+    });
+  });
+
+  // ----------------------------------------------------------
+  // AC3: $ARGUMENTS -> [arguments] for Antigravity
+  // ----------------------------------------------------------
+  describe('AC3: $ARGUMENTS -> [arguments] for Antigravity', () => {
+    it('should map $ARGUMENTS to [arguments] for Antigravity', () => {
+      const ir = createTestIR({
+        body: 'Input: $ARGUMENTS',
+        placeholders: [
+          { type: 'ARGUMENTS', raw: '$ARGUMENTS', position: { start: 7, end: 17 } }
+        ]
+      });
+      const result = transformer.transformForPlatform(ir, 'antigravity');
+      expect(result.body).toContain('[arguments]');
+      expect(result.body).not.toContain('$ARGUMENTS');
+    });
+  });
+
+  // ----------------------------------------------------------
+  // AC4: $ARGUMENTS unchanged for Codex/Cursor
+  // ----------------------------------------------------------
+  describe('AC4: $ARGUMENTS unchanged for Codex/Cursor', () => {
+    it('should keep $ARGUMENTS unchanged for Codex', () => {
+      const ir = createTestIR({
+        body: 'Input: $ARGUMENTS',
+        placeholders: [
+          { type: 'ARGUMENTS', raw: '$ARGUMENTS', position: { start: 7, end: 17 } }
+        ]
+      });
+      const result = transformer.transformForPlatform(ir, 'codex');
+      expect(result.body).toContain('$ARGUMENTS');
+    });
+
+    it('should keep $ARGUMENTS unchanged for Cursor', () => {
+      const ir = createTestIR({
+        body: 'Input: $ARGUMENTS',
+        placeholders: [
+          { type: 'ARGUMENTS', raw: '$ARGUMENTS', position: { start: 7, end: 17 } }
+        ]
+      });
+      const result = transformer.transformForPlatform(ir, 'cursor');
+      expect(result.body).toContain('$ARGUMENTS');
+    });
+  });
+
+  // ----------------------------------------------------------
+  // AC5: {AGENT_SCRIPT} expansion with platform-specific marker
+  // ----------------------------------------------------------
+  describe('AC5: AGENT_SCRIPT expansion', () => {
+    it('should expand {AGENT_SCRIPT} with shell script content', () => {
+      const ir = createTestIR({
+        frontmatter: {
+          name: 'test',
+          description: 'Test',
+          agent_scripts: {
+            sh: 'echo "Hello from __AGENT__"'
+          }
+        },
+        body: 'Execute: {AGENT_SCRIPT}',
+        placeholders: [
+          { type: 'AGENT_SCRIPT', raw: '{AGENT_SCRIPT}', position: { start: 9, end: 23 } }
+        ]
+      });
+
+      const result = transformer.transformForPlatform(ir, 'codex');
+      expect(result.body).not.toContain('{AGENT_SCRIPT}');
+      expect(result.body).toContain('echo "Hello from codex"');
+    });
+
+    it('should substitute __AGENT__ with platform name', () => {
+      const ir = createTestIR({
+        frontmatter: {
+          name: 'test',
+          description: 'Test',
+          agent_scripts: {
+            sh: 'agent=__AGENT__'
+          }
+        },
+        body: '{AGENT_SCRIPT}',
+        placeholders: [
+          { type: 'AGENT_SCRIPT', raw: '{AGENT_SCRIPT}', position: { start: 0, end: 14 } }
+        ]
+      });
+
+      expect(transformer.transformForPlatform(ir, 'codex').body).toContain('agent=codex');
+      expect(transformer.transformForPlatform(ir, 'cursor').body).toContain('agent=cursor');
+      expect(transformer.transformForPlatform(ir, 'qwen').body).toContain('agent=qwen');
+      expect(transformer.transformForPlatform(ir, 'antigravity').body).toContain('agent=antigravity');
+    });
+  });
+
+  // ----------------------------------------------------------
+  // transformForPlatform() tests
+  // ----------------------------------------------------------
+  describe('transformForPlatform()', () => {
+    it('should return transformed content with frontmatter', () => {
+      const ir = createTestIR({ body: 'Simple body', placeholders: [] });
+      const result = transformer.transformForPlatform(ir, 'codex');
+      expect(result).toHaveProperty('body');
+      expect(result).toHaveProperty('frontmatter');
+    });
+
+    it('should preserve frontmatter in result', () => {
+      const ir = createTestIR({ body: 'Test', placeholders: [] });
+      const result = transformer.transformForPlatform(ir, 'codex');
+      expect(result.frontmatter.name).toBe('flow-test');
+      expect(result.frontmatter.description).toBe('Test command');
+    });
+
+    it('should handle all four platforms', () => {
+      const platforms = ['codex', 'cursor', 'qwen', 'antigravity'];
+      const ir = createTestIR({ body: 'Test $ARGUMENTS', placeholders: [
+        { type: 'ARGUMENTS', raw: '$ARGUMENTS', position: { start: 5, end: 15 } }
+      ]});
+
+      platforms.forEach(platform => {
+        expect(() => transformer.transformForPlatform(ir, platform)).not.toThrow();
+      });
+    });
+  });
+
+  // ----------------------------------------------------------
+  // expandScriptPlaceholders() tests
+  // ----------------------------------------------------------
+  describe('expandScriptPlaceholders()', () => {
+    it('should expand {SCRIPT:alias} to bash path', () => {
+      const scripts = { prereq: '.claude/scripts/prereq.sh' };
+      const result = transformer.expandScriptPlaceholders('Run {SCRIPT:prereq}', scripts);
+      expect(result).toBe('Run bash .claude/scripts/prereq.sh');
+    });
+
+    it('should handle multiple placeholders', () => {
+      const scripts = { a: 'path/a.sh', b: 'path/b.sh' };
+      const result = transformer.expandScriptPlaceholders('{SCRIPT:a} then {SCRIPT:b}', scripts);
+      expect(result).toBe('bash path/a.sh then bash path/b.sh');
+    });
+
+    it('should handle content without placeholders', () => {
+      const result = transformer.expandScriptPlaceholders('No placeholders here', {});
+      expect(result).toBe('No placeholders here');
+    });
+  });
+
+  // ----------------------------------------------------------
+  // expandAgentScript() tests
+  // ----------------------------------------------------------
+  describe('expandAgentScript()', () => {
+    it('should expand {AGENT_SCRIPT} with sh content', () => {
+      const agentScripts = { sh: 'echo "test"' };
+      const result = transformer.expandAgentScript('Run: {AGENT_SCRIPT}', agentScripts, 'codex');
+      expect(result).toContain('echo "test"');
+      expect(result).not.toContain('{AGENT_SCRIPT}');
+    });
+
+    it('should replace __AGENT__ marker', () => {
+      const agentScripts = { sh: 'platform=__AGENT__' };
+      const result = transformer.expandAgentScript('{AGENT_SCRIPT}', agentScripts, 'qwen');
+      expect(result).toContain('platform=qwen');
+    });
+
+    it('should handle missing agent_scripts gracefully', () => {
+      const result = transformer.expandAgentScript('{AGENT_SCRIPT}', undefined, 'codex');
+      expect(result).toBe('{AGENT_SCRIPT}');
+    });
+  });
+
+  // ----------------------------------------------------------
+  // mapArguments() tests
+  // ----------------------------------------------------------
+  describe('mapArguments()', () => {
+    it('should keep $ARGUMENTS for codex', () => {
+      const result = transformer.mapArguments('Input: $ARGUMENTS', 'codex');
+      expect(result).toBe('Input: $ARGUMENTS');
+    });
+
+    it('should keep $ARGUMENTS for cursor', () => {
+      const result = transformer.mapArguments('Input: $ARGUMENTS', 'cursor');
+      expect(result).toBe('Input: $ARGUMENTS');
+    });
+
+    it('should map to {{args}} for qwen', () => {
+      const result = transformer.mapArguments('Input: $ARGUMENTS', 'qwen');
+      expect(result).toBe('Input: {{args}}');
+    });
+
+    it('should map to [arguments] for antigravity', () => {
+      const result = transformer.mapArguments('Input: $ARGUMENTS', 'antigravity');
+      expect(result).toBe('Input: [arguments]');
+    });
+
+    it('should handle multiple $ARGUMENTS occurrences', () => {
+      const result = transformer.mapArguments('$ARGUMENTS and $ARGUMENTS again', 'qwen');
+      expect(result).toBe('{{args}} and {{args}} again');
+    });
+  });
+});

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

@@ -0,0 +1,171 @@
+/**
+ * T035: AntigravityEmitter - Antigravity 平台输出
+ *
+ * 输出格式: Markdown + YAML frontmatter
+ * 目录: .agent/workflows/
+ * 限制: 单文件 <= 12,000 字符
+ * 超限时自动拆分
+ */
+const yaml = require('js-yaml');
+const BaseEmitter = require('./base-emitter.js');
+
+const CONTENT_LIMIT = 12000;
+const DESCRIPTION_LIMIT = 250;
+
+class AntigravityEmitter extends BaseEmitter {
+  static CONTENT_LIMIT = CONTENT_LIMIT;
+
+  get name() {
+    return 'antigravity';
+  }
+
+  get outputDir() {
+    return '.agent/workflows';
+  }
+
+  get fileExtension() {
+    return '.md';
+  }
+
+  get contentLimit() {
+    return CONTENT_LIMIT;
+  }
+
+  /**
+   * 格式化为 Antigravity 格式
+   * - YAML frontmatter: description (max 250 chars)
+   * - Markdown body
+   * - 超过 12K 时返回拆分数组
+   */
+  format(ir, transformedContent) {
+    // 截断 description 到 250 字符
+    const description = ir.frontmatter.description.substring(0, DESCRIPTION_LIMIT);
+
+    const frontmatterData = { description };
+    const yamlStr = yaml.dump(frontmatterData, {
+      lineWidth: -1,
+      quotingType: '"',
+      forceQuotes: false
+    });
+
+    const content = `---\n${yamlStr}---\n\n${transformedContent}`;
+
+    // 检查是否超过限制
+    if (content.length > CONTENT_LIMIT) {
+      return this.splitContent(ir, content);
+    }
+
+    return content;
+  }
+
+  /**
+   * 拆分超长内容为多个文件
+   * 策略: 按章节（# 或 ## 标题）拆分，超大章节再硬拆分
+   * 所有拆分文件都带完整 frontmatter (description)
+   */
+  splitContent(ir, content) {
+    const filename = ir.source.filename;
+    const description = ir.frontmatter.description.substring(0, DESCRIPTION_LIMIT);
+
+    // 计算 frontmatter 固定开销
+    const fmOverhead = this.createFrontmatter(description, 1, 1).length;
+    const maxBodySize = CONTENT_LIMIT - fmOverhead - 50; // 留 50 字符余量
+
+    // 移除原有 frontmatter，只处理 body
+    const bodyOnly = content.replace(/^---[\s\S]*?---\n*/m, '');
+
+    // 按 # 或 ## 标题拆分章节
+    const sections = bodyOnly.split(/(?=^#{1,2}\s)/m).filter(s => s.trim());
+
+    // 如果没有章节标题，直接硬拆分
+    if (sections.length <= 1) {
+      return this.hardSplit(bodyOnly, filename, description, maxBodySize);
+    }
+
+    // 预处理：将超大章节先硬拆分
+    const normalizedSections = [];
+    for (const section of sections) {
+      if (section.length > maxBodySize) {
+        // 超大章节需要硬拆分
+        const subParts = this.splitLargeSection(section, maxBodySize);
+        normalizedSections.push(...subParts);
+      } else {
+        normalizedSections.push(section);
+      }
+    }
+
+    // 贪心合并：尽量把多个小章节合并到一个文件
+    const mergedParts = [];
+    let currentPart = '';
+
+    for (const section of normalizedSections) {
+      const testContent = currentPart + section;
+      if (testContent.length > maxBodySize && currentPart) {
+        // 当前 part 已满，保存并开始新 part
+        mergedParts.push(currentPart);
+        currentPart = section;
+      } else {
+        currentPart = testContent;
+      }
+    }
+
+    // 保存最后一个 part
+    if (currentPart) {
+      mergedParts.push(currentPart);
+    }
+
+    // 生成最终文件列表，带序号 frontmatter
+    const totalParts = mergedParts.length;
+    return mergedParts.map((body, index) => ({
+      filename: totalParts === 1 ? filename : `${filename}-part${index + 1}`,
+      content: this.createFrontmatter(description, index + 1, totalParts) + body
+    }));
+  }
+
+  /**
+   * 创建带分页信息的 frontmatter
+   */
+  createFrontmatter(description, partNum, totalParts) {
+    let desc = description;
+    if (totalParts > 1) {
+      desc = `${description} (Part ${partNum}/${totalParts})`;
+    }
+    const fm = { description: desc };
+    // lineWidth: -1 强制单行输出，避免 >- 多行格式
+    return `---\n${yaml.dump(fm, { lineWidth: -1 })}---\n\n`;
+  }
+
+  /**
+   * 拆分超大章节
+   * 策略：直接按 maxSize 硬拆分，不尝试保持段落完整性
+   * （因为按段落拆分会导致标题和内容分离等问题）
+   */
+  splitLargeSection(section, maxSize) {
+    const parts = [];
+
+    for (let i = 0; i < section.length; i += maxSize) {
+      parts.push(section.substring(i, i + maxSize));
+    }
+
+    return parts;
+  }
+
+  /**
+   * 纯硬拆分（无章节标题时的后备方案）
+   */
+  hardSplit(content, filename, description, maxBodySize) {
+    const parts = [];
+
+    for (let i = 0; i < content.length; i += maxBodySize) {
+      parts.push(content.substring(i, i + maxBodySize));
+    }
+
+    const totalParts = parts.length;
+    return parts.map((body, index) => ({
+      filename: totalParts === 1 ? filename : `${filename}-part${index + 1}`,
+      content: this.createFrontmatter(description, index + 1, totalParts) + body
+    }));
+  }
+}
+
+module.exports = AntigravityEmitter;

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

@@ -0,0 +1,73 @@
+/**
+ * T031: BaseEmitter - Emitter 基类
+ *
+ * 定义 Emitter 接口:
+ * - name: 平台名称
+ * - outputDir: 输出目录
+ * - fileExtension: 文件扩展名
+ * - format(ir, transformedContent): 格式化输出
+ * - emit(filename, content): 写入文件
+ */
+const fs = require('fs');
+const path = require('path');
+const crypto = require('crypto');
+
+// ============================================================
+// SECURITY CONFIGURATION (FINDING-003)
+// ============================================================
+const MAX_OUTPUT_SIZE = 2 * 1024 * 1024; // 2MB limit
+
+class BaseEmitter {
+  // ----------------------------------------------------------
+  // Abstract properties - 子类必须覆盖
+  // ----------------------------------------------------------
+  get name() {
+    throw new Error('Not implemented');
+  }
+
+  get outputDir() {
+    throw new Error('Not implemented');
+  }
+
+  get fileExtension() {
+    throw new Error('Not implemented');
+  }
+
+  // ----------------------------------------------------------
+  // format() - 子类必须实现
+  // ----------------------------------------------------------
+  format(ir, transformedContent) {
+    throw new Error('Not implemented');
+  }
+
+  // ----------------------------------------------------------
+  // emit() - 写入文件到输出目录
+  // ----------------------------------------------------------
+  async emit(filename, content) {
+    // ✅ SECURITY FIX (FINDING-003): Check output size
+    if (content.length > MAX_OUTPUT_SIZE) {
+      throw new Error(`Output too large: ${filename} (${content.length} bytes > ${MAX_OUTPUT_SIZE} bytes)`);
+    }
+
+    const outputDir = this.outputDir;
+    const ext = this.fileExtension;
+    const filePath = path.join(outputDir, `${filename}${ext}`);
+
+    // ✅ SECURITY FIX (FINDING-005): Set explicit directory permissions
+    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 });
+
+    // 计算哈希
+    const hash = crypto.createHash('sha256').update(content).digest('hex');
+
+    return {
+      path: filePath,
+      hash,
+      timestamp: new Date().toISOString()
+    };
+  }
+}
+
+module.exports = BaseEmitter;

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

@@ -0,0 +1,52 @@
+/**
+ * T032: CodexEmitter - Codex 平台输出
+ *
+ * 输出格式: Markdown + YAML frontmatter
+ * 目录: .codex/prompts/
+ * Frontmatter 字段: description, argument-hint
+ */
+const yaml = require('js-yaml');
+const BaseEmitter = require('./base-emitter.js');
+
+class CodexEmitter extends BaseEmitter {
+  get name() {
+    return 'codex';
+  }
+
+  get outputDir() {
+    return '.codex/prompts';
+  }
+
+  get fileExtension() {
+    return '.md';
+  }
+
+  /**
+   * 格式化为 Codex 格式
+   * - YAML frontmatter: description, argument-hint
+   * - Markdown body
+   */
+  format(ir, transformedContent) {
+    const frontmatterData = {
+      description: ir.frontmatter.description
+    };
+
+    // 添加 argument-hint（如有 scripts）
+    if (ir.frontmatter.scripts) {
+      const aliases = Object.keys(ir.frontmatter.scripts);
+      if (aliases.length > 0) {
+        frontmatterData['argument-hint'] = aliases.join(', ');
+      }
+    }
+
+    const yamlStr = yaml.dump(frontmatterData, {
+      lineWidth: -1,
+      quotingType: '"',
+      forceQuotes: false
+    });
+
+    return `---\n${yamlStr}---\n\n${transformedContent}`;
+  }
+}
+
+module.exports = CodexEmitter;

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

@@ -0,0 +1,31 @@
+/**
+ * T033: CursorEmitter - Cursor 平台输出
+ *
+ * 输出格式: 纯 Markdown (无 frontmatter)
+ * 目录: .cursor/commands/
+ */
+const BaseEmitter = require('./base-emitter.js');
+
+class CursorEmitter extends BaseEmitter {
+  get name() {
+    return 'cursor';
+  }
+
+  get outputDir() {
+    return '.cursor/commands';
+  }
+
+  get fileExtension() {
+    return '.md';
+  }
+
+  /**
+   * 格式化为 Cursor 格式
+   * - 纯 Markdown，无 frontmatter
+   */
+  format(ir, transformedContent) {
+    return transformedContent;
+  }
+}
+
+module.exports = CursorEmitter;

package/lib/compiler/emitters/index.js

@@ -0,0 +1,50 @@
+/**
+ * T036: Emitter Index
+ *
+ * 导出所有 Emitter 类
+ * 提供 getEmitter(platform) 工厂函数
+ */
+const BaseEmitter = require('./base-emitter.js');
+const CodexEmitter = require('./codex-emitter.js');
+const CursorEmitter = require('./cursor-emitter.js');
+const QwenEmitter = require('./qwen-emitter.js');
+const AntigravityEmitter = require('./antigravity-emitter.js');
+
+// ============================================================
+// Emitter Registry
+// ============================================================
+const EMITTERS = {
+  codex: CodexEmitter,
+  cursor: CursorEmitter,
+  qwen: QwenEmitter,
+  antigravity: AntigravityEmitter
+};
+
+// ============================================================
+// getEmitter - 工厂函数
+// ============================================================
+function getEmitter(platform) {
+  const EmitterClass = EMITTERS[platform];
+  if (!EmitterClass) {
+    throw new Error(`Unknown platform: ${platform}`);
+  }
+  return new EmitterClass();
+}
+
+// ============================================================
+// getAllEmitters - 获取所有平台 Emitter 实例
+// ============================================================
+function getAllEmitters() {
+  return Object.keys(EMITTERS).map(platform => getEmitter(platform));
+}
+
+module.exports = {
+  BaseEmitter,
+  CodexEmitter,
+  CursorEmitter,
+  QwenEmitter,
+  AntigravityEmitter,
+  getEmitter,
+  getAllEmitters,
+  PLATFORMS: Object.keys(EMITTERS)
+};