@openprd/cli 0.1.10 → 0.1.18

package/src/knowledge.js

@@ -1,7 +1,15 @@
+import crypto from 'node:crypto';
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { appendJsonl, cjoin, exists, readJson, readJsonl, writeJson, writeText } from './fs-utils.js';
 import { resolveQualityLearningSource } from './quality-learning.js';
+import {
+  buildSessionEvidenceReviewSource,
+  extractSessionEvidenceRecords,
+  filterGenericFrameworkTokens,
+  normalizeSessionEvidenceRecords,
+  sanitizeEvidenceText,
+} from './session-evidence.js';
 import { timestamp } from './time.js';
 
 const KNOWLEDGE_DIR = cjoin('.openprd', 'knowledge');
@@ -210,7 +218,7 @@ function normalizeSearchTokens(value) {
     .map((item) => item.trim())
     .filter((item) => item.length >= 3);
   const hanTokens = String(value ?? '').match(/[\u4e00-\u9fa5]{2,}/g) ?? [];
-  return uniq([...asciiTokens, ...hanTokens]);
+  return filterGenericFrameworkTokens(uniq([...asciiTokens, ...hanTokens]));
 }
 
 function sortByLength(items = []) {
@@ -252,16 +260,17 @@ function scoreQueryAgainstFields(queryText, queryTokens, fields = []) {
   let score = 0;
   const matchedOn = [];
   for (const field of fields) {
-    const text = String(field ?? '').trim();
+    const text = sanitizeEvidenceText(field);
     if (!text) continue;
     const normalized = normalizeSearchText(text);
     if (!normalized) continue;
+    const fieldTokens = normalizeSearchTokens(text);
+    if (fieldTokens.length === 0) continue;
     let matched = false;
     if (normalized.length >= 6 && queryText.includes(normalized)) {
       matched = true;
       score += normalized.length >= 18 ? 10 : 7;
     } else {
-      const fieldTokens = normalizeSearchTokens(text);
       const overlap = fieldTokens.filter((token) => queryTokens.includes(token));
       if (overlap.length > 0) {
         matched = true;
@@ -858,16 +867,56 @@ function deriveKnowledgeNames(source, options = {}) {
   return { incidentId, patternId, skillName };
 }
 
-function buildTurnReviewTitle(raw, source) {
-  return firstString(
-    raw?.title,
-    raw?.summary?.title,
-    raw?.promptPreview,
-    raw?.prompt,
-    source.title,
-    source.sourceId,
-    '项目经验草案',
-  ) ?? '项目经验草案';
+const LOW_SIGNAL_TITLE_PATTERN = /^(只回复|回复|继续|可以|好的|没问题|嗯|哦|行|是|对|确认|同意|执行|开始|ok|okay|yes|done|go)([\s，。,.!！?？]|$)/i;
+
+function titleLooksLikeRawInstruction(text) {
+  const value = String(text ?? '').trim();
+  if (!value) return true;
+  if (value.length < 8) return true;
+  return LOW_SIGNAL_TITLE_PATTERN.test(value);
+}
+
+function describeTouchedFilesTitle(touchedFiles) {
+  const files = [...new Set((touchedFiles ?? []).map((file) => String(file ?? '').trim()).filter(Boolean))];
+  if (files.length === 0) return null;
+  const primary = files[0].split('/').filter(Boolean).at(-1);
+  return files.length > 1
+    ? `围绕 ${primary} 等 ${files.length} 个文件的实现经验`
+    : `围绕 ${primary} 的实现经验`;
+}
+
+function buildTurnReviewTitle(raw, source, touchedFiles = []) {
+  const structured = firstString(raw?.title, raw?.summary?.title, source.title);
+  if (structured && !titleLooksLikeRawInstruction(structured)) return structured;
+  const rootCause = source.rootCauseCandidates?.[0]?.title;
+  if (rootCause && !titleLooksLikeRawInstruction(rootCause)) return rootCause;
+  const prompt = firstString(raw?.promptPreview, raw?.prompt);
+  if (prompt && !titleLooksLikeRawInstruction(prompt)) return prompt;
+  return describeTouchedFilesTitle(touchedFiles)
+    ?? firstString(structured, source.sourceId, '项目经验草案')
+    ?? '项目经验草案';
+}
+
+function knowledgeCandidateFingerprint(categories = [], touchedFiles = [], sourceSeed = null) {
+  const normalizedCategories = [...new Set((categories ?? []).map((item) => String(item ?? '').trim()).filter(Boolean))].sort();
+  const normalizedFiles = [...new Set((touchedFiles ?? []).map((item) => String(item ?? '').trim()).filter(Boolean))].sort();
+  const normalizedSourceSeed = String(sourceSeed ?? '').trim();
+  return crypto.createHash('sha256').update(JSON.stringify([normalizedCategories, normalizedFiles, normalizedSourceSeed])).digest('hex').slice(0, 16);
+}
+
+async function findPendingCandidateByFingerprint(projectRoot, fingerprint, excludeId) {
+  const index = await readKnowledgeIndex(projectRoot);
+  for (const entry of index.candidates ?? []) {
+    if (!entry?.candidateId || entry.candidateId === excludeId) continue;
+    const candidate = await readCandidateById(projectRoot, entry.candidateId);
+    if (!candidate || !isPendingKnowledgeCandidateStatus(normalizeCandidateStatus(candidate.status))) continue;
+    const existingFingerprint = candidate.fingerprint
+      ?? knowledgeCandidateFingerprint(candidate.categories, candidate.touchedFiles);
+    if (existingFingerprint === fingerprint) {
+      return candidate;
+    }
+  }
+  return null;
 }
 
 async function loadRawReviewInput(projectRoot, from) {
@@ -1155,6 +1204,7 @@ function buildKnowledgeCandidateMeta({
     updatedAt: timestamp(),
     sourceKind: source.kind,
     sourceRef: source.sourceId,
+    evidenceOnly: source.evidenceOnly === true,
     title,
     summary,
     categories,
@@ -1365,6 +1415,11 @@ export async function reviewKnowledgeWorkspace(projectRoot, options = {}) {
   const turnStateSource = (await exists(knowledgePath(projectRoot, OPENPRD_HARNESS_TURN_STATE))) ? OPENPRD_HARNESS_TURN_STATE : null;
   const from = firstString(options.from, turnStateSource, latestReportPath);
   const rawInput = from ? await loadRawReviewInput(projectRoot, from) : { sourcePath: null, raw: null };
+  const evidenceRecords = normalizeSessionEvidenceRecords([
+    ...normalizeSessionEvidenceRecords(options.evidenceRecords),
+    ...extractSessionEvidenceRecords(options.sessionEvents ?? []),
+  ]);
+  const cleanEvidenceRecords = evidenceRecords.filter((record) => record.sourceKind !== 'context-only');
   const resolved = from
     ? await resolveQualityLearningSource(projectRoot, {
       from,
@@ -1374,13 +1429,20 @@ export async function reviewKnowledgeWorkspace(projectRoot, options = {}) {
     : { ok: false, error: 'no-review-source' };
   const source = resolved.ok
     ? resolved.source
+    : (cleanEvidenceRecords.length > 0
+      ? buildSessionEvidenceReviewSource({
+        records: cleanEvidenceRecords,
+        sourceId: firstString(options.sourceId, options.title, cleanEvidenceRecords[0]?.text),
+        sourcePath: rawInput.sourcePath ?? latestReportPath ?? KNOWLEDGE_REVIEW_SIGNAL_LOG,
+        title: firstString(options.title, cleanEvidenceRecords.find((record) => record.sourceKind === 'user-direct')?.text),
+      })
     : buildSyntheticReviewSource(projectRoot, {
       signal: options.signal,
       recentSignals,
       touchedFiles: options.touchedFiles,
       sourcePath: rawInput.sourcePath ?? latestReportPath ?? KNOWLEDGE_REVIEW_SIGNAL_LOG,
       title: firstString(options.title, readJsonObject(rawInput.raw)?.title),
-    });
+    }));
   if (!resolved.ok && source.evidenceSources.length === 0 && source.rootCauseCandidates.length === 0) {
     return {
       ok: true,
@@ -1415,28 +1477,39 @@ export async function reviewKnowledgeWorkspace(projectRoot, options = {}) {
   const reviewSignals = reviewContext.reviewSignals;
   const categories = buildKnowledgeCategories({ source, touchedFiles: substantiveTouchedFiles, reviewSignals });
   const reasons = categories.map(categoryReason);
+  const allowEvidenceOnly = options.allowEvidenceOnly === true || source.evidenceOnly === true || source.kind === 'session-evidence-review';
   const hasStrongSignal = categories.length > 0
     || source.rootCauseCandidates.length > 0
     || source.symptoms.length > 1
     || source.kind === 'completion-review'
+    || source.kind === 'session-evidence-review'
     || reviewSignals.some((signal) => signal.ok === true || signal.productionReady === true);
 
-  if (substantiveTouchedFiles.length === 0 || !hasStrongSignal) {
+  if ((substantiveTouchedFiles.length === 0 && !allowEvidenceOnly) || !hasStrongSignal) {
     return {
       ok: true,
       action: 'quality-knowledge-review',
       skipped: true,
-      reason: substantiveTouchedFiles.length === 0 ? 'no-substantive-touched-files' : 'no-knowledge-signal',
+      reason: substantiveTouchedFiles.length === 0 && !allowEvidenceOnly ? 'no-substantive-touched-files' : 'no-knowledge-signal',
       sourceKind: source.kind,
       sourcePath: source.sourcePath,
     };
   }
 
-  const title = buildTurnReviewTitle(raw, source);
+  const title = buildTurnReviewTitle(raw, source, substantiveTouchedFiles);
   const rawCandidateRef = firstString(raw.knowledgeCandidateId, raw.id);
-  const candidateId = rawCandidateRef
+  let candidateId = rawCandidateRef
     ? (rawCandidateRef.startsWith('candidate-') ? rawCandidateRef : `candidate-${slugify(rawCandidateRef, 'knowledge')}`)
     : `candidate-${slugify(source.sourceId ?? title, 'knowledge')}`;
+  const fingerprint = knowledgeCandidateFingerprint(
+    categories,
+    substantiveTouchedFiles,
+    allowEvidenceOnly ? firstString(source.sourceId, source.title, source.sourcePath) : null,
+  );
+  const duplicateCandidate = await findPendingCandidateByFingerprint(projectRoot, fingerprint, candidateId);
+  if (duplicateCandidate?.candidateId) {
+    candidateId = duplicateCandidate.candidateId;
+  }
   const promotedSource = { ...source, sourceId: candidateId };
   const names = deriveKnowledgeNames(promotedSource, { stablePattern: false });
   const candidateDir = knowledgePath(projectRoot, cjoin(KNOWLEDGE_CANDIDATES_DIR, candidateId));
@@ -1448,11 +1521,15 @@ export async function reviewKnowledgeWorkspace(projectRoot, options = {}) {
   const existingCandidate = await readJson(candidatePath).catch(() => null);
   const relativeCandidateDir = path.relative(projectRoot, candidateDir).split(path.sep).join('/');
   const relativeDraftSkillPath = path.relative(projectRoot, draftSkillPath).split(path.sep).join('/');
+  const scopeSummary = substantiveTouchedFiles.length > 0
+    ? `本轮围绕 ${substantiveTouchedFiles.length} 个可沉淀文件生成回顾。`
+    : '本轮基于只读证据生成项目经验候选。';
   const reviewSummary = [
-    `本轮围绕 ${substantiveTouchedFiles.length} 个可沉淀文件生成回顾。`,
+    scopeSummary,
     reasons[0] ?? '这次实现已经具备项目级经验抽象价值。',
     reviewSignals.length > 0 ? `已记录 ${reviewSignals.length} 条回顾信号。` : null,
     touchedFileSource === 'inferred-recent-files' ? '本轮 touched files 来自最近修改文件推断。' : null,
+    allowEvidenceOnly && substantiveTouchedFiles.length === 0 ? '本轮没有把 AGENTS、system 或 tool schema 命中当成用户证据。' : null,
   ].filter(Boolean).join(' ');
   const draftCandidate = buildKnowledgeCandidateMeta({
     projectRoot,
@@ -1482,6 +1559,8 @@ export async function reviewKnowledgeWorkspace(projectRoot, options = {}) {
   const candidate = {
     ...draftCandidate,
     abstraction,
+    fingerprint,
+    occurrences: (readJsonObject(existingCandidate)?.occurrences ?? 0) + 1,
   };
   const userFacingExperience = buildKnowledgeUserFacingExperience({
     candidate,
@@ -1693,7 +1772,9 @@ function buildKnowledgeMatchQuery(options = {}) {
     options.activeChange,
     options.nextTaskTitle,
     ...(normalizeStringList(options.relatedFiles)),
-  ].filter(Boolean);
+  ]
+    .map((field) => sanitizeEvidenceText(field))
+    .filter(Boolean);
   const text = candidateFields.join('\n');
   return {
     text,

package/src/language-policy.js

@@ -1,11 +1,13 @@
-export const OPENPRD_CONTENT_LOCALE = 'zh-CN';
+export const OPENPRD_FALLBACK_LOCALE = 'zh-CN';
+export const OPENPRD_CONTENT_LOCALE = OPENPRD_FALLBACK_LOCALE;
 
 export const OPENPRD_LANGUAGE_POLICY =
-  'OpenPrd 默认用简体中文生成用户可见内容以及 Agent 产出的 spec、tasks 和说明文案；PRD、OpenPrd、OpenSpec、API、SDK、CLI、TypeScript、JSON、HTTP、WebSocket、字段 key、命令名、品牌名、产品名和协议名等必要专有名词按原文保留。';
+  'OpenPrd 用户可见内容以及 Agent 产出的 spec、tasks 和说明文案应跟随用户当前主语言；无法判断时才使用简体中文兜底。PRD、OpenPrd、OpenSpec、API、SDK、CLI、TypeScript、JSON、HTTP、WebSocket、字段 key、命令名、品牌名、产品名和协议名等必要专有名词按原文保留。';
 
 export const TBD_ZH = '待补充';
 
 const CJK_RE = /[\u3400-\u9fff]/;
+const LATIN_WORD_RE = /[A-Za-z][A-Za-z0-9+_.-]*/g;
 
 export function scalarZh(value, fallback = TBD_ZH) {
   if (value === null || value === undefined) {
@@ -19,14 +21,72 @@ export function hasSimplifiedChinese(value) {
   return CJK_RE.test(String(value ?? ''));
 }
 
+export function englishWords(value) {
+  return String(value ?? '').match(LATIN_WORD_RE) ?? [];
+}
+
+export function isChineseLocale(locale) {
+  return normalizeOutputLocale(locale).startsWith('zh');
+}
+
+export function normalizeOutputLocale(locale, fallback = OPENPRD_FALLBACK_LOCALE) {
+  const text = String(locale ?? '').trim();
+  if (!text) {
+    return fallback;
+  }
+  const lower = text.toLowerCase();
+  if (lower === 'cn' || lower.startsWith('zh')) {
+    return 'zh-CN';
+  }
+  if (lower.startsWith('en')) {
+    return 'en';
+  }
+  return text;
+}
+
+export function detectPrimaryLanguage(values, fallback = OPENPRD_FALLBACK_LOCALE) {
+  const text = (Array.isArray(values) ? values : [values])
+    .map((value) => String(value ?? ''))
+    .join('\n');
+  const cjkCount = (text.match(CJK_RE) ?? []).length;
+  const latinCount = englishWords(text).length;
+  if (cjkCount > 0) {
+    return 'zh-CN';
+  }
+  if (latinCount >= 4) {
+    return 'en';
+  }
+  return normalizeOutputLocale(fallback);
+}
+
+export function isEnglishHeavyText(value) {
+  const text = String(value ?? '').trim();
+  if (!text || hasSimplifiedChinese(text)) {
+    return false;
+  }
+  return englishWords(text).length >= 4;
+}
+
 export function preferSimplifiedChinese(value, fallback = TBD_ZH) {
   const text = scalarZh(value, '');
   return hasSimplifiedChinese(text) ? text : fallback;
 }
 
+export function preferUserLanguage(value, locale = OPENPRD_FALLBACK_LOCALE, fallbacks = {}) {
+  const text = scalarZh(value, '');
+  if (text) {
+    return text;
+  }
+  const normalizedLocale = normalizeOutputLocale(locale);
+  if (!isChineseLocale(normalizedLocale) && fallbacks.en) {
+    return fallbacks.en;
+  }
+  return fallbacks.zh ?? fallbacks.default ?? TBD_ZH;
+}
+
 export function languagePolicyLines() {
   return [
-    '> 语言规则：默认用简体中文生成 PRD、spec、tasks 和用户可见说明；除 PRD、OpenPrd、OpenSpec、API、SDK、CLI、TypeScript、JSON、HTTP、WebSocket、字段 key、命令名、品牌名、产品名和协议名等必要专有名词外，其余内容优先写成简体中文。',
+    '> 语言规则：用户可见说明、PRD、spec 和 tasks 跟随用户当前主语言；无法判断时才使用简体中文兜底。PRD、OpenPrd、OpenSpec、API、SDK、CLI、TypeScript、JSON、HTTP、WebSocket、字段 key、命令名、品牌名、产品名和协议名等必要专有名词保留原文。',
     '',
   ];
 }

package/src/learning-review.js

@@ -622,7 +622,7 @@ async function buildEvidenceManifest(ws, snapshot, options = {}) {
   ];
 
   if (changeId) {
-    const changeRoot = path.join(ws.projectRoot, 'openprd', 'changes', changeId);
+    const changeRoot = path.join(ws.projectRoot, '.openprd', 'changes', changeId);
     candidateDefs.push(
       makeEvidenceCandidate({
         id: 'change-proposal',

package/src/loop.js

@@ -550,7 +550,7 @@ async function syncLoopIsolationArtifacts(sourceRoot, targetRoot, options = {})
     LOOP_STATE,
     LOOP_BOOTSTRAP,
     RELEASE_LEDGER,
-    options.change ? path.join('openprd', 'changes', options.change) : null,
+    options.change ? path.join('.openprd', 'changes', options.change) : null,
   ].filter(Boolean);
   for (const relativePath of relativePaths) {
     if (await copyRelativePath(sourceRoot, targetRoot, relativePath, { force: Boolean(options.force) })) {

package/src/openprd.js

@@ -33,7 +33,8 @@ import { doctorOpenPrdAgentIntegration, setupOpenPrdAgentIntegration, updateOpen
 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, printBrainstormResult, printCaptureResult, printClarifyResult, printClassifyResult, printDesignStarterResult, 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, printVisualPrepareResult } from './cli/print.js';
+import { runQualityCommand } from './cli/quality-commands.js';
+import { printAcceptedSpecsResult, printAgentIntegrationResult, printBenchmarkResult, printBrainstormResult, printCanvasResult, printCaptureResult, printClarifyResult, printClassifyResult, printDesignStarterResult, 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, printVisualPrepareResult } 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';
@@ -64,6 +65,7 @@ import {
 import { brainstormWorkspace } from './brainstorm.js';
 import { buildBrainstormPresentationTemplatePayload, brainstormPresentationWorkspace } from './brainstorm-presentation.js';
 import { designStarterWorkspace } from './design-starter.js';
+import { canvasWorkspace } from './canvas-workspace.js';
 import { buildReviewPresentationTemplatePayload, reviewPresentationWorkspace } from './review-presentation.js';
 import { analyzeWorkspaceRegistryHygiene } from './registry-hygiene.js';
 import { syncSessionBindingFromChange } from './session-binding.js';
@@ -74,6 +76,22 @@ import { captureWorkspace, clarifyWorkspace, classifyWorkspace, computeWorkspace
 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';
 
+function buildInitTemplatePackGuidance(templatePack, options = {}) {
+  const label = formatTemplatePackDisplay(templatePack, { fallback: '通用产品或工程场景' });
+  if (options.explicit) {
+    return {
+      source: 'explicit',
+      templatePack,
+      message: `已按指定场景模板使用${label}起步；后续需求澄清或场景分类时，仍可按用户确认调整产品场景。`,
+    };
+  }
+  return {
+    source: 'default',
+    templatePack,
+    message: `未指定场景模板，已使用${label}起步；后续需求澄清或场景分类时，可再锁定为个人消费者、企业服务或 Agent 场景。`,
+  };
+}
+
 async function initWorkspace(projectRoot, options) {
   const ws = await ensureWorkspaceSkeleton(projectRoot, options);
   const workspace = await loadWorkspace(projectRoot);
@@ -131,12 +149,16 @@ async function initWorkspace(projectRoot, options) {
     templatePack: currentState.templatePack,
     projectRoot,
   });
+  const templatePackGuidance = buildInitTemplatePackGuidance(currentState.templatePack, {
+    explicit: Boolean(options.templatePack),
+  });
   await appendProgress(workspace, [
     `已初始化工作区: ${workspace.workspaceRoot}。`,
     `场景模板: ${formatTemplatePackDisplay(currentState.templatePack, { fallback: '待确认' })}。`,
+    templatePackGuidance.message,
   ]);
 
-  return { ws: workspace, created: ws.created, currentState, standards, quality, growth, agentIntegration };
+  return { ws: workspace, created: ws.created, currentState, templatePackGuidance, standards, quality, growth, agentIntegration };
 }
 
 async function setupAgentIntegrationWorkspace(projectRoot, options = {}) {
@@ -171,7 +193,16 @@ async function setupAgentIntegrationWorkspace(projectRoot, options = {}) {
     platform: options.platform,
     hookProfile: options.hookProfile,
   });
-  return { ...agentIntegration, initialized: false, migration, standards, quality, growth };
+  return {
+    ...agentIntegration,
+    ok: agentIntegration.ok && migration.ok,
+    initialized: false,
+    migration,
+    standards,
+    quality,
+    growth,
+    errors: [...(agentIntegration.errors ?? []), ...(migration.errors ?? [])],
+  };
 }
 
 async function updateAgentIntegrationWorkspace(projectRoot, options = {}) {
@@ -189,7 +220,15 @@ async function updateAgentIntegrationWorkspace(projectRoot, options = {}) {
     platform: options.platform,
     hookProfile: options.hookProfile,
   });
-  return { ...agentIntegration, migration, standards, quality, growth };
+  return {
+    ...agentIntegration,
+    ok: agentIntegration.ok && migration.ok,
+    migration,
+    standards,
+    quality,
+    growth,
+    errors: [...(agentIntegration.errors ?? []), ...(migration.errors ?? [])],
+  };
 }
 
 async function doctorWorkspace(projectRoot, options = {}) {
@@ -897,138 +936,34 @@ export async function main(argv = process.argv.slice(2)) {
       return result.ok ? 0 : 1;
     }
 
-    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,
+    if (command === 'canvas') {
+      const result = await canvasWorkspace(projectPath, {
+        thread: flags.thread,
+        threadTitle: flags.threadTitle,
+        conversationTitle: flags.conversationTitle,
+        session: flags.session,
+        sessionTitle: flags.sessionTitle,
+        host: flags.host,
+        port: flags.port,
+        daemon: flags.daemon,
+        stop: flags.stop,
+        bridgeOutbox: flags.bridgeOutbox,
+        bridgeSent: flags.bridgeSent,
+        bridgeFailed: flags.bridgeFailed,
+        claim: flags.claim,
         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,
-      });
-      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,
+        reason: flags.reason,
+        open: flags.open,
+        openTarget: flags.openTarget,
+        dryRun: flags.dryRun,
       });
-      printDesignStarterResult(result, flags.json);
+      printCanvasResult(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 === 'dev-check') {
-      const firstArgIsProjectPath = !flags.path && positionals.length > 1 && 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);
-      const result = await checkDevelopmentStandardsWorkspace(devProjectPath, { files });
-      printDevelopmentStandardsResult(result, flags.json);
-      return result.ok ? 0 : 1;
+    const qualityCommandExit = await runQualityCommand(command, { projectPath, flags, positionals });
+    if (qualityCommandExit !== null) {
+      return qualityCommandExit;
     }
 
     if (command === 'benchmark') {
@@ -1171,6 +1106,7 @@ export async function main(argv = process.argv.slice(2)) {
         version: flags.version,
         digest: flags.digest,
         workUnit: flags.workUnit,
+        direction: flags.direction,
       });
       printReviewResult(result, flags.json);
       return result.ok ? 0 : 1;
@@ -1454,6 +1390,7 @@ export {
   fleetWorkspace,
   backfillWorkUnitsWorkspace,
   runWorkspace,
+  canvasWorkspace,
   initLoopWorkspace,
   planLoopWorkspace,
   statusLoopWorkspace,

package/src/openspec/change-validate.js

@@ -47,7 +47,7 @@ export async function resolveOpenSpecChangeId(projectRoot, requestedChange) {
     return changeDirs[0];
   }
   if (changeDirs.length === 0) {
-    throw new Error('openprd/changes 下没有找到 OpenPrd change。');
+    throw new Error('.openprd/changes 下没有找到 OpenPrd change。');
   }
   throw new Error(`找到多个 OpenPrd change；请传入 --change <id>。已找到: ${changeDirs.join(', ')}`);
 }
@@ -60,7 +60,7 @@ function extractProposalCapabilities(text) {
   return capabilities;
 }
 
-const SPEC_SECTION_HEADING_RE = /^##\s+(?:(ADDED|MODIFIED|REMOVED)\s+Requirements|(?:新增|修改|移除)需求)\s*$/gim;
+const SPEC_SECTION_HEADING_RE = /^##\s+(?:(ADDED|MODIFIED|REMOVED|NEW|UPDATED|CHANGED)\s+Requirements|(?:新增|修改|移除)需求)\s*$/gim;
 const REQUIREMENT_HEADING_RE = /^###\s+(?:Requirement|需求)[：:]\s*(.+)$/gm;
 const SCENARIO_HEADING_RE = /^####\s+(?:Scenario|场景)[：:]\s*(.+)$/gm;
 const WHEN_STEP_RE = /^-\s+\*\*(?:WHEN|当)\*\*/im;

package/src/openspec/constants.js

@@ -1,12 +1,11 @@
 export const OPENPRD_DISCOVERY_DIR = ['.openprd', 'discovery'];
 export const OPENPRD_DISCOVERY_CONFIG_PATH = ['.openprd', 'discovery', 'config.json'];
-export const LEGACY_OPENSPEC_DISCOVERY_DIR = ['.openspec', 'discovery'];
-export const LEGACY_OPENSPEC_DISCOVERY_CONFIG_PATH = ['.openspec', 'discovery', 'config.json'];
-export const OPENSPEC_DISCOVERY_CONFIG_PATH = LEGACY_OPENSPEC_DISCOVERY_CONFIG_PATH;
-export const OPENPRD_CHANGE_ROOT = ['openprd', 'changes'];
-export const LEGACY_OPENSPEC_CHANGE_ROOT = ['openspec', 'changes'];
-export const OPENPRD_ACCEPTED_SPEC_ROOT = ['openprd', 'specs'];
-export const OPENPRD_ARCHIVE_CHANGE_ROOT = ['openprd', 'archive', 'changes'];
+export const OPENPRD_CHANGE_ROOT = ['.openprd', 'changes'];
+export const LEGACY_OPENPRD_CHANGE_ROOT = ['openprd', 'changes'];
+export const OPENPRD_ACCEPTED_SPEC_ROOT = ['.openprd', 'specs'];
+export const LEGACY_OPENPRD_ACCEPTED_SPEC_ROOT = ['openprd', 'specs'];
+export const OPENPRD_ARCHIVE_CHANGE_ROOT = ['.openprd', 'archive', 'changes'];
+export const LEGACY_OPENPRD_ARCHIVE_CHANGE_ROOT = ['openprd', 'archive', 'changes'];
 export const OPENSPEC_TASK_MAX_ITEMS_PER_FILE = 25;
 export const OPENSPEC_TASK_FILE_PATTERN = /^tasks(?:-\d{3})?\.md$/;
 export const OPENSPEC_TASK_ID_PATTERN = /^T\d{3}\.\d+$/;

package/src/openspec/execute.js

@@ -96,9 +96,9 @@ function resolveTaskSelection(state, options = {}) {
 
   if (!task) {
     if (requestedId) {
-      throw new Error(`Unknown OpenSpec task: ${requestedId}`);
+      throw new Error(`Unknown OpenPrd task: ${requestedId}`);
     }
-    throw new Error('No ready OpenSpec task is available.');
+    throw new Error('No ready OpenPrd task is available.');
   }
 
   return task;