@openprd/cli 0.1.1 → 0.1.8

package/src/cli/doctor-print.js

@@ -0,0 +1,268 @@
+/*
+ * 核心功能
+ * 渲染 agent integration、doctor、fleet、self-update 和 upgrade 等诊断类命令输出。
+ *
+ * 输入
+ * 接收诊断、迁移、工具健康、自更新和批量项目扫描等结构化结果对象。
+ *
+ * 输出
+ * 向终端输出诊断结论、修复建议和批量处理摘要，或在 `--json` 模式下直出 JSON。
+ *
+ * 定位
+ * 位于 CLI 表现层的诊断输出模块，负责工具链和项目健康相关的终端呈现。
+ *
+ * 依赖
+ * 仅依赖终端输出和诊断 result 契约，不承担修复执行。
+ *
+ * 维护规则
+ * 诊断类输出新增字段时要保持错误、建议和命令展示顺序稳定，避免隐藏关键信息。
+ */
+import { printOptionalCapabilitySuggestions } from './shared-print.js';
+
+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}`);
+    }
+  }
+  printOptionalCapabilitySuggestions(result.optionalCapabilities ?? result.doctor?.optionalCapabilities);
+}
+
+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 printCodexRuntimeResult(codexRuntime, prefix = '') {
+  if (!codexRuntime) {
+    return;
+  }
+  const health = codexRuntime.preflight;
+  console.log(`${prefix}Codex CLI 健康检查: ${codexRuntime.ok ? '通过' : '失败'}`);
+  if (health?.command?.display) {
+    console.log(`${prefix}检查命令: ${health.command.display}`);
+  }
+  if (health?.version) {
+    console.log(`${prefix}Codex 版本: ${health.version}`);
+  }
+  if (health?.diagnostic) {
+    console.log(`${prefix}诊断: ${health.diagnostic.summary}`);
+    if (health.diagnostic.missingPackage) {
+      console.log(`${prefix}缺失组件: ${health.diagnostic.missingPackage}`);
+    }
+    console.log(`${prefix}修复命令: ${health.diagnostic.manualCommand}`);
+  }
+  if (codexRuntime.repairAttempted) {
+    console.log(`${prefix}显式修复: ${codexRuntime.repair?.ok ? '通过' : '失败'}`);
+    if (codexRuntime.repair?.command?.display) {
+      console.log(`${prefix}修复执行: ${codexRuntime.repair.command.display}`);
+    }
+    if (codexRuntime.repair?.result) {
+      console.log(`${prefix}修复退出码: ${codexRuntime.repair.result.exitCode ?? 'unknown'}`);
+    }
+    if (codexRuntime.repair?.recheck?.version) {
+      console.log(`${prefix}复查版本: ${codexRuntime.repair.recheck.version}`);
+    }
+  } else if (health?.diagnostic && health?.repairCommand?.display) {
+    console.log(`${prefix}提示: OpenPrd 默认不会静默安装全局依赖；需要显式运行 openprd doctor . --tools codex --fix 或 openprd loop . --run --agent codex --repair-agent。`);
+  }
+}
+
+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 ? '无' : '存在'}`);
+  }
+  printCodexRuntimeResult(result.codexRuntime);
+  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}`);
+    }
+  }
+  printOptionalCapabilitySuggestions(result.agentIntegration.optionalCapabilities);
+}
+
+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}`);
+  }
+}
+
+export {
+  printAgentIntegrationResult,
+  printCodexRuntimeResult,
+  printDoctorResult,
+  printFleetResult,
+  printSelfUpdateResult,
+  printUpgradeResult,
+};

package/src/cli/growth-print.js

@@ -0,0 +1,176 @@
+/*
+ * 核心功能
+ * 渲染 growth 候选、自动补齐和 benchmark 推荐相关的人类可读输出。
+ *
+ * 输入
+ * 接收 growth init/review/apply/reject 等结构化结果对象和候选元数据。
+ *
+ * 输出
+ * 向终端输出候选状态、证据、拟写入内容和 benchmark 推荐摘要，或在 `--json` 模式下直出 JSON。
+ *
+ * 定位
+ * 位于 CLI 表现层的 growth 输出模块，专门承接自我成长和规则固化反馈。
+ *
+ * 依赖
+ * 仅依赖终端输出和候选字段契约。
+ *
+ * 维护规则
+ * growth 输出要优先保留范围、置信度、采纳影响和拟写入内容，避免用户难以判断是否固化。
+ */
+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 printGrowthLedger(ledger) {
+  if (!ledger?.summary) {
+    return;
+  }
+  const summary = ledger.summary;
+  console.log(`账本: events ${summary.eventCount ?? 0}，observe ${summary.observed}，pending ${summary.pendingObserved}，auto ${summary.autoApplied}，manual ${summary.manualApplied}，reconcile ${summary.reconciledAutoApplied}，checkpoint ${summary.completionCheckpoints ?? 0}，reject ${summary.rejected}，skip ${summary.skipped}`);
+  if (summary.current) {
+    console.log(`当前状态: ${summary.current.total} 个候选，${summary.current.pending} 待确认，${summary.current.applied} 已应用，${summary.current.rejected} 已拒绝`);
+  }
+  const skippedReasons = Object.entries(summary.skippedReasons ?? {});
+  if (skippedReasons.length > 0) {
+    console.log(`跳过原因: ${skippedReasons.map(([reason, count]) => `${reason}=${count}`).join('；')}`);
+  }
+}
+
+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}`);
+    printGrowthLedger(result.ledger);
+    return;
+  }
+
+  console.log(`OpenPrd growth: ${result.ok ? '完成' : '失败'}`);
+  if (result.summary) {
+    console.log(`候选: ${result.summary.pending} 待确认，${result.summary.applied} 已应用，${result.summary.rejected} 已拒绝。`);
+  }
+  printGrowthLedger(result.ledger);
+  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 recommendation of result.benchmarkRecommendations ?? []) {
+    console.log(`- Benchmark 推荐: ${recommendation.sourceKey} 最近 ${recommendation.windowDays} 天已采纳 ${recommendation.adoptedCount}/${recommendation.threshold} 次，累计 ${recommendation.totalAdoptedCount} 次；确认后运行 ${recommendation.approveCommand}`);
+  }
+  for (const error of result.errors ?? []) {
+    console.log(`- ${error}`);
+  }
+}
+
+export {
+  printGrowthResult,
+};