@openprd/cli 0.1.1 → 0.1.8

package/src/cli/print.js

@@ -1,1386 +1,73 @@
-function resolveActiveTemplatePack(ws) {
-  return ws.data.currentState?.templatePack ?? ws.data.config?.activeTemplatePack ?? 'base';
-}
-
-function printValidation(report, json) {
-  if (json) {
-    console.log(JSON.stringify(report, null, 2));
-    return;
-  }
-
-  if (report.valid) {
-    console.log('OpenPrd 校验通过');
-    if (report.warnings.length > 0) {
-      console.log('警告:');
-      for (const warning of report.warnings) {
-        console.log(`- ${warning}`);
-      }
-    }
-    return;
-  }
-
-  console.log('OpenPrd 校验失败');
-  for (const error of report.errors) {
-    console.log(`- ${error}`);
-  }
-  if (report.warnings.length > 0) {
-    console.log('警告:');
-    for (const warning of report.warnings) {
-      console.log(`- ${warning}`);
-    }
-  }
-}
-
-function printStatus(ws, report, guidance, json) {
-  const versionIndex = Array.isArray(ws.data.versionIndex) ? ws.data.versionIndex : [];
-  const learningReview = ws.data.config?.learningReview ?? null;
-  const summary = {
-    projectRoot: ws.projectRoot,
-    workspaceRoot: ws.workspaceRoot,
-    schema: ws.data.schema?.name ?? null,
-    templatePack: resolveActiveTemplatePack(ws),
-    productTypes: ws.data.config?.supportedProductTypes ?? [],
-    prdVersion: ws.data.currentState?.prdVersion ?? 0,
-    latestVersionId: ws.data.currentState?.latestVersionId ?? versionIndex.at(-1)?.versionId ?? null,
-    versionCount: versionIndex.length,
-    valid: report.valid,
-    errors: report.errors,
-    warnings: report.warnings,
-    activeEngagementStatus: ws.data.currentState?.status ?? 'unknown',
-    scenario: guidance?.clarification?.scenario?.label ?? null,
-    userParticipationMode: guidance?.clarification?.scenario?.userParticipation ?? null,
-    currentGate: guidance?.gates?.currentGate ?? null,
-    upcomingGate: guidance?.gates?.upcomingGate ?? null,
-    learningReview,
-    learningCurrent: ws.data.learningCurrent ?? null,
-  };
-
-  if (json) {
-    console.log(JSON.stringify(summary, null, 2));
-    return;
-  }
-
-  console.log(`工作区: ${summary.workspaceRoot}`);
-  console.log(`Schema: ${summary.schema}`);
-  console.log(`模板包: ${summary.templatePack}`);
-  console.log(`产品类型: ${summary.productTypes.join(', ')}`);
-  console.log(`PRD 版本: ${summary.prdVersion}`);
-  console.log(`最新版本: ${summary.latestVersionId ?? '无'}`);
-  console.log(`版本数量: ${summary.versionCount}`);
-  console.log(`状态: ${summary.activeEngagementStatus}`);
-  if (summary.scenario) {
-    console.log(`场景: ${summary.scenario}`);
-  }
-  if (summary.userParticipationMode) {
-    console.log(`用户参与模式: ${summary.userParticipationMode}`);
-  }
-  if (summary.currentGate) {
-    console.log(`当前门禁: ${summary.currentGate}`);
-  }
-  if (summary.upcomingGate) {
-    console.log(`后续门禁: ${summary.upcomingGate}`);
-  }
-  if (summary.learningReview) {
-    console.log(`复盘学习模式: ${summary.learningReview.enabled !== false ? '开启' : '关闭'}`);
-    console.log(`默认题材: ${summary.learningReview.defaultGenre ?? 'internet-product'}`);
-    console.log(`自动打开: ${summary.learningReview.autoOpen !== false ? '是' : '否'}`);
-    console.log(`来源范围: ${summary.learningReview.sourceScope ?? 'workspace'}`);
-  }
-  if (summary.learningCurrent?.packageId) {
-    console.log(`最近学习包: ${summary.learningCurrent.packageId}`);
-  }
-  console.log(`验证: ${summary.valid ? '通过' : '失败'}`);
-  if (summary.errors.length > 0) {
-    console.log('错误:');
-    for (const error of summary.errors) {
-      console.log(`- ${error}`);
-    }
-  }
-  if (summary.warnings.length > 0) {
-    console.log('警告:');
-    for (const warning of summary.warnings) {
-      console.log(`- ${warning}`);
-    }
-  }
-}
-
-function printClassifyResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  console.log(`已分类产品类型: ${result.currentState.productType}`);
-  console.log(`模板包: ${result.currentState.templatePack}`);
-}
-
-function printClarifyResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  console.log(`需要澄清: ${result.ws.workspaceRoot}`);
-  console.log(`场景: ${result.clarification.scenario.label}`);
-  console.log(`用户参与: ${result.clarification.scenario.userParticipation}`);
-  console.log(`待确认关键信息: ${result.clarification.missingRequiredFields}`);
-  console.log(`待确认问题: ${result.clarification.mustAskUser.length}`);
-  if (result.clarifyPresentation) {
-    console.log(`澄清呈现: ${result.clarifyPresentation.label}`);
-    console.log(`呈现原因: ${result.clarifyPresentation.reason}`);
-  }
-  console.log('建议先确认的问题:');
-  for (const item of result.clarification.mustAskUser) {
-    console.log(`- ${item.prompt}`);
-  }
-  if (result.inlineClarification) {
-    console.log('对话内澄清提纲:');
-    for (const line of result.inlineClarification.lines) {
-      console.log(line);
-    }
-    console.log('无需打开 HTML；请把上面的目标、范围、非目标和验收方式压缩给用户确认。');
-  }
-  if (result.clarification.canInferLater.length > 0) {
-    console.log('之后可以再补充或细化:');
-    for (const item of result.clarification.canInferLater.slice(0, 5)) {
-      console.log(`- ${item.prompt}`);
-    }
-  }
-}
-
-function printCaptureResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  if (result.applied?.length > 1) {
-    console.log(`已捕获 ${result.applied.length} 个字段`);
-    for (const item of result.applied) {
-      console.log(`- ${item.field} (${item.source}): ${JSON.stringify(item.value)}`);
-    }
-  } else {
-    console.log(`已捕获 ${result.field}`);
-    console.log(`状态 key: ${result.stateKey}`);
-    console.log(`来源: ${result.source}`);
-    console.log(`值: ${JSON.stringify(result.value)}`);
-  }
-  if (result.artifactMarkdown) {
-    console.log(`来源 artifact markdown: ${result.artifactMarkdown}`);
-  }
-  console.log(`剩余缺失必填字段: ${result.analysis.missingRequiredFields}`);
-}
-
-function printInterviewResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  console.log(`访谈模式: ${result.productType ?? '未分类'}`);
-  console.log(`来源文件: ${result.sourceFiles.join(', ')}`);
-  console.log(result.transcript);
-}
-
-function printPlaygroundResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  console.log(`已生成 Playground: ${result.snapshot.title}`);
-  console.log(`HTML: ${result.htmlPath}`);
-  console.log(`Markdown 数据源: ${result.markdownPath}`);
-  console.log(`捕获补丁: ${result.patchPath}`);
-  console.log(`已打开: ${result.opened ? '是' : '否'}`);
-}
-
-function printLearningResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  if (result.action === 'learning-review-config') {
-    console.log(`复盘学习模式: ${result.enabled ? '已开启' : '已关闭'}`);
-    console.log(`默认题材: ${result.config?.defaultGenre ?? 'internet-product'}`);
-    console.log(`自动打开: ${result.config?.autoOpen !== false ? '是' : '否'}`);
-    return;
-  }
-
-  if (result.skipped) {
-    console.log('复盘学习包: 已跳过');
-    console.log(`原因: ${result.reason}`);
-    return;
-  }
-
-  console.log(`复盘学习包: ${result.packageId}`);
-  console.log(`题材: ${result.genre?.label ?? result.packageMeta?.genreLabel ?? '未知'}`);
-  if (result.packageMeta?.styleLabel || result.content?.stylePromptPack?.label) {
-    console.log(`子风格: ${result.packageMeta?.styleLabel ?? result.content?.stylePromptPack?.label}`);
-  }
-  console.log(`主题: ${result.content?.topic ?? result.packageMeta?.topic ?? '未知'}`);
-  if (result.packageMeta?.authoringStatus) {
-    console.log(`写作状态: ${result.packageMeta.authoringStatus}`);
-  }
-  console.log(`HTML: ${result.packagePaths?.readerHtml ?? '无'}`);
-  console.log(`内容合同: ${result.packagePaths?.contentJson ?? '无'}`);
-  console.log(`证据清单: ${result.packagePaths?.evidenceManifest ?? '无'}`);
-  if (result.packagePaths?.agentPrompt) {
-    console.log(`Agent 写作提示: ${result.packagePaths.agentPrompt}`);
-  }
-  if (result.packagePaths?.agentContext) {
-    console.log(`Agent 上下文: ${result.packagePaths.agentContext}`);
-  }
-  console.log(`已打开: ${result.opened ? '是' : '否'}`);
-}
-
-
-function printSynthesizeResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  console.log(`已合成 PRD 版本 ${result.snapshot.versionId}`);
-  console.log(`标题: ${result.snapshot.title}`);
-  console.log(`产品类型: ${result.snapshot.productType ?? '未分类'}`);
-  console.log(`摘要指纹: ${result.snapshot.digest}`);
-  if (result.workUnitId) {
-    console.log(`工作单元: ${result.workUnitId}`);
-  }
-  if (!result.reviewPresentationRequired && (result.reviewPath ?? result.stableReviewArtifact)) {
-    console.log(`评审面板: ${result.reviewPath ?? result.stableReviewArtifact}`);
-  }
-  if (!result.reviewPresentationRequired && (result.reviewEntryPath ?? result.reviewArtifact)) {
-    console.log(`固定入口: ${result.reviewEntryPath ?? result.reviewArtifact}`);
-  }
-  console.log(`已打开评审面板: ${result.opened ? '是' : '否'}`);
-  if (result.reviewPresentationRequired) {
-    console.log('评审面板: 尚未生成可确认页面');
-    console.log('下一步: 先运行 openprd review-presentation . --template，填写 presentation JSON 后运行 openprd review-presentation . --presentation <json> --write --fail-on-violation。');
-    const feedback = result.reviewPresentationGate?.violations ?? [];
-    for (const item of feedback.slice(0, 6)) {
-      const pathHint = item.jsonPath ? `${item.jsonPath}: ` : '';
-      console.log(`- ${pathHint}${item.action}`);
-    }
-  } else if (result.reviewPath ?? result.stableReviewArtifact) {
-    console.log('请让用户先评审版本绑定的评审面板；用户确认后，使用页面复制出的带 version/digest/work-unit 的命令记录确认。');
-  }
-}
-
-function printReviewResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  if (!result.ok) {
-    console.log('PRD 评审状态不可用');
-    for (const error of result.errors ?? []) {
-      console.log(`- ${error}`);
-    }
-    if (result.requiredCommand) {
-      console.log(`下一步: ${result.requiredCommand}`);
-    }
-    for (const item of (result.presentationFeedback ?? []).slice(0, 6)) {
-      const pathHint = item.jsonPath ? `${item.jsonPath}: ` : '';
-      console.log(`- ${pathHint}${item.action}`);
-    }
-    return;
-  }
-
-  console.log(`PRD 评审状态: ${result.status}`);
-  console.log(`版本: ${result.versionId}`);
-  if (result.workUnitId) {
-    console.log(`工作单元: ${result.workUnitId}`);
-  }
-  console.log(`HTML 评审面板: ${result.reviewPath ?? result.stableReviewArtifact ?? result.reviewArtifact}`);
-  if (result.marked) {
-    console.log(`已从 ${result.previousStatus} 更新为 ${result.status}`);
-  }
-  if (result.opened) {
-    console.log('已打开评审面板');
-  }
-}
-
-function printHistoryResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  console.log(`版本历史: ${result.ws.workspaceRoot}`);
-  for (const entry of result.versions) {
-    console.log(`- ${entry.versionId} | ${entry.title} | ${entry.productType ?? '未分类'} | ${entry.createdAt}`);
-  }
-}
-
-function printDiffResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result.diff, null, 2));
-    return;
-  }
-
-  console.log(`差异 ${result.diff.fromVersionId} -> ${result.diff.toVersionId}`);
-  console.log(`变更章节: ${result.diff.changedSections.length > 0 ? result.diff.changedSections.join(', ') : '无'}`);
-  for (const change of result.diff.changes) {
-    console.log(`- ${change.path}: ${JSON.stringify(change.before)} -> ${JSON.stringify(change.after)}`);
-  }
-}
-
-
-function printNextResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  const { recommendation, analysis, workflow, taskGraph } = result;
-  console.log(`下一步动作: ${recommendation.nextAction}`);
-  if (recommendation.currentGate) {
-    console.log(`当前门禁: ${recommendation.currentGate}`);
-  }
-  if (recommendation.upcomingGate) {
-    console.log(`后续门禁: ${recommendation.upcomingGate}`);
-  }
-  console.log(`原因: ${recommendation.reason}`);
-  console.log(`建议命令: ${recommendation.suggestedCommand}`);
-  console.log(`完成度: ${analysis.completedRequiredFields}/${analysis.totalRequiredFields}`);
-  if (taskGraph?.nextReadyNode) {
-    console.log(`下一个就绪节点: ${taskGraph.nextReadyNode}`);
-  }
-  if (result.diagramState?.needed) {
-    console.log(`图表门禁: ${result.diagramState.shouldGateFreeze ? '激活' : '已满足'}`);
-    console.log(`建议图表: ${result.diagramState.preferredType}`);
-  }
-  console.log('工作流:');
-  console.log(`  ${workflow.join(' -> ')}`);
-  if (recommendation.suggestedQuestions.length > 0) {
-    console.log('建议问题:');
-    for (const question of recommendation.suggestedQuestions) {
-      console.log(`- ${question}`);
-    }
-  }
-}
-
-function printInitResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  console.log(`已初始化 OpenPrd 工作区: ${result.ws.workspaceRoot}`);
-  console.log(`模板包: ${result.currentState.templatePack}`);
-  console.log(`已复制种子文件: ${result.created}`);
-  if (result.standards) {
-    console.log(`标准化文档: ${result.standards.docsRoot}`);
-  }
-  if (result.agentIntegration) {
-    console.log(`Agent 引导: ${result.agentIntegration.ok ? '已启用' : '需修复'} (${result.agentIntegration.tools.join(', ')})`);
-    if (result.agentIntegration.hookProfile) {
-      console.log(`Hook 模式: ${result.agentIntegration.hookProfile}`);
-    }
-  }
-}
-
-function printAgentIntegrationResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  console.log(`OpenPrd agent ${result.action}: ${result.ok ? '通过' : '需修复'}`);
-  console.log(`项目: ${result.projectRoot}`);
-  console.log(`工具: ${result.tools.join(', ')}`);
-  if (result.hookProfile) {
-    console.log(`Hook 模式: ${result.hookProfile}`);
-  }
-  if (result.initialized) {
-    console.log(`已初始化工作区: ${result.init.workspaceRoot}`);
-  }
-  if (result.standards) {
-    console.log(`标准化文档: ${result.standards.docsRoot}`);
-  }
-  if (result.migration) {
-    const changed = result.migration.changes.filter((change) => change.status !== 'unchanged').length;
-    console.log(`工作区迁移: ${changed} 项`);
-  }
-  if (result.registry) {
-    console.log(`全局 registry: ${result.registry.status === 'created' ? '已登记' : '已刷新'} (${result.registry.registryPath})`);
-  }
-  console.log('变更:');
-  for (const change of result.changes) {
-    const detail = change.message ? ` (${change.message})` : '';
-    console.log(`- ${change.status}: ${change.path}${detail}`);
-    if (change.repairHint) {
-      console.log(`  修复建议: ${change.repairHint}`);
-    }
-  }
-  if (result.doctor?.errors?.length > 0) {
-    console.log('待处理:');
-    for (const error of result.doctor.errors) {
-      console.log(`- ${error}`);
-    }
-  }
-}
-
-function doctorCheckLabel(check) {
-  if (check.ok) return '通过';
-  if (check.reason === 'missing-file') return '缺失';
-  if (check.reason === 'missing-generated-marker') return '未受管';
-  if (check.reason === 'checksum-drift') return '漂移';
-  return '失败';
-}
-
-function printDoctorResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  console.log(`OpenPrd doctor: ${result.ok ? '通过' : '失败'}`);
-  console.log(`项目: ${result.projectRoot}`);
-  console.log(`工具: ${result.tools.join(', ')}`);
-  if (result.agentIntegration.hookProfile) {
-    console.log(`Hook 模式: ${result.agentIntegration.hookProfile}`);
-  }
-  console.log(`标准化: ${result.standards.ok ? '通过' : '失败'}`);
-  console.log(`工作区验证: ${result.validation.valid ? '通过' : '失败'}`);
-  if (result.agentIntegration.drift) {
-    console.log(`生成物漂移: ${result.agentIntegration.drift.ok ? '无' : '存在'}`);
-  }
-  console.log('Agent 集成检查:');
-  for (const check of result.agentIntegration.checks) {
-    const reason = !check.ok && check.reason ? ` (${check.reason})` : '';
-    console.log(`- ${doctorCheckLabel(check)}: ${check.path}${reason}`);
-    if (!check.ok && check.repairHint) {
-      console.log(`  修复建议: ${check.repairHint}`);
-    }
-  }
-  if (result.errors.length > 0) {
-    console.log('错误:');
-    for (const error of result.errors) {
-      console.log(`- ${error}`);
-    }
-  }
-}
-
-function printFleetResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  const mode = result.dryRun
-    ? 'dry-run'
-    : Object.entries(result.requestedActions)
-      .filter(([, enabled]) => enabled)
-      .map(([name]) => name)
-      .join(', ');
-  console.log(`OpenPrd fleet: ${result.ok ? '通过' : '需处理'}`);
-  console.log(`根目录: ${result.root}`);
-  console.log(`模式: ${mode || 'report'}`);
-  console.log(`最大深度: ${result.maxDepth}`);
-  console.log(`项目: ${result.summary.total}`);
-  console.log(`- OpenPrd: ${result.summary.openprd}`);
-  console.log(`- Agent-only: ${result.summary.agentConfigured}`);
-  console.log(`- Plain: ${result.summary.plain}`);
-  console.log(`结果: 计划 ${result.summary.planned}，已更新 ${result.summary.updated}，已接入 ${result.summary.setup}，已检查 ${result.summary.doctored}，已补身份 ${result.summary.backfilled}，已同步 registry ${result.summary.synced}，失败 ${result.summary.failed}，跳过 ${result.summary.skipped}`);
-  if (result.registry) {
-    console.log(`全局 registry: 已知 ${result.registry.knownTotal}，当前 root 命中 ${result.registry.scopedKnown}，root 外 ${result.registry.outsideRoot}，失效 ${result.registry.stale}`);
-  }
-  if ((result.summary.healthAttention ?? 0) > 0) {
-    console.log(`项目健康: ${result.summary.healthAttention} 个需关注（已报告，不阻断本次更新）`);
-  }
-
-  const visibleProjects = result.projects
-    .filter((project) => project.category !== 'plain-project' || project.status === 'failed' || (project.healthErrors?.length ?? 0) > 0)
-    .slice(0, 50);
-  if (visibleProjects.length > 0) {
-    console.log('项目明细:');
-    for (const project of visibleProjects) {
-      console.log(`- ${project.status}: ${project.relativePath} (${project.category}) -> ${project.plannedAction}`);
-      if (project.workUnits) {
-        console.log(`  工作单元: ${project.workUnits.changedVersions}/${project.workUnits.totalVersions} 个历史版本已覆盖或计划覆盖`);
-      }
-      for (const error of project.errors.slice(0, 3)) {
-        console.log(`  错误: ${error}`);
-      }
-      for (const error of (project.healthErrors ?? []).slice(0, 3)) {
-        console.log(`  需关注: ${error}`);
-      }
-    }
-  }
-  const hiddenCount = result.projects.length - visibleProjects.length;
-  if (hiddenCount > 0) {
-    console.log(`还有 ${hiddenCount} 个 plain/skipped 项目未展开；使用 --json 查看完整明细。`);
-  }
-  if (result.reportPath) {
-    console.log(`报告: ${result.reportPath}`);
-  }
-}
-
-function printSelfUpdateResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  const status = result.dryRun
-    ? '预演'
-    : result.ok
-      ? '完成'
-      : result.skipped
-        ? '已跳过'
-        : '失败';
-  console.log(`OpenPrd self-update: ${status}`);
-  console.log(`当前版本: ${result.package?.version ?? 'unknown'}`);
-  console.log(`安装源: ${result.source}`);
-  console.log(`计划命令: ${result.installCommand.display}`);
-  if (result.localCheckout) {
-    console.log('运行环境: 本地源码 checkout');
-  }
-  if (result.dryRun) {
-    console.log('dry-run: 未修改 CLI、项目或 registry。');
-  }
-  if (result.result) {
-    console.log(`安装退出码: ${result.result.exitCode}`);
-  }
-  if (result.resolvedExecutable?.executable) {
-    console.log(`OpenPrd 可执行文件: ${result.resolvedExecutable.executable}`);
-  }
-  for (const action of result.nextActions ?? []) {
-    console.log(`下一步: ${action}`);
-  }
-  for (const error of result.errors ?? []) {
-    console.log(`错误: ${error}`);
-  }
-}
-
-function printUpgradeResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  console.log(`OpenPrd upgrade: ${result.dryRun ? '预演' : result.ok ? '完成' : '失败'}`);
-  console.log(`模式: ${result.mode === 'fleet' ? '历史项目批量刷新' : '单项目刷新'}`);
-  console.log(`目标: ${result.targetPath}`);
-  console.log(`阶段 self-update: ${result.stages.selfUpdateOk ? '通过' : '失败'}`);
-  console.log(`阶段 project-refresh: ${result.stages.projectRefreshOk ? '通过' : result.projectRefresh.skipped ? '跳过' : '失败'}`);
-  console.log(`self-update 命令: ${result.selfUpdate.installCommand.display}`);
-  console.log(`项目刷新命令: ${result.projectRefresh.command.display}`);
-  if (result.dryRun) {
-    console.log('dry-run: 未执行工具更新，也未刷新项目。');
-  }
-  if (result.selfUpdate.result) {
-    console.log(`self-update 退出码: ${result.selfUpdate.result.exitCode}`);
-  }
-  if (result.projectRefresh.result) {
-    console.log(`project-refresh 退出码: ${result.projectRefresh.result.exitCode}`);
-  }
-  for (const error of result.errors ?? []) {
-    console.log(`错误: ${error}`);
-  }
-}
-
-function printKnowledgeReview(knowledgeReview) {
-  if (!knowledgeReview) {
-    return;
-  }
-  if (knowledgeReview.skipped) {
-    console.log(`项目经验回顾: 已跳过 (${knowledgeReview.reason})`);
-    return;
-  }
-  if (knowledgeReview.ok === false) {
-    console.log(`项目经验回顾: 失败 (${knowledgeReview.errors?.[0] ?? 'unknown'})`);
-    return;
-  }
-  console.log(`项目经验草案: ${knowledgeReview.candidateId}`);
-  if (knowledgeReview.summary) {
-    console.log(`摘要: ${knowledgeReview.summary}`);
-  }
-  if (Array.isArray(knowledgeReview.categories) && knowledgeReview.categories.length > 0) {
-    console.log(`类别: ${knowledgeReview.categories.join(', ')}`);
-  }
-  if (knowledgeReview.files?.draftSkill) {
-    console.log(`Draft Skill: ${knowledgeReview.files.draftSkill}`);
-  }
-  if (knowledgeReview.files?.candidateDir) {
-    console.log(`诊断候选: ${knowledgeReview.files.candidateDir}`);
-  }
-  if (knowledgeReview.suggestedLearnCommand) {
-    console.log(`Promote: ${knowledgeReview.suggestedLearnCommand}`);
-  }
-}
-
-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 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}`);
-    }
-    printKnowledgeReview(result.knowledgeReview);
-    if (result.warnings.length > 0) {
-      console.log('工作区待关注:');
-      for (const warning of result.warnings) {
-        console.log(`- ${warning}`);
-      }
-    }
-    if (result.errors.length > 0) {
-      console.log('错误:');
-      for (const error of result.errors) {
-        console.log(`- ${error}`);
-      }
-    }
-    return;
-  }
-
-  console.log('OpenPrd 运行上下文');
-  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) {
-    console.log(`当前需求入口: ${result.activeRequirementGate.status ?? 'active'}`);
-  }
-  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}`);
-  }
-  console.log(`下一步类型: ${result.recommendation.type}`);
-  console.log(`下一步: ${result.recommendation.title}`);
-  console.log(`原因: ${result.recommendation.reason}`);
-  console.log(`建议只读命令: ${result.recommendation.command}`);
-  if (result.recommendation.preparationCommand || result.recommendation.executionCommand || result.recommendation.commitCommand) {
-    console.log('执行门槛: 仅当用户当前明确要求开发、实现、继续任务、深度调研、深度对标、复刻落地或提交时使用；规划、梳理、分析、审查类请求保持只读。');
-  }
-  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('工作区建议: 使用独立 worktree 或等价隔离环境承接单任务 Loop。');
-  }
-  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.finish?.commit) {
-      console.log(`提交: ${result.finish.commit.skipped ? '跳过' : result.finish.commit.sha}`);
-    }
-    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.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.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}`);
-  }
-}
-
-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 dev-check: ${result.ok ? '完成' : '失败'}`);
-  console.log(`阈值: ≤${result.thresholds.okMax} 行 ok，${result.thresholds.okMax + 1}-${result.thresholds.attentionMax} 行需注意，>${result.thresholds.warningAbove} 行警告。`);
-  for (const file of result.files) {
-    const lineText = file.lineCount === null || file.lineCount === undefined ? '未知行数' : `${file.lineCount} 行`;
-    console.log(`- ${file.status}: ${file.path} (${lineText})`);
-    console.log(`  ${file.nextAction}`);
-  }
-  printKnowledgeReview(result.knowledgeReview);
-  for (const error of result.errors ?? []) {
-    console.log(`- ${error}`);
-  }
-}
-
-function growthCandidateStatusLabel(status) {
-  if (status === 'applied') return '已应用';
-  if (status === 'rejected') return '已拒绝';
-  return '待确认';
-}
-
-function growthCandidateApplyModeLabel(candidate) {
-  if (candidate.applyMode === 'auto') return '自动补齐';
-  if (candidate.applyMode === 'manual') return '手动采纳';
-  return '未应用';
-}
-
-function growthCandidateScopeLabel(scope) {
-  if (scope === 'user-local') return '当前用户本地偏好';
-  if (scope === 'openprd-core') return 'OpenPrd 核心规则';
-  return '项目共享规则';
-}
-
-function formatGrowthConfidence(confidence) {
-  if (typeof confidence !== 'number' || Number.isNaN(confidence)) {
-    return '未提供';
-  }
-  return `${Math.round(confidence * 100)}%`;
-}
-
-function describeGrowthCandidateImpact(candidate) {
-  if (candidate.type === 'code-extension') {
-    return `会把匹配 ${candidate.key} 的文件纳入代码文件识别，减少后续同类 dev-check 重复提醒。`;
-  }
-  if (candidate.type === 'exempt-path-segment') {
-    return `会把路径片段 ${candidate.key} 加入代码行数规则豁免，影响对应目录下文件的 dev-check 判断。`;
-  }
-  if (candidate.type === 'exempt-file-pattern') {
-    return `会把文件模式 ${candidate.key} 加入代码行数规则豁免，影响命中的文件。`;
-  }
-  if (candidate.type === 'user-preference') {
-    return `会把偏好 ${candidate.key} 写入当前用户本地配置，不进入项目共享规则。`;
-  }
-  if (candidate.scope === 'openprd-core') {
-    return '采纳后会进入 OpenPrd 核心规则，请确认是否值得作为跨项目默认行为。';
-  }
-  return `采纳后会写入${growthCandidateScopeLabel(candidate.scope)}，请确认这是否是你想要固化的范围。`;
-}
-
-function formatGrowthEvidenceItem(item = {}) {
-  if (typeof item === 'string') {
-    return item;
-  }
-  const parts = [];
-  if (item.path) {
-    parts.push(String(item.path));
-  }
-  if (item.lineCount !== null && item.lineCount !== undefined) {
-    parts.push(`${item.lineCount} 行`);
-  }
-  if (item.reason) {
-    parts.push(`原因: ${item.reason}`);
-  }
-  if (item.note) {
-    parts.push(`说明: ${item.note}`);
-  }
-  return parts.length > 0 ? parts.join('；') : JSON.stringify(item);
-}
-
-function formatGrowthSuggestedPatch(patch) {
-  if (!patch) {
-    return '未提供';
-  }
-  if (typeof patch === 'string') {
-    return patch;
-  }
-  const file = patch.file ? String(patch.file) : 'unknown-file';
-  const pathText = patch.path ? String(patch.path) : 'unknown-path';
-  const op = patch.op ? String(patch.op) : 'update';
-  const value = patch.value === undefined ? '' : ` ${JSON.stringify(patch.value)}`;
-  return `${file} -> ${pathText} ${op}${value}`.trim();
-}
-
-function printGrowthResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  if (result.action === 'growth-init') {
-    console.log('OpenPrd growth: 已初始化');
-    console.log(`候选队列: ${result.files.candidates}`);
-    return;
-  }
-
-  console.log(`OpenPrd growth: ${result.ok ? '完成' : '失败'}`);
-  if (result.summary) {
-    console.log(`候选: ${result.summary.pending} 待确认，${result.summary.applied} 已应用，${result.summary.rejected} 已拒绝。`);
-  }
-  const candidates = result.pending ?? (result.candidate ? [result.candidate] : []);
-  for (const candidate of candidates) {
-    console.log(`- ${candidate.id}: ${candidate.title}`);
-    console.log(`  状态: ${growthCandidateStatusLabel(candidate.status)}`);
-    console.log(`  作用范围: ${growthCandidateScopeLabel(candidate.scope)}`);
-    if (candidate.status === 'applied') {
-      console.log(`  应用方式: ${growthCandidateApplyModeLabel(candidate)}`);
-    }
-    console.log(`  置信度: ${formatGrowthConfidence(candidate.confidence)}`);
-    if (candidate.summary) {
-      console.log(`  摘要: ${candidate.summary}`);
-    }
-    console.log(`  采纳影响: ${describeGrowthCandidateImpact(candidate)}`);
-    if ((candidate.evidence ?? []).length > 0) {
-      console.log('  证据:');
-      for (const evidence of candidate.evidence) {
-        console.log(`    - ${formatGrowthEvidenceItem(evidence)}`);
-      }
-    }
-    if (candidate.suggestedPatch) {
-      console.log('  拟写入:');
-      console.log(`    - ${formatGrowthSuggestedPatch(candidate.suggestedPatch)}`);
-    }
-    if (candidate.status === 'pending') {
-      console.log(`  收工复盘采纳命令: openprd grow . --apply --id ${candidate.id}`);
-      console.log(`  拒绝命令: openprd grow . --reject --id ${candidate.id}`);
-    }
-  }
-  for (const change of result.changed ?? []) {
-    console.log(`- 已更新: ${change}`);
-  }
-  const shouldSkipNextActions = candidates.some((candidate) => candidate.status === 'pending');
-  for (const action of shouldSkipNextActions ? [] : (result.nextActions ?? [])) {
-    console.log(`- 下一步: ${action}`);
-  }
-  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;
-  }
-
-  console.log(`OpenPrd quality: ${result.ok ? '完成' : '失败'}`);
-  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(', ')}`);
-    }
-    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 printVisualCompareResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  console.log('OpenPrd visual compare: 已生成');
-  console.log(`输出图片: ${result.outputPath}`);
-  console.log(`格式: ${result.format}${result.quality ? `, quality=${result.quality}` : ''}`);
-  console.log(`画布: ${result.canvas.width}x${result.canvas.height}`);
-  console.log(`左侧: ${result.labels.reference} (${result.reference.rendered.width}x${result.reference.rendered.height})`);
-  console.log(`右侧: ${result.labels.actual} (${result.actual.rendered.width}x${result.actual.rendered.height})`);
-  for (const action of result.nextActions ?? []) {
-    console.log(`- 下一步: ${action}`);
-  }
-}
-
-function printFreezeResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  console.log(`已 freeze OpenPrd 工作区: ${result.ws.workspaceRoot}`);
-  console.log(`版本: ${result.snapshot.latestVersionId}`);
-  console.log(`Digest: ${result.snapshot.digest}`);
-  console.log(`状态文件: ${result.ws.paths.freezeState}`);
-}
-
-function printDiagramResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  if (result.snapshot) {
-    console.log(`已为 ${result.snapshot.title} 生成${result.type === 'product-flow' ? '产品流程' : '架构'}图`);
-  } else {
-    console.log(`已更新${result.type === 'product-flow' ? '产品流程' : '架构'}图`);
-  }
-  console.log(`HTML: ${result.htmlPath}`);
-  console.log(`JSON: ${result.jsonPath}`);
-  console.log(`Mermaid: ${result.mermaidPath}`);
-  if (result.inputPath) {
-    console.log(`输入 contract: ${result.inputPath}`);
-  }
-  if (result.marked) {
-    console.log(`评审状态: ${result.marked}`);
-  } else if (result.model?.metadata?.reviewStatus) {
-    console.log(`评审状态: ${result.model.metadata.reviewStatus}`);
-  }
-  console.log(`已打开: ${result.opened ? '是' : '否'}`);
-}
-
-function printHandoffResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  console.log(`交接包已写入: ${result.exportDir}`);
-  console.log(`目标: ${result.handoff.target}`);
-  console.log(`版本: ${result.handoff.versionId}`);
-  console.log(`Digest: ${result.handoff.digest}`);
-}
-
-function printOpenSpecDiscoveryResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  console.log(`OpenPrd discovery 运行: ${result.runId}`);
-  if (result.advanced) {
-    console.log(`已推进条目: ${result.advancedItem.id}`);
-    console.log(`条目状态: ${result.advancedItem.status}`);
-    if (result.claim) {
-      console.log(`Claim: ${result.claim.id}`);
-    }
-  }
-  if (result.verified) {
-    console.log(`验证: ${result.verification.valid ? '通过' : '失败'}`);
-    console.log(`完成: ${result.verification.complete ? '是' : '否'}`);
-    for (const check of result.verification.checks) {
-      console.log(`- ${check}`);
-    }
-    if (result.verification.errors.length > 0) {
-      console.log('错误:');
-      for (const error of result.verification.errors) {
-        console.log(`- ${error}`);
-      }
-    }
-    if (result.verification.warnings.length > 0) {
-      console.log('警告:');
-      for (const warning of result.verification.warnings) {
-        console.log(`- ${warning}`);
-      }
-    }
-  }
-  console.log(`是否恢复: ${result.resumed ? '是' : '否'}`);
-  console.log(`运行目录: ${result.runDir}`);
-  console.log(`模式: ${result.control.mode}`);
-  console.log(`状态: ${result.control.status}`);
-  console.log(`已索引来源文件: ${result.inventory.summary.files}`);
-  console.log(`覆盖待处理: ${result.coverageMatrix.summary.pending}/${result.coverageMatrix.summary.total}`);
-  console.log(`下一步动作: ${result.control.nextAction}`);
-}
-
-function printOpenSpecChangeValidationResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  console.log(`OpenPrd change 验证: ${result.valid ? '通过' : '失败'}`);
-  console.log(`Change: ${result.changeId}`);
-  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}`);
-    }
-  }
-}
-
-function printOpenSpecGenerateResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  console.log(`已生成 OpenPrd change: ${result.changeId}`);
-  console.log(`Capability: ${result.capability}`);
-  console.log(`任务数: ${result.taskCount}`);
-  console.log(`验证: ${result.validation.valid ? '通过' : '失败'}`);
-  console.log('文件:');
-  for (const file of result.files) {
-    console.log(`- ${file}`);
-  }
-  if (result.validation.errors.length > 0) {
-    console.log('错误:');
-    for (const error of result.validation.errors) {
-      console.log(`- ${error}`);
-    }
-  }
-}
-
-function printOpenSpecTaskResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  console.log(`OpenPrd 任务: ${result.changeId}`);
-  if (result.action === 'list') {
-    console.log(`进度: ${result.summary.completed}/${result.summary.total} 已完成，${result.summary.pending} 待处理，${result.summary.blocked} 阻塞`);
-    if (result.summary.implementation) {
-      console.log(`实质实现任务: ${result.summary.implementation.completed}/${result.summary.implementation.total} 已完成，${result.summary.implementation.pending} 待处理`);
-    }
-    if (result.nextTask) {
-      console.log(`下一任务: ${result.nextTask.id} ${result.nextTask.title}`);
-      console.log(`验证命令: ${result.nextTask.metadata.verify}`);
-    } else {
-      console.log('下一任务: 无');
-    }
-    if (result.blockedTasks.length > 0) {
-      console.log('阻塞任务:');
-      for (const task of result.blockedTasks.slice(0, 10)) {
-        console.log(`- ${task.id}: ${[...task.missing, ...task.incomplete].join(', ')}`);
-      }
-    }
-    return;
-  }
-
-  console.log(`任务: ${result.task.id} ${result.task.title}`);
-  if (result.verification) {
-    console.log(`验证: ${result.verification.ok ? '通过' : '失败'} (${result.verification.command})`);
-    if (!result.verification.ok && result.verification.stderr) {
-      console.log(result.verification.stderr.trim());
-    }
-  }
-  if (result.action === 'advance') {
-    console.log(`已推进: ${result.advanced ? '是' : '否'}`);
-    if (result.summary) {
-      console.log(`进度: ${result.summary.completed}/${result.summary.total} 已完成`);
-    }
-    if (result.nextTask) {
-      console.log(`下一任务: ${result.nextTask.id} ${result.nextTask.title}`);
-    }
-  }
-}
-
-function printOpenPrdChangesResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  console.log(`OpenPrd changes: ${result.changes.length}`);
-  console.log(`当前激活 change: ${result.activeChange ?? '无'}`);
-  for (const change of result.changes) {
-    const marker = change.active ? '*' : '-';
-    console.log(`${marker} ${change.id} | ${change.status} | ${change.source} | 任务 ${change.taskTotal - change.taskIncomplete}/${change.taskTotal}`);
-  }
-}
-
-function printOpenPrdChangeActionResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  console.log(`OpenPrd change ${result.action}: ${result.changeId}`);
-  if (result.action === 'apply') {
-    console.log(`已应用: ${result.ok ? '是' : '否'}`);
-    if (result.appliedSpecs?.length > 0) {
-      console.log('已接受 specs:');
-      for (const spec of result.appliedSpecs) {
-        console.log(`- ${spec.capability}: ${spec.specPath}`);
-      }
-    }
-    if (result.errors?.length > 0) {
-      console.log('错误:');
-      for (const error of result.errors) {
-        console.log(`- ${error}`);
-      }
-    }
-  }
-  if (result.action === 'archive') {
-    console.log(`归档目录: ${result.archiveDir}`);
-    console.log(`已移除来源: ${result.removedSource ? '是' : '否'}`);
-  }
-  if (result.action === 'activate') {
-    console.log(`当前激活 change: ${result.changeId}`);
-  }
-}
-
-function printAcceptedSpecsResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  console.log(`已接受 specs: ${result.specs.length}`);
-  for (const spec of result.specs) {
-    const source = spec.metadata?.sourceChange ? ` 来自 ${spec.metadata.sourceChange}` : '';
-    console.log(`- ${spec.capability}${source}: ${spec.specPath}`);
-  }
-  console.log(`已应用 changes: ${result.appliedChanges.length}`);
-}
-
-function printBenchmarkResult(result, json) {
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  if (result.action === 'benchmark-add') {
-    console.log(`OpenPrd benchmark add: ${result.ok ? '已加入 candidate' : '失败'}`);
-    if (result.source) {
-      console.log(`ID: ${result.source.id}`);
-      console.log(`标题: ${result.source.title}`);
-      console.log(`来源: ${result.source.url ?? result.source.path ?? 'unknown'}`);
-      console.log(`场景: ${result.source.scenarios.join(', ') || '未分类'}`);
-    }
-    if (result.error) {
-      console.log(`错误: ${result.error}`);
-    }
-    return;
-  }
-
-  if (result.action === 'benchmark-approve') {
-    console.log('OpenPrd benchmark approve: 已加入 approved registry');
-    console.log(`ID: ${result.source.id}`);
-    console.log(`标题: ${result.source.title}`);
-    console.log(`已批准来源: ${result.counts.approved}`);
-    console.log(`待确认来源: ${result.counts.candidates}`);
-    return;
-  }
-
-  if (result.action === 'benchmark-verify') {
-    console.log(`OpenPrd benchmark verify: ${result.ok ? '通过' : '失败'}`);
-    for (const check of result.checks) {
-      console.log(`- ${check.ok ? '通过' : '失败'}: ${check.id}`);
-      for (const issue of check.issues) {
-        console.log(`  ${issue.level === 'error' ? '错误' : '警告'}: ${issue.message}`);
-      }
-    }
-    return;
-  }
-
-  console.log(`OpenPrd benchmark list: approved ${result.counts.approved}, candidate ${result.counts.candidates}`);
-  for (const source of result.approved) {
-    console.log(`- approved ${source.id}: ${source.title}`);
-  }
-  for (const source of result.candidates) {
-    console.log(`- candidate ${source.id}: ${source.title}`);
-  }
-}
-
+/*
+ * 核心功能
+ * 汇总 OpenPrd CLI 各子模块的终端输出函数，并保持对外 named exports 稳定。
+ *
+ * 输入
+ * 接收各 CLI 子模块导出的打印函数集合。
+ *
+ * 输出
+ * 作为统一 barrel 对外导出基础、工作流、诊断、运行、质量、growth、change 与 benchmark 输出函数。
+ *
+ * 定位
+ * 位于 CLI 表现层的汇总入口，不再承载具体格式化逻辑。
+ *
+ * 依赖
+ * 依赖同目录下的分域 print 模块。
+ *
+ * 维护规则
+ * 新增打印函数时优先放入对应子模块，再由这里补充导出，避免 barrel 重新膨胀。
+ */
+import {
+  printCaptureResult,
+  printClarifyResult,
+  printClassifyResult,
+  printInitResult,
+  printInterviewResult,
+  printLearningResult,
+  printPlaygroundResult,
+  printReleaseResult,
+  printStatus,
+  printValidation,
+} from './basic-print.js';
+import { printBenchmarkResult } from './benchmark-print.js';
+import {
+  printAcceptedSpecsResult,
+  printOpenPrdChangeActionResult,
+  printOpenPrdChangesResult,
+  printOpenSpecChangeValidationResult,
+  printOpenSpecDiscoveryResult,
+  printOpenSpecGenerateResult,
+  printOpenSpecTaskResult,
+} from './change-print.js';
+import {
+  printAgentIntegrationResult,
+  printDoctorResult,
+  printFleetResult,
+  printSelfUpdateResult,
+  printUpgradeResult,
+} from './doctor-print.js';
+import { printGrowthResult } from './growth-print.js';
+import {
+  printDevelopmentStandardsResult,
+  printKnowledgeResult,
+  printQualityResult,
+  printStandardsResult,
+  printVisualCompareResult,
+} from './quality-print.js';
+import {
+  printLoopResult,
+  printRunResult,
+} from './run-print.js';
+import {
+  printDiagramResult,
+  printDiffResult,
+  printFreezeResult,
+  printHandoffResult,
+  printHistoryResult,
+  printNextResult,
+  printReviewResult,
+  printSynthesizeResult,
+} from './workflow-print.js';
 
 export {
   printValidation,
@@ -1391,6 +78,7 @@ export {
   printInterviewResult,
   printPlaygroundResult,
   printLearningResult,
+  printReleaseResult,
   printSynthesizeResult,
   printReviewResult,
   printHistoryResult,
@@ -1408,6 +96,7 @@ export {
   printDevelopmentStandardsResult,
   printGrowthResult,
   printQualityResult,
+  printKnowledgeResult,
   printVisualCompareResult,
   printFreezeResult,
   printDiagramResult,
@@ -1419,5 +108,5 @@ export {
   printOpenPrdChangesResult,
   printOpenPrdChangeActionResult,
   printAcceptedSpecsResult,
-  printBenchmarkResult
+  printBenchmarkResult,
 };