@openprd/cli 0.1.1 → 0.1.8

package/src/openprd.js

@@ -1,33 +1,74 @@
+/*
+ * 核心功能
+ * 汇总 OpenPrd CLI 的命令入口、workspace 函数编排和测试可复用导出。
+ *
+ * 输入
+ * 接收 CLI 参数、项目路径、OpenPrd 工作区文件和各子模块 workspace 结果。
+ *
+ * 输出
+ * 执行 init/setup/update/doctor/run/loop 等命令，打印结果并导出内部 workspace API。
+ *
+ * 定位
+ * 位于 CLI 应用层，负责路由与组合，不承载单个领域的深层业务规则。
+ *
+ * 依赖
+ * 依赖 cli/args、cli/print、agent-integration、loop、standards、quality、openspec 等模块。
+ *
+ * 维护规则
+ * 新增命令或参数时同步更新 usage、打印契约、docs/basic/backend-structure.md 和相关测试。
+ */
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { analyzePrdSnapshot, buildPrdSnapshot, formatVersionId } from './prd-core.js';
+import { formatTemplatePackDisplay } from './product-type-copy.js';
+import { buildSnapshotChangeSummary } from './change-summary.js';
+import { appendReleaseEntry, buildReleaseChangeSummary, buildReleaseLedgerSummary, loadReleaseLedger, saveReleaseLedger, setCurrentReleaseVersion, setReleaseLedgerEnabled, setReleaseVersionStatus } from './release-ledger.js';
 import { validateOpenSpecChangeWorkspace } from './openspec/change-validate.js';
 import { generateOpenSpecChangeWorkspace as writeOpenSpecChangeWorkspace } from './openspec/generate.js';
-import { advanceOpenSpecTaskWorkspace, listOpenSpecTaskWorkspace, verifyOpenSpecTaskWorkspace } from './openspec/execute.js';
+import { advanceOpenSpecTaskWorkspace, checkOpenSpecTaskEvidenceWorkspace, listOpenSpecTaskWorkspace, verifyOpenSpecTaskWorkspace } from './openspec/execute.js';
+import { ensureCodexCliReady } from './codex-runtime.js';
 import { activateOpenPrdChangeWorkspace, applyOpenPrdChangeWorkspace, archiveOpenPrdChangeWorkspace, closeOpenPrdChangeWorkspace, listAcceptedSpecsWorkspace, listOpenPrdChangesWorkspace } from './openspec/change-lifecycle.js';
 import { checkStandardsWorkspace, classifyExternalReferenceWorkspace, initStandardsWorkspace } from './standards.js';
 import { doctorOpenPrdAgentIntegration, setupOpenPrdAgentIntegration, updateOpenPrdAgentIntegration } from './agent-integration.js';
 import { finishLoopWorkspace, initLoopWorkspace, nextLoopWorkspace, planLoopWorkspace, promptLoopWorkspace, runLoopWorkspace, statusLoopWorkspace, verifyLoopWorkspace } from './loop.js';
 import { timestamp } from './time.js';
 import { parseCommandArgs, usage } from './cli/args.js';
-import { printAcceptedSpecsResult, printAgentIntegrationResult, printBenchmarkResult, printCaptureResult, printClarifyResult, printClassifyResult, printDevelopmentStandardsResult, printDiagramResult, printDiffResult, printDoctorResult, printFleetResult, printFreezeResult, printGrowthResult, printHandoffResult, printHistoryResult, printInitResult, printInterviewResult, printLearningResult, printLoopResult, printNextResult, printOpenPrdChangeActionResult, printOpenPrdChangesResult, printOpenSpecChangeValidationResult, printOpenSpecDiscoveryResult, printOpenSpecGenerateResult, printOpenSpecTaskResult, printPlaygroundResult, printQualityResult, printReviewResult, printRunResult, printSelfUpdateResult, printStandardsResult, printStatus, printSynthesizeResult, printUpgradeResult, printValidation, printVisualCompareResult } from './cli/print.js';
-import { cjoin, exists, writeJson, writeText, writeYaml } from './fs-utils.js';
+import { printAcceptedSpecsResult, printAgentIntegrationResult, printBenchmarkResult, printCaptureResult, printClarifyResult, printClassifyResult, printDevelopmentStandardsResult, printDiagramResult, printDiffResult, printDoctorResult, printFleetResult, printFreezeResult, printGrowthResult, printHandoffResult, printHistoryResult, printInitResult, printInterviewResult, printKnowledgeResult, printLearningResult, printLoopResult, printNextResult, printOpenPrdChangeActionResult, printOpenPrdChangesResult, printOpenSpecChangeValidationResult, printOpenSpecDiscoveryResult, printOpenSpecGenerateResult, printOpenSpecTaskResult, printPlaygroundResult, printQualityResult, printReleaseResult, printReviewResult, printRunResult, printSelfUpdateResult, printStandardsResult, printStatus, printSynthesizeResult, printUpgradeResult, printValidation, printVisualCompareResult } from './cli/print.js';
+import { cjoin, exists, readJson, writeJson, writeText, writeYaml } from './fs-utils.js';
 import { diagramWorkspace } from './diagram-workspace.js';
 import { createOpenSpecDiscoveryWorkspace } from './discovery.js';
 import { createFleetWorkspace } from './fleet.js';
 import { selfUpdateWorkspace, upgradeWorkspace } from './self-update.js';
 import { backfillWorkUnitsWorkspace } from './work-unit-migration.js';
 import { generateLearningReviewWorkspace, setLearningReviewModeWorkspace } from './learning-review.js';
-import { addBenchmarkWorkspace, approveBenchmarkWorkspace, benchmarkWorkspace, listBenchmarkWorkspace, verifyBenchmarkWorkspace } from './benchmark.js';
+import { addBenchmarkWorkspace, approveBenchmarkWorkspace, benchmarkWorkspace, listBenchmarkWorkspace, observeBenchmarkSourceWorkspace, verifyBenchmarkWorkspace } from './benchmark.js';
 import { initQualityWorkspace, qualityWorkspace, verifyQualityWorkspace, learnQualityWorkspace } from './quality.js';
+import {
+  archiveKnowledgeCandidate,
+  listKnowledgeCandidates,
+  recordKnowledgeReviewSignal,
+  rejectKnowledgeCandidate,
+  restoreKnowledgeCandidate,
+  reviewKnowledgeWorkspace,
+} from './knowledge.js';
 import { createRunWorkspace } from './run-harness.js';
 import { checkDevelopmentStandardsWorkspace } from './dev-standards.js';
-import { applyGrowthCandidateWorkspace, checkGrowthWorkspace, initGrowthWorkspace, rejectGrowthCandidateWorkspace, reviewGrowthWorkspace } from './growth.js';
+import {
+  applyGrowthCandidateWorkspace,
+  checkGrowthWorkspace,
+  initGrowthWorkspace,
+  recordGrowthCheckpointWorkspace,
+  rejectGrowthCandidateWorkspace,
+  reviewGrowthWorkspace,
+} from './growth.js';
 import { buildReviewPresentationTemplatePayload, reviewPresentationWorkspace } from './review-presentation.js';
+import { analyzeWorkspaceRegistryHygiene } from './registry-hygiene.js';
 import { syncSessionBindingFromChange } from './session-binding.js';
+import { readSessionRegistry } from './session-registry.js';
 import { visualCompareWorkspace } from './visual-compare.js';
 import { captureWorkspace, clarifyWorkspace, classifyWorkspace, computeWorkspaceGuidance, diffWorkspace, historyWorkspace, interviewWorkspace, nextWorkspace, playgroundWorkspace, reviewWorkspace, synthesizeWorkspace } from './workspace-workflow.js';
-import { appendDecision, appendProgress, appendVerification, appendWorkflowEvent, buildWorkflowTaskGraph, computeWorkspaceDigest, CORE_TEMPLATE_FILES, ensureWorkspaceSkeleton, isSupportedProductType, loadLatestVersionSnapshot, loadWorkspace, migrateWorkspaceSkeleton, normalizeVersionId, readVersionIndex, resolveActiveTemplatePack, resolveCurrentProductType, validateWorkspace } from './workspace-core.js';
+import { appendDecision, appendProgress, appendVerification, appendWorkflowEvent, buildCurrentStateSnapshot, buildWorkflowTaskGraph, computeWorkspaceDigest, CORE_TEMPLATE_FILES, ensureWorkspaceSkeleton, isSupportedProductType, loadCurrentLaneSnapshot, loadLatestVersionSnapshot, loadWorkspace, migrateWorkspaceSkeleton, normalizeVersionId, persistWorkspaceCurrentState, readVersionIndex, resolveActiveTemplatePack, resolveCurrentProductType, validateWorkspace } from './workspace-core.js';
+import { readWorkspaceRegistry } from './workspace-registry.js';
 
 async function initWorkspace(projectRoot, options) {
   const ws = await ensureWorkspaceSkeleton(projectRoot, options);
@@ -41,7 +82,9 @@ async function initWorkspace(projectRoot, options) {
     action: 'init',
     enableUserCodexConfig: Boolean(options.enableUserCodexConfig),
     codexHome: options.codexHome,
+    cursorHome: options.cursorHome,
     openprdHome: options.openprdHome,
+    platform: options.platform,
     hookProfile: options.hookProfile,
   });
   const config = workspace.data.config ?? {};
@@ -86,7 +129,7 @@ async function initWorkspace(projectRoot, options) {
   });
   await appendProgress(workspace, [
     `已初始化工作区: ${workspace.workspaceRoot}。`,
-    `模板包: ${currentState.templatePack}。`,
+    `场景模板: ${formatTemplatePackDisplay(currentState.templatePack, { fallback: '待确认' })}。`,
   ]);
 
   return { ws: workspace, created: ws.created, currentState, standards, quality, growth, agentIntegration };
@@ -119,7 +162,9 @@ async function setupAgentIntegrationWorkspace(projectRoot, options = {}) {
     action: 'setup',
     enableUserCodexConfig: Boolean(options.enableUserCodexConfig),
     codexHome: options.codexHome,
+    cursorHome: options.cursorHome,
     openprdHome: options.openprdHome,
+    platform: options.platform,
     hookProfile: options.hookProfile,
   });
   return { ...agentIntegration, initialized: false, migration, standards, quality, growth };
@@ -135,7 +180,9 @@ async function updateAgentIntegrationWorkspace(projectRoot, options = {}) {
     force: Boolean(options.force),
     enableUserCodexConfig: Boolean(options.enableUserCodexConfig),
     codexHome: options.codexHome,
+    cursorHome: options.cursorHome,
     openprdHome: options.openprdHome,
+    platform: options.platform,
     hookProfile: options.hookProfile,
   });
   return { ...agentIntegration, migration, standards, quality, growth };
@@ -146,16 +193,31 @@ async function doctorWorkspace(projectRoot, options = {}) {
     tools: options.tools ?? 'all',
     enableUserCodexConfig: Boolean(options.enableUserCodexConfig),
     codexHome: options.codexHome,
+    cursorHome: options.cursorHome,
     hookProfile: options.hookProfile,
   });
-  const standards = await checkStandardsWorkspace(projectRoot).catch((error) => ({
+  const codexRuntime = (agentIntegration.tools ?? []).includes('codex') && options.checkCodexRuntime
+    ? await ensureCodexCliReady({
+      cwd: projectRoot,
+      repair: Boolean(options.fix),
+      runCommand: options.codexRunCommand,
+      packageManager: options.packageManager,
+    })
+    : null;
+  const standards = await checkStandardsWorkspace(projectRoot, {
+    sourceManuals: options.sourceManuals,
+    docsContent: options.docsContent,
+  }).catch((error) => ({
     ok: false,
     errors: [error instanceof Error ? error.message : String(error)],
     warnings: [],
     checks: [],
     docsRoot: path.join('docs', 'basic'),
   }));
-  const validation = await validateWorkspace(projectRoot)
+  const validation = await validateWorkspace(projectRoot, {
+    sourceManuals: options.sourceManuals,
+    docsContent: options.docsContent,
+  })
     .then(({ report }) => report)
     .catch((error) => ({
       valid: false,
@@ -163,20 +225,88 @@ async function doctorWorkspace(projectRoot, options = {}) {
       warnings: [],
       checks: [],
     }));
+  const workspaceRegistry = await readWorkspaceRegistry({ openprdHome: options.openprdHome }).catch(() => null);
+  const sessionRegistry = await readSessionRegistry({ openprdHome: options.openprdHome }).catch(() => null);
+  const registryHygiene = workspaceRegistry
+    ? analyzeWorkspaceRegistryHygiene(workspaceRegistry.entries)
+    : { ok: true, issues: [] };
+  const registryWarnings = [
+    ...(registryHygiene.issues ?? []).map((issue) => `registry: ${issue.message}`),
+    ...((workspaceRegistry?.staleEntries ?? []).map((entry) => `registry: stale workspace ${entry.workspaceRoot} (${entry.reason})`)),
+    ...((sessionRegistry?.staleEntries ?? []).map((entry) => `session-registry: stale session ${entry.sessionId} (${entry.reason})`)),
+  ];
+  const doctorOk = agentIntegration.ok && (codexRuntime?.ok ?? true) && standards.ok && validation.valid;
+  const latestQuality = await readJson(cjoin(projectRoot, '.openprd', 'quality', 'reports', 'latest.json')).catch(() => null);
+  const doctorSignal = doctorOk
+    ? {
+      kind: 'doctor-green',
+      ok: true,
+      summary: 'doctor passed',
+    }
+    : null;
+  if (doctorSignal) {
+    await recordKnowledgeReviewSignal(projectRoot, doctorSignal).catch(() => null);
+  }
+  const growthCheckpoint = doctorSignal
+    ? await recordGrowthCheckpointWorkspace(projectRoot, {
+      outcome: 'doctor-passed',
+      reason: 'doctor-post-completion',
+    }).catch((error) => ({
+      ok: false,
+      action: 'growth-checkpoint',
+      projectRoot,
+      recorded: false,
+      errors: [error instanceof Error ? error.message : String(error)],
+    }))
+    : {
+      ok: true,
+      action: 'growth-checkpoint',
+      projectRoot,
+      recorded: false,
+      skipped: true,
+      reason: 'doctor-not-green',
+    };
+  const knowledgeReview = doctorSignal
+    ? await reviewKnowledgeWorkspace(projectRoot, {
+      from: latestQuality?.jsonPath ?? null,
+      signal: doctorSignal,
+    }).catch((error) => ({
+      ok: false,
+      action: 'quality-knowledge-review',
+      skipped: false,
+      errors: [error instanceof Error ? error.message : String(error)],
+    }))
+    : {
+      ok: true,
+      action: 'quality-knowledge-review',
+      skipped: true,
+      reason: 'doctor-not-green',
+    };
 
   return {
-    ok: agentIntegration.ok && standards.ok && validation.valid,
+    ok: doctorOk,
     action: 'doctor',
     projectRoot,
     tools: agentIntegration.tools,
     agentIntegration,
+    codexRuntime,
     standards,
     validation,
+    registry: {
+      workspace: workspaceRegistry,
+      sessions: sessionRegistry,
+      hygiene: registryHygiene,
+      warnings: registryWarnings,
+    },
+    growthCheckpoint,
+    knowledgeReview,
     errors: [
       ...agentIntegration.errors,
+      ...(codexRuntime?.errors ?? []).map((error) => `codex-runtime: ${error}`),
       ...(standards.errors ?? []).map((error) => `standards: ${error}`),
       ...(validation.errors ?? []).map((error) => `validate: ${error}`),
     ],
+    warnings: registryWarnings,
   };
 }
 
@@ -236,7 +366,7 @@ async function freezeWorkspace(projectRoot) {
   }
 
   let ws = validation.ws;
-  let latest = await loadLatestVersionSnapshot(ws);
+  let latest = await loadCurrentLaneSnapshot(ws, { fallbackToLatest: true });
   if (!latest) {
     const synthesized = await synthesizeWorkspace(projectRoot, {});
     ws = synthesized.ws;
@@ -294,28 +424,26 @@ async function freezeWorkspace(projectRoot) {
     frozenAt: snapshot.frozenAt,
     digest,
   };
-  await writeJson(ws.paths.currentState, currentState);
+  const storedCurrentState = await persistWorkspaceCurrentState(ws, currentState);
   await appendWorkflowEvent(ws, 'frozen', {
     versionId: snapshot.latestVersionId,
     digest,
   });
   await appendVerification(ws, [
-    'Freeze 验证通过。',
-    `版本: ${snapshot.latestVersionId}`,
-    `Digest: ${digest}`,
-    `PRD 版本: ${snapshot.prdVersion}`,
+    '定稿前检查通过。',
+    `本次确认稿: ${snapshot.latestVersionId}`,
+    `需求稿版本序号: ${snapshot.prdVersion}`,
   ]);
   await appendProgress(ws, [
-    `已 freeze PRD 版本 ${snapshot.latestVersionId}。`,
-    `Digest: ${digest}`,
+    `这版需求已经定稿。`,
   ]);
   await appendDecision(ws, [
-    `已 freeze 版本 ${snapshot.latestVersionId}。`,
+    '这版需求已经定稿。',
     `已准备好交接给 ${resolveActiveTemplatePack(ws) === 'base' ? '下游执行方' : '执行系统'}。`,
   ]);
-  await writeJson(ws.paths.taskGraph, buildWorkflowTaskGraph(currentState));
+  await writeJson(ws.paths.taskGraph, buildWorkflowTaskGraph(storedCurrentState));
 
-  return { ok: true, ws, report, snapshot, latest };
+  return { ok: true, ws: { ...ws, data: { ...ws.data, currentState: storedCurrentState } }, report, snapshot, latest };
 }
 
 async function handoffWorkspace(projectRoot, target) {
@@ -325,13 +453,23 @@ async function handoffWorkspace(projectRoot, target) {
   }
 
   const { ws, snapshot } = freeze;
+  const sourceSnapshot = freeze.latest?.snapshot ?? snapshot;
   const exportDir = cjoin(ws.paths.exportsDir, target);
+  const releaseState = await loadReleaseLedger(projectRoot);
+  const releaseSummary = buildReleaseLedgerSummary(releaseState.ledger);
+  const releaseChangeSummary = releaseSummary.enabled && releaseSummary.currentVersion
+    ? buildReleaseChangeSummary(releaseState.ledger, { limit: 5 })
+    : null;
+  const changeSummary = releaseChangeSummary?.items?.length
+    ? releaseChangeSummary
+    : buildSnapshotChangeSummary(sourceSnapshot, { limit: 5 });
   await fs.mkdir(exportDir, { recursive: true });
 
   const handoff = {
     version: 1,
     versionId: snapshot.latestVersionId,
     versionNumber: snapshot.prdVersion,
+    projectVersion: releaseSummary.currentVersion,
     target,
     generatedAt: timestamp(),
     workspaceRoot: ws.workspaceRoot,
@@ -341,6 +479,10 @@ async function handoffWorkspace(projectRoot, target) {
     productTypes: ws.data.config?.supportedProductTypes ?? [],
     productType: resolveCurrentProductType(ws),
     digest: snapshot.digest,
+    projectRelease: releaseSummary,
+    changeSummarySource: releaseChangeSummary?.items?.length ? 'release-ledger' : 'snapshot',
+    changeSummary,
+    releaseNotes: changeSummary.items.map((item) => item.sentence),
     sourceFiles: [
       ...CORE_TEMPLATE_FILES,
       ...((await exists(ws.paths.activeArchitectureDiagramHtml)) ? ['engagements/active/architecture-diagram.html'] : []),
@@ -356,7 +498,12 @@ async function handoffWorkspace(projectRoot, target) {
   };
 
   await writeJson(cjoin(exportDir, 'handoff.json'), handoff);
-  await writeText(cjoin(exportDir, 'handoff.md'), `# 交接\n\n- 目标: ${target}\n- 版本: ${handoff.versionId}\n- Schema: ${handoff.schema}\n- 模板包: ${handoff.templatePack}\n- Digest: ${handoff.digest}\n- 下一步: ${handoff.nextStep}\n`);
+  const summarySection = handoff.changeSummary.markdown
+    ? `\n## 变化摘要\n\n${handoff.changeSummary.markdown}\n`
+    : '';
+  const handoffMarkdown = `# 交接\n\n- 交接去向: ${target}\n${handoff.projectVersion ? `- 项目版本: ${handoff.projectVersion}\n` : ''}- 使用格式: ${handoff.schema}\n- 场景模板: ${formatTemplatePackDisplay(handoff.templatePack, { fallback: '待确认' })}\n- 下一步: ${handoff.nextStep}\n${summarySection}`;
+  await writeText(cjoin(exportDir, 'handoff.md'), handoffMarkdown);
+  await writeText(ws.paths.activeHandoff, handoffMarkdown);
   if (await exists(ws.paths.activeArchitectureDiagramHtml)) {
     await fs.copyFile(ws.paths.activeArchitectureDiagramHtml, cjoin(exportDir, 'architecture-diagram.html'));
   }
@@ -394,10 +541,107 @@ async function handoffWorkspace(projectRoot, target) {
     handedOffAt: handoff.generatedAt,
     handoffTarget: target,
   };
-  await writeJson(ws.paths.currentState, currentState);
-  await writeJson(ws.paths.taskGraph, buildWorkflowTaskGraph(currentState));
+  const storedCurrentState = await persistWorkspaceCurrentState(ws, currentState);
+  await writeJson(ws.paths.taskGraph, buildWorkflowTaskGraph(storedCurrentState));
 
-  return { ok: true, ws, report: freeze.report, snapshot, handoff, exportDir };
+  return { ok: true, ws: { ...ws, data: { ...ws.data, currentState: storedCurrentState } }, report: freeze.report, snapshot, handoff, exportDir };
+}
+
+async function releaseWorkspace(projectRoot, options = {}) {
+  const workspaceRoot = cjoin(projectRoot, '.openprd');
+  if (!(await exists(workspaceRoot))) {
+    return {
+      ok: false,
+      action: 'release',
+      projectRoot,
+      errors: [`Missing workspace: ${workspaceRoot}. Please run openprd init first.`],
+    };
+  }
+
+  const loaded = await loadReleaseLedger(projectRoot);
+  let ledger = loaded.ledger;
+  const actions = [];
+  const warnings = [];
+  let changed = false;
+
+  try {
+    if (options.disable) {
+      ({ ledger } = setReleaseLedgerEnabled(ledger, false));
+      actions.push('disable');
+      changed = true;
+    }
+
+    if (options.enable) {
+      ({ ledger } = setReleaseLedgerEnabled(ledger, true));
+      actions.push('enable');
+      changed = true;
+    }
+
+    if (options.setVersion) {
+      const updated = setCurrentReleaseVersion(ledger, options.setVersion, {
+        status: options.status === 'released' ? 'current' : (options.status ?? 'current'),
+      });
+      ledger = updated.ledger;
+      actions.push('set-version');
+      changed = true;
+      if (updated.previousVersion) {
+        warnings.push(`当前项目版本已从 ${updated.previousVersion} 切换到 ${updated.entry.version}；旧版本默认改为 released。`);
+      }
+      if (updated.semver.warning) {
+        warnings.push(updated.semver.warning);
+      }
+    }
+
+    if (options.status && !options.setVersion) {
+      const updated = setReleaseVersionStatus(ledger, options.status, { version: options.version });
+      ledger = updated.ledger;
+      actions.push('set-status');
+      changed = true;
+    }
+
+    if (options.notes) {
+      const updated = appendReleaseEntry(ledger, options.notes, {
+        version: options.version,
+        fallbackType: '调整',
+        source: {
+          kind: 'manual-note',
+          manualId: `manual-note-${Date.now()}`,
+        },
+      });
+      ledger = updated.ledger;
+      actions.push('append-note');
+      changed = true;
+    }
+  } catch (error) {
+    return {
+      ok: false,
+      action: 'release',
+      projectRoot,
+      errors: [error instanceof Error ? error.message : String(error)],
+    };
+  }
+
+  if (changed) {
+    await saveReleaseLedger(projectRoot, ledger);
+  }
+
+  const summary = buildReleaseLedgerSummary(ledger, { version: options.version });
+  const changeSummary = buildReleaseChangeSummary(ledger, {
+    version: options.version ?? summary.currentVersion,
+    limit: 5,
+  });
+
+  return {
+    ok: true,
+    action: 'release',
+    projectRoot,
+    releaseLedgerPath: loaded.filePath,
+    changed,
+    actions,
+    warnings,
+    summary,
+    changeSummary,
+  };
 }
 
 function reviewConfirmationCommand(snapshot) {
@@ -431,17 +675,9 @@ function assertPrdReviewConfirmedForChange(currentState, snapshot) {
 async function generateOpenSpecChangeWorkspace(projectRoot, options = {}) {
   const ws = await loadWorkspace(projectRoot);
   const versionIndex = await readVersionIndex(ws);
-  const latest = await loadLatestVersionSnapshot(ws);
+  const latest = await loadCurrentLaneSnapshot(ws, { fallbackToLatest: true });
   const currentState = ws.data.currentState ?? {};
-  const snapshot = latest?.snapshot ?? buildPrdSnapshot(ws, {
-    ...currentState,
-    versionNumber: currentState.prdVersion ?? (versionIndex.at(-1)?.versionNumber ?? 0),
-    versionId: currentState.prdVersion > 0
-      ? formatVersionId(currentState.prdVersion)
-      : (versionIndex.at(-1)?.versionId ?? 'v0000'),
-    productType: resolveCurrentProductType(ws),
-    templatePack: resolveActiveTemplatePack(ws),
-  });
+  const snapshot = latest?.snapshot ?? buildCurrentStateSnapshot(ws, currentState, versionIndex);
   assertPrdReviewConfirmedForChange(currentState, snapshot);
   const analysis = analyzePrdSnapshot(snapshot);
   const result = await writeOpenSpecChangeWorkspace(projectRoot, {
@@ -463,6 +699,7 @@ async function generateOpenSpecChangeWorkspace(projectRoot, options = {}) {
     `验证: ${validation.valid ? '通过' : '失败'}。`,
   ]);
   await syncSessionBindingFromChange(projectRoot, result.changeId, {
+    sessionId: ws.data.currentSessionId ?? null,
     title: snapshot.title ?? null,
     versionId: snapshot.versionId ?? null,
     digest: snapshot.digest ?? null,
@@ -572,7 +809,7 @@ export async function main(argv = process.argv.slice(2)) {
     }
 
     if (command === 'doctor') {
-      const result = await doctorWorkspace(projectPath, { tools: flags.tools, hookProfile: flags.hookProfile, enableUserCodexConfig: true });
+      const result = await doctorWorkspace(projectPath, { tools: flags.tools, hookProfile: flags.hookProfile, fix: flags.fix, checkCodexRuntime: true, enableUserCodexConfig: true });
       printDoctorResult(result, flags.json);
       return result.ok ? 0 : 1;
     }
@@ -604,6 +841,7 @@ export async function main(argv = process.argv.slice(2)) {
         context: flags.context,
         verify: flags.verify,
         recordHook: flags.recordHook,
+        hookInject: flags.hookInject,
         event: flags.event,
         risk: flags.risk,
         outcome: flags.outcome,
@@ -627,6 +865,7 @@ export async function main(argv = process.argv.slice(2)) {
         message: flags.message,
         evidence: flags.evidence,
         notes: flags.notes,
+        repairAgent: flags.repairAgent,
       };
       if (flags.init) {
         result = await initLoopWorkspace(projectPath, options);
@@ -674,10 +913,44 @@ export async function main(argv = process.argv.slice(2)) {
       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-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,
@@ -733,6 +1006,14 @@ export async function main(argv = process.argv.slice(2)) {
           source: target ?? flags.source,
           notes: flags.notes,
         });
+      } else if (subcommand === 'observe') {
+        result = await observeBenchmarkSourceWorkspace(benchmarkProjectPath, {
+          source: target ?? flags.source,
+          notes: flags.notes,
+          task: flags.item ?? flags.event,
+          adoptedSignal: flags.status ?? flags.outcome,
+          threshold: flags.threshold,
+        });
       } else if (subcommand === 'approve') {
         result = await approveBenchmarkWorkspace(benchmarkProjectPath, {
           id: flags.id ?? target,
@@ -742,7 +1023,7 @@ export async function main(argv = process.argv.slice(2)) {
       } else if (subcommand === 'list') {
         result = await listBenchmarkWorkspace(benchmarkProjectPath);
       } else {
-        console.log('Usage: openprd benchmark <add|list|approve|verify> [target-or-id] [path-for-list-or-verify] [--path <project>] [--notes <text>] [--id <benchmark-id>]');
+        console.log('Usage: openprd benchmark <add|observe|list|approve|verify> [target-or-id] [path-for-list-or-verify] [--path <project>] [--notes <text>] [--id <benchmark-id>]');
         return 1;
       }
       printBenchmarkResult(result, flags.json);
@@ -906,6 +1187,19 @@ export async function main(argv = process.argv.slice(2)) {
       return 0;
     }
 
+    if (command === 'release') {
+      const result = await releaseWorkspace(projectPath, {
+        enable: flags.enable,
+        disable: flags.disable,
+        setVersion: flags.set,
+        status: flags.status,
+        version: flags.version,
+        notes: flags.notes,
+      });
+      printReleaseResult(result, flags.json);
+      return result.ok ? 0 : 1;
+    }
+
     if (command === 'validate') {
       const { report } = await validateWorkspace(projectPath);
       printValidation(report, flags.json);
@@ -1012,7 +1306,9 @@ export async function main(argv = process.argv.slice(2)) {
         evidence: flags.evidence,
         notes: flags.notes,
       };
-      const result = flags.advance
+      const result = flags.evidenceRequired
+        ? await checkOpenSpecTaskEvidenceWorkspace(projectPath, taskOptions)
+        : flags.advance
         ? await advanceOpenSpecTaskWorkspace(projectPath, taskOptions)
         : flags.verify
           ? await verifyOpenSpecTaskWorkspace(projectPath, taskOptions)
@@ -1094,6 +1390,7 @@ export {
   nextWorkspace,
   diffWorkspace,
   historyWorkspace,
+  releaseWorkspace,
   reviewWorkspace,
   reviewPresentationWorkspace,
   freezeWorkspace,
@@ -1104,6 +1401,7 @@ export {
   listOpenSpecTaskWorkspace,
   advanceOpenSpecTaskWorkspace,
   verifyOpenSpecTaskWorkspace,
+  checkOpenSpecTaskEvidenceWorkspace,
   listOpenPrdChangesWorkspace,
   activateOpenPrdChangeWorkspace,
   closeOpenPrdChangeWorkspace,
@@ -1121,6 +1419,10 @@ export {
   verifyQualityWorkspace,
   learnQualityWorkspace,
   qualityWorkspace,
+  listKnowledgeCandidates,
+  rejectKnowledgeCandidate,
+  archiveKnowledgeCandidate,
+  restoreKnowledgeCandidate,
   visualCompareWorkspace,
   checkDevelopmentStandardsWorkspace,
   initGrowthWorkspace,
@@ -1130,6 +1432,7 @@ export {
   rejectGrowthCandidateWorkspace,
   benchmarkWorkspace,
   addBenchmarkWorkspace,
+  observeBenchmarkSourceWorkspace,
   listBenchmarkWorkspace,
   approveBenchmarkWorkspace,
   verifyBenchmarkWorkspace,

package/src/openspec/change-validate.js

@@ -4,7 +4,6 @@ import YAML from 'yaml';
 import { listChangeDirs, readDiscoveryConfig, resolveChangeDir } from './paths.js';
 import { analyzeOpenSpecTaskVolumes } from './tasks.js';
 import { checkStandardsWorkspace } from '../standards.js';
-import { findOpenPrdSpecLanguageViolations } from '../language-policy.js';
 
 function cjoin(...parts) {
   return path.join(...parts);
@@ -70,7 +69,6 @@ const THEN_STEP_RE = /^-\s+\*\*(?:THEN|则|那么)\*\*/im;
 function validateOpenSpecSpecText(relativePath, text, errors, checks) {
   const requirementMatches = [...text.matchAll(REQUIREMENT_HEADING_RE)];
   const sectionMatches = [...text.matchAll(SPEC_SECTION_HEADING_RE)];
-  const languageViolations = findOpenPrdSpecLanguageViolations(text);
 
   if (sectionMatches.length === 0) {
     errors.push(`${relativePath} 必须包含“新增需求”“修改需求”或“移除需求”章节。`);
@@ -104,13 +102,6 @@ function validateOpenSpecSpecText(relativePath, text, errors, checks) {
     }
   }
 
-  for (const violation of languageViolations.slice(0, 5)) {
-    errors.push(`${relativePath}:${violation.line} 不符合简体中文规则: ${violation.reason}。除必要专业字段、命令、文件名或英文产品名外，spec.md 正文必须使用简体中文。`);
-  }
-  if (languageViolations.length > 5) {
-    errors.push(`${relativePath} 还有 ${languageViolations.length - 5} 处简体中文规则问题。`);
-  }
-
   checks.push(`${relativePath}: ${requirementMatches.length} 个需求。`);
 }