cc-devflow 4.3.0 → 4.5.0

package/lib/harness/operations/plan.js

@@ -1,83 +0,0 @@
-/**
- * [INPUT]: 依赖 planner.createTaskManifest，接收 changeId/goal/overwrite 参数。
- * [OUTPUT]: 生成并返回已校验的 task-manifest.json 摘要。
- * [POS]: harness Stage-3 计划生成入口，被 CLI `harness:plan` 调用。
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- */
-
-const { createTaskManifest } = require('../planner');
-const { getTaskManifestPath, getHarnessStatePath, exists, readText, readJson, writeJson } = require('../store');
-const path = require('path');
-const { execSync } = require('child_process');
-
-async function runPlan({ repoRoot, changeId, goal, overwrite }) {
-  // v4.3: 检查是否存在 proposal.md（新架构）
-  const reqDir = path.join(repoRoot, 'devflow', 'requirements', changeId);
-  const proposalPath = path.join(reqDir, 'proposal.md');
-  const hasProposal = await exists(proposalPath);
-
-  if (hasProposal) {
-    console.log(`[v4.3] Detected proposal.md, generating design.md and Delta specs...`);
-
-    // 注意：实际的 design.md 和 Delta specs 生成由 Claude Agent 在 /flow:spec 中完成
-    // 这里只是检测并提示，不执行生成逻辑
-    // 生成逻辑在 .claude/skills/flow-spec/SKILL.md 的 Execution Steps 中定义
-
-    const designPath = path.join(reqDir, 'design.md');
-    const specsDir = path.join(reqDir, 'specs');
-    const scopeReportPath = path.join(reqDir, 'scope-creep-report.md');
-
-    // 检查必需产物是否存在
-    const hasDesign = await exists(designPath);
-    const hasSpecs = await exists(specsDir);
-    const hasScopeReport = await exists(scopeReportPath);
-
-    if (!hasDesign) {
-      console.warn(`[v4.3] WARNING: design.md not found. Expected at ${designPath}`);
-    }
-
-    if (!hasSpecs) {
-      console.warn(`[v4.3] WARNING: specs/ directory not found. Expected at ${specsDir}`);
-    }
-
-    if (!hasScopeReport) {
-      console.warn(`[v4.3] WARNING: scope-creep-report.md not found. Run validate-scope.sh`);
-    }
-
-    // 如果存在 scope-creep-report.md，检查是否有阻塞性警告
-    if (hasScopeReport) {
-      const reportContent = await readText(scopeReportPath);
-      if (reportContent.includes('⚠️') && reportContent.includes('Potential scope creep')) {
-        console.warn(`[v4.3] WARNING: Scope creep detected. Review ${scopeReportPath}`);
-      }
-    }
-  }
-
-  const manifest = await createTaskManifest({
-    repoRoot,
-    changeId,
-    goal,
-    overwrite
-  });
-
-  // Update harness-state.json with plannedAt timestamp
-  const statePath = getHarnessStatePath(repoRoot, changeId);
-  if (await exists(statePath)) {
-    const state = await readJson(statePath);
-    state.status = 'planned';
-    state.plannedAt = new Date().toISOString();
-    state.updatedAt = new Date().toISOString();
-    await writeJson(statePath, state);
-  }
-
-  return {
-    changeId,
-    manifestPath: getTaskManifestPath(repoRoot, changeId),
-    taskCount: manifest.tasks.length,
-    source: manifest.metadata.source
-  };
-}
-
-module.exports = {
-  runPlan
-};

package/lib/harness/operations/release.js

@@ -1,170 +0,0 @@
-/**
- * [INPUT]: 依赖 report-card 与 task-manifest 的最终状态。
- * [OUTPUT]: 在 requirement 目录生成 RELEASE_NOTE.md，并更新 harness-state 为 released。
- * [POS]: harness 发布收尾入口，被 CLI `harness:release` 调用。
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- */
-
-const {
-  nowIso,
-  readJson,
-  writeText,
-  writeJson,
-  exists,
-  getReportCardPath,
-  getTaskManifestPath,
-  getReleaseNotePath,
-  getHarnessStatePath
-} = require('../store');
-const { parseReportCard, parseManifest } = require('../schemas');
-const path = require('path');
-const { execSync } = require('child_process');
-const fs = require('fs').promises;
-
-function formatReleaseNote({ changeId, manifest, report }) {
-  const passedTasks = manifest.tasks.filter((task) => task.status === 'passed');
-  const failedTasks = manifest.tasks.filter((task) => task.status === 'failed');
-
-  return [
-    `# Release Note - ${changeId}`,
-    '',
-    `- Released At: ${nowIso()}`,
-    `- Verification: ${report.overall.toUpperCase()}`,
-    '',
-    '## Task Summary',
-    '',
-    `- Passed: ${passedTasks.length}`,
-    `- Failed: ${failedTasks.length}`,
-    '',
-    '## Completed Tasks',
-    '',
-    ...(passedTasks.length > 0
-      ? passedTasks.map((task) => `- ${task.id}: ${task.title}`)
-      : ['- (none)']),
-    '',
-    '## Blocking Findings',
-    '',
-    ...(report.blockingFindings.length > 0
-      ? report.blockingFindings.map((item) => `- ${item}`)
-      : ['- None']),
-    ''
-  ].join('\n');
-}
-
-async function runRelease({ repoRoot, changeId }) {
-  const reportPath = getReportCardPath(repoRoot, changeId);
-  const manifestPath = getTaskManifestPath(repoRoot, changeId);
-  const statePath = getHarnessStatePath(repoRoot, changeId);
-
-  const report = parseReportCard(await readJson(reportPath));
-  const manifest = parseManifest(await readJson(manifestPath));
-
-  if (report.overall !== 'pass') {
-    throw new Error('Release blocked: report-card overall is not pass');
-  }
-
-  // v4.3: 合并 Delta specs 到项目级 specs/
-  const reqDir = path.join(repoRoot, 'devflow', 'requirements', changeId);
-  const deltaSpecsDir = path.join(reqDir, 'specs');
-  const projectSpecsDir = path.join(repoRoot, 'devflow', 'specs');
-  const hasDeltaSpecs = await exists(deltaSpecsDir);
-
-  if (hasDeltaSpecs) {
-    console.log(`[v4.3] Merging Delta specs to project-level specs/...`);
-
-    try {
-      // 遍历所有 Delta spec.md 文件
-      const modules = await fs.readdir(deltaSpecsDir);
-      const mergeResults = [];
-
-      for (const module of modules) {
-        const deltaSpecPath = path.join(deltaSpecsDir, module, 'spec.md');
-        const projectSpecPath = path.join(projectSpecsDir, module, 'spec.md');
-
-        if (!(await exists(deltaSpecPath))) {
-          console.warn(`[v4.3] WARNING: Delta spec not found: ${deltaSpecPath}`);
-          continue;
-        }
-
-        if (!(await exists(projectSpecPath))) {
-          console.warn(`[v4.3] WARNING: Project spec not found: ${projectSpecPath}`);
-          console.log(`[v4.3] Creating new project spec for module: ${module}`);
-
-          // 如果项目级 spec 不存在，创建目录并复制 Delta 作为初始版本
-          await fs.mkdir(path.dirname(projectSpecPath), { recursive: true });
-          await fs.copyFile(deltaSpecPath, projectSpecPath);
-
-          mergeResults.push({ module, status: 'created', newVersion: '1.0.0' });
-          continue;
-        }
-
-        // 调用 delta-parser.ts merge 命令
-        const deltaParserPath = path.join(repoRoot, '.claude', 'scripts', 'delta-parser.ts');
-
-        try {
-          const output = execSync(
-            `npx ts-node "${deltaParserPath}" merge "${projectSpecPath}" "${deltaSpecPath}"`,
-            { cwd: repoRoot, encoding: 'utf-8' }
-          );
-
-          // 解析输出获取新版本号
-          const versionMatch = output.match(/New version: ([\d.]+)/);
-          const newVersion = versionMatch ? versionMatch[1] : 'unknown';
-
-          mergeResults.push({ module, status: 'merged', newVersion });
-          console.log(`[v4.3] ✅ Merged ${module}: ${newVersion}`);
-        } catch (mergeError) {
-          console.error(`[v4.3] ❌ Failed to merge ${module}:`, mergeError.message);
-          mergeResults.push({ module, status: 'failed', error: mergeError.message });
-        }
-      }
-
-      // 记录合并结果到 RELEASE_NOTE
-      const mergeReport = mergeResults
-        .map(r => {
-          if (r.status === 'merged') {
-            return `- ✅ ${r.module}: merged to v${r.newVersion}`;
-          } else if (r.status === 'created') {
-            return `- 🆕 ${r.module}: created v${r.newVersion}`;
-          } else {
-            return `- ❌ ${r.module}: ${r.error}`;
-          }
-        })
-        .join('\n');
-
-      console.log(`[v4.3] Delta merge summary:\n${mergeReport}`);
-
-      // 将合并结果添加到 release note
-      manifest.metadata = manifest.metadata || {};
-      manifest.metadata.deltaMergeResults = mergeResults;
-
-    } catch (error) {
-      console.error(`[v4.3] ERROR during Delta merge:`, error);
-      throw new Error(`Delta merge failed: ${error.message}`);
-    }
-  } else {
-    console.log(`[v4.3] No Delta specs found, skipping merge.`);
-  }
-
-  const note = formatReleaseNote({ changeId, manifest, report });
-  const releaseNotePath = getReleaseNotePath(repoRoot, changeId);
-
-  await writeText(releaseNotePath, note);
-  await writeJson(statePath, {
-    changeId,
-    goal: manifest.goal,
-    status: 'released',
-    releasedAt: nowIso(),
-    updatedAt: nowIso()
-  });
-
-  return {
-    changeId,
-    releaseNotePath,
-    status: 'released'
-  };
-}
-
-module.exports = {
-  runRelease
-};

package/lib/harness/operations/resume.js

@@ -1,44 +0,0 @@
-/**
- * [INPUT]: 依赖 manifest 当前任务状态与 dispatch 执行器，接收 changeId/并行度/重试参数。
- * [OUTPUT]: 将 running 与可重试 failed 任务回置为 pending，并继续调度执行。
- * [POS]: harness 恢复执行入口，被 CLI `harness:resume` 调用。
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- */
-
-const { readJson, writeJson, getTaskManifestPath } = require('../store');
-const { parseManifest } = require('../schemas');
-const { runDispatch } = require('./dispatch');
-
-async function runResume({ repoRoot, changeId, parallel, maxRetries }) {
-  const manifestPath = getTaskManifestPath(repoRoot, changeId);
-  const manifest = parseManifest(await readJson(manifestPath));
-
-  for (const task of manifest.tasks) {
-    if (task.status === 'running') {
-      task.status = 'pending';
-      task.lastError = 'Resumed from interrupted running state';
-      continue;
-    }
-
-    if (task.status === 'failed') {
-      const retryLimit = Number.isInteger(maxRetries) ? maxRetries : task.maxRetries;
-      if (task.attempts <= retryLimit) {
-        task.status = 'pending';
-      }
-    }
-  }
-
-  await writeJson(manifestPath, manifest);
-
-  return runDispatch({
-    repoRoot,
-    changeId,
-    parallel,
-    maxRetries,
-    resume: true
-  });
-}
-
-module.exports = {
-  runResume
-};

package/lib/harness/operations/verify.js

@@ -1,177 +0,0 @@
-/**
- * [INPUT]: 依赖 manifest 与 package scripts，依赖 shell gates（lint/typecheck/test/audit/review）。
- * [OUTPUT]: 生成 report-card.json，给出 quick/strict/review 门禁结论。
- * [POS]: harness 质量门禁入口，被 CLI `harness:verify` 调用。
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- */
-
-const {
-  nowIso,
-  getPackageScripts,
-  readJson,
-  writeJson,
-  runCommand,
-  getTaskManifestPath,
-  getHarnessStatePath,
-  getReportCardPath
-} = require('../store');
-const { parseManifest, parseReportCard } = require('../schemas');
-
-async function runGate(command, cwd, timeoutMs = 20 * 60 * 1000) {
-  const result = await runCommand(command, { cwd, timeoutMs });
-  return {
-    status: result.code === 0 ? 'pass' : 'fail',
-    durationMs: result.durationMs,
-    details: result.code === 0
-      ? 'ok'
-      : (result.stderr || result.stdout || 'command failed').trim().slice(0, 400)
-  };
-}
-
-async function runNpmScriptGate(scripts, scriptName, repoRoot) {
-  if (!scripts[scriptName]) {
-    return {
-      name: scriptName,
-      command: `npm run ${scriptName}`,
-      status: 'skipped',
-      durationMs: 0,
-      details: `Script ${scriptName} is not defined`
-    };
-  }
-
-  const result = await runGate(`npm run ${scriptName}`, repoRoot);
-  return {
-    name: scriptName,
-    command: `npm run ${scriptName}`,
-    ...result
-  };
-}
-
-async function runReviewGate({ repoRoot, strict, skipReview }) {
-  if (!strict) {
-    return {
-      status: 'skipped',
-      details: 'Strict mode disabled'
-    };
-  }
-
-  if (skipReview) {
-    return {
-      status: 'skipped',
-      details: 'Skipped by --skip-review'
-    };
-  }
-
-  const hasCodex = await runCommand('command -v codex', { cwd: repoRoot });
-  if (hasCodex.code !== 0) {
-    return {
-      status: 'fail',
-      details: 'codex binary not found; rerun with --skip-review if intentional'
-    };
-  }
-
-  const review = await runCommand('codex review --base main', {
-    cwd: repoRoot,
-    timeoutMs: 30 * 60 * 1000
-  });
-
-  if (review.code !== 0) {
-    return {
-      status: 'fail',
-      details: (review.stderr || review.stdout || 'codex review failed').trim().slice(0, 400)
-    };
-  }
-
-  return {
-    status: 'pass',
-    details: 'codex review passed'
-  };
-}
-
-function collectBlockingFindings(manifest, quickGates, strictGates, reviewGate) {
-  const findings = [];
-
-  for (const task of manifest.tasks) {
-    if (task.status === 'failed') {
-      findings.push(`${task.id}: ${task.lastError || 'task failed'}`);
-    }
-  }
-
-  for (const gate of [...quickGates, ...strictGates]) {
-    if (gate.status === 'fail') {
-      findings.push(`${gate.name}: ${gate.details}`);
-    }
-  }
-
-  if (reviewGate.status === 'fail') {
-    findings.push(`review: ${reviewGate.details}`);
-  }
-
-  return findings;
-}
-
-async function runVerify({ repoRoot, changeId, strict = false, skipReview = false }) {
-  const manifestPath = getTaskManifestPath(repoRoot, changeId);
-  const manifest = parseManifest(await readJson(manifestPath));
-  const scripts = await getPackageScripts(repoRoot);
-
-  const quickGateNames = ['lint', 'typecheck', 'test'];
-  const quickGates = [];
-
-  for (const name of quickGateNames) {
-    quickGates.push(await runNpmScriptGate(scripts, name, repoRoot));
-  }
-
-  const strictGates = [];
-  if (strict) {
-    strictGates.push(await runNpmScriptGate(scripts, 'test:integration', repoRoot));
-
-    const audit = await runGate('npm audit --audit-level=high', repoRoot, 20 * 60 * 1000);
-    strictGates.push({
-      name: 'audit',
-      command: 'npm audit --audit-level=high',
-      ...audit
-    });
-  }
-
-  const review = await runReviewGate({ repoRoot, strict, skipReview });
-  const blockingFindings = collectBlockingFindings(manifest, quickGates, strictGates, review);
-  const hasFailures = blockingFindings.length > 0;
-
-  const report = parseReportCard({
-    changeId,
-    overall: hasFailures ? 'fail' : 'pass',
-    quickGates,
-    strictGates,
-    review,
-    blockingFindings,
-    timestamp: nowIso()
-  });
-
-  const outputPath = getReportCardPath(repoRoot, changeId);
-  await writeJson(outputPath, report);
-
-  // Update harness-state.json with verifiedAt timestamp if passed
-  if (!hasFailures) {
-    const statePath = getHarnessStatePath(repoRoot, changeId);
-    const stateExists = require('fs').existsSync(statePath);
-    if (stateExists) {
-      const state = await readJson(statePath);
-      state.status = 'verified';
-      state.verifiedAt = nowIso();
-      state.updatedAt = nowIso();
-      await writeJson(statePath, state);
-    }
-  }
-
-  return {
-    changeId,
-    outputPath,
-    overall: report.overall,
-    blockingFindings: report.blockingFindings
-  };
-}
-
-module.exports = {
-  runVerify
-};