@openprd/cli 0.1.0 → 0.1.8

package/src/cli/quality-print.js

@@ -0,0 +1,284 @@
+/*
+ * 核心功能
+ * 渲染 standards、dev-check、quality、knowledge 和 visual compare 等质量相关命令输出。
+ *
+ * 输入
+ * 接收标准校验、研发期行数检查、质量报告、知识候选和视觉对比等结构化结果对象。
+ *
+ * 输出
+ * 向终端输出质量门禁、证据状态、知识候选和视觉对比摘要，或在 `--json` 模式下直出 JSON。
+ *
+ * 定位
+ * 位于 CLI 表现层的质量输出模块，负责 standards/quality 这一类高频质量反馈。
+ *
+ * 依赖
+ * 依赖 shared-print 中的知识回顾 helper，不承担实际检测逻辑。
+ *
+ * 维护规则
+ * 质量类输出要优先保留 production-ready、门禁范围和证据状态，避免把关键风险埋进长文本里。
+ */
+import { printKnowledgeReview } from './shared-print.js';
+
+function describeFeatureCoverageLedger(report) {
+  const activeTasks = report?.evalHarness?.featureCoverage?.activeTasks ?? null;
+  if (!activeTasks || Number(activeTasks.pending ?? 0) <= 0) {
+    return null;
+  }
+  const total = Number(activeTasks.total ?? 0);
+  const done = Number(activeTasks.done ?? 0);
+  const pending = Number(activeTasks.pending ?? 0);
+  const blocked = Number(activeTasks.blocked ?? 0);
+  const progress = total > 0 ? `${done}/${total}` : `${done}`;
+  const changeLabel = activeTasks.activeChange ? `当前变更 ${activeTasks.activeChange}` : '当前任务账本';
+  return `${changeLabel} 仍有 ${pending} 个未完成任务（已完成 ${progress}${blocked > 0 ? `，其中 ${blocked} 个因依赖阻塞` : ''}）。这表示账本未收口，不等于当前实现失败。`;
+}
+
+function printStandardsResult(result, json) {
+  if (json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+
+  if (result.action === 'init') {
+    console.log(`已初始化 OpenPrd standards: ${result.docsRoot}`);
+    for (const item of result.changed) {
+      console.log(`- ${item.status}: ${item.path}`);
+    }
+    return;
+  }
+  if (result.action === 'classify-external-reference') {
+    console.log(`已归类外部参考源码: ${result.path}`);
+    console.log(`配置: ${result.configPath}`);
+    console.log(`状态: ${result.alreadyPresent ? '已存在' : '已写入'}`);
+    return;
+  }
+
+  console.log(`OpenPrd standards: ${result.ok ? '通过' : '失败'}`);
+  console.log(`Docs root: ${result.docsRoot}`);
+  for (const check of result.checks) {
+    console.log(`- ${check}`);
+  }
+  if (result.errors.length > 0) {
+    console.log('错误:');
+    for (const error of result.errors) {
+      console.log(`- ${error}`);
+    }
+  }
+  if (result.warnings.length > 0) {
+    console.log('警告:');
+    for (const warning of result.warnings) {
+      console.log(`- ${warning}`);
+    }
+  }
+  const candidates = result.manualReport?.externalReferenceCandidates ?? [];
+  if (candidates.length > 0) {
+    console.log('外部参考源码候选:');
+    console.log('请先询问用户这些目录是否只作为外部参考；用户确认后再运行归类命令。');
+    for (const candidate of candidates) {
+      console.log(`- ${candidate.path}: ${candidate.missingFiles} 个文件、${candidate.missingFolders} 个文件夹缺说明书；原因: ${candidate.reason}；建议确认后运行 ${candidate.suggestedCommand}`);
+    }
+  }
+}
+
+function printDevelopmentStandardsResult(result, json) {
+  if (json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+
+  console.log(`OpenPrd 后续建议: ${result.ok ? '完成' : '失败'}`);
+  const attentionFiles = result.files.filter((file) => ['attention', 'warning', 'error'].includes(file.status));
+  if (attentionFiles.length > 0) {
+    console.log(`关注程度: 🟡 低风险｜建议留意，🟠 中风险｜建议优先关注，🔴 高风险｜需要先处理。`);
+  } else {
+    console.log(`本轮已回顾 ${result.files.length} 个改动文件，暂未发现需要额外说明的影响对象。`);
+  }
+  for (const file of attentionFiles) {
+    const lineText = file.lineCount === null || file.lineCount === undefined ? '未知行数' : `${file.lineCount} 行`;
+    console.log(`- ${file.statusLabel ?? file.status}: ${file.path} (${lineText})`);
+    console.log(`  ${file.nextAction}`);
+  }
+  if (result.wrapUp?.required && result.wrapUp.markdownTable) {
+    console.log(result.wrapUp.markdownBlock ?? result.wrapUp.markdownTable);
+  }
+  printKnowledgeReview(result.knowledgeReview);
+  for (const error of result.errors ?? []) {
+    console.log(`- ${error}`);
+  }
+}
+
+function printQualityResult(result, json) {
+  if (json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+
+  if (result.action === 'quality-init') {
+    console.log(`OpenPrd quality: 已初始化 (${result.changed})`);
+    console.log(`配置: ${result.files.config}`);
+    console.log(`报告目录: ${result.files.reportsDir}`);
+    console.log(`知识库索引: ${result.files.knowledgeIndex}`);
+    return;
+  }
+
+  if (result.action === 'quality-learn') {
+    console.log(`OpenPrd quality learn: ${result.ok ? '已沉淀' : '失败'}`);
+    if (result.ok) {
+      console.log(`来源类型: ${result.sourceKind}`);
+      console.log(`来源: ${result.sourcePath}`);
+      if (Array.isArray(result.sourcePaths) && result.sourcePaths.length > 1) {
+        console.log(`证据数: ${result.sourcePaths.length}`);
+      }
+      console.log(`事故: ${result.files.incident}`);
+      console.log(`模式: ${result.files.pattern}`);
+      console.log(`经验 Skill: ${result.files.skill}`);
+      return;
+    }
+    for (const error of result.errors ?? []) {
+      console.log(`- ${error}`);
+    }
+    return;
+  }
+
+  if (result.action === 'quality-knowledge-review') {
+    console.log('OpenPrd quality review: 已完成');
+    printKnowledgeReview(result);
+    return;
+  }
+
+  const headline = result.report
+    ? (result.report.readiness.ok && !result.report.readiness.productionReady
+      ? '需关注'
+      : (result.ok ? '完成' : '失败'))
+    : (result.ok ? '完成' : '失败');
+  console.log(`OpenPrd quality: ${headline}`);
+  if (result.report) {
+    console.log(`质量状态: ${result.report.summary.status}`);
+    console.log(`生产就绪: ${result.report.readiness.productionReady ? '是' : '否'}`);
+    console.log(`执行模式: ${result.report.readiness.enforcement}`);
+    if (result.report.qualityPolicy) {
+      console.log(`场景标签: ${result.report.qualityPolicy.scenarioTags.join(', ')}`);
+      console.log(`必需门禁: ${result.report.qualityPolicy.requiredGates.join(', ') || '无'}`);
+    }
+    if (result.report.readiness.attentionGates.length > 0) {
+      console.log(`需关注门禁: ${result.report.readiness.attentionGates.join(', ')}`);
+    }
+    const featureCoverageLedger = describeFeatureCoverageLedger(result.report);
+    if (featureCoverageLedger) {
+      console.log(`账本提示: ${featureCoverageLedger}`);
+    }
+    console.log('门禁:');
+    for (const gate of result.report.gates) {
+      const scope = gate.required ? '必需' : '可选';
+      const evidence = gate.evidence?.present ? `证据 ${gate.evidence.sources.length}` : '缺证据';
+      console.log(`- ${gate.status}: ${gate.label} (${scope}, ${evidence})`);
+    }
+  }
+  if (result.reportPath) {
+    console.log(`JSON: ${result.reportPath}`);
+  }
+  if (result.htmlPath) {
+    console.log(`HTML: ${result.htmlPath}`);
+  }
+  printKnowledgeReview(result.knowledgeReview);
+  for (const error of result.errors ?? []) {
+    console.log(`- ${error}`);
+  }
+}
+
+function printKnowledgeResult(result, json) {
+  if (json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+
+  if (!result.ok) {
+    console.log(`OpenPrd knowledge: 失败 (${result.action ?? 'unknown'})`);
+    for (const error of result.errors ?? []) {
+      console.log(`- ${error}`);
+    }
+    return;
+  }
+
+  if (result.action === 'knowledge-candidates') {
+    const counts = result.counts ?? {};
+    console.log(`OpenPrd knowledge candidates: ${result.candidates.length} 个 (${result.status})`);
+    console.log(`统计: pending ${counts.pending ?? 0}, promoted ${counts.promoted ?? 0}, rejected ${counts.rejected ?? 0}, archived ${counts.archived ?? 0}, reviewed ${counts.reviewed ?? 0}, total ${counts.total ?? 0}`);
+    for (const candidate of result.candidates) {
+      console.log(`- ${candidate.candidateId}: ${candidate.title ?? candidate.candidateId}`);
+      console.log(`  状态: ${candidate.status}`);
+      console.log(`  候选: ${candidate.path ?? candidate.files?.candidate}`);
+      if (candidate.draftSkillPath ?? candidate.files?.draftSkill) {
+        console.log(`  草案 Skill: ${candidate.draftSkillPath ?? candidate.files?.draftSkill}`);
+      }
+      if (candidate.pending) {
+        console.log(`  拒绝: openprd knowledge reject --id ${candidate.candidateId} --reason <原因>`);
+        console.log(`  归档: openprd knowledge archive --id ${candidate.candidateId} --reason <原因>`);
+      }
+    }
+    if (result.candidates.length === 0) {
+      console.log('没有匹配的 knowledge candidate。');
+    }
+    return;
+  }
+
+  console.log(`OpenPrd knowledge ${result.action?.replace(/^knowledge-/, '') ?? 'update'}: ${result.candidateId}`);
+  if (result.candidate) {
+    console.log(`状态: ${result.candidate.status}`);
+    if (result.candidate.reviewDecision) {
+      console.log(`决定: ${result.candidate.reviewDecision}`);
+    }
+    if (result.candidate.reviewReason) {
+      console.log(`原因: ${result.candidate.reviewReason}`);
+    }
+  }
+  if (result.files?.candidate) {
+    console.log(`候选: ${result.files.candidate}`);
+  }
+  if (result.files?.knowledgeIndex) {
+    console.log(`索引: ${result.files.knowledgeIndex}`);
+  }
+}
+
+function printVisualCompareResult(result, json) {
+  if (json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+
+  const modeLabel = result.mode === 'before-after'
+    ? '修改前后自检'
+    : result.mode === 'focus-board'
+      ? '局部焦点证据板'
+      : result.mode === 'parallel-board'
+        ? '并行实验证据板'
+        : '效果图对比';
+  console.log('OpenPrd visual compare: 已生成');
+  console.log(`输出图片: ${result.outputPath}`);
+  console.log(`模式: ${modeLabel}`);
+  console.log(`格式: ${result.format}${result.quality ? `, quality=${result.quality}` : ''}`);
+  console.log(`画布: ${result.canvas.width}x${result.canvas.height}`);
+  if (result.labels?.reference && result.reference?.rendered) {
+    console.log(`左侧: ${result.labels.reference} (${result.reference.rendered.width}x${result.reference.rendered.height})`);
+  }
+  if (result.labels?.actual && result.actual?.rendered) {
+    console.log(`右侧: ${result.labels.actual} (${result.actual.rendered.width}x${result.actual.rendered.height})`);
+  }
+  if (Array.isArray(result.focusRegions) && result.focusRegions.length > 0) {
+    console.log(`焦点区域: ${result.focusRegions.length}`);
+  }
+  if (Array.isArray(result.items) && result.items.length > 0) {
+    console.log(`实验卡片: ${result.items.length}`);
+  }
+  for (const action of result.nextActions ?? []) {
+    console.log(`- 下一步: ${action}`);
+  }
+}
+
+export {
+  printStandardsResult,
+  printDevelopmentStandardsResult,
+  printQualityResult,
+  printKnowledgeResult,
+  printVisualCompareResult,
+};

package/src/cli/run-print.js

@@ -0,0 +1,297 @@
+/*
+ * 核心功能
+ * 渲染 run / loop 相关命令的人类可读输出或 JSON 输出。
+ *
+ * 输入
+ * 接收 run context、run verify、loop prompt/run/finish 和执行确认清单等结构化结果对象。
+ *
+ * 输出
+ * 向终端输出当前执行流、任务状态、Loop 运行信息和知识回顾摘要。
+ *
+ * 定位
+ * 位于 CLI 表现层的执行路径输出模块，专门承接 run/loop 相关的密集终端信息。
+ *
+ * 依赖
+ * 依赖 shared-print 与 doctor-print 提供的复用 helper，不承担实际执行。
+ *
+ * 维护规则
+ * run/loop 输出字段变更时要保持任务态、验证态和确认清单的展示顺序稳定，避免遗漏执行门槛。
+ */
+import { labelExecutionMode } from '../execution-strategy.js';
+import { printCodexRuntimeResult } from './doctor-print.js';
+import { printKnowledgeReview, printKnowledgeSkillMatches } from './shared-print.js';
+
+function printExecutionConfirmationChecklist(checklist) {
+  if (!checklist?.required) {
+    return;
+  }
+  console.log(`${checklist.title ?? '开始动手前先确认这些'}:`);
+  if (checklist.objective) {
+    console.log(`- 这次要做什么: ${checklist.objective}`);
+  }
+  if (checklist.scope?.length > 0) {
+    console.log(`- 这次范围: ${checklist.scope.join('；')}`);
+  }
+  if (checklist.implementationItems?.length > 0) {
+    console.log(`- 我会这样推进: ${checklist.implementationItems.join('；')}`);
+  }
+  if (checklist.outOfScope?.length > 0) {
+    console.log(`- 这次先不做: ${checklist.outOfScope.join('；')}`);
+  }
+  if (checklist.verification?.length > 0) {
+    console.log(`- 完成后会检查: ${checklist.verification.join('；')}`);
+  }
+  if (checklist.risks?.length > 0) {
+    console.log(`- 需要提前知道: ${checklist.risks.join('；')}`);
+  }
+  if (checklist.confirmationPrompt) {
+    console.log(`- 如果要我现在继续: ${checklist.confirmationPrompt}`);
+  }
+}
+
+function printRunResult(result, json) {
+  if (json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+
+  if (result.action === 'run-record-hook') {
+    console.log(`OpenPrd run hook 已记录: ${result.event.eventName} -> ${result.event.outcome}`);
+    console.log(`迭代记录: ${result.files.iterations}`);
+    return;
+  }
+
+  if (result.action === 'run-verify') {
+    const taskReady = result.readiness?.taskReady !== false;
+    const workspaceReady = result.readiness?.workspaceReady !== false;
+    const workspaceAttention = result.workspaceAttention ?? null;
+    const status = taskReady
+      ? (workspaceReady ? '通过' : '当前任务通过，工作区待关注')
+      : '当前任务失败';
+    console.log(`OpenPrd run verify: ${status}`);
+    if (result.readiness) {
+      console.log(`任务就绪: ${taskReady ? '是' : '否'}`);
+      console.log(`工作区就绪: ${workspaceReady ? '是' : '否'}`);
+      if (result.readiness.qualityProductionReady !== null) {
+        console.log(`质量门禁: ${result.readiness.qualityProductionReady ? 'production-ready' : '待补证据'}`);
+      }
+    }
+    for (const check of result.checks) {
+      const scope = check.scope === 'workspace' ? '工作区' : '任务';
+      const detail = check.name === 'quality' && check.productionReady === false
+        ? ' (production-ready=false)'
+        : '';
+      console.log(`- ${check.ok ? '通过' : '失败'}: ${check.name} [${scope}]${detail}`);
+    }
+    if (workspaceAttention?.kind === 'feature-coverage-ledger') {
+      const changeLabel = workspaceAttention.activeChange
+        ? `激活变更 ${workspaceAttention.activeChange}`
+        : '当前激活任务';
+      const progress = workspaceAttention.total > 0
+        ? `${workspaceAttention.done}/${workspaceAttention.total}`
+        : `${workspaceAttention.done}`;
+      console.log('工作区待关注原因: feature-coverage 账本未收口');
+      console.log(`- ${changeLabel} 已完成 ${progress}，待处理 ${workspaceAttention.pending}${workspaceAttention.blocked > 0 ? `，阻塞 ${workspaceAttention.blocked}` : ''}`);
+      console.log('- 这通常表示任务账本或覆盖证据还没补齐，不等于本次功能失败。');
+    } else if (workspaceAttention?.summary) {
+      console.log(`工作区待关注原因: ${workspaceAttention.summary}`);
+    }
+    printKnowledgeReview(result.knowledgeReview);
+    const extraWarnings = workspaceAttention?.detail
+      ? result.warnings.filter((warning) => warning !== `quality: ${workspaceAttention.detail}`)
+      : result.warnings;
+    if (extraWarnings.length > 0) {
+      console.log('工作区待关注:');
+      for (const warning of extraWarnings) {
+        console.log(`- ${warning}`);
+      }
+    }
+    if (result.errors.length > 0) {
+      console.log('错误:');
+      for (const error of result.errors) {
+        console.log(`- ${error}`);
+      }
+    }
+    return;
+  }
+
+  console.log('当前进展参考');
+  console.log(`当前项目: ${result.projectRoot}`);
+  console.log(`基础检查: ${result.validation.valid ? '通过' : '失败'}`);
+  if (result.lane?.summary) {
+    console.log(`当前处理路径: ${result.lane.summary}`);
+  }
+  if (result.activeChange) {
+    const label = result.recommendation?.type === 'requirement-intake' ? '历史聚焦事项' : '当前聚焦事项';
+    console.log(`${label}: ${result.activeChange}`);
+  }
+  if (result.focus?.changeId && result.focus.changeId !== result.activeChange) {
+    console.log(`当前补充焦点: ${result.focus.changeId}`);
+  }
+  if (result.activeRequirementGate) {
+    const gateStatus = result.activeRequirementGate.status ?? 'active';
+    const gateSuffix = result.activeRequirementGate.relevance === 'background' ? '（仅背景提醒）' : '';
+    console.log(`当前处理阶段: ${gateStatus}${gateSuffix}`);
+  }
+  if (result.taskSummary) {
+    console.log(`后续任务进度: ${result.taskSummary.completed}/${result.taskSummary.total} 完成，${result.taskSummary.pending} 待处理，${result.taskSummary.blocked} 阻塞`);
+    if (result.taskSummary.implementation) {
+      console.log(`待落地任务: ${result.taskSummary.implementation.completed}/${result.taskSummary.implementation.total} 完成，${result.taskSummary.implementation.pending} 待处理`);
+    }
+  }
+  if (result.discovery) {
+    console.log(`调研进度: ${result.discovery.runId} 已覆盖 ${result.discovery.summary.covered}/${result.discovery.summary.total}，待处理 ${result.discovery.summary.pending}`);
+  }
+  printKnowledgeSkillMatches(result.knowledgeSkills);
+  console.log('对外表达: 面向用户时，请优先说“本次调整”“后续任务”“继续落地”“完成后检查”这类人话，不要直接复述内部编号、命令、路径、版本号或流程术语。');
+  console.log(`建议下一步: ${result.recommendation.title}`);
+  if (result.recommendation.executionMode) {
+    console.log(`推进方式: ${labelExecutionMode(result.recommendation.executionMode)}`);
+  }
+  if (result.recommendation.parallelPlan?.eligible) {
+    console.log(`协作建议: ${result.recommendation.parallelPlan.summary}`);
+  }
+  console.log(`这样安排的原因: ${result.recommendation.reason}`);
+  if (result.recommendation.preparationCommand || result.recommendation.executionCommand || result.recommendation.commitCommand) {
+    console.log('开始动手前提: 只有在用户明确要求继续落地、实现、修复、深挖或提交时，才继续往下做；如果还缺这一步，就先用人话说明范围和影响。');
+  }
+  printExecutionConfirmationChecklist(result.recommendation.executionConfirmationChecklist);
+  if (result.recommendation.preparationCommand) {
+    console.log(`内部准备参考: ${result.recommendation.preparationCommand}`);
+  }
+  if (result.recommendation.executionCommand) {
+    console.log(`内部执行参考: ${result.recommendation.executionCommand}`);
+  }
+  if (result.recommendation.commitCommand) {
+    console.log(`内部提交参考: ${result.recommendation.commitCommand}`);
+  }
+  if (result.recommendation.loop?.worktreeRecommended) {
+    console.log('环境建议: 最好放到单独环境里继续，避免和别的事项串线。');
+  }
+  console.log(`内部检查参考: ${result.recommendation.verifyCommand}`);
+  console.log(`内部状态参考: ${result.files.runState}`);
+}
+
+function printLoopResult(result, json) {
+  if (json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+
+  if (result.action === 'loop-prompt') {
+    console.log(`OpenPrd loop 提示词: ${result.ok ? '就绪' : '阻塞'}`);
+    if (result.task) {
+      console.log(`任务: ${result.task.id} ${result.task.title}`);
+      if (result.task.taskHandle) console.log(`任务句柄: ${result.task.taskHandle}`);
+    }
+    if (result.promptPath) {
+      console.log(`提示词: ${result.promptPath}`);
+    }
+    if (result.invocation?.display) {
+      console.log(`执行: ${result.invocation.display}`);
+    }
+    if (result.errors?.length) {
+      for (const error of result.errors) console.log(`- ${error}`);
+    }
+    return;
+  }
+
+  if (result.action === 'loop-run') {
+    console.log(`OpenPrd loop 运行: ${result.ok ? '通过' : '失败'}${result.dryRun ? ' (dry-run)' : ''}`);
+    if (result.task) console.log(`任务: ${result.task.id} ${result.task.title}`);
+    if (result.task?.taskHandle) console.log(`任务句柄: ${result.task.taskHandle}`);
+    if (result.promptPath) console.log(`提示词: ${result.promptPath}`);
+    if (result.invocation?.display) console.log(`执行: ${result.invocation.display}`);
+    if (result.codexRuntime || result.preflight) {
+      printCodexRuntimeResult(result.codexRuntime ?? {
+        ok: result.preflight.ok,
+        preflight: result.preflight,
+        repair: result.repair,
+        repairAttempted: Boolean(result.repairAttempted),
+      });
+    }
+    if (result.finish?.commit) {
+      console.log(`提交: ${result.finish.commit.skipped ? '跳过' : result.finish.commit.sha}`);
+    }
+    if (result.finish?.projectRelease?.version) {
+      console.log(`项目版本: ${result.finish.projectRelease.version}`);
+      if (result.finish.projectRelease.tag?.tagName) {
+        const localSha = result.finish.projectRelease.tag.localSha ? ` -> ${result.finish.projectRelease.tag.localSha}` : '';
+        console.log(`版本 tag: ${result.finish.projectRelease.tag.tagName}${localSha}`);
+      }
+    }
+    if (result.finish?.testReport) {
+      console.log(`测试报告: ${result.finish.testReport}`);
+    }
+    if (result.errors?.length) {
+      for (const error of result.errors) console.log(`- ${error}`);
+    }
+    return;
+  }
+
+  if (result.action === 'loop-finish') {
+    console.log(`OpenPrd loop finish: ${result.ok ? '通过' : '失败'}`);
+    if (result.task) console.log(`任务: ${result.task.id} ${result.task.title}`);
+    if (result.task?.taskHandle) console.log(`任务句柄: ${result.task.taskHandle}`);
+    if (result.commit) console.log(`提交: ${result.commit.skipped ? '跳过' : result.commit.sha}`);
+    if (result.projectRelease?.version) {
+      console.log(`项目版本: ${result.projectRelease.version}`);
+      if (result.projectRelease.tag?.tagName) {
+        const localSha = result.projectRelease.tag.localSha ? ` -> ${result.projectRelease.tag.localSha}` : '';
+        console.log(`版本 tag: ${result.projectRelease.tag.tagName}${localSha}`);
+      }
+    }
+    if (result.testReport) console.log(`测试报告: ${result.testReport}`);
+    if (result.learningReview) {
+      if (result.learningReview.skipped) {
+        console.log(`复盘学习包: 已跳过 (${result.learningReview.reason})`);
+      } else if (result.learningReview.ok === false) {
+        console.log(`复盘学习包: 生成失败 (${result.learningReview.errors?.[0] ?? 'unknown'})`);
+      } else {
+        console.log(`复盘学习包: ${result.learningReview.packageId}`);
+        console.log(`HTML: ${result.learningReview.packagePaths?.readerHtml ?? '无'}`);
+        console.log(`题材: ${result.learningReview.genre?.label ?? '未知'}`);
+        if (result.learningReview.packageMeta?.styleLabel) console.log(`子风格: ${result.learningReview.packageMeta.styleLabel}`);
+        if (result.learningReview.packageMeta?.authoringStatus) console.log(`写作状态: ${result.learningReview.packageMeta.authoringStatus}`);
+        if (result.learningReview.packagePaths?.agentPrompt) console.log(`Agent 写作提示: ${result.learningReview.packagePaths.agentPrompt}`);
+        console.log(`已打开: ${result.learningReview.opened ? '是' : '否'}`);
+      }
+    }
+    printKnowledgeReview(result.knowledgeReview);
+    if (result.next) {
+      console.log(`下一任务: ${result.next.id} ${result.next.title}`);
+      if (result.next.taskHandle) console.log(`下一任务句柄: ${result.next.taskHandle}`);
+    }
+    if (result.projectRelease?.warnings?.length) {
+      for (const warning of result.projectRelease.warnings) {
+        console.log(`- ${warning}`);
+      }
+    }
+    if (result.errors?.length) {
+      for (const error of result.errors) console.log(`- ${error}`);
+    }
+    return;
+  }
+
+  console.log(`OpenPrd loop: ${result.action} ${result.ok ? '通过' : '失败'}`);
+  if (result.changeId) console.log(`变更: ${result.changeId}`);
+  if (result.summary) {
+    console.log(`任务: ${result.summary.done}/${result.summary.total} 完成，${result.summary.pending} 待处理，${result.summary.failed} 失败，${result.summary.blocked} 阻塞`);
+  }
+  if (result.next) {
+    console.log(`下一任务: ${result.next.id} ${result.next.title}`);
+    if (result.next.taskHandle) console.log(`下一任务句柄: ${result.next.taskHandle}`);
+  }
+  if (result.files) {
+    console.log(`任务清单: ${result.files.featureList}`);
+  }
+  if (result.errors?.length) {
+    for (const error of result.errors) console.log(`- ${error}`);
+  }
+}
+
+export {
+  printExecutionConfirmationChecklist,
+  printRunResult,
+  printLoopResult,
+};