@openprd/cli 0.1.11 → 0.1.19

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;