cc-devflow 4.5.10 → 4.5.12

package/lib/skill-runtime/operations/plan.js

@@ -1,59 +0,0 @@
-/**
- * [INPUT]: 依赖 planner.createTaskManifest，接收 changeId/goal/overwrite 参数。
- * [OUTPUT]: 生成并返回已校验的 task-manifest.json 摘要。
- * [POS]: skill runtime Stage-3 计划生成入口，供内部规划链路复用。
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- */
-
-const { createTaskManifest } = require('../planner');
-const { getIntentHandoffArtifactPaths } = require('../artifacts');
-const {
-  getTaskManifestPath,
-  getRuntimeStatePath,
-  getReportCardPath,
-  exists,
-  readJson,
-  writeJson,
-  removePath
-} = require('../store');
-
-async function runPlan({ repoRoot, changeId, goal, overwrite }) {
-  const manifest = await createTaskManifest({
-    repoRoot,
-    changeId,
-    goal,
-    overwrite
-  });
-
-  // Update change-state.json with plannedAt timestamp
-  const statePath = getRuntimeStatePath(repoRoot, changeId);
-  if (await exists(statePath)) {
-    const state = await readJson(statePath);
-    state.status = 'planned';
-    state.plannedAt = new Date().toISOString();
-    state.approval = {
-      status: 'pending',
-      executionMode: state.approval?.executionMode || 'delegate'
-    };
-    delete state.verifiedAt;
-    delete state.releasedAt;
-    state.updatedAt = new Date().toISOString();
-    await writeJson(statePath, state);
-  }
-
-  await Promise.all([
-    removePath(getReportCardPath(repoRoot, changeId)),
-    ...getIntentHandoffArtifactPaths(repoRoot, changeId).map((target) => removePath(target))
-  ]);
-
-  return {
-    changeId,
-    manifestPath: getTaskManifestPath(repoRoot, changeId),
-    taskCount: manifest.tasks.length,
-    source: manifest.metadata.source
-  };
-}
-
-module.exports = {
-  runPlan
-};

package/lib/skill-runtime/operations/prepare-pr.js

@@ -1,25 +0,0 @@
-/**
- * [INPUT]: 依赖 intent 的 PR brief 生成能力，接收 repoRoot 与 changeId。
- * [OUTPUT]: 生成 `devflow/changes/<goal>/handoff/pr-brief.md`，并清理冲突 handoff 文件。
- * [POS]: skill runtime 的 PR-ready 收尾入口，被 autopilot 与内部收尾链路复用。
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- */
-
-const { getIntentPrBriefPath } = require('../artifacts');
-const { syncIntentMemory, syncIntentPrBrief } = require('../intent');
-
-async function runPreparePr({ repoRoot, changeId }) {
-  const prepared = await syncIntentPrBrief(repoRoot, changeId);
-  await syncIntentMemory(repoRoot, changeId);
-
-  return {
-    changeId,
-    prBriefPath: prepared.prBriefPath || getIntentPrBriefPath(repoRoot, changeId),
-    suggestedTitle: prepared.suggestedTitle,
-    status: 'prepared'
-  };
-}
-
-module.exports = {
-  runPreparePr
-};

package/lib/skill-runtime/operations/release.js

@@ -1,99 +0,0 @@
-/**
- * [INPUT]: 依赖 report-card 与 task-manifest 的最终状态。
- * [OUTPUT]: 在 handoff 目录生成 release-note.md，并更新 change-state 为 released。
- * [POS]: skill runtime 发布收尾入口，供内部收尾链路复用。
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- */
-
-const {
-  nowIso,
-  readJson,
-  writeText,
-  writeJson,
-  getReportCardPath,
-  getTaskManifestPath,
-  getReleaseNotePath,
-  getRuntimeStatePath
-} = require('../store');
-const { parseReportCard, parseManifest } = require('../schemas');
-const { syncIntentMemory } = require('../intent');
-const { assertShipReady } = require('../readiness');
-
-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()}`,
-    `- Verdict: ${(report.verdict || report.overall).toUpperCase()}`,
-    `- Verification: ${report.overall.toUpperCase()}`,
-    `- Review: ${(report.review?.status || 'skipped').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 = getRuntimeStatePath(repoRoot, changeId);
-
-  const report = parseReportCard(await readJson(reportPath));
-  const manifest = parseManifest(await readJson(manifestPath));
-  const previousState = await readJson(statePath, null);
-
-  assertShipReady(report, {
-    reportPath,
-    errorName: 'ReleaseReadinessError',
-    rescueAction: 'run cc-check until ship-readiness is ready before release'
-  });
-
-  const note = formatReleaseNote({ changeId, manifest, report });
-  const releaseNotePath = getReleaseNotePath(repoRoot, changeId);
-
-  await writeText(releaseNotePath, note);
-  await writeJson(statePath, {
-    ...(previousState || {}),
-    changeId,
-    changeKey: previousState?.changeKey,
-    slug: previousState?.slug,
-    createdAt: previousState?.createdAt,
-    goal: manifest.goal || previousState?.goal,
-    status: 'released',
-    initializedAt: previousState?.initializedAt || nowIso(),
-    plannedAt: previousState?.plannedAt,
-    verifiedAt: previousState?.verifiedAt,
-    approval: previousState?.approval,
-    releasedAt: nowIso(),
-    updatedAt: nowIso()
-  });
-  await syncIntentMemory(repoRoot, changeId);
-
-  return {
-    changeId,
-    releaseNotePath,
-    status: 'released'
-  };
-}
-
-module.exports = {
-  runRelease
-};

package/lib/skill-runtime/operations/resume.js

@@ -1,126 +0,0 @@
-/**
- * [INPUT]: 依赖 manifest 当前状态与 dispatch 执行器，接收 changeId/并行度/重试参数。
- * [OUTPUT]: 将失败执行恢复到最近已通过的 manifest 任务边界，把未稳定任务重新排队后继续执行。
- * [POS]: skill runtime 恢复执行入口，供内部恢复链路复用。
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- */
-
-const {
-  readJson,
-  writeJson,
-  getTaskManifestPath,
-  getRuntimeStatePath
-} = require('../store');
-const { parseManifest } = require('../schemas');
-const { applyManifestExecutionState } = require('../planner');
-const { runDispatch } = require('./dispatch');
-const { syncIntentMemory } = require('../intent');
-const { getApprovalState, isExecutionApproved } = require('../lifecycle');
-
-async function resolveStableManifestPoint(manifest) {
-  const passedTasks = manifest.tasks
-    .filter((task) => task.status === 'passed')
-    .map((task) => ({
-      taskId: task.id,
-      status: task.status,
-      title: task.title || '',
-      planVersion: manifest.metadata?.planVersion || 1
-    }));
-
-  return passedTasks[passedTasks.length - 1] || null;
-}
-
-function restoreTaskToPending(task, restoreLabel) {
-  const previousError = task.lastError ? ` Previous error: ${task.lastError}` : '';
-  task.status = 'pending';
-  task.attempts = 0;
-  task.lastError = `Restored from ${restoreLabel}.${previousError}`.trim();
-}
-
-function requeueFromStableManifestPoint(manifest, restoreTarget) {
-  const restoreLabel = restoreTarget ? `stable manifest task ${restoreTarget.taskId}` : 'execution start';
-  const restoredTaskIds = [];
-
-  for (const task of manifest.tasks) {
-    if (task.status === 'running' || task.status === 'failed') {
-      restoreTaskToPending(task, restoreLabel);
-      restoredTaskIds.push(task.id);
-      continue;
-    }
-
-    if (task.status === 'skipped' && task.lastError === 'Blocked by failed dependency') {
-      restoreTaskToPending(task, restoreLabel);
-      restoredTaskIds.push(task.id);
-    }
-  }
-
-  return {
-    restoreLabel,
-    restoredTaskIds
-  };
-}
-
-async function runResume({
-  repoRoot,
-  changeId,
-  parallel,
-  maxRetries,
-  executionScope = 'all',
-  fromCheckpoint = 'stable'
-}) {
-  const manifestPath = getTaskManifestPath(repoRoot, changeId);
-  const manifest = parseManifest(await readJson(manifestPath));
-  const state = await readJson(getRuntimeStatePath(repoRoot, changeId), null);
-  const approval = getApprovalState(state, manifest);
-
-  if (!isExecutionApproved(state, manifest)) {
-    await syncIntentMemory(repoRoot, changeId, {
-      event: 'resume_blocked_unapproved',
-      reason: `Plan version ${approval.planVersion || manifest.metadata?.planVersion || 1} must be approved before resume`
-    });
-
-    return {
-      changeId,
-      manifestPath,
-      summary: null,
-      success: false,
-      reason: `Execution blocked until plan_version ${approval.planVersion || manifest.metadata?.planVersion || 1} is approved. Return to the cc-plan approval gate and keep execution mode ${approval.executionMode}.`
-    };
-  }
-
-  if (fromCheckpoint && fromCheckpoint !== 'stable') {
-    throw new Error(`Unsupported resume point: ${fromCheckpoint}`);
-  }
-
-  const restoreTarget = await resolveStableManifestPoint(manifest);
-  const restoreSummary = requeueFromStableManifestPoint(manifest, restoreTarget);
-
-  applyManifestExecutionState(manifest);
-  await writeJson(manifestPath, manifest);
-  await syncIntentMemory(repoRoot, changeId, {
-    event: 'resume_restored_manifest_state',
-    reason: restoreSummary.restoredTaskIds.length > 0
-      ? `Restored ${restoreSummary.restoredTaskIds.join(', ')} from ${restoreSummary.restoreLabel}`
-      : `Resume confirmed ${restoreSummary.restoreLabel}; no unresolved tasks required requeue`
-  });
-
-  const dispatchResult = await runDispatch({
-    repoRoot,
-    changeId,
-    parallel,
-    maxRetries,
-    resume: true,
-    executionScope
-  });
-
-  return {
-    ...dispatchResult,
-    restoredState: restoreTarget,
-    restoredTasks: restoreSummary.restoredTaskIds,
-    reason: dispatchResult.reason || `Resumed from ${restoreSummary.restoreLabel}`
-  };
-}
-
-module.exports = {
-  runResume
-};

package/lib/skill-runtime/operations/review-records.js

@@ -1,265 +0,0 @@
-/**
- * [INPUT]: 依赖 review-records helper、store.appendJsonl、ReviewLedgerEventSchema。
- * [OUTPUT]: 实现 review durable records CLI operation，当前只写 review-started。
- * [POS]: CLI 与 durable review ledger 的边界层；负责校验后追加 JSONL。
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- */
-
-const path = require('path');
-
-const { getChangePaths } = require('../paths');
-const { appendJsonl, readText, writeText } = require('../store');
-const { parseReviewLedgerEvent } = require('../schemas');
-const {
-  getReviewLedgerPath,
-  nextReviewId,
-  parseSkippedNode
-} = require('../review-records');
-
-function readLedgerEvents(text) {
-  return String(text || '')
-    .split('\n')
-    .map((line) => line.trim())
-    .filter(Boolean)
-    .map((line) => JSON.parse(line));
-}
-
-function normalizeArray(values) {
-  return (values || [])
-    .flatMap((value) => String(value || '').split(','))
-    .map((value) => value.trim())
-    .filter(Boolean);
-}
-
-async function loadLedger(repoRoot, changeId, changeKey) {
-  const change = getChangePaths(repoRoot, changeId, { changeKey });
-  const ledgerPath = getReviewLedgerPath(repoRoot, changeId, { changeKey });
-  const events = readLedgerEvents(await readText(ledgerPath, ''));
-  return { change, ledgerPath, events };
-}
-
-function hasStarted(events, reviewId) {
-  return events.some((event) => event.reviewId === reviewId && event.event === 'review-started');
-}
-
-function hasClosed(events, reviewId) {
-  return events.some((event) => event.reviewId === reviewId && event.event === 'review-closed');
-}
-
-async function appendReviewEvent(options, eventFields) {
-  const {
-    repoRoot,
-    changeId,
-    changeKey,
-    reviewId,
-    now = new Date()
-  } = options;
-  const { change, ledgerPath, events } = await loadLedger(repoRoot, changeId, changeKey);
-
-  if (!reviewId || !hasStarted(events, reviewId)) {
-    return {
-      code: 4,
-      stderr: `Review ${reviewId || '<missing>'} has not been started`
-    };
-  }
-
-  if (eventFields.event === 'review-closed' && hasClosed(events, reviewId)) {
-    return {
-      code: 4,
-      stderr: `Review ${reviewId} is already closed`
-    };
-  }
-
-  const event = parseReviewLedgerEvent({
-    schema: 'review-ledger.v2',
-    change: change.changeKey,
-    reviewId,
-    createdAt: now.toISOString(),
-    createdBy: 'cc-devflow-cli',
-    ...eventFields
-  });
-
-  await appendJsonl(ledgerPath, event);
-
-  return {
-    code: 0,
-    reviewId,
-    ledgerPath: path.relative(repoRoot, ledgerPath),
-    event: event.event
-  };
-}
-
-async function runReviewStart(options) {
-  const {
-    repoRoot,
-    changeId,
-    changeKey,
-    mode = 'implementation',
-    scope = 'current-diff',
-    baseSha = 'unknown',
-    headSha = 'unknown',
-    selectedNodes = [],
-    skippedNodes = [],
-    riskLanes = [],
-    now = new Date()
-  } = options;
-  const change = getChangePaths(repoRoot, changeId, { changeKey });
-  const ledgerPath = getReviewLedgerPath(repoRoot, changeId, { changeKey });
-  const existingEvents = readLedgerEvents(await readText(ledgerPath, ''));
-  const reviewId = nextReviewId(existingEvents, now);
-  const event = parseReviewLedgerEvent({
-    schema: 'review-ledger.v2',
-    change: change.changeKey,
-    reviewId,
-    createdAt: now.toISOString(),
-    createdBy: 'cc-devflow-cli',
-    event: 'review-started',
-    mode,
-    scope,
-    baseSha,
-    headSha,
-    selectedNodes: normalizeArray(selectedNodes),
-    skippedNodes: skippedNodes.map(parseSkippedNode),
-    riskLanes: normalizeArray(riskLanes)
-  });
-
-  await appendJsonl(ledgerPath, event);
-
-  return {
-    code: 0,
-    reviewId,
-    ledgerPath: path.relative(repoRoot, ledgerPath),
-    event: event.event
-  };
-}
-
-async function runReviewRecordNode(options) {
-  return appendReviewEvent(options, {
-    event: 'review-node-checked',
-    nodeId: options.nodeId,
-    mode: options.mode || 'implementation',
-    target: options.target,
-    status: options.status || 'checked',
-    coverage: normalizeArray(options.coverage),
-    evidenceRefs: normalizeArray(options.evidenceRefs),
-    findings: normalizeArray(options.findings),
-    next: options.next || 'cc-check'
-  });
-}
-
-async function runReviewAddFinding(options) {
-  return appendReviewEvent(options, {
-    event: 'review-finding-added',
-    findingId: options.findingId,
-    severity: options.severity || 'important',
-    confidence: Number(options.confidence),
-    displayTier: options.displayTier || 'blocking',
-    fingerprint: options.fingerprint,
-    scope: options.scope,
-    path: options.path,
-    evidence: options.evidence,
-    recommendation: options.recommendation,
-    route: options.route || 'cc-do'
-  });
-}
-
-async function runReviewClose(options) {
-  return appendReviewEvent(options, {
-    event: 'review-closed',
-    status: options.status || 'clean',
-    blockingCount: Number(options.blockingCount || 0),
-    warningCount: Number(options.warningCount || 0),
-    next: options.next || 'cc-check'
-  });
-}
-
-function renderReviewMarkdown({ changeKey, reviewId, events }) {
-  const closed = events.find((event) => event.event === 'review-closed');
-  const findings = events.filter((event) => event.event === 'review-finding-added');
-  const lines = [
-    '---',
-    'Output language: en',
-    `reviewId: ${reviewId}`,
-    `change: ${changeKey}`,
-    '---',
-    '',
-    `# Review ${reviewId}`,
-    '',
-    '## Summary',
-    '',
-    `- Status: ${closed?.status || 'open'}`,
-    `- Blocking findings: ${closed?.blockingCount ?? 0}`,
-    `- Warnings: ${closed?.warningCount ?? 0}`,
-    `- Next: ${closed?.next || 'cc-check'}`,
-    '',
-    '## Findings',
-    ''
-  ];
-
-  if (findings.length === 0) {
-    lines.push('- None');
-  } else {
-    for (const finding of findings) {
-      lines.push(
-        `- ${finding.findingId} [${finding.severity}/${finding.displayTier}, confidence ${finding.confidence}] ${finding.path}`,
-        `  - Evidence: ${finding.evidence}`,
-        `  - Recommendation: ${finding.recommendation}`,
-        `  - Route: ${finding.route}`
-      );
-    }
-  }
-
-  lines.push('', '## Ledger Events', '');
-  for (const event of events) {
-    lines.push(`- ${event.event} at ${event.createdAt}`);
-  }
-
-  return `${lines.join('\n')}\n`;
-}
-
-async function runReviewRender(options) {
-  const {
-    repoRoot,
-    changeId,
-    changeKey,
-    reviewId,
-    output
-  } = options;
-  const { change, events } = await loadLedger(repoRoot, changeId, changeKey);
-  const selectedReviewId = reviewId
-    || [...events].reverse().find((event) => event.event === 'review-started')?.reviewId;
-
-  if (!selectedReviewId) {
-    return { code: 4, stderr: 'No reviewId available to render' };
-  }
-
-  if (!output) {
-    return { code: 4, stderr: 'review render --output is required' };
-  }
-
-  const reviewEvents = events.filter((event) => event.reviewId === selectedReviewId);
-  if (reviewEvents.length === 0) {
-    return { code: 4, stderr: `Review ${selectedReviewId} has no ledger events` };
-  }
-
-  const outputPath = path.isAbsolute(output) ? output : path.join(repoRoot, output);
-  await writeText(outputPath, renderReviewMarkdown({
-    changeKey: change.changeKey,
-    reviewId: selectedReviewId,
-    events: reviewEvents
-  }));
-
-  return {
-    code: 0,
-    reviewId: selectedReviewId,
-    outputPath: path.relative(repoRoot, outputPath)
-  };
-}
-
-module.exports = {
-  runReviewAddFinding,
-  runReviewClose,
-  runReviewRecordNode,
-  runReviewRender,
-  runReviewStart
-};

package/lib/skill-runtime/operations/snapshot.js

@@ -1,45 +0,0 @@
-/**
- * [INPUT]: 依赖 store 读取 change-state/package scripts，并通过 git 命令收集仓库事实。
- * [OUTPUT]: 返回 discover 阶段需要的仓库事实，不再落盘 planning-snapshot.md。
- * [POS]: skill runtime Stage-2 内部快照入口，被 autopilot discover 阶段调用。
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- */
-
-const {
-  readJson,
-  getRuntimeStatePath,
-  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)'
-  };
-}
-
-async function runPlanningSnapshot({ repoRoot, changeId, goal }) {
-  const state = (await readJson(getRuntimeStatePath(repoRoot, changeId), {})) || {};
-  const effectiveGoal = goal || state.goal || `Deliver ${changeId} safely with task-state truth.`;
-  const gitFacts = await collectGitFacts(repoRoot);
-  const scripts = await getPackageScripts(repoRoot);
-
-  return {
-    changeId,
-    goal: effectiveGoal,
-    gitFacts,
-    scripts
-  };
-}
-
-module.exports = {
-  runPlanningSnapshot
-};