cc-devflow 4.3.0 → 4.5.0

package/lib/compiler/context-expander.js

@@ -1,179 +0,0 @@
-/**
- * Context Expander - context.jsonl 编译时展开
- *
- * [INPUT]: context.jsonl 文件内容, 目标平台
- * [OUTPUT]: 展开后的上下文引用字符串
- * [POS]: 编译器核心模块，将 context.jsonl 转换为平台特定格式
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- *
- * 功能:
- * - 解析 JSONL 格式的上下文定义
- * - 根据平台生成不同格式的上下文引用
- * - Cursor 使用 @file 引用
- * - 其他平台生成 "Required Context" 章节
- */
-const fs = require('fs');
-const path = require('path');
-
-// ============================================================
-// ContextExpander - 上下文展开器
-// ============================================================
-class ContextExpander {
-  /**
-   * 解析 context.jsonl 文件
-   * @param {string} jsonlPath - context.jsonl 文件路径
-   * @returns {Array<Object>} 上下文条目数组
-   */
-  static parseContextFile(jsonlPath) {
-    if (!fs.existsSync(jsonlPath)) {
-      return [];
-    }
-
-    const content = fs.readFileSync(jsonlPath, 'utf8');
-    return ContextExpander.parseJsonl(content);
-  }
-
-  /**
-   * 解析 JSONL 字符串
-   * @param {string} jsonlContent - JSONL 内容
-   * @returns {Array<Object>} 上下文条目数组
-   */
-  static parseJsonl(jsonlContent) {
-    if (!jsonlContent || !jsonlContent.trim()) {
-      return [];
-    }
-
-    const lines = jsonlContent.split('\n').filter(line => line.trim());
-    const contexts = [];
-
-    for (const line of lines) {
-      try {
-        const entry = JSON.parse(line);
-        if (entry.file) {
-          contexts.push({
-            file: entry.file,
-            reason: entry.reason || '',
-            optional: entry.optional || false
-          });
-        }
-      } catch (e) {
-        // 跳过无效行
-        console.warn(`Warning: Invalid JSONL line: ${line}`);
-      }
-    }
-
-    return contexts;
-  }
-
-  /**
-   * 展开上下文为平台特定格式
-   * @param {Array<Object>} contexts - 上下文条目数组
-   * @param {string} platform - 目标平台
-   * @returns {string} 展开后的字符串
-   */
-  static expand(contexts, platform) {
-    if (!contexts || contexts.length === 0) {
-      return '';
-    }
-
-    switch (platform) {
-      case 'cursor':
-        return ContextExpander.expandForCursor(contexts);
-      case 'codex':
-        return ContextExpander.expandForCodex(contexts);
-      case 'qwen':
-        return ContextExpander.expandForQwen(contexts);
-      case 'antigravity':
-        return ContextExpander.expandForAntigravity(contexts);
-      default:
-        return ContextExpander.expandDefault(contexts);
-    }
-  }
-
-  /**
-   * Cursor 格式: 使用 @file 引用
-   */
-  static expandForCursor(contexts) {
-    const lines = contexts.map(c => {
-      const optional = c.optional ? ' (optional)' : '';
-      return `@${c.file}${optional}`;
-    });
-
-    return `\n## Context Files\n\n${lines.join('\n')}\n`;
-  }
-
-  /**
-   * Codex 格式: 生成 Required Context 章节
-   */
-  static expandForCodex(contexts) {
-    return ContextExpander.expandDefault(contexts);
-  }
-
-  /**
-   * Qwen 格式: 生成 Required Context 章节
-   */
-  static expandForQwen(contexts) {
-    return ContextExpander.expandDefault(contexts);
-  }
-
-  /**
-   * Antigravity 格式: 生成 Required Context 章节
-   */
-  static expandForAntigravity(contexts) {
-    return ContextExpander.expandDefault(contexts);
-  }
-
-  /**
-   * 默认格式: 生成 Required Context 章节
-   */
-  static expandDefault(contexts) {
-    const lines = contexts.map(c => {
-      const optional = c.optional ? ' (optional)' : '';
-      return `- \`${c.file}\` - ${c.reason}${optional}`;
-    });
-
-    return `
-## Required Context
-
-Before executing this skill, read the following files:
-${lines.join('\n')}
-`;
-  }
-
-  /**
-   * 从 SKILL.md 所在目录读取并展开 context.jsonl
-   * @param {string} skillDir - SKILL.md 所在目录
-   * @param {string} platform - 目标平台
-   * @returns {string} 展开后的字符串
-   */
-  static expandFromSkillDir(skillDir, platform) {
-    const contextPath = path.join(skillDir, 'context.jsonl');
-    const contexts = ContextExpander.parseContextFile(contextPath);
-    return ContextExpander.expand(contexts, platform);
-  }
-
-  /**
-   * 替换 SKILL.md 中的 {CONTEXT} 占位符
-   * @param {string} content - SKILL.md 内容
-   * @param {string} skillDir - SKILL.md 所在目录
-   * @param {string} platform - 目标平台
-   * @returns {string} 替换后的内容
-   */
-  static replaceContextPlaceholder(content, skillDir, platform) {
-    const contextExpanded = ContextExpander.expandFromSkillDir(skillDir, platform);
-
-    // 替换 {CONTEXT} 占位符
-    if (content.includes('{CONTEXT}')) {
-      return content.replace('{CONTEXT}', contextExpanded);
-    }
-
-    // 如果没有占位符但有 context.jsonl，追加到末尾
-    if (contextExpanded) {
-      return content + '\n' + contextExpanded;
-    }
-
-    return content;
-  }
-}
-
-module.exports = { ContextExpander };

package/lib/compiler/rules-emitters/__tests__/codex-rules-emitter.test.js

@@ -1,109 +0,0 @@
-/**
- * T006: Codex Rules Emitter Tests
- *
- * 测试 CodexRulesEmitter SKILL.md 格式输出:
- * 1. 输出包含 YAML frontmatter (name, description, type)
- * 2. 输出路径为 .codex/skills/cc-devflow/SKILL.md
- * 3. Skills 和 Commands 部分存在
- *
- * Reference: contracts/cli-spec.yaml#codex
- */
-
-const matter = require('gray-matter');
-
-describe('CodexRulesEmitter', () => {
-  describe('format()', () => {
-    test('should output YAML frontmatter with name, description, type', async () => {
-      const { CodexRulesEmitter } = require('../../rules-emitters/codex-rules-emitter');
-
-      const emitter = new CodexRulesEmitter();
-      const registry = {
-        version: '1.0',
-        skills: [
-          { name: 'test-skill', description: 'Test', type: 'domain' }
-        ]
-      };
-
-      const content = emitter.format(registry, []);
-
-      // 解析 frontmatter
-      const parsed = matter(content);
-
-      // 验证必需的 frontmatter 字段
-      expect(parsed.data).toHaveProperty('name');
-      expect(parsed.data).toHaveProperty('description');
-      expect(parsed.data).toHaveProperty('type');
-
-      expect(parsed.data.name).toBe('cc-devflow');
-      expect(parsed.data.type).toBe('domain');
-    });
-
-    test('should include Skills section', async () => {
-      const { CodexRulesEmitter } = require('../../rules-emitters/codex-rules-emitter');
-
-      const emitter = new CodexRulesEmitter();
-      const registry = {
-        version: '1.0',
-        skills: [
-          { name: 'cc-devflow-orchestrator', description: 'Router', type: 'domain', enforcement: 'suggest' },
-          { name: 'devflow-tdd-enforcer', description: 'TDD', type: 'guardrail', enforcement: 'block' }
-        ]
-      };
-
-      const content = emitter.format(registry, []);
-      const parsed = matter(content);
-
-      // 验证 Skills 部分
-      expect(parsed.content).toMatch(/## Skills/i);
-      expect(parsed.content).toContain('cc-devflow-orchestrator');
-      expect(parsed.content).toContain('devflow-tdd-enforcer');
-
-      // 验证包含 Triggers 和 Enforcement 信息
-      expect(parsed.content).toMatch(/Triggers|Enforcement/i);
-    });
-
-    test('should include Commands section', async () => {
-      const { CodexRulesEmitter } = require('../../rules-emitters/codex-rules-emitter');
-
-      const emitter = new CodexRulesEmitter();
-      const commands = [
-        { name: 'flow-init', description: 'Initialize' },
-        { name: 'flow-prd', description: 'Generate PRD' }
-      ];
-
-      const content = emitter.format({ skills: [] }, commands);
-      const parsed = matter(content);
-
-      // 验证 Commands 部分
-      expect(parsed.content).toMatch(/## Commands/i);
-      expect(parsed.content).toContain('flow-init');
-      expect(parsed.content).toContain('flow-prd');
-    });
-  });
-
-  describe('emit()', () => {
-    test('should output to .codex/skills/cc-devflow/SKILL.md', async () => {
-      const { CodexRulesEmitter } = require('../../rules-emitters/codex-rules-emitter');
-
-      const emitter = new CodexRulesEmitter();
-
-      expect(emitter.outputPath).toBe('.codex/skills/cc-devflow/SKILL.md');
-    });
-
-    test('should write file with correct content', async () => {
-      const { CodexRulesEmitter } = require('../../rules-emitters/codex-rules-emitter');
-
-      const emitter = new CodexRulesEmitter();
-      const registry = { version: '1.0', skills: [] };
-
-      const result = await emitter.emit(registry, []);
-
-      expect(result).toHaveProperty('path');
-      expect(result).toHaveProperty('hash');
-      expect(result).toHaveProperty('timestamp');
-
-      expect(result.path).toBe('.codex/skills/cc-devflow/SKILL.md');
-      expect(result.hash).toMatch(/^[a-f0-9]{64}$/);
-    });
-  });
-});

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

@@ -1,116 +0,0 @@
-/**
- * CodexRulesEmitter - Codex 规则入口文件生成
- *
- * 输出格式: SKILL.md (Markdown with YAML frontmatter)
- * 输出路径: .codex/skills/cc-devflow/SKILL.md
- *
- * Reference: REQ-006/TECH_DESIGN.md#CodexSKILL
- */
-const BaseRulesEmitter = require('./base-rules-emitter');
-
-class CodexRulesEmitter extends BaseRulesEmitter {
-  // ----------------------------------------------------------
-  // Platform properties
-  // ----------------------------------------------------------
-  get platform() {
-    return 'codex';
-  }
-
-  get outputPath() {
-    return '.codex/skills/cc-devflow/SKILL.md';
-  }
-
-  // ----------------------------------------------------------
-  // format() - 生成 SKILL.md 格式内容
-  // ----------------------------------------------------------
-  format(registry, commands) {
-    const frontmatter = this.buildFrontmatter(registry);
-    const body = this.buildBody(registry, commands);
-
-    return `---
-${frontmatter}---
-
-${body}`;
-  }
-
-  // ----------------------------------------------------------
-  // buildFrontmatter() - 构建 YAML frontmatter
-  // ----------------------------------------------------------
-  buildFrontmatter(_registry) {
-    const lines = [
-      `name: cc-devflow`,
-      `description: CC-DevFlow development workflow system`,
-      `type: domain`
-    ];
-
-    return lines.join('\n') + '\n';
-  }
-
-  // ----------------------------------------------------------
-  // buildBody() - 构建 Markdown 正文
-  // ----------------------------------------------------------
-  buildBody(registry, commands) {
-    const sections = [];
-
-    // 标题
-    sections.push('# cc-devflow');
-    sections.push('');
-    sections.push('CC-DevFlow development workflow system for structured requirement management.');
-    sections.push('');
-
-    // 技能章节
-    sections.push('## Skills');
-    sections.push('');
-
-    if (registry && registry.skills && registry.skills.length > 0) {
-      sections.push('| Name | Description | Type | Enforcement | Priority |');
-      sections.push('|------|-------------|------|-------------|----------|');
-
-      for (const skill of registry.skills) {
-        sections.push(
-          `| ${skill.name} | ${skill.description || '-'} | ${skill.type} | ${skill.enforcement || 'suggest'} | ${skill.priority || 'medium'} |`
-        );
-      }
-      sections.push('');
-    } else {
-      sections.push('No skills registered.');
-      sections.push('');
-    }
-
-    // 命令章节
-    sections.push('## Commands');
-    sections.push('');
-
-    if (commands && commands.length > 0) {
-      sections.push('| Command | Description |');
-      sections.push('|---------|-------------|');
-
-      for (const cmd of commands) {
-        sections.push(`| /${cmd.name} | ${cmd.description || '-'} |`);
-      }
-      sections.push('');
-    } else {
-      sections.push('No commands available.');
-      sections.push('');
-    }
-
-    // 使用说明
-    sections.push('## Usage');
-    sections.push('');
-    sections.push('```bash');
-    sections.push('# Start a new requirement');
-    sections.push('/flow-init "REQ-XXX|Title|URL"');
-    sections.push('');
-    sections.push('# Generate PRD');
-    sections.push('/flow-prd "REQ-XXX"');
-    sections.push('');
-    sections.push('# Run development workflow');
-    sections.push('/flow-dev "REQ-XXX"');
-    sections.push('```');
-    sections.push('');
-
-    return sections.join('\n');
-  }
-}
-
-module.exports = { CodexRulesEmitter };

package/lib/compiler/skill-discovery.js

@@ -1,68 +0,0 @@
-/**
- * T041: Skill Discovery Utility
- *
- * [INPUT]: .claude/skills/ 目录
- * [OUTPUT]: SkillEntry[] (name, skillDir, skillMdPath)
- * [POS]: Skills 扫描工具，统一发现分组与非分组 Skill
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- *
- * 规则:
- * - 递归扫描所有子目录
- * - 目录内存在 SKILL.md 即判定为 Skill
- * - 跳过以下划线开头的目录（例如 _reference-implementations）
- * - 扫描结果按 skillMdPath 排序，保证输出稳定
- */
-
-const fs = require('fs');
-const path = require('path');
-
-// ============================================================
-// discoverSkillEntries - 递归扫描 Skill 目录
-// ============================================================
-function discoverSkillEntries(skillsDir) {
-  const absoluteDir = path.resolve(skillsDir);
-
-  if (!fs.existsSync(absoluteDir)) {
-    return [];
-  }
-
-  const entries = [];
-  walkSkillDirs(absoluteDir, entries);
-
-  // 保证输出稳定，避免不同文件系统顺序差异
-  entries.sort((a, b) => a.skillMdPath.localeCompare(b.skillMdPath));
-  return entries;
-}
-
-// ============================================================
-// walkSkillDirs - 深度优先扫描
-// ============================================================
-function walkSkillDirs(dirPath, entries) {
-  const dirName = path.basename(dirPath);
-  if (dirName.startsWith('_')) {
-    return;
-  }
-
-  const skillMdPath = path.join(dirPath, 'SKILL.md');
-  if (fs.existsSync(skillMdPath)) {
-    entries.push({
-      name: dirName,
-      skillDir: dirPath,
-      skillMdPath
-    });
-    return;
-  }
-
-  const children = fs.readdirSync(dirPath, { withFileTypes: true });
-  for (const child of children) {
-    if (!child.isDirectory()) {
-      continue;
-    }
-
-    walkSkillDirs(path.join(dirPath, child.name), entries);
-  }
-}
-
-module.exports = {
-  discoverSkillEntries
-};

package/lib/harness/CLAUDE.md

@@ -1,22 +0,0 @@
-# harness/
-> L2 | 父级: /Users/dimon/001Area/80-CodeWorld/002-devflow/cc-devflow/CLAUDE.md
-
-成员清单
-index.js: 聚合导出 harness 基础模块，供 CLI 与测试统一引用。
-schemas.js: 定义 manifest/report/checkpoint/harness-state 的 Zod 契约，阻断脏数据进入执行层。
-store.js: 提供路径规范、JSON/文本读写、JSONL 事件记录与 shell 命令执行。
-planner.js: 将 TASKS.md 解析为 dependency-aware 的 task-manifest.json。
-query.js: 聚合分散状态文件，提供 getProgress/getNextTask/getFullState 查询函数。
-cli.js: 解析命令参数并分发到 operations 子模块。
-operations/init.js: 初始化 requirement 与 runtime 目录并写入 harness-state。
-operations/pack.js: 采集 git 与脚本事实，生成 context-package.md。
-operations/plan.js: 调用 planner 生成 task-manifest.json，更新 harness-state 为 planned。
-operations/dispatch.js: 依据依赖图与文件冲突并行执行任务，写 checkpoint 与 events，更新 harness-state 为 in_progress。
-operations/resume.js: 恢复中断任务并复用 dispatch 继续执行。
-operations/verify.js: 执行 quick/strict 质量门禁并输出 report-card.json，通过时更新 harness-state 为 verified。
-operations/release.js: 读取通过的 report-card，生成 RELEASE_NOTE 并标记 released。
-operations/janitor.js: 清理过期 runtime 工件，保留运行中任务状态。
-
-法则: 成员完整·一行一文件·父级链接·技术词前置
-
-[PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md

package/lib/harness/__tests__/planner.tdd.test.js

@@ -1,125 +0,0 @@
-/**
- * TDD Order Validation Tests
- *
- * Tests for Constitution Article VI enforcement in planner.js
- */
-
-const { parseTasksMarkdown } = require('../planner');
-
-describe('TDD Order Validation', () => {
-  describe('Valid TDD sequences', () => {
-    test('should accept TEST before IMPL with correct dependency', () => {
-      const markdown = `
-- [ ] T001 [TEST] 用户登录功能测试
-- [ ] T002 [IMPL] 用户登录功能实现 (dependsOn:T001)
-      `.trim();
-
-      expect(() => parseTasksMarkdown(markdown)).not.toThrow();
-    });
-
-    test('should accept multiple TEST-IMPL pairs', () => {
-      const markdown = `
-- [ ] T001 [TEST] 用户登录测试
-- [ ] T002 [IMPL] 用户登录实现 (dependsOn:T001)
-- [ ] T003 [TEST] 用户注册测试 [P]
-- [ ] T004 [IMPL] 用户注册实现 (dependsOn:T003)
-      `.trim();
-
-      expect(() => parseTasksMarkdown(markdown)).not.toThrow();
-    });
-
-    test('should accept tasks without TEST/IMPL markers', () => {
-      const markdown = `
-- [ ] T001 初始化项目结构
-- [ ] T002 配置开发环境
-      `.trim();
-
-      expect(() => parseTasksMarkdown(markdown)).not.toThrow();
-    });
-  });
-
-  describe('TDD violations', () => {
-    test('should reject IMPL without corresponding TEST', () => {
-      const markdown = `
-- [ ] T001 [IMPL] 用户登录功能实现
-      `.trim();
-
-      expect(() => parseTasksMarkdown(markdown)).toThrow(
-        /missing corresponding TEST task/
-      );
-    });
-
-    test('should reject IMPL not depending on TEST', () => {
-      const markdown = `
-- [ ] T001 [TEST] 用户登录功能测试
-- [ ] T002 [IMPL] 用户登录功能实现 [P]
-      `.trim();
-
-      expect(() => parseTasksMarkdown(markdown)).toThrow(
-        /must depend on T001/
-      );
-    });
-
-    test('should reject TEST depending on IMPL', () => {
-      const markdown = `
-- [ ] T001 [IMPL] 用户登录功能实现
-- [ ] T002 [TEST] 用户登录功能测试 (dependsOn:T001)
-      `.trim();
-
-      expect(() => parseTasksMarkdown(markdown)).toThrow(
-        /Tests must be written BEFORE implementation/
-      );
-    });
-
-    test('should reject IMPL depending on wrong TEST', () => {
-      const markdown = `
-- [ ] T001 [TEST] 用户注册测试
-- [ ] T002 [IMPL] 用户登录实现 (dependsOn:T001)
-      `.trim();
-
-      expect(() => parseTasksMarkdown(markdown)).toThrow(
-        /missing corresponding TEST task/
-      );
-    });
-  });
-
-  describe('Feature name extraction', () => {
-    test('should match TEST and IMPL with same feature name', () => {
-      const markdown = `
-- [ ] T001 [TEST] 实现用户认证功能
-- [ ] T002 [IMPL] 实现用户认证功能 (dependsOn:T001)
-      `.trim();
-
-      expect(() => parseTasksMarkdown(markdown)).not.toThrow();
-    });
-
-    test('should handle case-insensitive markers', () => {
-      const markdown = `
-- [ ] T001 [test] 用户登录
-- [ ] T002 [impl] 用户登录 (dependsOn:T001)
-      `.trim();
-
-      expect(() => parseTasksMarkdown(markdown)).not.toThrow();
-    });
-  });
-
-  describe('Error messages', () => {
-    test('should provide clear violation details', () => {
-      const markdown = `
-- [ ] T001 [IMPL] 功能A
-- [ ] T002 [TEST] 功能B
-- [ ] T003 [IMPL] 功能B
-      `.trim();
-
-      try {
-        parseTasksMarkdown(markdown);
-        fail('Should have thrown TDD violation error');
-      } catch (error) {
-        expect(error.message).toContain('TDD Order Validation Failed');
-        expect(error.message).toContain('Constitution Article VI');
-        expect(error.message).toContain('T001');
-        expect(error.message).toContain('missing corresponding TEST task');
-      }
-    });
-  });
-});