@openprd/cli 0.1.18 → 0.1.21

package/src/visual-compare.js

@@ -17,6 +17,7 @@ import {
   DEFAULT_PARALLEL_CARD_WIDTH,
   DEFAULT_PARALLEL_COLUMNS,
   FOCUS_COLORS,
+  VISUAL_BOARD_PALETTE,
   defaultOutputPath,
   encodePipeline,
   escapeXml,
@@ -75,7 +76,7 @@ async function renderStandardComparison(projectRoot, comparison, options = {}) {
       width: canvasWidth,
       height: canvasHeight,
       channels: 3,
-      background: '#111827',
+      background: VISUAL_BOARD_PALETTE.canvas,
     },
   }).composite([
     { input: referencePanel.input, left: referenceLeft, top: referenceTop },
@@ -278,7 +279,7 @@ async function renderFocusBoard(projectRoot, board, options = {}) {
       width: contentWidth,
       height: canvasHeight,
       channels: 3,
-      background: '#111827',
+      background: VISUAL_BOARD_PALETTE.canvas,
     },
   }).composite(composites);
 
@@ -398,7 +399,7 @@ async function renderParallelBoard(projectRoot, board, options = {}) {
       width: canvasWidth,
       height: canvasHeight,
       channels: 3,
-      background: '#111827',
+      background: VISUAL_BOARD_PALETTE.canvas,
     },
   }).composite(composites);
 
@@ -458,11 +459,12 @@ async function renderVerificationBoard(projectRoot, board, options = {}) {
   }
   const cardWidth = parsePositiveInteger(board.payload.cardWidth ?? options.maxPanelWidth, DEFAULT_PARALLEL_CARD_WIDTH, 'cardWidth');
   const columns = Math.max(1, Math.min(parsePositiveInteger(board.payload.columns, Math.min(DEFAULT_PARALLEL_COLUMNS, items.length), 'columns'), 4));
-  const margin = 24;
-  const gap = 24;
+  const compactResult = board.payload.presentation !== 'detailed';
+  const margin = compactResult ? 16 : 24;
+  const gap = compactResult ? 16 : 24;
   const route = String(board.payload.route ?? board.payload.flow ?? board.payload.method ?? '').trim();
   const summary = String(board.payload.summary ?? copy.verificationSummary(route));
-  const titleBlock = titleBlockSvg(
+  const titleBlock = compactResult ? null : titleBlockSvg(
     columns * cardWidth + (columns - 1) * gap,
     String(board.payload.title ?? copy.verificationTitle),
     summary,
@@ -475,6 +477,7 @@ async function renderVerificationBoard(projectRoot, board, options = {}) {
       cardWidth,
       eyebrow: copy.verificationCardEyebrow,
       locale,
+      compactEvidence: compactResult,
     }));
   }
 
@@ -483,11 +486,12 @@ async function renderVerificationBoard(projectRoot, board, options = {}) {
     rowHeights.push(Math.max(...renderedCards.slice(index, index + columns).map((card) => card.height)));
   }
   const canvasWidth = margin * 2 + columns * cardWidth + (columns - 1) * gap;
-  const canvasHeight = margin * 2 + titleBlock.height + 18 + rowHeights.reduce((sum, value) => sum + value, 0) + Math.max(0, rowHeights.length - 1) * gap;
-  const composites = [
+  const headerHeight = titleBlock ? titleBlock.height + 18 : 0;
+  const canvasHeight = margin * 2 + headerHeight + rowHeights.reduce((sum, value) => sum + value, 0) + Math.max(0, rowHeights.length - 1) * gap;
+  const composites = titleBlock ? [
     { input: titleBlock.input, left: margin, top: margin },
-  ];
-  let currentTop = margin + titleBlock.height + 18;
+  ] : [];
+  let currentTop = margin + headerHeight;
   for (let row = 0; row < rowHeights.length; row += 1) {
     const rowCards = renderedCards.slice(row * columns, row * columns + columns);
     for (const [column, card] of rowCards.entries()) {
@@ -505,7 +509,7 @@ async function renderVerificationBoard(projectRoot, board, options = {}) {
       width: canvasWidth,
       height: canvasHeight,
       channels: 3,
-      background: '#111827',
+      background: VISUAL_BOARD_PALETTE.canvas,
     },
   }).composite(composites);
 
@@ -522,6 +526,8 @@ async function renderVerificationBoard(projectRoot, board, options = {}) {
     format,
     boardSource: toWorkspacePath(projectRoot, board.sourcePath),
     title: String(board.payload.title ?? copy.verificationTitle),
+    presentation: compactResult ? 'compact-result' : 'detailed',
+    alignmentGuidesApplied: false,
     route: route || null,
     layout: {
       columns,
@@ -896,7 +902,7 @@ async function renderAlignmentBoard(projectRoot, board, options = {}) {
       width: contentWidth,
       height: canvasHeight,
       channels: 3,
-      background: '#111827',
+      background: VISUAL_BOARD_PALETTE.canvas,
     },
   }).composite(composites);
 

package/src/workspace-core.js

@@ -9,6 +9,7 @@ import { migrateLegacyOpenPrdArtifacts } from './openspec/migration.js';
 import { analyzePrdSnapshot, buildPrdSnapshot, formatVersionId, getRequiredFieldDescriptors, renderPrdMarkdown, summarizeSnapshot } from './prd-core.js';
 import { normalizeReleaseLedger } from './release-ledger.js';
 import { appendJsonl, appendText, cjoin, exists, readJson, readText, readYaml, stringifyYaml, writeJson, writeText, writeYaml } from './fs-utils.js';
+import { openProjectLedger } from './kernel/index.js';
 import { OPENSPEC_TASK_MAX_ITEMS_PER_FILE } from './openspec/constants.js';
 import { checkStandardsWorkspace, STANDARD_DOCS } from './standards.js';
 import { timestamp } from './time.js';
@@ -100,11 +101,6 @@ const WORKSPACE_SEED_REFRESH_FILES = [
   'design/templates/content-home.html',
   'design/templates/product-launch.html',
   'design/templates/ops-dashboard.html',
-  'design/active/facts-sheet.md',
-  'design/active/asset-spec.md',
-  'design/active/image-preflight.md',
-  'design/active/direction-plan.md',
-  'design/active/selected-direction.md',
   'schema/prd.schema.yaml',
   'schema/diagram-architecture.schema.yaml',
   'schema/diagram-product-flow.schema.yaml',
@@ -138,6 +134,7 @@ const WORKSPACE_SEED_COPY_IGNORE = new Set([
   'benchmarks/inbox',
   'changes',
   'discovery',
+  'design/active',
   'growth',
   'harness',
   'knowledge',
@@ -162,6 +159,76 @@ const WORKSPACE_SEED_COPY_IGNORE = new Set([
   'engagements/active/review.html',
   'engagements/active/verification.md',
 ]);
+const ACTIVE_DESIGN_TEMPLATE_FILES = {
+  'facts-sheet.md': `# Facts Sheet
+
+| 字段 | 当前值 | 来源 | verifiedAt | 状态 |
+| --- | --- | --- | --- | --- |
+| 产品 / 项目名 | 待填写 | 待确认 | - | pending |
+| 版本 / 发布状态 | 待填写 | 待确认 | - | pending |
+| 关键事实 1 | 待填写 | 待确认 | - | pending |
+| 关键事实 2 | 待填写 | 待确认 | - | pending |
+
+## 备注
+
+- 没核实到就保留 \`pending\`
+- 不要把记忆当来源
+`,
+  'asset-spec.md': `# Asset Spec
+
+| 类型 | 资产 | 来源 | 状态 | 备注 |
+| --- | --- | --- | --- | --- |
+| logo | 待填写 | 待确认 | pending |  |
+| 产品图 | 待填写 | 待确认 | pending |  |
+| UI 图 | 待填写 | 待确认 | pending |  |
+| 功能图标 | 新入口/按钮/空态默认配图标 | UI 图标 Phosphor；实现库 Lucide/Tabler/React Icons；AI 品牌 LobeHub；技术栈 Tech Icons | pending | 开发新功能时 Agent 自动找图标并登记，不等用户要求 |
+| 摄影 / 插图 | 待填写 | 待确认 | pending |  |
+| 色板 / 字体 | 待填写 | 待确认 | pending |  |
+| 动效节奏 | 待填写 | 待确认 | pending |  |
+| 背景 / 表面 | 待填写 | 待确认 | pending |  |
+| 构图记忆点 | 待填写 | 待确认 | pending |  |
+
+## 冻结变量
+
+- lens: 待填写
+- theme: 待填写
+- layout: 待填写
+- aesthetic: 待填写
+- memory-point: 待填写
+`,
+  'image-preflight.md': `# Image Preflight
+
+| 问题 | 回答 |
+| --- | --- |
+| 真实图片是不是页面成立前提 | 待填写 |
+| 必需图片类型 | 待填写 |
+| 计划来源 | 待填写 |
+| 缺失风险 | 待填写 |
+| 降级方案 | 待填写 |
+`,
+  'direction-plan.md': `# Direction Plan
+
+| 方向 | 生成逻辑 | lens | theme | layout | 审美主张 | 记忆点 | 为什么不同 | 适用场景 | 主要风险 |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| 方向 1 | contrast | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 |
+| 方向 2 | reference-transfer | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 |
+| 方向 3 | design-lens | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 |
+`,
+  'selected-direction.md': `# Selected Direction
+
+- selected: 待填写
+- reason: 待填写
+- lens: 待填写
+- theme: 待填写
+- layout: 待填写
+- aesthetic: 待填写
+- memory-point: 待填写
+- components:
+  - 待填写
+- follow-up risks:
+  - 待填写
+`,
+};
 const OPERATIONAL_GITIGNORE_ENTRIES = [
   '.openprd/harness/',
   '.openprd/learning/',
@@ -662,10 +729,32 @@ function buildWorkflowTaskGraph(snapshot = null, analysis = null, options = {})
 }
 
 async function appendWorkflowEvent(ws, type, payload = {}) {
+  const at = timestamp();
+  const eventTypeSuffix = String(type ?? 'event')
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '.')
+    .replace(/^\.+|\.+$/g, '') || 'event';
+  const jsonPayload = JSON.parse(JSON.stringify(payload ?? {}));
+  const ledger = openProjectLedger(ws.projectRoot);
+  await ledger.append(
+    `workflow:${ws.data?.currentSessionId ?? 'workspace'}`,
+    {
+      eventType: `workflow.${eventTypeSuffix}`,
+      actor: { type: 'openprd-cli' },
+      payload: {
+        type,
+        at,
+        ...jsonPayload,
+      },
+      metadata: {
+        compatibilityProjection: path.relative(ws.projectRoot, ws.paths.eventsLog).split(path.sep).join('/'),
+      },
+    },
+  );
   await appendJsonl(ws.paths.eventsLog, {
     type,
-    at: timestamp(),
-    ...payload,
+    at,
+    ...jsonPayload,
   });
 }
 
@@ -751,6 +840,12 @@ async function ensureWorkspaceSkeleton(projectRoot, options = {}) {
   await fs.mkdir(cjoin(workspaceRoot, 'design', 'assets'), { recursive: true });
   await fs.mkdir(cjoin(workspaceRoot, 'design', 'templates'), { recursive: true });
   await fs.mkdir(cjoin(workspaceRoot, 'design', 'active'), { recursive: true });
+  for (const [filename, content] of Object.entries(ACTIVE_DESIGN_TEMPLATE_FILES)) {
+    const targetPath = cjoin(workspaceRoot, 'design', 'active', filename);
+    if (options.force || !(await exists(targetPath))) {
+      await writeText(targetPath, content);
+    }
+  }
   await fs.mkdir(cjoin(workspaceRoot, 'growth'), { recursive: true });
   await fs.mkdir(cjoin(workspaceRoot, 'knowledge', 'incidents'), { recursive: true });
   await fs.mkdir(cjoin(workspaceRoot, 'knowledge', 'patterns'), { recursive: true });
@@ -1082,6 +1177,13 @@ async function migrateWorkspaceSkeleton(projectRoot, options = {}) {
   await fs.mkdir(cjoin(workspaceRoot, 'design', 'assets'), { recursive: true });
   await fs.mkdir(cjoin(workspaceRoot, 'design', 'templates'), { recursive: true });
   await fs.mkdir(cjoin(workspaceRoot, 'design', 'active'), { recursive: true });
+  for (const [filename, content] of Object.entries(ACTIVE_DESIGN_TEMPLATE_FILES)) {
+    const targetPath = cjoin(workspaceRoot, 'design', 'active', filename);
+    if (!(await exists(targetPath))) {
+      await writeText(targetPath, content);
+      changes.push({ path: cjoin('.openprd', 'design', 'active', filename), status: 'created' });
+    }
+  }
   await fs.mkdir(cjoin(workspaceRoot, 'growth'), { recursive: true });
   await fs.mkdir(cjoin(workspaceRoot, 'knowledge', 'incidents'), { recursive: true });
   await fs.mkdir(cjoin(workspaceRoot, 'knowledge', 'patterns'), { recursive: true });

package/src/workspace-registry.js

@@ -2,6 +2,7 @@ import fs from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
 import { appendJsonl, cjoin, exists, readJson, readJsonl } from './fs-utils.js';
+import { atomicWriteText, withFileLock } from './kernel/atomic-store.js';
 import { timestamp } from './time.js';
 
 const OPENPRD_WORKSPACE_MARKER = '.openprd';
@@ -56,9 +57,13 @@ function normalizeWorkspaceRegistryEntry(entry) {
 }
 
 function resolveOpenPrdHome(options = {}) {
+  const testHome = process.env.NODE_TEST_CONTEXT
+    ? cjoin(os.tmpdir(), 'openprd-node-test-home', String(process.pid))
+    : null;
   return path.resolve(
     options.openprdHome
       ?? process.env.OPENPRD_HOME
+      ?? testHome
       ?? cjoin(os.homedir(), '.openprd'),
   );
 }
@@ -144,7 +149,7 @@ async function upsertWorkspaceRegistryEntry(projectRoot, options = {}) {
     lastAction: snapshot.lastAction ?? existing?.lastAction ?? 'detected',
   };
 
-  await appendJsonl(registry.registryPath, entry);
+  await withFileLock(`${registry.registryPath}.lock`, () => appendJsonl(registry.registryPath, entry));
   return {
     home: registry.home,
     registryPath: registry.registryPath,
@@ -154,9 +159,42 @@ async function upsertWorkspaceRegistryEntry(projectRoot, options = {}) {
   };
 }
 
+function registryBackupName(prefix = 'workspaces') {
+  return `${prefix}-${new Date().toISOString().replace(/[:.]/g, '-')}.jsonl`;
+}
+
+async function compactWorkspaceRegistry(options = {}) {
+  const registryPath = workspaceRegistryFilePath(options);
+  return withFileLock(`${registryPath}.lock`, async () => {
+    const registry = await readWorkspaceRegistry(options);
+    const staleRoots = new Set((registry.staleEntries ?? []).map((entry) => entry.workspaceRoot));
+    const entries = options.pruneStale === false
+      ? registry.entries
+      : registry.entries.filter((entry) => !staleRoots.has(entry.workspaceRoot));
+    const backupDir = path.resolve(options.backupDir ?? cjoin(registry.home, 'registry', 'backups'));
+    await fs.mkdir(backupDir, { recursive: true });
+    const backupPath = cjoin(backupDir, registryBackupName('workspaces'));
+    if (await exists(registryPath)) await fs.copyFile(registryPath, backupPath);
+    else await atomicWriteText(backupPath, '');
+    const body = entries.length > 0 ? `${entries.map((entry) => JSON.stringify(entry)).join('\n')}\n` : '';
+    await atomicWriteText(registryPath, body);
+    return {
+      ok: true,
+      registryPath,
+      backupPath,
+      beforeEvents: registry.totalEvents,
+      afterEvents: entries.length,
+      kept: entries.length,
+      pruned: registry.entries.length - entries.length,
+      stale: registry.staleEntries.length,
+    };
+  });
+}
+
 export {
   readWorkspaceRegistry,
   resolveOpenPrdHome,
+  compactWorkspaceRegistry,
   upsertWorkspaceRegistryEntry,
   workspaceRegistryFilePath,
 };

package/src/workspace-workflow.js

@@ -2350,7 +2350,7 @@ async function computeWorkspaceGuidance(ws, options = {}) {
 }
 
 
-async function nextWorkspace(projectRoot) {
+async function nextWorkspace(projectRoot, options = {}) {
   const ws = await loadWorkspace(projectRoot);
   if (!(await exists(ws.workspaceRoot))) {
     throw new Error(`Missing workspace: ${ws.workspaceRoot}`);
@@ -2373,22 +2373,24 @@ async function nextWorkspace(projectRoot) {
     gates,
   } = guidance;
 
-  await writeJson(ws.paths.taskGraph, taskGraph);
-  await appendWorkflowEvent(ws, 'next', {
-    nextAction,
-    reason,
-    missingRequiredFields: analysis.missingRequiredFields,
-  });
-  if (analysis.missingRequiredFields > 0) {
-    await appendOpenQuestions(ws, [
-      `还有 ${analysis.missingRequiredFields} 个关键信息需要确认。`,
-      ...analysis.suggestedQuestions,
+  if (!options.readOnly) {
+    await writeJson(ws.paths.taskGraph, taskGraph);
+    await appendWorkflowEvent(ws, 'next', {
+      nextAction,
+      reason,
+      missingRequiredFields: analysis.missingRequiredFields,
+    });
+    if (analysis.missingRequiredFields > 0) {
+      await appendOpenQuestions(ws, [
+        `还有 ${analysis.missingRequiredFields} 个关键信息需要确认。`,
+        ...analysis.suggestedQuestions,
+      ]);
+    }
+    await appendProgress(ws, [
+      `建议下一步: ${nextAction}。`,
+      `原因: ${reason}`,
     ]);
   }
-  await appendProgress(ws, [
-    `建议下一步: ${nextAction}。`,
-    `原因: ${reason}`,
-  ]);
 
   return {
     ws,
@@ -2411,6 +2413,7 @@ async function nextWorkspace(projectRoot) {
     },
     brainstormSuggestion: guidance.brainstormSuggestion,
     workflow: ['brainstorm', 'clarify', 'classify', 'interview', 'synthesize', 'diagram', 'review', 'freeze', 'handoff'],
+    readOnly: Boolean(options.readOnly),
   };
 }