cc-devflow 4.2.0 → 4.4.1

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

package/lib/harness/cli.js

@@ -1,208 +0,0 @@
-/**
- * [INPUT]: 依赖 operations 子模块与命令行参数。
- * [OUTPUT]: 对外提供 runCli(argv) 统一命令分发入口。
- * [POS]: harness 命令编排层，被 bin/harness.js 调用。
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- */
-
-const {
-  resolveRepoRoot,
-  ChangeIdSchema
-} = require('./index');
-const { runInit } = require('./operations/init');
-const { runPack } = require('./operations/pack');
-const { runPlan } = require('./operations/plan');
-const { runDispatch } = require('./operations/dispatch');
-const { runResume } = require('./operations/resume');
-const { runVerify } = require('./operations/verify');
-const { runRelease } = require('./operations/release');
-const { runJanitor } = require('./operations/janitor');
-
-function parseArgs(argv) {
-  const [command, ...rest] = argv;
-  const args = {
-    command,
-    changeId: null,
-    goal: null,
-    parallel: 3,
-    maxRetries: undefined,
-    strict: false,
-    skipReview: false,
-    overwrite: false,
-    hours: 72
-  };
-
-  for (let i = 0; i < rest.length; i += 1) {
-    const token = rest[i];
-
-    if (token === '--change-id') {
-      args.changeId = rest[i + 1];
-      i += 1;
-      continue;
-    }
-
-    if (token === '--goal') {
-      args.goal = rest[i + 1];
-      i += 1;
-      continue;
-    }
-
-    if (token === '--parallel') {
-      args.parallel = Number.parseInt(rest[i + 1], 10);
-      i += 1;
-      continue;
-    }
-
-    if (token === '--max-retries') {
-      args.maxRetries = Number.parseInt(rest[i + 1], 10);
-      i += 1;
-      continue;
-    }
-
-    if (token === '--hours') {
-      args.hours = Number.parseInt(rest[i + 1], 10);
-      i += 1;
-      continue;
-    }
-
-    if (token === '--strict') {
-      args.strict = true;
-      continue;
-    }
-
-    if (token === '--skip-review') {
-      args.skipReview = true;
-      continue;
-    }
-
-    if (token === '--overwrite') {
-      args.overwrite = true;
-      continue;
-    }
-  }
-
-  return args;
-}
-
-function showHelp() {
-  console.log(`
-Usage: node bin/harness.js <command> [options]
-
-Commands:
-  init      --change-id <REQ-ID> [--goal "..."]
-  pack      --change-id <REQ-ID> [--goal "..."]
-  plan      --change-id <REQ-ID> [--goal "..."] [--overwrite]
-  dispatch  --change-id <REQ-ID> [--parallel 3] [--max-retries 2]
-  resume    --change-id <REQ-ID> [--parallel 3] [--max-retries 2]
-  verify    --change-id <REQ-ID> [--strict] [--skip-review]
-  release   --change-id <REQ-ID>
-  janitor   [--hours 72]
-`);
-}
-
-function requireChangeId(changeId) {
-  const parsed = ChangeIdSchema.safeParse(changeId);
-  if (!parsed.success) {
-    throw new Error('Missing or invalid --change-id (expected REQ-123 or BUG-123)');
-  }
-  return parsed.data;
-}
-
-function printResult(result) {
-  console.log(JSON.stringify(result, null, 2));
-}
-
-async function runCli(argv) {
-  const args = parseArgs(argv);
-
-  if (!args.command || args.command === 'help' || args.command === '--help' || args.command === '-h') {
-    showHelp();
-    return 0;
-  }
-
-  const repoRoot = resolveRepoRoot(process.cwd());
-
-  switch (args.command) {
-    case 'init': {
-      const changeId = requireChangeId(args.changeId);
-      const result = await runInit({ repoRoot, changeId, goal: args.goal });
-      printResult(result);
-      return 0;
-    }
-
-    case 'pack': {
-      const changeId = requireChangeId(args.changeId);
-      const result = await runPack({ repoRoot, changeId, goal: args.goal });
-      printResult(result);
-      return 0;
-    }
-
-    case 'plan': {
-      const changeId = requireChangeId(args.changeId);
-      const result = await runPlan({
-        repoRoot,
-        changeId,
-        goal: args.goal,
-        overwrite: args.overwrite
-      });
-      printResult(result);
-      return 0;
-    }
-
-    case 'dispatch': {
-      const changeId = requireChangeId(args.changeId);
-      const result = await runDispatch({
-        repoRoot,
-        changeId,
-        parallel: args.parallel,
-        maxRetries: Number.isInteger(args.maxRetries) ? args.maxRetries : undefined
-      });
-      printResult(result);
-      return result.success ? 0 : 1;
-    }
-
-    case 'resume': {
-      const changeId = requireChangeId(args.changeId);
-      const result = await runResume({
-        repoRoot,
-        changeId,
-        parallel: args.parallel,
-        maxRetries: Number.isInteger(args.maxRetries) ? args.maxRetries : undefined
-      });
-      printResult(result);
-      return result.success ? 0 : 1;
-    }
-
-    case 'verify': {
-      const changeId = requireChangeId(args.changeId);
-      const result = await runVerify({
-        repoRoot,
-        changeId,
-        strict: args.strict,
-        skipReview: args.skipReview
-      });
-      printResult(result);
-      return result.overall === 'pass' ? 0 : 1;
-    }
-
-    case 'release': {
-      const changeId = requireChangeId(args.changeId);
-      const result = await runRelease({ repoRoot, changeId });
-      printResult(result);
-      return 0;
-    }
-
-    case 'janitor': {
-      const result = await runJanitor({ repoRoot, hours: args.hours });
-      printResult(result);
-      return 0;
-    }
-
-    default:
-      throw new Error(`Unknown harness command: ${args.command}`);
-  }
-}
-
-module.exports = {
-  runCli
-};