cc-devflow 4.2.0 → 4.4.1

package/lib/harness/index.js

@@ -1,16 +0,0 @@
-/**
- * [INPUT]: 依赖 harness 各模块。
- * [OUTPUT]: 统一导出 schema/store/planner 与 operations 入口。
- * [POS]: harness 模块聚合出口，被 bin 与测试代码使用。
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- */
-
-const store = require('./store');
-const schemas = require('./schemas');
-const planner = require('./planner');
-
-module.exports = {
-  ...store,
-  ...schemas,
-  ...planner
-};

package/lib/harness/operations/dispatch.js

@@ -1,285 +0,0 @@
-/**
- * [INPUT]: 依赖 manifest/checkpoint/events 与 shell 执行能力，接收并行度与重试参数。
- * [OUTPUT]: 更新 task-manifest 状态，写入每任务 events.jsonl 与 checkpoint.json。
- * [POS]: harness Stage-4 执行入口，被 CLI `harness:dispatch` 与 `harness:resume` 复用。
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- */
-
-const {
-  nowIso,
-  ensureDir,
-  appendJsonl,
-  writeJson,
-  readJson,
-  runCommand,
-  getTaskManifestPath,
-  getRuntimeTaskDir,
-  getEventsPath,
-  getCheckpointPath
-} = require('../store');
-const { parseManifest, parseCheckpoint } = require('../schemas');
-
-function toSessionId(taskId) {
-  return `${taskId}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
-}
-
-function dependenciesPassed(task, taskMap) {
-  return task.dependsOn.every((depId) => {
-    const dep = taskMap.get(depId);
-    return dep && dep.status === 'passed';
-  });
-}
-
-function dependenciesFailed(task, taskMap) {
-  return task.dependsOn.some((depId) => {
-    const dep = taskMap.get(depId);
-    return dep && (dep.status === 'failed' || dep.status === 'skipped');
-  });
-}
-
-function hasTouchConflict(task, lockedTouches) {
-  if (!task.touches || task.touches.length === 0) {
-    return false;
-  }
-
-  return task.touches.some((filePath) => lockedTouches.has(filePath));
-}
-
-function selectBatch(readyTasks, parallel) {
-  const selected = [];
-  const lockedTouches = new Set();
-
-  for (const task of readyTasks) {
-    if (selected.length >= parallel) {
-      break;
-    }
-
-    if (hasTouchConflict(task, lockedTouches)) {
-      continue;
-    }
-
-    selected.push(task);
-    for (const touched of task.touches) {
-      lockedTouches.add(touched);
-    }
-  }
-
-  return selected;
-}
-
-async function writeCheckpoint(repoRoot, changeId, taskId, payload) {
-  const checkpointPath = getCheckpointPath(repoRoot, changeId, taskId);
-  const checkpoint = parseCheckpoint(payload);
-  await writeJson(checkpointPath, checkpoint);
-}
-
-async function writeEvent(repoRoot, changeId, taskId, event) {
-  const eventsPath = getEventsPath(repoRoot, changeId, taskId);
-  await appendJsonl(eventsPath, event);
-}
-
-async function executeTask({ repoRoot, changeId, task, retryOverride }) {
-  const taskRuntimeDir = getRuntimeTaskDir(repoRoot, changeId, task.id);
-  await ensureDir(taskRuntimeDir);
-
-  const sessionId = toSessionId(task.id);
-  const commands = [...task.run, ...task.checks];
-  const taskRetry = Number.isInteger(retryOverride) ? retryOverride : task.maxRetries;
-  const maxAttempts = Math.max(1, taskRetry + 1);
-
-  while (task.attempts < maxAttempts) {
-    task.attempts += 1;
-    task.status = 'running';
-
-    await writeCheckpoint(repoRoot, changeId, task.id, {
-      changeId,
-      taskId: task.id,
-      sessionId,
-      status: task.status,
-      summary: `Task started (attempt ${task.attempts}/${maxAttempts})`,
-      timestamp: nowIso(),
-      attempt: task.attempts
-    });
-
-    await writeEvent(repoRoot, changeId, task.id, {
-      type: 'task_started',
-      changeId,
-      taskId: task.id,
-      sessionId,
-      attempt: task.attempts,
-      timestamp: nowIso()
-    });
-
-    let failed = false;
-    let failureMessage = '';
-
-    for (const command of commands) {
-      const result = await runCommand(command, {
-        cwd: repoRoot,
-        timeoutMs: 30 * 60 * 1000
-      });
-
-      await writeEvent(repoRoot, changeId, task.id, {
-        type: 'command_finished',
-        changeId,
-        taskId: task.id,
-        sessionId,
-        attempt: task.attempts,
-        command,
-        code: result.code,
-        durationMs: result.durationMs,
-        timestamp: nowIso()
-      });
-
-      if (result.code !== 0) {
-        failed = true;
-        failureMessage = (result.stderr || result.stdout || 'Command failed').trim();
-        break;
-      }
-    }
-
-    if (!failed) {
-      task.status = 'passed';
-      task.lastError = undefined;
-
-      await writeCheckpoint(repoRoot, changeId, task.id, {
-        changeId,
-        taskId: task.id,
-        sessionId,
-        status: task.status,
-        summary: `Task passed after ${task.attempts} attempt(s)`,
-        timestamp: nowIso(),
-        attempt: task.attempts
-      });
-
-      await writeEvent(repoRoot, changeId, task.id, {
-        type: 'task_passed',
-        changeId,
-        taskId: task.id,
-        sessionId,
-        attempts: task.attempts,
-        timestamp: nowIso()
-      });
-
-      return;
-    }
-
-    task.status = 'failed';
-    task.lastError = failureMessage;
-
-    await writeCheckpoint(repoRoot, changeId, task.id, {
-      changeId,
-      taskId: task.id,
-      sessionId,
-      status: task.status,
-      summary: `Task failed: ${failureMessage.slice(0, 240)}`,
-      timestamp: nowIso(),
-      attempt: task.attempts
-    });
-
-    await writeEvent(repoRoot, changeId, task.id, {
-      type: 'task_failed',
-      changeId,
-      taskId: task.id,
-      sessionId,
-      attempt: task.attempts,
-      error: failureMessage,
-      timestamp: nowIso()
-    });
-  }
-}
-
-function summarizeTasks(tasks) {
-  return tasks.reduce(
-    (acc, task) => {
-      acc[task.status] = (acc[task.status] || 0) + 1;
-      return acc;
-    },
-    { pending: 0, running: 0, passed: 0, failed: 0, skipped: 0 }
-  );
-}
-
-async function runDispatch({ repoRoot, changeId, parallel = 3, maxRetries, resume = false }) {
-  const manifestPath = getTaskManifestPath(repoRoot, changeId);
-  const manifest = parseManifest(await readJson(manifestPath));
-
-  if (resume) {
-    for (const task of manifest.tasks) {
-      if (task.status === 'running') {
-        task.status = 'pending';
-      }
-    }
-  }
-
-  const safeParallel = Math.max(1, Number.parseInt(parallel, 10) || 1);
-
-  while (true) {
-    const taskMap = new Map(manifest.tasks.map((task) => [task.id, task]));
-    const pending = manifest.tasks.filter((task) => task.status === 'pending');
-
-    if (pending.length === 0) {
-      break;
-    }
-
-    for (const task of pending) {
-      if (dependenciesFailed(task, taskMap)) {
-        task.status = 'skipped';
-        task.lastError = 'Blocked by failed dependency';
-      }
-    }
-
-    const ready = manifest.tasks.filter(
-      (task) => task.status === 'pending' && dependenciesPassed(task, taskMap)
-    );
-
-    if (ready.length === 0) {
-      await writeJson(manifestPath, {
-        ...manifest,
-        updatedAt: nowIso()
-      });
-
-      return {
-        changeId,
-        manifestPath,
-        summary: summarizeTasks(manifest.tasks),
-        success: false,
-        reason: 'No ready tasks left. Check dependencies and failed tasks.'
-      };
-    }
-
-    const batch = selectBatch(ready, safeParallel);
-
-    if (batch.length === 0) {
-      const firstReady = ready[0];
-      batch.push(firstReady);
-    }
-
-    await Promise.all(
-      batch.map((task) =>
-        executeTask({
-          repoRoot,
-          changeId,
-          task,
-          retryOverride: Number.isInteger(maxRetries) ? maxRetries : undefined
-        })
-      )
-    );
-
-    manifest.updatedAt = nowIso();
-    await writeJson(manifestPath, manifest);
-  }
-
-  const summary = summarizeTasks(manifest.tasks);
-  const success = summary.failed === 0 && summary.pending === 0;
-
-  return {
-    changeId,
-    manifestPath,
-    summary,
-    success
-  };
-}
-
-module.exports = {
-  runDispatch
-};

package/lib/harness/operations/init.js

@@ -1,48 +0,0 @@
-/**
- * [INPUT]: 依赖 store 提供 repo/change 路径与读写能力，接收 changeId/goal 初始化参数。
- * [OUTPUT]: 写入 requirement 目录与 harness-state.json，返回初始化摘要。
- * [POS]: harness Stage-1 初始化入口，被 CLI `harness:init` 调用。
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- */
-
-const {
-  nowIso,
-  ensureDir,
-  writeJson,
-  readJson,
-  getRequirementDir,
-  getRuntimeChangeDir,
-  getHarnessStatePath
-} = require('../store');
-
-async function runInit({ repoRoot, changeId, goal }) {
-  const requirementDir = getRequirementDir(repoRoot, changeId);
-  const runtimeDir = getRuntimeChangeDir(repoRoot, changeId);
-  const statePath = getHarnessStatePath(repoRoot, changeId);
-
-  await ensureDir(requirementDir);
-  await ensureDir(runtimeDir);
-
-  const previous = (await readJson(statePath, {})) || {};
-  const nextState = {
-    changeId,
-    goal: goal || previous.goal || `Deliver ${changeId} safely with auditable checkpoints.`,
-    status: 'initialized',
-    initializedAt: previous.initializedAt || nowIso(),
-    updatedAt: nowIso()
-  };
-
-  await writeJson(statePath, nextState);
-
-  return {
-    changeId,
-    requirementDir,
-    runtimeDir,
-    statePath,
-    status: nextState.status
-  };
-}
-
-module.exports = {
-  runInit
-};

package/lib/harness/operations/pack.js

@@ -1,100 +0,0 @@
-/**
- * [INPUT]: 依赖 store 读取 harness-state/package scripts，并通过 git 命令收集仓库事实。
- * [OUTPUT]: 生成 context-package.md，提供可复现的目标/约束/下一步命令。
- * [POS]: harness Stage-2 上下文打包入口，被 CLI `harness:pack` 调用。
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- */
-
-const {
-  nowIso,
-  readJson,
-  writeText,
-  getContextPackagePath,
-  getHarnessStatePath,
-  runCommand,
-  getPackageScripts
-} = require('../store');
-
-async function collectGitFacts(repoRoot) {
-  const [branch, commit, status] = await Promise.all([
-    runCommand('git rev-parse --abbrev-ref HEAD', { cwd: repoRoot }),
-    runCommand('git rev-parse HEAD', { cwd: repoRoot }),
-    runCommand('git status --short', { cwd: repoRoot })
-  ]);
-
-  return {
-    branch: branch.code === 0 ? branch.stdout.trim() : 'unknown',
-    commit: commit.code === 0 ? commit.stdout.trim() : 'unknown',
-    status: status.code === 0 ? status.stdout.trim() : '(clean)'
-  };
-}
-
-function buildContextMarkdown({ changeId, goal, gitFacts, scripts }) {
-  const nextCommands = [
-    `npm run harness:plan -- --change-id ${changeId}`,
-    `npm run harness:dispatch -- --change-id ${changeId} --parallel 3`,
-    `npm run harness:verify -- --change-id ${changeId} --strict`,
-    `npm run harness:release -- --change-id ${changeId}`
-  ];
-
-  return [
-    `# Context Package - ${changeId}`,
-    '',
-    `- Generated: ${nowIso()}`,
-    `- Goal: ${goal}`,
-    '',
-    '## Repository Facts',
-    '',
-    `- Branch: ${gitFacts.branch}`,
-    `- Commit: ${gitFacts.commit}`,
-    '',
-    '### Git Status',
-    '',
-    '```text',
-    gitFacts.status || '(clean)',
-    '```',
-    '',
-    '## Constraints',
-    '',
-    '- Keep tasks dependency-aware and checkpointed.',
-    '- Block release when strict verification fails.',
-    '- Preserve auditable runtime logs in .harness/runtime/.',
-    '',
-    '## Available npm scripts',
-    '',
-    '```text',
-    Object.keys(scripts).sort().join('\n') || '(none)',
-    '```',
-    '',
-    '## Next Commands',
-    '',
-    ...nextCommands.map((command) => `- \`${command}\``),
-    ''
-  ].join('\n');
-}
-
-async function runPack({ repoRoot, changeId, goal }) {
-  const state = (await readJson(getHarnessStatePath(repoRoot, changeId), {})) || {};
-  const effectiveGoal = goal || state.goal || `Deliver ${changeId} safely with auditable checkpoints.`;
-  const gitFacts = await collectGitFacts(repoRoot);
-  const scripts = await getPackageScripts(repoRoot);
-  const context = buildContextMarkdown({
-    changeId,
-    goal: effectiveGoal,
-    gitFacts,
-    scripts
-  });
-
-  const outputPath = getContextPackagePath(repoRoot, changeId);
-  await writeText(outputPath, `${context}`);
-
-  return {
-    changeId,
-    outputPath,
-    goal: effectiveGoal
-  };
-}
-
-module.exports = {
-  runPack
-};

package/lib/harness/operations/plan.js

@@ -1,29 +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 } = require('../store');
-
-async function runPlan({ repoRoot, changeId, goal, overwrite }) {
-  const manifest = await createTaskManifest({
-    repoRoot,
-    changeId,
-    goal,
-    overwrite
-  });
-
-  return {
-    changeId,
-    manifestPath: getTaskManifestPath(repoRoot, changeId),
-    taskCount: manifest.tasks.length,
-    source: manifest.metadata.source
-  };
-}
-
-module.exports = {
-  runPlan
-};

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,163 +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,
-  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);
-
-  return {
-    changeId,
-    outputPath,
-    overall: report.overall,
-    blockingFindings: report.blockingFindings
-  };
-}
-
-module.exports = {
-  runVerify
-};