@openprd/cli 0.1.11 → 0.1.19

package/src/cli/args.js

@@ -19,7 +19,7 @@
  */
 function parseCommandArgs(argv) {
   const args = [...argv];
-  const flags = { json: false, force: false, fix: false, open: false, append: false, init: false, check: false, review: false, reject: false, resume: false, advance: false, verify: false, evidenceRequired: false, next: false, generate: false, validate: false, apply: false, archive: false, activate: false, close: false, keep: false, write: false, dryRun: false, repairAgent: false, allowDirtyMain: false, fleet: false, updateOpenprd: false, backfillWorkUnits: false, syncRegistry: false, setupMissing: false, doctor: false, context: false, recordHook: false, hookInject: false, plan: false, prompt: false, loopRun: false, finish: false, commit: false, html: false, template: false, failOnViolation: false, noExternalFacts: false, noBrandAssets: false, noRealImages: false, mark: null, type: 'architecture', mode: 'auto', input: null, field: null, value: null, set: null, jsonFile: null, artifactMarkdown: null, contentJson: null, presentation: null, source: null, reference: null, actual: null, before: null, after: null, board: null, grid: null, boxes: null, out: null, format: null, quality: null, maxPanelWidth: null, referenceLabel: null, actualLabel: null, classifyExternal: null, maxIterations: null, maxDepth: null, include: null, exclude: null, report: null, item: null, id: null, status: null, claim: null, notes: null, reason: null, confidence: null, threshold: null, change: null, starter: null, sections: null, brief: null, tools: 'all', hookProfile: null, templatePack: null, target: 'openprd', targetRoot: null, path: null, productType: null, title: null, owner: null, problem: null, whyNow: null, evidence: null, from: null, to: null, version: null, digest: null, workUnit: null, event: null, risk: null, outcome: null, preview: null, learn: null, genre: null, style: null, topic: null, enable: false, disable: false, agent: 'codex', agentCommand: null, worktree: null, branch: null, message: null };
+  const flags = { json: false, force: false, fix: false, open: false, append: false, init: false, check: false, review: false, reject: false, resume: false, advance: false, verify: false, evidenceRequired: false, next: false, generate: false, validate: false, apply: false, archive: false, activate: false, close: false, keep: false, write: false, dryRun: false, repairAgent: false, allowDirtyMain: false, fleet: false, updateOpenprd: false, backfillWorkUnits: false, syncRegistry: false, setupMissing: false, doctor: false, context: false, recordHook: false, hookInject: false, plan: false, prompt: false, loopRun: false, finish: false, commit: false, html: false, template: false, failOnViolation: false, noExternalFacts: false, noBrandAssets: false, noRealImages: false, daemon: false, stop: false, bridgeOutbox: false, bridgeSent: false, bridgeFailed: false, mark: null, direction: null, autoRefactor: null, type: 'architecture', mode: 'auto', input: null, field: null, value: null, set: null, jsonFile: null, artifactMarkdown: null, contentJson: null, presentation: null, source: null, reference: null, actual: null, before: null, after: null, board: null, grid: null, boxes: null, out: null, format: null, quality: null, maxPanelWidth: null, referenceLabel: null, actualLabel: null, locale: null, classifyExternal: null, maxIterations: null, maxDepth: null, include: null, exclude: null, report: null, item: null, id: null, status: null, claim: null, notes: null, reason: null, confidence: null, threshold: null, change: null, starter: null, sections: null, brief: null, tools: 'all', hookProfile: null, templatePack: null, target: 'openprd', targetRoot: null, path: null, productType: null, title: null, owner: null, problem: null, whyNow: null, evidence: null, from: null, to: null, version: null, digest: null, workUnit: null, event: null, risk: null, outcome: null, preview: null, learn: null, genre: null, style: null, topic: null, enable: false, disable: false, agent: 'codex', agentCommand: null, worktree: null, branch: null, message: null, thread: null, threadTitle: null, conversationTitle: null, session: null, sessionTitle: null, host: null, port: null, openTarget: 'auto' };
   const positionals = [];
 
   while (args.length > 0) {
@@ -116,6 +116,26 @@ function parseCommandArgs(argv) {
       flags.dryRun = true;
       continue;
     }
+    if (arg === '--daemon' || arg === '--background' || arg === '--persist') {
+      flags.daemon = true;
+      continue;
+    }
+    if (arg === '--stop') {
+      flags.stop = true;
+      continue;
+    }
+    if (arg === '--bridge-outbox') {
+      flags.bridgeOutbox = true;
+      continue;
+    }
+    if (arg === '--bridge-sent') {
+      flags.bridgeSent = true;
+      continue;
+    }
+    if (arg === '--bridge-failed') {
+      flags.bridgeFailed = true;
+      continue;
+    }
     if (arg === '--repair-agent') {
       flags.repairAgent = true;
       continue;
@@ -224,6 +244,36 @@ function parseCommandArgs(argv) {
       flags.agentCommand = args.shift() ?? null;
       continue;
     }
+    if (arg === '--thread' || arg === '--thread-id' || arg === '--conversation' || arg === '--conversation-id') {
+      flags.thread = args.shift() ?? null;
+      continue;
+    }
+    if (arg === '--thread-title' || arg === '--conversation-title' || arg === '--conversation-name') {
+      const value = args.shift() ?? null;
+      flags.threadTitle = value;
+      flags.conversationTitle = value;
+      continue;
+    }
+    if (arg === '--session' || arg === '--session-id') {
+      flags.session = args.shift() ?? null;
+      continue;
+    }
+    if (arg === '--session-title' || arg === '--session-name') {
+      flags.sessionTitle = args.shift() ?? null;
+      continue;
+    }
+    if (arg === '--host') {
+      flags.host = args.shift() ?? null;
+      continue;
+    }
+    if (arg === '--port') {
+      flags.port = args.shift() ?? null;
+      continue;
+    }
+    if (arg === '--open-target') {
+      flags.openTarget = args.shift() ?? 'auto';
+      continue;
+    }
     if (arg === '--worktree') {
       flags.worktree = args.shift() ?? null;
       continue;
@@ -332,6 +382,10 @@ function parseCommandArgs(argv) {
       flags.actualLabel = args.shift() ?? null;
       continue;
     }
+    if (arg === '--locale' || arg === '--lang') {
+      flags.locale = args.shift() ?? null;
+      continue;
+    }
     if (arg === '--classify-external') {
       flags.classifyExternal = args.shift() ?? '';
       continue;
@@ -488,6 +542,14 @@ function parseCommandArgs(argv) {
       flags.digest = args.shift() ?? null;
       continue;
     }
+    if (arg === '--direction') {
+      flags.direction = args.shift() ?? null;
+      continue;
+    }
+    if (arg === '--auto-refactor') {
+      flags.autoRefactor = args.shift() ?? null;
+      continue;
+    }
     if (arg === '--work-unit' || arg === '--work-unit-id') {
       flags.workUnit = args.shift() ?? null;
       continue;
@@ -528,6 +590,9 @@ function usage() {
     '  openprd fleet <root> [--dry-run|--doctor|--update-openprd|--backfill-work-units|--sync-registry|--setup-missing] [--hook-profile <lite|guarded|full>] [--max-depth <n>] [--include <csv>] [--exclude <csv>] [--report <file>] [--json]',
     '  openprd run [path] [--context|--verify|--record-hook --event <name> --risk <level> --outcome <text> --preview <text>] [--message <text>] [--json]',
     '  openprd loop [path] [--init|--plan|--next|--prompt|--run|--verify|--finish] [--change <id>] [--item <task-id-or-handle>] [--agent <codex|claude>] [--agent-command <cmd>] [--repair-agent] [--worktree <path>] [--branch <name>] [--allow-dirty-main] [--commit] [--dry-run] [--message <text>] [--json]',
+    '  openprd canvas [path] [--thread <id> [--thread-title <name>]|--session <id> [--session-title <name>]] [--host <host>] [--port <number>] [--daemon|--stop] [--open] [--open-target <auto|system|codex-browser>] [--dry-run] [--json]',
+    '  openprd canvas [path] --bridge-outbox [--thread <id>|--session <id>] [--claim <next|id>] [--json]',
+    '  openprd canvas [path] (--bridge-sent|--bridge-failed) --id <bridge-id> [--thread <id>|--session <id>] [--reason <text>] [--json]',
     '  openprd classify [path] <consumer|b2b|agent>',
     '  openprd clarify [path] [--mode <auto|inline|inline-with-checklist>] [--json]',
     '  openprd capture [path] (--field <section.path> --value <text|json> | --json-file <answers.json> | --artifact-markdown <artifact.md>) [--source <user-confirmed|project-derived|agent-inferred|agent-normalized>] [--append] [--json]',
@@ -538,15 +603,18 @@ function usage() {
     '  openprd quality [path] [--init|--verify|--report --html|--learn [--review] --from <report-id-or-json-or-diagnostics-or-turn-state>] [--force] [--json]',
     '  openprd knowledge <candidates|reject|archive|restore> [path-or-id] [--status <pending-review|all|rejected|archived|promoted|merged>] [--id <candidate-id>] [--reason <text>] [--json]',
     '  openprd visual-prepare [path] --reference <effect-image> ((--grid <columns>x<rows>) | (--boxes <plan.json>)) [--include <csv>] [--id <reference-set-id>] [--title <text>] [--out <dir>] [--json]',
-    '  openprd visual-compare [path] ((--reference <effect-image> --actual <screenshot-image>) | (--before <before-screenshot> --after <after-screenshot>) | --board <board.json>) [--out <file.jpg>] [--format <jpg|png|webp>] [--quality <1..100>] [--max-panel-width <px>] [--json]',
+    '  openprd visual-compare [path] ((--reference <effect-image> --actual <screenshot-image>) | (--before <before-screenshot> --after <after-screenshot>) | --board <board.json>) [--out <file.jpg>] [--format <jpg|png|webp>] [--quality <1..100>] [--max-panel-width <px>] [--locale <zh-CN|en>] [--json]',
+    '    --board modes: focus-board, parallel-board, verification-board, alignment-board, centering-board',
     '  openprd design-starter [path] [--starter <content-home|product-launch|ops-dashboard>] [--out <index.html>] [--title <name>] [--brief <text>] [--sections <a|b|c>] [--no-external-facts] [--no-brand-assets] [--no-real-images] [--force] [--json]',
-    '  openprd dev-check [path] <file...> [--json]',
+    '  openprd dev-check [path] <file...> [--auto-refactor <on|off>] [--json]',
     '  openprd grow [path] [--review|--apply --id <candidate-id>|--reject --id <candidate-id>|--init|--check] [--notes <text>] [--json]',
     '  openprd benchmark <add|observe|list|approve|verify> [target-or-id] [path-for-list-or-verify] [--path <project>] [--notes <text>] [--threshold <n>] [--id <benchmark-id>] [--json]',
     '  openprd synthesize [path] [--title <text>] [--owner <text>] [--problem <text>] [--why-now <text>] [--work-unit <id>] [--target-root <path>] [--open] [--json]',
-    '  openprd review [path] [--open] [--mark <pending-confirmation|confirmed|needs-revision>] [--version <id>] [--digest <sha256>] [--work-unit <id>] [--notes <text>] [--json]',
+    '  openprd review [path] [--open] [--mark <pending-confirmation|confirmed|needs-revision>] [--version <id>] [--digest <sha256>] [--work-unit <id>] [--direction <design-direction-id>] [--notes <text>] [--json]',
     '  openprd brainstorm-presentation [path] [--template] [--presentation <json>] [--write] [--fail-on-violation] [--json]',
     '  openprd review-presentation [path] [--template] [--version <id>] [--presentation <json>] [--write] [--fail-on-violation] [--json]',
+    '  openprd docs-compact [path] [--json]',
+    '  openprd guide [path] [--json]',
     '  openprd diagram [path] [--type <architecture|product-flow>] [--input <contract.json>] [--mark <pending-confirmation|confirmed|needs-revision>] [--open] [--json]',
     '  openprd diff [path] [--from <version>] [--to <version>]',
     '  openprd history [path]',

package/src/cli/basic-print.js

@@ -338,6 +338,9 @@ function printInitResult(result, json) {
 
   console.log(`已初始化 OpenPrd 工作区: ${result.ws.workspaceRoot}`);
   console.log(`场景模板: ${formatTemplatePackDisplay(result.currentState.templatePack, { fallback: '待确认' })}`);
+  if (result.templatePackGuidance?.message) {
+    console.log(`场景确认: ${result.templatePackGuidance.message}`);
+  }
   console.log(`已复制种子文件: ${result.created}`);
   if (result.standards) {
     console.log(`标准化文档: ${result.standards.docsRoot}`);

package/src/cli/canvas-print.js

@@ -0,0 +1,106 @@
+/*
+ * Core purpose
+ * Print user-facing output for `openprd canvas`.
+ *
+ * Inputs
+ * Receives the canvas workspace result.
+ *
+ * Outputs
+ * Emits either JSON or concise terminal text with the local URL, binding, and
+ * archive paths.
+ *
+ * Positioning
+ * CLI presentation layer only; all service and session logic stays in
+ * canvas-workspace.js.
+ *
+ * Maintenance rules
+ * Keep output copy user-facing. Do not expose internal API details unless the
+ * command is explicitly in JSON mode.
+ */
+import { toPrintableCanvasResult } from '../canvas-workspace.js';
+
+function printCanvasResult(result, asJson = false) {
+  const printable = toPrintableCanvasResult(result);
+  if (asJson) {
+    console.log(JSON.stringify(printable, null, 2));
+    return;
+  }
+
+  if (!printable?.ok) {
+    console.log('OpenPrd 画布启动失败。');
+    return;
+  }
+
+  if (printable.action === 'canvas-stop') {
+    console.log(printable.stopped ? 'OpenPrd 画布后台服务已停止。' : 'OpenPrd 画布后台服务未在运行。');
+    const stopBinding = printable.session?.binding ?? {};
+    console.log(`绑定: ${stopBinding.kind ?? 'session'} ${stopBinding.displayId ?? stopBinding.id ?? printable.session?.sessionKey}`);
+    console.log(`目录: ${printable.paths?.sessionDir}`);
+    return;
+  }
+
+  if (printable.action === 'canvas-agent-bridge') {
+    const binding = printable.session?.binding ?? {};
+    if (printable.bridgeAction === 'outbox') {
+      console.log(`待 Codex Agent 前台接力: ${printable.pending?.length ?? 0} 条。`);
+      if ((printable.pending?.length ?? 0) > 0) {
+        console.log('下一步: Agent 使用 --claim next 领取后，调用 Codex 线程工具发送，再用 --bridge-sent 回写。');
+      }
+    } else if (printable.bridgeAction === 'claim') {
+      console.log(printable.item ? '已认领一条 Codex 前台接力任务。' : '没有可认领的 Codex 前台接力任务。');
+      if (printable.item) {
+        console.log(`目标线程: ${printable.item.threadId}`);
+        console.log('下一步: 调用 codex_app.send_message_to_thread 发送返回的 prompt。');
+      }
+    } else if (printable.bridgeAction === 'sent') {
+      console.log('已标记 Codex 前台接力完成。');
+    } else if (printable.bridgeAction === 'failed') {
+      console.log('已标记 Codex 前台接力失败。');
+    }
+    console.log(`绑定: ${binding.kind ?? 'session'} ${binding.displayId ?? binding.id ?? printable.session?.sessionKey}`);
+    console.log(`目录: ${printable.paths?.sessionDir}`);
+    return;
+  }
+
+  if (printable.dryRun) {
+    console.log('OpenPrd 画布会话检查完成。');
+  } else if (printable.daemon && printable.alreadyRunning) {
+    console.log('OpenPrd 画布后台服务已在运行。');
+  } else if (printable.daemon) {
+    console.log('OpenPrd 画布后台服务已启动。');
+  } else {
+    console.log('OpenPrd 画布已启动。');
+  }
+  if (printable.url) {
+    console.log(`地址: ${printable.url}`);
+  }
+  if (printable.pid) {
+    console.log(`进程: ${printable.pid}`);
+  }
+  if (printable.logPath) {
+    console.log(`日志: ${printable.logPath}`);
+  }
+  if (printable.openResult) {
+    const labels = {
+      'codex-browser': 'Codex 右侧 Browser',
+      system: '系统默认浏览器',
+    };
+    const label = labels[printable.openResult.target] ?? printable.openResult.target;
+    console.log(`打开方式: ${label}`);
+    if (printable.openResult.status === 'requires-agent-browser') {
+      console.log('提醒: 当前命令不会打开系统浏览器；请由 Codex Agent 使用右侧 Browser 打开上面的地址。');
+    }
+  }
+  const binding = printable.session?.binding ?? {};
+  console.log(`绑定: ${binding.kind ?? 'session'} ${binding.displayId ?? binding.id ?? printable.session?.sessionKey}`);
+  console.log(`来源: ${binding.source ?? 'unknown'} (${binding.confidence ?? 'unknown'})`);
+  if (binding.note) {
+    console.log(`提醒: ${binding.note}`);
+  }
+  console.log(`目录: ${printable.paths?.sessionDir}`);
+  if (!printable.dryRun && !printable.daemon) {
+    console.log('保持该命令运行即可继续协同；结束时按 Ctrl+C。');
+  }
+}
+
+export { printCanvasResult };

package/src/cli/doctor-print.js

@@ -104,6 +104,25 @@ function printCodexRuntimeResult(codexRuntime, prefix = '') {
   }
 }
 
+function printRuntimeEnvironmentSummary(agentIntegration) {
+  const active = agentIntegration?.runtimeEnvironment?.active;
+  if (active?.activeClient && active.activeClient !== 'unknown') {
+    const confidence = typeof active.confidence === 'number' ? `，置信度 ${active.confidence}` : '';
+    const capabilities = Array.isArray(active.observedCapabilities) && active.observedCapabilities.length > 0
+      ? `，已观察能力 ${active.observedCapabilities.join(', ')}`
+      : '';
+    console.log(`当前 Agent 环境: ${active.activeClient}${active.surface ? ` / ${active.surface}` : ''}${confidence}${capabilities}`);
+  } else {
+    console.log('当前 Agent 环境: 未观察到当前会话 hook/session 证据');
+  }
+  const packs = Array.isArray(agentIntegration?.platformCapabilityPacks)
+    ? agentIntegration.platformCapabilityPacks
+    : [];
+  if (packs.length > 0) {
+    console.log(`平台能力包: ${packs.map((pack) => pack.name ?? pack.id).join('，')}`);
+  }
+}
+
 function printDoctorResult(result, json) {
   if (json) {
     console.log(JSON.stringify(result, null, 2));
@@ -116,6 +135,7 @@ function printDoctorResult(result, json) {
   if (result.agentIntegration.hookProfile) {
     console.log(`Hook 模式: ${result.agentIntegration.hookProfile}`);
   }
+  printRuntimeEnvironmentSummary(result.agentIntegration);
   console.log(`标准化: ${result.standards.ok ? '通过' : '失败'}`);
   console.log(`工作区验证: ${result.validation.valid ? '通过' : '失败'}`);
   if (result.agentIntegration.drift) {

package/src/cli/print.js

@@ -30,6 +30,7 @@ import {
   printValidation,
 } from './basic-print.js';
 import { printBenchmarkResult } from './benchmark-print.js';
+import { printCanvasResult } from './canvas-print.js';
 import {
   printAcceptedSpecsResult,
   printOpenPrdChangeActionResult,
@@ -115,4 +116,5 @@ export {
   printOpenPrdChangeActionResult,
   printAcceptedSpecsResult,
   printBenchmarkResult,
+  printCanvasResult,
 };

package/src/cli/quality-commands.js

@@ -0,0 +1,222 @@
+/*
+ * 核心功能
+ * 承载质量与视觉相关 CLI 命令分发：standards、quality、knowledge、visual-prepare、
+ * visual-compare、design-starter、grow、docs-compact、guide、dev-check。
+ *
+ * 输入
+ * 接收 main 传入的 command、projectPath、flags、positionals。
+ *
+ * 输出
+ * 命中命令时执行对应 workspace 函数并打印结果，返回退出码；未命中返回 null。
+ *
+ * 定位
+ * 位于 CLI 应用层，从 openprd.js 拆出的命令分组，不承载领域业务规则。
+ *
+ * 依赖
+ * 依赖 standards、quality、knowledge、visual-compare、growth 等 workspace 模块与 cli/print。
+ *
+ * 维护规则
+ * 新增质量/视觉类命令时优先放这里，并同步 usage、打印契约与测试。
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { checkStandardsWorkspace, classifyExternalReferenceWorkspace, initStandardsWorkspace } from '../standards.js';
+import { qualityWorkspace } from '../quality.js';
+import {
+  archiveKnowledgeCandidate,
+  listKnowledgeCandidates,
+  rejectKnowledgeCandidate,
+  restoreKnowledgeCandidate,
+} from '../knowledge.js';
+import { checkDevelopmentStandardsWorkspace } from '../dev-standards.js';
+import {
+  applyGrowthCandidateWorkspace,
+  checkGrowthWorkspace,
+  initGrowthWorkspace,
+  rejectGrowthCandidateWorkspace,
+  reviewGrowthWorkspace,
+} from '../growth.js';
+import { designStarterWorkspace } from '../design-starter.js';
+import { visualCompareWorkspace } from '../visual-compare.js';
+import { visualPrepareWorkspace } from '../visual-prepare.js';
+import {
+  printDesignStarterResult,
+  printDevelopmentStandardsResult,
+  printGrowthResult,
+  printKnowledgeResult,
+  printQualityResult,
+  printStandardsResult,
+  printVisualCompareResult,
+  printVisualPrepareResult,
+} from './print.js';
+
+async function isDirectoryPath(candidate) {
+  const stat = await fs.stat(path.resolve(candidate)).catch(() => null);
+  return Boolean(stat?.isDirectory());
+}
+
+export async function runQualityCommand(command, { projectPath, flags, positionals }) {
+  if (command === 'standards') {
+    const result = flags.init
+      ? await initStandardsWorkspace(projectPath, { force: flags.force })
+      : flags.classifyExternal !== null
+        ? await classifyExternalReferenceWorkspace(projectPath, { externalReference: flags.classifyExternal })
+        : await checkStandardsWorkspace(projectPath);
+    printStandardsResult(result, flags.json);
+    return result.ok ? 0 : 1;
+  }
+
+  if (command === 'quality') {
+    const result = await qualityWorkspace(projectPath, {
+      init: flags.init,
+      verify: flags.verify,
+      report: flags.report,
+      html: flags.html,
+      learn: Boolean(flags.learn),
+      review: flags.review,
+      from: flags.from,
+      force: flags.force,
+    });
+    printQualityResult(result, flags.json);
+    return result.ok ? 0 : 1;
+  }
+
+  if (command === 'knowledge') {
+    const subcommand = positionals[0] ?? 'candidates';
+    const firstArgIsProjectPath = !flags.path && positionals.length > 1 && await isDirectoryPath(positionals[1]);
+    const knowledgeProjectPath = path.resolve(flags.path ?? (firstArgIsProjectPath ? positionals[1] : process.cwd()));
+    let result;
+    if (subcommand === 'candidates' || subcommand === 'list') {
+      result = await listKnowledgeCandidates(knowledgeProjectPath, {
+        status: flags.status ?? 'pending-review',
+      });
+    } else if (subcommand === 'reject') {
+      result = await rejectKnowledgeCandidate(knowledgeProjectPath, {
+        id: flags.id ?? positionals[1] ?? null,
+        reason: flags.reason ?? flags.notes,
+      });
+    } else if (subcommand === 'archive') {
+      result = await archiveKnowledgeCandidate(knowledgeProjectPath, {
+        id: flags.id ?? positionals[1] ?? null,
+        reason: flags.reason ?? flags.notes,
+      });
+    } else if (subcommand === 'restore') {
+      result = await restoreKnowledgeCandidate(knowledgeProjectPath, {
+        id: flags.id ?? positionals[1] ?? null,
+      });
+    } else {
+      console.log('Usage: openprd knowledge <candidates|reject|archive|restore> [path-or-id] [--status <pending-review|all|rejected|archived|promoted|merged>] [--id <candidate-id>] [--reason <text>] [--json]');
+      return 1;
+    }
+    printKnowledgeResult(result, flags.json);
+    return result.ok ? 0 : 1;
+  }
+
+  if (command === 'visual-prepare') {
+    const result = await visualPrepareWorkspace(projectPath, {
+      reference: flags.reference,
+      grid: flags.grid,
+      boxes: flags.boxes,
+      include: flags.include,
+      id: flags.id,
+      title: flags.title,
+      out: flags.out,
+    });
+    printVisualPrepareResult(result, flags.json);
+    return result.ok ? 0 : 1;
+  }
+
+  if (command === 'visual-compare') {
+    const result = await visualCompareWorkspace(projectPath, {
+      reference: flags.reference,
+      actual: flags.actual,
+      before: flags.before,
+      after: flags.after,
+      board: flags.board,
+      out: flags.out,
+      format: flags.format,
+      quality: flags.quality,
+      maxPanelWidth: flags.maxPanelWidth,
+      referenceLabel: flags.referenceLabel,
+      actualLabel: flags.actualLabel,
+      locale: flags.locale,
+    });
+    printVisualCompareResult(result, flags.json);
+    return result.ok ? 0 : 1;
+  }
+
+  if (command === 'design-starter') {
+    const result = await designStarterWorkspace(projectPath, {
+      starter: flags.starter,
+      out: flags.out,
+      title: flags.title,
+      brief: flags.brief,
+      sections: flags.sections,
+      noExternalFacts: flags.noExternalFacts,
+      noBrandAssets: flags.noBrandAssets,
+      noRealImages: flags.noRealImages,
+      force: flags.force,
+    });
+    printDesignStarterResult(result, flags.json);
+    return result.ok ? 0 : 1;
+  }
+
+  if (command === 'grow') {
+    const firstArgIsProjectPath = !flags.path && positionals.length > 0 && await isDirectoryPath(positionals[0]);
+    const growthProjectPath = path.resolve(flags.path ?? (firstArgIsProjectPath ? positionals[0] : process.cwd()));
+    let result;
+    if (flags.init) {
+      result = await initGrowthWorkspace(growthProjectPath);
+    } else if (flags.apply) {
+      result = await applyGrowthCandidateWorkspace(growthProjectPath, { id: flags.id });
+    } else if (flags.reject) {
+      result = await rejectGrowthCandidateWorkspace(growthProjectPath, { id: flags.id, notes: flags.notes });
+    } else if (flags.check) {
+      result = await checkGrowthWorkspace(growthProjectPath);
+    } else {
+      result = await reviewGrowthWorkspace(growthProjectPath);
+    }
+    printGrowthResult(result, flags.json);
+    return result.ok ? 0 : 1;
+  }
+
+  if (command === 'docs-compact') {
+    const { docsCompactWorkspace, printDocsCompactResult } = await import('../docs-compact.js');
+    const result = await docsCompactWorkspace(projectPath);
+    printDocsCompactResult(result, flags.json);
+    return result.ok ? 0 : 1;
+  }
+
+  if (command === 'guide') {
+    const { guideWorkspace, printGuideResult } = await import('../guide.js');
+    const result = await guideWorkspace(projectPath);
+    printGuideResult(result, flags.json);
+    return result.ok ? 0 : 1;
+  }
+
+  if (command === 'dev-check') {
+    const firstArgIsProjectPath = !flags.path && positionals.length > 0 && await isDirectoryPath(positionals[0]);
+    const devProjectPath = path.resolve(flags.path ?? (firstArgIsProjectPath ? positionals[0] : process.cwd()));
+    const files = flags.path
+      ? positionals
+      : (firstArgIsProjectPath ? positionals.slice(1) : positionals);
+    if (flags.autoRefactor !== null) {
+      const normalized = String(flags.autoRefactor).trim().toLowerCase();
+      if (!['on', 'off'].includes(normalized)) {
+        console.error('--auto-refactor 只接受 on 或 off。');
+        return 1;
+      }
+      const { setDevCheckAutoRefactor } = await import('../dev-standards.js');
+      const toggleResult = await setDevCheckAutoRefactor(devProjectPath, normalized === 'on');
+      if (files.length === 0) {
+        printDevelopmentStandardsResult(toggleResult, flags.json);
+        return toggleResult.ok ? 0 : 1;
+      }
+    }
+    const result = await checkDevelopmentStandardsWorkspace(devProjectPath, { files });
+    printDevelopmentStandardsResult(result, flags.json);
+    return result.ok ? 0 : 1;
+  }
+
+  return null;
+}

package/src/cli/quality-print.js

@@ -86,10 +86,19 @@ function printDevelopmentStandardsResult(result, json) {
     return;
   }
 
-  console.log(`OpenPrd 后续建议: ${result.ok ? '完成' : '失败'}`);
+  if (result.action === 'dev-check-auto-refactor') {
+    console.log(`OpenPrd dev-check 自动优化: 已${result.autoRefactor?.enabled ? '开启' : '关闭'}`);
+    console.log(`当前模式: ${result.autoRefactor?.enabled ? '自动执行优化（OpenPRD 自动优化报告）' : '仅推荐（后续建议）'}`);
+    console.log(`配置文件: ${result.configPath}`);
+    return;
+  }
+
+  const autoMode = result.autoRefactor?.enabled !== false;
+  console.log(`OpenPrd ${autoMode ? '自动优化报告' : '后续建议'}: ${result.ok ? '完成' : '失败'}`);
+  console.log(`自动优化: ${autoMode ? '开启（超行文件本轮直接拆分，收口附开关确认）' : '关闭（仅输出拆分推荐）'}`);
   const attentionFiles = result.files.filter((file) => ['attention', 'warning', 'error'].includes(file.status));
   if (attentionFiles.length > 0) {
-    console.log(`关注程度: 🟡 低风险｜建议留意，🟠 中风险｜建议优先关注，🔴 高风险｜需要先处理。`);
+    console.log(`${autoMode ? '问题级别' : '关注程度'}: 🟡 低风险｜建议留意，🟠 中风险｜建议优先关注，🔴 高风险｜需要先处理。`);
   } else {
     console.log(`本轮已回顾 ${result.files.length} 个改动文件，暂未发现需要额外说明的影响对象。`);
   }
@@ -101,6 +110,19 @@ function printDevelopmentStandardsResult(result, json) {
   if (result.wrapUp?.required && result.wrapUp.markdownTable) {
     console.log(result.wrapUp.markdownBlock ?? result.wrapUp.markdownTable);
   }
+  if (result.wrapUp?.required && result.wrapUp.switchHint) {
+    console.log(`- 开关提示: ${result.wrapUp.switchHint}`);
+  }
+  if (result.visualEvidence?.required) {
+    console.log(`- 视觉证据提醒: ${result.visualEvidence.reason}`);
+    console.log(`  涉及界面文件: ${result.visualEvidence.uiFiles.join(', ')}`);
+    for (const command of result.visualEvidence.suggestedCommands ?? []) {
+      console.log(`  可选命令: ${command}`);
+    }
+    console.log(`  ${result.visualEvidence.chatEmbedHint}`);
+  } else if (result.visualEvidence?.uiFiles?.length > 0) {
+    console.log(`- 视觉证据: 最近 24 小时已有证据板（${result.visualEvidence.freshEvidence.join(', ')}）；确认覆盖本轮改动并把证据图嵌入对话流。`);
+  }
   printKnowledgeReview(result.knowledgeReview);
   for (const error of result.errors ?? []) {
     console.log(`- ${error}`);
@@ -276,6 +298,10 @@ function printVisualCompareResult(result, json) {
   if (Array.isArray(result.items) && result.items.length > 0) {
     console.log(`实验卡片: ${result.items.length}`);
   }
+  if (result.chatEmbed?.markdown) {
+    console.log(`对话流嵌入: ${result.chatEmbed.markdown}`);
+    console.log(`  ${result.chatEmbed.hint}`);
+  }
   for (const action of result.nextActions ?? []) {
     console.log(`- 下一步: ${action}`);
   }

package/src/cli/run-print.js

@@ -131,6 +131,11 @@ function printRunResult(result, json) {
 
   console.log('当前进展参考');
   console.log(`当前项目: ${result.projectRoot}`);
+  if (result.runtimeEnvironment?.active?.activeClient && result.runtimeEnvironment.active.activeClient !== 'unknown') {
+    const active = result.runtimeEnvironment.active;
+    const confidence = typeof active.confidence === 'number' ? `，置信度 ${active.confidence}` : '';
+    console.log(`当前 Agent 环境: ${active.activeClient}${active.surface ? ` / ${active.surface}` : ''}${confidence}`);
+  }
   console.log(`基础检查: ${result.validation.valid ? '通过' : '失败'}`);
   if (result.lane?.summary) {
     console.log(`当前处理路径: ${result.lane.summary}`);

package/src/cli/workflow-print.js

@@ -71,6 +71,9 @@ function printReviewResult(result, json) {
   if (result.marked) {
     console.log(`状态已从 ${result.previousStatus} 更新为 ${result.status}`);
   }
+  if (result.designDirection) {
+    console.log(`选定交互方向: ${result.designDirection.id}（${result.designDirection.title}）`);
+  }
   if (result.opened) {
     console.log('已打开确认页面');
   }