cc-devflow 4.3.0 → 4.4.1

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
-};

package/lib/harness/index.js

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

package/lib/harness/operations/dispatch.js

@@ -1,298 +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,
-  getHarnessStatePath,
-  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));
-
-  // Update harness-state.json to in_progress on first dispatch
-  const statePath = getHarnessStatePath(repoRoot, changeId);
-  const stateExists = require('fs').existsSync(statePath);
-  if (stateExists) {
-    const state = await readJson(statePath);
-    if (state.status === 'planned' || state.status === 'initialized') {
-      state.status = 'in_progress';
-      state.updatedAt = nowIso();
-      await writeJson(statePath, state);
-    }
-  }
-
-  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
-};